com.github.javaparser.ast

Class CompilationUnit

java.lang.Object

com.github.javaparser.ast.Node

com.github.javaparser.ast.CompilationUnit

All Implemented Interfaces:

Observable, Visitable, HasParentNode<Node>, Cloneable

public final class CompilationUnit
extends Node

This class represents the entire compilation unit. Each java file denotes a compilation unit.

The CompilationUnit is constructed following the syntax:

 
 CompilationUnit ::=  ( PackageDeclaration )?
                      ( ImportDeclaration )*
                      ( TypeDeclaration )*
 
 

Author:

Julio Vilmar Gesser

Nested Class Summary

Nested classes/interfaces inherited from class com.github.javaparser.ast.Node

Node.ObserverRegistrationMode

Field Summary

Fields inherited from class com.github.javaparser.ast.Node

ABSOLUTE_BEGIN_LINE, ABSOLUTE_END_LINE, NODE_BY_BEGIN_POSITION, prettyPrinterNoCommentsConfiguration

Constructor Summary

Constructors

Constructor and Description
CompilationUnit()
CompilationUnit(PackageDeclaration packageDeclaration, NodeList<ImportDeclaration> imports, NodeList<TypeDeclaration<?>> types)
CompilationUnit(Range range, PackageDeclaration packageDeclaration, NodeList<ImportDeclaration> imports, NodeList<TypeDeclaration<?>> types)

Method Summary

Modifier and Type	Method and Description
<R,A> R	accept(GenericVisitor<R,A> v, A arg) Accept method for visitor support.
<A> void	accept(VoidVisitor<A> v, A arg) Accept method for visitor support.
AnnotationDeclaration	addAnnotationDeclaration(String name) Add a public annotation declaration to the types of this compilation unit
AnnotationDeclaration	addAnnotationDeclaration(String name, Modifier... modifiers) Add an annotation declaration to the types of this compilation unit
ClassOrInterfaceDeclaration	addClass(String name) Add a public class to the types of this compilation unit
ClassOrInterfaceDeclaration	addClass(String name, Modifier... modifiers) Add a class to the types of this compilation unit
EnumDeclaration	addEnum(String name) Add a public enum to the types of this compilation unit
EnumDeclaration	addEnum(String name, Modifier... modifiers) Add an enum to the types of this compilation unit
CompilationUnit	addImport(Class<?> clazz) Add an import to the list of ImportDeclaration of this compilation unit shorthand for addImport(String) with clazz.getName()
CompilationUnit	addImport(String name) Add an import to the list of ImportDeclaration of this compilation unit shorthand for addImport(String, boolean, boolean) with name,false,false
CompilationUnit	addImport(String name, boolean isStatic, boolean isAsterisk) Add an import to the list of ImportDeclaration of this compilation unit This method check if no import with the same name is already in the list
ClassOrInterfaceDeclaration	addInterface(String name) Add a public interface class to the types of this compilation unit
ClassOrInterfaceDeclaration	addInterface(String name, Modifier... modifiers) Add an interface to the types of this compilation unit
AnnotationDeclaration	getAnnotationDeclarationByName(String annotationName) Try to get an annotation by its name
ClassOrInterfaceDeclaration	getClassByName(String className) Try to get a class by its name
List<Comment>	getComments() Return a list containing all comments declared in this compilation unit.
EnumDeclaration	getEnumByName(String enumName) Try to get an enum by its name
ImportDeclaration	getImport(int i)
NodeList<ImportDeclaration>	getImports() Retrieves the list of imports declared in this compilation unit or null if there is no import.
ClassOrInterfaceDeclaration	getInterfaceByName(String interfaceName) Try to get an interface by its name
List<NodeList<?>>	getNodeLists() The list of NodeLists owned by this node.
Optional<PackageDeclaration>	getPackage() Retrieves the package declaration of this compilation unit. If this compilation unit has no package declaration (default package), null is returned.
TypeDeclaration<?>	getType(int i) Convenience method that wraps getTypes(). If i is out of bounds, throws IndexOutOfBoundsException.
NodeList<TypeDeclaration<?>>	getTypes() Return the list of types declared in this compilation unit. If there is no types declared, null is returned.
CompilationUnit	setImports(NodeList<ImportDeclaration> imports) Sets the list of imports of this compilation unit.
CompilationUnit	setPackage(PackageDeclaration pakage) Sets or clear the package declarations of this compilation unit.
CompilationUnit	setPackage(String s) Shortcut: set the package declaration with a string.
CompilationUnit	setPackageName(String name) sets the package declaration of this compilation unit
CompilationUnit	setTypes(NodeList<TypeDeclaration<?>> types) Sets the list of types declared in this compilation unit.

Methods inherited from class com.github.javaparser.ast.Node

addOrphanComment, clone, containsWithin, equals, getAllContainedComments, getBegin, getChildNodes, getComment, getData, getEnd, getNodesByType, getOrphanComments, getParentNode, getParentNodeForChildren, getRange, hasComment, hashCode, isPositionedAfter, isPositionedBefore, isRegistered, notifyPropertyChange, register, register, registerForSubtree, remove, setAsParentNodeOf, setBlockComment, setComment, setData, setLineComment, setParentNode, setRange, toString, toString, tryAddImportToParentCompilationUnit, unregister

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.github.javaparser.HasParentNode

getAncestorOfType, setAsParentNodeOf, setAsParentNodeOf

Constructor Detail

CompilationUnit

public CompilationUnit()

CompilationUnit

public CompilationUnit(PackageDeclaration packageDeclaration,
                       NodeList<ImportDeclaration> imports,
                       NodeList<TypeDeclaration<?>> types)

CompilationUnit

public CompilationUnit(Range range,
                       PackageDeclaration packageDeclaration,
                       NodeList<ImportDeclaration> imports,
                       NodeList<TypeDeclaration<?>> types)

Method Detail

accept

public <R,A> R accept(GenericVisitor<R,A> v,
                      A arg)

Description copied from interface: Visitable

Accept method for visitor support.

Type Parameters:

R - the type of the return value of the visitor

A - the type the user argument passed to the visitor

Parameters:

v - the visitor implementation

arg - the argument passed to the visitor (of type A)

Returns:

the result of the visit (of type R)

accept

public <A> void accept(VoidVisitor<A> v,
                       A arg)

Description copied from interface: Visitable

Accept method for visitor support.

Type Parameters:

A - the type the argument passed for the visitor

Parameters:

v - the visitor implementation

arg - any value relevant for the visitor (of type A)

getComments

public List<Comment> getComments()

Return a list containing all comments declared in this compilation unit. Including javadocs, line comments and block comments of all types, inner-classes and other members.
If there is no comment, an empty list is returned.

Returns:

list with all comments of this compilation unit.

See Also:

JavadocComment, LineComment, BlockComment

getImports

public NodeList<ImportDeclaration> getImports()

Retrieves the list of imports declared in this compilation unit or null if there is no import.

Returns:

the list of imports or null if there is no import

getImport

public ImportDeclaration getImport(int i)

getPackage

public Optional<PackageDeclaration> getPackage()

Retrieves the package declaration of this compilation unit.
If this compilation unit has no package declaration (default package), null is returned.

Returns:

the package declaration or null

getTypes

public NodeList<TypeDeclaration<?>> getTypes()

Return the list of types declared in this compilation unit.
If there is no types declared, null is returned.

Returns:

the list of types or null null if there is no type

See Also:

AnnotationDeclaration, ClassOrInterfaceDeclaration, EmptyTypeDeclaration, EnumDeclaration

getType

public TypeDeclaration<?> getType(int i)

Convenience method that wraps getTypes().
If i is out of bounds, throws IndexOutOfBoundsException.

Parameters:

i - the index of the type declaration to retrieve

setImports

public CompilationUnit setImports(NodeList<ImportDeclaration> imports)

Sets the list of imports of this compilation unit. The list is initially null.

Parameters:

imports - the list of imports

setPackage

public CompilationUnit setPackage(PackageDeclaration pakage)

Sets or clear the package declarations of this compilation unit.

Parameters:

pakage - the packageDeclaration declaration to set or null to default package

setTypes

public CompilationUnit setTypes(NodeList<TypeDeclaration<?>> types)

Sets the list of types declared in this compilation unit.

Parameters:

types - the lis of types

setPackageName

public CompilationUnit setPackageName(String name)

sets the package declaration of this compilation unit

Parameters:

name - the name of the package

Returns:

this, the CompilationUnit

addImport

public CompilationUnit addImport(String name)

Add an import to the list of ImportDeclaration of this compilation unit
shorthand for addImport(String, boolean, boolean) with name,false,false

Parameters:

name - the import name

Returns:

this, the CompilationUnit

addImport

public CompilationUnit addImport(Class<?> clazz)

Add an import to the list of ImportDeclaration of this compilation unit
shorthand for addImport(String) with clazz.getName()

Parameters:

clazz - the class to import

Returns:

this, the CompilationUnit

addImport

public CompilationUnit addImport(String name,
                                 boolean isStatic,
                                 boolean isAsterisk)

Add an import to the list of ImportDeclaration of this compilation unit
This method check if no import with the same name is already in the list

Parameters:

name - the import name

isStatic - is it an "import static"

isAsterisk - does the import end with ".*"

Returns:

this, the CompilationUnit

addClass

public ClassOrInterfaceDeclaration addClass(String name)

Add a public class to the types of this compilation unit

Parameters:

name - the class name

Returns:

the newly created class

addClass

public ClassOrInterfaceDeclaration addClass(String name,
                                            Modifier... modifiers)

Add a class to the types of this compilation unit

Parameters:

name - the class name

modifiers - the modifiers (like Modifier.PUBLIC)

Returns:

the newly created class

addInterface

public ClassOrInterfaceDeclaration addInterface(String name)

Add a public interface class to the types of this compilation unit

Parameters:

name - the interface name

Returns:

the newly created class

addInterface

public ClassOrInterfaceDeclaration addInterface(String name,
                                                Modifier... modifiers)

Add an interface to the types of this compilation unit

Parameters:

name - the interface name

modifiers - the modifiers (like Modifier.PUBLIC)

Returns:

the newly created class

addEnum

public EnumDeclaration addEnum(String name)

Add a public enum to the types of this compilation unit

Parameters:

name - the enum name

Returns:

the newly created class

addEnum

public EnumDeclaration addEnum(String name,
                               Modifier... modifiers)

Add an enum to the types of this compilation unit

Parameters:

name - the enum name

modifiers - the modifiers (like Modifier.PUBLIC)

Returns:

the newly created class

addAnnotationDeclaration

public AnnotationDeclaration addAnnotationDeclaration(String name)

Add a public annotation declaration to the types of this compilation unit

Parameters:

name - the annotation name

Returns:

the newly created class

addAnnotationDeclaration

public AnnotationDeclaration addAnnotationDeclaration(String name,
                                                      Modifier... modifiers)

Add an annotation declaration to the types of this compilation unit

Parameters:

name - the annotation name

modifiers - the modifiers (like Modifier.PUBLIC)

Returns:

the newly created class

getClassByName

public ClassOrInterfaceDeclaration getClassByName(String className)

Try to get a class by its name

Parameters:

className - the class name (case-sensitive)

Returns:

null if not found, the class otherwise

getInterfaceByName

public ClassOrInterfaceDeclaration getInterfaceByName(String interfaceName)

Try to get an interface by its name

Parameters:

interfaceName - the interface name (case-sensitive)

Returns:

null if not found, the interface otherwise

getEnumByName

public EnumDeclaration getEnumByName(String enumName)

Try to get an enum by its name

Parameters:

enumName - the enum name (case-sensitive)

Returns:

null if not found, the enum otherwise

getAnnotationDeclarationByName

public AnnotationDeclaration getAnnotationDeclarationByName(String annotationName)

Try to get an annotation by its name

Parameters:

annotationName - the annotation name (case-sensitive)

Returns:

null if not found, the annotation otherwise

getNodeLists

public List<NodeList<?>> getNodeLists()

Description copied from class: Node

The list of NodeLists owned by this node.

Overrides:

getNodeLists in class Node

setPackage

public CompilationUnit setPackage(String s)

Shortcut: set the package declaration with a string.