orb.html

API資料大全

</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.<A HREF="../../../java/lang/Object.html">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../java/lang/Object.html#clone()">clone</A>, <A HREF="../../../java/lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="../../../java/lang/Object.html#finalize()">finalize</A>, <A HREF="../../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../../java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="../../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../../java/lang/Object.html#toString()">toString</A>, <A HREF="../../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../../java/lang/Object.html#wait(long)">wait</A>, <A HREF="../../../java/lang/Object.html#wait(long, int)">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="ORB()"><!-- --></A><H3>
ORB</H3>
<PRE>
public <B>ORB</B>()</PRE>
<DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="init()"><!-- --></A><H3>
init</H3>
<PRE>
public static <A HREF="../../../org/omg/CORBA/ORB.html">ORB</A> <B>init</B>()</PRE>
<DL>
<DD>Returns the <code>ORB</code> singleton object. This method always returns the
 same ORB instance, which is an instance of the class described by the
 <code>org.omg.CORBA.ORBSingletonClass</code> system property.
 <P>
 This no-argument version of the method <code>init</code> is used primarily
 as a factory for <code>TypeCode</code> objects, which are used by
 <code>Helper</code> classes to implement the method <code>type</code>.
 It is also used to create <code>Any</code> objects that are used to
 describe <code>union</code> labels (as part of creating a <code>
 TypeCode</code> object for a <code>union</code>).
 <P>
 This method is not intended to be used by applets, and in the event
 that it is called in an applet environment, the ORB it returns
 is restricted so that it can be used only as a factory for
 <code>TypeCode</code> objects.  Any <code>TypeCode</code> objects
 it produces can be safely shared among untrusted applets.
 <P>
 If an ORB is created using this method from an applet,
 a system exception will be thrown if
 methods other than those for
 creating <code>TypeCode</code> objects are invoked.<DD><DL>
<DT><B>Returns:</B><DD>the singleton ORB</DL>
</DD>
</DL>
<HR>

<A NAME="init(java.lang.String[], java.util.Properties)"><!-- --></A><H3>
init</H3>
<PRE>
public static <A HREF="../../../org/omg/CORBA/ORB.html">ORB</A> <B>init</B>(<A HREF="../../../java/lang/String.html">String</A>[]&nbsp;args,
                       <A HREF="../../../java/util/Properties.html">Properties</A>&nbsp;props)</PRE>
<DL>
<DD>Creates a new <code>ORB</code> instance for a standalone
 application.  This method may be called from applications
 only and returns a new fully functional <code>ORB</code> object
 each time it is called.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>args</CODE> - command-line arguments for the application's <code>main</code>
             method; may be <code>null</code><DD><CODE>props</CODE> - application-specific properties; may be <code>null</code><DT><B>Returns:</B><DD>the newly-created ORB instance</DL>
</DD>
</DL>
<HR>

<A NAME="init(java.applet.Applet, java.util.Properties)"><!-- --></A><H3>
init</H3>
<PRE>
public static <A HREF="../../../org/omg/CORBA/ORB.html">ORB</A> <B>init</B>(<A HREF="../../../java/applet/Applet.html">Applet</A>&nbsp;app,
                       <A HREF="../../../java/util/Properties.html">Properties</A>&nbsp;props)</PRE>
<DL>
<DD>Creates a new <code>ORB</code> instance for an applet.  This
 method may be called from applets only and returns a new
 fully-functional <code>ORB</code> object each time it is called.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>app</CODE> - the applet; may be <code>null</code><DD><CODE>props</CODE> - applet-specific properties; may be <code>null</code><DT><B>Returns:</B><DD>the newly-created ORB instance</DL>
</DD>
</DL>
<HR>

<A NAME="set_parameters(java.lang.String[], java.util.Properties)"><!-- --></A><H3>
set_parameters</H3>
<PRE>
protected abstract void <B>set_parameters</B>(<A HREF="../../../java/lang/String.html">String</A>[]&nbsp;args,
                                       <A HREF="../../../java/util/Properties.html">Properties</A>&nbsp;props)</PRE>
<DL>
<DD>Allows the ORB implementation to be initialized with the given
 parameters and properties. This method, used in applications only,
 is implemented by subclass ORB implementations and called
 by the appropriate <code>init</code> method to pass in its parameters.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>args</CODE> - command-line arguments for the application's <code>main</code>
             method; may be <code>null</code><DD><CODE>props</CODE> - application-specific properties; may be <code>null</code></DL>
</DD>
</DL>
<HR>

<A NAME="set_parameters(java.applet.Applet, java.util.Properties)"><!-- --></A><H3>
set_parameters</H3>
<PRE>
protected abstract void <B>set_parameters</B>(<A HREF="../../../java/applet/Applet.html">Applet</A>&nbsp;app,
                                       <A HREF="../../../java/util/Properties.html">Properties</A>&nbsp;props)</PRE>
<DL>
<DD>Allows the ORB implementation to be initialized with the given
 applet and parameters. This method, used in applets only,
 is implemented by subclass ORB implementations and called
 by the appropriate <code>init</code> method to pass in its parameters.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>app</CODE> - the applet; may be <code>null</code><DD><CODE>props</CODE> - applet-specific properties; may be <code>null</code></DL>
</DD>
</DL>
<HR>

<A NAME="connect(org.omg.CORBA.Object)"><!-- --></A><H3>
connect</H3>
<PRE>
public void <B>connect</B>(<A HREF="../../../org/omg/CORBA/Object.html">Object</A>&nbsp;obj)</PRE>
<DL>
<DD>Connects the given servant object (a Java object that is
 an instance of the server implementation class)
 to the ORB. The servant class must
 extend the <code>ImplBase</code> class corresponding to the interface that is
 supported by the server. The servant must thus be a CORBA object
 reference, and inherit from <code>org.omg.CORBA.Object</code>.
 Servants created by the user can start receiving remote invocations
 after the method <code>connect</code> has been called. A servant may also be
 automatically and implicitly connected to the ORB if it is passed as
 an IDL parameter in an IDL method invocation on a non-local object,
 that is, if the servant object has to be marshalled and sent outside of the
 process address space.
 <P>
 Calling the method <code>connect</code> has no effect
 when the servant object is already connected to the ORB.
 <P>
 Deprecated by the OMG in favor of the Portable Object Adapter APIs.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>obj</CODE> - the servant object reference<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="destroy()"><!-- --></A><H3>
destroy</H3>
<PRE>
public void <B>destroy</B>()</PRE>
<DL>
<DD>Destroys the ORB instance and frees all the resources under an ORB instance.
 The method is not implemented, The API is provided to conform with the OMG
 spec.</DL>
<HR>

<A NAME="disconnect(org.omg.CORBA.Object)"><!-- --></A><H3>
disconnect</H3>
<PRE>
public void <B>disconnect</B>(<A HREF="../../../org/omg/CORBA/Object.html">Object</A>&nbsp;obj)</PRE>
<DL>
<DD>Disconnects the given servant object from the ORB. After this method returns,
 the ORB will reject incoming remote requests for the disconnected
 servant and will send the exception
 <code>org.omg.CORBA.OBJECT_NOT_EXIST</code> back to the
 remote client. Thus the object appears to be destroyed from the
 point of view of remote clients. Note, however, that local requests issued
 using the servant  directly do not
 pass through the ORB; hence, they will continue to be processed by the
 servant.
 <P>
 Calling the method <code>disconnect</code> has no effect
 if the servant is not connected to the ORB.
 <P>
 Deprecated by the OMG in favor of the Portable Object Adapter APIs.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>obj</CODE> - The servant object to be disconnected from the ORB<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="list_initial_services()"><!-- --></A><H3>
list_initial_services</H3>
<PRE>
public abstract <A HREF="../../../java/lang/String.html">String</A>[] <B>list_initial_services</B>()</PRE>
<DL>
<DD>Returns a list of the initially available CORBA object references,
 such as "NameService" and "InterfaceRepository".<DD><DL>
<DT><B>Returns:</B><DD>an array of <code>String</code> objects that represent
         the object references for CORBA services
         that are initially available with this ORB</DL>
</DD>
</DL>
<HR>

<A NAME="resolve_initial_references(java.lang.String)"><!-- --></A><H3>
resolve_initial_references</H3>
<PRE>
public abstract <A HREF="../../../org/omg/CORBA/Object.html">Object</A> <B>resolve_initial_references</B>(<A HREF="../../../java/lang/String.html">String</A>&nbsp;object_name)
                                           throws <A HREF="../../../org/omg/CORBA/ORBPackage/InvalidName.html">InvalidName</A></PRE>
<DL>
<DD>Resolves a specific object reference from the set of available
 initial service names.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>object_name</CODE> - the name of the initial service as a string<DT><B>Returns:</B><DD>the object reference associated with the given name<DT><B>Throws:</B><DD><CODE><A HREF="../../../org/omg/CORBA/ORBPackage/InvalidName.html">InvalidName</A></CODE> - if the given name is not associated with a
                         known service</DL>
</DD>
</DL>
<HR>

<A NAME="object_to_string(org.omg.CORBA.Object)"><!-- --></A><H3>
object_to_string</H3>
<PRE>
public abstract <A HREF="../../../java/lang/String.html">String</A> <B>object_to_string</B>(<A HREF="../../../org/omg/CORBA/Object.html">Object</A>&nbsp;obj)</PRE>
<DL>
<DD>Converts the given CORBA object reference to a string.
 Note that the format of this string is predefined by IIOP, allowing
 strings generated by a different ORB to be converted back into an object
 reference.
 <P>
 The resulting <code>String</code> object may be stored or communicated
 in any way that a <code>String</code> object can be manipulated.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>obj</CODE> - the object reference to stringify<DT><B>Returns:</B><DD>the string representing the object reference</DL>
</DD>
</DL>
<HR>

<A NAME="string_to_object(java.lang.String)"><!-- --></A><H3>
string_to_object</H3>
<PRE>
public abstract <A HREF="../../../org/omg/CORBA/Object.html">Object</A> <B>string_to_object</B>(<A HREF="../../../java/lang/String.html">String</A>&nbsp;str)</PRE>
<DL>
<DD>Converts a string produced by the method <code>object_to_string</code>