/[classpath]/classpath/org/omg/CORBA/package.html
ViewVC logotype

Diff of /classpath/org/omg/CORBA/package.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.1 by audriusa, Sun May 15 01:09:29 2005 UTC revision 1.2 by audriusa, Fri May 27 16:16:01 2005 UTC
# Line 40  exception statement from your version. - Line 40  exception statement from your version. -
40  <head><title>GNU Classpath - org.omg.CORBA</title></head>  <head><title>GNU Classpath - org.omg.CORBA</title></head>
41    
42  <body>  <body>
43  This package will provide the support of <a href="www.omg.org">OMG</a> <a href="www.CORBA.org">CORBA</a>; see <a href="#overview">overview</a> of the implemented functionality. CORBA is an open, vendor independent system that applications use to work together over networks.  Thie purpose of this package is to provide CORBA APIs to java programming language, including the fully functional Object Request Broker ({@link org.omg.CORBA.ORB}).  This package provides the support of <a href="www.omg.org">OMG</a>
44    <a href="www.CORBA.org">CORBA</a>; see <a href="#overview">overview</a>
45    of the implemented functionality. CORBA is an open, vendor independent
46    system that applications use to work together over networks.  Thie purpose
47    of this package is to provide CORBA APIs to java programming language,
48    including the fully functional Object Request Broker ({@link org.omg.CORBA.ORB}).
49    
50  <a name="overview">  <a name="overview">
51  <h4>Overview of the currently <u>implemented</u> CORBA classes (all packages)</h4>  <h4>Overview of the currently implemented CORBA functionality</h4>
52  <ol>  <p>The CORBA implementation in the Classpath project is now a working prototype.
53  <li>The <b>holder</b> classes are containers to store and pass values both to and from the method being executed. In java, the primitive types (int, boolean, etc) are passed by value (one way) only. While Objects are passed by reference, some of them (like String or Integer) are unmodifyable and the arrays cannot be resized. To work around this, such values are passed wrapped into a holder class, where the object instance can be modified and, if needed, replaced. The holders for the most of the types are located in the org.omg.CORBA package, having the suffix *Holder and implementing {@link org.omg.CORBA.portable.Streamable}.   This prototype is interoperable with Sun's implementation v 1.4, transferring
54  </li><li>   object references, primitive types, narrow and wide strings, arrays, structures
55  The <b>helper</b> classes, having suffix *Helper, provide several convenience methods to manipulate the particular type of holder.   and trees between these two platforms. The thrown exceptions are also transferred
56  </li><li>   and handled. The support for stringified object references (IORs) is implemented.
57  The <b>typecode</b> classes provide means to define all large variety of the CORBA types, from strings and arrays till structures, unions and enumerations. The typecodes (instances of the {@link org.omg.CORBA.TypeCode}) are created by invoking the methods of the ORB class. The instance of the restricted ORB (no networking) can be obtained by invoking  {@link org.omg.CORBA.ORB#init()}. The typecodes can be used everywhere where the means to define data structures are required.   The redirection commands works.
58  </li><li>   You can use both request-oriented (based on {@link org.omg.CORBA.Request})
59  The {@link org.omg.CORBA.Any} class is be used as a container to store the arbitray data type and has the numerous methods for inserting and extracting all primitive types, supported by CORBA. The {@link org.omg.CORBA.Any} is a convienient structure for storing, and passing and returning the values of the arbitrary type.   and stream-oriented (based on {@link org.omg.CORBA.portable.ObjectImpl})
60  </li><li>   invocation models. The current release includes the working examples, demonstrating
61  The <b>CDR</b> (Commond Data Representation) streams, {@link org.omg.CORBA.portable.InputStream} and {@link org.omg.CORBA.portable.OutputStream}) are very much like DataInputStream and DataOutputStream in java.io. They read and write data in the binary form, standard for the CORBA messages. The working instances of these abstract classes can be obtained by calling methods on {@link org.omg.CORBA.ORB} or {@link org.omg.CORBA.Any}.   the client-server communication using both methods. These examples also show,
62  </li>   how to use the Classpath naming service. The IDL compiler is not yet written,
63  </ol>   but as a side effect of the required compatibility, the implementation seems
64     accepting the output of the Sun's 1.3 idlj.</p>
65    
66  </body>  </body>
67  </html>  </html>
68    

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.2

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26