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.

A compilation unit start with an optional package declaration, followed by zero or more import declarations, followed by zero or more type declarations.

Author:

Julio Vilmar Gesser

See Also:

PackageDeclaration, ImportDeclaration, TypeDeclaration

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(ImportDeclaration imports)
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
CompilationUnit	addType(TypeDeclaration<?> type)
Optional<AnnotationDeclaration>	getAnnotationDeclarationByName(String annotationName) Try to get an annotation by its name
Optional<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.
Optional<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.
Optional<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>	getPackageDeclaration() 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	setImport(int i, ImportDeclaration imports)
CompilationUnit	setImports(NodeList<ImportDeclaration> imports) Sets the list of imports of this compilation unit.
CompilationUnit	setPackageDeclaration(PackageDeclaration pakage) Sets or clear the package declarations of this compilation unit.
CompilationUnit	setPackageDeclaration(String s) Shortcut: set the package declaration with a string.
CompilationUnit	setPackageName(String name) sets the package declaration of this compilation unit
CompilationUnit	setType(int i, TypeDeclaration<?> type)
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)

getPackageDeclaration

public Optional<PackageDeclaration> getPackageDeclaration()

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

setImport

public CompilationUnit setImport(int i,
                                 ImportDeclaration imports)

addImport

public CompilationUnit addImport(ImportDeclaration imports)

setPackageDeclaration

public CompilationUnit setPackageDeclaration(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.

setType

public CompilationUnit setType(int i,
                               TypeDeclaration<?> type)

addType

public CompilationUnit addType(TypeDeclaration<?> type)

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 Optional<ClassOrInterfaceDeclaration> getClassByName(String className)

Try to get a class by its name

Parameters:

className - the class name (case-sensitive)

getInterfaceByName

public Optional<ClassOrInterfaceDeclaration> getInterfaceByName(String interfaceName)

Try to get an interface by its name

Parameters:

interfaceName - the interface name (case-sensitive)

getEnumByName

public Optional<EnumDeclaration> getEnumByName(String enumName)

Try to get an enum by its name

Parameters:

enumName - the enum name (case-sensitive)

getAnnotationDeclarationByName

public Optional<AnnotationDeclaration> getAnnotationDeclarationByName(String annotationName)

Try to get an annotation by its name

Parameters:

annotationName - the annotation name (case-sensitive)

getNodeLists

public List<NodeList<?>> getNodeLists()

Description copied from class: Node

The list of NodeLists owned by this node.

Overrides:

getNodeLists in class Node

setPackageDeclaration

public CompilationUnit setPackageDeclaration(String s)

Shortcut: set the package declaration with a string.