< prev index next >

src/java.corba/share/classes/org/omg/PortableServer/POAPackage/package.html

Print this page


   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2 <html>
   3 <head>
   4 <!--
   5  
   6  Copyright (c) 2001, 2006, Oracle and/or its affiliates. All rights reserved.
   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
  11  published by the Free Software Foundation.  Oracle designates this
  12  particular file as subject to the "Classpath" exception as provided
  13  by Oracle in the LICENSE file that accompanied this code.
  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 
  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.
  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 <P>
  40 <UL>
  41 <LI>Allow programmers to construct object implementations that are portable between different ORB products.
  42 <LI>Provide support for objects with persistent identities.
  43 <LI>Provide support for transparent activation of objects.
  44 <LI>Allow a single servant to support multiple object identities simultaneously.
  45 </UL>
  46 
  47 
  48 
  49 <P>Given an interface <tt>My</tt> defined in <tt>My.idl</tt>, the file <tt>MyPOA.java</tt> is generated by the <tt>idlj</tt> compiler. You must provide the implementation for <tt>My</tt> and it must inherit from <tt>MyPOA</tt>.  
  50 
  51 <P><TT>MyPOA.java</TT> is a stream-based skeleton that extends <tt>org.omg.PortableServer.Servant</tt> and implements the <tt>InvokeHandler</tt> interface and the operations interface associated with the IDL interface the skeleton implements.
  52 
  53 <P>The <TT>PortableServer</TT> module for the Portable Object Adapter (POA) defines the native <tt>Servant</tt> type. In the Java programming language, the <tt>Servant</tt> type is mapped to the Java <TT>org.omg.PortableServer.Servant</TT> class.  It serves as the base class for all POA servant implementations and provides a number of methods that may 
  54 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.
  55  
  56 
  57 
  58 <P>All Mapping corresponds to the Chapter 11 of 
  59  CORBA V2.3.1 specified by OMG document formal/99-10-07.pdf.
  60  The exception to this is the <code>id</code> attribute, which is added in ptc/00-08-06, 
  61  section 11.3.8.26.
  62 
  63 <H3>Package Specification</H3>
  64  
  65 <P>For a precise list of supported sections of official specifications with which 
  66 the Java[tm] Platform, Standard Edition 6, ORB complies, see <A 
  67 HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA 
  68 support in Java[tm] SE 6</A>.
  69 <p>
  70 @since 1.4
  71 <br>
  72 @serial exclude
  73 </body>
  74 </html>
   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2 <html>
   3 <head>
   4 <!--
   5  
   6  Copyright (c) 2001, 2015, Oracle and/or its affiliates. All rights reserved.
   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
  11  published by the Free Software Foundation.  Oracle designates this
  12  particular file as subject to the "Classpath" exception as provided
  13  by Oracle in the LICENSE file that accompanied this code.
  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 
  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.
  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 
  48 <P>Given an interface <tt>My</tt> defined in <tt>My.idl</tt>, the file <tt>MyPOA.java</tt> is generated by the <tt>idlj</tt> compiler. You must provide the implementation for <tt>My</tt> and it must inherit from <tt>MyPOA</tt>.  
  49 
  50 <P><TT>MyPOA.java</TT> is a stream-based skeleton that extends <tt>org.omg.PortableServer.Servant</tt> and implements the <tt>InvokeHandler</tt> interface and the operations interface associated with the IDL interface the skeleton implements.
  51 
  52 <P>The <TT>PortableServer</TT> module for the Portable Object Adapter (POA) defines the native <tt>Servant</tt> type. In the Java programming language, the <tt>Servant</tt> type is mapped to the Java <TT>org.omg.PortableServer.Servant</TT> class.  It serves as the base class for all POA servant implementations and provides a number of methods that may 
  53 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.
  54  
  55 
  56 
  57 <P>All Mapping corresponds to the Chapter 11 of 
  58  CORBA V2.3.1 specified by OMG document formal/99-10-07.pdf.
  59  The exception to this is the <code>id</code> attribute, which is added in ptc/00-08-06, 
  60  section 11.3.8.26.
  61 
  62 <H3>Package Specification</H3>
  63  
  64 <P>For a precise list of supported sections of official specifications with which 
  65 the Java[tm] Platform, Standard Edition 6, ORB complies, see <A 
  66 HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA 
  67 support in Java[tm] SE 6</A>.
  68 
  69 @since 1.4
  70 <br>
  71 @serial exclude
  72 </body>
  73 </html>
< prev index next >