ServerRequestInfoOperations

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> org >> omg >> [ PortableInterceptor overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

Sourc code of org.omg.PortableInterceptor.ServerRequestInfoOperations

SOURCE |

Download org.omg.PortableInterceptor.ServerRequestInfoOperations

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.omg.PortableInterceptor
Interface ServerRequestInfoOperations

All Superinterfaces:: RequestInfoOperations

All Known Subinterfaces:: ServerRequestInfo

public interface ServerRequestInfoOperations
extends RequestInfoOperations

Provides request information, accessible for the ClientRequestInterceptor. Some methods of this interface are not valid at all interception points. The following table shows the validity of each method. If it is not valid, BAD_INV_ORDER minor 14 will be thrown. * *

receive_request_
service_contexts 55 receive_request 55 send_reply 55 send_exception 55 send_other 55

Inherited from RequestInfoOperations:

arguments 55 no yes₁ yes no₂ no₂

exceptions 55 no yes

contexts 55 no yes

operation_context 55 no yes yes no no

result 55 no no yes no no

reply_status 55 no no yes

forward_reference 55 no yes₂

get_request_service_context 55 yes no yes

get_reply_service_context 55 no no yes

request_id 55 yes

operation 55 yes

response_expected 55 yes

sync_scope 55 yes

get_slot 55 yes

ServerRequestInfo-specific:

get_server_policy 55 yes

add_reply_service_context 55 yes

set_slot 55 yes

sending_exception 55 no yes no

object_id 55 no yes yes yes₃ yes₃

adapter_id 55 no yes yes yes₃ yes₃

target_most_derived_interface 55 no yes no

target_is_a 55 no yes no

receive_request_
service_contexts 55 receive_request 55 send_reply 55 send_exception 55 send_other 55

	receive_request_ service_contexts 55	receive_request 55	send_reply 55	send_exception 55	send_other 55
Inherited from RequestInfoOperations:
arguments 55	no	yes₁	yes	no₂	no₂
exceptions 55	no	yes
contexts 55	no	yes
operation_context 55	no	yes	yes	no	no
result 55	no	no	yes	no	no
reply_status 55	no	no	yes
forward_reference 55	no	yes₂
get_request_service_context 55	yes	no	yes
get_reply_service_context 55	no	no	yes
request_id 55	yes
operation 55	yes
response_expected 55	yes
sync_scope 55	yes
get_slot 55	yes
ServerRequestInfo-specific:
get_server_policy 55	yes
add_reply_service_context 55	yes
set_slot 55	yes
sending_exception 55	no	yes	no
object_id 55	no	yes	yes	yes₃	yes₃
adapter_id 55	no	yes	yes	yes₃	yes₃
target_most_derived_interface 55	no	yes	no
target_is_a 55	no	yes	no
	receive_request_ service_contexts 55	receive_request 55	send_reply 55	send_exception 55	send_other 55

When ServerRequestInfo is passed to receive_request, there is an entry in the list for every argument. But only the in and inout arguments will be available.
If the reply_status attribute is not LOCATION_FORWARD, accessing this attribute throws BAD_INV_ORDER minor code of 14.
If the servant locator caused a location forward, or thrown an exception, this attribute/operation may not be available (NO_RESOURCES with a standard minor code of 1 will be thrown).

Method Summary

byte[] adapter_id()
          Get the identifier for the object adapter (POA).

java.lang.String[] adapter_name()
          Returns the name of the adapter that is handling the current request.

void add_reply_service_context(org.omg.IOP.ServiceContext service_context, boolean replace)
          Allows the interceptor to add service contexts to the request.

org.omg.CORBA.Policy get_server_policy(int type)
          Return the policy of the given type that applies to this operation.

byte[] object_id()
          Get the object_id describing the target of the operation invocation.

java.lang.String orb_id()
          Returns the id of the ORB that is handling the current request.

org.omg.CORBA.Any sending_exception()
          Get the exception to be returned to the client.

java.lang.String server_id()
          Returs the id of the server that is handling the current request.

void set_slot(int id, org.omg.CORBA.Any data)
          Allows the interceptor to set a slot in the PortableInterceptor.Current that is in the scope of the request.

boolean target_is_a(java.lang.String id)
          Checks if the servant is the given repository id.

java.lang.String target_most_derived_interface()
          Get the most derived (most specific) repository Id of the servant.

Methods inherited from interface org.omg.PortableInterceptor.RequestInfoOperations

arguments, contexts, exceptions, forward_reference, get_reply_service_context, get_request_service_context, get_slot, operation_context, operation, reply_status, request_id, response_expected, result, sync_scope

Method Detail

add_reply_service_context

public void add_reply_service_context(org.omg.IOP.ServiceContext service_context,
                                      boolean replace)

Allows the interceptor to add service contexts to the request. Such added contexts can carry arbitrary data and can be later accessed on the client side by the client request interceptor using RequestInfoOperations.get_reply_service_context(int) 55 .

adapter_id

public byte[] adapter_id()

Get the identifier for the object adapter (POA).

object_id

public byte[] object_id()

Get the object_id describing the target of the operation invocation.

get_server_policy

public org.omg.CORBA.Policy get_server_policy(int type)
                                       throws org.omg.CORBA.INV_POLICY

Return the policy of the given type that applies to this operation. This method should only be used with policies, produced by the registered PolicyFactory.

sending_exception

public org.omg.CORBA.Any sending_exception()

Get the exception to be returned to the client. If the returned Any cannot not support holding of that exception, it holds org.omg.CORBA.UNKNOWN minor 1 instead.

set_slot

public void set_slot(int id,
                     org.omg.CORBA.Any data)
              throws InvalidSlot

Allows the interceptor to set a slot in the PortableInterceptor.Current that is in the scope of the request.

target_is_a

public boolean target_is_a(java.lang.String id)

Checks if the servant is the given repository id.

target_most_derived_interface

public java.lang.String target_most_derived_interface()

Get the most derived (most specific) repository Id of the servant.

adapter_name

public java.lang.String[] adapter_name()

Returns the name of the adapter that is handling the current request. The name is returned as a string array, representing full path from the root poa till the current poa, for instance {"RootPOA", "childPOA","grandchildPOA"}.

orb_id

public java.lang.String orb_id()

Returns the id of the ORB that is handling the current request. The ORB id can be specified as the property org.omg.CORBA.ORBid when creating the ORB.

server_id

public java.lang.String server_id()

Returs the id of the server that is handling the current request. The server id is the same for all POAs and ORBs in the current virtual machine and can be set as the property org.omg.CORBA.ServerId when creating one of the ORBs.