org.eclipse.ui.MultiPartInitException Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of org.eclipse.ui.workbench Show documentation

This is org.eclipse.ui.workbench jar used by Scout SDK

There is a newer version: 3.108.0.v20160602-1232

Show newest version

/*******************************************************************************
 * Copyright (c) 2009, 2012 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.ui;

/**
 * A checked exception indicating one or more workbench parts could not be
 * initialized correctly. The message text provides a further description of the
 * problem.
 *
 * @since 3.5
 * @noextend This class is not intended to be subclassed by clients.
 */
public class MultiPartInitException extends WorkbenchException {

	private IWorkbenchPartReference[] references;
	private PartInitException[] exceptions;

	/**
	 * Creates a new exception object. Note that as of 3.5, this constructor
	 * expects exactly one exception object in the given array, with all other
	 * array positions being null. The restriction may be lifted in
	 * the future, and clients of this class must not make this assumption.
	 *
	 * @param references
	 * @param exceptions
	 */
	public MultiPartInitException(IWorkbenchPartReference[] references,
			PartInitException[] exceptions) {
		super(exceptions[findFirstException(exceptions)].getStatus());
		this.references = references;
		this.exceptions = exceptions;
	}

	/**
	 * Returns an array of part references, containing references of parts that
	 * were intialized correctly. Any number of elements of the returned array
	 * may have a null value.
	 *
	 * @return the part reference array
	 */
	public IWorkbenchPartReference[] getReferences() {
		return references;
	}

	/**
	 * Returns an array of exceptions, corresponding to parts that could not be
	 * intialized correctly. At least one element of the returned array will
	 * have a non-null value.
	 *
	 * @return the exception array
	 */
	public PartInitException[] getExceptions() {
		return exceptions;
	}

	private static int findFirstException(PartInitException[] exceptions) {
		for (int i = 0; i < exceptions.length; i++) {
			if (exceptions[i] != null)
				return i;
		}
		throw new IllegalArgumentException();
	}

	private static final long serialVersionUID = -9138185942975165490L;

}