org.omg.PortableServer

Class ServantLocatorHelper

public abstract class ServantLocatorHelper extends Object

The helper operations for the CORBA object {@link ServantLocator}.

Method Summary
static ServantLocator	extract(Any any) Extract the ServantLocator from given Any.
static String	id() Get the ServantLocator repository id.
static void	insert(Any any, ServantLocator that) Insert the ServantLocator into the given Any.
static ServantLocator	narrow(Object obj) Cast the passed object into the ServantLocator.
static ServantLocator	read(InputStream input) This should read the servant locator, but it cannot be transferred this way as its operations cannot be remote.
static TypeCode	type() Get the type code of the {@link ServantLocator}.
static ServantLocator	unchecked_narrow(Object obj) Narrow the given object to the ServantLocator.
static void	write(OutputStream output, ServantLocator value) This should write the servant activator, but it cannot be transferred this way as its operations cannot be remote.

Method Detail

extract

public static ServantLocator extract(Any any)

Extract the ServantLocator from given Any.

Throws: BAD_OPERATION if the passed Any does not contain ServantLocator.

id

public static String id()

Get the ServantLocator repository id.

Returns: "org.omg.PortableServer.ServantLocatorOperations", always.

insert

public static void insert(Any any, ServantLocator that)

Insert the ServantLocator into the given Any.

Parameters: any the Any to insert into. that the ServantLocator to insert.

narrow

public static ServantLocator narrow(Object obj)

Cast the passed object into the ServantLocator.

Parameters: obj the object to narrow.

Returns: narrowed instance.

Throws: BAD_PARAM if the passed object is not a ServantLocator.

read

public static ServantLocator read(InputStream input)

This should read the servant locator, but it cannot be transferred this way as its operations cannot be remote. The operations cannot be remote because one of the method parameters, POA, is required to be always a local object (both by 1.5 API and 3.0.3 OMG).

Throws: MARSHAL, always.

UNKNOWN: Same as Sun.

type

public static TypeCode type()

Get the type code of the {@link ServantLocator}.

unchecked_narrow

public static ServantLocator unchecked_narrow(Object obj)

Narrow the given object to the ServantLocator. For the objects that are always local, this operation does not differ from the ordinary {@link #narrow} (ClassCastException will be thrown if narrowing something different). See OMG issue 4158.

Parameters: obj the object to cast.

Returns: the casted ServantLocator.

Since: 1.5

write

public static void write(OutputStream output, ServantLocator value)

This should write the servant activator, but it cannot be transferred this way as its operations cannot be remote. The operations cannot be remote because one of the method parameters, POA, is required to be always a local object (both by 1.5 API and 3.0.3 OMG).

Throws: MARSHAL, always.

UNKNOWN: Same as Sun.