com.sun.corba.ee.spi.protocol

Interface ClientRequestDispatcher

All Known Implementing Classes:

ClientRequestDispatcherImpl, SharedCDRClientRequestDispatcherImpl

public interface ClientRequestDispatcher

ClientRequestDispatcher coordinates the request (and possible response) processing for a specific protocol.

Author:

Harold Carr

Method Summary

Modifier and Type	Method and Description
CDROutputObject	beginRequest(Object self, String methodName, boolean isOneWay, ContactInfo contactInfo) At the beginning of a request the presentation block uses this to obtain an OutputObject to set data to be sent on a message.
void	endRequest(ORB broker, Object self, CDRInputObject inputObject) After the presentation block completes a request it signals the PEPt runtime by calling this method.
CDRInputObject	marshalingComplete(Object self, CDROutputObject outputObject) After the presentation block has set data on the CDROutputObject it signals the PEPt runtime to send the encoded data by calling this method.

Method Detail

beginRequest

CDROutputObject beginRequest(Object self,
                             String methodName,
                             boolean isOneWay,
                             ContactInfo contactInfo)

At the beginning of a request the presentation block uses this to obtain an OutputObject to set data to be sent on a message.

Parameters:

self - -

methodName - - the remote method name

isOneWay - - true if the message is asynchronous

contactInfo - - the CorbaContactInfo which which created/chose this ClientRequestDispatcher

Returns:

OutputObject

marshalingComplete

CDRInputObject marshalingComplete(Object self,
                                  CDROutputObject outputObject)
                           throws ApplicationException,
                                  RemarshalException

After the presentation block has set data on the CDROutputObject it signals the PEPt runtime to send the encoded data by calling this method.

Parameters:

self - -

outputObject -

Returns:

CDRInputObject if the message is synchronous.

Throws:

{@link - org.omg.CORBA.portable.ApplicationException ApplicationException} if the remote side raises an exception declared in the remote interface.

{@link - org.omg.CORBA.portable.RemarshalException RemarshalException} if the PEPt runtime would like the presentation block to start over.

ApplicationException

RemarshalException

endRequest

void endRequest(ORB broker,
                Object self,
                CDRInputObject inputObject)

After the presentation block completes a request it signals the PEPt runtime by calling this method. This method may release resources. In some cases it may cause control or error messages to be sent.

Parameters:

broker - -

inputObject - -