| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
| <html> |
| <head> |
| <!-- |
| |
| Copyright (c) 2001, 2015, Oracle and/or its affiliates. All rights reserved. |
| DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| |
| This code is free software; you can redistribute it and/or modify it |
| under the terms of the GNU General Public License version 2 only, as |
| published by the Free Software Foundation. Oracle designates this |
| particular file as subject to the "Classpath" exception as provided |
| by Oracle in the LICENSE file that accompanied this code. |
| |
| This code 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 |
| version 2 for more details (a copy is included in the LICENSE file that |
| accompanied this code). |
| |
| You should have received a copy of the GNU General Public License version |
| 2 along with this work; if not, write to the Free Software Foundation, |
| Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| |
| Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| or visit www.oracle.com if you need additional information or have any |
| questions. |
| |
| |
| --> |
| |
| </head> |
| <body bgcolor="white"> |
| |
| <P>Allows programmers to construct object implementations that are portable |
| between different ORB products. |
| |
| <P>The Portable Object Adaptor (POA) is designed to meet the following goals: |
| <UL> |
| <LI>Allow programmers to construct object implementations that are portable between different ORB products. |
| <LI>Provide support for objects with persistent identities. |
| <LI>Provide support for transparent activation of objects. |
| <LI>Allow a single servant to support multiple object identities simultaneously. |
| </UL> |
| |
| |
| |
| <P>Given an interface <code>My</code> defined in <code>My.idl</code>, the file <code>MyPOA.java</code> |
| is generated by the <code>idlj</code> compiler. You must provide |
| the implementation for <code>My</code> and it must inherit from <code>MyPOA</code>. |
| |
| <P><code>MyPOA.java</code> is a stream-based skeleton that extends |
| <code>org.omg.PortableServer.Servant</code> and implements the <code>InvokeHandler</code> |
| interface and the operations interface associated with the IDL interface the skeleton implements. |
| |
| <P>The <code>PortableServer</code> module for the Portable Object Adapter (POA) |
| defines the native <code>Servant</code> type. In the Java programming language, |
| the <code>Servant</code> type is mapped to the Java <code>org.omg.PortableServer.Servant</code> class. |
| It serves as the base class for all POA servant implementations |
| and provides a number of methods that may be invoked by the application programmer, |
| as well as methods which are invoked by the POA itself |
| and may be overridden by the user to control aspects of servant behavior. |
| |
| |
| |
| <P>All Mapping corresponds to the Chapter 11 of |
| CORBA V2.3.1 specified by OMG document formal/99-10-07.pdf. |
| The exception to this is the <code>id</code> attribute, which is added in ptc/00-08-06, |
| section 11.3.8.26. |
| |
| <H3>Package Specification</H3> |
| |
| <P>For a precise list of supported sections of official specifications with which |
| the Java[tm] Platform, Standard Edition 6, ORB complies, see <A |
| HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA |
| support in Java[tm] SE 6</A>. |
| |
| @since 1.4 |
| <br> |
| @serial exclude |
| </body> |
| </html> |