JPackage (Red Hat JBoss Enterprise Application Platform 7.2.0.GA public API)

java.lang.Object
- com.sun.codemodel.JPackage

All Implemented Interfaces:: JAnnotatable, JClassContainer, JDeclaration, JDocCommentable, JGenerable, Comparable<JPackage>

public final class JPackage
extends Object
implements JDeclaration, JGenerable, JClassContainer, JAnnotatable, Comparable<JPackage>, JDocCommentable

A Java package.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`JDefinedClass`	`_annotationTypeDeclaration(String name)` Add an annotationType Declaration to this package
`JDefinedClass`	`_class(int mods, String name)` Add a class to this package.
`JDefinedClass`	`_class(int mods, String name, boolean isInterface)` Deprecated.
`JDefinedClass`	`_class(int mods, String name, ClassType classTypeVal)` Creates a new class/enum/interface/annotation.
`JDefinedClass`	`_class(String name)` Adds a public class to this package.
`JDefinedClass`	`_enum(String name)` Add a public enum to this package
`JDefinedClass`	`_getClass(String name)` Gets a reference to the already created `JDefinedClass`.
`JDefinedClass`	`_interface(int mods, String name)` Add an interface to this package.
`JDefinedClass`	`_interface(String name)` Adds a public interface to this package.
`JResourceFile`	`addResourceFile(JResourceFile rsrc)` Adds a new resource file to this package.
`JAnnotationUse`	`annotate(Class<? extends Annotation> clazz)` Adds an annotation to this program element.
`JAnnotationUse`	`annotate(JClass clazz)` Adds an annotation to this program element.
`<W extends JAnnotationWriter> W`	`annotate2(Class<W> clazz)` Adds an annotation to this program element and returns a type-safe writer to fill in the values of such annotations.
`Collection<JAnnotationUse>`	`annotations()` Read-only live view of all annotations on this `JAnnotatable`
`Iterator<JDefinedClass>`	`classes()` Returns an iterator that walks the top-level classes defined in this package.
`int`	`compareTo(JPackage that)` Order is based on the lexicological order of the package name.
`void`	`declare(JFormatter f)`
`void`	`generate(JFormatter f)`
`JPackage`	`getPackage()` Gets the nearest package parent.
`boolean`	`hasClasses()` Checks if this package contains any classes.
`boolean`	`hasResourceFile(String name)` Checks if a resource of the given name exists.
`boolean`	`isClass()` Returns true if the container is a class.
`boolean`	`isDefined(String classLocalName)` Checks if a given name is already defined as a class/interface
`boolean`	`isPackage()` Returns true if the container is a package.
`boolean`	`isUnnamed()` Checks if this package is the root, unnamed package.
`JDocComment`	`javadoc()` Creates, if necessary, and returns the package javadoc for this JDefinedClass.
`String`	`name()` Get the name of this package
`JCodeModel`	`owner()` Return the code model root object being used to create this package.
`JPackage`	`parent()` Gets the parent package, or null if this class is the root package.
`JClassContainer`	`parentContainer()` Parent JClassContainer.
`Iterator<JResourceFile>`	`propertyFiles()` Iterates all resource files in this package.
`JClass`	`ref(String name)` Reference a class within this package.
`void`	`remove(JClass c)` Removes a class from this package.
`boolean`	`removeAnnotation(JAnnotationUse annotation)` Removes annotation from this program element.
`JPackage`	`subPackage(String pkg)` Gets a reference to a sub package of this package.

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

- Method Detail
  - parentContainer
```
public JClassContainer parentContainer()
```
    Description copied from interface: JClassContainer
    
    Parent JClassContainer. If this is a package, this method returns a parent package, or null if this package is the root package. If this is an outer-most class, this method returns a package to which it belongs. If this is an inner class, this method returns the outer class.
    
    Specified by:
    
    parentContainer in interface JClassContainer
  - parent
```
public JPackage parent()
```
    Gets the parent package, or null if this class is the root package.
  - isClass
```
public boolean isClass()
```
    Description copied from interface: JClassContainer
    
    Returns true if the container is a class.
    
    Specified by:
    
    isClass in interface JClassContainer
  - isPackage
```
public boolean isPackage()
```
    Description copied from interface: JClassContainer
    
    Returns true if the container is a package.
    
    Specified by:
    
    isPackage in interface JClassContainer
  - getPackage
```
public JPackage getPackage()
```
    Description copied from interface: JClassContainer
    
    Gets the nearest package parent.
    If this.isPackage(), then return this.
    
    Specified by:
    
    getPackage in interface JClassContainer
  - _class
```
public JDefinedClass _class(int mods,
                            String name)
                     throws JClassAlreadyExistsException
```
    Add a class to this package.
    
    Specified by:
    
    _class in interface JClassContainer
    
    Parameters:
    
    mods - Modifiers for this class declaration
    
    name - Name of class to be added to this package
    
    Returns:
    
    Newly generated class
    
    Throws:
    
    JClassAlreadyExistsException - When the specified class/interface was already created.
  - _class
```
public JDefinedClass _class(int mods,
                            String name,
                            boolean isInterface)
                     throws JClassAlreadyExistsException
```
    Deprecated.
    
    Create a new class or a new interface.
    
    Specified by:
    
    _class in interface JClassContainer
    
    Throws:
    
    JClassAlreadyExistsException
  - _class
```
public JDefinedClass _class(int mods,
                            String name,
                            ClassType classTypeVal)
                     throws JClassAlreadyExistsException
```
    Description copied from interface: JClassContainer
    
    Creates a new class/enum/interface/annotation.
    
    Specified by:
    
    _class in interface JClassContainer
    
    Throws:
    
    JClassAlreadyExistsException
  - _class
```
public JDefinedClass _class(String name)
                     throws JClassAlreadyExistsException
```
    Adds a public class to this package.
    
    Specified by:
    
    _class in interface JClassContainer
    
    Throws:
    
    JClassAlreadyExistsException - When the specified class/interface was already created.
  - _getClass
```
public JDefinedClass _getClass(String name)
```
    Gets a reference to the already created JDefinedClass.
    
    Returns:
    
    null If the class is not yet created.
  - compareTo
```
public int compareTo(JPackage that)
```
    Order is based on the lexicological order of the package name.
    
    Specified by:
    
    compareTo in interface Comparable<JPackage>
  - _interface
```
public JDefinedClass _interface(int mods,
                                String name)
                         throws JClassAlreadyExistsException
```
    Add an interface to this package.
    
    Specified by:
    
    _interface in interface JClassContainer
    
    Parameters:
    
    mods - Modifiers for this interface declaration
    
    name - Name of interface to be added to this package
    
    Returns:
    
    Newly generated interface
    
    Throws:
    
    JClassAlreadyExistsException - When the specified class/interface was already created.
  - _interface
```
public JDefinedClass _interface(String name)
                         throws JClassAlreadyExistsException
```
    Adds a public interface to this package.
    
    Specified by:
    
    _interface in interface JClassContainer
    
    Throws:
    
    JClassAlreadyExistsException - When the specified class/interface was already created.
  - _annotationTypeDeclaration
```
public JDefinedClass _annotationTypeDeclaration(String name)
                                         throws JClassAlreadyExistsException
```
    Add an annotationType Declaration to this package
    
    Specified by:
    
    _annotationTypeDeclaration in interface JClassContainer
    
    Parameters:
    
    name - Name of the annotation Type declaration to be added to this package
    
    Returns:
    
    newly created Annotation Type Declaration
    
    Throws:
    
    JClassAlreadyExistsException - When the specified class/interface was already created.
  - _enum
```
public JDefinedClass _enum(String name)
                    throws JClassAlreadyExistsException
```
    Add a public enum to this package
    
    Specified by:
    
    _enum in interface JClassContainer
    
    Parameters:
    
    name - Name of the enum to be added to this package
    
    Returns:
    
    newly created Enum
    
    Throws:
    
    JClassAlreadyExistsException - When the specified class/interface was already created.
  - addResourceFile
```
public JResourceFile addResourceFile(JResourceFile rsrc)
```
    Adds a new resource file to this package.
  - hasResourceFile
```
public boolean hasResourceFile(String name)
```
    Checks if a resource of the given name exists.
  - propertyFiles
```
public Iterator<JResourceFile> propertyFiles()
```
    Iterates all resource files in this package.
  - javadoc
```
public JDocComment javadoc()
```
    Creates, if necessary, and returns the package javadoc for this JDefinedClass.
    
    Specified by:
    
    javadoc in interface JDocCommentable
    
    Returns:
    
    JDocComment containing javadocs for this class
  - remove
```
public void remove(JClass c)
```
    Removes a class from this package.
  - ref
```
public JClass ref(String name)
           throws ClassNotFoundException
```
    Reference a class within this package.
    
    Throws:
    
    ClassNotFoundException
  - subPackage
```
public JPackage subPackage(String pkg)
```
    Gets a reference to a sub package of this package.
  - classes
```
public Iterator<JDefinedClass> classes()
```
    Returns an iterator that walks the top-level classes defined in this package.
    
    Specified by:
    
    classes in interface JClassContainer
  - hasClasses
```
public boolean hasClasses()
```
    Checks if this package contains any classes.
    
    Returns:
    
    true if this package contains any classes or false otherwise.
  - isDefined
```
public boolean isDefined(String classLocalName)
```
    Checks if a given name is already defined as a class/interface
  - isUnnamed
```
public final boolean isUnnamed()
```
    Checks if this package is the root, unnamed package.
  - name
```
public String name()
```
    Get the name of this package
    
    Returns:
    
    The name of this package, or the empty string if this is the null package. For example, this method returns strings like "java.lang"
  - owner
```
public final JCodeModel owner()
```
    Return the code model root object being used to create this package.
    
    Specified by:
    
    owner in interface JClassContainer
  - annotate
```
public JAnnotationUse annotate(JClass clazz)
```
    Description copied from interface: JAnnotatable
    
    Adds an annotation to this program element.
    
    Specified by:
    
    annotate in interface JAnnotatable
    
    Parameters:
    
    clazz - The annotation class to annotate the program element with
  - annotate
```
public JAnnotationUse annotate(Class<? extends Annotation> clazz)
```
    Description copied from interface: JAnnotatable
    
    Adds an annotation to this program element.
    
    Specified by:
    
    annotate in interface JAnnotatable
    
    Parameters:
    
    clazz - The annotation class to annotate the program element with
  - annotate2
```
public <W extends JAnnotationWriter> W annotate2(Class<W> clazz)
```
    Description copied from interface: JAnnotatable
    
    Adds an annotation to this program element and returns a type-safe writer to fill in the values of such annotations.
    
    Specified by:
    
    annotate2 in interface JAnnotatable
  - removeAnnotation
```
public boolean removeAnnotation(JAnnotationUse annotation)
```
    Description copied from interface: JAnnotatable
    
    Removes annotation from this program element.
    
    Specified by:
    
    removeAnnotation in interface JAnnotatable
    
    Parameters:
    
    annotation - The annotation to be removed from the program element
  - annotations
```
public Collection<JAnnotationUse> annotations()
```
    Description copied from interface: JAnnotatable
    
    Read-only live view of all annotations on this JAnnotatable
    
    Specified by:
    
    annotations in interface JAnnotatable
    
    Returns:
    
    Can be empty but never null.
  - declare
```
public void declare(JFormatter f)
```
    Specified by:
    
    declare in interface JDeclaration
  - generate
```
public void generate(JFormatter f)
```
    Specified by:
    
    generate in interface JGenerable

Class JPackage

Method Summary

Methods inherited from class java.lang.Object

Method Detail

parentContainer

parent

isClass

isPackage

getPackage

_class

_class

_class

_class

_getClass

compareTo

_interface

_interface

_annotationTypeDeclaration

_enum

addResourceFile

hasResourceFile

propertyFiles

javadoc

remove

ref

subPackage

classes

hasClasses

isDefined

isUnnamed

name

owner

annotate

annotate

annotate2

removeAnnotation

annotations

declare

generate