Package org.omg.PortableInterceptor

Class ServerRequestInfoHolder

java.lang.Object

org.omg.PortableInterceptor.ServerRequestInfoHolder

All Implemented Interfaces:

Streamable

public final class ServerRequestInfoHolder
extends Object
implements Streamable

Request Information, accessible to server-side request interceptors.

Some attributes and operations on ServerRequestInfo are not valid at all interception points. The following table shows the validity of each attribute or operation. If it is not valid, attempting to access it will result in a BAD_INV_ORDER being thrown with a standard minor code of 14.

	receive_request_ service_contexts	receive_request	send_reply	send_exception	send_other
Inherited from RequestInfo:
request_id	yes	yes	yes	yes	yes
operation	yes	yes	yes	yes	yes
arguments	no	yes1	yes	no2	no2
exceptions	no	yes	yes	yes	yes
contexts	no	yes	yes	yes	yes
operation_context	no	yes	yes	no	no
result	no	no	yes	no	no
response_expected	yes	yes	yes	yes	yes
sync_scope	yes	yes	yes	yes	yes
request_id	yes	yes	yes	yes	yes
operation	yes	yes	yes	yes	yes
arguments	no	yes1</sub	yes	no2	no2
exceptions	no	yes	yes	yes	yes
contexts	no	yes	yes	yes	yes
operation_context	no	yes	yes	no	no
result	no	no	yes	no	no
response_expected	yes	yes	yes	yes	yes
sync_scope	yes	yes	yes	yes	yes
reply_status	no	no	yes	yes	yes
forward_reference	no	no	no	no	yes2
get_slot	yes	yes	yes	yes	yes
get_request_service_context	yes	no	yes	yes	yes
get_reply_service_context	no	no	yes	yes	yes
ServerRequestInfo-specific:
sending_exception	no	no	no	yes	no
object_id	no	yes	yes	yes3	yes3
adapter_id	no	yes	yes	yes3	yes3
server_id	no	yes	yes	yes	yes
orb_id	no	yes	yes	yes	yes
adapter_name	no	yes	yes	yes	yes
target_most_derived_interface	no	yes	no4	no4	no4
get_server_policy	yes	yes	yes	yes	yes
set_slot	yes	yes	yes	yes	yes
target_is_a	no	yes	no4	no4	no4
add_reply_service_context	yes	yes	yes	yes	yes

1. When ServerRequestInfo is passed to receive_request, there is an entry in the list for every argument, whether in, inout, or out. But only the in and inout arguments will be available.
2. If the reply_status attribute is not LOCATION_FORWARD, accessing this attribute will throw BAD_INV_ORDER with a standard minor code of 14.
3. If the servant locator caused a location forward, or thrown an exception, this attribute/operation may not be available in this interception point. NO_RESOURCES with a standard minor code of 1 will be thrown if it is not available.
4. The operation is not available in this interception point because the necessary information requires access to the target object's servant, which may no longer be available to the ORB. For example, if the object's adapter is a POA that uses a ServantLocator, then the ORB invokes the interception point after it calls ServantLocator.postinvoke()
.

See Also:

• ServerRequestInterceptor

Field Summary

Fields

Modifier and Type	Field	Description
ServerRequestInfo	value

Constructor Summary

Constructors

Constructor	Description
ServerRequestInfoHolder()
ServerRequestInfoHolder(ServerRequestInfo initialValue)

Method Summary

Modifier and Type	Method	Description
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 Details

value

public ServerRequestInfo value

Constructor Details

ServerRequestInfoHolder

public ServerRequestInfoHolder()

ServerRequestInfoHolder

public ServerRequestInfoHolder(ServerRequestInfo initialValue)

Method Details

_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