io.ghostwriter.openjdk.v7.ast.compiler

Interface JavaCompiler

All Known Implementing Classes:

Javac

public interface JavaCompiler

All Java compiler API specific complex operations - that do not only deal with reading and writing the properties of the internal types - are collected here.

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 variable)
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...
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.
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.

Method Detail

defaultValueForType

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.

Parameters:

type - Type of the default value

Returns:

Expression representing a default value

isPrimitiveType

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

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

Parameters:

type - expression to check

Returns:

true if the passed expression resolves to a primitive type

wrapperType

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

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

Parameters:

type - primitive type to wrap

Returns:

the wrapper representation for a give primitive type

methodReturnType

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. In case of procedures, this will be java.lang.Void.

Parameters:

method - used for introspection

Returns:

fully qualified type of the return parameter.

methodName

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

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

Parameters:

method - used for introspection

Returns:

name of the method.

expression

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. This method generates such an expression. For example, maker.Select(maker.Select(maker.Ident(NAME[java]), NAME[lang]), NAME[String]).

Parameters:

expr - Java expression to be built into an AST

Returns:

AST representation of the passed expression

See Also:

JCTree.JCIdent, JCTree.JCFieldAccess

name

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

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.

Parameters:

identifierName - identifier name

Returns:

internal representation for an identifier

See Also:

Name, Name.Table

array

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

Construct an array of specified type

Parameters:

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

Returns:

expression representing the array declaration

literal

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

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

Parameters:

value - the value to be represented as a constant

Returns:

AST representation of the constant

identifier

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

Parameters:

name - name of the identifier to be constructed

Returns:

compiler representation of the identifier

finalVariable

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

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

assign

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

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

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...

Parameters:

expression - expression to wrap

Returns:

statement that executes the specified expression

call

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

Parameters:

method - method to be called

arguments - input arguments for the method

Returns:

function call AST

apply

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

Parameters:

method - method application target

arguments - arguments to be applied to a method

Returns:

method invocation AST

block

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

Parameters:

statements - list of statements to enclose

Returns:

returns the compiler representation of a block containing the given statements

declarationType

com.sun.tools.javac.tree.JCTree.JCExpression declarationType(com.sun.tools.javac.tree.JCTree.JCExpression variable)

tryFinally

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

catchExpression

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

throwStatement

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

tryCatchFinally

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)

ifCondition

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

notEqualExpression

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

nullLiteral

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

isStaticMethod

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

fullyQualifiedNameForTypeExpression

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

annotation

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

catchParameter

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

primitiveType

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

binary

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)

makeReturn

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

castToType

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

arrayAccess

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