com.sun.corba.se.impl.interceptors

Class ClientRequestInfoImpl

java.lang.Object

org.omg.CORBA.LocalObject

com.sun.corba.se.impl.interceptors.RequestInfoImpl

com.sun.corba.se.impl.interceptors.ClientRequestInfoImpl

All Implemented Interfaces:

RequestInfoExt, Serializable, Object, IDLEntity, ClientRequestInfo, ClientRequestInfoOperations, RequestInfo, RequestInfoOperations

public final class ClientRequestInfoImpl
extends RequestInfoImpl
implements ClientRequestInfo

Implementation of the ClientRequestInfo interface as specified in orbos/99-12-02 section 5.4.2.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	MID_ADD_REQUEST_SERVICE_CONTEXT
protected static int	MID_EFFECTIVE_PROFILE
protected static int	MID_EFFECTIVE_TARGET
protected static int	MID_GET_EFFECTIVE_COMPONENT
protected static int	MID_GET_EFFECTIVE_COMPONENTS
protected static int	MID_GET_REQUEST_POLICY
protected static int	MID_RECEIVED_EXCEPTION
protected static int	MID_RECEIVED_EXCEPTION_ID
protected static int	MID_TARGET
protected boolean	piCurrentPushed

Fields inherited from class com.sun.corba.se.impl.interceptors.RequestInfoImpl

alreadyExecuted, connection, currentExecutionPoint, endingPointCall, exception, EXECUTION_POINT_ENDING, EXECUTION_POINT_INTERMEDIATE, EXECUTION_POINT_STARTING, flowStackIndex, forwardRequest, forwardRequestIOR, intermediatePointCall, MID_ARGUMENTS, MID_CONTEXTS, MID_EXCEPTIONS, MID_FORWARD_REFERENCE, MID_GET_REPLY_SERVICE_CONTEXT, MID_GET_REQUEST_SERVICE_CONTEXT, MID_GET_SLOT, MID_OPERATION, MID_OPERATION_CONTEXT, MID_REPLY_STATUS, MID_REQUEST_ID, MID_RESPONSE_EXPECTED, MID_RESULT, MID_RI_LAST, MID_SYNC_SCOPE, myORB, replyStatus, serviceContexts, slotTable, startingPointCall, stdWrapper, UNINITIALIZED, wrapper

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ClientRequestInfoImpl(ORB myORB) Creates a new ClientRequestInfo implementation.

Method Summary

Modifier and Type	Method and Description
void	add_request_service_context(ServiceContext service_context, boolean replace) Allows interceptors to add service contexts to the request.
Parameter[]	arguments() See RequestInfoImpl for javadoc.
protected void	checkAccess(int methodID) See description for RequestInfoImpl.checkAccess
Connection	connection()
String[]	contexts() See RequestInfoImpl for javadoc.
TaggedProfile	effective_profile() The profile that will be used to send the request.
Object	effective_target() The actual object on which the operation will be invoked.
TypeCode[]	exceptions() See RequestInfoImpl for javadoc.
Object	forward_reference() See RequestInfoImpl for javadoc.
TaggedComponent	get_effective_component(int id) Returns the IOP::TaggedComponent with the given ID from the profile selected for this request.
TaggedComponent[]	get_effective_components(int id) Returns all the tagged components with the given ID from the profile selected for this request.
ServiceContext	get_reply_service_context(int id) does not contain an etry for that ID, BAD_PARAM with a minor code of TBD_BP is raised.
Policy	get_request_policy(int type) Returns the given policy in effect for this operation.
ServiceContext	get_request_service_context(int id) See RequestInfoImpl for javadoc.
protected boolean	getIsOneWay()
protected boolean	isDIIInitiate() See comment for setDIIInitiate
protected boolean	isPICurrentPushed()
String[]	operation_context() See RequestInfoImpl for javadoc.
String	operation() See RequestInfoImpl for javadoc.
String	received_exception_id() The CORBA::RepositoryId of the exception to be returned to the client.
Any	received_exception() Contains the exception to be returned to the client.
int	request_id() See RequestInfoImpl for javadoc.
boolean	response_expected() See RequestInfoImpl for javadoc.
Any	result() See RequestInfoImpl for javadoc.
protected void	setDIIInitiate(boolean diiInitiate) Keeps track of whether initiate was called for a DII request.
protected void	setDIIRequest(Request req) Sets DII request object in the RequestInfoObject.
protected void	setException(Exception exception) Overridden from RequestInfoImpl.
protected void	setInfo(MessageMediator messageMediator)
protected void	setLocatedIOR(IOR ior)
protected void	setPICurrentPushed(boolean piCurrentPushed) The PICurrent stack should only be popped if it was pushed.
protected void	setReplyStatus(short replyStatus) Overridden from RequestInfoImpl.
Object	target() The object which the client called to perform the operation.

Methods inherited from class com.sun.corba.se.impl.interceptors.RequestInfoImpl

addServiceContext, exceptionToAny, get_slot, getAlreadyExecuted, getEndingPointCall, getFlowStackIndex, getForwardRequestException, getForwardRequestIOR, getIntermediatePointCall, getReplyStatus, getServiceContext, getStartingPointCall, iorToObject, nvListToParameterArray, reply_status, setAlreadyExecuted, setCurrentExecutionPoint, setEndingPointCall, setFlowStackIndex, setForwardRequest, setForwardRequest, setIntermediatePointCall, setStartingPointCall, sync_scope

Methods inherited from class org.omg.CORBA.LocalObject

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_interface, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_policy_override, validate_connection

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.omg.PortableInterceptor.RequestInfoOperations

get_slot, reply_status, sync_scope

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Field Detail

piCurrentPushed

protected boolean piCurrentPushed

MID_TARGET

protected static final int MID_TARGET

See Also:

Constant Field Values

MID_EFFECTIVE_TARGET

protected static final int MID_EFFECTIVE_TARGET

See Also:

Constant Field Values

MID_EFFECTIVE_PROFILE

protected static final int MID_EFFECTIVE_PROFILE

See Also:

Constant Field Values

MID_RECEIVED_EXCEPTION

protected static final int MID_RECEIVED_EXCEPTION

See Also:

Constant Field Values

MID_RECEIVED_EXCEPTION_ID

protected static final int MID_RECEIVED_EXCEPTION_ID

See Also:

Constant Field Values

MID_GET_EFFECTIVE_COMPONENT

protected static final int MID_GET_EFFECTIVE_COMPONENT

See Also:

Constant Field Values

MID_GET_EFFECTIVE_COMPONENTS

protected static final int MID_GET_EFFECTIVE_COMPONENTS

See Also:

Constant Field Values

MID_GET_REQUEST_POLICY

protected static final int MID_GET_REQUEST_POLICY

See Also:

Constant Field Values

MID_ADD_REQUEST_SERVICE_CONTEXT

protected static final int MID_ADD_REQUEST_SERVICE_CONTEXT

See Also:

Constant Field Values

Constructor Detail

ClientRequestInfoImpl

protected ClientRequestInfoImpl(ORB myORB)

Creates a new ClientRequestInfo implementation. The constructor is package scope since no other package need create an instance of this class.

Method Detail

target

public Object target()

The object which the client called to perform the operation.

Specified by:

target in interface ClientRequestInfoOperations

See Also:

ClientRequestInfoOperations.effective_target()

effective_target

public Object effective_target()

The actual object on which the operation will be invoked. If the reply_status is LOCATION_FORWARD, then on subsequent requests, effective_target will contain the forwarded IOR while target will remain unchanged.

Specified by:

effective_target in interface ClientRequestInfoOperations

See Also:

ClientRequestInfoOperations.target()

effective_profile

public TaggedProfile effective_profile()

The profile that will be used to send the request. If a location forward has occurred for this operation's object and that object's profile change accordingly, then this profile will be that located profile.

Specified by:

effective_profile in interface ClientRequestInfoOperations

received_exception

public Any received_exception()

Contains the exception to be returned to the client.

Specified by:

received_exception in interface ClientRequestInfoOperations

See Also:

ClientRequestInfoOperations.received_exception_id()

received_exception_id

public String received_exception_id()

The CORBA::RepositoryId of the exception to be returned to the client.

Specified by:

received_exception_id in interface ClientRequestInfoOperations

See Also:

ClientRequestInfoOperations.received_exception(), PortableInterceptor package comments for limitations / unimplemented features

get_effective_component

public TaggedComponent get_effective_component(int id)

Returns the IOP::TaggedComponent with the given ID from the profile selected for this request. IF there is more than one component for a given component ID, it is undefined which component this operation returns (get_effective_component should be called instead).

Specified by:

get_effective_component in interface ClientRequestInfoOperations

Parameters:

id - The component id of the component which is to be returned.

Returns:

The IOP.TaggedComponent obtained with the given identifier.

See Also:

ClientRequestInfoOperations.get_effective_components(int)

get_effective_components

public TaggedComponent[] get_effective_components(int id)

Returns all the tagged components with the given ID from the profile selected for this request.

Specified by:

get_effective_components in interface ClientRequestInfoOperations

Parameters:

id - The component id of the components which are to be returned.

Returns:

An array of TaggedComponent objects, each of which contains the given identifier.

See Also:

ClientRequestInfoOperations.get_effective_component(int)

get_request_policy

public Policy get_request_policy(int type)

Returns the given policy in effect for this operation.

Specified by:

get_request_policy in interface ClientRequestInfoOperations

Parameters:

type - The policy type which specifies the policy to be returned.

Returns:

The CORBA.Policy obtained with the given type.

See Also:

PortableInterceptor package comments for limitations / unimplemented features

add_request_service_context

public void add_request_service_context(ServiceContext service_context,
                                        boolean replace)

Allows interceptors to add service contexts to the request.

There is no declaration of the order of the service contexts. They may or may not appear in the order they are added.

Specified by:

add_request_service_context in interface ClientRequestInfoOperations

Parameters:

service_context - The IOP.ServiceContext to be added to the request.

replace - Indicates the behavior of this operation when a service context already exists with the given ID. If false, then BAD_INV_ORDER with a standard minor code of 15 is thrown. If true, then the existing service context is replaced by the new one.

request_id

public int request_id()

See RequestInfoImpl for javadoc.

Specified by:

request_id in interface RequestInfoOperations

Specified by:

request_id in class RequestInfoImpl

operation

public String operation()

See RequestInfoImpl for javadoc.

Specified by:

operation in interface RequestInfoOperations

Specified by:

operation in class RequestInfoImpl

arguments

public Parameter[] arguments()

See RequestInfoImpl for javadoc.

Specified by:

arguments in interface RequestInfoOperations

Specified by:

arguments in class RequestInfoImpl

See Also:

PortableInterceptor package comments for limitations / unimplemented features

exceptions

public TypeCode[] exceptions()

See RequestInfoImpl for javadoc.

Specified by:

exceptions in interface RequestInfoOperations

Specified by:

exceptions in class RequestInfoImpl

See Also:

PortableInterceptor package comments for limitations / unimplemented features

contexts

public String[] contexts()

See RequestInfoImpl for javadoc.

Specified by:

contexts in interface RequestInfoOperations

Specified by:

contexts in class RequestInfoImpl

See Also:

PortableInterceptor package comments for limitations / unimplemented features

operation_context

public String[] operation_context()

See RequestInfoImpl for javadoc.

Specified by:

operation_context in interface RequestInfoOperations

Specified by:

operation_context in class RequestInfoImpl

See Also:

PortableInterceptor package comments for limitations / unimplemented features

result

public Any result()

See RequestInfoImpl for javadoc.

Specified by:

result in interface RequestInfoOperations

Specified by:

result in class RequestInfoImpl

See Also:

PortableInterceptor package comments for limitations / unimplemented features

response_expected

public boolean response_expected()

See RequestInfoImpl for javadoc.

Specified by:

response_expected in interface RequestInfoOperations

Specified by:

response_expected in class RequestInfoImpl

forward_reference

public Object forward_reference()

See RequestInfoImpl for javadoc.

Specified by:

forward_reference in interface RequestInfoOperations

Specified by:

forward_reference in class RequestInfoImpl

setLocatedIOR

protected void setLocatedIOR(IOR ior)

get_request_service_context

public ServiceContext get_request_service_context(int id)

See RequestInfoImpl for javadoc.

Specified by:

get_request_service_context in interface RequestInfoOperations

Specified by:

get_request_service_context in class RequestInfoImpl

Parameters:

id - The IOP.ServiceId of the service context which is to be returned.

Returns:

The IOP.ServiceContext obtained with the given identifier.

get_reply_service_context

public ServiceContext get_reply_service_context(int id)

does not contain an etry for that ID, BAD_PARAM with a minor code of TBD_BP is raised.

Specified by:

get_reply_service_context in interface RequestInfoOperations

Specified by:

get_reply_service_context in class RequestInfoImpl

Parameters:

id - The IOP.ServiceId of the service context which is to be returned.

Returns:

The IOP.ServiceContext obtained with the given identifier.

connection

public Connection connection()

Specified by:

connection in interface RequestInfoExt

Overrides:

connection in class RequestInfoImpl

Returns:

The connection on which the request is made. Note: we store the connection as an internal type but expose it here as an external type.

setInfo

protected void setInfo(MessageMediator messageMediator)

setReplyStatus

protected void setReplyStatus(short replyStatus)

Overridden from RequestInfoImpl. Calls the super class, then sets the ending point call depending on the reply status.

Overrides:

setReplyStatus in class RequestInfoImpl

setDIIRequest

protected void setDIIRequest(Request req)

Sets DII request object in the RequestInfoObject.

setDIIInitiate

protected void setDIIInitiate(boolean diiInitiate)

Keeps track of whether initiate was called for a DII request. The ORB needs to know this so it knows whether to ignore a second call to initiateClientPIRequest or not.

isDIIInitiate

protected boolean isDIIInitiate()

See comment for setDIIInitiate

setPICurrentPushed

protected void setPICurrentPushed(boolean piCurrentPushed)

The PICurrent stack should only be popped if it was pushed. This is generally the case. But exceptions which occur after the stub's entry to _request but before the push end up in _releaseReply which will try to pop unless told not to.

isPICurrentPushed

protected boolean isPICurrentPushed()

setException

protected void setException(Exception exception)

Overridden from RequestInfoImpl.

Overrides:

setException in class RequestInfoImpl

getIsOneWay

protected boolean getIsOneWay()

checkAccess

protected void checkAccess(int methodID)
                    throws BAD_INV_ORDER

See description for RequestInfoImpl.checkAccess

Specified by:

checkAccess in class RequestInfoImpl

Parameters:

methodID - The ID of this method, one of the MID_* constants. This allows us to easily look up the method access in a table. Note that method ids may overlap between subclasses.

Throws:

BAD_INV_ORDER