io.ghostwriter.openjdk.v7.ast.compiler

Class Javac

java.lang.Object

io.ghostwriter.openjdk.v7.ast.compiler.Javac

All Implemented Interfaces:

JavaCompiler

public class Javac
extends java.lang.Object
implements JavaCompiler

Field Summary

Fields

Modifier and Type	Field and Description
protected com.sun.tools.javac.util.Context	context
protected com.sun.tools.javac.model.JavacElements	elements
protected com.sun.tools.javac.tree.TreeMaker	make

Constructor Summary

Constructors

Constructor and Description
Javac(javax.annotation.processing.ProcessingEnvironment env)

Method Summary

Modifier and Type	Method and Description
com.sun.tools.javac.tree.JCTree.JCAnnotation	annotation(java.lang.String fullyQualifiedName)
com.sun.tools.javac.tree.JCTree.JCMethodInvocation	apply(com.sun.tools.javac.tree.JCTree.JCExpression method, com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCExpression> arguments) Create a function application
com.sun.tools.javac.tree.JCTree.JCNewArray	array(com.sun.tools.javac.tree.JCTree.JCExpression type) Construct an array of specified type
com.sun.tools.javac.tree.JCTree.JCArrayAccess	arrayAccess(com.sun.tools.javac.tree.JCTree.JCExpression indexed, com.sun.tools.javac.tree.JCTree.JCExpression index)
com.sun.tools.javac.tree.JCTree.JCAssign	assign(com.sun.tools.javac.tree.JCTree.JCIdent identifier, com.sun.tools.javac.tree.JCTree.JCExpression expression)
com.sun.tools.javac.tree.JCTree.JCBinary	binary(java.lang.String operation, com.sun.tools.javac.tree.JCTree.JCExpression lhs, com.sun.tools.javac.tree.JCTree.JCExpression rhs)
com.sun.tools.javac.tree.JCTree.JCBlock	block(com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCStatement> statements)
com.sun.tools.javac.tree.JCTree.JCExpressionStatement	call(com.sun.tools.javac.tree.JCTree.JCExpression method, com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCExpression> arguments) Create a function invocation expression
com.sun.tools.javac.tree.JCTree.JCExpression	castToType(com.sun.tools.javac.tree.JCTree returnType, com.sun.tools.javac.tree.JCTree.JCExpression expression)
com.sun.tools.javac.tree.JCTree.JCCatch	catchExpression(com.sun.tools.javac.tree.JCTree.JCVariableDecl param, com.sun.tools.javac.tree.JCTree.JCBlock body)
com.sun.tools.javac.tree.JCTree.JCVariableDecl	catchParameter(java.lang.String name, com.sun.tools.javac.tree.JCTree parent)
com.sun.tools.javac.tree.JCTree.JCExpression	declarationType(com.sun.tools.javac.tree.JCTree.JCExpression typeExpression)
com.sun.tools.javac.tree.JCTree.JCExpression	defaultValueForType(com.sun.tools.javac.tree.JCTree.JCExpression type) Returns an expression which evaluates to the default value (Java spec.) of a given type.
com.sun.tools.javac.tree.JCTree.JCExpressionStatement	execute(com.sun.tools.javac.tree.JCTree.JCExpression expression) Wrap expression into a statement type that can be added to method bodies and so on...
protected com.sun.tools.javac.tree.JCTree.JCExpression	expression(java.lang.String... elements)
com.sun.tools.javac.tree.JCTree.JCExpression	expression(java.lang.String expr) In javac, dotted access of any kind, from java.lang.String to var.methodName is represented by a fold-left of Select nodes with the leftmost string represented by a Ident node.
com.sun.tools.javac.tree.JCTree.JCVariableDecl	finalVariable(com.sun.tools.javac.tree.JCTree.JCExpression type, java.lang.String name, com.sun.tools.javac.tree.JCTree.JCExpression value, com.sun.tools.javac.tree.JCTree parent) Create a finalVariable declaration
java.lang.String	fullyQualifiedNameForTypeExpression(com.sun.tools.javac.tree.JCTree.JCExpression typeExpression)
com.sun.tools.javac.tree.JCTree.JCIdent	identifier(java.lang.String name)
com.sun.tools.javac.tree.JCTree.JCStatement	ifCondition(com.sun.tools.javac.tree.JCTree.JCExpression condition, com.sun.tools.javac.tree.JCTree.JCStatement then)
boolean	isPrimitiveType(com.sun.tools.javac.tree.JCTree.JCExpression type) Tests whether a javac AST expression resolves to a primitive type.
boolean	isStaticMethod(com.sun.tools.javac.tree.JCTree.JCMethodDecl method)
com.sun.tools.javac.tree.JCTree.JCLiteral	literal(java.lang.Object value) Return a "constant" value expression for a given value.
protected com.sun.tools.javac.tree.JCTree.JCNewArray	makeArray(com.sun.tools.javac.tree.JCTree.JCExpression type, com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCExpression> dimensions, com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCExpression> values) Constructs and array expression with the specified dimensions and initial values.
com.sun.tools.javac.tree.JCTree.JCReturn	makeReturn(com.sun.tools.javac.tree.JCTree.JCExpression result)
java.lang.String	methodName(com.sun.tools.javac.tree.JCTree.JCMethodDecl method) Extract the name of the method based on the javac representation.
com.sun.tools.javac.tree.JCTree.JCExpression	methodReturnType(com.sun.tools.javac.tree.JCTree.JCMethodDecl method) Returns the fully qualified type of the return parameter.
com.sun.tools.javac.util.Name	name(java.lang.String identifierName) Returns an abstraction for internal compiler strings.
com.sun.tools.javac.tree.JCTree.JCExpression	notEqualExpression(com.sun.tools.javac.tree.JCTree.JCExpression lhs, com.sun.tools.javac.tree.JCTree.JCExpression rhs)
com.sun.tools.javac.tree.JCTree.JCExpression	nullLiteral()
com.sun.tools.javac.tree.JCTree.JCPrimitiveTypeTree	primitiveType(java.lang.String type)
com.sun.tools.javac.tree.JCTree.JCThrow	throwStatement(com.sun.tools.javac.tree.JCTree.JCExpression expr)
com.sun.tools.javac.tree.JCTree.JCTry	tryCatchFinally(com.sun.tools.javac.tree.JCTree.JCBlock tryBlock, com.sun.tools.javac.tree.JCTree.JCCatch catchBlock, com.sun.tools.javac.tree.JCTree.JCBlock finallyBlock)
com.sun.tools.javac.tree.JCTree.JCTry	tryFinally(com.sun.tools.javac.tree.JCTree.JCBlock tryBlock, com.sun.tools.javac.tree.JCTree.JCBlock finallyBlock)
java.lang.Class<?>	wrapperType(com.sun.tools.javac.tree.JCTree.JCPrimitiveTypeTree type) Returns the wrapper class representation for a javac finalVariable declaration type expression.

Methods inherited from class java.lang.Object

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

Field Detail

make

protected final com.sun.tools.javac.tree.TreeMaker make

elements

protected final com.sun.tools.javac.model.JavacElements elements

context

protected final com.sun.tools.javac.util.Context context

Constructor Detail

Javac

public Javac(javax.annotation.processing.ProcessingEnvironment env)

Method Detail

fullyQualifiedNameForTypeExpression

public java.lang.String fullyQualifiedNameForTypeExpression(com.sun.tools.javac.tree.JCTree.JCExpression typeExpression)

Specified by:

fullyQualifiedNameForTypeExpression in interface JavaCompiler

declarationType

public com.sun.tools.javac.tree.JCTree.JCExpression declarationType(com.sun.tools.javac.tree.JCTree.JCExpression typeExpression)

Specified by:

declarationType in interface JavaCompiler

isPrimitiveType

public boolean isPrimitiveType(com.sun.tools.javac.tree.JCTree.JCExpression type)

Description copied from interface: JavaCompiler

Tests whether a javac AST expression resolves to a primitive type.

Specified by:

isPrimitiveType in interface JavaCompiler

Parameters:

type - expression to check

Returns:

true if the passed expression resolves to a primitive type

wrapperType

public java.lang.Class<?> wrapperType(com.sun.tools.javac.tree.JCTree.JCPrimitiveTypeTree type)

Description copied from interface: JavaCompiler

Returns the wrapper class representation for a javac finalVariable declaration type expression.

Specified by:

wrapperType in interface JavaCompiler

Parameters:

type - primitive type to wrap

Returns:

the wrapper representation for a give primitive type

methodReturnType

public com.sun.tools.javac.tree.JCTree.JCExpression methodReturnType(com.sun.tools.javac.tree.JCTree.JCMethodDecl method)

Description copied from interface: JavaCompiler

Returns the fully qualified type of the return parameter. In case of procedures, this will be java.lang.Void.

Specified by:

methodReturnType in interface JavaCompiler

Parameters:

method - used for introspection

Returns:

fully qualified type of the return parameter.

methodName

public java.lang.String methodName(com.sun.tools.javac.tree.JCTree.JCMethodDecl method)

Description copied from interface: JavaCompiler

Extract the name of the method based on the javac representation. The symbol is returned as a java.lang.String

Specified by:

methodName in interface JavaCompiler

Parameters:

method - used for introspection

Returns:

name of the method.

expression

public com.sun.tools.javac.tree.JCTree.JCExpression expression(java.lang.String expr)

Description copied from interface: JavaCompiler

In javac, dotted access of any kind, from java.lang.String to var.methodName is represented by a fold-left of Select nodes with the leftmost string represented by a Ident node. This method generates such an expression. For example, maker.Select(maker.Select(maker.Ident(NAME[java]), NAME[lang]), NAME[String]).

Specified by:

expression in interface JavaCompiler

Parameters:

expr - Java expression to be built into an AST

Returns:

AST representation of the passed expression

See Also:

JCTree.JCIdent, JCTree.JCFieldAccess

expression

protected com.sun.tools.javac.tree.JCTree.JCExpression expression(java.lang.String... elements)

name

public com.sun.tools.javac.util.Name name(java.lang.String identifierName)

Description copied from interface: JavaCompiler

Returns an abstraction for internal compiler strings. They are stored in UTF8 format. Names are stored in a Name.Table, and are unique within that table.

Specified by:

name in interface JavaCompiler

Parameters:

identifierName - identifier name

Returns:

internal representation for an identifier

See Also:

Name, Name.Table

array

public com.sun.tools.javac.tree.JCTree.JCNewArray array(com.sun.tools.javac.tree.JCTree.JCExpression type)

Description copied from interface: JavaCompiler

Construct an array of specified type

Specified by:

array in interface JavaCompiler

Parameters:

type - fully qualified name of the type, such as java.lang.Object

Returns:

expression representing the array declaration

makeArray

protected com.sun.tools.javac.tree.JCTree.JCNewArray makeArray(com.sun.tools.javac.tree.JCTree.JCExpression type,
                                                               com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCExpression> dimensions,
                                                               com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCExpression> values)

Constructs and array expression with the specified dimensions and initial values.

Parameters:

type - Type of the constructed array

dimensions - dimensions Dimensions of the array

values - Initial values of the array

Returns:

Array expression

literal

public com.sun.tools.javac.tree.JCTree.JCLiteral literal(java.lang.Object value)

Description copied from interface: JavaCompiler

Return a "constant" value expression for a given value. The type of the value is deduced base on the value itself. In case of null, a NullPointerException will be thrown

Specified by:

literal in interface JavaCompiler

Parameters:

value - the value to be represented as a constant

Returns:

AST representation of the constant

identifier

public com.sun.tools.javac.tree.JCTree.JCIdent identifier(java.lang.String name)

Specified by:

identifier in interface JavaCompiler

Parameters:

name - name of the identifier to be constructed

Returns:

compiler representation of the identifier

call

public com.sun.tools.javac.tree.JCTree.JCExpressionStatement call(com.sun.tools.javac.tree.JCTree.JCExpression method,
                                                                  com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCExpression> arguments)

Description copied from interface: JavaCompiler

Create a function invocation expression

Specified by:

call in interface JavaCompiler

Parameters:

method - method to be called

arguments - input arguments for the method

Returns:

function call AST

apply

public com.sun.tools.javac.tree.JCTree.JCMethodInvocation apply(com.sun.tools.javac.tree.JCTree.JCExpression method,
                                                                com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCExpression> arguments)

Description copied from interface: JavaCompiler

Create a function application

Specified by:

apply in interface JavaCompiler

Parameters:

method - method application target

arguments - arguments to be applied to a method

Returns:

method invocation AST

finalVariable

public com.sun.tools.javac.tree.JCTree.JCVariableDecl finalVariable(com.sun.tools.javac.tree.JCTree.JCExpression type,
                                                                    java.lang.String name,
                                                                    com.sun.tools.javac.tree.JCTree.JCExpression value,
                                                                    com.sun.tools.javac.tree.JCTree parent)

Description copied from interface: JavaCompiler

Create a finalVariable declaration

Specified by:

finalVariable in interface JavaCompiler

Parameters:

type - type of the finalVariable

name - name of the finalVariable

value - right side part of the finalVariable declaration

parent - scope that the variable should belong to

Returns:

compiler representation of the finalVariable declaration

catchParameter

public com.sun.tools.javac.tree.JCTree.JCVariableDecl catchParameter(java.lang.String name,
                                                                     com.sun.tools.javac.tree.JCTree parent)

Specified by:

catchParameter in interface JavaCompiler

assign

public com.sun.tools.javac.tree.JCTree.JCAssign assign(com.sun.tools.javac.tree.JCTree.JCIdent identifier,
                                                       com.sun.tools.javac.tree.JCTree.JCExpression expression)

Specified by:

assign in interface JavaCompiler

Parameters:

identifier - left hand side of the assign operation

expression - right hand side of the assign operation

Returns:

compiler representation of the assign operation

execute

public com.sun.tools.javac.tree.JCTree.JCExpressionStatement execute(com.sun.tools.javac.tree.JCTree.JCExpression expression)

Description copied from interface: JavaCompiler

Wrap expression into a statement type that can be added to method bodies and so on...

Specified by:

execute in interface JavaCompiler

Parameters:

expression - expression to wrap

Returns:

statement that executes the specified expression

throwStatement

public com.sun.tools.javac.tree.JCTree.JCThrow throwStatement(com.sun.tools.javac.tree.JCTree.JCExpression expr)

Specified by:

throwStatement in interface JavaCompiler

ifCondition

public com.sun.tools.javac.tree.JCTree.JCStatement ifCondition(com.sun.tools.javac.tree.JCTree.JCExpression condition,
                                                               com.sun.tools.javac.tree.JCTree.JCStatement then)

Specified by:

ifCondition in interface JavaCompiler

block

public com.sun.tools.javac.tree.JCTree.JCBlock block(com.sun.tools.javac.util.List<com.sun.tools.javac.tree.JCTree.JCStatement> statements)

Specified by:

block in interface JavaCompiler

Parameters:

statements - list of statements to enclose

Returns:

returns the compiler representation of a block containing the given statements

tryFinally

public com.sun.tools.javac.tree.JCTree.JCTry tryFinally(com.sun.tools.javac.tree.JCTree.JCBlock tryBlock,
                                                        com.sun.tools.javac.tree.JCTree.JCBlock finallyBlock)

Specified by:

tryFinally in interface JavaCompiler

tryCatchFinally

public com.sun.tools.javac.tree.JCTree.JCTry tryCatchFinally(com.sun.tools.javac.tree.JCTree.JCBlock tryBlock,
                                                             com.sun.tools.javac.tree.JCTree.JCCatch catchBlock,
                                                             com.sun.tools.javac.tree.JCTree.JCBlock finallyBlock)

Specified by:

tryCatchFinally in interface JavaCompiler

catchExpression

public com.sun.tools.javac.tree.JCTree.JCCatch catchExpression(com.sun.tools.javac.tree.JCTree.JCVariableDecl param,
                                                               com.sun.tools.javac.tree.JCTree.JCBlock body)

Specified by:

catchExpression in interface JavaCompiler

notEqualExpression

public com.sun.tools.javac.tree.JCTree.JCExpression notEqualExpression(com.sun.tools.javac.tree.JCTree.JCExpression lhs,
                                                                       com.sun.tools.javac.tree.JCTree.JCExpression rhs)

Specified by:

notEqualExpression in interface JavaCompiler

defaultValueForType

public com.sun.tools.javac.tree.JCTree.JCExpression defaultValueForType(com.sun.tools.javac.tree.JCTree.JCExpression type)

Description copied from interface: JavaCompiler

Returns an expression which evaluates to the default value (Java spec.) of a given type.

Specified by:

defaultValueForType in interface JavaCompiler

Parameters:

type - Type of the default value

Returns:

Expression representing a default value

nullLiteral

public com.sun.tools.javac.tree.JCTree.JCExpression nullLiteral()

Specified by:

nullLiteral in interface JavaCompiler

isStaticMethod

public boolean isStaticMethod(com.sun.tools.javac.tree.JCTree.JCMethodDecl method)

Specified by:

isStaticMethod in interface JavaCompiler

annotation

public com.sun.tools.javac.tree.JCTree.JCAnnotation annotation(java.lang.String fullyQualifiedName)

Specified by:

annotation in interface JavaCompiler

primitiveType

public com.sun.tools.javac.tree.JCTree.JCPrimitiveTypeTree primitiveType(java.lang.String type)

Specified by:

primitiveType in interface JavaCompiler

binary

public com.sun.tools.javac.tree.JCTree.JCBinary binary(java.lang.String operation,
                                                       com.sun.tools.javac.tree.JCTree.JCExpression lhs,
                                                       com.sun.tools.javac.tree.JCTree.JCExpression rhs)

Specified by:

binary in interface JavaCompiler

makeReturn

public com.sun.tools.javac.tree.JCTree.JCReturn makeReturn(com.sun.tools.javac.tree.JCTree.JCExpression result)

Specified by:

makeReturn in interface JavaCompiler

castToType

public com.sun.tools.javac.tree.JCTree.JCExpression castToType(com.sun.tools.javac.tree.JCTree returnType,
                                                               com.sun.tools.javac.tree.JCTree.JCExpression expression)

Specified by:

castToType in interface JavaCompiler

arrayAccess

public com.sun.tools.javac.tree.JCTree.JCArrayAccess arrayAccess(com.sun.tools.javac.tree.JCTree.JCExpression indexed,
                                                                 com.sun.tools.javac.tree.JCTree.JCExpression index)

Specified by:

arrayAccess in interface JavaCompiler