org.omg.CORBA
Class ExceptionList

java.lang.Object sample code for java.lang.Object definition code for java.lang.Object 
  extended by org.omg.CORBA.ExceptionList

public abstract class ExceptionList
extends Object sample code for java.lang.Object definition code for java.lang.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.

Since:
JDK1.2

Constructor Summary
ExceptionList sample code for org.omg.CORBA.ExceptionList.ExceptionList() definition code for org.omg.CORBA.ExceptionList.ExceptionList() ()
           
 
Method Summary
abstract  void add sample code for org.omg.CORBA.ExceptionList.add(org.omg.CORBA.TypeCode) definition code for org.omg.CORBA.ExceptionList.add(org.omg.CORBA.TypeCode) (TypeCode sample code for org.omg.CORBA.TypeCode definition code for org.omg.CORBA.TypeCode  exc)
          Adds a TypeCode object describing an exception to this ExceptionList object.
abstract  int count sample code for org.omg.CORBA.ExceptionList.count() definition code for org.omg.CORBA.ExceptionList.count() ()
          Retrieves the number of TypeCode objects in this ExceptionList object.
abstract  TypeCode sample code for org.omg.CORBA.TypeCode definition code for org.omg.CORBA.TypeCode item sample code for org.omg.CORBA.ExceptionList.item(int) definition code for org.omg.CORBA.ExceptionList.item(int) (int index)
          Returns the TypeCode object at the given index.
abstract  void remove sample code for org.omg.CORBA.ExceptionList.remove(int) definition code for org.omg.CORBA.ExceptionList.remove(int) (int index)
          Removes the TypeCode object at the given index.
 
Methods inherited from class java.lang.Object sample code for java.lang.Object definition code for java.lang.Object
clone sample code for java.lang.Object.clone() definition code for java.lang.Object.clone() , equals sample code for java.lang.Object.equals(java.lang.Object) definition code for java.lang.Object.equals(java.lang.Object) , finalize sample code for java.lang.Object.finalize() definition code for java.lang.Object.finalize() , getClass sample code for java.lang.Object.getClass() definition code for java.lang.Object.getClass() , hashCode sample code for java.lang.Object.hashCode() definition code for java.lang.Object.hashCode() , notify sample code for java.lang.Object.notify() definition code for java.lang.Object.notify() , notifyAll sample code for java.lang.Object.notifyAll() definition code for java.lang.Object.notifyAll() , toString sample code for java.lang.Object.toString() definition code for java.lang.Object.toString() , wait sample code for java.lang.Object.wait() definition code for java.lang.Object.wait() , wait sample code for java.lang.Object.wait(long) definition code for java.lang.Object.wait(long) , wait sample code for java.lang.Object.wait(long, int) definition code for java.lang.Object.wait(long, int)
 

Constructor Detail

ExceptionList sample code for org.omg.CORBA.ExceptionList() definition code for org.omg.CORBA.ExceptionList()

public ExceptionList()
Method Detail

count sample code for org.omg.CORBA.ExceptionList.count() definition code for org.omg.CORBA.ExceptionList.count()

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

Returns:
the number of TypeCode objects in this ExceptionList object

add sample code for org.omg.CORBA.ExceptionList.add(org.omg.CORBA.TypeCode) definition code for org.omg.CORBA.ExceptionList.add(org.omg.CORBA.TypeCode)

public abstract void add(TypeCode sample code for org.omg.CORBA.TypeCode definition code for org.omg.CORBA.TypeCode  exc)
Adds a TypeCode object describing an exception to this ExceptionList object.

Parameters:
exc - the TypeCode object to be added

item sample code for org.omg.CORBA.ExceptionList.item(int) definition code for org.omg.CORBA.ExceptionList.item(int)

public abstract TypeCode sample code for org.omg.CORBA.TypeCode definition code for org.omg.CORBA.TypeCode  item(int index)
                       throws Bounds sample code for org.omg.CORBA.Bounds definition code for org.omg.CORBA.Bounds 
Returns the TypeCode object at the given index. The first item is at index 0.

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.
Returns:
the TypeCode object at the given index
Throws:
Bounds sample code for org.omg.CORBA.Bounds definition code for org.omg.CORBA.Bounds - if the index given is greater than or equal to the number of TypeCode objects in this ExceptionList object

remove sample code for org.omg.CORBA.ExceptionList.remove(int) definition code for org.omg.CORBA.ExceptionList.remove(int)

public abstract void remove(int index)
                     throws Bounds sample code for org.omg.CORBA.Bounds definition code for org.omg.CORBA.Bounds 
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:
Bounds sample code for org.omg.CORBA.Bounds definition code for org.omg.CORBA.Bounds - if the index is greater than or equal to the number of TypeCode objects in this ExceptionList object