javax.sip
Class ResponseEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--javax.sip.ResponseEvent

All Implemented Interfaces:

java.io.Serializable

public class ResponseEvent

extends java.util.EventObject

This class represents a Response event that is passed from a SipProvider to its SipListener. This specification handles the passing of Response messages to the application with the event model. An application (SipListener) registers with the SIP protocol stack (SipProvider) and listens for Response events from the SipProvider.

This specification defines a single Response event object to handle all Response messages. The Response event encapsulates the Response message that can be retrieved from getResponse(). Therefore the event type of a Response event can be determined as follows:

eventType == ResponseEvent.getResponse().getStatusCode();

A Response event also encapsulates the client transaction upon which the Response is correlated, i.e. the client transaction of the Request message upon which this is a Response.

ResponseEvent contains the following elements:

• source - the source of the event i.e. the SipProvider sending the ResponseEvent.
• clientTransaction - the client transaction this ResponseEvent is associated with.
• Response - the Response message received on the SipProvider that needs passed to the application encapsulated in a ResponseEvent.

Since:

v1.1

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.EventObject

source

Constructor Summary

ResponseEvent(java.lang.Object source, ClientTransaction clientTransaction, Response response)
Constructs a ResponseEvent encapsulating the Response that has been received by the underlying SipProvider.

Method Summary

ClientTransaction	getClientTransaction() Gets the client transaction associated with this ResponseEvent
Response	getResponse() Gets the Response message encapsulated in this ResponseEvent.

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ResponseEvent

public ResponseEvent(java.lang.Object source,
                     ClientTransaction clientTransaction,
                     Response response)

Constructs a ResponseEvent encapsulating the Response that has been received by the underlying SipProvider. This ResponseEvent once created is passed to SipListener.processResponse(ResponseEvent) method of the SipListener for application processing.

Parameters:

source - - the source of ResponseEvent i.e. the SipProvider

clientTransaction - - client transaction upon which this Response was sent

response - - the Response message received by the SipProvider

Method Detail

getClientTransaction

public ClientTransaction getClientTransaction()

Gets the client transaction associated with this ResponseEvent

Returns:

client transaction associated with this ResponseEvent

getResponse

public Response getResponse()

Gets the Response message encapsulated in this ResponseEvent.

Returns:

the response associated with this ResponseEvent.