X-Git-Url: http://git.phpeclipse.com diff --git a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IJavaElement.java b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IJavaElement.java index cea7b63..679a580 100644 --- a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IJavaElement.java +++ b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IJavaElement.java @@ -16,14 +16,15 @@ import org.eclipse.core.runtime.IPath; import org.eclipse.core.runtime.jobs.ISchedulingRule; /** - * Common protocol for all elements provided by the Java model. - * Java model elements are exposed to clients as handles to the actual underlying element. + * Common protocol for all elements provided by the Java model. Java model + * elements are exposed to clients as handles to the actual underlying element. * The Java model may hand out any number of handles for each element. Handles - * that refer to the same element are guaranteed to be equal, but not necessarily identical. + * that refer to the same element are guaranteed to be equal, but not + * necessarily identical. *
- * Methods annotated as "handle-only" do not require underlying elements to exist.
- * Methods that require underlying elements to exist throw
- * a JavaModelException
when an underlying element is missing.
+ * Methods annotated as "handle-only" do not require underlying elements to
+ * exist. Methods that require underlying elements to exist throw a
+ * JavaModelException
when an underlying element is missing.
* JavaModelException.isDoesNotExist
can be used to recognize
* this common special case.
*
IJavaModel
.
+ * Constant representing a Java model (workspace level object). A Java
+ * element with this type can be safely cast to IJavaModel
.
*/
int JAVA_MODEL = 1;
/**
- * Constant representing a Java project.
- * A Java element with this type can be safely cast to IJavaProject
.
+ * Constant representing a Java project. A Java element with this type can
+ * be safely cast to IJavaProject
.
*/
int JAVA_PROJECT = 2;
/**
- * Constant representing a package fragment root.
- * A Java element with this type can be safely cast to IPackageFragmentRoot
.
+ * Constant representing a package fragment root. A Java element with this
+ * type can be safely cast to IPackageFragmentRoot
.
*/
int PACKAGE_FRAGMENT_ROOT = 3;
/**
- * Constant representing a package fragment.
- * A Java element with this type can be safely cast to IPackageFragment
.
+ * Constant representing a package fragment. A Java element with this type
+ * can be safely cast to IPackageFragment
.
*/
int PACKAGE_FRAGMENT = 4;
/**
- * Constant representing a Java compilation unit.
- * A Java element with this type can be safely cast to ICompilationUnit
.
+ * Constant representing a Java compilation unit. A Java element with this
+ * type can be safely cast to ICompilationUnit
.
*/
int COMPILATION_UNIT = 5;
/**
- * Constant representing a class file.
- * A Java element with this type can be safely cast to IClassFile
.
+ * Constant representing a class file. A Java element with this type can be
+ * safely cast to IClassFile
.
*/
int CLASS_FILE = 6;
/**
- * Constant representing a type (a class or interface).
- * A Java element with this type can be safely cast to IType
.
+ * Constant representing a type (a class or interface). A Java element with
+ * this type can be safely cast to IType
.
*/
int TYPE = 7;
/**
- * Constant representing a field.
- * A Java element with this type can be safely cast to IField
.
+ * Constant representing a field. A Java element with this type can be
+ * safely cast to IField
.
*/
int FIELD = 8;
/**
- * Constant representing a method or constructor.
- * A Java element with this type can be safely cast to IMethod
.
+ * Constant representing a method or constructor. A Java element with this
+ * type can be safely cast to IMethod
.
*/
int METHOD = 9;
/**
- * Constant representing a stand-alone instance or class initializer.
- * A Java element with this type can be safely cast to IInitializer
.
+ * Constant representing a stand-alone instance or class initializer. A Java
+ * element with this type can be safely cast to IInitializer
.
*/
int INITIALIZER = 10;
/**
- * Constant representing a package declaration within a compilation unit.
- * A Java element with this type can be safely cast to IPackageDeclaration
.
+ * Constant representing a package declaration within a compilation unit. A
+ * Java element with this type can be safely cast to
+ * IPackageDeclaration
.
*/
int PACKAGE_DECLARATION = 11;
/**
* Constant representing all import declarations within a compilation unit.
- * A Java element with this type can be safely cast to IImportContainer
.
+ * A Java element with this type can be safely cast to
+ * IImportContainer
.
*/
int IMPORT_CONTAINER = 12;
/**
- * Constant representing an import declaration within a compilation unit.
- * A Java element with this type can be safely cast to IImportDeclaration
.
+ * Constant representing an import declaration within a compilation unit. A
+ * Java element with this type can be safely cast to
+ * IImportDeclaration
.
*/
int IMPORT_DECLARATION = 13;
/**
- * Constant representing a local variable declaration.
- * A Java element with this type can be safely cast to ILocalVariable
.
+ * Constant representing a local variable declaration. A Java element with
+ * this type can be safely cast to ILocalVariable
.
+ *
* @since 3.0
*/
int LOCAL_VARIABLE = 14;
+
/**
* Returns whether this Java element exists in the model.
*
@@ -125,205 +131,211 @@ public interface IJavaElement extends IAdaptable {
* said to "exist", and this method returns true
. For Java
* elements that are not working copies, it is always the case that if the
* element exists, then its parent also exists (provided it has one) and
- * includes the element as one of its children. It is therefore possible
- * to navigated to any existing Java element from the root of the Java model
+ * includes the element as one of its children. It is therefore possible to
+ * navigated to any existing Java element from the root of the Java model
* along a chain of existing Java elements. On the other hand, working
* copies are said to exist until they are destroyed (with
* IWorkingCopy.destroy
). Unlike regular Java elements, a
* working copy never shows up among the children of its parent element
* (which may or may not exist).
*
true
if this element exists in the Java model, and
- * false
if this element does not exist
+ * false
if this element does not exist
*/
boolean exists();
-
+
/**
* Returns the first ancestor of this Java element that has the given type.
- * Returns null
if no such an ancestor can be found.
- * This is a handle-only method.
+ * Returns null
if no such an ancestor can be found. This is
+ * a handle-only method.
*
- * @param ancestorType the given type
- * @return the first ancestor of this Java element that has the given type, null if no such an ancestor can be found
+ * @param ancestorType
+ * the given type
+ * @return the first ancestor of this Java element that has the given type,
+ * null if no such an ancestor can be found
* @since 2.0
*/
IJavaElement getAncestor(int ancestorType);
/**
- * Returns the resource that corresponds directly to this element,
- * or null
if there is no resource that corresponds to
- * this element.
+ * Returns the resource that corresponds directly to this element, or
+ * null
if there is no resource that corresponds to this
+ * element.
*
- * For example, the corresponding resource for an ICompilationUnit
- * is its underlying IFile
. The corresponding resource for
- * an IPackageFragment
that is not contained in an archive
- * is its underlying IFolder
. An IPackageFragment
- * contained in an archive has no corresponding resource. Similarly, there
- * are no corresponding resources for IMethods
,
- * IFields
, etc.
+ * For example, the corresponding resource for an
+ * ICompilationUnit
is its underlying IFile
.
+ * The corresponding resource for an IPackageFragment
that is
+ * not contained in an archive is its underlying IFolder
. An
+ * IPackageFragment
contained in an archive has no
+ * corresponding resource. Similarly, there are no corresponding resources
+ * for IMethods
, IFields
, etc.
*
- *
+ *
* @return the corresponding resource, or null
if none
- * @exception JavaModelException if this element does not exist or if an
- * exception occurs while accessing its corresponding resource
+ * @exception JavaModelException
+ * if this element does not exist or if an exception occurs
+ * while accessing its corresponding resource
*/
IResource getCorrespondingResource() throws JavaModelException;
/**
* Returns the name of this element. This is a handle-only method.
- *
+ *
* @return the element name
*/
String getElementName();
/**
- * Returns this element's kind encoded as an integer.
- * This is a handle-only method.
- *
+ * Returns this element's kind encoded as an integer. This is a handle-only
+ * method.
+ *
* @return the kind of element; one of the constants declared in
- * IJavaElement
+ * IJavaElement
* @see IJavaElement
*/
int getElementType();
/**
- * Returns a string representation of this element handle. The format of
- * the string is not specified; however, the identifier is stable across
- * workspace sessions, and can be used to recreate this handle via the
+ * Returns a string representation of this element handle. The format of the
+ * string is not specified; however, the identifier is stable across
+ * workspace sessions, and can be used to recreate this handle via the
* JavaCore.create(String)
method.
- *
+ *
* @return the string handle identifier
* @see JavaCore#create(java.lang.String)
*/
String getHandleIdentifier();
/**
- * Returns the Java model.
- * This is a handle-only method.
- *
+ * Returns the Java model. This is a handle-only method.
+ *
* @return the Java model
*/
- IJavaModel getJavaModel();
+ IJavaModel getJavaModel();
/**
- * Returns the Java project this element is contained in,
- * or null
if this element is not contained in any Java project
- * (for instance, the IJavaModel
is not contained in any Java
- * project).
- * This is a handle-only method.
- *
- * @return the containing Java project, or null
if this element is
- * not contained in a Java project
+ * Returns the Java project this element is contained in, or
+ * null
if this element is not contained in any Java project
+ * (for instance, the IJavaModel
is not contained in any Java
+ * project). This is a handle-only method.
+ *
+ * @return the containing Java project, or null
if this
+ * element is not contained in a Java project
*/
IJavaProject getJavaProject();
/**
- * Returns the first openable parent. If this element is openable, the element
- * itself is returned. Returns null
if this element doesn't have
- * an openable parent.
- * This is a handle-only method.
+ * Returns the first openable parent. If this element is openable, the
+ * element itself is returned. Returns null
if this element
+ * doesn't have an openable parent. This is a handle-only method.
*
- * @return the first openable parent or null
if this element doesn't have
- * an openable parent.
+ * @return the first openable parent or null
if this element
+ * doesn't have an openable parent.
* @since 2.0
*/
IOpenable getOpenable();
/**
- * Returns the element directly containing this element,
- * or null
if this element has no parent.
- * This is a handle-only method.
- *
- * @return the parent element, or null
if this element has no parent
+ * Returns the element directly containing this element, or
+ * null
if this element has no parent. This is a handle-only
+ * method.
+ *
+ * @return the parent element, or null
if this element has no
+ * parent
*/
IJavaElement getParent();
/**
- * Returns the path to the innermost resource enclosing this element.
- * If this element is not included in an external archive,
- * the path returned is the full, absolute path to the underlying resource,
- * relative to the workbench.
- * If this element is included in an external archive,
- * the path returned is the absolute path to the archive in the file system.
- * This is a handle-only method.
+ * Returns the path to the innermost resource enclosing this element. If
+ * this element is not included in an external archive, the path returned is
+ * the full, absolute path to the underlying resource, relative to the
+ * workbench. If this element is included in an external archive, the path
+ * returned is the absolute path to the archive in the file system. This is
+ * a handle-only method.
*
* @return the path to the innermost resource enclosing this element
* @since 2.0
*/
IPath getPath();
+
/**
- * Returns the primary element (whose compilation unit is the primary compilation unit)
- * this working copy element was created from, or this element if it is a descendant of a
- * primary compilation unit or if it is not a descendant of a working copy (e.g. it is a
- * binary member).
- * The returned element may or may not exist.
+ * Returns the primary element (whose compilation unit is the primary
+ * compilation unit) this working copy element was created from, or this
+ * element if it is a descendant of a primary compilation unit or if it is
+ * not a descendant of a working copy (e.g. it is a binary member). The
+ * returned element may or may not exist.
*
- * @return the primary element this working copy element was created from, or this
- * element.
+ * @return the primary element this working copy element was created from,
+ * or this element.
* @since 3.0
*/
IJavaElement getPrimaryElement();
+
/**
- * Returns the innermost resource enclosing this element.
- * If this element is included in an archive and this archive is not external,
- * this is the underlying resource corresponding to the archive.
- * If this element is included in an external archive, null
- * is returned.
- * If this element is a working copy, null
is returned.
- * This is a handle-only method.
+ * Returns the innermost resource enclosing this element. If this element is
+ * included in an archive and this archive is not external, this is the
+ * underlying resource corresponding to the archive. If this element is
+ * included in an external archive, null
is returned. If this
+ * element is a working copy, null
is returned. This is a
+ * handle-only method.
*
- * @return the innermost resource enclosing this element, null
if this
- * element is a working copy or is included in an external archive
+ * @return the innermost resource enclosing this element, null
+ * if this element is a working copy or is included in an external
+ * archive
* @since 2.0
*/
IResource getResource();
+
/**
- * Returns the scheduling rule associated with this Java element.
- * This is a handle-only method.
+ * Returns the scheduling rule associated with this Java element. This is a
+ * handle-only method.
*
* @return the scheduling rule associated with this Java element
* @since 3.0
*/
ISchedulingRule getSchedulingRule();
+
/**
- * Returns the smallest underlying resource that contains
- * this element, or null
if this element is not contained
- * in a resource.
- *
+ * Returns the smallest underlying resource that contains this element, or
+ * null
if this element is not contained in a resource.
+ *
* @return the underlying resource, or null
if none
- * @exception JavaModelException if this element does not exist or if an
- * exception occurs while accessing its underlying resource
+ * @exception JavaModelException
+ * if this element does not exist or if an exception occurs
+ * while accessing its underlying resource
*/
IResource getUnderlyingResource() throws JavaModelException;
/**
* Returns whether this Java element is read-only. An element is read-only
- * if its structure cannot be modified by the java model.
+ * if its structure cannot be modified by the java model.
*
* Note this is different from IResource.isReadOnly(). For example, .jar - * files are read-only as the java model doesn't know how to add/remove + * files are read-only as the java model doesn't know how to add/remove * elements in this file, but the underlying IFile can be writable. *
* This is a handle-only method.
- *
+ *
* @return true
if this element is read-only
*/
boolean isReadOnly();
/**
- * Returns whether the structure of this element is known. For example, for a
- * compilation unit that could not be parsed, false
is returned.
- * If the structure of an element is unknown, navigations will return reasonable
- * defaults. For example, getChildren
will return an empty collection.
+ * Returns whether the structure of this element is known. For example, for
+ * a compilation unit that could not be parsed, false
is
+ * returned. If the structure of an element is unknown, navigations will
+ * return reasonable defaults. For example, getChildren
will
+ * return an empty collection.
*
- * Note: This does not imply anything about consistency with the - * underlying resource/buffer contents. + * Note: This does not imply anything about consistency with the underlying + * resource/buffer contents. *
- * + * * @returntrue
if the structure of this element is known
- * @exception JavaModelException if this element does not exist or if an
- * exception occurs while accessing its corresponding resource
+ * @exception JavaModelException
+ * if this element does not exist or if an exception occurs
+ * while accessing its corresponding resource
*/
boolean isStructureKnown() throws JavaModelException;
}