org.apache.bcel.classfile

Class CodeException

Implemented Interfaces:
Cloneable, Constants, Node, Serializable

public final class CodeException
extends java.lang.Object
implements Cloneable, Constants, Node, Serializable

This class represents an entry in the exception table of the Code attribute and is used only there. It contains a range in which a particular exception handler is active.
Version:
$Id: CodeException.java,v 1.3 2002/07/11 19:39:04 mdahm Exp $
Author:
M. Dahm
See Also:
Code

Fields inherited from interface org.apache.bcel.Constants

AALOAD, AASTORE, ACCESS_NAMES, ACC_ABSTRACT, ACC_FINAL, ACC_INTERFACE, ACC_NATIVE, ACC_PRIVATE, ACC_PROTECTED, ACC_PUBLIC, ACC_STATIC, ACC_STRICT, ACC_SUPER, ACC_SYNCHRONIZED, ACC_TRANSIENT, ACC_VOLATILE, ACONST_NULL, ALOAD, ALOAD_0, ALOAD_1, ALOAD_2, ALOAD_3, ANEWARRAY, ANEWARRAY_QUICK, ARETURN, ARRAYLENGTH, ASTORE, ASTORE_0, ASTORE_1, ASTORE_2, ASTORE_3, ATHROW, ATTRIBUTE_NAMES, ATTR_CODE, ATTR_CONSTANT_VALUE, ATTR_DEPRECATED, ATTR_EXCEPTIONS, ATTR_INNER_CLASSES, ATTR_LINE_NUMBER_TABLE, ATTR_LOCAL_VARIABLE_TABLE, ATTR_PMG, ATTR_SIGNATURE, ATTR_SOURCE_FILE, ATTR_STACK_MAP, ATTR_SYNTHETIC, ATTR_UNKNOWN, BALOAD, BASTORE, BIPUSH, BREAKPOINT, CALOAD, CASTORE, CHECKCAST, CHECKCAST_QUICK, CLASS_TYPE_NAMES, CONSTANT_Class, CONSTANT_Double, CONSTANT_Fieldref, CONSTANT_Float, CONSTANT_Integer, CONSTANT_InterfaceMethodref, CONSTANT_Long, CONSTANT_Methodref, CONSTANT_NAMES, CONSTANT_NameAndType, CONSTANT_String, CONSTANT_Utf8, CONSTRUCTOR_NAME, CONSUME_STACK, D2F, D2I, D2L, DADD, DALOAD, DASTORE, DCMPG, DCMPL, DCONST_0, DCONST_1, DDIV, DLOAD, DLOAD_0, DLOAD_1, DLOAD_2, DLOAD_3, DMUL, DNEG, DREM, DRETURN, DSTORE, DSTORE_0, DSTORE_1, DSTORE_2, DSTORE_3, DSUB, DUP, DUP2, DUP2_X1, DUP2_X2, DUP_X1, DUP_X2, F2D, F2I, F2L, FADD, FALOAD, FASTORE, FCMPG, FCMPL, FCONST_0, FCONST_1, FCONST_2, FDIV, FLOAD, FLOAD_0, FLOAD_1, FLOAD_2, FLOAD_3, FMUL, FNEG, FREM, FRETURN, FSTORE, FSTORE_0, FSTORE_1, FSTORE_2, FSTORE_3, FSUB, GETFIELD, GETFIELD2_QUICK, GETFIELD_QUICK, GETFIELD_QUICK_W, GETSTATIC, GETSTATIC2_QUICK, GETSTATIC_QUICK, GOTO, GOTO_W, I2B, I2C, I2D, I2F, I2L, I2S, IADD, IALOAD, IAND, IASTORE, ICONST_0, ICONST_1, ICONST_2, ICONST_3, ICONST_4, ICONST_5, ICONST_M1, IDIV, IFEQ, IFGE, IFGT, IFLE, IFLT, IFNE, IFNONNULL, IFNULL, IF_ACMPEQ, IF_ACMPNE, IF_ICMPEQ, IF_ICMPGE, IF_ICMPGT, IF_ICMPLE, IF_ICMPLT, IF_ICMPNE, IINC, ILLEGAL_OPCODE, ILLEGAL_TYPE, ILOAD, ILOAD_0, ILOAD_1, ILOAD_2, ILOAD_3, IMPDEP1, IMPDEP2, IMUL, INEG, INSTANCEOF, INSTANCEOF_QUICK, INT2BYTE, INT2CHAR, INT2SHORT, INTERFACES_IMPLEMENTED_BY_ARRAYS, INVOKEINTERFACE, INVOKEINTERFACE_QUICK, INVOKENONVIRTUAL, INVOKENONVIRTUAL_QUICK, INVOKESPECIAL, INVOKESTATIC, INVOKESTATIC_QUICK, INVOKESUPER_QUICK, INVOKEVIRTUAL, INVOKEVIRTUALOBJECT_QUICK, INVOKEVIRTUAL_QUICK, INVOKEVIRTUAL_QUICK_W, IOR, IREM, IRETURN, ISHL, ISHR, ISTORE, ISTORE_0, ISTORE_1, ISTORE_2, ISTORE_3, ISUB, ITEM_Bogus, ITEM_Double, ITEM_Float, ITEM_InitObject, ITEM_Integer, ITEM_Long, ITEM_NAMES, ITEM_NewObject, ITEM_Null, ITEM_Object, IUSHR, IXOR, JSR, JSR_W, KNOWN_ATTRIBUTES, L2D, L2F, L2I, LADD, LALOAD, LAND, LASTORE, LCMP, LCONST_0, LCONST_1, LDC, LDC2_W, LDC2_W_QUICK, LDC_QUICK, LDC_W, LDC_W_QUICK, LDIV, LLOAD, LLOAD_0, LLOAD_1, LLOAD_2, LLOAD_3, LMUL, LNEG, LOOKUPSWITCH, LOR, LREM, LRETURN, LSHL, LSHR, LSTORE, LSTORE_0, LSTORE_1, LSTORE_2, LSTORE_3, LSUB, LUSHR, LXOR, MAJOR, MAJOR_1_1, MAJOR_1_2, MAJOR_1_3, MAX_ACC_FLAG, MAX_BYTE, MAX_CODE_SIZE, MAX_CP_ENTRIES, MAX_SHORT, MINOR, MINOR_1_1, MINOR_1_2, MINOR_1_3, MONITORENTER, MONITOREXIT, MULTIANEWARRAY, MULTIANEWARRAY_QUICK, NEW, NEWARRAY, NEW_QUICK, NOP, NO_OF_OPERANDS, OPCODE_NAMES, POP, POP2, PRODUCE_STACK, PUSH, PUTFIELD, PUTFIELD2_QUICK, PUTFIELD_QUICK, PUTFIELD_QUICK_W, PUTSTATIC, PUTSTATIC2_QUICK, PUTSTATIC_QUICK, RESERVED, RET, RETURN, SALOAD, SASTORE, SHORT_TYPE_NAMES, SIPUSH, STATIC_INITIALIZER_NAME, SWAP, SWITCH, TABLESWITCH, TYPE_NAMES, TYPE_OF_OPERANDS, T_ADDRESS, T_ARRAY, T_BOOLEAN, T_BYTE, T_CHAR, T_DOUBLE, T_FLOAT, T_INT, T_LONG, T_OBJECT, T_REFERENCE, T_SHORT, T_UNKNOWN, T_VOID, UNDEFINED, UNPREDICTABLE, WIDE

Constructor Summary

CodeException(int start_pc, int end_pc, int handler_pc, int catch_type)
CodeException(CodeException c)
Initialize from another object.

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.
CodeException
copy()
void
dump(DataOutputStream file)
Dump code exception to file stream in binary format.
int
getCatchType()
int
getEndPC()
int
getHandlerPC()
int
getStartPC()
void
setCatchType(int catch_type)
void
setEndPC(int end_pc)
void
setHandlerPC(int handler_pc)
void
setStartPC(int start_pc)
String
toString()
String
toString(ConstantPool cp)
String
toString(ConstantPool cp, boolean verbose)

Constructor Details

CodeException

public CodeException(int start_pc,
                     int end_pc,
                     int handler_pc,
                     int catch_type)
Parameters:
start_pc - Range in the code the exception handler is active, start_pc is inclusive while
end_pc - is exclusive
handler_pc - Starting address of exception handler, i.e., an offset from start of code.
catch_type - If zero the handler catches any exception, otherwise it points to the exception class which is to be caught.

CodeException

public CodeException(CodeException c)
Initialize from another object.

Method Details

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

copy

public CodeException copy()
Returns:
deep copy of this object

dump

public final void dump(DataOutputStream file)
            throws IOException
Dump code exception to file stream in binary format.
Parameters:
file - Output file stream

getCatchType

public final int getCatchType()
Returns:
0, if the handler catches any exception, otherwise it points to the exception class which is to be caught.

getEndPC

public final int getEndPC()
Returns:
Exclusive end index of the region where the handler is active.

getHandlerPC

public final int getHandlerPC()
Returns:
Starting address of exception handler, relative to the code.

getStartPC

public final int getStartPC()
Returns:
Inclusive start index of the region where the handler is active.

setCatchType

public final void setCatchType(int catch_type)
Parameters:

setEndPC

public final void setEndPC(int end_pc)
Parameters:
end_pc - end of handled block

setHandlerPC

public final void setHandlerPC(int handler_pc)
Parameters:
handler_pc - where the actual code is

setStartPC

public final void setStartPC(int start_pc)
Parameters:
start_pc - start of handled block

toString

public final String toString()
Returns:
String representation.

toString

public final String toString(ConstantPool cp)

toString

public final String toString(ConstantPool cp,
                             boolean verbose)
Returns:
String representation.