1. /*

  2.  * @(#)Environment.java	1.23 03/12/19

  3.  *

  4.  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.

  5.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  6.  */

  7. 

  8. package org.omg.CORBA;

  9. 

  10. /**

  11.  * A container (holder) for an exception that is used in <code>Request</code>

  12.  * operations to make exceptions available to the client.  An

  13.  * <code>Environment</code> object is created with the <code>ORB</code>

  14.  * method <code>create_environment</code>.

  15.  *

  16.  * @version 1.11, 09/09/97

  17.  * @since   JDK1.2

  18.  */

  19. 

  20. public abstract class Environment {

  21. 

  22.     /**

  23.      * Retrieves the exception in this <code>Environment</code> object.

  24.      *

  25.      * @return			the exception in this <code>Environment</code> object

  26.      */

  27. 

  28.     public abstract java.lang.Exception exception();

  29. 

  30.     /**

  31.      * Inserts the given exception into this <code>Environment</code> object.

  32.      *

  33.      * @param except		the exception to be set

  34.      */

  35. 

  36.     public abstract void exception(java.lang.Exception except);

  37. 

  38.     /**

  39.      * Clears this <code>Environment</code> object of its exception.

  40.      */

  41. 

  42.     public abstract void clear();

  43. 

  44. }