📄 orb.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc on Thu Apr 27 23:43:13 PDT 2000 --><TITLE>Java 2 Platform SE v1.3: Class ORB</TITLE><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"></HEAD><BODY BGCOLOR="white"><!-- ========== START OF NAVBAR ========== --><A NAME="navbar_top"><!-- --></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_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> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/ORB.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Std. Ed. v1.3</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../org/omg/CORBA/OctetSeqHolder.html"><B>PREV CLASS</B></A> <A HREF="../../../org/omg/CORBA/PolicyHelper.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> <A HREF="ORB.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: INNER | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD></TR></TABLE><!-- =========== END OF NAVBAR =========== --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">org.omg.CORBA</FONT><BR>Class ORB</H2><PRE><A HREF="../../../java/lang/Object.html">java.lang.Object</A> | +--<B>org.omg.CORBA.ORB</B></PRE><DL><DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../org/omg/CORBA_2_3/ORB.html">ORB</A></DD></DL><HR><DL><DT>public abstract class <B>ORB</B><DT>extends <A HREF="../../../java/lang/Object.html">Object</A></DL><P>A class providing APIs for the CORBA Object Request Broker features. The <code>ORB</code> class also provides "pluggable ORB implementation" APIs that allow another vendor's ORB implementation to be used. <P> An ORB makes it possible for CORBA objects to communicate with each other by connecting objects making requests (clients) with objects servicing requests (servers). <P> The <code>ORB</code> class, which encapsulates generic CORBA functionality, does the following: (Note that items 5 and 6, which include most of the methods in the class <code>ORB</code>, are typically used with the <code>Dynamic Invocation Interface</code> (DII) and the <code>Dynamic Skeleton Interface</code> (DSI). These interfaces may be used by a developer directly, but most commonly they are used by the ORB internally and are not seen by the general programmer.) <OL> <li> initializes the ORB implementation by supplying values for predefined properties and environmental parameters <li> obtains initial object references to services such as the NameService using the method <code>resolve_initial_references</code> <li> converts object references to strings and back <li> connects the ORB to a servant (an instance of a CORBA object implementation) and disconnects the ORB from a servant <li> creates objects such as <ul> <li><code>TypeCode</code> <li><code>Any</code> <li><code>NamedValue</code> <li><code>Context</code> <li><code>Environment</code> <li>lists (such as <code>NVList</code>) containing these objects </ul> <li> sends multiple messages in the DII </OL> <P> The <code>ORB</code> class can be used to obtain references to objects implemented anywhere on the network. <P> An application or applet gains access to the CORBA environment by initializing itself into an <code>ORB</code> using one of three <code>init</code> methods. Two of the three methods use the properties (associations of a name with a value) shown in the table below.<BR> <TABLE BORDER> <TR><TH>Property Name</TH> <TH>Property Value</TH></TR> <CAPTION>Standard Java CORBA Properties:</CAPTION> <TR><TD>org.omg.CORBA.ORBClass</TD> <TD>class name of an ORB implementation</TD></TR> <TR><TD>org.omg.CORBA.ORBSingletonClass</TD> <TD>class name of the ORB returned by <code>init()</code></TD></TR> </TABLE> <P> These properties allow a different vendor's <code>ORB</code> implementation to be "plugged in." <P> When an ORB instance is being created, the class name of the ORB implementation is located using the following standard search order:<P> <OL> <LI>check in Applet parameter or application string array, if any <LI>check in properties parameter, if any <LI>check in the System properties <LI>check in the orb.properties file located in the java.home/lib directory <LI>fall back on a hardcoded default behavior (use the Java IDL implementation) </OL> <P> Note that Java IDL provides a default implementation for the fully-functional ORB and for the Singleton ORB. When the method <code>init</code> is given no parameters, the default Singleton ORB is returned. When the method <code>init</code> is given parameters but no ORB class is specified, the Java IDL ORB implementation is returned. <P> The following code fragment creates an <code>ORB</code> object initialized with the default ORB Singleton. This ORB has a restricted implementation to prevent malicious applets from doing anything beyond creating typecodes. It is called a singleton because there is only one instance for an entire virtual machine. <PRE> ORB orb = ORB.init(); </PRE> <P> The following code fragment creates an <code>ORB</code> object for an application. The parameter <code>args</code> represents the arguments supplied to the application's <code>main</code> method. Since the property specifies the ORB class to be "SomeORBImplementation", the new ORB will be initialized with that ORB implementation. If p had been null, and the arguments had not specified an ORB class, the new ORB would have been initialized with the default Java IDL implementation. <PRE> Properties p = new Properties(); p.put("org.omg.CORBA.ORBClass", "SomeORBImplementation"); ORB orb = ORB.init(args, p); </PRE> <P> The following code fragment creates an <code>ORB</code> object for the applet supplied as the first parameter. If the given applet does not specify an ORB class, the new ORB will be initialized with the default Java IDL implementation. <PRE> ORB orb = ORB.init(myApplet, null); </PRE> <P> An application or applet can be initialized in one or more ORBs. ORB initialization is a bootstrap call into the CORBA world.<P><DL><DT><B>Since: </B><DD>JDK1.2</DD></DL><HR><P><!-- ======== INNER CLASS SUMMARY ======== --><!-- =========== FIELD SUMMARY =========== --><!-- ======== CONSTRUCTOR SUMMARY ======== --><A NAME="constructor_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Constructor Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="../../../org/omg/CORBA/ORB.html#ORB()">ORB</A></B>()</CODE><BR> </TD></TR></TABLE> <!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Method Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../org/omg/CORBA/ORB.html#connect(org.omg.CORBA.Object)">connect</A></B>(<A HREF="../../../org/omg/CORBA/Object.html">Object</A> obj)</CODE><BR> Connects the given servant object (a Java object that is an instance of the server implementation class) to the ORB.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../org/omg/CORBA/TypeCode.html">TypeCode</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../org/omg/CORBA/ORB.html#create_abstract_interface_tc(java.lang.String, java.lang.String)">create_abstract_interface_tc</A></B>(<A HREF="../../../java/lang/String.html">String</A> id, <A HREF="../../../java/lang/String.html">String</A> name)</CODE><BR> Create a <code>TypeCode</code> object for an IDL abstract interface.</TD>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -