org.aspectj.org.eclipse.jdt.core.IJavaModelStatus Maven / Gradle / Ivy

/*******************************************************************************
 * Copyright (c) 2000, 2008 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.aspectj.org.eclipse.jdt.core;

import org.eclipse.core.runtime.IPath;
import org.eclipse.core.runtime.IStatus;

/**
 * Represents the outcome of an Java model operation. Status objects are
 * used inside JavaModelException objects to indicate what went
 * wrong.
 * 
 * Java model status object are distinguished by their plug-in id:
 * getPlugin returns "org.aspectj.org.eclipse.jdt.core".
 * getCode returns one of the status codes declared in
 * IJavaModelStatusConstants.
 * 
 * 
 * A Java model status may also carry additional information (that is, in
 * addition to the information defined in IStatus):
 * 

 *   elements - optional handles to Java elements associated with the failure
 *   string - optional string associated with the failure
 * 
 *
 * @see org.eclipse.core.runtime.IStatus
 * @see IJavaModelStatusConstants
 * @noimplement This interface is not intended to be implemented by clients.
 */
public interface IJavaModelStatus extends IStatus {
/**
 * Returns any Java elements associated with the failure (see specification
 * of the status code), or an empty array if no elements are related to this
 * particular status code.
 *
 * @return the list of Java element culprits
 * @see IJavaModelStatusConstants
 */
IJavaElement[] getElements();
/**
 * Returns the path associated with the failure (see specification
 * of the status code), or null if the failure is not
 * one of DEVICE_PATH, INVALID_PATH,
 * PATH_OUTSIDE_PROJECT, or RELATIVE_PATH.
 *
 * @return the path that caused the failure, or null if none
 * @see IJavaModelStatusConstants#DEVICE_PATH
 * @see IJavaModelStatusConstants#INVALID_PATH
 * @see IJavaModelStatusConstants#PATH_OUTSIDE_PROJECT
 * @see IJavaModelStatusConstants#RELATIVE_PATH
 */
IPath getPath();
/**
 * Returns the string associated with the failure (see specification
 * of the status code), or null if no string is related to this
 * particular status code.
 *
 * @return the string culprit, or null if none
 * @see IJavaModelStatusConstants
 * @deprecated Use {@link IStatus#getMessage()} instead
 */
String getString();
/**
 * Returns whether this status indicates that a Java model element does not exist.
 * This convenience method is equivalent to
 * getCode() == IJavaModelStatusConstants.ELEMENT_DOES_NOT_EXIST.
 *
 * @return true if the status code indicates that a Java model
 *   element does not exist
 * @see IJavaModelStatusConstants#ELEMENT_DOES_NOT_EXIST
 */
boolean isDoesNotExist();
}