FileDocCategorySizeDatePackage
ExceptionList.javaAPI DocJava SE 5 API3482Fri Aug 26 14:58:28 BST 2005org.omg.CORBA

ExceptionList

public abstract class ExceptionList extends Object
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.

version
1.13, 09/09/97
since
JDK1.2

Fields Summary
Constructors Summary
Methods Summary
public abstract voidadd(TypeCode exc)
Adds a TypeCode object describing an exception to this ExceptionList object.

param
exc the TypeCode object to be added

public abstract intcount()
Retrieves the number of TypeCode objects in this ExceptionList object.

return
the number of TypeCode objects in this ExceptionList object

public abstract TypeCodeitem(int index)
Returns the TypeCode object at the given index. The first item is at index 0.

param
index the index of the TypeCode object desired. This must be an int between 0 and the number of TypeCode objects minus one, inclusive.
return
the TypeCode object at the given index
exception
org.omg.CORBA.Bounds if the index given is greater than or equal to the number of TypeCode objects in this ExceptionList object

public abstract voidremove(int 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.

param
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.
exception
org.omg.CORBA.Bounds if the index is greater than or equal to the number of TypeCode objects in this ExceptionList object