1. /*

  2.  * @(#)Environment.java	1.19 00/02/02

  3.  *

  4.  * Copyright 1996-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. package org.omg.CORBA;

  12. 

  13. /**

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

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

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

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

  18.  *

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

  20.  * @since   JDK1.2

  21.  */

  22. 

  23. public abstract class Environment {

  24. 

  25.     /**

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

  27.      *

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

  29.      */

  30. 

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

  32. 

  33.     /**

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

  35.      *

  36.      * @param except		the exception to be set

  37.      */

  38. 

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

  40. 

  41.     /**

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

  43.      */

  44. 

  45.     public abstract void clear();

  46. 

  47. }