< prev index next >

src/java.corba/share/classes/org/omg/CORBA/ServerRequest.java

Print this page




 231      *
 232      * @param any an <code>Any</code> object containing the return value to be set
 233      * @see <a href="package-summary.html#unimpl"><code>CORBA</code>
 234      *      package comments for unimplemented features</a>
 235      */
 236     public void set_result(org.omg.CORBA.Any any)
 237     {
 238         throw new org.omg.CORBA.NO_IMPLEMENT();
 239     }
 240 
 241 
 242     /**
 243      * The DIR may call set_exception at any time to return an exception to the
 244      * client. The Any passed to set_exception must contain either a system
 245      * exception or a user exception specified in the raises expression
 246      * of the invoked operation's IDL definition. Passing in an Any that does
 247      * not
 248      * contain an exception will result in a BAD_PARAM system exception. Passing
 249      * in an unlisted user exception will result in either the DIR receiving a
 250      * BAD_PARAM system exception or in the client receiving an
 251      * UNKNOWN_EXCEPTION system exception.
 252      *
 253      * @param any       the <code>Any</code> object containing the exception
 254      * @deprecated use set_exception()
 255      */
 256     @Deprecated
 257     public void except(Any any)
 258     {
 259         set_exception(any);
 260     }
 261 
 262     /**
 263      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception.
 264      * <P>
 265      * Returns the given exception to the client.  This method
 266      * is invoked by the DIR, which may call it at any time.
 267      * The <code>Any</code> object  passed to this method must
 268      * contain either a system
 269      * exception or one of the user exceptions specified in the
 270      * invoked operation's IDL definition. Passing in an
 271      * <code>Any</code> object that does not contain an exception
 272      * will cause a BAD_PARAM system exception to be thrown. Passing
 273      * in an unlisted user exception will result in either the DIR receiving a
 274      * BAD_PARAM system exception or in the client receiving an
 275      * UNKNOWN_EXCEPTION system exception.
 276      *
 277      * @param any       the <code>Any</code> object containing the exception
 278      * @exception BAD_PARAM if the given <code>Any</code> object does not
 279      *                      contain an exception or the exception is an
 280      *                      unlisted user exception
 281      * @exception UNKNOWN_EXCEPTION if the given exception is an unlisted
 282      *                              user exception and the DIR did not
 283      *                              receive a BAD_PARAM exception
 284      * @see <a href="package-summary.html#unimpl"><code>CORBA</code>
 285      *      package comments for unimplemented features</a>
 286      */
 287     public void set_exception(Any any)
 288     {
 289         throw new org.omg.CORBA.NO_IMPLEMENT();
 290     }
 291 
 292     /**
 293      * Returns the context information specified in IDL for the operation
 294      * when the operation is not an attribute access and the operation's IDL
 295      * definition contains a context expression; otherwise it returns
 296      * a nil <code>Context</code> reference. Calling the method
 297      * <code>ctx</code> before the method <code>arguments</code> has
 298      * been called or after the method <code>ctx</code>,
 299      * <code>set_result</code>, or <code>set_exception</code>
 300      * has been called will result in a
 301      * BAD_INV_ORDER system exception.


 231      *
 232      * @param any an <code>Any</code> object containing the return value to be set
 233      * @see <a href="package-summary.html#unimpl"><code>CORBA</code>
 234      *      package comments for unimplemented features</a>
 235      */
 236     public void set_result(org.omg.CORBA.Any any)
 237     {
 238         throw new org.omg.CORBA.NO_IMPLEMENT();
 239     }
 240 
 241 
 242     /**
 243      * The DIR may call set_exception at any time to return an exception to the
 244      * client. The Any passed to set_exception must contain either a system
 245      * exception or a user exception specified in the raises expression
 246      * of the invoked operation's IDL definition. Passing in an Any that does
 247      * not
 248      * contain an exception will result in a BAD_PARAM system exception. Passing
 249      * in an unlisted user exception will result in either the DIR receiving a
 250      * BAD_PARAM system exception or in the client receiving an
 251      * UNKNOWN system exception.
 252      *
 253      * @param any       the <code>Any</code> object containing the exception
 254      * @deprecated use set_exception()
 255      */
 256     @Deprecated
 257     public void except(Any any)
 258     {
 259         set_exception(any);
 260     }
 261 
 262     /**
 263      * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception.
 264      * <P>
 265      * Returns the given exception to the client.  This method
 266      * is invoked by the DIR, which may call it at any time.
 267      * The <code>Any</code> object  passed to this method must
 268      * contain either a system
 269      * exception or one of the user exceptions specified in the
 270      * invoked operation's IDL definition. Passing in an
 271      * <code>Any</code> object that does not contain an exception
 272      * will cause a BAD_PARAM system exception to be thrown. Passing
 273      * in an unlisted user exception will result in either the DIR receiving a
 274      * BAD_PARAM system exception or in the client receiving an
 275      * UNKNOWN system exception.
 276      *
 277      * @param any       the <code>Any</code> object containing the exception
 278      * @exception BAD_PARAM if the given <code>Any</code> object does not
 279      *                      contain an exception or the exception is an
 280      *                      unlisted user exception
 281      * @exception UNKNOWN if the given exception is an unlisted
 282      *                              user exception and the DIR did not
 283      *                              receive a BAD_PARAM exception
 284      * @see <a href="package-summary.html#unimpl"><code>CORBA</code>
 285      *      package comments for unimplemented features</a>
 286      */
 287     public void set_exception(Any any)
 288     {
 289         throw new org.omg.CORBA.NO_IMPLEMENT();
 290     }
 291 
 292     /**
 293      * Returns the context information specified in IDL for the operation
 294      * when the operation is not an attribute access and the operation's IDL
 295      * definition contains a context expression; otherwise it returns
 296      * a nil <code>Context</code> reference. Calling the method
 297      * <code>ctx</code> before the method <code>arguments</code> has
 298      * been called or after the method <code>ctx</code>,
 299      * <code>set_result</code>, or <code>set_exception</code>
 300      * has been called will result in a
 301      * BAD_INV_ORDER system exception.
< prev index next >