ExceptionList JDK 1.6)

Description

publicabstract abstract class ExceptionList

An object used in Request operations to describe the exceptions that can be thrown by a method.

An object used in Request operations to describe the exceptions that can be thrown by a method. It maintains a modifiable list of TypeCodes 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.

See also:

Methods

Hide/Show inherited methods

publicabstract void add (TypeCode exc)

Adds a TypeCode object describing an exception to this ExceptionList object.

Adds a TypeCode object describing an exception
to this ExceptionList object.
Parameters:
- exc - the TypeCode object to be added

publicabstract int count ()

Retrieves the number of TypeCode objects in this ExceptionList object.

Retrieves the number of TypeCode objects in this
ExceptionList object.
Returns: the number of TypeCode objects in this ExceptionList object

publicabstract TypeCode item (int index) throws Bounds

Returns the TypeCode object at the given index.

Returns the TypeCode object at the given index. The first
item is at index 0.
Returns: the TypeCode object at the given index
Parameters:
- index - the index of the TypeCode object desired. This must be an int between 0 and the number of TypeCode objects minus one, inclusive.
Throws:
- org.omg.CORBA.Bounds - if the index given is greater than or equal to the number of TypeCode objects in this ExceptionList object

publicabstract void remove (int index) throws Bounds

Removes the TypeCode object at the given index.

Removes the TypeCode object at the given index.
Note that the indices of all the TypeCoded objects
following the one deleted are shifted down by one.
Parameters:
- index - the index of the TypeCode object to be removed. This must be an int between 0 and the number of TypeCode objects minus one, inclusive.
Throws:
- org.omg.CORBA.Bounds - if the index is greater than or equal to the number of TypeCode objects in this ExceptionList object