All the action for a synchronous twoway invocation happen here. More...

#include <Synch_Invocation.h>

Inheritance diagram for TAO::Synch_Twoway_Invocation:

Collaboration diagram for TAO::Synch_Twoway_Invocation:

Public Member Functions
	Synch_Twoway_Invocation (CORBA::Object_ptr otarget, Profile_Transport_Resolver &resolver, TAO_Operation_Details &detail, bool response_expected=true)
	Constructor used by TAO::Invocation_Adapter.
Invocation_Status	remote_twoway (ACE_Time_Value *max_wait_time)
Public Member Functions inherited from TAO::Remote_Invocation
	Remote_Invocation (CORBA::Object_ptr otarget, Profile_Transport_Resolver &resolver, TAO_Operation_Details &detail, bool response_expected)
Public Member Functions inherited from TAO::Invocation_Base
virtual	~Invocation_Base (void)
TAO_Stub *	stub (void) const
	Accessor and mutator methods.
CORBA::Object_ptr	forwarded_reference (void)
void	forwarded_reference (CORBA::Object_ptr o)
	Accessor and mutator methods.
TAO_Service_Context &	request_service_context (void)
	Accessors for the service context list.
TAO_Service_Context &	reply_service_context (void)
	Accessor and mutator methods.
CORBA::Object_ptr	steal_forwarded_reference (void)
	Return the forwarded object location by loosing ownership.
CORBA::Object_ptr	effective_target (void) const
	Return the effective target of the invocation.
CORBA::Object_ptr	target (void) const
	Return the target object.
CORBA::Boolean	response_expected (void) const
	Does this invocation return a response?
GIOP::ReplyStatusType	reply_status (void) const
	Accessor of reply_status of the invocation.
void	reply_status (GIOP::ReplyStatusType s)
	Mutator of reply_status of the invocation.
TAO_Operation_Details &	operation_details (void)
	The operaton details of the invocation.
size_t &	stack_size (void)
CORBA::Exception *	caught_exception (void)
	The client requestor adapter.
TAO::Invocation_Status	invoke_status (void) const
	Invocation status.
void	invoke_status (Invocation_Status s)
	Mutator to set the invocation status.
PortableInterceptor::ReplyStatus	pi_reply_status (void) const
	The client requestor adapter.
bool	is_remote_request () const

Protected Member Functions
virtual Invocation_Status	handle_user_exception (TAO_InputCDR &cdr)
Invocation_Status	location_forward (TAO_InputCDR &cdr)
	Helper method used to handle location forwarded replies.
Invocation_Status	handle_system_exception (TAO_InputCDR &cdr)
Invocation_Status	wait_for_reply (ACE_Time_Value *max_wait_time, TAO_Synch_Reply_Dispatcher &rd, TAO_Bind_Dispatcher_Guard &bd)
	As the name suggests waits for a reply from the remote ORB.
Protected Member Functions inherited from TAO::Remote_Invocation
void	init_target_spec (TAO_Target_Specification &spec, TAO_OutputCDR &output)
	Initialize the spec.
void	write_header (TAO_OutputCDR &out_stream)
	Write the GIOP header into the stream.
void	marshal_data (TAO_OutputCDR &cdr)
	Marshal the arguments into the stream.
Invocation_Status	send_message (TAO_OutputCDR &cdr, TAO_Message_Semantics message_semantics, ACE_Time_Value *max_wait_time)
	Write the message onto the socket.
Protected Member Functions inherited from TAO::Invocation_Base
	Invocation_Base (CORBA::Object_ptr otarget, CORBA::Object_ptr target, TAO_Stub *stub, TAO_Operation_Details &op, bool response_expected, bool request_is_remote)
Invocation_Status	send_request_interception (void)
Invocation_Status	receive_reply_interception (void)
Invocation_Status	receive_other_interception (void)
PortableInterceptor::ReplyStatus	handle_any_exception (CORBA::Exception *e)
PortableInterceptor::ReplyStatus	handle_all_exception (void)
	The client requestor adapter.

Private Member Functions
Invocation_Status	check_reply_status (TAO_Synch_Reply_Dispatcher &rd)

Additional Inherited Members
Protected Attributes inherited from TAO::Remote_Invocation
Profile_Transport_Resolver &	resolver_
	Our resolver.
Protected Attributes inherited from TAO::Invocation_Base
TAO_Operation_Details &	details_
	The operation details on which we are operating on.
CORBA::Object_var	forwarded_to_
	Forwarded object reference.
bool	response_expected_
	Is response expected?
GIOP::ReplyStatusType	reply_status_
	A GIOP reply status of the invocation.
ClientRequestInterceptor_Adapter *	cri_adapter_
	The client requestor adapter.
ServerRequestInterceptor_Adapter *	sri_adapter_
	The client requestor adapter.
size_t	stack_size_
	The client requestor adapter.
TAO::Invocation_Status	invoke_status_
	The client requestor adapter.

Detailed Description

All the action for a synchronous twoway invocation happen here.

An object of this type is created by TAO::Invocation_Adapter and invokes a method on this class. The method takes care of creating and sending a request, waiting for a reply and demarshalling the reply for the client.

Constructor & Destructor Documentation

TAO::Synch_Twoway_Invocation::Synch_Twoway_Invocation	(	CORBA::Object_ptr	otarget,
		Profile_Transport_Resolver &	resolver,
		TAO_Operation_Details &	detail,
		bool	response_expected = `true`
	)

Constructor used by TAO::Invocation_Adapter.

Parameters:

otarget	The original target on which this invocation was started. This is there to be passed up to its parent class.
resolver	The profile and transport holder.
detail	Operation details of the invocation on the target
response_expected	Flag to indicate whether the operation encapsulated by op returns a response or not.

Member Function Documentation

Invocation_Status TAO::Synch_Twoway_Invocation::check_reply_status ( TAO_Synch_Reply_Dispatcher & rd )

private

Helper method that checks the reply status of the replies and takes appropriate action. This method returns an exception when there is an error.

Invocation_Status TAO::Synch_Twoway_Invocation::handle_system_exception ( TAO_InputCDR & cdr )

protected

Helper method used to handle system exceptions from the remote objects.

There has been a unanimous view that this is not the right way to do things. But a need to be compliant is forcing us into this.

       @note A location forwarding loop may occur where a client
             is bounced from the original target to the forwarded
             target and back if the application is not equipped to
             handle retries of previously called targets.  TAO may
             be able to help in this case but it ultimately ends
             up being an application issue.

Invocation_Status TAO::Synch_Twoway_Invocation::handle_user_exception ( TAO_InputCDR & cdr )

protectedvirtual

This method is selectively made virtual, so that inherited classes can overload the user exception handling type. For example the DII needs a totally different method of user exception exception handling

Invocation_Status TAO::Synch_Twoway_Invocation::location_forward ( TAO_InputCDR & cdr )

protected

Helper method used to handle location forwarded replies.

Invocation_Status TAO::Synch_Twoway_Invocation::remote_twoway ( ACE_Time_Value * max_wait_time )

Method used by the adapter to kickstart an invocation to the remote object. There is a exception declaration in this method which ensures that the exceptions propogated by the remote objects are converted a CORBA exceptions for the clients. This method does a bunch of things necessary to create and send the invocation. This method is also nerve centre for the interceptor invocation points.

Invocation_Status TAO::Synch_Twoway_Invocation::wait_for_reply	(	ACE_Time_Value *	max_wait_time,
		TAO_Synch_Reply_Dispatcher &	rd,
		TAO_Bind_Dispatcher_Guard &	bd
	)

protected

As the name suggests waits for a reply from the remote ORB.

This method returns an exception when there is an error.

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation