1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
/* Copyright (C) 2003 Vladimir Roubtsov. All rights reserved.
*
* This program and the accompanying materials are made available under
* the terms of the Common Public License v1.0 which accompanies this distribution,
* and is available at http://www.eclipse.org/legal/cpl-v10.html
*
* $Id: IDeclaredExceptionTable.java,v 1.1.1.1.2.1 2004/07/10 03:34:52 vlad_r Exp $
*/
package com.vladium.jcd.cls.attribute;
import com.vladium.jcd.compiler.IClassFormatOutput;
// ----------------------------------------------------------------------------
/**
* This table is a structure nested within {@link ExceptionsAttribute_info}
* structure. It is a table of unsigned 16-bit indexes into constant pool. Each
* index points to a {@link com.vladium.jcd.cls.constant.CONSTANT_Class_info}
* entry representing an exception a method can throw [in unspecified order].
*
* @author (C) 2001, Vlad Roubtsov
*/
public
interface IDeclaredExceptionTable extends Cloneable, IClassFormatOutput
{
// public: ................................................................
// ACCESSORS:
/**
* Returns the {@link com.vladium.jcd.cls.constant.CONSTANT_Class_info} constant
* pool index for offset'th exception type thrown by the method that contains
* this this exception index table in its ExceptionsAttribute_info attribute.
*
* @param offset thrown exception class number [must be in [0, size()) range]
* @return constant pool index [always positive]
*
* @throws IndexOutOfBoundsException if 'offset' is outside of valid range
*/
int get (int offset);
/**
* Returns the number of exception types the containing method professes
* to throw.
*/
int size ();
/**
* Returns the total length of this table when converted to
* .class format [including 2 count bytes]
*/
long length ();
// Cloneable: adjust the access level of Object.clone():
Object clone ();
// MUTATORS:
/**
* Appends a new exception class pointer to the collection. No duplicate checks
* are made.
*
* @param exception_index constant pool index [must be positive; input not validated]
* @return offset of the new pointer [same as {@link #size()}-1 when called
* after this method]
*/
int add (int exception_index);
/**
* Replaces exception class pointer number 'offset' with new value 'interface_index'.
* No duplicate checks are made. It is the responsibility of the caller to
* ensure that the relevant CONSTANT_Class_info descriptor will be found
* in the constant pool, in the slot pointed to by 'exception_index'.
*
* @param offset thrown exception class number [must be in [0, size()) range]
* @param exception_index constant pool index [must be positive; input not validated]
* @return previous value at the given index [always positive]
*
* @throws IndexOutOfBoundsException if 'offset' is outside of valid range
*/
int set (int offset, int exception_index);
} // end of interface
// ----------------------------------------------------------------------------
|
