gnu.bytecode
Class ClassType

java.lang.Object
  |
  +--gnu.bytecode.Type
        |
        +--gnu.bytecode.ObjectType
              |
              +--gnu.bytecode.ClassType

public class ClassType

extends ObjectType

implements AttrContainer

Field Summary

int	access_flags
Method	constructor
static int	major_version
static int	minor_version

Fields inherited from class gnu.bytecode.Type

boolean_ctype, boolean_type, booleanValue_method, byte_type, char_type, double_type, doubleValue_method, float_type, floatValue_method, int_type, intValue_method, long_type, longValue_method, number_type, pointer_type, reflectClass, short_type, string_type, throwable_type, toString_method, typeArray0, void_type

Constructor Summary

ClassType()

ClassType(java.lang.String class_name)

Method Summary

Field	addField() Add a new field to this class.
Field	addField(java.lang.String name) Add a new field to this class, and name the field.
Field	addField(java.lang.String name, Type type)
Field	addField(java.lang.String name, Type type, int flags)
void	addFields() Use reflection to add all the declared fields of this class.
void	addInterface(ClassType newInterface) Add an interface to the list of implemented interfaces.
Method	addMethod(java.lang.String name)
Method	addMethod(java.lang.String name, int flags)
Method	addMethod(java.lang.String name, int flags, Type[] arg_types, Type return_type) Add a method to this ClassType.
Method	addMethod(java.lang.String name, java.lang.String signature, int flags)
Method	addMethod(java.lang.String name, Type[] arg_types, Type return_type, int flags)
void	addMethods(java.lang.Class clas) Use reflection to add all the declared methods of this class.
int	compare(Type other) Return a numeric code showing "subtype" relationship: 1: if other is a pure subtype of this; 0: if has the same members; -1: if this is a pure subtype of other; -2: if both a member in common but neither is a subtype of the other; -3: if the types have no values in common.
void	doFixups() Do various fixups after generating code but before we can write it out.
Attribute	getAttributes() Get the (first) Attribute of this container.
CpoolEntry	getConstant(int i)
ConstantPool	getConstants()
Field	getDeclaredField(java.lang.String name) Find a field with the given name declared in this class.
Method	getDeclaredMethod(java.lang.String name, int argCount) Get a method with matching name and number of arguments.
Method	getDeclaredMethod(java.lang.String name, Type[] arg_types)
Field	getField(java.lang.String name) Find a field with the given name declared in this class or its ancestors.
int	getFieldCount()
Field	getFields() Get the fields of this class.
ClassType[]	getInterfaces()
Method[]	getMatchingMethods(java.lang.String name, Type[] paramTypes, int flags)
Method	getMethod(java.lang.String name, Type[] arg_types)
int	getMethodCount()
Method	getMethods() Get the methods of this class.
int	getModifiers() Return the modifiers (access flags) for this class.
java.lang.String	getNameOrSignature()
ClassType	getSuperclass()
boolean	isInterface()
boolean	isSubclass(ClassType other)
static ClassType	make(java.lang.String name) Find a ClassType with the given name, or create a new one.
static ClassType	make(java.lang.String name, ClassType superClass)
void	setAttributes(Attribute attributes) Set the (list of) Attributes of this container.
void	setInterfaces(ClassType[] interfaces)
void	setModifiers(int flags) Set the modifiers (access flags) for this class.
void	setName(java.lang.String name) Sets the name of the class being defined in this classfile.
void	setSourceFile(java.lang.String name) Set the name of the SourceFile associated with this class.
void	setSuper(ClassType superClass)
void	setSuper(java.lang.String name) Set the superclass of the is class.
static byte[]	to_utf8(java.lang.String str) Convert a String to a Utf8 byte array.
java.lang.String	toString()
byte[]	writeToArray()
void	writeToFile()
void	writeToFile(java.lang.String filename)
void	writeToStream(java.io.OutputStream stream)

Methods inherited from class gnu.bytecode.ObjectType

coerceFromObject, emitCoerceFromObject, getReflectClass

Methods inherited from class gnu.bytecode.Type

coerceToObject, emitCoerceToObject, emitIsInstance, getName, getSignature, getSize, getType, isInstance, isMoreSpecific, isSubtype, isValidJavaTypeName, isVoid, lookupType, lowestCommonSuperType, make, promote, registerTypeForClass, setSignature, signatureLength, signatureLength, signatureToName, signatureToPrimitive, signatureToType, signatureToType, swappedCompareResult

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

minor_version

public static final int minor_version

major_version

public static final int major_version

access_flags

public int access_flags

constructor

public Method constructor

Constructor Detail

ClassType

public ClassType()

ClassType

public ClassType(java.lang.String class_name)

Method Detail

make

public static ClassType make(java.lang.String name)

Find a ClassType with the given name, or create a new one. Use this for "library classes", where you need the field/method types, but not one where you are about to generate code for.

Parameters:

name - the name of the class (e..g. "java.lang.String").

make

public static ClassType make(java.lang.String name,
                             ClassType superClass)

getAttributes

public final Attribute getAttributes()

Description copied from interface: AttrContainer

Get the (first) Attribute of this container.

Specified by:

getAttributes in interface AttrContainer

setAttributes

public final void setAttributes(Attribute attributes)

Description copied from interface: AttrContainer

Set the (list of) Attributes of this container.

Specified by:

setAttributes in interface AttrContainer

getConstants

public final ConstantPool getConstants()

getConstant

public final CpoolEntry getConstant(int i)

getModifiers

public final int getModifiers()

Return the modifiers (access flags) for this class.

setModifiers

public final void setModifiers(int flags)

Set the modifiers (access flags) for this class.

setName

public void setName(java.lang.String name)

Sets the name of the class being defined in this classfile.

Parameters:

name - the name to give to the class

setSourceFile

public void setSourceFile(java.lang.String name)

Set the name of the SourceFile associated with this class.

setSuper

public void setSuper(java.lang.String name)

Set the superclass of the is class.

Parameters:

name - name of super class, or null if this is "Object".

setSuper

public void setSuper(ClassType superClass)

getSuperclass

public ClassType getSuperclass()

getInterfaces

public ClassType[] getInterfaces()

Returns:

the interfaces this class is declared to implement (not those inherited from its superclass/superinterfaces).

getNameOrSignature

public java.lang.String getNameOrSignature()

Overrides:

getNameOrSignature in class ObjectType

setInterfaces

public void setInterfaces(ClassType[] interfaces)

addInterface

public void addInterface(ClassType newInterface)

Add an interface to the list of implemented interfaces.

isInterface

public final boolean isInterface()

getFields

public final Field getFields()

Get the fields of this class.

getFieldCount

public final int getFieldCount()

getDeclaredField

public Field getDeclaredField(java.lang.String name)

Find a field with the given name declared in this class.

Returns:

the matching field, or null if there is no such field.

getField

public Field getField(java.lang.String name)

Find a field with the given name declared in this class or its ancestors.

Returns:

the matching field, or null if there is no such field.

addField

public Field addField()

Add a new field to this class.

addField

public Field addField(java.lang.String name)

Add a new field to this class, and name the field.

Parameters:

name - the name of the new field

addField

public final Field addField(java.lang.String name,
                            Type type)

addField

public final Field addField(java.lang.String name,
                            Type type,
                            int flags)

addFields

public void addFields()

Use reflection to add all the declared fields of this class. Does not add private or package-private fields. Does not check for duplicate (already-known) fields.

getMethods

public final Method getMethods()

Get the methods of this class.

getMethodCount

public final int getMethodCount()

addMethod

public Method addMethod(java.lang.String name)

addMethod

public Method addMethod(java.lang.String name,
                        int flags)

addMethod

public Method addMethod(java.lang.String name,
                        Type[] arg_types,
                        Type return_type,
                        int flags)

addMethod

public Method addMethod(java.lang.String name,
                        int flags,
                        Type[] arg_types,
                        Type return_type)

Add a method to this ClassType. If an existing method matches, return that. Otherwise, create a new one. In contrast, the other addMethod methods always create new Methods.

addMethod

public Method addMethod(java.lang.String name,
                        java.lang.String signature,
                        int flags)

getDeclaredMethod

public Method getDeclaredMethod(java.lang.String name,
                                Type[] arg_types)

getDeclaredMethod

public Method getDeclaredMethod(java.lang.String name,
                                int argCount)

Get a method with matching name and number of arguments.

getMethod

public Method getMethod(java.lang.String name,
                        Type[] arg_types)

addMethods

public void addMethods(java.lang.Class clas)

Use reflection to add all the declared methods of this class. Does not add constructors nor private or package-private methods. Does not check for duplicate (already-known) methods.

Parameters:

clas - should be the same as getReflectClass().

getMatchingMethods

public Method[] getMatchingMethods(java.lang.String name,
                                   Type[] paramTypes,
                                   int flags)

doFixups

public void doFixups()

Do various fixups after generating code but before we can write it out. This includes assigning constant pool indexes where needed, finalizing labels, etc.

writeToStream

public void writeToStream(java.io.OutputStream stream)
                   throws java.io.IOException

writeToFile

public void writeToFile(java.lang.String filename)
                 throws java.io.IOException

writeToFile

public void writeToFile()
                 throws java.io.IOException

writeToArray

public byte[] writeToArray()
                    throws java.io.IOException

to_utf8

public static byte[] to_utf8(java.lang.String str)

Convert a String to a Utf8 byte array.

Parameters:

str - the input String.

Returns:

the input encoded as a utf8 byte array.

isSubclass

public final boolean isSubclass(ClassType other)

compare

public int compare(Type other)

Description copied from class: Type

Return a numeric code showing "subtype" relationship: 1: if other is a pure subtype of this; 0: if has the same members; -1: if this is a pure subtype of other; -2: if both a member in common but neither is a subtype of the other; -3: if the types have no values in common. "Same member" is rather loose; by "A is a subtype of B" we mean that all instance of A can be "widened" to B. More formally, A.compare(B) returns: 1: all B values can be converted to A without a coercion failure (i.e. a ClassCastException), but not vice versa. 0: all A values can be converted to B without a coercion failure and vice versa; -1: all A values can be converted to B without a coercion failure not not vice versa; -2: there are (potentially) some A values that can be converted to B, and some B values can be converted to A; -3: there are no A values that can be converted to B, and neither are there any B values that can be converted to A.

Overrides:

compare in class Type

toString

public java.lang.String toString()

Overrides:

toString in class Type