Package org.omg.CORBA
Class ExceptionList
java.lang.Object
org.omg.CORBA.ExceptionList
- Direct Known Subclasses:
ExceptionListImpl
An object used in
Request
operations to
describe the exceptions that can be thrown by a method. It maintains a
modifiable list of TypeCode
s of the exceptions.
The following code fragment demonstrates creating
an ExceptionList
object:
ORB orb = ORB.init(args, null); org.omg.CORBA.ExceptionList excList = orb.create_exception_list();The variable
excList
represents an ExceptionList
object with no TypeCode
objects in it.
To add items to the list, you first create a TypeCode
object
for the exception you want to include, using the ORB
method
create_exception_tc
. Then you use the ExceptionList
method add
to add it to the list.
The class ExceptionList
has a method for getting
the number of TypeCode
objects in the list, and after
items have been added, it is possible to call methods for accessing
or deleting an item at a designated index.
- Since:
- JDK1.2
- Version:
- 1.13, 09/09/97
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract void
Adds aTypeCode
object describing an exception to thisExceptionList
object.abstract int
count()
Retrieves the number ofTypeCode
objects in thisExceptionList
object.abstract TypeCode
item
(int index) Returns theTypeCode
object at the given index.abstract void
remove
(int index) Removes theTypeCode
object at the given index.
-
Constructor Details
-
ExceptionList
public ExceptionList()
-
-
Method Details
-
count
public abstract int count()Retrieves the number ofTypeCode
objects in thisExceptionList
object.- Returns:
- the number of
TypeCode
objects in thisExceptionList
object
-
add
Adds aTypeCode
object describing an exception to thisExceptionList
object.- Parameters:
exc
- theTypeCode
object to be added
-
item
Returns theTypeCode
object at the given index. The first item is at index 0.- Parameters:
index
- the index of theTypeCode
object desired. This must be anint
between 0 and the number ofTypeCode
objects minus one, inclusive.- Returns:
- the
TypeCode
object at the given index - Throws:
Bounds
- if the index given is greater than or equal to the number ofTypeCode
objects in thisExceptionList
object
-
remove
Removes theTypeCode
object at the given index. Note that the indices of all theTypeCoded
objects following the one deleted are shifted down by one.- Parameters:
index
- the index of theTypeCode
object to be removed. This must be anint
between 0 and the number ofTypeCode
objects minus one, inclusive.- Throws:
Bounds
- if the index is greater than or equal to the number ofTypeCode
objects in thisExceptionList
object
-