serverrequest.html

API資料大全

 attributes are <code>_get_&lt;attribute_name&gt;</code>
 and <code>_set_&lt;attribute_name&gt;</code>,
 respectively.<DD><DL>
<DT><B>Returns:</B><DD>the name of the operation to be invoked</DL>
</DD>
</DL>
<HR>

<A NAME="operation()"><!-- --></A><H3>
operation</H3>
<PRE>
public <A HREF="../../../java/lang/String.html">String</A> <B>operation</B>()</PRE>
<DL>
<DD>Retrieves the name of the operation being
 invoked. According to OMG IDL's rules, these names must be unique
 among all operations supported by this object's "most-derived"
 interface. Note that the operation names for getting and setting
 attributes are _get_<attribute_name> and _set_<attribute_name>,
 respectively.<DD><DL>
<DT><B>Returns:</B><DD>the name of the operation to be invoked<DT><B>See Also: </B><DD><a href="package-summary.html#unimpl"><code>CORBA</code>
      package comments for unimplemented features</a></DL>
</DD>
</DL>
<HR>

<A NAME="params(org.omg.CORBA.NVList)"><!-- --></A><H3>
params</H3>
<PRE>
public void <B>params</B>(<A HREF="../../../org/omg/CORBA/NVList.html">NVList</A>&nbsp;params)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>use the method <code>arguments</code></I>
<P>
<DD>Specifies method parameter types and retrieves "in" and "inout"
 argument values.
 <P>
 Note that this method is deprecated; use the method
 <code>arguments</code> in its place.
 <P>
 Unless it calls the method <code>set_exception</code>,
 the DIR must call this method exactly once, even if the
 method signature contains no parameters. Once the method <code>
 arguments</code> or <code>set_exception</code>
 has been called, calling <code>arguments</code> on the same
 <code>ServerRequest</code> object 
 will result in a <code>BAD_INV_ORDER</code> system exception.
 The DIR must pass in to the method <code>arguments</code>
 an NVList initialized with TypeCodes and Flags
 describing the parameter types for the operation, in the order in which
 they appear in the IDL specification (left to right). A
 potentially-different NVList will be returned from
 <code>arguments</code>, with the
 "in" and "inout" argument values supplied. If it does not call
 the method <code>set_exception</code>,
 the DIR must supply the returned NVList with return
 values for any "out" arguments before returning, and may also change
 the return values for any "inout" arguments.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>params</CODE> - the arguments of the method, in the
				form of an <code>NVList</code> object</DL>
</DD>
</DL>
<HR>

<A NAME="arguments(org.omg.CORBA.NVList)"><!-- --></A><H3>
arguments</H3>
<PRE>
public void <B>arguments</B>(<A HREF="../../../org/omg/CORBA/NVList.html">NVList</A>&nbsp;args)</PRE>
<DL>
<DD>Specifies method parameter types and retrieves "in" and "inout"
 argument values.
 Unless it calls the method <code>set_exception</code>,
 the DIR must call this method exactly once, even if the
 method signature contains no parameters. Once the method <code>
 arguments</code> or <code>set_exception</code>
 has been called, calling <code>arguments</code> on the same
 <code>ServerRequest</code> object 
 will result in a <code>BAD_INV_ORDER</code> system exception.
 The DIR must pass in to the method <code>arguments</code>
 an NVList initialized with TypeCodes and Flags
 describing the parameter types for the operation, in the order in which
 they appear in the IDL specification (left to right). A
 potentially-different NVList will be returned from
 <code>arguments</code>, with the
 "in" and "inout" argument values supplied. If it does not call
 the method <code>set_exception</code>,
 the DIR must supply the returned NVList with return
 values for any "out" arguments before returning, and it may also change
 the return values for any "inout" arguments.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>args</CODE> - the arguments of the method, in the
                            form of an NVList<DT><B>See Also: </B><DD><a href="package-summary.html#unimpl"><code>CORBA</code>
      package comments for unimplemented features</a></DL>
</DD>
</DL>
<HR>

<A NAME="result(org.omg.CORBA.Any)"><!-- --></A><H3>
result</H3>
<PRE>
public void <B>result</B>(<A HREF="../../../org/omg/CORBA/Any.html">Any</A>&nbsp;any)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>use the method <code>set_result</code></I>
<P>
<DD>Specifies any return value for the call. 
 <P>
 Note that this method is deprecated; use the method
 <code>set_result</code> in its place.
 <P>
 Unless the method 
 <code>set_exception</code> is called, if the invoked method
 has a non-void result type, the method <code>set_result</code>
 must be called exactly once before the DIR returns.
 If the operation has a void result type, the method 
 <code>set_result</code> may optionally be
 called once with an <code>Any</code> object whose type is 
 <code>tk_void</code>. Calling the method <code>set_result</code> before
 the method <code>arguments</code> has been called or after
 the method <code>set_result</code> or <code>set_exception</code> has been
 called will result in a BAD_INV_ORDER exception. Calling the method
 <code>set_result</code> without having previously called
 the method <code>ctx</code> when the IDL operation contains a
 context expression, or when the NVList passed to arguments did not
 describe all parameters passed by the client, may result in a MARSHAL
 system exception.</DL>
<HR>

<A NAME="set_result(org.omg.CORBA.Any)"><!-- --></A><H3>
set_result</H3>
<PRE>
public void <B>set_result</B>(<A HREF="../../../org/omg/CORBA/Any.html">Any</A>&nbsp;any)</PRE>
<DL>
<DD>Specifies any return value for the call. Unless the method 
 <code>set_exception</code> is called, if the invoked method
 has a non-void result type, the method <code>set_result</code>
 must be called exactly once before the DIR returns.
 If the operation has a void result type, the method 
 <code>set_result</code> may optionally be
 called once with an <code>Any</code> object whose type is 
 <code>tk_void</code>. Calling the method <code>set_result</code> before
 the method <code>arguments</code> has been called or after
 the method <code>set_result</code> or <code>set_exception</code> has been
 called will result in a BAD_INV_ORDER exception. Calling the method
 <code>set_result</code> without having previously called
 the method <code>ctx</code> when the IDL operation contains a
 context expression, or when the NVList passed to arguments did not
 describe all parameters passed by the client, may result in a MARSHAL
 system exception.<DD><DL>
<DT><B>See Also: </B><DD><a href="package-summary.html#unimpl"><code>CORBA</code>
      package comments for unimplemented features</a></DL>
</DD>
</DL>
<HR>

<A NAME="except(org.omg.CORBA.Any)"><!-- --></A><H3>
except</H3>
<PRE>
public void <B>except</B>(<A HREF="../../../org/omg/CORBA/Any.html">Any</A>&nbsp;any)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<I>use set_exception()</I>
<P>
<DD>The DIR may call set_exception at any time to return an exception to the
 client. The Any passed to set_exception must contain either a system
 exception or a user exception specified in the raises expression
 of the invoked operation's IDL definition. Passing in an Any that does
 not
 contain an exception will result in a BAD_PARAM system exception. Passing
 in an unlisted user exception will result in either the DIR receiving a
 BAD_PARAM system exception or in the client receiving an
 UNKNOWN_EXCEPTION system exception.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>any</CODE> - the <code>Any</code> object containing the exception</DL>
</DD>
</DL>
<HR>

<A NAME="set_exception(org.omg.CORBA.Any)"><!-- --></A><H3>
set_exception</H3>
<PRE>
public void <B>set_exception</B>(<A HREF="../../../org/omg/CORBA/Any.html">Any</A>&nbsp;any)</PRE>
<DL>
<DD>Returns the given exception to the client.  This method 
 is invoked by the DIR, which may call it at any time.
 The <code>Any</code> object  passed to this method must
 contain either a system
 exception or one of the user exceptions specified in the 
 invoked operation's IDL definition. Passing in an
 <code>Any</code> object that does not contain an exception 
 will cause a BAD_PARAM system exception to be thrown. Passing
 in an unlisted user exception will result in either the DIR receiving a
 BAD_PARAM system exception or in the client receiving an
 UNKNOWN_EXCEPTION system exception.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>any</CODE> - the <code>Any</code> object containing the exception<DT><B>Throws:</B><DD><CODE><A HREF="../../../org/omg/CORBA/BAD_PARAM.html">BAD_PARAM</A></CODE> - if the given <code>Any</code> object does not
                      contain an exception or the exception is an
                      unlisted user exception<DD><CODE>UNKNOWN_EXCEPTION</CODE> - if the given exception is an unlisted
                              user exception and the DIR did not
                              receive a BAD_PARAM exception<DT><B>See Also: </B><DD><a href="package-summary.html#unimpl"><code>CORBA</code>
      package comments for unimplemented features</a></DL>
</DD>
</DL>
<HR>

<A NAME="ctx()"><!-- --></A><H3>
ctx</H3>
<PRE>
public abstract <A HREF="../../../org/omg/CORBA/Context.html">Context</A> <B>ctx</B>()</PRE>
<DL>
<DD>Returns the context information specified in IDL for the operation
 when the operation is not an attribute access and the operation's IDL
 definition contains a context expression; otherwise it returns
 a nil <code>Context</code> reference. Calling the method
 <code>ctx</code> before the method <code>arguments</code> has
 been called or after the method <code>ctx</code>,
 <code>set_result</code>, or <code>set_exception</code>
 has been called will result in a
 BAD_INV_ORDER system exception.<DD><DL>
<DT><B>Returns:</B><DD>the context object that is to be used
				to resolve any context strings whose
				values need to be sent with the invocation.<DT><B>Throws:</B><DD><CODE><A HREF="../../../org/omg/CORBA/BAD_INV_ORDER.html">BAD_INV_ORDER</A></CODE> - if (1) the method <code>ctx</code> is called
                          before the method <code>arguments</code> or
                          (2) the method <code>ctx</code> is called
                          after calling <code>set_result</code> or
                          <code>set_exception</code></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/ServerRequest.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Std.&nbsp;Ed. v1.3</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../org/omg/CORBA/Request.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../org/omg/CORBA/ServiceDetail.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="ServerRequest.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1"><a href="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a><br>For further API reference and developer documentation, see <a href="http://java.sun.com/products/jdk/1.3/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation  contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. <p>Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road<br>Palo Alto, California, 94303, U.S.A.  All Rights Reserved.</font>
</BODY>
</HTML>