old-autovect-branch/libjava/classpath/org/omg/CORBA/package.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2 <!-- package.html
   3    Copyright (C) 2005 Free Software Foundation, Inc.
   4
   5 This file is part of GNU Classpath.
   6
   7 GNU Classpath is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2, or (at your option)
  10 any later version.
  11
  12 GNU Classpath is distributed in the hope that it will be useful, but
  13 WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GNU Classpath; see the file COPYING.  If not, write to the
  19 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  20 02110-1301 USA.
  21
  22 Linking this library statically or dynamically with other modules is
  23 making a combined work based on this library.  Thus, the terms and
  24 conditions of the GNU General Public License cover the whole
  25 combination.
  26
  27 As a special exception, the copyright holders of this library give you
  28 permission to link this library with independent modules to produce an
  29 executable, regardless of the license terms of these independent
  30 modules, and to copy and distribute the resulting executable under
  31 terms of your choice, provided that you also meet, for each linked
  32 independent module, the terms and conditions of the license of that
  33 module.  An independent module is a module which is not derived from
  34 or based on this library.  If you modify this library, you may extend
  35 this exception to your version of the library, but you are not
  36 obligated to do so.  If you do not wish to do so, delete this
  37 exception statement from your version. -->
  38
  39 <html>
  40 <head><title>GNU Classpath - org.omg.CORBA</title></head>
  41
  42 <body>
  43 This package provides the support of <a href="http://www.CORBA.org">CORBA</a>;
  44 see <a href="#overview">overview</a> of the implemented functionality.
  45 <p>
  46 CORBA a system that applications use to work over networks. CORBA messages
  47 are binary, not text oriented. They practically cary no "data wrapping"
  48 information like XML &lt;opening&gt; &lt;/closing&gt; tags. Hence CORBA
  49 objects easier exchange large amounts of binary data. CORBA can work
  50 in such data-intensive application areas as telecommunications or radio
  51 broadcasting. Java programs connect to CORBA objects without care
  52 about what platform they run on, where they exist in the network, or what
  53 language they were written in. The remote CORBA objects appear to the
  54 programmer as the ordinary Java objects and can be passed as
  55 parameters in both remote or local method invocations.
  56 </p><p>
  57 The CORBA processing unit is divided into {@link org.omg.CORBA.Object}
  58 that is exposed to the client and the servant
  59 ({@link org.omg.PortableServer.Servant} where the method, invoked on
  60 object, is finally delegated. It can be multiple objects per servant or
  61 multiple servants per object. The servant for particular object or
  62 even particular call can be dynamically chosen at run time using
  63 {@link org.omg.PortableServer.ServantManager}.
  64 </p><p>
  65 All stages of both local and remote invocations on CORBA objects can be
  66 monitored and modified using {@link org.omg.PortableInterceptor.Interceptor}.
  67 The interceptors can add an extra data to the CORBA message (these data
  68 can be later accessed by other interceptor on remote side).
  69 </p>
  70 <a name="overview">
  71 <h4>Overview of the currently implemented CORBA functionality</h4>
  72 The CORBA implementation in the Classpath project is now a working
  73 prototype.
  74 <ul>
  75 <li>This prototype is interoperable with Sun's implementation v 1.4,
  76 transferring object references, primitive types, narrow and wide strings,
  77 arrays, structures  and trees between these two platforms.
  78 </li>
  79 <li>The prototype provides interoperable support for the Abstract interface
  80  and Value types. Those appear in 1.3, being a feature of CORBA 2.3.
  81 </li>
  82 <li>The remote exceptions are also transferred and handled as expected.
  83 </li>
  84 <li>The support for parsing stringified object references (IORs), both
  85 Big and Little Endian encoded, is implemented.
  86 </li>
  87 <li>The redirection commands works, LOCATION_FORWARD_PERM changing the
  88 target address until the application is restarted and LOCATION_FORWARD
  89 redirecting for the current session only.
  90 </li>
  91 <li>Both Little and Big Endian encoded messages are accepted. The encoding
  92 of the sent messages is the same as used in the stringified IOR reference
  93 of that object or Big Endian, if no such data available.
  94 </li>
  95 <li>You can use both request-oriented (based on {@link org.omg.CORBA.Request}
  96 and stream-oriented (based on {@link org.omg.CORBA.portable.ObjectImpl}
  97 invocation models. The current release includes the working examples,
  98 demonstrating the client-server communication using both methods.
  99 </li>
 100 <li>These examples also show,  how to use the Classpath naming service.
 101 </li>
 102 <li>The IDL compiler is not yet written (and not even started), but as a
 103  side effect of the required compatibility, the implementation seems
 104 accepting the output of the Sun's idlj.
 105 </li>
 106 <li>The Portable Object Adapter is already released. For details on POA,
 107 see the {@link org.omg.PortableServer} package.</li>
 108 <li>We provide the implementation of the {@link org.omg.DynamicAny}
 109 package. ORB returns the working DynAnyFactory that produces working
 110 DynAny's as defined in OMG specification.</li>
 111 <li>The Portable Interceptor is also complete. See
 112 {@link org.omg.PortableInterceptor} package for details how to register
 113 and use CORBA interceptors.
 114 <li>All GNU Classpath classes in omg.org namespace are newly written using
 115  the OMG .pdf document (Version 3.0.3, formal/04-03-12).
 116 </li>
 117 </ul>
 118
 119  @author Audrius Meskauskas, Lithuania (AudriusA@Bioinformatics.org)
 120 </body>
 121 </html>
 122