Package org. omg. PortableServer
See: Description
-
Interface Summary Interface Description AdapterActivator An adapter activator supplies a POA with the ability to create child POAs on demand, as a side-effect of receiving a request that names the child POA (or one of its children), or when find_POA is called with an activate parameter value of TRUE.AdapterActivatorOperations An adapter activator supplies a POA with the ability to create child POAs on demand, as a side-effect of receiving a request that names the child POA (or one of its children), or when find_POA is called with an activate parameter value of TRUE.Current The PortableServer::Current interface, derived from CORBA::Current, provides method implementations with access to the identity of the object on which the method was invoked.CurrentOperations The PortableServer::Current interface, derived from CORBA::Current, provides method implementations with access to the identity of the object on which the method was invoked.ID_ASSIGNMENT_POLICY_ID org/omg/PortableServer/ID_ASSIGNMENT_POLICY_ID.java .ID_UNIQUENESS_POLICY_ID org/omg/PortableServer/ID_UNIQUENESS_POLICY_ID.java .IdAssignmentPolicy IdAssignmentPolicy specifies whether Object Ids in the created POA are generated by the application or by the ORB.IdAssignmentPolicyOperations IdAssignmentPolicy specifies whether Object Ids in the created POA are generated by the application or by the ORB.IdUniquenessPolicy The IdUniquenessPolicy specifies whether the servants activated in the created POA must have unique object i identities.IdUniquenessPolicyOperations The IdUniquenessPolicy specifies whether the servants activated in the created POA must have unique object i identities.IMPLICIT_ACTIVATION_POLICY_ID org/omg/PortableServer/IMPLICIT_ACTIVATION_POLICY_ID.java .ImplicitActivationPolicy This policy specifies whether implicit activation of servants is supported in the created POA.ImplicitActivationPolicyOperations This policy specifies whether implicit activation of servants is supported in the created POA.LIFESPAN_POLICY_ID org/omg/PortableServer/LIFESPAN_POLICY_ID.java .LifespanPolicy The LifespanPolicy specifies the lifespan of the objects implemented in the created POA.LifespanPolicyOperations The LifespanPolicy specifies the lifespan of the objects implemented in the created POA.POA A POA object manages the implementation of a collection of objects.POAManager Each POA object has an associated POAManager object.POAManagerOperations Each POA object has an associated POAManager object.POAOperations A POA object manages the implementation of a collection of objects.REQUEST_PROCESSING_POLICY_ID org/omg/PortableServer/REQUEST_PROCESSING_POLICY_ID.java .RequestProcessingPolicy This policy specifies how requests are processed by the created POA.RequestProcessingPolicyOperations This policy specifies how requests are processed by the created POA.SERVANT_RETENTION_POLICY_ID org/omg/PortableServer/SERVANT_RETENTION_POLICY_ID.java .ServantActivator When the POA has the RETAIN policy it uses servant managers that are ServantActivators.ServantActivatorOperations When the POA has the RETAIN policy it uses servant managers that are ServantActivators.ServantLocator When the POA has the NON_RETAIN policy it uses servant managers that are ServantLocators.ServantLocatorOperations When the POA has the NON_RETAIN policy it uses servant managers that are ServantLocators.ServantManager A servant manager supplies a POA with the ability to activate objects on demand when the POA receives a request targeted at an inactive object.ServantManagerOperations A servant manager supplies a POA with the ability to activate objects on demand when the POA receives a request targeted at an inactive object.ServantRetentionPolicy This policy specifies whether the created POA retains active servants in an Active Object Map.ServantRetentionPolicyOperations This policy specifies whether the created POA retains active servants in an Active Object Map.THREAD_POLICY_ID org/omg/PortableServer/THREAD_POLICY_ID.java .ThreadPolicy The ThreadPolicy specifies the threading model used with the created POA.ThreadPolicyOperations The ThreadPolicy specifies the threading model used with the created POA. -
Class Summary Class Description _ServantActivatorStub When the POA has the RETAIN policy it uses servant managers that are ServantActivators._ServantLocatorStub When the POA has the NON_RETAIN policy it uses servant managers that are ServantLocators.CurrentHelper The PortableServer::Current interface, derived from CORBA::Current, provides method implementations with access to the identity of the object on which the method was invoked.DynamicImplementation Allows dynamic handling of object invocations.ForwardRequestHelper org/omg/PortableServer/ForwardRequestHelper.java .IdAssignmentPolicyValue The IdAssignmentPolicyValue can have the following values.IdUniquenessPolicyValue IdUniquenessPolicyValue can have the following values.ImplicitActivationPolicyValue ImplicitActivationPolicyValue has the following semantics.LifespanPolicyValue The LifespanPolicyValue can have the following values.POAHelper A POA object manages the implementation of a collection of objects.RequestProcessingPolicyValue The RequestProcessingPolicyValue can have the following values.Servant Defines the nativeServant
type.ServantActivatorHelper When the POA has the RETAIN policy it uses servant managers that are ServantActivators.ServantActivatorPOA When the POA has the RETAIN policy it uses servant managers that are ServantActivators.ServantLocatorHelper When the POA has the NON_RETAIN policy it uses servant managers that are ServantLocators.ServantLocatorPOA When the POA has the NON_RETAIN policy it uses servant managers that are ServantLocators.ServantRetentionPolicyValue ServantRetentionPolicyValue can have the following values.ThreadPolicyValue The ThreadPolicyValue can have the following values. -
Exception Summary Exception Description ForwardRequest org/omg/PortableServer/ForwardRequest.java .
Package org.omg.PortableServer Description
In Java, Portable Object Adaptor (POA)-based Dynamic Skeleton Interface (DSI) servants inherit from the standard DynamicImplementation class, which inherits from the Servant class. The native Servant type is defined by the PortableServer module for the POA. In Java, the Servant type is mapped to the Java org.omg.PortableServer.Servant 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.
Package Specification
For a precise list of supported sections of official OMG specifications with which the Java[tm] Platform, Standard Edition 6 complies, see Official Specifications for CORBA support in Java[tm] SE 6.
POA-related Interfaces
The PortableServer module defines the following POA-related interfaces:
- POA
- POAManager
- ServantManager
- ServantActivator
- ServantLocator
- AdapterActivator
- ThreadPolicy
- LifespanPolicy
- IdUniquenessPolicy
- IdAssignmentPolicy
- ImplicitActivationPolicy
- ServantRetentionPolicy
- RequestProcessingPolicy
- Current
In addition, the POA defines the Servant native type.
Operations classes
Each of the interfaces listed above has an associated Operations
interface. The Operations
interface is generated by the idlj
compiler and contains the method signatures for methods defined in its associated interface. The Operations
interface can be accessed by both the client and the server, while its associated interface can only be called by the client.
Value Classes
Classes ending in the suffixPolicyValue
provide the values used for the create_POA
call, which sets the policy for the POA. See the sample code below for a demonstration. PolicyValue
files include the following:
IdAssignmentPolicyValue
IdUniquenessPolicyValue
ImplicitActivationPolicyValue
LifespanPolicyValue
RequestProcessingPolicyValue
ServantRetentionPolicyValue
ThreadPolicyValue
Helper Classes
Helper classes, which are generated for all user-defined types in an OMG IDL
interface, supply static methods needed to manipulate those types. There is only one method in a helper class that an application programmer uses: the narrow
method. Only Java interfaces mapped from IDL interfaces will have a helper class that includes a narrow
method, so in the PortableServer
package, only the following classes have a narrow
method:
ForwardRequestHelper
ServantActivatorHelper
ServantLocatorHelper
POA Classes
POA classes are used to implement the ServantActivator
or ServantLocator
.
Exceptions
The ForwardRequest
exception indicates to the ORB
that it is responsible for delivering the current request and subsequent ForwardRequest
requests to the object denoted in the
forward_reference
member of the exception.
Interfaces Implemented by the Application Programmer
Most of what PortableServer
does is transparent to the user. The result is that programmers will use only a few of the interfaces mentioned above. The remaining interfaces will be provided by the ORB implementation. The interfaces of interest to application programmers are the following:
AdapterActivator
Adapter activators are associated with POAs. An adapter activator supplies a POA with the ability to create child POAs on demand, as a side-effect of receiving a request that names the child POA (or one of its children), or when
find_POA
is called with an activate parameter value ofTRUE
. An application server that creates all its needed POAs at the beginning of execution does not need to use or provide an adapter activator; it is necessary only for the case in which POAs need to be created during request processing.ServantLocator
When the POA has the
NON_RETAIN
policy, it uses servant managers that areServantLocator
s.ServantActivator
When the POA has the
RETAIN
policy, it uses servant managers that areServantActivator
s.
Package org.omg.PortableServer.ServantLocatorPackage
This package supplies a CookieHolder class for passing
the Cookie type as an out
parameter. The CookieHolder
class
follows exactly the same pattern as the other holder classes for basic types.
Related Documentation
For an overview of Java IDL, please see:
Example Code
Example Server Code
import javax.naming.InitialContext; import javax.naming.Context; import javax.rmi.PortableRemoteObject ; import com.sun.corba.se.impl.poa.POAORB; import org.omg.PortableServer.*; import java.util.*; import org.omg.CORBA.*; import javax.rmi.CORBA.Stub; import javax.rmi.CORBA.Util; public class HelloServer { public HelloServer(String[] args) { try { Properties p = System.getProperties(); // p.put("org.omg.CORBA.ORBClass", "com.sun.corba.ee.internal.POA.POAORB"); ORB orb = ORB.init( args, p ); POA rootPOA = (POA)orb.resolve_initial_references("RootPOA"); Policy[] tpolicy = new Policy[3]; tpolicy[0] = rootPOA.create_lifespan_policy( LifespanPolicyValue.TRANSIENT ); tpolicy[1] = rootPOA.create_request_processing_policy( RequestProcessingPolicyValue.USE_ACTIVE_OBJECT_MAP_ONLY ); tpolicy[2] = rootPOA.create_servant_retention_policy( ServantRetentionPolicyValue.RETAIN); POA tpoa = rootPOA.create_POA("MyTransientPOA", null, tpolicy); String ObjectId = "MyObjectId"; byte[] oid = ObjectId.getBytes(); org.omg.CORBA.Object obj = tpoa.create_reference_with_id(oid, new _HelloImpl_Tie()._all_interfaces(tpoa, oid)[0]); HelloInterface helloRef = (HelloInterface)PortableRemoteObject.narrow( obj, HelloInterface.class ); Context initialNamingContext = new InitialContext(); initialNamingContext.rebind("HelloService", helloRef); System.out.println("Hello Server: Ready..."); orb.run(); } catch (Exception e) { System.out.println("Trouble: " + e); e.printStackTrace(); } } public static void main(String args[]) { new HelloServer( args ); } }
- Since:
- 1.4
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-org/omg/portableserver/package-summary.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.