public class ClassNode extends AnnotatedNode implements org.objectweb.asm.Opcodes
A ClassNode should be created using the methods in ClassHelper. This ClassNode may be used to represent a class declaration or any other type. This class uses a proxy mechanism allowing to create a class for a plain name at AST creation time. In another phase of the compiler the real ClassNode for the plain name may be found. To avoid the need of exchanging this ClassNode with an instance of the correct ClassNode the correct ClassNode is set as redirect. Most method calls are then redirected to that ClassNode.
There are three types of ClassNodes:
To describe generic type signature see getGenericsTypes()
and
setGenericsTypes(GenericsType[])
. These methods are not proxied,
they describe the type signature used at the point of declaration or the
type signatures provided by the class. If the type signatures provided
by the class are needed, then a call to redirect()
will help.
ClassHelper
Modifier and Type | Field and Description |
---|---|
protected Class |
clazz |
static ClassNode[] |
EMPTY_ARRAY |
protected List<InnerClassNode> |
innerClasses |
protected boolean |
isPrimaryNode |
protected Object |
lazyInitLock |
static ClassNode |
SUPER |
static ClassNode |
THIS |
AALOAD, AASTORE, ACC_ABSTRACT, ACC_ANNOTATION, ACC_BRIDGE, ACC_DEPRECATED, ACC_ENUM, ACC_FINAL, ACC_INTERFACE, ACC_MANDATED, ACC_MODULE, ACC_NATIVE, ACC_OPEN, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STATIC_PHASE, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_SYNTHETIC, ACC_TRANSIENT, ACC_TRANSITIVE, ACC_VARARGS, ACC_VOLATILE, ACONST_NULL, ALOAD, ANEWARRAY, ARETURN, ARRAYLENGTH, ASM4, ASM5, ASM6, ASM7, ASM8_EXPERIMENTAL, ASTORE, ATHROW, BALOAD, BASTORE, BIPUSH, CALOAD, CASTORE, CHECKCAST, D2F, D2I, D2L, DADD, DALOAD, DASTORE, DCMPG, DCMPL, DCONST_0, DCONST_1, DDIV, DLOAD, DMUL, DNEG, DOUBLE, DREM, DRETURN, DSTORE, DSUB, DUP, DUP_X1, DUP_X2, DUP2, DUP2_X1, DUP2_X2, F_APPEND, F_CHOP, F_FULL, F_NEW, F_SAME, F_SAME1, F2D, F2I, F2L, FADD, FALOAD, FASTORE, FCMPG, FCMPL, FCONST_0, FCONST_1, FCONST_2, FDIV, FLOAD, FLOAT, FMUL, FNEG, FREM, FRETURN, FSTORE, FSUB, GETFIELD, GETSTATIC, GOTO, H_GETFIELD, H_GETSTATIC, H_INVOKEINTERFACE, H_INVOKESPECIAL, H_INVOKESTATIC, H_INVOKEVIRTUAL, H_NEWINVOKESPECIAL, H_PUTFIELD, H_PUTSTATIC, I2B, I2C, I2D, I2F, I2L, I2S, IADD, IALOAD, IAND, IASTORE, ICONST_0, ICONST_1, ICONST_2, ICONST_3, ICONST_4, ICONST_5, ICONST_M1, IDIV, IF_ACMPEQ, IF_ACMPNE, IF_ICMPEQ, IF_ICMPGE, IF_ICMPGT, IF_ICMPLE, IF_ICMPLT, IF_ICMPNE, IFEQ, IFGE, IFGT, IFLE, IFLT, IFNE, IFNONNULL, IFNULL, IINC, ILOAD, IMUL, INEG, INSTANCEOF, INTEGER, INVOKEDYNAMIC, INVOKEINTERFACE, INVOKESPECIAL, INVOKESTATIC, INVOKEVIRTUAL, IOR, IREM, IRETURN, ISHL, ISHR, ISTORE, ISUB, IUSHR, IXOR, JSR, L2D, L2F, L2I, LADD, LALOAD, LAND, LASTORE, LCMP, LCONST_0, LCONST_1, LDC, LDIV, LLOAD, LMUL, LNEG, LONG, LOOKUPSWITCH, LOR, LREM, LRETURN, LSHL, LSHR, LSTORE, LSUB, LUSHR, LXOR, MONITORENTER, MONITOREXIT, MULTIANEWARRAY, NEW, NEWARRAY, NOP, NULL, POP, POP2, PUTFIELD, PUTSTATIC, RET, RETURN, SALOAD, SASTORE, SIPUSH, SOURCE_DEPRECATED, SOURCE_MASK, SWAP, T_BOOLEAN, T_BYTE, T_CHAR, T_DOUBLE, T_FLOAT, T_INT, T_LONG, T_SHORT, TABLESWITCH, TOP, UNINITIALIZED_THIS, V_PREVIEW, V1_1, V1_2, V1_3, V1_4, V1_5, V1_6, V1_7, V1_8, V10, V11, V12, V13, V14, V15, V9
DOC_COMMENT
Constructor and Description |
---|
ClassNode(Class<?> c)
Creates a non-primary
ClassNode from a real class. |
ClassNode(String name,
int modifiers,
ClassNode superClass) |
ClassNode(String name,
int modifiers,
ClassNode superClass,
ClassNode[] interfaces,
MixinNode[] mixins) |
Modifier and Type | Method and Description |
---|---|
void |
addConstructor(ConstructorNode node) |
ConstructorNode |
addConstructor(int modifiers,
Parameter[] parameters,
ClassNode[] exceptions,
Statement code) |
void |
addField(FieldNode node) |
FieldNode |
addField(String name,
int modifiers,
ClassNode type,
Expression initialValue) |
void |
addFieldFirst(FieldNode node) |
FieldNode |
addFieldFirst(String name,
int modifiers,
ClassNode type,
Expression initialValue) |
void |
addInterface(ClassNode type) |
void |
addMethod(MethodNode node) |
MethodNode |
addMethod(String name,
int modifiers,
ClassNode returnType,
Parameter[] parameters,
ClassNode[] exceptions,
Statement code)
If a method with the given name and parameters is already defined then it is returned
otherwise the given method is added to this node.
|
void |
addMixin(MixinNode mixin) |
void |
addObjectInitializerStatements(Statement statements)
Adds a statement to the object initializer.
|
void |
addProperty(PropertyNode node) |
PropertyNode |
addProperty(String name,
int modifiers,
ClassNode type,
Expression initialValueExpression,
Statement getterBlock,
Statement setterBlock) |
void |
addStaticInitializerStatements(List<Statement> staticStatements,
boolean fieldInit) |
MethodNode |
addSyntheticMethod(String name,
int modifiers,
ClassNode returnType,
Parameter[] parameters,
ClassNode[] exceptions,
Statement code)
Adds a synthetic method as part of the compilation process.
|
void |
addTransform(Class<? extends ASTTransformation> transform,
ASTNode node) |
GenericsType |
asGenericsType() |
boolean |
declaresAnyInterfaces(ClassNode... classNodes) |
boolean |
declaresInterface(ClassNode classNode) |
boolean |
equals(Object that) |
List<MethodNode> |
getAbstractMethods() |
List<MethodNode> |
getAllDeclaredMethods() |
Set<ClassNode> |
getAllInterfaces() |
List<AnnotationNode> |
getAnnotations() |
List<AnnotationNode> |
getAnnotations(ClassNode type) |
CompileUnit |
getCompileUnit() |
ClassNode |
getComponentType() |
ConstructorNode |
getDeclaredConstructor(Parameter[] parameters) |
List<ConstructorNode> |
getDeclaredConstructors() |
FieldNode |
getDeclaredField(String name)
Finds a field matching the given name in this class.
|
MethodNode |
getDeclaredMethod(String name,
Parameter[] parameters)
Finds a method matching the given name and parameters in this class.
|
List<MethodNode> |
getDeclaredMethods(String name)
This methods returns a list of all methods of the given name
defined in the current class
|
Map<String,MethodNode> |
getDeclaredMethodsMap() |
MethodNode |
getEnclosingMethod() |
FieldNode |
getField(String name)
Finds a field matching the given name in this class or a parent class.
|
Map<String,FieldNode> |
getFieldIndex() |
List<FieldNode> |
getFields() |
GenericsType[] |
getGenericsTypes() |
MethodNode |
getGetterMethod(String getterName) |
MethodNode |
getGetterMethod(String getterName,
boolean searchSuperClasses) |
Iterator<InnerClassNode> |
getInnerClasses() |
ClassNode[] |
getInterfaces() |
MethodNode |
getMethod(String name,
Parameter[] parameters)
Finds a method matching the given name and parameters in this class
or any parent class.
|
List<MethodNode> |
getMethods() |
List<MethodNode> |
getMethods(String name)
This methods creates a list of all methods with this name of the
current class and of all super classes
|
MixinNode[] |
getMixins() |
int |
getModifiers() |
ModuleNode |
getModule() |
String |
getName() |
String |
getNameWithoutPackage() |
List<Statement> |
getObjectInitializerStatements() |
ClassNode |
getOuterClass() |
List<ClassNode> |
getOuterClasses() |
FieldNode |
getOuterField(String name) |
PackageNode |
getPackage() |
String |
getPackageName() |
ClassNode |
getPlainNodeReference() |
List<PropertyNode> |
getProperties() |
PropertyNode |
getProperty(String name) |
MethodNode |
getSetterMethod(String setterName) |
MethodNode |
getSetterMethod(String setterName,
boolean voidOnly) |
ClassNode |
getSuperClass() |
String |
getText() |
Map<Class<? extends ASTTransformation>,Set<ASTNode>> |
getTransforms(CompilePhase phase) |
Class |
getTypeClass()
Returns the concrete class this classnode relates to.
|
ClassNode[] |
getUnresolvedInterfaces() |
ClassNode[] |
getUnresolvedInterfaces(boolean useRedirect) |
String |
getUnresolvedName() |
ClassNode |
getUnresolvedSuperClass() |
ClassNode |
getUnresolvedSuperClass(boolean useRedirect) |
boolean |
hasDeclaredMethod(String name,
Parameter[] parameters) |
int |
hashCode() |
boolean |
hasMethod(String name,
Parameter[] parameters) |
boolean |
hasPackageName() |
boolean |
hasPossibleMethod(String name,
Expression arguments)
Returns true if the given method has a possibly matching instance method with the given name and arguments.
|
boolean |
hasPossibleStaticMethod(String name,
Expression arguments)
Checks if the given method has a possibly matching static method with the
given name and arguments.
|
boolean |
hasProperty(String name) |
boolean |
implementsAnyInterfaces(ClassNode... classNodes) |
boolean |
implementsInterface(ClassNode classNode) |
boolean |
isAbstract() |
boolean |
isAnnotated() |
boolean |
isAnnotationDefinition() |
boolean |
isArray() |
boolean |
isDerivedFrom(ClassNode type) |
boolean |
isDerivedFromGroovyObject() |
boolean |
isEnum() |
boolean |
isGenericsPlaceHolder() |
boolean |
isInterface() |
boolean |
isPrimaryClassNode() |
boolean |
isRedirectNode() |
boolean |
isResolved() |
boolean |
isScript() |
boolean |
isScriptBody() |
boolean |
isStaticClass()
Is this class declared in a static method (such as a closure / inner class declared in a static method)
|
boolean |
isSyntheticPublic()
Indicates that this class has been "promoted" to public by Groovy when in
fact there was no public modifier explicitly in the source code.
|
boolean |
isUsingGenerics() |
ClassNode |
makeArray()
Returns a
ClassNode representing an array of the type represented
by this. |
protected boolean |
parametersEqual(Parameter[] a,
Parameter[] b) |
void |
positionStmtsAfterEnumInitStmts(List<Statement> staticFieldStatements) |
ClassNode |
redirect()
Returns the
ClassNode this node is a proxy for or the node itself. |
void |
removeConstructor(ConstructorNode node) |
void |
removeField(String oldName) |
void |
removeMethod(MethodNode node) |
void |
renameField(String oldName,
String newName) |
void |
setAnnotated(boolean annotated)
Marks if the current class uses annotations or not.
|
protected void |
setCompileUnit(CompileUnit cu) |
void |
setEnclosingMethod(MethodNode enclosingMethod) |
void |
setGenericsPlaceHolder(boolean placeholder) |
void |
setGenericsTypes(GenericsType[] genericsTypes) |
void |
setInterfaces(ClassNode[] interfaces) |
void |
setMixins(MixinNode[] mixins) |
void |
setModifiers(int modifiers) |
void |
setModule(ModuleNode module) |
String |
setName(String name) |
void |
setRedirect(ClassNode node)
Sets this instance as proxy for the given
ClassNode . |
void |
setScript(boolean script) |
void |
setScriptBody(boolean scriptBody) |
void |
setStaticClass(boolean staticClass) |
void |
setSuperClass(ClassNode superClass)
Sets the superclass of this
ClassNode . |
void |
setSyntheticPublic(boolean syntheticPublic) |
void |
setUnresolvedSuperClass(ClassNode superClass) |
void |
setUsingGenerics(boolean usesGenerics) |
String |
toString() |
String |
toString(boolean showRedirect) |
MethodNode |
tryFindPossibleMethod(String name,
Expression arguments) |
void |
visitContents(GroovyClassVisitor visitor) |
addAnnotation, addAnnotations, getDeclaringClass, getGroovydoc, getInstance, hasNoRealSourcePosition, isSynthetic, setDeclaringClass, setHasNoRealSourcePosition, setSynthetic
copyNodeMetaData, getColumnNumber, getLastColumnNumber, getLastLineNumber, getLineNumber, getMetaDataMap, setColumnNumber, setLastColumnNumber, setLastLineNumber, setLineNumber, setMetaDataMap, setSourcePosition, visit
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
copyNodeMetaData, getNodeMetaData, getNodeMetaData, getNodeMetaData, putNodeMetaData, removeNodeMetaData, setNodeMetaData
public static final ClassNode[] EMPTY_ARRAY
public static final ClassNode THIS
public static final ClassNode SUPER
protected boolean isPrimaryNode
protected List<InnerClassNode> innerClasses
protected final Object lazyInitLock
protected Class clazz
public ClassNode(Class<?> c)
ClassNode
from a real class.public ClassNode(String name, int modifiers, ClassNode superClass)
name
- the fully-qualified name of the classmodifiers
- the modifiers; see Opcodes
superClass
- the base class; use "java.lang.Object" if no direct base classpublic ClassNode(String name, int modifiers, ClassNode superClass, ClassNode[] interfaces, MixinNode[] mixins)
name
- the fully-qualified name of the classmodifiers
- the modifiers; see Opcodes
superClass
- the base class; use "java.lang.Object" if no direct base classinterfaces
- the interfaces for this classmixins
- the mixins for this classpublic ClassNode redirect()
ClassNode
this node is a proxy for or the node itself.public boolean isRedirectNode()
public void setRedirect(ClassNode node)
ClassNode
.node
- the class to redirect to; if null
the redirect is removedpublic ClassNode makeArray()
ClassNode
representing an array of the type represented
by this.public boolean isPrimaryClassNode()
true
if this instance is a primary ClassNode
public MethodNode getEnclosingMethod()
public void setEnclosingMethod(MethodNode enclosingMethod)
public boolean isSyntheticPublic()
true
if node is public but had no explicit public modifierpublic void setSyntheticPublic(boolean syntheticPublic)
public void setSuperClass(ClassNode superClass)
ClassNode
.public ClassNode[] getInterfaces()
ClassNode
public void setInterfaces(ClassNode[] interfaces)
public MixinNode[] getMixins()
ClassNode
public void setMixins(MixinNode[] mixins)
public List<MethodNode> getMethods()
ClassNode
public List<MethodNode> getAbstractMethods()
ClassNode
public List<MethodNode> getAllDeclaredMethods()
public Map<String,MethodNode> getDeclaredMethodsMap()
public String getName()
public String getUnresolvedName()
public int getModifiers()
public void setModifiers(int modifiers)
public List<PropertyNode> getProperties()
public List<ConstructorNode> getDeclaredConstructors()
public ConstructorNode getDeclaredConstructor(Parameter[] parameters)
null
public void removeConstructor(ConstructorNode node)
public ModuleNode getModule()
public PackageNode getPackage()
public void setModule(ModuleNode module)
public void addField(FieldNode node)
public void addFieldFirst(FieldNode node)
public void addProperty(PropertyNode node)
public PropertyNode addProperty(String name, int modifiers, ClassNode type, Expression initialValueExpression, Statement getterBlock, Statement setterBlock)
public boolean hasProperty(String name)
public PropertyNode getProperty(String name)
public void addConstructor(ConstructorNode node)
public ConstructorNode addConstructor(int modifiers, Parameter[] parameters, ClassNode[] exceptions, Statement code)
public void addMethod(MethodNode node)
public void removeMethod(MethodNode node)
public MethodNode addMethod(String name, int modifiers, ClassNode returnType, Parameter[] parameters, ClassNode[] exceptions, Statement code)
public boolean hasDeclaredMethod(String name, Parameter[] parameters)
getDeclaredMethod(String, Parameter[])
public boolean hasMethod(String name, Parameter[] parameters)
getMethod(String, Parameter[])
public MethodNode addSyntheticMethod(String name, int modifiers, ClassNode returnType, Parameter[] parameters, ClassNode[] exceptions, Statement code)
public FieldNode addField(String name, int modifiers, ClassNode type, Expression initialValue)
public FieldNode addFieldFirst(String name, int modifiers, ClassNode type, Expression initialValue)
public void addInterface(ClassNode type)
public void addMixin(MixinNode mixin)
public FieldNode getDeclaredField(String name)
name
- the name of the field of interestpublic FieldNode getField(String name)
name
- the name of the field of interestpublic FieldNode getOuterField(String name)
null
if this is not an inner classpublic ClassNode getOuterClass()
public void addObjectInitializerStatements(Statement statements)
statements
- the statement to be addedpublic void addStaticInitializerStatements(List<Statement> staticStatements, boolean fieldInit)
public void positionStmtsAfterEnumInitStmts(List<Statement> staticFieldStatements)
public List<MethodNode> getDeclaredMethods(String name)
getMethods(String)
public List<MethodNode> getMethods(String name)
getDeclaredMethods(String)
public MethodNode getDeclaredMethod(String name, Parameter[] parameters)
public MethodNode getMethod(String name, Parameter[] parameters)
public boolean isDerivedFrom(ClassNode type)
type
- the ClassNode of interestpublic boolean isDerivedFromGroovyObject()
true
if this type implements GroovyObject
public boolean implementsAnyInterfaces(ClassNode... classNodes)
classNodes
- the class nodes for the interfacestrue
if this type implements any of the given interfacespublic boolean implementsInterface(ClassNode classNode)
classNode
- the class node for the interfacetrue
if this type implements the given interfacepublic boolean declaresAnyInterfaces(ClassNode... classNodes)
classNodes
- the class nodes for the interfacestrue
if this type declares that it implements any of the
given interfaces or if one of its interfaces extends directly/indirectly
any of the given interfacespublic boolean declaresInterface(ClassNode classNode)
classNode
- the class node for the interfacetrue
if this class declares that it implements the given
interface or if one of its interfaces extends directly/indirectly the interface
NOTE: Doesn't consider an interface to implement itself.
I think this is intended to be called on ClassNodes representing
classes, not interfaces.public ClassNode getSuperClass()
ClassNode
of the super class of this typepublic ClassNode getUnresolvedSuperClass()
public ClassNode getUnresolvedSuperClass(boolean useRedirect)
public void setUnresolvedSuperClass(ClassNode superClass)
public ClassNode[] getUnresolvedInterfaces()
public ClassNode[] getUnresolvedInterfaces(boolean useRedirect)
public CompileUnit getCompileUnit()
protected void setCompileUnit(CompileUnit cu)
protected boolean parametersEqual(Parameter[] a, Parameter[] b)
true
if the two arrays are of the same size and have the same contentspublic String getPackageName()
public String getNameWithoutPackage()
public void visitContents(GroovyClassVisitor visitor)
public MethodNode getGetterMethod(String getterName)
public MethodNode getGetterMethod(String getterName, boolean searchSuperClasses)
public MethodNode getSetterMethod(String setterName)
public MethodNode getSetterMethod(String setterName, boolean voidOnly)
public boolean isStaticClass()
public void setStaticClass(boolean staticClass)
public boolean isScriptBody()
true
if this inner class or closure was declared inside a script bodypublic void setScriptBody(boolean scriptBody)
public boolean isScript()
public void setScript(boolean script)
public String toString(boolean showRedirect)
public boolean hasPossibleMethod(String name, Expression arguments)
name
- the name of the method of interestarguments
- the arguments to match againstpublic MethodNode tryFindPossibleMethod(String name, Expression arguments)
public boolean hasPossibleStaticMethod(String name, Expression arguments)
name
- the name of the method of interestarguments
- the arguments to match againsttrue
if a matching method was foundpublic boolean isInterface()
public boolean isAbstract()
public boolean isResolved()
public boolean isArray()
public ClassNode getComponentType()
public Class getTypeClass()
getPlainNodeReference()
.public boolean hasPackageName()
public void setAnnotated(boolean annotated)
public boolean isAnnotated()
public GenericsType asGenericsType()
public GenericsType[] getGenericsTypes()
public void setGenericsTypes(GenericsType[] genericsTypes)
public void setGenericsPlaceHolder(boolean placeholder)
public boolean isGenericsPlaceHolder()
public boolean isUsingGenerics()
public void setUsingGenerics(boolean usesGenerics)
public ClassNode getPlainNodeReference()
public boolean isAnnotationDefinition()
public List<AnnotationNode> getAnnotations()
getAnnotations
in class AnnotatedNode
public List<AnnotationNode> getAnnotations(ClassNode type)
getAnnotations
in class AnnotatedNode
public void addTransform(Class<? extends ASTTransformation> transform, ASTNode node)
public Map<Class<? extends ASTTransformation>,Set<ASTNode>> getTransforms(CompilePhase phase)
public void removeField(String oldName)
public boolean isEnum()
public Iterator<InnerClassNode> getInnerClasses()