org.apache.bcel.classfile
Class JavaClass

java.lang.Object
  |
  +--org.apache.bcel.classfile.AccessFlags
        |
        +--org.apache.bcel.classfile.JavaClass

All Implemented Interfaces:

java.lang.Cloneable, Node, java.io.Serializable

public class JavaClass

extends AccessFlags

implements java.lang.Cloneable, Node

Represents a Java class, i.e., the data structures, constant pool, fields, methods and commands contained in a Java .class file. See JVM specification for details. The intent of this class is to represent a parsed or otherwise existing class file. Those interested in programatically generating classes should see the ClassGen class.

Version:

$Id: JavaClass.java,v 1.13 2002/07/11 19:39:04 mdahm Exp $

Author:

M. Dahm

See Also:

ClassGen, Serialized Form

Field Summary

static byte	FILE
static byte	HEAP
static byte	ZIP

Fields inherited from class org.apache.bcel.classfile.AccessFlags

access_flags

Constructor Summary

JavaClass(int class_name_index, int superclass_name_index, java.lang.String file_name, int major, int minor, int access_flags, ConstantPool constant_pool, int[] interfaces, Field[] fields, Method[] methods, Attribute[] attributes)
Constructor gets all contents as arguments.

JavaClass(int class_name_index, int superclass_name_index, java.lang.String file_name, int major, int minor, int access_flags, ConstantPool constant_pool, int[] interfaces, Field[] fields, Method[] methods, Attribute[] attributes, byte source)
Constructor gets all contents as arguments.

Method Summary

void	accept(Visitor v) Called by objects that are traversing the nodes of the tree implicitely defined by the contents of a Java class.
JavaClass	copy()
void	dump(java.io.DataOutputStream file) Dump Java class to output stream in binary format.
void	dump(java.io.File file) Dump class to a file.
void	dump(java.io.OutputStream file) Dump Java class to output stream in binary format.
void	dump(java.lang.String file_name) Dump class to a file named file_name.
JavaClass[]	getAllInterfaces() Get all interfaces implemented by this JavaClass (transitively).
Attribute[]	getAttributes()
byte[]	getBytes()
java.lang.String	getClassName()
int	getClassNameIndex()
ConstantPool	getConstantPool()
Field[]	getFields()
java.lang.String	getFileName()
int[]	getInterfaceIndices()
java.lang.String[]	getInterfaceNames()
JavaClass[]	getInterfaces() Get interfaces directly implemented by this JavaClass.
int	getMajor()
Method	getMethod(java.lang.reflect.Method m)
Method[]	getMethods()
int	getMinor()
java.lang.String	getPackageName()
Repository	getRepository() Gets the ClassRepository which holds its definition.
byte	getSource()
java.lang.String	getSourceFileName()
JavaClass	getSuperClass()
JavaClass[]	getSuperClasses()
java.lang.String	getSuperclassName()
int	getSuperclassNameIndex()
boolean	implementationOf(JavaClass inter)
boolean	instanceOf(JavaClass super_class) Equivalent to runtime "instanceof" operator.
boolean	isClass()
boolean	isSuper()
void	setAttributes(Attribute[] attributes)
void	setClassName(java.lang.String class_name)
void	setClassNameIndex(int class_name_index)
void	setConstantPool(ConstantPool constant_pool)
void	setFields(Field[] fields)
void	setFileName(java.lang.String file_name) Set File name of class, aka SourceFile attribute value
void	setInterfaceNames(java.lang.String[] interface_names)
void	setInterfaces(int[] interfaces)
void	setMajor(int major)
void	setMethods(Method[] methods)
void	setMinor(int minor)
void	setRepository(Repository repository) Sets the ClassRepository which loaded the JavaClass.
void	setSourceFileName(java.lang.String source_file_name) Set absolute path to file this class was read from.
void	setSuperclassName(java.lang.String superclass_name)
void	setSuperclassNameIndex(int superclass_name_index)
java.lang.String	toString()

Methods inherited from class org.apache.bcel.classfile.AccessFlags

getAccessFlags, getModifiers, isAbstract, isAbstract, isFinal, isFinal, isInterface, isInterface, isNative, isNative, isPrivate, isPrivate, isProtected, isProtected, isPublic, isPublic, isStatic, isStatic, isStrictfp, isStrictfp, isSynchronized, isSynchronized, isTransient, isTransient, isVolatile, isVolatile, setAccessFlags, setModifiers

Methods inherited from class java.lang.Object

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

Field Detail

HEAP

public static final byte HEAP

See Also:

Constant Field Values

FILE

public static final byte FILE

See Also:

Constant Field Values

ZIP

public static final byte ZIP

See Also:

Constant Field Values

Constructor Detail

JavaClass

public JavaClass(int class_name_index,
                 int superclass_name_index,
                 java.lang.String file_name,
                 int major,
                 int minor,
                 int access_flags,
                 ConstantPool constant_pool,
                 int[] interfaces,
                 Field[] fields,
                 Method[] methods,
                 Attribute[] attributes,
                 byte source)

Constructor gets all contents as arguments.

Parameters:

class_name_index - Index into constant pool referencing a ConstantClass that represents this class.

superclass_name_index - Index into constant pool referencing a ConstantClass that represents this class's superclass.

file_name - File name

major - Major compiler version

minor - Minor compiler version

access_flags - Access rights defined by bit flags

constant_pool - Array of constants

interfaces - Implemented interfaces

fields - Class fields

methods - Class methods

attributes - Class attributes

source - Read from file or generated in memory?

JavaClass

public JavaClass(int class_name_index,
                 int superclass_name_index,
                 java.lang.String file_name,
                 int major,
                 int minor,
                 int access_flags,
                 ConstantPool constant_pool,
                 int[] interfaces,
                 Field[] fields,
                 Method[] methods,
                 Attribute[] attributes)

Constructor gets all contents as arguments.

Parameters:

class_name_index - Class name

superclass_name_index - Superclass name

file_name - File name

major - Major compiler version

minor - Minor compiler version

access_flags - Access rights defined by bit flags

constant_pool - Array of constants

interfaces - Implemented interfaces

fields - Class fields

methods - Class methods

attributes - Class attributes

Method Detail

accept

public void accept(Visitor v)

Called by objects that are traversing the nodes of the tree implicitely defined by the contents of a Java class. I.e., the hierarchy of methods, fields, attributes, etc. spawns a tree of objects.

Specified by:

accept in interface Node

Parameters:

v - Visitor object

dump

public void dump(java.io.File file)
          throws java.io.IOException

Dump class to a file.

Parameters:

file - Output file

Throws:

java.io.IOException

dump

public void dump(java.lang.String file_name)
          throws java.io.IOException

Dump class to a file named file_name.

Parameters:

file_name - Output file name

Throws:

java.io.IOException

getBytes

public byte[] getBytes()

Returns:

class in binary format

dump

public void dump(java.io.OutputStream file)
          throws java.io.IOException

Dump Java class to output stream in binary format.

Parameters:

file - Output stream

Throws:

java.io.IOException

dump

public void dump(java.io.DataOutputStream file)
          throws java.io.IOException

Dump Java class to output stream in binary format.

Parameters:

file - Output stream

Throws:

java.io.IOException

getAttributes

public Attribute[] getAttributes()

Returns:

Attributes of the class.

getClassName

public java.lang.String getClassName()

Returns:

Class name.

getPackageName

public java.lang.String getPackageName()

Returns:

Package name.

getClassNameIndex

public int getClassNameIndex()

Returns:

Class name index.

getConstantPool

public ConstantPool getConstantPool()

Returns:

Constant pool.

getFields

public Field[] getFields()

Returns:

Fields, i.e., variables of the class. Like the JVM spec mandates for the classfile format, these fields are those specific to this class, and not those of the superclass or superinterfaces.

getFileName

public java.lang.String getFileName()

Returns:

File name of class, aka SourceFile attribute value

getInterfaceNames

public java.lang.String[] getInterfaceNames()

Returns:

Names of implemented interfaces.

getInterfaceIndices

public int[] getInterfaceIndices()

Returns:

Indices in constant pool of implemented interfaces.

getMajor

public int getMajor()

Returns:

Major number of class file version.

getMethods

public Method[] getMethods()

Returns:

Methods of the class.

getMethod

public Method getMethod(java.lang.reflect.Method m)

Returns:

A org.apache.bcel.classfile.Method corresponding to java.lang.reflect.Method if any

getMinor

public int getMinor()

Returns:

Minor number of class file version.

getSourceFileName

public java.lang.String getSourceFileName()

Returns:

sbsolute path to file where this class was read from

getSuperclassName

public java.lang.String getSuperclassName()

Returns:

Superclass name.

getSuperclassNameIndex

public int getSuperclassNameIndex()

Returns:

Class name index.

setAttributes

public void setAttributes(Attribute[] attributes)

Parameters:

attributes - .

setClassName

public void setClassName(java.lang.String class_name)

Parameters:

class_name - .

setClassNameIndex

public void setClassNameIndex(int class_name_index)

Parameters:

class_name_index - .

setConstantPool

public void setConstantPool(ConstantPool constant_pool)

Parameters:

constant_pool - .

setFields

public void setFields(Field[] fields)

Parameters:

fields - .

setFileName

public void setFileName(java.lang.String file_name)

Set File name of class, aka SourceFile attribute value

setInterfaceNames

public void setInterfaceNames(java.lang.String[] interface_names)

Parameters:

interface_names - .

setInterfaces

public void setInterfaces(int[] interfaces)

Parameters:

interfaces - .

setMajor

public void setMajor(int major)

Parameters:

major - .

setMethods

public void setMethods(Method[] methods)

Parameters:

methods - .

setMinor

public void setMinor(int minor)

Parameters:

minor - .

setSourceFileName

public void setSourceFileName(java.lang.String source_file_name)

Set absolute path to file this class was read from.

setSuperclassName

public void setSuperclassName(java.lang.String superclass_name)

Parameters:

superclass_name - .

setSuperclassNameIndex

public void setSuperclassNameIndex(int superclass_name_index)

Parameters:

superclass_name_index - .

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

Returns:

String representing class contents.

copy

public JavaClass copy()

Returns:

deep copy of this class

isSuper

public final boolean isSuper()

isClass

public final boolean isClass()

getSource

public final byte getSource()

Returns:

returns either HEAP (generated), FILE, or ZIP

getRepository

public Repository getRepository()

Gets the ClassRepository which holds its definition. By default this is the same as SyntheticRepository.getInstance();

setRepository

public void setRepository(Repository repository)

Sets the ClassRepository which loaded the JavaClass. Should be called immediately after parsing is done.

instanceOf

public final boolean instanceOf(JavaClass super_class)

Equivalent to runtime "instanceof" operator.

Returns:

true if this JavaClass is derived from teh super class

implementationOf

public boolean implementationOf(JavaClass inter)

Returns:

true, if clazz is an implementation of interface inter

getSuperClass

public JavaClass getSuperClass()

Returns:

the superclass for this JavaClass object, or null if this is java.lang.Object

getSuperClasses

public JavaClass[] getSuperClasses()

Returns:

list of super classes of this class in ascending order, i.e., java.lang.Object is always the last element

getInterfaces

public JavaClass[] getInterfaces()

Get interfaces directly implemented by this JavaClass.

getAllInterfaces

public JavaClass[] getAllInterfaces()

Get all interfaces implemented by this JavaClass (transitively).