corba/src/java.corba/share/classes/org/omg/PortableServer/POAPackage/package.html
author avstepan
Sun, 13 Sep 2015 23:31:47 +0300
changeset 32688 936c391804a5
parent 29827 aac4782e69ac
permissions -rw-r--r--
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs Reviewed-by: lancea
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
4
02bb8761fcce Initial load
duke
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
02bb8761fcce Initial load
duke
parents:
diff changeset
     2
<html>
02bb8761fcce Initial load
duke
parents:
diff changeset
     3
<head>
02bb8761fcce Initial load
duke
parents:
diff changeset
     4
<!--
02bb8761fcce Initial load
duke
parents:
diff changeset
     5
 
29827
aac4782e69ac 8039440: Tidy warnings cleanup for org/omg
avstepan
parents: 25862
diff changeset
     6
 Copyright (c) 2001, 2015, Oracle and/or its affiliates. All rights reserved.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
     7
 DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
02bb8761fcce Initial load
duke
parents:
diff changeset
     8
02bb8761fcce Initial load
duke
parents:
diff changeset
     9
 This code is free software; you can redistribute it and/or modify it
02bb8761fcce Initial load
duke
parents:
diff changeset
    10
 under the terms of the GNU General Public License version 2 only, as
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    11
 published by the Free Software Foundation.  Oracle designates this
4
02bb8761fcce Initial load
duke
parents:
diff changeset
    12
 particular file as subject to the "Classpath" exception as provided
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    13
 by Oracle in the LICENSE file that accompanied this code.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
    14
02bb8761fcce Initial load
duke
parents:
diff changeset
    15
 This code is distributed in the hope that it will be useful, but WITHOUT
02bb8761fcce Initial load
duke
parents:
diff changeset
    16
 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
02bb8761fcce Initial load
duke
parents:
diff changeset
    17
 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
02bb8761fcce Initial load
duke
parents:
diff changeset
    18
 version 2 for more details (a copy is included in the LICENSE file that
02bb8761fcce Initial load
duke
parents:
diff changeset
    19
 accompanied this code).
02bb8761fcce Initial load
duke
parents:
diff changeset
    20
02bb8761fcce Initial load
duke
parents:
diff changeset
    21
 You should have received a copy of the GNU General Public License version
02bb8761fcce Initial load
duke
parents:
diff changeset
    22
 2 along with this work; if not, write to the Free Software Foundation,
02bb8761fcce Initial load
duke
parents:
diff changeset
    23
 Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
02bb8761fcce Initial load
duke
parents:
diff changeset
    24
5555
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    25
 Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    26
 or visit www.oracle.com if you need additional information or have any
b2b5ed3f0d0d 6943119: Rebrand source copyright notices
ohair
parents: 4
diff changeset
    27
 questions.
4
02bb8761fcce Initial load
duke
parents:
diff changeset
    28
02bb8761fcce Initial load
duke
parents:
diff changeset
    29
02bb8761fcce Initial load
duke
parents:
diff changeset
    30
-->
02bb8761fcce Initial load
duke
parents:
diff changeset
    31
02bb8761fcce Initial load
duke
parents:
diff changeset
    32
</head>
02bb8761fcce Initial load
duke
parents:
diff changeset
    33
<body bgcolor="white">
02bb8761fcce Initial load
duke
parents:
diff changeset
    34
02bb8761fcce Initial load
duke
parents:
diff changeset
    35
<P>Allows programmers to construct object implementations that are portable
02bb8761fcce Initial load
duke
parents:
diff changeset
    36
between different ORB products.  
02bb8761fcce Initial load
duke
parents:
diff changeset
    37
02bb8761fcce Initial load
duke
parents:
diff changeset
    38
<P>The Portable Object Adaptor (POA) is designed to meet the following goals:
02bb8761fcce Initial load
duke
parents:
diff changeset
    39
<UL>
02bb8761fcce Initial load
duke
parents:
diff changeset
    40
<LI>Allow programmers to construct object implementations that are portable between different ORB products.
02bb8761fcce Initial load
duke
parents:
diff changeset
    41
<LI>Provide support for objects with persistent identities.
02bb8761fcce Initial load
duke
parents:
diff changeset
    42
<LI>Provide support for transparent activation of objects.
02bb8761fcce Initial load
duke
parents:
diff changeset
    43
<LI>Allow a single servant to support multiple object identities simultaneously.
02bb8761fcce Initial load
duke
parents:
diff changeset
    44
</UL>
02bb8761fcce Initial load
duke
parents:
diff changeset
    45
02bb8761fcce Initial load
duke
parents:
diff changeset
    46
02bb8761fcce Initial load
duke
parents:
diff changeset
    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
02bb8761fcce Initial load
duke
parents:
diff changeset
    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
02bb8761fcce Initial load
duke
parents:
diff changeset
    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
02bb8761fcce Initial load
duke
parents:
diff changeset
    63
02bb8761fcce Initial load
duke
parents:
diff changeset
    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
02bb8761fcce Initial load
duke
parents:
diff changeset
    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
02bb8761fcce Initial load
duke
parents:
diff changeset
    69
 section 11.3.8.26.
02bb8761fcce Initial load
duke
parents:
diff changeset
    70
02bb8761fcce Initial load
duke
parents:
diff changeset
    71
<H3>Package Specification</H3>
02bb8761fcce Initial load
duke
parents:
diff changeset
    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
02bb8761fcce Initial load
duke
parents:
diff changeset
    76
support in Java[tm] SE 6</A>.
29827
aac4782e69ac 8039440: Tidy warnings cleanup for org/omg
avstepan
parents: 25862
diff changeset
    77
4
02bb8761fcce Initial load
duke
parents:
diff changeset
    78
@since 1.4
02bb8761fcce Initial load
duke
parents:
diff changeset
    79
<br>
02bb8761fcce Initial load
duke
parents:
diff changeset
    80
@serial exclude
02bb8761fcce Initial load
duke
parents:
diff changeset
    81
</body>
02bb8761fcce Initial load
duke
parents:
diff changeset
    82
</html>