JavacAST (Lombok)

java.lang.Object
- lombok.core.AST<JavacAST,JavacNode,com.sun.tools.javac.tree.JCTree>
- - lombok.javac.JavacAST

```
public class JavacAST
extends AST<JavacAST,JavacNode,com.sun.tools.javac.tree.JCTree>
```
Wraps around javac's internal AST view to add useful features as well as the ability to visit parents from children, something javac's own AST system does not offer.

Nested Class Summary
- Nested classes/interfaces inherited from class lombok.core.AST
  AST.FieldAccess, AST.Kind

Constructor Summary

Constructors
Constructor and Description
`JavacAST(Messager messager, com.sun.tools.javac.util.Context context, com.sun.tools.javac.tree.JCTree.JCCompilationUnit top)` Creates a new JavacAST of the provided Compilation Unit.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected JavacNode`	`buildTree(com.sun.tools.javac.tree.JCTree node, AST.Kind kind)` Build an AST.Node object for the stated internal (javac/Eclipse) AST Node object.
`URI`	`getAbsoluteFileLocation()` Attempts to find the absolute path (in URI form) to the source file represented by this AST.
`com.sun.tools.javac.util.Context`	`getContext()`
`int`	`getLatestJavaSpecSupported()` Returns the latest version of the java language specification supported by the host compiler.
`int`	`getSourceVersion()` Returns the JLS spec version that the compiler uses to parse and compile this AST.
`protected Collection<Class<? extends com.sun.tools.javac.tree.JCTree>>`	`getStatementTypes()` For javac, both JCExpression and JCStatement are considered as valid children types.
`com.sun.tools.javac.code.Symtab`	`getSymbolTable()`
`lombok.javac.JavacTreeMaker`	`getTreeMaker()`
`com.sun.tools.javac.model.JavacTypes`	`getTypesUtil()`
`void`	`removeFromDeferredDiagnostics(int startPos, int endPos)`
`protected void`	`setElementInASTCollection(Field field, Object refField, List<Collection<?>> chain, Collection<?> collection, int idx, com.sun.tools.javac.tree.JCTree newN)` Override if your AST collection does not support the set method.
`com.sun.tools.javac.util.Name`	`toName(String name)`
`void`	`traverse(JavacASTVisitor visitor)` Runs through the entire AST, starting at the compilation unit, calling the provided visitor's visit methods for each node, depth first.

Methods inherited from class lombok.core.AST
buildWithField, clearChanged, clearState, fieldsOf, get, getFileName, getImportList, getNodeMap, getPackageDeclaration, isChanged, putInMap, readConfiguration, replaceStatementInNode, setAndGetAsHandled, setChanged, setTop, shouldDrill, top

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - JavacAST
```
public JavacAST(Messager messager,
                com.sun.tools.javac.util.Context context,
                com.sun.tools.javac.tree.JCTree.JCCompilationUnit top)
```
    Creates a new JavacAST of the provided Compilation Unit.
    
    Parameters:
    
    messager - A Messager for warning and error reporting.
    
    context - A Context object for interfacing with the compiler.
    
    top - The compilation unit, which serves as the top level node in the tree to be built.
- Method Detail
  - getAbsoluteFileLocation
```
public URI getAbsoluteFileLocation()
```
    Description copied from class: AST
    
    Attempts to find the absolute path (in URI form) to the source file represented by this AST. May return null if this cannot be done. We don't yet know under which conditions this will happen.
    
    Specified by:
    
    getAbsoluteFileLocation in class AST<JavacAST,JavacNode,com.sun.tools.javac.tree.JCTree>
  - getContext
```
public com.sun.tools.javac.util.Context getContext()
```
  - traverse
```
public void traverse(JavacASTVisitor visitor)
```
    Runs through the entire AST, starting at the compilation unit, calling the provided visitor's visit methods for each node, depth first.
  - getSourceVersion
```
public int getSourceVersion()
```
    Description copied from class: AST
    
    Returns the JLS spec version that the compiler uses to parse and compile this AST. For example, if -source 1.6 is on the command line, this will return 6.
    
    Overrides:
    
    getSourceVersion in class AST<JavacAST,JavacNode,com.sun.tools.javac.tree.JCTree>
  - getLatestJavaSpecSupported
```
public int getLatestJavaSpecSupported()
```
    Description copied from class: AST
    
    Returns the latest version of the java language specification supported by the host compiler. For example, if compiling with javac v1.7, this returns 7. NB: Even if -source (lower than maximum) is specified, this method still returns the maximum supported number.
    
    Overrides:
    
    getLatestJavaSpecSupported in class AST<JavacAST,JavacNode,com.sun.tools.javac.tree.JCTree>
  - toName
```
public com.sun.tools.javac.util.Name toName(String name)
```
    Returns:
    
    A Name object generated for the proper name table belonging to this AST.
  - getTreeMaker
```
public lombok.javac.JavacTreeMaker getTreeMaker()
```
    Returns:
    
    A TreeMaker instance that you can use to create new AST nodes.
  - getSymbolTable
```
public com.sun.tools.javac.code.Symtab getSymbolTable()
```
    Returns:
    
    The symbol table used by this AST for symbols.
  - getTypesUtil
```
public com.sun.tools.javac.model.JavacTypes getTypesUtil()
```
    Returns:
    
    The implementation of Types of javac. Contains a few extra methods beyond the ones listed in the official annotation API interface.
  - buildTree
```
protected JavacNode buildTree(com.sun.tools.javac.tree.JCTree node,
                              AST.Kind kind)
```
    Build an AST.Node object for the stated internal (javac/Eclipse) AST Node object.
    
    Specified by:
    
    buildTree in class AST<JavacAST,JavacNode,com.sun.tools.javac.tree.JCTree>
  - getStatementTypes
```
protected Collection<Class<? extends com.sun.tools.javac.tree.JCTree>> getStatementTypes()
```
    For javac, both JCExpression and JCStatement are considered as valid children types.
    
    Specified by:
    
    getStatementTypes in class AST<JavacAST,JavacNode,com.sun.tools.javac.tree.JCTree>
  - removeFromDeferredDiagnostics
```
public void removeFromDeferredDiagnostics(int startPos,
                                          int endPos)
```
  - setElementInASTCollection
```
protected void setElementInASTCollection(Field field,
                                         Object refField,
                                         List<Collection<?>> chain,
                                         Collection<?> collection,
                                         int idx,
                                         com.sun.tools.javac.tree.JCTree newN)
                                  throws IllegalAccessException
```
    Override if your AST collection does not support the set method. Javac's for example, does not.
    
    Overrides:
    
    setElementInASTCollection in class AST<JavacAST,JavacNode,com.sun.tools.javac.tree.JCTree>
    
    Parameters:
    
    field - The field that contains the array or list of AST nodes.
    
    refField - The object that you can supply to the field's get method.
    
    chain - If the collection is immutable, you need to update the pointer to the collection in each element in the chain.
    
    Throws:
    
    IllegalAccessException - This exception won't happen, but we allow you to throw it so you can avoid having to catch it.

Class JavacAST

Nested Class Summary

Nested classes/interfaces inherited from class lombok.core.AST

Constructor Summary

Method Summary

Methods inherited from class lombok.core.AST

Methods inherited from class java.lang.Object

Constructor Detail

JavacAST

Method Detail

getAbsoluteFileLocation

getContext

traverse

getSourceVersion

getLatestJavaSpecSupported

toName

getTreeMaker

getSymbolTable

getTypesUtil

buildTree

getStatementTypes

removeFromDeferredDiagnostics

setElementInASTCollection