Package org.aspectj.org.eclipse.jdt.internal.core

Class LocalVariable

java.lang.Object

org.eclipse.core.runtime.PlatformObject

org.aspectj.org.eclipse.jdt.internal.core.JavaElement

org.aspectj.org.eclipse.jdt.internal.core.SourceRefElement

org.aspectj.org.eclipse.jdt.internal.core.LocalVariable

All Implemented Interfaces:

IAnnotatable, IJavaElement, ILocalVariable, ISourceReference, org.eclipse.core.runtime.IAdaptable

public class LocalVariable
extends SourceRefElement
implements ILocalVariable

Field Summary

Fields

Modifier and Type	Field	Description
IAnnotation[]	annotations
IAnnotation[][]	annotationsOnDimensions
final int	declarationSourceEnd
final int	declarationSourceStart
final int	nameEnd
final int	nameStart
static final ILocalVariable[]	NO_LOCAL_VARIABLES

Fields inherited from class org.aspectj.org.eclipse.jdt.internal.core.JavaElement

JEM_ANNOTATION, JEM_CLASSFILE, JEM_COMPILATIONUNIT, JEM_COUNT, JEM_DELIMITER_ESCAPE, JEM_ESCAPE, JEM_FIELD, JEM_IMPORTDECLARATION, JEM_INITIALIZER, JEM_JAVAPROJECT, JEM_LAMBDA_EXPRESSION, JEM_LAMBDA_METHOD, JEM_LOCALVARIABLE, JEM_METHOD, JEM_MODULAR_CLASSFILE, JEM_MODULE, JEM_PACKAGEDECLARATION, JEM_PACKAGEFRAGMENT, JEM_PACKAGEFRAGMENTROOT, JEM_STRING, JEM_TYPE, JEM_TYPE_PARAMETER, NO_ELEMENTS, NO_INFO, NO_STRINGS

Fields inherited from interface org.aspectj.org.eclipse.jdt.core.IJavaElement

ANNOTATION, CLASS_FILE, COMPILATION_UNIT, FIELD, IMPORT_CONTAINER, IMPORT_DECLARATION, INITIALIZER, JAVA_MODEL, JAVA_MODULE, JAVA_PROJECT, LOCAL_VARIABLE, METHOD, PACKAGE_DECLARATION, PACKAGE_FRAGMENT, PACKAGE_FRAGMENT_ROOT, TYPE, TYPE_PARAMETER

Constructor Summary

Constructors

Constructor	Description
LocalVariable(JavaElement parent, String name, int declarationSourceStart, int declarationSourceEnd, int nameStart, int nameEnd, String typeSignature, Annotation[] astAnnotations, int flags, boolean isParameter)
LocalVariable(JavaElement parent, String name, int declarationSourceStart, int declarationSourceEnd, int nameStart, int nameEnd, String typeSignature, Annotation[] astAnnotations, int flags, boolean isParameter, Annotation[][] astAnnotationsOnDimensions)

Method Summary

Modifier and Type	Method	Description
protected int	calculateHashCode()
protected void	closing(Object info)	This element is being closed.
protected JavaElementInfo	createElementInfo()	Returns a new element info for this element.
boolean	equals(Object o)	Returns true if this handle represents the same Java element as the given handle.
boolean	exists()	Returns whether this Java element exists in the model.
protected void	generateInfos(IElementInfo info, Map<IJavaElement,IElementInfo> newElements, org.eclipse.core.runtime.IProgressMonitor pm)	Generates the element infos for this element, its ancestors (if they are not opened) and its children (if it is an Openable).
IAnnotation	getAnnotation(String annotationName)	Returns the annotation with the given name declared on this element.
IAnnotation[]	getAnnotations()	Returns the annotations for this element.
ClassFile	getClassFile()
org.eclipse.core.resources.IResource	getCorrespondingResource()	Elements within compilation units and class files have no corresponding resource.
IMember	getDeclaringMember()	Returns the declaring member of this local variable.
String	getElementName()	Returns the name of this element.
int	getElementType()	Returns this element's kind encoded as an integer.
int	getFlags()	Returns the modifier flags for this local variable.
IJavaElement	getHandleFromMemento(String token, MementoTokenizer memento, WorkingCopyOwner owner)
protected void	getHandleMemento(StringBuilder buff)
protected void	getHandleMemento(StringBuilder buff, boolean memoizeParent)
protected char	getHandleMementoDelimiter()	Returns the char that marks the start of this handles contribution to a memento.
String	getKey(boolean forceOpen)
ISourceRange	getNameRange()	Returns the name range associated with this element.
org.eclipse.core.runtime.IPath	getPath()	Returns the path to the innermost resource enclosing this element.
String	getSource()	Returns the source code associated with this element.
ISourceRange	getSourceRange()	Returns the source range associated with this element.
ITypeRoot	getTypeRoot()	Returns the Java type root in which this local variable is declared.
String	getTypeSignature()	Returns the type signature of this local variable.
org.eclipse.core.resources.IResource	getUnderlyingResource()	Returns the smallest underlying resource that contains this element, or null if this element is not contained in a resource.
boolean	isParameter()	Returns true if this local variable is a method parameter, false otherwise.
boolean	isStructureKnown()	Returns whether the structure of this element is known.
org.eclipse.core.resources.IResource	resource()
protected void	toStringInfo(int tab, StringBuilder buffer, Object info, boolean showResolvedInfo)	Debugging purposes

Methods inherited from class org.aspectj.org.eclipse.jdt.internal.core.SourceRefElement

copy, delete, findNode, getCompilationUnit, getHandleUpdatingCountFromMemento, getOccurrenceCount, getOpenableParent, hasChildren, incOccurrenceCount, move, rename, setOccurrenceCount, toStringName

Methods inherited from class org.aspectj.org.eclipse.jdt.internal.core.JavaElement

appendEscapedDelimiter, close, escapeMementoName, getAncestor, getAttachedJavadoc, getChildren, getChildrenOfType, getElementInfo, getElementInfo, getHandleFromMemento, getHandleIdentifier, getHandleMemento, getJavadocBaseLocation, getJavaModel, getJavaProject, getLibraryJavadocLocation, getOpenable, getParent, getPrimaryElement, getPrimaryElement, getResource, getSchedulingRule, getSourceElementAt, getSourceMapper, getURLContents, hashCode, isAncestorOf, isReadOnly, newDoesNotExistStatus, newJavaModelException, newNotPresentException, openWhenClosed, readableName, resetHashCode, resolved, tabString, toDebugString, toString, toString, toStringAncestors, toStringChildren, toStringInfo, toStringWithAncestors, toStringWithAncestors, unresolved, validateAndCache

Methods inherited from class org.eclipse.core.runtime.PlatformObject

getAdapter

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.eclipse.core.runtime.IAdaptable

getAdapter

Methods inherited from interface org.aspectj.org.eclipse.jdt.core.IJavaElement

getAncestor, getAttachedJavadoc, getHandleIdentifier, getJavaModel, getJavaProject, getOpenable, getParent, getPrimaryElement, getResource, getSchedulingRule, isReadOnly

Field Details

NO_LOCAL_VARIABLES

public static final ILocalVariable[] NO_LOCAL_VARIABLES

declarationSourceStart

public final int declarationSourceStart

declarationSourceEnd

public final int declarationSourceEnd

nameStart

public final int nameStart

nameEnd

public final int nameEnd

annotations

public IAnnotation[] annotations

annotationsOnDimensions

public IAnnotation[][] annotationsOnDimensions

Constructor Details

LocalVariable

public LocalVariable(JavaElement parent,
 String name,
 int declarationSourceStart,
 int declarationSourceEnd,
 int nameStart,
 int nameEnd,
 String typeSignature,
 Annotation[] astAnnotations,
 int flags,
 boolean isParameter)

LocalVariable

public LocalVariable(JavaElement parent,
 String name,
 int declarationSourceStart,
 int declarationSourceEnd,
 int nameStart,
 int nameEnd,
 String typeSignature,
 Annotation[] astAnnotations,
 int flags,
 boolean isParameter,
 Annotation[][] astAnnotationsOnDimensions)

Method Details

closing

protected void closing(Object info)

Description copied from class: SourceRefElement

This element is being closed. Do any necessary cleanup.

Overrides:

closing in class SourceRefElement

createElementInfo

protected JavaElementInfo createElementInfo()

Description copied from class: SourceRefElement

Returns a new element info for this element.

Overrides:

createElementInfo in class SourceRefElement

equals

public boolean equals(Object o)

Description copied from class: JavaElement

Returns true if this handle represents the same Java element as the given handle. By default, two handles represent the same element if they are identical or if they represent the same type of element, have equal names, parents, and occurrence counts.

If a subclass has other requirements for equality, this method must be overridden.

Overrides:

equals in class SourceRefElement

See Also:

• Object.equals(java.lang.Object)

calculateHashCode

protected int calculateHashCode()

Overrides:

calculateHashCode in class SourceRefElement

exists

public boolean exists()

Description copied from interface: IJavaElement

Returns whether this Java element exists in the model.

Java elements are handle objects that may or may not be backed by an actual element. Java elements that are backed by an actual element are 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 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).

Specified by:

exists in interface IJavaElement

Specified by:

exists in interface ISourceReference

Overrides:

exists in class JavaElement

Returns:

true if this element exists in the Java model, and false if this element does not exist

See Also:

• IJavaElement

generateInfos

protected void generateInfos(IElementInfo info,
 Map<IJavaElement,IElementInfo> newElements,
 org.eclipse.core.runtime.IProgressMonitor pm)

Description copied from class: JavaElement

Generates the element infos for this element, its ancestors (if they are not opened) and its children (if it is an Openable). Puts the newly created element info in the given map.

Overrides:

generateInfos in class SourceRefElement

getAnnotation

public IAnnotation getAnnotation(String annotationName)

Description copied from interface: IAnnotatable

Returns the annotation with the given name declared on this element. This is a handle-only method. The annotation may or may not exist.

Specified by:

getAnnotation in interface IAnnotatable

Overrides:

getAnnotation in class SourceRefElement

Parameters:

annotationName - the given simple name

Returns:

the annotation with the given name declared on this element

getAnnotations

public IAnnotation[] getAnnotations()
                             throws JavaModelException

Description copied from interface: IAnnotatable

Returns the annotations for this element. Returns an empty array if this element has no annotations.

Specified by:

getAnnotations in interface IAnnotatable

Overrides:

getAnnotations in class SourceRefElement

Returns:

the annotations of this element, in the order declared in the source, or an empty array if none

Throws:

JavaModelException - if this element does not exist or if an exception occurs while accessing its corresponding resource.

getHandleFromMemento

public IJavaElement getHandleFromMemento(String token,
 MementoTokenizer memento,
 WorkingCopyOwner owner)

Overrides:

getHandleFromMemento in class SourceRefElement

getHandleMemento

protected void getHandleMemento(StringBuilder buff)

Overrides:

getHandleMemento in class SourceRefElement

getHandleMemento

protected void getHandleMemento(StringBuilder buff,
 boolean memoizeParent)

getHandleMementoDelimiter

protected char getHandleMementoDelimiter()

Description copied from class: JavaElement

Returns the char that marks the start of this handles contribution to a memento.

Specified by:

getHandleMementoDelimiter in class JavaElement

getCorrespondingResource

public org.eclipse.core.resources.IResource getCorrespondingResource()

Description copied from class: SourceRefElement

Elements within compilation units and class files have no corresponding resource.

Specified by:

getCorrespondingResource in interface IJavaElement

Overrides:

getCorrespondingResource in class SourceRefElement

Returns:

the corresponding resource, or null if none

See Also:

• IJavaElement

getDeclaringMember

public IMember getDeclaringMember()

Returns the declaring member of this local variable.

This is a handle-only method.

Specified by:

getDeclaringMember in interface ILocalVariable

Returns:

the declaring member of this local variable

Since:

3.7

getElementName

public String getElementName()

Description copied from interface: IJavaElement

Returns the name of this element. This is a handle-only method.

Specified by:

getElementName in interface IJavaElement

Specified by:

getElementName in interface ILocalVariable

Overrides:

getElementName in class JavaElement

Returns:

the element name

See Also:

• IAdaptable

getElementType

public int getElementType()

Description copied from interface: IJavaElement

Returns this element's kind encoded as an integer. This is a handle-only method.

Specified by:

getElementType in interface IJavaElement

Returns:

the kind of element; one of the constants declared in IJavaElement

See Also:

• IJavaElement

getFlags

public int getFlags()

Returns the modifier flags for this local variable. The flags can be examined using class Flags.

Note that only flags as indicated in the source are returned.

Specified by:

getFlags in interface ILocalVariable

Returns:

the modifier flags for this local variable

Since:

3.7

See Also:

• Flags

getClassFile

public ClassFile getClassFile()

Overrides:

getClassFile in class JavaElement

See Also:

• IMember.getClassFile()

getNameRange

public ISourceRange getNameRange()

Returns the name range associated with this element.

If the element is an IMember, it returns the source range of this member's simple name, or null if this member does not have a name (for example, an initializer), or if this member does not have associated source code (for example, a binary type).

If this element is an IImportDeclaration, the source range of this import declaration's name, or null if this import declaration does not have associated source code (for example, a binary type).
The source range for the name includes the trailing '*' if the call to IImportDeclaration.isOnDemand() returns true.

If this element is an IPackageDeclaration, the source range of this package declaration's name, or null if this package declaration does not have associated source code (for example, a binary type).

If this element is an IAnnotation, the source range of this annotation's name, or null if this annotation does not have associated source code (for example, in a binary type).

If this element is an ITypeParameter, the source range of this type parameter's name, or null if this type parameter does not have associated source code (for example, in a binary type).

If this element is an ITypeRoot or IImportContainer, it returns null.

Specified by:

getNameRange in interface ILocalVariable

Specified by:

getNameRange in interface ISourceReference

Returns:

the name range associated with this element, or null if not available

Since:

3.7

getPath

public org.eclipse.core.runtime.IPath getPath()

Description copied from interface: IJavaElement

Returns the path to the innermost resource enclosing this element. If this element is not included in an external library, the path returned is the full, absolute path to the underlying resource, relative to the workbench. If this element is included in an external library, the path returned is the absolute path to the archive or to the folder in the file system. This is a handle-only method.

Specified by:

getPath in interface IJavaElement

Overrides:

getPath in class SourceRefElement

Returns:

the path to the innermost resource enclosing this element

resource

public org.eclipse.core.resources.IResource resource()

Overrides:

resource in class SourceRefElement

getSource

public String getSource()
                 throws JavaModelException

Description copied from interface: ISourceReference

Returns the source code associated with this element. This extracts the substring from the source buffer containing this source element. This corresponds to the source range that would be returned by getSourceRange.

For class files, this returns the source of the entire compilation unit associated with the class file (if there is one).

Specified by:

getSource in interface ISourceReference

Overrides:

getSource in class SourceRefElement

Returns:

the source code, or null if this element has no associated source code

Throws:

JavaModelException - if an exception occurs while accessing its corresponding resource

See Also:

• ISourceReference

getSourceRange

public ISourceRange getSourceRange()
                            throws JavaModelException

Returns the source range associated with this element.

For class files, this returns the range of the entire compilation unit associated with the class file (if there is one).

If this element has no associated source code, either null is returned, or a source range with a -1 offset and a 0 length. SourceRange.isAvailable(ISourceRange) can be used to detect that case.

Specified by:

getSourceRange in interface ISourceReference

Overrides:

getSourceRange in class SourceRefElement

Returns:

the source range, or either null or [-1, 0] if this element has no associated source code

Throws:

JavaModelException - if an exception occurs while accessing its corresponding resource

Since:

3.7

See Also:

• ISourceReference

getTypeRoot

public ITypeRoot getTypeRoot()

Returns the Java type root in which this local variable is declared.

This is a handle-only method.

Specified by:

getTypeRoot in interface ILocalVariable

Returns:

the Java type root in which this local variable is declared

Since:

3.7

getTypeSignature

public String getTypeSignature()

Description copied from interface: ILocalVariable

Returns the type signature of this local variable.

The type signature may be either unresolved (for source types) or resolved (for binary types), and either basic (for basic types) or rich (for parameterized types). See Signature for details.

Specified by:

getTypeSignature in interface ILocalVariable

Returns:

the type signature of this local variable.

See Also:

• Signature

getUnderlyingResource

public org.eclipse.core.resources.IResource getUnderlyingResource()
                                                           throws JavaModelException

Description copied from interface: IJavaElement

Returns the smallest underlying resource that contains this element, or null if this element is not contained in a resource.

Specified by:

getUnderlyingResource in interface IJavaElement

Overrides:

getUnderlyingResource in class SourceRefElement

Returns:

the underlying resource, or null if none

Throws:

JavaModelException - if this element does not exist or if an exception occurs while accessing its underlying resource

See Also:

• IJavaElement

isParameter

public boolean isParameter()

Returns true if this local variable is a method parameter, false otherwise.

Specified by:

isParameter in interface ILocalVariable

Returns:

true if this local variable is a method parameter, false otherwise

Since:

3.7

isStructureKnown

public boolean isStructureKnown()
                         throws JavaModelException

Description copied from interface: IJavaElement

Returns whether the structure of this element is known. For example, for a compilation unit that has syntax errors, false is returned. If the structure of an element is unknown, navigations will return reasonable defaults. For example, getChildren for a compilation unit with syntax errors will return a collection of the children that could be parsed.

Note: This does not imply anything about consistency with the underlying resource/buffer contents.

Specified by:

isStructureKnown in interface IJavaElement

Overrides:

isStructureKnown in class SourceRefElement

Returns:

true if the structure of this element is known

Throws:

JavaModelException - if this element does not exist or if an exception occurs while accessing its corresponding resource

See Also:

• IJavaElement

getKey

public String getKey(boolean forceOpen)
              throws JavaModelException

Throws:

JavaModelException

See Also:

• invalid reference

  org.eclipse.jdt.internal.compiler.lookup.Binding#computeUniqueKey()

toStringInfo

protected void toStringInfo(int tab,
 StringBuilder buffer,
 Object info,
 boolean showResolvedInfo)

Description copied from class: JavaElement

Debugging purposes

Overrides:

toStringInfo in class JavaElement

Parameters:

showResolvedInfo - TODO