Class ClassHolder
java.lang.Object
org.apache.derby.iapi.services.classfile.ClassHolder
- Direct Known Subclasses:
ClassInvestigator
Based upon "THE class FILE FORMAT" chapter of "The Java Virtual Machine Specification"
corresponding to version 1.0.2 of the Java Virtual Machine and 1.0.2 of the
Java Language Specification.
ISBN 0-201-63452-X, September 1996.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected int
protected Attributes
protected Vector
<ConstantPoolEntry> private int
protected Hashtable
<Object, ConstantPoolEntry> protected MemberTable
protected int[]
protected int
Minor class format number defaults to VMDescriptor.JAVA_CLASS_FORMAT_MAJOR_VERSIONprotected MemberTable
protected int
Minor class format number defaults to VMDescriptor.JAVA_CLASS_FORMAT_MINOR_VERSION which currently corresponds to a really old (JDK 1.0.2) setting.private final CONSTANT_Index_info
Used to search for index entries to avoid object allocation in the case a referecne already exists.protected int
protected int
-
Constructor Summary
ConstructorsModifierConstructorDescriptionprotected
ClassHolder
(int estimatedConstantPoolCount) ClassHolder
(String fullyQualifiedName, String superClassName, int modifiers) This will not define a constructor -- it is up to the caller to add at least one. -
Method Summary
Modifier and TypeMethodDescriptionvoid
addAttribute
(String attributeName, ClassFormatOutput info) int
addClassReference
(String fullyQualifiedName) Add a class entry to the pool.int
addConstant
(double value) int
addConstant
(float value) int
addConstant
(int value) int
addConstant
(long value) int
addConstant
(String value) private int
Add an entry, but only if it doesn't exist.protected int
addEntry
(Object key, ConstantPoolEntry item) Generic add entry to constant pool.private CONSTANT_Utf8_info
addExtraUtf8
(String value) Add an extra UTF8 into the poolint
addFieldReference
(String className, String simpleName, String descriptor) int
addFieldReference
(ClassMember field) private int
addIndexReference
(int tag, int i1, int i2) Add an index reference.int
addMethodReference
(String className, String simpleName, String descriptor, boolean isInterface) private int
addNameAndType
(String name, String descriptor) Add a name and type entryprivate int
addReference
(int tag, String className, String simpleName, String descriptor) private int
addReference
(int tag, ClassMember member) private int
Add a string entryint
private CONSTANT_Utf8_info
addUtf8Entry
(String value) Add a UTF8 into the pool and return the index to it.protected String
className
(int classIndex) Return the class name for an index to a CONSTANT_Class_info.private static String
convertToInternal
(String externalName, boolean descriptor) static String
convertToInternalClassName
(String externalName) static String
convertToInternalDescriptor
(String externalName) protected void
cptPut
(ClassFormatOutput out) int
Find a class descriptor (section 4.4.1) and return its index, returns -1 if not found.protected CONSTANT_Index_info
findIndexEntry
(int tag, int i1, int i2) protected int
findIndexIndex
(int tag, int i1, int i2) protected ConstantPoolEntry
findMatchingEntry
(Object key) int
findNameAndType
(String name, String descriptor) Find a name and type descriptor (section 4.4.6) and return it's index.(package private) int
Return the index of a UTF entry or -1 if it doesn't exist.protected String
getClassName
(int index) get the class name of a Class given the index of its CONSTANT_Class_info entry in the Constant Pool.int
getEntry
(int index) Convert the object representation of the class into its class file format.int
getName()
static boolean
isExternalClassName
(String className) private static String
makeDesc
(char builtin, int arity) A helper to build a type description based on a built-in type and an array arity.private static String
A helper to build a type description based on a Java class and an array arity.(package private) String
nameIndexToString
(int index) get a string (UTF) given a name_index into the constant poolprivate void
put
(ClassFormatOutput out)
-
Field Details
-
minor_version
protected int minor_versionMinor class format number defaults to VMDescriptor.JAVA_CLASS_FORMAT_MINOR_VERSION which currently corresponds to a really old (JDK 1.0.2) setting. The default major and minor value is used by the generated code for Derby's SQL statements. Currently there is no need to bump the version number as the generated code does not take advantage of any of the new elements in the class file format. If such a need exists then this can be bumped. One issue is that the change in format numbers is not well documented. -
major_version
protected int major_versionMinor class format number defaults to VMDescriptor.JAVA_CLASS_FORMAT_MAJOR_VERSION -
access_flags
protected int access_flags -
this_class
protected int this_class -
super_class
protected int super_class -
interfaces
protected int[] interfaces -
field_info
-
method_info
-
attribute_info
-
cptHashTable
-
cptEntries
-
cptEstimatedSize
private int cptEstimatedSize -
searchIndex
Used to search for index entries to avoid object allocation in the case a referecne already exists.
-
-
Constructor Details
-
ClassHolder
protected ClassHolder(int estimatedConstantPoolCount) -
ClassHolder
This will not define a constructor -- it is up to the caller to add at least one.
-
-
Method Details
-
put
- Throws:
IOException
-
getFileFormat
Convert the object representation of the class into its class file format.- Throws:
IOException
- error writing the class
-
getModifier
public int getModifier()- See Also:
-
getName
- See Also:
-
addMember
- See Also:
-
addFieldReference
- See Also:
-
addFieldReference
-
addMethodReference
public int addMethodReference(String className, String simpleName, String descriptor, boolean isInterface) - See Also:
-
addReference
-
addReference
-
addConstant
- See Also:
-
addUtf8
- See Also:
-
addConstant
public int addConstant(int value) - See Also:
-
addConstant
public int addConstant(float value) - See Also:
-
addConstant
public int addConstant(long value) - See Also:
-
addConstant
public int addConstant(double value) - See Also:
-
getConstantPoolIndex
public int getConstantPoolIndex()- See Also:
-
addAttribute
-
getSuperClassName
-
addEntry
Generic add entry to constant pool. Includes the logic for an entry to occupy more than one slot (e.g. long).- Returns:
- The number of slots occupied by the entry. .
-
addDirectEntry
Add an entry, but only if it doesn't exist.- Returns:
- the constant pool index of the added or existing item.
-
addIndexReference
private int addIndexReference(int tag, int i1, int i2) Add an index reference. -
addClassReference
Add a class entry to the pool. -
addNameAndType
Add a name and type entry -
addUtf8Entry
Add a UTF8 into the pool and return the index to it. -
addExtraUtf8
Add an extra UTF8 into the pool -
addString
Add a string entry -
cptPut
- Throws:
IOException
-
getEntry
-
className
Return the class name for an index to a CONSTANT_Class_info. -
findUtf8
Return the index of a UTF entry or -1 if it doesn't exist. -
findClass
Find a class descriptor (section 4.4.1) and return its index, returns -1 if not found. -
findNameAndType
Find a name and type descriptor (section 4.4.6) and return it's index.returns -1 if not found.
-
findIndexEntry
-
findIndexIndex
protected int findIndexIndex(int tag, int i1, int i2) -
findMatchingEntry
-
nameIndexToString
get a string (UTF) given a name_index into the constant pool -
getClassName
get the class name of a Class given the index of its CONSTANT_Class_info entry in the Constant Pool. -
isExternalClassName
-
convertToInternalClassName
-
convertToInternalDescriptor
-
convertToInternal
-
makeDesc
A helper to build a type description based on a built-in type and an array arity. -
makeDesc
A helper to build a type description based on a Java class and an array arity. If descriptor is true create a descriptor according to section 4.3.2 of the vm spec. If false create a class name according to sections 4.3.2 and 4.4.1 of the vm spec.
-