Package com.sun.tools.javac.comp

Class Lower

java.lang.Object

com.sun.tools.javac.tree.JCTree.Visitor

com.sun.tools.javac.tree.TreeTranslator

com.sun.tools.javac.comp.Lower

public class Lower
extends TreeTranslator

This pass translates away some syntactic sugar: inner classes, class literals, assertions, foreach loops, etc.

This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Field Summary

Fields

Modifier and Type	Field and Description
protected static Context.Key<Lower>	lowerKey
Map<Symbol.ClassSymbol,List<JCTree>>	prunedTree A hash table mapping local classes to a list of pruned trees.

Fields inherited from class com.sun.tools.javac.tree.TreeTranslator

result

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Lower(Context context)

Method Summary

Modifier and Type	Method and Description
static Lower	instance(Context context)
<T extends JCTree> List<T>	translate(List<T> trees, JCTree.JCExpression enclOp) Visitor method: Translate list of trees.
<T extends JCTree> List<T>	translate(List<T> trees, Type type) Visitor method: Translate list of trees.
<T extends JCTree> T	translate(T tree) Visitor method: Translate a single node.
<T extends JCTree> T	translate(T tree, JCTree.JCExpression enclOp) Visitor method: Translate tree.
<T extends JCTree> T	translate(T tree, Type type) Visitor method: Translate a single node, boxing or unboxing if needed.
List<JCTree>	translateTopLevelClass(Env<AttrContext> env, JCTree cdef, TreeMaker make) Translate a toplevel class and return a list consisting of the translated class and translated versions of all inner classes.
void	visitAnnotatedType(JCTree.JCAnnotatedType tree)
void	visitAnnotation(JCTree.JCAnnotation tree)
void	visitApply(JCTree.JCMethodInvocation tree)
void	visitAssert(JCTree.JCAssert tree) Visitor method for assert statements.
void	visitAssign(JCTree.JCAssign tree)
void	visitAssignop(JCTree.JCAssignOp tree)
void	visitBinary(JCTree.JCBinary tree)
void	visitBlock(JCTree.JCBlock tree)
void	visitClassDef(JCTree.JCClassDecl tree)
void	visitConditional(JCTree.JCConditional tree) Visitor method for conditional expressions.
void	visitDoLoop(JCTree.JCDoWhileLoop tree)
JCTree	visitEnumSwitch(JCTree.JCSwitch tree)
void	visitForeachLoop(JCTree.JCEnhancedForLoop tree) Translate away the foreach loop.
void	visitForLoop(JCTree.JCForLoop tree)
void	visitIdent(JCTree.JCIdent tree)
void	visitIf(JCTree.JCIf tree) Visitor method for if statements.
void	visitIndexed(JCTree.JCArrayAccess tree)
void	visitLetExpr(JCTree.LetExpr tree)
void	visitMethodDef(JCTree.JCMethodDecl tree)
void	visitNewArray(JCTree.JCNewArray tree)
void	visitNewClass(JCTree.JCNewClass tree)
void	visitParens(JCTree.JCParens tree) Visitor method for parenthesized expressions.
void	visitReturn(JCTree.JCReturn tree)
void	visitSelect(JCTree.JCFieldAccess tree)
JCTree	visitStringSwitch(JCTree.JCSwitch tree)
void	visitSwitch(JCTree.JCSwitch tree)
void	visitTopLevel(JCTree.JCCompilationUnit tree)
void	visitTry(JCTree.JCTry tree)
void	visitTypeCast(JCTree.JCTypeCast tree)
void	visitUnary(JCTree.JCUnary tree)
void	visitVarDef(JCTree.JCVariableDecl tree)
void	visitWhileLoop(JCTree.JCWhileLoop tree)

Methods inherited from class com.sun.tools.javac.tree.TreeTranslator

translate, translateAnnotations, translateCases, translateCatchers, translateTypeParams, translateVarDefs, visitBreak, visitCase, visitCatch, visitContinue, visitErroneous, visitExec, visitImport, visitLabelled, visitLambda, visitLiteral, visitModifiers, visitReference, visitSkip, visitSynchronized, visitThrow, visitTree, visitTypeApply, visitTypeArray, visitTypeBoundKind, visitTypeIdent, visitTypeIntersection, visitTypeParameter, visitTypeTest, visitTypeUnion, visitWildcard

Methods inherited from class java.lang.Object

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

Field Detail

lowerKey

protected static final Context.Key<Lower> lowerKey

prunedTree

public Map<Symbol.ClassSymbol,List<JCTree>> prunedTree

A hash table mapping local classes to a list of pruned trees.

Constructor Detail

Lower

protected Lower(Context context)

Method Detail

instance

public static Lower instance(Context context)

translate

public <T extends JCTree> T translate(T tree)

Visitor method: Translate a single node. Attach the source position from the old tree to its replacement tree.

Overrides:

translate in class TreeTranslator

translate

public <T extends JCTree> T translate(T tree,
                                      Type type)

Visitor method: Translate a single node, boxing or unboxing if needed.

translate

public <T extends JCTree> T translate(T tree,
                                      JCTree.JCExpression enclOp)

Visitor method: Translate tree.

translate

public <T extends JCTree> List<T> translate(List<T> trees,
                                            JCTree.JCExpression enclOp)

Visitor method: Translate list of trees.

translate

public <T extends JCTree> List<T> translate(List<T> trees,
                                            Type type)

Visitor method: Translate list of trees.

visitTopLevel

public void visitTopLevel(JCTree.JCCompilationUnit tree)

Overrides:

visitTopLevel in class TreeTranslator

visitClassDef

public void visitClassDef(JCTree.JCClassDecl tree)

Overrides:

visitClassDef in class TreeTranslator

visitMethodDef

public void visitMethodDef(JCTree.JCMethodDecl tree)

Overrides:

visitMethodDef in class TreeTranslator

visitAnnotatedType

public void visitAnnotatedType(JCTree.JCAnnotatedType tree)

Overrides:

visitAnnotatedType in class TreeTranslator

visitTypeCast

public void visitTypeCast(JCTree.JCTypeCast tree)

Overrides:

visitTypeCast in class TreeTranslator

visitNewClass

public void visitNewClass(JCTree.JCNewClass tree)

Overrides:

visitNewClass in class TreeTranslator

visitConditional

public void visitConditional(JCTree.JCConditional tree)

Visitor method for conditional expressions.

Overrides:

visitConditional in class TreeTranslator

visitIf

public void visitIf(JCTree.JCIf tree)

Visitor method for if statements.

Overrides:

visitIf in class TreeTranslator

visitAssert

public void visitAssert(JCTree.JCAssert tree)

Visitor method for assert statements. Translate them away.

Overrides:

visitAssert in class TreeTranslator

visitApply

public void visitApply(JCTree.JCMethodInvocation tree)

Overrides:

visitApply in class TreeTranslator

visitParens

public void visitParens(JCTree.JCParens tree)

Visitor method for parenthesized expressions. If the subexpression has changed, omit the parens.

Overrides:

visitParens in class TreeTranslator

visitIndexed

public void visitIndexed(JCTree.JCArrayAccess tree)

Overrides:

visitIndexed in class TreeTranslator

visitAssign

public void visitAssign(JCTree.JCAssign tree)

Overrides:

visitAssign in class TreeTranslator

visitAssignop

public void visitAssignop(JCTree.JCAssignOp tree)

Overrides:

visitAssignop in class TreeTranslator

visitUnary

public void visitUnary(JCTree.JCUnary tree)

Overrides:

visitUnary in class TreeTranslator

visitBinary

public void visitBinary(JCTree.JCBinary tree)

Overrides:

visitBinary in class TreeTranslator

visitIdent

public void visitIdent(JCTree.JCIdent tree)

Overrides:

visitIdent in class TreeTranslator

visitForeachLoop

public void visitForeachLoop(JCTree.JCEnhancedForLoop tree)

Translate away the foreach loop.

Overrides:

visitForeachLoop in class TreeTranslator

visitVarDef

public void visitVarDef(JCTree.JCVariableDecl tree)

Overrides:

visitVarDef in class TreeTranslator

visitBlock

public void visitBlock(JCTree.JCBlock tree)

Overrides:

visitBlock in class TreeTranslator

visitDoLoop

public void visitDoLoop(JCTree.JCDoWhileLoop tree)

Overrides:

visitDoLoop in class TreeTranslator

visitWhileLoop

public void visitWhileLoop(JCTree.JCWhileLoop tree)

Overrides:

visitWhileLoop in class TreeTranslator

visitForLoop

public void visitForLoop(JCTree.JCForLoop tree)

Overrides:

visitForLoop in class TreeTranslator

visitReturn

public void visitReturn(JCTree.JCReturn tree)

Overrides:

visitReturn in class TreeTranslator

visitSwitch

public void visitSwitch(JCTree.JCSwitch tree)

Overrides:

visitSwitch in class TreeTranslator

visitEnumSwitch

public JCTree visitEnumSwitch(JCTree.JCSwitch tree)

visitStringSwitch

public JCTree visitStringSwitch(JCTree.JCSwitch tree)

visitNewArray

public void visitNewArray(JCTree.JCNewArray tree)

Overrides:

visitNewArray in class TreeTranslator

visitSelect

public void visitSelect(JCTree.JCFieldAccess tree)

Overrides:

visitSelect in class TreeTranslator

visitLetExpr

public void visitLetExpr(JCTree.LetExpr tree)

Overrides:

visitLetExpr in class TreeTranslator

visitAnnotation

public void visitAnnotation(JCTree.JCAnnotation tree)

Overrides:

visitAnnotation in class TreeTranslator

visitTry

public void visitTry(JCTree.JCTry tree)

Overrides:

visitTry in class TreeTranslator

translateTopLevelClass

public List<JCTree> translateTopLevelClass(Env<AttrContext> env,
                                           JCTree cdef,
                                           TreeMaker make)

Translate a toplevel class and return a list consisting of the translated class and translated versions of all inner classes.

Parameters:

env - The attribution environment current at the class definition. We need this for resolving some additional symbols.

cdef - The tree representing the class definition.