JavaTM 2 Platform
Std. Ed. v1.4.0

org.omg.PortableServer
Class ServantLocatorHolder

java.lang.Object
  |
  +--org.omg.PortableServer.ServantLocatorHolder
All Implemented Interfaces:
Streamable

public final class ServantLocatorHolder
extends Object
implements Streamable

When the POA has the NON_RETAIN policy it uses servant managers that are ServantLocators. Because the POA knows that the servant returned by this servant manager will be used only for a single request, it can supply extra information to the servant manager's operations and the servant manager's pair of operations may be able to cooperate to do something different than a ServantActivator. When the POA uses the ServantLocator interface, immediately after performing the operation invocation on the servant returned by preinvoke, the POA will invoke postinvoke on the servant manager, passing the ObjectId value and the Servant value as parameters (among others). This feature may be used to force every request for objects associated with a POA to be mediated by the servant manager.


Field Summary
 ServantLocator value
           
 
Constructor Summary
ServantLocatorHolder()
           
ServantLocatorHolder(ServantLocator initialValue)
           
 
Method Summary
 void _read(InputStream i)
          Reads data from istream and initalizes the value field of the Holder with the unmarshalled data.
 TypeCode _type()
          Retrieves the TypeCode object corresponding to the value in the value field of the Holder.
 void _write(OutputStream o)
          Marshals to ostream the value in the value field of the Holder.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

value

public ServantLocator value
Constructor Detail

ServantLocatorHolder

public ServantLocatorHolder()

ServantLocatorHolder

public ServantLocatorHolder(ServantLocator initialValue)
Method Detail

_read

public void _read(InputStream i)
Description copied from interface: Streamable
Reads data from istream and initalizes the value field of the Holder with the unmarshalled data.

Specified by:
_read in interface Streamable
Parameters:
i - the InputStream that represents the CDR data from the wire.

_write

public void _write(OutputStream o)
Description copied from interface: Streamable
Marshals to ostream the value in the value field of the Holder.

Specified by:
_write in interface Streamable
Parameters:
o - the CDR OutputStream

_type

public TypeCode _type()
Description copied from interface: Streamable
Retrieves the TypeCode object corresponding to the value in the value field of the Holder.

Specified by:
_type in interface Streamable
Returns:
the TypeCode object for the value held in the holder

JavaTM 2 Platform
Std. Ed. v1.4.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2001 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.