Package com.github.javaparser.symbolsolver.javaparsermodel

Class JavaParserFacade

java.lang.Object

com.github.javaparser.symbolsolver.javaparsermodel.JavaParserFacade

public class JavaParserFacade
extends Object

Class to be used by final users to solve symbols for JavaParser ASTs.

Author:

Federico Tomassetti

Method Summary

Modifier and Type	Method	Description
ResolvedType	classToResolvedType(Class<?> clazz)	Convert a Class into the corresponding ResolvedType.
static void	clearInstances()	This method is used to clear internal caches for the sake of releasing memory.
ResolvedType	convert(Type type, Node node)
ResolvedType	convert(Type type, Context context)
protected ResolvedType	convertArrayTypeToUsage(ArrayType arrayType, Context context)	Convert a ArrayType into a ResolvedType.
protected ResolvedType	convertClassOrInterfaceTypeToUsage(ClassOrInterfaceType classOrInterfaceType, Context context)	Convert a ClassOrInterfaceType into a ResolvedType.
ResolvedType	convertToUsage(Type type)	Convert a Type into the corresponding ResolvedType.
ResolvedType	convertToUsage(Type type, Node context)	Convert a Type into the corresponding ResolvedType.
protected ResolvedType	convertToUsage(Type type, Context context)	Convert a Type into the corresponding ResolvedType.
ResolvedType	convertToUsageVariableType(VariableDeclarator var)
protected ResolvedType	convertUnionTypeToUsage(UnionType unionType, Context context)	Convert a UnionType into a ResolvedType.
protected ResolvedType	convertVarTypeToUsage(VarType varType, Context context)	Convert a VarType into a ResolvedType.
protected ResolvedType	convertWildcardTypeToUsage(WildcardType wildcardType, Context context)	Convert a WildcardType into a ResolvedType.
protected TypeDeclaration<?>	findContainingTypeDecl(Node node)	Where a node has an interface/class/enum declaration as its ancestor, return the nearest one.
protected Node	findContainingTypeDeclOrObjectCreationExpr(Node node)	Where a node has an interface/class/enum declaration -- or an object creation expression (anonymous inner class) -- as its ancestor, return the nearest one.
protected Node	findContainingTypeDeclOrObjectCreationExpr(Node node, String className)	Where a node has an interface/class/enum declaration -- or an object creation expression in an inner class references an outer class -- as its ancestor, return the declaration corresponding to the class name specified.
static JavaParserFacade	get(TypeSolver typeSolver)	Note that the addition of the modifier synchronized is specific and directly in response to issue #2668.
protected ResolvedType	getBinaryTypeConcrete(Node left, Node right, boolean solveLambdas, BinaryExpr.Operator operator)
SymbolSolver	getSymbolSolver()
ResolvedType	getType(Node node)	Get the type associated with the node.
ResolvedType	getType(Node node, boolean solveLambdas)
ResolvedReferenceTypeDeclaration	getTypeDeclaration(ClassOrInterfaceDeclaration classOrInterfaceDeclaration)
ResolvedReferenceTypeDeclaration	getTypeDeclaration(TypeDeclaration<?> typeDeclaration)
ResolvedReferenceTypeDeclaration	getTypeDeclaration(Node node)
ResolvedType	getTypeOfThisIn(Node node)	"this" inserted in the given point, which type would have?
TypeSolver	getTypeSolver()
SymbolReference<ResolvedAnnotationDeclaration>	solve(AnnotationExpr annotationExpr)
SymbolReference<? extends ResolvedValueDeclaration>	solve(Expression expr)
SymbolReference<ResolvedValueDeclaration>	solve(FieldAccessExpr fieldAccessExpr)
SymbolReference<ResolvedMethodDeclaration>	solve(MethodCallExpr methodCallExpr)
SymbolReference<ResolvedMethodDeclaration>	solve(MethodCallExpr methodCallExpr, boolean solveLambdas)	Given a method call find out to which method declaration it corresponds.
SymbolReference<ResolvedMethodDeclaration>	solve(MethodReferenceExpr methodReferenceExpr)
SymbolReference<ResolvedMethodDeclaration>	solve(MethodReferenceExpr methodReferenceExpr, boolean solveLambdas)	Given a method reference find out to which method declaration it corresponds.
SymbolReference<? extends ResolvedValueDeclaration>	solve(NameExpr nameExpr)
SymbolReference<ResolvedConstructorDeclaration>	solve(ObjectCreationExpr objectCreationExpr)
SymbolReference<ResolvedConstructorDeclaration>	solve(ObjectCreationExpr objectCreationExpr, boolean solveLambdas)	Given a constructor call find out to which constructor declaration it corresponds.
SymbolReference<? extends ResolvedValueDeclaration>	solve(SimpleName nameExpr)
SymbolReference<ResolvedTypeDeclaration>	solve(ThisExpr node)
SymbolReference<ResolvedConstructorDeclaration>	solve(ExplicitConstructorInvocationStmt explicitConstructorInvocationStmt)
SymbolReference<ResolvedConstructorDeclaration>	solve(ExplicitConstructorInvocationStmt explicitConstructorInvocationStmt, boolean solveLambdas)
protected static ResolvedType	solveGenericTypes(ResolvedType type, Context context)
MethodUsage	solveMethodAsUsage(MethodCallExpr call)
protected MethodUsage	toMethodUsage(MethodReferenceExpr methodReferenceExpr, List<ResolvedType> paramTypes)

Methods inherited from class java.lang.Object

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

Method Details

get

public static JavaParserFacade get(TypeSolver typeSolver)

Note that the addition of the modifier synchronized is specific and directly in response to issue #2668.
This MUST NOT be misinterpreted as a signal that JavaParser is safe to use within a multi-threaded environment.

Additional discussion and context from a user attempting multithreading can be found within issue #2671 .

See Also:

https://github.com/javaparser/javaparser/issues/2668, https://github.com/javaparser/javaparser/issues/2671

clearInstances

public static void clearInstances()

This method is used to clear internal caches for the sake of releasing memory.

solveGenericTypes

protected static ResolvedType solveGenericTypes(ResolvedType type,
 Context context)

getTypeSolver

public TypeSolver getTypeSolver()

getSymbolSolver

public SymbolSolver getSymbolSolver()

solve

public SymbolReference<? extends ResolvedValueDeclaration> solve(NameExpr nameExpr)

solve

public SymbolReference<? extends ResolvedValueDeclaration> solve(SimpleName nameExpr)

solve

public SymbolReference<? extends ResolvedValueDeclaration> solve(Expression expr)

solve

public SymbolReference<ResolvedMethodDeclaration> solve(MethodCallExpr methodCallExpr)

solve

public SymbolReference<ResolvedMethodDeclaration> solve(MethodReferenceExpr methodReferenceExpr)

solve

public SymbolReference<ResolvedConstructorDeclaration> solve(ObjectCreationExpr objectCreationExpr)

solve

public SymbolReference<ResolvedConstructorDeclaration> solve(ExplicitConstructorInvocationStmt explicitConstructorInvocationStmt)

solve

public SymbolReference<ResolvedConstructorDeclaration> solve(ExplicitConstructorInvocationStmt explicitConstructorInvocationStmt,
 boolean solveLambdas)

solve

public SymbolReference<ResolvedTypeDeclaration> solve(ThisExpr node)

solve

public SymbolReference<ResolvedConstructorDeclaration> solve(ObjectCreationExpr objectCreationExpr,
 boolean solveLambdas)

Given a constructor call find out to which constructor declaration it corresponds.

solve

public SymbolReference<ResolvedMethodDeclaration> solve(MethodCallExpr methodCallExpr,
 boolean solveLambdas)

Given a method call find out to which method declaration it corresponds.

solve

public SymbolReference<ResolvedMethodDeclaration> solve(MethodReferenceExpr methodReferenceExpr,
 boolean solveLambdas)

Given a method reference find out to which method declaration it corresponds.

solve

public SymbolReference<ResolvedAnnotationDeclaration> solve(AnnotationExpr annotationExpr)

solve

public SymbolReference<ResolvedValueDeclaration> solve(FieldAccessExpr fieldAccessExpr)

getType

public ResolvedType getType(Node node)

Get the type associated with the node.

This method was originally intended to get the type of a value: any value has a type.

For example:

 int foo(int a) {
     return a; // when getType is invoked on "a" it returns the type "int"
 }
 

Now, users started using also of names of types itself, which do not have a type.

For example:

 class A {
     int foo(int a) {
         return A.someStaticField; // when getType is invoked on "A", which represents a class, it returns
             // the type "A" itself while it used to throw UnsolvedSymbolException
 }
 

To accommodate this usage and avoid confusion this method return the type itself when used on the name of type.

getType

public ResolvedType getType(Node node,
 boolean solveLambdas)

toMethodUsage

protected MethodUsage toMethodUsage(MethodReferenceExpr methodReferenceExpr,
 List<ResolvedType> paramTypes)

getBinaryTypeConcrete

protected ResolvedType getBinaryTypeConcrete(Node left,
 Node right,
 boolean solveLambdas,
 BinaryExpr.Operator operator)

findContainingTypeDecl

protected TypeDeclaration<?> findContainingTypeDecl(Node node)

Where a node has an interface/class/enum declaration as its ancestor, return the nearest one.

NOTE: See findContainingTypeDeclOrObjectCreationExpr(com.github.javaparser.ast.Node) if wanting to include anonymous inner classes.

For example, these all return X: public interface X { ... node here ... } public class X { ... node here ... } public enum X { ... node here ... }

Parameters:

node - The Node whose ancestors will be traversed,

Returns:

The first class/interface/enum declaration in the Node's ancestry.

findContainingTypeDeclOrObjectCreationExpr

protected Node findContainingTypeDeclOrObjectCreationExpr(Node node)

Where a node has an interface/class/enum declaration -- or an object creation expression (anonymous inner class) -- as its ancestor, return the nearest one.

NOTE: See findContainingTypeDecl(com.github.javaparser.ast.Node) if wanting to not include anonymous inner classes.

For example, these all return X:

• public interface X { ... node here ... }
• public class X { ... node here ... }
• public enum X { ... node here ... }

• 
       new ActionListener() {
            ... node here ...
            public void actionPerformed(ActionEvent e) {
                 ... or node here ...
            }
       }
       

Parameters:

node - The Node whose ancestors will be traversed,

Returns:

The first class/interface/enum declaration -- or object creation expression (anonymous inner class) -- in the Node's ancestry.

findContainingTypeDeclOrObjectCreationExpr

protected Node findContainingTypeDeclOrObjectCreationExpr(Node node,
 String className)

Where a node has an interface/class/enum declaration -- or an object creation expression in an inner class references an outer class -- as its ancestor, return the declaration corresponding to the class name specified.

convertToUsageVariableType

public ResolvedType convertToUsageVariableType(VariableDeclarator var)

convertToUsage

protected ResolvedType convertToUsage(Type type,
 Context context)

Convert a Type into the corresponding ResolvedType.

Parameters:

type - The type to be converted.

context - The current context.

Returns:

The type resolved.

convertToUsage

public ResolvedType convertToUsage(Type type,
 Node context)

Convert a Type into the corresponding ResolvedType.

Parameters:

type - The type to be converted.

context - The current context.

Returns:

The type resolved.

convertToUsage

public ResolvedType convertToUsage(Type type)

Convert a Type into the corresponding ResolvedType.

Parameters:

type - The type to be converted.

Returns:

The type resolved.

convertClassOrInterfaceTypeToUsage

protected ResolvedType convertClassOrInterfaceTypeToUsage(ClassOrInterfaceType classOrInterfaceType,
 Context context)

Convert a ClassOrInterfaceType into a ResolvedType.

Parameters:

classOrInterfaceType - The class of interface type to be converted.

context - The current context.

Returns:

The type resolved.

convertWildcardTypeToUsage

protected ResolvedType convertWildcardTypeToUsage(WildcardType wildcardType,
 Context context)

Convert a WildcardType into a ResolvedType.

Parameters:

wildcardType - The wildcard type to be converted.

context - The current context.

Returns:

The type resolved.

convertArrayTypeToUsage

protected ResolvedType convertArrayTypeToUsage(ArrayType arrayType,
 Context context)

Convert a ArrayType into a ResolvedType.

Parameters:

arrayType - The array type to be converted.

context - The current context.

Returns:

The type resolved.

convertUnionTypeToUsage

protected ResolvedType convertUnionTypeToUsage(UnionType unionType,
 Context context)

Convert a UnionType into a ResolvedType.

Parameters:

unionType - The union type to be converted.

context - The current context.

Returns:

The type resolved.

convertVarTypeToUsage

protected ResolvedType convertVarTypeToUsage(VarType varType,
 Context context)

Convert a VarType into a ResolvedType.

Parameters:

varType - The var type to be converted.

context - The current context.

Returns:

The type resolved.

convert

public ResolvedType convert(Type type,
 Node node)

convert

public ResolvedType convert(Type type,
 Context context)

solveMethodAsUsage

public MethodUsage solveMethodAsUsage(MethodCallExpr call)

getTypeDeclaration

public ResolvedReferenceTypeDeclaration getTypeDeclaration(Node node)

getTypeDeclaration

public ResolvedReferenceTypeDeclaration getTypeDeclaration(ClassOrInterfaceDeclaration classOrInterfaceDeclaration)

getTypeOfThisIn

public ResolvedType getTypeOfThisIn(Node node)

"this" inserted in the given point, which type would have?

getTypeDeclaration

public ResolvedReferenceTypeDeclaration getTypeDeclaration(TypeDeclaration<?> typeDeclaration)

classToResolvedType

public ResolvedType classToResolvedType(Class<?> clazz)

Convert a Class into the corresponding ResolvedType.

Parameters:

clazz - The class to be converted.

Returns:

The class resolved.