com.github.javaparser.ast

Class CompilationUnit

java.lang.Object

com.github.javaparser.ast.Node

com.github.javaparser.ast.CompilationUnit

All Implemented Interfaces:

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

Field Summary

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

ABSOLUTE_BEGIN_LINE, ABSOLUTE_END_LINE, NODE_BY_BEGIN_POSITION

Constructor Summary

Constructors

Constructor and Description
CompilationUnit()
CompilationUnit(Optional<PackageDeclaration> pakage, NodeList<ImportDeclaration> imports, NodeList<TypeDeclaration<?>> types)
CompilationUnit(Range range, Optional<PackageDeclaration> pakage, 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
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
Optional<PackageDeclaration>	getPackage() Retrieves the package declaration of this compilation unit. If this compilation unit has no package declaration (default package), null is returned.
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(Optional<PackageDeclaration> pakage) Sets or clear the package declarations of this compilation unit.
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, getBackwardsCompatibleChildrenNodes, getBegin, getChildrenNodes, getComment, getEnd, getNodesByType, getOrphanComments, getParentNode, getParentNodeOfType, getRange, getUserData, hashCode, isPositionedAfter, isPositionedBefore, remove, setAsParentNodeOf, setAsParentNodeOf, setAsParentNodeOf, setBegin, setBlockComment, setComment, setEnd, setLineComment, setParentNode, setRange, setUserData, toString, toStringWithoutComments, tryAddImportToParentCompilationUnit

Methods inherited from class java.lang.Object

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

Constructor Detail

CompilationUnit

public CompilationUnit()

CompilationUnit

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

CompilationUnit

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

Method Detail

accept

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

Description copied from class: Node

Accept method for visitor support.

Specified by:

accept in class Node

Type Parameters:

R - the type the return value of the visitor

A - the type the argument passed to the visitor

Parameters:

v - the visitor implementation

arg - the argument passed to the visitor

Returns:

the result of the visit

accept

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

Description copied from class: Node

Accept method for visitor support.

Specified by:

accept in class Node

Type Parameters:

A - the type the argument passed for the visitor

Parameters:

v - the visitor implementation

arg - any value relevant for the visitor

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, null is returned.

Returns:

list with all comments of this compilation unit or null

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

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

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(Optional<PackageDeclaration> pakage)

Sets or clear the package declarations of this compilation unit.

Parameters:

pakage - the pakage 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