org.ws4d.java.service

Class ProxyService.ProxyServiceCallback

java.lang.Object

org.ws4d.java.communication.callback.DefaultResponseCallback

org.ws4d.java.service.ProxyService.ProxyServiceCallback

All Implemented Interfaces:

ResponseCallback

Enclosing class:

ProxyService

protected class ProxyService.ProxyServiceCallback
extends DefaultResponseCallback

Field Summary

Fields inherited from class org.ws4d.java.communication.callback.DefaultResponseCallback

targetXAddressInfo

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ProxyServiceCallback(XAddressInfo targetXAddressInfo, Operation op, ClientSubscription subscription)

Method Summary

Modifier and Type	Method and Description
OperationDescription	getOperation()
void	handle(GetStatusMessage getStatus, GetStatusResponseMessage msg, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Receives a GetStatusResponseMessage.
void	handle(InvokeMessage invokeRequest, InvokeMessage msg, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Receives a InvokeMessage as a response to another request InvokeMessage that has previously been sent by passing this ResponseCallback instance as the third argument to the send method.
void	handle(Message request, FaultMessage msg, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Receives a FaultMessage in response to a previously sent request message.
void	handle(RenewMessage renew, RenewResponseMessage msg, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Receives a RenewResponseMessage.
void	handle(SubscribeMessage subscribe, SubscribeResponseMessage msg, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Receives a SubscribeResponseMessage.
void	handle(UnsubscribeMessage unsubscribe, UnsubscribeResponseMessage msg, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Receives an UnsubscribeResponseMessage.
void	handleMalformedResponseException(Message request, java.lang.Exception exception, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Called when an exception occurs while receiving, decoding or processing the response message to a previously sent request.
void	handleNoContent(Message request, java.lang.String reason, ConnectionInfo connectionInfo, AttributedURI optionalMessageId)
void	handleTimeout(Message request, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Called when an attempt to receive responses to a previously sent request message passed to CommunicationManager.send(Message, ProtocolInfo, DataStructure, ResponseCallback) timeouted.
void	handleTransmissionException(Message request, java.lang.Exception exception, ConnectionInfo connectionInfo, AttributedURI optionalMessageId) Called when an exception arises while sending the request message.

Methods inherited from class org.ws4d.java.communication.callback.DefaultResponseCallback

getEvent, getTargetAddress, handle, handle, handle, handle, logResponse, requestStartedWithTimeout, setTargetAddress

Methods inherited from class java.lang.Object

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

Constructor Detail

ProxyServiceCallback

protected ProxyServiceCallback(XAddressInfo targetXAddressInfo,
                               Operation op,
                               ClientSubscription subscription)

Method Detail

handle

public void handle(SubscribeMessage subscribe,
                   SubscribeResponseMessage msg,
                   ConnectionInfo connectionInfo,
                   AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Receives a SubscribeResponseMessage. The corresponding SubscribeMessage has been sent previously by passing this ResponseCallback instance as the fourth argument to the send method.

Each SubscribeMessage may result in a call to either this method (in case of successful two-way communication), or to methods:

• ResponseCallback.handleTransmissionException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure while sending the request message
• ResponseCallback.handle(Message, FaultMessage, ConnectionInfo, AttributedURI) in case of a failure during request processing on the server side
• ResponseCallback.handleMalformedResponseException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure during response processing on this side
• ResponseCallback.handleTimeout(Message, ConnectionInfo, AttributedURI) in case of a timeout while waiting for responses to the sent request.

Specified by:

handle in interface ResponseCallback

Overrides:

handle in class DefaultResponseCallback

Parameters:

subscribe - the original request message

msg - a message containing the response to the previously sent request

connectionInfo - protocol (aka. technology) specific addressing information attached to the received message

handle

public void handle(InvokeMessage invokeRequest,
                   InvokeMessage msg,
                   ConnectionInfo connectionInfo,
                   AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Receives a InvokeMessage as a response to another request InvokeMessage that has previously been sent by passing this ResponseCallback instance as the third argument to the send method.

Each request InvokeMessage may result in a call to either this method (in case of successful two-way communication), or to methods:

• ResponseCallback.handleTransmissionException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure while sending the request message
• ResponseCallback.handle(Message, FaultMessage, ConnectionInfo, AttributedURI) in case of a failure during request processing on the server side
• ResponseCallback.handleMalformedResponseException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure during response processing on this side
• ResponseCallback.handleTimeout(Message, ConnectionInfo, AttributedURI) in case of a timeout while waiting for responses to the sent request.

In case of successful one-way communication, no method of this interface is called.

Specified by:

handle in interface ResponseCallback

Overrides:

handle in class DefaultResponseCallback

Parameters:

invokeRequest - the original request message

msg - a message containing the response to the previously sent request

connectionInfo - protocol (aka. technology) specific addressing information attached to the received message

handle

public void handle(Message request,
                   FaultMessage msg,
                   ConnectionInfo connectionInfo,
                   AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Receives a FaultMessage in response to a previously sent request message.

A fault is raised on the responding side while processing the request message and then sent back to the requester (aka. this side). It is explicitly NOT created on this side while processing the received response (see method ResponseCallback.handleMalformedResponseException(Message, Exception, ConnectionInfo, AttributedURI) for the latter case).

Specified by:

handle in interface ResponseCallback

Overrides:

handle in class DefaultResponseCallback

Parameters:

request - the original request message

msg - the fault generated by the responding side

connectionInfo - protocol (aka. technology) specific addressing information attached to the received message

handleMalformedResponseException

public void handleMalformedResponseException(Message request,
                                             java.lang.Exception exception,
                                             ConnectionInfo connectionInfo,
                                             AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Called when an exception occurs while receiving, decoding or processing the response message to a previously sent request. The exception is passed to argument exception

Specified by:

handleMalformedResponseException in interface ResponseCallback

Overrides:

handleMalformedResponseException in class DefaultResponseCallback

Parameters:

request - the original request message

exception - the exception caused during processing the response

connectionInfo - protocol (aka. technology) specific addressing information related to the malformed response

handleNoContent

public void handleNoContent(Message request,
                            java.lang.String reason,
                            ConnectionInfo connectionInfo,
                            AttributedURI optionalMessageId)

Specified by:

handleNoContent in interface ResponseCallback

Overrides:

handleNoContent in class DefaultResponseCallback

handleTransmissionException

public void handleTransmissionException(Message request,
                                        java.lang.Exception exception,
                                        ConnectionInfo connectionInfo,
                                        AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Called when an exception arises while sending the request message. This could be e.g. due to network reachability reasons, an IO problem within the transport connection, an invalid message construct, etc.

Specified by:

handleTransmissionException in interface ResponseCallback

Overrides:

handleTransmissionException in class DefaultResponseCallback

Parameters:

request - the request message which was meant to be sent when the exception occurred

exception - the exception cause while sending the request message

connectionInfo - protocol (aka. technology) specific addressing information related to the transmission exception

handleTimeout

public void handleTimeout(Message request,
                          ConnectionInfo connectionInfo,
                          AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Called when an attempt to receive responses to a previously sent request message passed to CommunicationManager.send(Message, ProtocolInfo, DataStructure, ResponseCallback) timeouted. This can only happen when using an unreliable connectionless transport layer for message transmission, such as UDP. Note that any other error related to sending the original request message is notified by the callback method ResponseCallback.handleTransmissionException(Message, Exception, ConnectionInfo, AttributedURI) . The original (request) message that was meant to be sent is passed as argument request.

Specified by:

handleTimeout in interface ResponseCallback

Overrides:

handleTimeout in class DefaultResponseCallback

Parameters:

request - the message meant to be sent, which resulted in a timeout

connectionInfo - protocol (aka. technology) specific addressing information attached to the received message

handle

public void handle(RenewMessage renew,
                   RenewResponseMessage msg,
                   ConnectionInfo connectionInfo,
                   AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Receives a RenewResponseMessage. The corresponding RenewMessage has been sent previously by passing this ResponseCallback instance as the fourth argument to the send method.

Each RenewMessage may result in a call to either this method (in case of successful two-way communication), or to methods:

• ResponseCallback.handleTransmissionException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure while sending the request message
• ResponseCallback.handle(Message, FaultMessage, ConnectionInfo, AttributedURI) in case of a failure during request processing on the server side
• ResponseCallback.handleMalformedResponseException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure during response processing on this side
• ResponseCallback.handleTimeout(Message, ConnectionInfo, AttributedURI) in case of a timeout while waiting for responses to the sent request.

Specified by:

handle in interface ResponseCallback

Overrides:

handle in class DefaultResponseCallback

Parameters:

renew - the original request message

msg - a message containing the response to the previously sent request

connectionInfo - protocol (aka. technology) specific addressing information attached to the received message

handle

public void handle(UnsubscribeMessage unsubscribe,
                   UnsubscribeResponseMessage msg,
                   ConnectionInfo connectionInfo,
                   AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Receives an UnsubscribeResponseMessage. The corresponding UnsubscribeMessage has been sent previously by passing this ResponseCallback instance as the third argument to the send method.

Each UnsubscribeMessage may result in a call to either this method (in case of successful two-way communication), or to methods:

• ResponseCallback.handleTransmissionException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure while sending the request message
• ResponseCallback.handle(Message, FaultMessage, ConnectionInfo, AttributedURI) in case of a failure during request processing on the server side
• ResponseCallback.handleMalformedResponseException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure during response processing on this side
• ResponseCallback.handleTimeout(Message, ConnectionInfo, AttributedURI) in case of a timeout while waiting for responses to the sent request.

Specified by:

handle in interface ResponseCallback

Overrides:

handle in class DefaultResponseCallback

Parameters:

unsubscribe - the original request message

msg - a message containing the response to the previously sent request

connectionInfo - protocol (aka. technology) specific addressing information attached to the received message

handle

public void handle(GetStatusMessage getStatus,
                   GetStatusResponseMessage msg,
                   ConnectionInfo connectionInfo,
                   AttributedURI optionalMessageId)

Description copied from interface: ResponseCallback

Receives a GetStatusResponseMessage. The corresponding GetStatusMessage has been sent previously by passing this ResponseCallback instance as the fourth argument to the send method.

Each GetStatusMessage may result in a call to either this method (in case of successful two-way communication), or to methods:

• ResponseCallback.handleTransmissionException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure while sending the request message
• ResponseCallback.handle(Message, FaultMessage, ConnectionInfo, AttributedURI) in case of a failure during request processing on the server side
• ResponseCallback.handleMalformedResponseException(Message, Exception, ConnectionInfo, AttributedURI) in case of a failure during response processing on this side
• ResponseCallback.handleTimeout(Message, ConnectionInfo, AttributedURI) in case of a timeout while waiting for responses to the sent request.

Specified by:

handle in interface ResponseCallback

Overrides:

handle in class DefaultResponseCallback

Parameters:

getStatus - the original request message

msg - a message containing the response to the previously sent request

connectionInfo - protocol (aka. technology) specific addressing information attached to the received message

getOperation

public OperationDescription getOperation()

Specified by:

getOperation in interface ResponseCallback

Overrides:

getOperation in class DefaultResponseCallback