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

Klasse SourceMapper

java.lang.Object

org.aspectj.org.eclipse.jdt.internal.core.util.ReferenceInfoAdapter

org.aspectj.org.eclipse.jdt.internal.core.SourceMapper

Alle implementierten Schnittstellen:

ISourceElementRequestor, SuffixConstants

public class SourceMapper
extends ReferenceInfoAdapter
implements ISourceElementRequestor, SuffixConstants

A SourceMapper maps source code in a ZIP file to binary types or binary modules in a JAR. The SourceMapper uses the fuzzy parser to identify source fragments in a .java file, and attempts to match the source code with children in a binary type. Since a module has no children in the Java Model no such matching happens in that case. A SourceMapper is associated with a JarPackageFragment by an AttachSourceOperation.

Siehe auch:

• ungültiges @see

  org.eclipse.jdt.internal.core.JarPackageFragment

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

Modifizierer und Typ	Klasse	Beschreibung
static class	SourceMapper.LocalVariableElementKey

Von Schnittstelle geerbte verschachtelte Klassen/Schnittstellen org.aspectj.org.eclipse.jdt.internal.compiler.ISourceElementRequestor

ISourceElementRequestor.FieldInfo, ISourceElementRequestor.MethodInfo, ISourceElementRequestor.ModuleInfo, ISourceElementRequestor.PackageExportInfo, ISourceElementRequestor.ParameterInfo, ISourceElementRequestor.RequiresInfo, ISourceElementRequestor.ServicesInfo, ISourceElementRequestor.TypeInfo, ISourceElementRequestor.TypeParameterInfo

Feldübersicht

Felder

Modifizierer und Typ	Feld	Beschreibung
protected NamedMember	binaryTypeOrModule	The binary type or module source is being mapped for
protected HashMap	categories
protected HashSet	finalParameters	Set that contains all final local variables.
protected int[]	memberDeclarationStart	The position within the source of the start of the current member element, or -1 if we are outside a member.
protected String[]	memberName	The name of the current member element.
protected SourceRange[]	memberNameRange	The SourceRange of the name of the current member element.
protected char[][][]	methodParameterNames	The parameter names for the current member method element.
protected char[][][]	methodParameterTypes	The parameter types for the current member method element.
protected HashMap	parameterNames	Table that maps a binary method to its parameter names.
protected HashMap	parametersRanges	Table that contains all source ranges for local variables.
protected String	rootPath	Specifies the location of the package fragment root within the zip (empty specifies the default root).
protected ArrayList	rootPaths	Specifies the location of the package fragment roots within the zip (empty specifies the default root).
protected IJavaElement	searchedElement	The element searched for
protected org.eclipse.core.runtime.IPath	sourcePath	The location of the zip file containing source.
protected HashMap	sourceRanges	Table that maps a binary element to its SourceRanges.
static final SourceRange	UNKNOWN_RANGE	The unknown source range {-1, 0}
static boolean	VERBOSE

Von Schnittstelle geerbte Felder org.aspectj.org.eclipse.jdt.internal.compiler.util.SuffixConstants

EXTENSION_aj, EXTENSION_AJ, EXTENSION_class, EXTENSION_CLASS, EXTENSION_java, EXTENSION_JAVA, EXTENSION_jmod, EXTENSION_JMOD, SUFFIX_aj, SUFFIX_AJ, SUFFIX_class, SUFFIX_CLASS, SUFFIX_java, SUFFIX_JAVA, SUFFIX_STRING_aj, SUFFIX_STRING_AJ, SUFFIX_STRING_class, SUFFIX_STRING_CLASS, SUFFIX_STRING_java, SUFFIX_STRING_JAVA

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
SourceMapper()
SourceMapper(org.eclipse.core.runtime.IPath sourcePath, String rootPath, Map options)
SourceMapper(org.eclipse.core.runtime.IPath sourcePath, String rootPath, Map options, String encoding)	Creates a SourceMapper that locates source in the zip file at the given location in the specified package fragment root.

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
void	acceptImport(int declarationStart, int declarationEnd, int nameStart, int nameEnd, char[][] tokens, boolean onDemand, int modifiers)
void	acceptLineSeparatorPositions(int[] positions)
void	acceptPackage(ImportReference importReference)
void	acceptProblem(CategorizedProblem problem)
void	close()	Closes this SourceMapper's zip file.
String[]	convertTypeNamesToSigs(char[][] typeNames)	NOT API, public only for access by Unit tests.
void	enterCompilationUnit()
void	enterConstructor(ISourceElementRequestor.MethodInfo methodInfo)
void	enterField(ISourceElementRequestor.FieldInfo fieldInfo)
void	enterInitializer(int declarationSourceStart, int modifiers)
void	enterMethod(ISourceElementRequestor.MethodInfo methodInfo)
void	enterModule(ISourceElementRequestor.ModuleInfo moduleInfo)
void	enterType(ISourceElementRequestor.TypeInfo typeInfo)
void	exitCompilationUnit(int declarationEnd)
void	exitConstructor(int declarationEnd)
void	exitField(int initializationStart, int declarationEnd, int declarationSourceEnd)
void	exitInitializer(int declarationEnd)
void	exitMethod(int declarationEnd, Expression defaultValue)
void	exitModule(int declarationEnd)
void	exitRecordComponent(int declarationEnd, int declarationSourceEnd)
void	exitType(int declarationEnd)
char[]	findSource(String fullName)
char[]	findSource(IModuleDescription module)	Locates and returns source code for the given (binary) module, in this SourceMapper's ZIP file, or returns null if source code cannot be found.
char[]	findSource(IType type, String simpleSourceFileName)	Locates and returns source code for the given (binary) type, in this SourceMapper's ZIP file, or returns null if source code cannot be found.
char[]	findSource(IType type, IBinaryType info)	Locates and returns source code for the given (binary) type, in this SourceMapper's ZIP file, or returns null if source code cannot be found.
int	getFlags(IJavaElement element)
char[][]	getImports(Member typeOrModule)	Return a char[][] array containing the imports of the attached source for the binary type
char[][]	getMethodParameterNames(IMethod method)	Returns parameters names for the given method, or null if no parameter names are known for the method.
SourceRange	getNameRange(IJavaElement element)	Returns the SourceRange for the name of the given element, or {-1, -1} if no source range is known for the name of the element.
SourceRange	getSourceRange(IJavaElement element)	Returns the SourceRange for the given element, or {-1, -1} if no source range is known for the element.
protected IType	getType(String typeName)	Returns the type with the given typeName.
protected IJavaElement[]	getUnqualifiedMethodHandle(IMethod method, boolean noDollar)	Creates a handle that has parameter types that are not fully qualified so that the correct source is found.
void	mapSource(NamedMember typeOrModule, char[] contents, IBinaryType info)	Maps the given source code to the given binary type or module and its children.
ISourceRange	mapSource(NamedMember typeOrModule, char[] contents, IBinaryType info, IJavaElement elementToFind)	Maps the given source code to the given binary type and its children.
protected void	setMethodParameterNames(IMethod method, char[][] parameterNames)	Sets the mapping for this method to its parameter names.
protected void	setSourceRange(IJavaElement element, SourceRange sourceRange, SourceRange nameRange)	Sets the mapping for this element to its source ranges for its source range and name range.

Von Klasse geerbte Methoden org.aspectj.org.eclipse.jdt.internal.core.util.ReferenceInfoAdapter

acceptAnnotationTypeReference, acceptAnnotationTypeReference, acceptConstructorReference, acceptFieldReference, acceptMethodReference, acceptTypeReference, acceptTypeReference, acceptUnknownReference, acceptUnknownReference

Von Klasse geerbte Methoden java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Von Schnittstelle geerbte Methoden org.aspectj.org.eclipse.jdt.internal.compiler.ISourceElementRequestor

acceptAnnotationTypeReference, acceptAnnotationTypeReference, acceptConstructorReference, acceptFieldReference, acceptMethodReference, acceptTypeReference, acceptTypeReference, acceptUnknownReference, acceptUnknownReference

Felddetails

VERBOSE

public static boolean VERBOSE

rootPaths

protected ArrayList rootPaths

Specifies the location of the package fragment roots within the zip (empty specifies the default root). null is not a valid root path.

binaryTypeOrModule

protected NamedMember binaryTypeOrModule

The binary type or module source is being mapped for

sourcePath

protected org.eclipse.core.runtime.IPath sourcePath

The location of the zip file containing source.

rootPath

protected String rootPath

Specifies the location of the package fragment root within the zip (empty specifies the default root). null is not a valid root path.

parameterNames

protected HashMap parameterNames

Table that maps a binary method to its parameter names. Keys are the method handles, entries are char[][].

sourceRanges

protected HashMap sourceRanges

Table that maps a binary element to its SourceRanges. Keys are the element handles, entries are SourceRange[] which is a two element array; the first being source range, the second being name range.

categories

protected HashMap categories

parametersRanges

protected HashMap parametersRanges

Table that contains all source ranges for local variables. Keys are the special local variable elements, entries are char[][].

finalParameters

protected HashSet finalParameters

Set that contains all final local variables.

UNKNOWN_RANGE

public static final SourceRange UNKNOWN_RANGE

The unknown source range {-1, 0}

memberDeclarationStart

protected int[] memberDeclarationStart

The position within the source of the start of the current member element, or -1 if we are outside a member.

memberNameRange

protected SourceRange[] memberNameRange

The SourceRange of the name of the current member element.

memberName

protected String[] memberName

The name of the current member element.

methodParameterNames

protected char[][][] methodParameterNames

The parameter names for the current member method element.

methodParameterTypes

protected char[][][] methodParameterTypes

The parameter types for the current member method element.

searchedElement

protected IJavaElement searchedElement

The element searched for

Konstruktordetails

SourceMapper

public SourceMapper()

SourceMapper

public SourceMapper(org.eclipse.core.runtime.IPath sourcePath,
 String rootPath,
 Map options)

SourceMapper

public SourceMapper(org.eclipse.core.runtime.IPath sourcePath,
 String rootPath,
 Map options,
 String encoding)

Creates a SourceMapper that locates source in the zip file at the given location in the specified package fragment root.

Methodendetails

acceptImport

public void acceptImport(int declarationStart,
 int declarationEnd,
 int nameStart,
 int nameEnd,
 char[][] tokens,
 boolean onDemand,
 int modifiers)

Angegeben von:

acceptImport in Schnittstelle ISourceElementRequestor

Parameter:

declarationStart - This is the position of the first character of the import keyword.

declarationEnd - This is the position of the ';' ending the import statement or the end of the comment following the import.

nameStart - This is the position of the first character of the import declaration's name.

nameEnd - This is the position of the last character of the import declaration's name.

tokens - This are the tokens of the import like specified in the source.

onDemand - set to true if the import is an import on demand (e.g. import java.io.*). False otherwise.

modifiers - can be set to static from 1.5 on.

Siehe auch:

• ISourceElementRequestor

acceptLineSeparatorPositions

public void acceptLineSeparatorPositions(int[] positions)

Angegeben von:

acceptLineSeparatorPositions in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

acceptPackage

public void acceptPackage(ImportReference importReference)

Angegeben von:

acceptPackage in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

acceptProblem

public void acceptProblem(CategorizedProblem problem)

Angegeben von:

acceptProblem in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

close

public void close()

Closes this SourceMapper's zip file. Once this is done, this SourceMapper cannot be used again.

convertTypeNamesToSigs

public String[] convertTypeNamesToSigs(char[][] typeNames)

NOT API, public only for access by Unit tests. Converts these type names to unqualified signatures. This needs to be done in order to be consistent with the way the source range is retrieved.

Siehe auch:

• getUnqualifiedMethodHandle(org.aspectj.org.eclipse.jdt.core.IMethod, boolean)
• Signature

enterType

public void enterType(ISourceElementRequestor.TypeInfo typeInfo)

Angegeben von:

enterType in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

enterModule

public void enterModule(ISourceElementRequestor.ModuleInfo moduleInfo)

Angegeben von:

enterModule in Schnittstelle ISourceElementRequestor

exitModule

public void exitModule(int declarationEnd)

Angegeben von:

exitModule in Schnittstelle ISourceElementRequestor

enterCompilationUnit

public void enterCompilationUnit()

Angegeben von:

enterCompilationUnit in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

enterConstructor

public void enterConstructor(ISourceElementRequestor.MethodInfo methodInfo)

Angegeben von:

enterConstructor in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

enterField

public void enterField(ISourceElementRequestor.FieldInfo fieldInfo)

Angegeben von:

enterField in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

enterInitializer

public void enterInitializer(int declarationSourceStart,
 int modifiers)

Angegeben von:

enterInitializer in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

enterMethod

public void enterMethod(ISourceElementRequestor.MethodInfo methodInfo)

Angegeben von:

enterMethod in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

exitType

public void exitType(int declarationEnd)

Angegeben von:

exitType in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

exitCompilationUnit

public void exitCompilationUnit(int declarationEnd)

Angegeben von:

exitCompilationUnit in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

exitConstructor

public void exitConstructor(int declarationEnd)

Angegeben von:

exitConstructor in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

exitField

public void exitField(int initializationStart,
 int declarationEnd,
 int declarationSourceEnd)

Angegeben von:

exitField in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

exitRecordComponent

public void exitRecordComponent(int declarationEnd,
 int declarationSourceEnd)

Angegeben von:

exitRecordComponent in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

exitInitializer

public void exitInitializer(int declarationEnd)

Angegeben von:

exitInitializer in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

exitMethod

public void exitMethod(int declarationEnd,
 Expression defaultValue)

Angegeben von:

exitMethod in Schnittstelle ISourceElementRequestor

Siehe auch:

• ISourceElementRequestor

findSource

public char[] findSource(IType type,
 IBinaryType info)

Locates and returns source code for the given (binary) type, in this SourceMapper's ZIP file, or returns null if source code cannot be found.

findSource

public char[] findSource(IType type,
 String simpleSourceFileName)

Locates and returns source code for the given (binary) type, in this SourceMapper's ZIP file, or returns null if source code cannot be found. The given simpleSourceFileName is the .java file name (without the enclosing folder) used to create the given type (e.g. "A.java" for x/y/A$Inner.class)

findSource

public char[] findSource(IModuleDescription module)

Locates and returns source code for the given (binary) module, in this SourceMapper's ZIP file, or returns null if source code cannot be found.

findSource

public char[] findSource(String fullName)

getFlags

public int getFlags(IJavaElement element)

getNameRange

public SourceRange getNameRange(IJavaElement element)

Returns the SourceRange for the name of the given element, or {-1, -1} if no source range is known for the name of the element.

getMethodParameterNames

public char[][] getMethodParameterNames(IMethod method)

Returns parameters names for the given method, or null if no parameter names are known for the method.

getSourceRange

public SourceRange getSourceRange(IJavaElement element)

Returns the SourceRange for the given element, or {-1, -1} if no source range is known for the element.

getType

protected IType getType(String typeName)

Returns the type with the given typeName. Returns inner classes as well.

getUnqualifiedMethodHandle

protected IJavaElement[] getUnqualifiedMethodHandle(IMethod method,
 boolean noDollar)

Creates a handle that has parameter types that are not fully qualified so that the correct source is found.

mapSource

public void mapSource(NamedMember typeOrModule,
 char[] contents,
 IBinaryType info)

Maps the given source code to the given binary type or module and its children.

mapSource

public ISourceRange mapSource(NamedMember typeOrModule,
 char[] contents,
 IBinaryType info,
 IJavaElement elementToFind)

Maps the given source code to the given binary type and its children. If a non-null java element is passed, finds the name range for the given java element without storing it.

setMethodParameterNames

protected void setMethodParameterNames(IMethod method,
 char[][] parameterNames)

Sets the mapping for this method to its parameter names.

Siehe auch:

• parameterNames

setSourceRange

protected void setSourceRange(IJavaElement element,
 SourceRange sourceRange,
 SourceRange nameRange)

Sets the mapping for this element to its source ranges for its source range and name range.

Siehe auch:

• sourceRanges

getImports

public char[][] getImports(Member typeOrModule)

Return a char[][] array containing the imports of the attached source for the binary type