org.apache.bcel.classfile

## Class ExceptionTable

- java.lang.Object
- - org.apache.bcel.classfile.Attribute
  - - org.apache.bcel.classfile.ExceptionTable

- All Implemented Interfaces:
    Cloneable, Node

      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`

- - ### Field Summary

    - ### Fields inherited from class org.apache.bcel.classfile.Attribute

      `constant_pool, EMPTY_ARRAY, length, name_index, tag`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `ExceptionTable(ExceptionTable c)` Initialize from another object.
    `ExceptionTable(int nameIndex, int length, int[] exceptionIndexTable, ConstantPool constantPool)`

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `accept(Visitor v)` Called by objects that are traversing the nodes of the tree implicitly defined by the contents of a Java class.
    `Attribute` | `copy(ConstantPool constantPool)`
    `void` | `dump(DataOutputStream file)` Dump exceptions attribute to file stream in binary format.
    `int[]` | `getExceptionIndexTable()`
    `String[]` | `getExceptionNames()`
    `int` | `getNumberOfExceptions()`
    `void` | `setExceptionIndexTable(int[] exceptionIndexTable)`
    `String` | `toString()`

    - ### Methods inherited from class org.apache.bcel.classfile.Attribute

      `addAttributeReader, addAttributeReader, clone, getConstantPool, getLength, getName, getNameIndex, getTag, println, readAttribute, readAttribute, removeAttributeReader, setConstantPool, setLength, setNameIndex`

    - ### Methods inherited from class java.lang.Object

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

- - ### 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 nameIndex,
                                int length,
                                int[] exceptionIndexTable,
                                ConstantPool constantPool)

      Parameters:
        `nameIndex` - Index in constant pool
        `length` - Content length in bytes
        `exceptionIndexTable` - Table of indices in constant pool
        `constantPool` - Array of constants

  - ### Method Detail

    - #### accept

          public void accept(Visitor v)

      Called by objects that are traversing the nodes of the tree implicitly 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

    - #### copy

          public Attribute copy(ConstantPool constantPool)

      Specified by:
        `copy` in class `Attribute`
      Returns:
        deep copy of this attribute

    - #### dump

          public void dump(DataOutputStream file)
                    throws IOException

      Dump exceptions attribute to file stream in binary format.
      Overrides:
        `dump` in class `Attribute`
      Parameters:
        `file` - Output file stream
      Throws:
        `IOException` - if an I/O error occurs.

    - #### getExceptionIndexTable

          public int[] getExceptionIndexTable()

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

    - #### getExceptionNames

          public String[] getExceptionNames()

      Returns:
        class names of thrown exceptions

    - #### getNumberOfExceptions

          public int getNumberOfExceptions()

      Returns:
        Length of exception table.

    - #### setExceptionIndexTable

          public void setExceptionIndexTable(int[] exceptionIndexTable)

      Parameters:
        `exceptionIndexTable` - the list of exception indexes Also redefines number_of_exceptions according to table length.

    - #### toString

          public String toString()

      Overrides:
        `toString` in class `Attribute`
      Returns:
        String representation, i.e., a list of thrown exceptions.

Copyright © 2004–2022 The Apache Software Foundation. All rights reserved.