package.html revision 704:3ef63dbde965
190075Sobrien<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
250397Sobrien<html>
390075Sobrien<head>
450397Sobrien<!--
550397Sobrien 
690075Sobrien Copyright (c) 2001, 2015, Oracle and/or its affiliates. All rights reserved.
750397Sobrien DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
890075Sobrien
990075Sobrien This code is free software; you can redistribute it and/or modify it
1090075Sobrien under the terms of the GNU General Public License version 2 only, as
1190075Sobrien published by the Free Software Foundation.  Oracle designates this
1250397Sobrien particular file as subject to the "Classpath" exception as provided
1390075Sobrien by Oracle in the LICENSE file that accompanied this code.
1490075Sobrien
1590075Sobrien This code is distributed in the hope that it will be useful, but WITHOUT
1690075Sobrien ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
1750397Sobrien FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
1850397Sobrien version 2 for more details (a copy is included in the LICENSE file that
1990075Sobrien accompanied this code).
20169689Skan
21169689Skan You should have received a copy of the GNU General Public License version
2250397Sobrien 2 along with this work; if not, write to the Free Software Foundation,
2350397Sobrien Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
2450397Sobrien
2550397Sobrien Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2650397Sobrien or visit www.oracle.com if you need additional information or have any
2750397Sobrien questions.
2850397Sobrien
2950397Sobrien
3090075Sobrien-->
3190075Sobrien
3250397Sobrien</head>
3390075Sobrien<body bgcolor="white">
3490075Sobrien
35132718Skan<P>Allows programmers to construct object implementations that are portable
36132718Skanbetween different ORB products.  
3790075Sobrien
38132718Skan<P>The Portable Object Adaptor (POA) is designed to meet the following goals:
3990075Sobrien<UL>
40132718Skan<LI>Allow programmers to construct object implementations that are portable between different ORB products.
41132718Skan<LI>Provide support for objects with persistent identities.
4290075Sobrien<LI>Provide support for transparent activation of objects.
43132718Skan<LI>Allow a single servant to support multiple object identities simultaneously.
4490075Sobrien</UL>
45132718Skan
4690075Sobrien
47132718Skan
48169689Skan<P>Given an interface <code>My</code> defined in <code>My.idl</code>, the file <code>MyPOA.java</code>
49169689Skanis generated by the <code>idlj</code> compiler. You must provide
50132718Skanthe implementation for <code>My</code> and it must inherit from <code>MyPOA</code>.
51169689Skan
5290075Sobrien<P><code>MyPOA.java</code> is a stream-based skeleton that extends
53132718Skan<code>org.omg.PortableServer.Servant</code> and implements the <code>InvokeHandler</code>
54132718Skaninterface and the operations interface associated with the IDL interface the skeleton implements.
5590075Sobrien
56132718Skan<P>The <code>PortableServer</code> module for the Portable Object Adapter (POA)
5790075Sobriendefines the native <code>Servant</code> type. In the Java programming language,
5890075Sobrienthe <code>Servant</code> type is mapped to the Java <code>org.omg.PortableServer.Servant</code> class.
59132718SkanIt serves as the base class for all POA servant implementations
60132718Skanand provides a number of methods that may be invoked by the application programmer,
6190075Sobrienas well as methods which are invoked by the POA itself
62132718Skanand may be overridden by the user to control aspects of servant behavior.
6390075Sobrien
6490075Sobrien
65132718Skan
66132718Skan<P>All Mapping corresponds to the Chapter 11 of
6790075Sobrien CORBA V2.3.1 specified by OMG document formal/99-10-07.pdf.
68132718Skan The exception to this is the <code>id</code> attribute, which is added in ptc/00-08-06,
6990075Sobrien section 11.3.8.26.
7090075Sobrien
7150397Sobrien<H3>Package Specification</H3>
72132718Skan 
7350397Sobrien<P>For a precise list of supported sections of official specifications with which
74132718Skanthe Java[tm] Platform, Standard Edition 6, ORB complies, see <A
7550397SobrienHREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA
7650397Sobriensupport in Java[tm] SE 6</A>.
77169689Skan
78169689Skan@since 1.4
79169689Skan<br>
80169689Skan@serial exclude
81169689Skan</body>
82169689Skan</html>
83169689Skan