- java.lang.Object
-
- com.sun.codemodel.JType
-
- com.sun.codemodel.JClass
-
- com.sun.codemodel.JDefinedClass
-
- All Implemented Interfaces:
JAnnotatable
,JClassContainer
,JDeclaration
,JDocCommentable
,JGenerable
,JGenerifiable
,Comparable<JType>
public class JDefinedClass extends JClass implements JDeclaration, JClassContainer, JGenerifiable, JAnnotatable, JDocCommentable
A generated Java class/interface/enum/....This class models a declaration, and since a declaration can be always used as a reference, it inherits
JClass
.Where to go from here?
You'd want to generate fields and methods on a class. See
method(int, JType, String)
andfield(int, JType, String)
.
-
-
Field Summary
Fields Modifier and Type Field Description Object
metadata
Client-app spcific metadata associated with this user-created class.-
Fields inherited from class com.sun.codemodel.JClass
EMPTY_ARRAY
-
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description JDefinedClass
_annotationTypeDeclaration(String name)
Add an annotationType Declaration to this packageJDefinedClass
_class(int mods, String name)
Add a new nested class to this class.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)
Add a new public nested class to this class.JDefinedClass
_enum(int mods, String name)
Add a public enum to this packageJDefinedClass
_enum(String name)
Add a public enum to this packageJClass
_extends()
Returns the class extended by this class.JDefinedClass
_extends(JClass superClass)
This class extends the specifed class.JDefinedClass
_extends(Class<?> superClass)
Iterator<JClass>
_implements()
Returns an iterator that walks the nested classes defined in this class.JDefinedClass
_implements(JClass iface)
This class implements the specifed interface.JDefinedClass
_implements(Class<?> iface)
JDefinedClass
_interface(int mods, String name)
Add an interface to this package.JDefinedClass
_interface(String name)
Adds a public interface to this package.JPackage
_package()
Gets the package to which this class belongs.JAnnotationUse
annotate(JClass clazz)
Adding ability to annotate a classJAnnotationUse
annotate(Class<? extends Annotation> clazz)
Adding ability to annotate a class<W extends JAnnotationWriter<? extends Annotation>>
Wannotate2(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()
String
binaryName()
Gets the binary name of the type.Iterator<JDefinedClass>
classes()
Returns an iterator that walks the nested classes defined in this class.JMethod
constructor(int mods)
Adds a constructor to this class.Iterator<JMethod>
constructors()
Returns an iterator that walks the constructors defined in this class.void
declare(JFormatter f)
protected void
declareBody(JFormatter f)
prints the body of a class.void
direct(String string)
Places the given string directly inside the generated class.JEnumConstant
enumConstant(String name)
If the named enum already exists, the reference to it is returned.JFieldVar
field(int mods, JType type, String name)
Adds a field to the list of field members of this JDefinedClass.JFieldVar
field(int mods, JType type, String name, JExpression init)
Adds a field to the list of field members of this JDefinedClass.JFieldVar
field(int mods, Class<?> type, String name)
JFieldVar
field(int mods, Class<?> type, String name, JExpression init)
Map<String,JFieldVar>
fields()
Returns all the fields declred in this class.String
fullName()
Gets the fully qualified name of this class.JTypeVar
generify(String name)
Adds a new type variable to this declaration.JTypeVar
generify(String name, JClass bound)
Adds a new type variable to this declaration with a bound.JTypeVar
generify(String name, Class<?> bound)
Adds a new type variable to this declaration with a bound.ClassType
getClassType()
JMethod
getConstructor(JType[] argTypes)
Looks for a method that has the specified method signature and return it.JMethod
getMethod(String name, JType[] argTypes)
Looks for a method that has the specified method signature and return it.JPackage
getPackage()
Gets the nearest package parent.void
hide()
Mark this file as hidden, so that this file won't be generated.JBlock
init()
Creates, if necessary, and returns the static initializer for this class.JBlock
instanceInit()
Creates, if necessary, and returns the instance initializer for this class.boolean
isAbstract()
Checks if this class is an abstract class.boolean
isAnnotationTypeDeclaration()
This method indicates if the interface is an annotationTypeDeclarationboolean
isAnonymous()
Returns true if this is an anonymous class.boolean
isClass()
Returns true if the container is a class.boolean
isHidden()
boolean
isInterface()
Checks if this object represents an interface.boolean
isPackage()
Returns true if the container is a package.JDocComment
javadoc()
Creates, if necessary, and returns the class javadoc for this JDefinedClassJClass[]
listClasses()
Returns all the nested classes defined in this class.JMethod
method(int mods, JType type, String name)
Add a method to the list of method members of this JDefinedClass instance.JMethod
method(int mods, Class<?> type, String name)
Collection<JMethod>
methods()
Returns the set of methods defined in this class.JMods
mods()
String
name()
JClass name accessor.JClass
outer()
Returns the class in which this class is nested, ornull
if this is a top-level class.JClassContainer
parentContainer()
Parent JClassContainer.boolean
removeAnnotation(JAnnotationUse annotation)
Removes annotation from this program element.void
removeField(JFieldVar field)
Removes aJFieldVar
from this class.protected JClass
substituteParams(JTypeVar[] variables, List<JClass> bindings)
Substitutes the type variables with their actual arguments.JTypeVar[]
typeParams()
Iterates all the type parameters of this class/interface.-
Methods inherited from class com.sun.codemodel.JClass
array, boxify, dotclass, erasure, generate, getBaseClass, getBaseClass, getPrimitiveType, getTypeParameters, isAssignableFrom, isParameterized, narrow, narrow, narrow, narrow, narrow, narrow, owner, staticInvoke, staticInvoke, staticRef, staticRef, toString, unboxify, wildcard
-
Methods inherited from class com.sun.codemodel.JType
compareTo, elementType, isArray, isPrimitive, isReference, parse
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.sun.codemodel.JClassContainer
owner
-
-
-
-
Field Detail
-
metadata
public Object metadata
Client-app spcific metadata associated with this user-created class.
-
-
Method Detail
-
isAnonymous
public final boolean isAnonymous()
Returns true if this is an anonymous class.
-
_extends
public JDefinedClass _extends(JClass superClass)
This class extends the specifed class.- Parameters:
superClass
- Superclass for this class- Returns:
- This class
-
_extends
public JDefinedClass _extends(Class<?> superClass)
-
_extends
public JClass _extends()
Returns the class extended by this class.- Specified by:
_extends
in classJClass
- Returns:
- Returns the JClass representing the superclass of the
entity (class or interface) represented by this
JClass
. Even if no super class is given explicitly or thisJClass
is not a class, this method still returnsJClass
forObject
. If this JClass representsObject
, return null.
-
_implements
public JDefinedClass _implements(JClass iface)
This class implements the specifed interface.- Parameters:
iface
- Interface that this class implements- Returns:
- This class
-
_implements
public JDefinedClass _implements(Class<?> iface)
-
_implements
public Iterator<JClass> _implements()
Returns an iterator that walks the nested classes defined in this class.- Specified by:
_implements
in classJClass
- Returns:
- A non-null valid iterator that iterates all
JClass
objects that represents those interfaces implemented by this object.
-
name
public String name()
JClass name accessor.For example, for
java.util.List
, this method returns"List"
"
-
enumConstant
public JEnumConstant enumConstant(String name)
If the named enum already exists, the reference to it is returned. Otherwise this method generates a new enum reference with the given name and returns it.- Parameters:
name
- The name of the constant.- Returns:
- The generated type-safe enum constant.
-
fullName
public String fullName()
Gets the fully qualified name of this class.
-
binaryName
public String binaryName()
Description copied from class:JType
Gets the binary name of the type. See http://java.sun.com/docs/books/jls/third_edition/html/binaryComp.html#44909- Overrides:
binaryName
in classJType
- Returns:
- Name like "Foo$Bar", "int", "java.lang.String", "java.io.File[]". Never null.
-
isInterface
public boolean isInterface()
Description copied from class:JClass
Checks if this object represents an interface.- Specified by:
isInterface
in classJClass
-
isAbstract
public boolean isAbstract()
Description copied from class:JClass
Checks if this class is an abstract class.- Specified by:
isAbstract
in classJClass
-
field
public JFieldVar field(int mods, JType type, String name)
Adds a field to the list of field members of this JDefinedClass.- Parameters:
mods
- Modifiers for this fieldtype
- JType of this fieldname
- Name of this field- Returns:
- Newly generated field
-
field
public JFieldVar field(int mods, JType type, String name, JExpression init)
Adds a field to the list of field members of this JDefinedClass.- Parameters:
mods
- Modifiers for this field.type
- JType of this field.name
- Name of this field.init
- Initial value of this field.- Returns:
- Newly generated field
-
isAnnotationTypeDeclaration
public boolean isAnnotationTypeDeclaration()
This method indicates if the interface is an annotationTypeDeclaration
-
_annotationTypeDeclaration
public JDefinedClass _annotationTypeDeclaration(String name) throws JClassAlreadyExistsException
Add an annotationType Declaration to this package- Specified by:
_annotationTypeDeclaration
in interfaceJClassContainer
- 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 interfaceJClassContainer
- 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.
-
_enum
public JDefinedClass _enum(int mods, String name) throws JClassAlreadyExistsException
Add a public enum to this package- Parameters:
name
- Name of the enum to be added to this packagemods
- Modifiers for this enum declaration- Returns:
- newly created Enum
- Throws:
JClassAlreadyExistsException
- When the specified class/interface was already created.
-
getClassType
public ClassType getClassType()
-
field
public JFieldVar field(int mods, Class<?> type, String name, JExpression init)
-
fields
public Map<String,JFieldVar> fields()
Returns all the fields declred in this class. The returnedMap
is a read-only live view.- Returns:
- always non-null.
-
removeField
public void removeField(JFieldVar field)
Removes aJFieldVar
from this class.- Throws:
IllegalArgumentException
- if the given field is not a field on this class.
-
init
public JBlock init()
Creates, if necessary, and returns the static initializer for this class.- Returns:
- JBlock containing initialization statements for this class
-
instanceInit
public JBlock instanceInit()
Creates, if necessary, and returns the instance initializer for this class.- Returns:
- JBlock containing initialization statements for this class
-
constructor
public JMethod constructor(int mods)
Adds a constructor to this class.- Parameters:
mods
- Modifiers for this constructor
-
constructors
public Iterator<JMethod> constructors()
Returns an iterator that walks the constructors defined in this class.
-
getConstructor
public JMethod getConstructor(JType[] argTypes)
Looks for a method that has the specified method signature and return it.- Returns:
- null if not found.
-
method
public JMethod method(int mods, JType type, String name)
Add a method to the list of method members of this JDefinedClass instance.- Parameters:
mods
- Modifiers for this methodtype
- Return type for this methodname
- Name of the method- Returns:
- Newly generated JMethod
-
methods
public Collection<JMethod> methods()
Returns the set of methods defined in this class.
-
getMethod
public JMethod getMethod(String name, JType[] argTypes)
Looks for a method that has the specified method signature and return it.- Returns:
- null if not found.
-
isClass
public boolean isClass()
Description copied from interface:JClassContainer
Returns true if the container is a class.- Specified by:
isClass
in interfaceJClassContainer
-
isPackage
public boolean isPackage()
Description copied from interface:JClassContainer
Returns true if the container is a package.- Specified by:
isPackage
in interfaceJClassContainer
-
getPackage
public JPackage getPackage()
Description copied from interface:JClassContainer
Gets the nearest package parent.If
this.isPackage()
, then returnthis
.- Specified by:
getPackage
in interfaceJClassContainer
-
_class
public JDefinedClass _class(int mods, String name) throws JClassAlreadyExistsException
Add a new nested class to this class.- Specified by:
_class
in interfaceJClassContainer
- Parameters:
mods
- Modifiers for this class declarationname
- Name of class to be added to this package- Returns:
- Newly generated class
- Throws:
JClassAlreadyExistsException
- When the specified class/interface was already created.
-
_class
@Deprecated public JDefinedClass _class(int mods, String name, boolean isInterface) throws JClassAlreadyExistsException
Deprecated.Create a new class or a new interface.- Specified by:
_class
in interfaceJClassContainer
- 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 interfaceJClassContainer
- Throws:
JClassAlreadyExistsException
-
_class
public JDefinedClass _class(String name) throws JClassAlreadyExistsException
Add a new public nested class to this class.- Specified by:
_class
in interfaceJClassContainer
- Throws:
JClassAlreadyExistsException
- When the specified class/interface was already created.
-
_interface
public JDefinedClass _interface(int mods, String name) throws JClassAlreadyExistsException
Add an interface to this package.- Specified by:
_interface
in interfaceJClassContainer
- Parameters:
mods
- Modifiers for this interface declarationname
- 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 interfaceJClassContainer
- Throws:
JClassAlreadyExistsException
- When the specified class/interface was already created.
-
javadoc
public JDocComment javadoc()
Creates, if necessary, and returns the class javadoc for this JDefinedClass- Specified by:
javadoc
in interfaceJDocCommentable
- Returns:
- JDocComment containing javadocs for this class
-
hide
public void hide()
Mark this file as hidden, so that this file won't be generated.This feature could be used to generate code that refers to class X, without actually generating X.java.
-
isHidden
public boolean isHidden()
-
classes
public final Iterator<JDefinedClass> classes()
Returns an iterator that walks the nested classes defined in this class.- Specified by:
classes
in interfaceJClassContainer
-
listClasses
public final JClass[] listClasses()
Returns all the nested classes defined in this class.
-
outer
public JClass outer()
Description copied from class:JClass
Returns the class in which this class is nested, ornull
if this is a top-level class.
-
declare
public void declare(JFormatter f)
- Specified by:
declare
in interfaceJDeclaration
-
declareBody
protected void declareBody(JFormatter f)
prints the body of a class.
-
direct
public void direct(String string)
Places the given string directly inside the generated class. This method can be used to add methods/fields that are not generated by CodeModel. This method should be used only as the last resort.
-
_package
public final JPackage _package()
Description copied from class:JClass
Gets the package to which this class belongs. TODO: shall we move move this down?
-
parentContainer
public final 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 interfaceJClassContainer
-
generify
public JTypeVar generify(String name)
Description copied from interface:JGenerifiable
Adds a new type variable to this declaration.- Specified by:
generify
in interfaceJGenerifiable
-
generify
public JTypeVar generify(String name, Class<?> bound)
Description copied from interface:JGenerifiable
Adds a new type variable to this declaration with a bound.- Specified by:
generify
in interfaceJGenerifiable
-
generify
public JTypeVar generify(String name, JClass bound)
Description copied from interface:JGenerifiable
Adds a new type variable to this declaration with a bound.- Specified by:
generify
in interfaceJGenerifiable
-
typeParams
public JTypeVar[] typeParams()
Description copied from class:JClass
Iterates all the type parameters of this class/interface.For example, if this
JClass
representsSet<T>
, this method returns an array that contains singleJTypeVar
for 'T'.- Specified by:
typeParams
in interfaceJGenerifiable
- Overrides:
typeParams
in classJClass
-
substituteParams
protected JClass substituteParams(JTypeVar[] variables, List<JClass> bindings)
Description copied from class:JClass
Substitutes the type variables with their actual arguments.For example, when this class is
Map<String,Map<V>>
, (where V then doing substituteParams( V, Integer ) returns aJClass
forMap<String,Map<Integer>>
.This method needs to work recursively.
- Specified by:
substituteParams
in classJClass
-
annotate
public JAnnotationUse annotate(Class<? extends Annotation> clazz)
Adding ability to annotate a class- Specified by:
annotate
in interfaceJAnnotatable
- Parameters:
clazz
- The annotation class to annotate the class with
-
annotate
public JAnnotationUse annotate(JClass clazz)
Adding ability to annotate a class- Specified by:
annotate
in interfaceJAnnotatable
- Parameters:
clazz
- The annotation class to annotate the class with
-
annotate2
public <W extends JAnnotationWriter<? extends Annotation>> 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 interfaceJAnnotatable
- Returns:
-
removeAnnotation
public boolean removeAnnotation(JAnnotationUse annotation)
Description copied from interface:JAnnotatable
Removes annotation from this program element.- Specified by:
removeAnnotation
in interfaceJAnnotatable
- Parameters:
annotation
- The annotation to be removed from the program element
-
annotations
public Collection<JAnnotationUse> annotations()
- Specified by:
annotations
in interfaceJAnnotatable
- Returns:
- Can be empty but never null.
-
mods
public JMods mods()
- Returns:
- the current modifiers of this class. Always return non-null valid object.
-
-