summaryrefslogtreecommitdiff
path: root/org/omg/CORBA/package.html
blob: 8fe9acf5d3d80ee96957c2d405e0adf3fd358672 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!-- package.html
   Copyright (C) 2005 Free Software Foundation, Inc.

This file is part of GNU Classpath.

GNU Classpath is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

GNU Classpath is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Classpath; see the file COPYING.  If not, write to the
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA.

Linking this library statically or dynamically with other modules is
making a combined work based on this library.  Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.

As a special exception, the copyright holders of this library give you
permission to link this library with independent modules to produce an
executable, regardless of the license terms of these independent
modules, and to copy and distribute the resulting executable under
terms of your choice, provided that you also meet, for each linked
independent module, the terms and conditions of the license of that
module.  An independent module is a module which is not derived from
or based on this library.  If you modify this library, you may extend
this exception to your version of the library, but you are not
obligated to do so.  If you do not wish to do so, delete this
exception statement from your version. -->

<html>
<head><title>GNU Classpath - org.omg.CORBA</title></head>

<body>
This package provides 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}). 

<a name="overview">
<h4>Overview of the currently implemented CORBA functionality</h4>
<p>The CORBA implementation in the Classpath project is now a working prototype.
 This prototype is interoperable with Sun's implementation v 1.4, transferring 
 object references, primitive types, narrow and wide strings, arrays, structures 
 and trees between these two platforms. The thrown exceptions are also transferred 
 and handled. The support for stringified object references (IORs) is implemented.
 The redirection commands works, LOCATION_FORWARD_PERM changing the target address
 until the application is restarted and LOCATION_FORWARD redirecting for the
 current session only. Both Little and Big Endian encoded messages
 are accepted. The encoding of the sent messages is the same as used in the 
 stringified IOR reference of that object or Big Endian, if no such data
 available.
 </p>
  <p>
 The current release supports the Value types that appeared since v 1.3 and are
 something between CORBA structures (no methods, data local) and CORBA objects
 (both methods and data remote). Value type has local data, can have
 local methods and is transferred by value, not by IOR reference. 
 </p>
 <p>
 You can use both request-oriented (based on {@link org.omg.CORBA.Request}) 
 and stream-oriented (based on {@link org.omg.CORBA.portable.ObjectImpl}) 
 invocation models. The current release includes the working examples, demonstrating
 the client-server communication using both methods. These examples also show, 
 how to use the Classpath naming service. The IDL compiler is not yet written, 
 but as a side effect of the required compatibility, the implementation seems 
 accepting the output of the Sun's 1.3 idlj.</p>
 
 @author Audrius Meskauskas, Lithuania (AudriusA@Bioinformatics.org)
</body>
</html>