FileDocCategorySizeDatePackage
ExceptionsAttribute_info.javaAPI DocAndroid 1.5 API4464Wed May 06 22:41:16 BST 2009com.vladium.jcd.cls.attribute

ExceptionsAttribute_info

public final class ExceptionsAttribute_info extends Attribute_info
The Exceptions attribute is a variable-length attribute used in the attributes table of a {@link com.vladium.jcd.cls.Method_info} structure. The Exceptions attribute indicates which checked exceptions a method may throw. There must be exactly one Exceptions attribute in each method_info structure.

The Exceptions attribute has the following format: 

Exceptions_attribute {
u2 attribute_name_index;
u4 attribute_length;
u2 number_of_exceptions;
u2 exception_index_table[number_of_exceptions];
}
The value of the number_of_exceptions item indicates the number of entries in the exception_index_table.

Each nonzero value in the exception_index_table array must be a valid index into the constant_pool table. For each table item, if exception_index_table[i] != 0 , where 0 < i < number_of_exceptions, then the constant_pool entry at index exception_index_table[i] must be a {@link com.vladium.jcd.cls.constant.CONSTANT_Class_info} structure representing a class type that this method is declared to throw -- see {@link DeclaredExceptionTable}.

author
(C) 2001, Vlad Roubtsov

Fields Summary
private IDeclaredExceptionTable
m_exceptions
Constructors Summary
public ExceptionsAttribute_info(int attribute_name_index, IDeclaredExceptionTable exceptions)

        super (attribute_name_index, exceptions.length ());
    
        m_exceptions = exceptions;
ExceptionsAttribute_info(int attribute_name_index, long attribute_length, com.vladium.jcd.lib.UDataInputStream bytes)

        super (attribute_name_index, attribute_length);
        
        final int number_of_exceptions = bytes.readU2 ();
        m_exceptions = new DeclaredExceptionTable (number_of_exceptions);
        
        for (int i = 0; i < number_of_exceptions; i++)
        {
            final int exception_index = bytes.readU2 ();
            
            m_exceptions.add (exception_index);
        }
Methods Summary
public voidaccept(IAttributeVisitor visitor, java.lang.Object ctx)

        visitor.visit (this, ctx);
public java.lang.Objectclone()
Performs a deep copy.

        final ExceptionsAttribute_info _clone = (ExceptionsAttribute_info) super.clone ();
        
        // do deep copy:
        _clone.m_exceptions = (IDeclaredExceptionTable) m_exceptions.clone ();
        
        return _clone;
public IDeclaredExceptionTablegetDeclaredExceptions()

        return m_exceptions;
public longlength()

        return 6 + m_exceptions.length ();
public java.lang.StringtoString()

        // TODO: return more data here
        return "ExceptionsAttribute_info: [attribute_name_index = " + m_name_index + ", attribute_length = " + m_attribute_length + ']";
public voidwriteInClassFormat(com.vladium.jcd.lib.UDataOutputStream out)

        super.writeInClassFormat (out);
        
        m_exceptions.writeInClassFormat (out);