org.apache.bcel.classfile

Class ExceptionTable

public final class ExceptionTable extends Attribute

This class represents the table of exceptions that are thrown by a method. This attribute may be used once per method. The name of this class is ExceptionTable for historical reasons; The Java Virtual Machine Specification, Second Edition defines this attribute using the name Exceptions (which is inconsistent with the other classes).

See Also: Code

Constructor Summary
ExceptionTable(ExceptionTable c)
Initialize from another object.
ExceptionTable(int name_index, int length, int[] exception_index_table, ConstantPool constant_pool)
Method Summary
voidaccept(Visitor v)
Called by objects that are traversing the nodes of the tree implicitely defined by the contents of a Java class.
Attributecopy(ConstantPool _constant_pool)
voiddump(DataOutputStream file)
Dump exceptions attribute to file stream in binary format.
int[]getExceptionIndexTable()
String[]getExceptionNames()
intgetNumberOfExceptions()
voidsetExceptionIndexTable(int[] exception_index_table)
StringtoString()

Constructor Detail

ExceptionTable

public ExceptionTable(ExceptionTable c)
Initialize from another object. Note that both objects use the same references (shallow copy). Use copy() for a physical copy.

ExceptionTable

public ExceptionTable(int name_index, int length, int[] exception_index_table, ConstantPool constant_pool)

Parameters: name_index Index in constant pool length Content length in bytes exception_index_table Table of indices in constant pool constant_pool Array of constants

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.

Parameters: v Visitor object

copy

public Attribute copy(ConstantPool _constant_pool)

Returns: deep copy of this attribute

dump

public final void dump(DataOutputStream file)
Dump exceptions attribute to file stream in binary format.

Parameters: file Output file stream

Throws: IOException

getExceptionIndexTable

public final int[] getExceptionIndexTable()

Returns: Array of indices into constant pool of thrown exceptions.

getExceptionNames

public final String[] getExceptionNames()

Returns: class names of thrown exceptions

getNumberOfExceptions

public final int getNumberOfExceptions()

Returns: Length of exception table.

setExceptionIndexTable

public final void setExceptionIndexTable(int[] exception_index_table)

Parameters: exception_index_table the list of exception indexes Also redefines number_of_exceptions according to table length.

toString

public final String toString()

Returns: String representation, i.e., a list of thrown exceptions.