Package com.aparapi.internal.model

Class ClassModel

java.lang.Object

com.aparapi.internal.model.ClassModel

public class ClassModel
extends Object

Class represents a ClassFile (MyClass.class). A ClassModel is constructed from an instance of a java.lang.Class. If the java class mode changes we may need to modify this to accommodate.

See Also:

• Java 5 Class File Format + * @see Java 7 Class File Format

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ClassModel.Access
class	ClassModel.AttributePool
class	ClassModel.ClassModelField
class	ClassModel.ClassModelInterface
class	ClassModel.ClassModelMethod
class	ClassModel.ConstantPool
static enum	ClassModel.ConstantPoolType
static interface	ClassModel.LocalVariableInfo
static interface	ClassModel.LocalVariableTableEntry<T extends ClassModel.LocalVariableInfo>
static class	ClassModel.MethodDescription
private static enum	ClassModel.SignatureParseState

Field Summary

Fields

Modifier and Type	Field	Description
private int	accessFlags
private ClassModel.AttributePool	attributePool
private static final ValueCache<Class<?>,ClassModel,ClassParseException>	classModelCache
private static ClassLoader	classModelLoader
private Class<?>	clazz
private ClassModel.ConstantPool	constantPool
private final ValueCache<EntrypointKey,Entrypoint,AparapiException>	entrypointCache
private final List<ClassModel.ClassModelField>	fields
private final List<ClassModel.ClassModelInterface>	interfaces
private static Logger	logger
private int	magic
private int	majorVersion
private ValueCache<MethodKey,MethodModel,AparapiException>	methodModelCache
private final List<ClassModel.ClassModelMethod>	methods
private int	minorVersion
private Memoizer<Set<String>>	noClMethods
private Memoizer<Map<String,Kernel.PrivateMemorySpace>>	privateMemoryFields
private ValueCache<String,Integer,ClassParseException>	privateMemorySizes
static final char	SIGC_ARRAY
static final char	SIGC_BOOLEAN
static final char	SIGC_BYTE
static final char	SIGC_CHAR
static final char	SIGC_CLASS
static final char	SIGC_DOUBLE
static final char	SIGC_END_CLASS
static final char	SIGC_END_METHOD
static final char	SIGC_FLOAT
static final char	SIGC_INT
static final char	SIGC_LONG
static final char	SIGC_PACKAGE
static final char	SIGC_SHORT
static final char	SIGC_START_METHOD
static final char	SIGC_VOID
private final ArrayList<Long>	structMemberOffsets
private final ArrayList<ClassModel.ConstantPool.FieldEntry>	structMembers
private final ArrayList<InstructionSet.TypeSpec>	structMemberTypes
private int	superClassConstantPoolIndex
private ClassModel	superClazz
private int	thisClassConstantPoolIndex
private int	totalStructSize

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ClassModel(Class<?> _class)	Create a ClassModel representing a given Class.
(package private)	ClassModel(Class<?> _clazz, byte[] _bytes)

Method Summary

Modifier and Type	Method	Description
(package private) Entrypoint	computeBasicEntrypoint(EntrypointKey entrypointKey)
private MethodModel	computeMethodModel(MethodKey methodKey)
private Set<String>	computeNoCLMethods()
private Map<String,Kernel.PrivateMemorySpace>	computePrivateMemoryFields()
private Integer	computePrivateMemorySize(String fieldName)
static String	convert(String _string)
static String	convert(String _string, String _insert)
static String	convert(String _string, String _insert, boolean _showFullClassName)
static ClassModel	createClassModel(Class<?> _class)
private static ClassModel	createClassModelInternal(Class<?> key)
int	getAccessFlags()
ClassModel.AttributePool	getAttributePool()
Class<?>	getClassWeAreModelling()
ClassModel.ConstantPool	getConstantPool()
Entrypoint	getEntrypoint()
Entrypoint	getEntrypoint(String _entrypointName, Object _k)
(package private) Entrypoint	getEntrypoint(String _entrypointName, String _descriptor, Object _k)
ClassModel.ClassModelField	getField(String _name)
ClassModel.ClassModelField	getField(String _name, String _descriptor)
List<ClassModel.ClassModelField>	getFieldPoolEntries()
int	getMagic()
int	getMajorVersion()
ClassModel.ClassModelMethod	getMethod(ClassModel.ConstantPool.MethodEntry _methodEntry, boolean _isSpecial)	Look up a ConstantPool MethodEntry and return the corresponding Method.
ClassModel.ClassModelMethod	getMethod(String _name, String _descriptor)
static ClassModel.MethodDescription	getMethodDescription(String _string)
MethodModel	getMethodModel(String _name, String _signature)	Create a MethodModel for a given method name and signature.
private ClassModel.ClassModelMethod	getMethodOrNull(String _name, String _descriptor)
int	getMinorVersion()
Set<String>	getNoCLMethods()
Integer	getPrivateMemorySize(String fieldName)	If a field does not satisfy the private memory conditions, null, otherwise the size of private memory required.
static Integer	getPrivateMemorySizeFromField(Field field)
static Integer	getPrivateMemorySizeFromFieldName(String fieldName)
ArrayList<Long>	getStructMemberOffsets()
ArrayList<ClassModel.ConstantPool.FieldEntry>	getStructMembers()
ArrayList<InstructionSet.TypeSpec>	getStructMemberTypes()
int	getSuperClassConstantPoolIndex()
ClassModel	getSuperClazz()	Getter for superClazz
int	getThisClassConstantPoolIndex()
int	getTotalStructSize()
static void	invalidateCaches()
boolean	isSuperClass(Class<?> other)	Determine if this is the superclass of some other class.
boolean	isSuperClass(String otherClassName)	Determine if this is the superclass of some other named class.
(package private) void	parse(Class<?> _class)
void	replaceSuperClazz(ClassModel c)
void	setTotalStructSize(int x)
String	toString()
static String	typeName(char _typeChar)	Convert a given JNI character type (say 'I') to its type name ('int').

Methods inherited from class java.lang.Object

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

Field Details

SIGC_VOID

public static final char SIGC_VOID

See Also:

• Constant Field Values

SIGC_BOOLEAN

public static final char SIGC_BOOLEAN

See Also:

• Constant Field Values

SIGC_BYTE

public static final char SIGC_BYTE

See Also:

• Constant Field Values

SIGC_CHAR

public static final char SIGC_CHAR

See Also:

• Constant Field Values

SIGC_SHORT

public static final char SIGC_SHORT

See Also:

• Constant Field Values

SIGC_INT

public static final char SIGC_INT

See Also:

• Constant Field Values

SIGC_LONG

public static final char SIGC_LONG

See Also:

• Constant Field Values

SIGC_FLOAT

public static final char SIGC_FLOAT

See Also:

• Constant Field Values

SIGC_DOUBLE

public static final char SIGC_DOUBLE

See Also:

• Constant Field Values

SIGC_ARRAY

public static final char SIGC_ARRAY

See Also:

• Constant Field Values

SIGC_CLASS

public static final char SIGC_CLASS

See Also:

• Constant Field Values

SIGC_START_METHOD

public static final char SIGC_START_METHOD

See Also:

• Constant Field Values

SIGC_END_CLASS

public static final char SIGC_END_CLASS

See Also:

• Constant Field Values

SIGC_END_METHOD

public static final char SIGC_END_METHOD

See Also:

• Constant Field Values

SIGC_PACKAGE

public static final char SIGC_PACKAGE

See Also:

• Constant Field Values

logger

private static Logger logger

superClazz

private ClassModel superClazz

noClMethods

private Memoizer<Set<String>> noClMethods

privateMemoryFields

private Memoizer<Map<String,Kernel.PrivateMemorySpace>> privateMemoryFields

privateMemorySizes

private ValueCache<String,Integer,ClassParseException> privateMemorySizes

classModelCache

private static final ValueCache<Class<?>,ClassModel,ClassParseException> classModelCache

magic

private int magic

minorVersion

private int minorVersion

majorVersion

private int majorVersion

constantPool

private ClassModel.ConstantPool constantPool

accessFlags

private int accessFlags

thisClassConstantPoolIndex

private int thisClassConstantPoolIndex

superClassConstantPoolIndex

private int superClassConstantPoolIndex

interfaces

private final List<ClassModel.ClassModelInterface> interfaces

fields

private final List<ClassModel.ClassModelField> fields

methods

private final List<ClassModel.ClassModelMethod> methods

attributePool

private ClassModel.AttributePool attributePool

classModelLoader

private static ClassLoader classModelLoader

clazz

private Class<?> clazz

methodModelCache

private ValueCache<MethodKey,MethodModel,AparapiException> methodModelCache

structMembers

private final ArrayList<ClassModel.ConstantPool.FieldEntry> structMembers

structMemberOffsets

private final ArrayList<Long> structMemberOffsets

structMemberTypes

private final ArrayList<InstructionSet.TypeSpec> structMemberTypes

totalStructSize

private int totalStructSize

entrypointCache

private final ValueCache<EntrypointKey,Entrypoint,AparapiException> entrypointCache

Constructor Details

ClassModel

private ClassModel(Class<?> _class)
            throws ClassParseException

Create a ClassModel representing a given Class. The class's classfile must be available from the class's classloader via getClassLoader().getResourceAsStream(name)). For dynamic languages creating classes on the fly we may need another approach.

Parameters:

_class - The class we will extract the model from

Throws:

ClassParseException

ClassModel

ClassModel(Class<?> _clazz,
 byte[] _bytes)
    throws ClassParseException

Throws:

ClassParseException

Method Details

isSuperClass

public boolean isSuperClass(String otherClassName)

Determine if this is the superclass of some other named class.

Parameters:

otherClassName - The name of the class to compare against

Returns:

true if 'this' a superclass of another named class

isSuperClass

public boolean isSuperClass(Class<?> other)

Determine if this is the superclass of some other class.

Parameters:

other - The class to compare against

Returns:

true if 'this' a superclass of another class

getSuperClazz

public ClassModel getSuperClazz()

Getter for superClazz

Returns:

the superClazz ClassModel

replaceSuperClazz

public void replaceSuperClazz(ClassModel c)

typeName

public static String typeName(char _typeChar)

Convert a given JNI character type (say 'I') to its type name ('int').

Parameters:

_typeChar -

Returns:

either a mapped type name or null if no mapping exists.

getPrivateMemorySize

public Integer getPrivateMemorySize(String fieldName)
                             throws ClassParseException

If a field does not satisfy the private memory conditions, null, otherwise the size of private memory required.

Throws:

ClassParseException

computePrivateMemorySize

private Integer computePrivateMemorySize(String fieldName)
                                  throws ClassParseException

Throws:

ClassParseException

computePrivateMemoryFields

private Map<String,Kernel.PrivateMemorySpace> computePrivateMemoryFields()

getPrivateMemorySizeFromField

public static Integer getPrivateMemorySizeFromField(Field field)

getPrivateMemorySizeFromFieldName

public static Integer getPrivateMemorySizeFromFieldName(String fieldName)
                                                 throws ClassParseException

Throws:

ClassParseException

getNoCLMethods

public Set<String> getNoCLMethods()

computeNoCLMethods

private Set<String> computeNoCLMethods()

convert

public static String convert(String _string)

convert

public static String convert(String _string,
 String _insert)

convert

public static String convert(String _string,
 String _insert,
 boolean _showFullClassName)

getMethodDescription

public static ClassModel.MethodDescription getMethodDescription(String _string)

createClassModelInternal

private static ClassModel createClassModelInternal(Class<?> key)
                                            throws ClassParseException

Throws:

ClassParseException

createClassModel

public static ClassModel createClassModel(Class<?> _class)
                                   throws ClassParseException

Throws:

ClassParseException

parse

void parse(Class<?> _class)
    throws ClassParseException,
ClassNotFoundException

Throws:

ClassParseException

ClassNotFoundException

getMagic

public int getMagic()

getMajorVersion

public int getMajorVersion()

getMinorVersion

public int getMinorVersion()

getAccessFlags

public int getAccessFlags()

getConstantPool

public ClassModel.ConstantPool getConstantPool()

getThisClassConstantPoolIndex

public int getThisClassConstantPoolIndex()

getSuperClassConstantPoolIndex

public int getSuperClassConstantPoolIndex()

getAttributePool

public ClassModel.AttributePool getAttributePool()

getField

public ClassModel.ClassModelField getField(String _name,
 String _descriptor)

getField

public ClassModel.ClassModelField getField(String _name)

getMethod

public ClassModel.ClassModelMethod getMethod(String _name,
 String _descriptor)

getMethodOrNull

private ClassModel.ClassModelMethod getMethodOrNull(String _name,
 String _descriptor)

getFieldPoolEntries

public List<ClassModel.ClassModelField> getFieldPoolEntries()

getMethod

public ClassModel.ClassModelMethod getMethod(ClassModel.ConstantPool.MethodEntry _methodEntry,
 boolean _isSpecial)

Look up a ConstantPool MethodEntry and return the corresponding Method.

Parameters:

_methodEntry - The ConstantPool MethodEntry we want.

_isSpecial - True if we wish to delegate to super (to support super.foo())

Returns:

The Method or null if we fail to locate a given method.

getMethodModel

public MethodModel getMethodModel(String _name,
 String _signature)
                           throws AparapiException

Create a MethodModel for a given method name and signature.

Parameters:

_name -

_signature -

Returns:

Throws:

AparapiException

computeMethodModel

private MethodModel computeMethodModel(MethodKey methodKey)
                                throws AparapiException

Throws:

AparapiException

getStructMembers

public ArrayList<ClassModel.ConstantPool.FieldEntry> getStructMembers()

getStructMemberOffsets

public ArrayList<Long> getStructMemberOffsets()

getStructMemberTypes

public ArrayList<InstructionSet.TypeSpec> getStructMemberTypes()

getTotalStructSize

public int getTotalStructSize()

setTotalStructSize

public void setTotalStructSize(int x)

getEntrypoint

Entrypoint getEntrypoint(String _entrypointName,
 String _descriptor,
 Object _k)
                  throws AparapiException

Throws:

AparapiException

computeBasicEntrypoint

Entrypoint computeBasicEntrypoint(EntrypointKey entrypointKey)
                           throws AparapiException

Throws:

AparapiException

getClassWeAreModelling

public Class<?> getClassWeAreModelling()

getEntrypoint

public Entrypoint getEntrypoint(String _entrypointName,
 Object _k)
                         throws AparapiException

Throws:

AparapiException

getEntrypoint

public Entrypoint getEntrypoint()
                         throws AparapiException

Throws:

AparapiException

invalidateCaches

public static void invalidateCaches()

toString

public String toString()

Overrides:

toString in class Object