org.apache.bcel.classfile
Class Code
java.lang.Object
org.apache.bcel.classfile.Attribute
org.apache.bcel.classfile.Code
- All Implemented Interfaces:
- java.io.Serializable, java.lang.Cloneable, Node
public final class Code
- extends Attribute
This class represents a chunk of Java byte code contained in a
method. It is instantiated by the
Attribute.readAttribute() method. A Code
attribute contains informations about operand stack, local
variables, byte code and the exceptions handled within this
method.
This attribute has attributes itself, namely LineNumberTable which
is used for debugging purposes and LocalVariableTable which
contains information about the local variables.
- Version:
- $Id: Code.java 386056 2006-03-15 11:31:56Z tcurdt $
- Author:
- M. Dahm
- See Also:
Attribute
,
CodeException
,
LineNumberTable
,
LocalVariableTable
,
Serialized Form
Constructor Summary |
Code(Code c)
Initialize from another object. |
Code(int name_index,
int length,
java.io.DataInputStream file,
ConstantPool constant_pool)
|
Code(int name_index,
int length,
int max_stack,
int max_locals,
byte[] code,
CodeException[] exception_table,
Attribute[] attributes,
ConstantPool constant_pool)
|
Methods inherited from class org.apache.bcel.classfile.Attribute |
addAttributeReader, clone, getConstantPool, getLength, getNameIndex, getTag, readAttribute, removeAttributeReader, setConstantPool, setLength, setNameIndex |
Methods inherited from class java.lang.Object |
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
max_stack
private int max_stack
max_locals
private int max_locals
code_length
private int code_length
code
private byte[] code
exception_table_length
private int exception_table_length
exception_table
private CodeException[] exception_table
attributes_count
private int attributes_count
attributes
private Attribute[] attributes
Code
public Code(Code c)
- Initialize from another object. Note that both objects use the same
references (shallow copy). Use copy() for a physical copy.
Code
Code(int name_index,
int length,
java.io.DataInputStream file,
ConstantPool constant_pool)
throws java.io.IOException
- Parameters:
name_index
- Index pointing to the name Codelength
- Content length in bytesfile
- Input streamconstant_pool
- Array of constants
- Throws:
java.io.IOException
Code
public Code(int name_index,
int length,
int max_stack,
int max_locals,
byte[] code,
CodeException[] exception_table,
Attribute[] attributes,
ConstantPool constant_pool)
- Parameters:
name_index
- Index pointing to the name Codelength
- Content length in bytesmax_stack
- Maximum size of stackmax_locals
- Number of local variablescode
- Actual byte codeexception_table
- Table of handled exceptionsattributes
- Attributes of code: LineNumber or LocalVariableconstant_pool
- Array of constants
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
- Specified by:
accept
in class Attribute
- Parameters:
v
- Visitor object
dump
public final void dump(java.io.DataOutputStream file)
throws java.io.IOException
- Dump code attribute to file stream in binary format.
- Overrides:
dump
in class Attribute
- Parameters:
file
- Output file stream
- Throws:
java.io.IOException
getAttributes
public final Attribute[] getAttributes()
- Returns:
- Collection of code attributes.
- See Also:
Attribute
getLineNumberTable
public LineNumberTable getLineNumberTable()
- Returns:
- LineNumberTable of Code, if it has one
getLocalVariableTable
public LocalVariableTable getLocalVariableTable()
- Returns:
- LocalVariableTable of Code, if it has one
getCode
public final byte[] getCode()
- Returns:
- Actual byte code of the method.
getExceptionTable
public final CodeException[] getExceptionTable()
- Returns:
- Table of handled exceptions.
- See Also:
CodeException
getMaxLocals
public final int getMaxLocals()
- Returns:
- Number of local variables.
getMaxStack
public final int getMaxStack()
- Returns:
- Maximum size of stack used by this method.
getInternalLength
private final int getInternalLength()
- Returns:
- the internal length of this code attribute (minus the first 6 bytes)
and excluding all its attributes
calculateLength
private final int calculateLength()
- Returns:
- the full size of this code attribute, minus its first 6 bytes,
including the size of all its contained attributes
setAttributes
public final void setAttributes(Attribute[] attributes)
- Parameters:
attributes
- the attributes to set for this Code
setCode
public final void setCode(byte[] code)
- Parameters:
code
- byte code
setExceptionTable
public final void setExceptionTable(CodeException[] exception_table)
- Parameters:
exception_table
- exception table
setMaxLocals
public final void setMaxLocals(int max_locals)
- Parameters:
max_locals
- maximum number of local variables
setMaxStack
public final void setMaxStack(int max_stack)
- Parameters:
max_stack
- maximum stack size
toString
public final java.lang.String toString(boolean verbose)
- Returns:
- String representation of code chunk.
toString
public final java.lang.String toString()
- Overrides:
toString
in class Attribute
- Returns:
- String representation of code chunk.
copy
public Attribute copy(ConstantPool _constant_pool)
- Specified by:
copy
in class Attribute
- Parameters:
_constant_pool
- the constant pool to duplicate
- Returns:
- deep copy of this attribute