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 } 45