author | avstepan |
Sun, 13 Sep 2015 23:31:47 +0300 | |
changeset 32688 | 936c391804a5 |
parent 29827 | aac4782e69ac |
permissions | -rw-r--r-- |
4 | 1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
2 |
<html> |
|
3 |
<head> |
|
4 |
<!-- |
|
5 |
||
29827 | 6 |
Copyright (c) 2001, 2015, Oracle and/or its affiliates. All rights reserved. |
4 | 7 |
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
8 |
||
9 |
This code is free software; you can redistribute it and/or modify it |
|
10 |
under the terms of the GNU General Public License version 2 only, as |
|
5555 | 11 |
published by the Free Software Foundation. Oracle designates this |
4 | 12 |
particular file as subject to the "Classpath" exception as provided |
5555 | 13 |
by Oracle in the LICENSE file that accompanied this code. |
4 | 14 |
|
15 |
This code is distributed in the hope that it will be useful, but WITHOUT |
|
16 |
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
17 |
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
18 |
version 2 for more details (a copy is included in the LICENSE file that |
|
19 |
accompanied this code). |
|
20 |
||
21 |
You should have received a copy of the GNU General Public License version |
|
22 |
2 along with this work; if not, write to the Free Software Foundation, |
|
23 |
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
|
24 |
||
5555 | 25 |
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
26 |
or visit www.oracle.com if you need additional information or have any |
|
27 |
questions. |
|
4 | 28 |
|
29 |
||
30 |
--> |
|
31 |
||
32 |
</head> |
|
33 |
<body bgcolor="white"> |
|
34 |
||
35 |
<P>Allows programmers to construct object implementations that are portable |
|
36 |
between different ORB products. |
|
37 |
||
38 |
<P>The Portable Object Adaptor (POA) is designed to meet the following goals: |
|
39 |
<UL> |
|
40 |
<LI>Allow programmers to construct object implementations that are portable between different ORB products. |
|
41 |
<LI>Provide support for objects with persistent identities. |
|
42 |
<LI>Provide support for transparent activation of objects. |
|
43 |
<LI>Allow a single servant to support multiple object identities simultaneously. |
|
44 |
</UL> |
|
45 |
||
46 |
||
47 |
||
32688
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
48 |
<P>Given an interface <code>My</code> defined in <code>My.idl</code>, the file <code>MyPOA.java</code> |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
49 |
is generated by the <code>idlj</code> compiler. You must provide |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
50 |
the implementation for <code>My</code> and it must inherit from <code>MyPOA</code>. |
4 | 51 |
|
32688
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
52 |
<P><code>MyPOA.java</code> is a stream-based skeleton that extends |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
53 |
<code>org.omg.PortableServer.Servant</code> and implements the <code>InvokeHandler</code> |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
54 |
interface and the operations interface associated with the IDL interface the skeleton implements. |
4 | 55 |
|
32688
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
56 |
<P>The <code>PortableServer</code> module for the Portable Object Adapter (POA) |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
57 |
defines the native <code>Servant</code> type. In the Java programming language, |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
58 |
the <code>Servant</code> type is mapped to the Java <code>org.omg.PortableServer.Servant</code> class. |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
59 |
It serves as the base class for all POA servant implementations |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
60 |
and provides a number of methods that may be invoked by the application programmer, |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
61 |
as well as methods which are invoked by the POA itself |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
62 |
and may be overridden by the user to control aspects of servant behavior. |
4 | 63 |
|
64 |
||
32688
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
65 |
|
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
66 |
<P>All Mapping corresponds to the Chapter 11 of |
4 | 67 |
CORBA V2.3.1 specified by OMG document formal/99-10-07.pdf. |
32688
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
68 |
The exception to this is the <code>id</code> attribute, which is added in ptc/00-08-06, |
4 | 69 |
section 11.3.8.26. |
70 |
||
71 |
<H3>Package Specification</H3> |
|
72 |
||
32688
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
73 |
<P>For a precise list of supported sections of official specifications with which |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
74 |
the Java[tm] Platform, Standard Edition 6, ORB complies, see <A |
936c391804a5
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
avstepan
parents:
29827
diff
changeset
|
75 |
HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA |
4 | 76 |
support in Java[tm] SE 6</A>. |
29827 | 77 |
|
4 | 78 |
@since 1.4 |
79 |
<br> |
|
80 |
@serial exclude |
|
81 |
</body> |
|
82 |
</html> |