package-summary.html

API資料大全

</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="INV_FLAG.html">INV_FLAG</A></B></TD>
<TD>The CORBA <code>INV_FLAG</code> exception, which is thrown
 when an invalid flag is specified.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="INV_IDENT.html">INV_IDENT</A></B></TD>
<TD>The CORBA <code>INV_IDENT</code> exception, which is thrown
 when identifier syntax is invalid.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="INV_OBJREF.html">INV_OBJREF</A></B></TD>
<TD>The CORBA <code>INV_OBJREF</code> exception, which is thrown
 when an invalid object reference is specified.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="INV_POLICY.html">INV_POLICY</A></B></TD>
<TD>The CORBA <code>INV_POLICY</code> standard exception, which is thrown
 when an invocation cannot be made because of an incompatibility between 
 Policy overrides.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="INVALID_TRANSACTION.html">INVALID_TRANSACTION</A></B></TD>
<TD>The CORBA <code>INVALID_TRANSACTION</code> exception, which is thrown
 when there is a transaction error.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="MARSHAL.html">MARSHAL</A></B></TD>
<TD>The CORBA <code>MARSHAL</code> exception, which is thrown
 when the ORB has a problem marshalling or unmarshalling parameters.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NO_IMPLEMENT.html">NO_IMPLEMENT</A></B></TD>
<TD>The CORBA <code>NO_IMPLEMENT</code> exception, which is thrown
 when the implementation for a method is not available.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NO_MEMORY.html">NO_MEMORY</A></B></TD>
<TD>The CORBA <code>NO_MEMORY</code> exception, which may be thrown
 by either the client or the server
 when there is not enough memory for a dynamic memory allocation.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NO_PERMISSION.html">NO_PERMISSION</A></B></TD>
<TD>The CORBA <code>NO_PERMISSION</code> exception, which is thrown
 if the client does not have permission to perform the request.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NO_RESOURCES.html">NO_RESOURCES</A></B></TD>
<TD>The CORBA <code>NO_RESOURCES</code> exception, which is thrown
 when either the client or the server does not have sufficient resources
 to perform the request.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="NO_RESPONSE.html">NO_RESPONSE</A></B></TD>
<TD>The CORBA <code>NO_RESPONSE</code> exception, which is thrown
 when a response to the request is not yet available.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="OBJ_ADAPTER.html">OBJ_ADAPTER</A></B></TD>
<TD>The CORBA <code>OBJ_ADAPTER</code> exception, which is thrown
 by the object adapter on the server to indicate some error.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="OBJECT_NOT_EXIST.html">OBJECT_NOT_EXIST</A></B></TD>
<TD>The CORBA <code>OBJECT_NOT_EXIST</code> exception, which is usually thrown
 from the server to indicate that the target object does not exist.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="PERSIST_STORE.html">PERSIST_STORE</A></B></TD>
<TD>The CORBA <code>PERSIST_STORE</code> exception, which is thrown
 when there is an error with the persistent storage on the server.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="PolicyError.html">PolicyError</A></B></TD>
<TD>An exception carrying one of the following policy error reason codes
 defined in the org.omg.CORBA package: 
 BAD_POLICY, BAD_POLICY_TYPE, BAD_POLICY_VALUE, UNSUPPORTED_POLICY, UNSUPPORTED_POLICY_VALUE</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="SystemException.html">SystemException</A></B></TD>
<TD>The root class for all CORBA standard exceptions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="TRANSACTION_REQUIRED.html">TRANSACTION_REQUIRED</A></B></TD>
<TD>The CORBA <code>TRANSACTION_REQUIRED</code> exception, which is thrown
 by the ORB on the client or server during the
 processing of a request that
 is required to be enclosed in a transaction.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="TRANSACTION_ROLLEDBACK.html">TRANSACTION_ROLLEDBACK</A></B></TD>
<TD>The CORBA <code>TRANSACTION_ROLLEDBACK</code> exception, which is thrown
 when a transactional operation did not complete
 because the transaction was rolled back.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="TRANSIENT.html">TRANSIENT</A></B></TD>
<TD>The CORBA <code>TRANSIENT</code> exception, which is thrown
 by the server to signal a transient failure
 that might not occur again if the request is retried.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="UNKNOWN.html">UNKNOWN</A></B></TD>
<TD>The CORBA <code>UNKNOWN</code> exception, which is thrown when there is
 an error whose cause is unknown to the ORB.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="UnknownUserException.html">UnknownUserException</A></B></TD>
<TD>A class that contains user exceptions returned by the server.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="UserException.html">UserException</A></B></TD>
<TD>The root class for CORBA IDL-defined user exceptions.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="WrongTransaction.html">WrongTransaction</A></B></TD>
<TD>The CORBA <code>WrongTransaction</code> user-defined exception.</TD>
</TR>
</TABLE>
&nbsp;

<P>
<A NAME="package_description"><!-- --></A><H2>
Package org.omg.CORBA Description
</H2>

<P>
Provides the mapping of the OMG CORBA APIs to the Java<SUP><FONT SIZE=-2>TM</FONT></SUP>
programming language, including the class <TT>ORB</TT>, which is implemented
so that a programmer can use it as a fully-functional Object Request Broker
(ORB).

<P>An ORB handles (or brokers) method invocations between a client and
the method's implementation on a server. Because the client and server
may be anywhere on a network, and because the invocation and implementation
may be written in different programming languages, an ORB does a great
deal of work behind the scenes to accomplish this communication.
<H2>
What the General User Needs to Know</H2>
Most of what an ORB does is completely transparent to the user, and a major
portion of the <TT>CORBA</TT> package consists of classes used by the ORB
behind the scenes. The result is that most programmers will use only a
small part of this package directly. In fact, most programmers will use
only a few methods from the <TT>ORB</TT> class, some exceptions, and occasionally,
a holder class.
<H3>
<TT>ORB</TT> Methods</H3>
These are the <TT>ORB</TT> methods that a general user might invoke:
<UL>
<LI>
<TT><bold>connect</bold>()</TT>

<LI>
<TT><bold>disconnect</bold>()</TT>

<LI>
<TT><bold>init</bold>()</TT>

<LI>
<TT><bold>init</bold>(String [] args, Properties props)</TT>

<LI>
<TT><bold>init</bold>(Applet app, Properties props)</TT>

<LI>
<TT><bold>list_initial_services</bold>()</TT>

<LI>
<TT><bold>resolve_initial_references</bold>(String name)</TT>

<LI>
<TT><bold>object_to_string</bold>(Object obj)</TT>

<LI>
<TT><bold>string_to_object</bold>(String str)</TT>
</UL>

<H3>
Exceptions</H3>
Exceptions in Java IDL are similar to those in any code written in the
Java programming language. If a method is defined to throw an exception,
then any code using that method must have a <TT>try</TT>/<TT>catch</TT>
block and handle that exception when it is thrown.

<P>The documentation on <A HREF="../../../../guide/idl/jidlExceptions.html">Java
IDL exceptions</A> has more information and explains the difference between
system exceptions and user-defined exceptions.

<P>The following is a list of the system exceptions (which are unchecked
exceptions inheriting through <TT>org.omg.CORBA.SystemException</TT> from
<TT>java.lang.RuntimeException</TT>) that are defined in the package <TT>org.omg.CORBA</TT>:
<PRE><code>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; BAD_CONTEXT
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; BAD_INV_ORDER
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; BAD_OPERATION
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; BAD_PARAM
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; BAD_TYPECODE
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; COMM_FAILURE
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; DATA_CONVERSION
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; FREE_MEM
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; IMP_LIMIT
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INITIALIZE
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INTERNAL
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INTF_REPOS
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INVALID_TRANSACTION
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INV_FLAG
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INV_IDENT
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INV_OBJREF
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; INV_POLICY
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; MARSHAL
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; NO_IMPLEMENT
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; NO_MEMORY
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; NO_PERMISSION
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; NO_RESOURCES
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; NO_RESPONSE
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; OBJECT_NOT_EXIST
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; OBJ_ADAPTER
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PERSIST_STORE
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; TRANSACTION_REQUIRED
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; TRANSACTION_ROLLEDBACK
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; TRANSIENT
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; UNKNOWN
</code></PRE>
<P>
The following is a list of user-defined exceptions defined in the package
<TT>org.omg.CORBA</TT>.
<PRE><code>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Bounds
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; UnknownUserException
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; WrongTransaction&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; PolicyError
</code></PRE>
Note that there are some packages inside the <TT>CORBA</TT> package with
"Package" as part of their names. These packages are generally quite small
because all they do is provide exceptions or classes for use by interfaces
and classes in the <TT>CORBA</TT> package.

<P>For example, the package <TT>org.omg.CORBA.TypeCodePackage</TT> contains
two exceptions thrown by methods in the class <TT>TypeCode</TT>. These
exceptions are:
<UL>
<LI>
<TT>BadKind</TT>

<LI>
<TT>Bounds</TT>
</UL>
The package <TT>org.omg.CORBA.ORBPackage</TT> contains two exceptions:
<UL>
<LI>
<TT>InvalidName</TT>

<LI>
<TT>InconsistentTypeCode</TT>
</UL>
The package <TT>org.omg.CORBA.DynAnyPackage</TT> contains four exceptions:
<UL>
<LI>
<TT>InvalidValue</TT>, thrown by methods in

<UL>
<LI>
<TT>DynAny</TT>

<LI>
<TT>DynFixed</TT>
</UL>

<LI>
<TT>Invalid</TT>, thrown by methods in

<UL>
<LI>
<TT>DynAny</TT>
</UL>

<LI>
<TT>TypeMismatch</TT>, thrown by methods in

<UL>
<LI>
<TT>DynAny</TT>
</UL>

<LI>
<TT>InvalidSeq</TT>, thrown by methods in

<UL>
<LI>
<TT>DynArray</TT>

<LI>
<TT>DynSequence</TT>

<LI>
<TT>DynStruct</TT>

<LI>
<TT>DynValue</TT>
</UL>
</UL>