org.cipango.client

Class RequestHandler

java.lang.Object

org.cipango.client.AbstractChallengedMessageHandler

org.cipango.client.RequestHandler

All Implemented Interfaces:

ChallengedMessageHandler, MessageHandler

public class RequestHandler
extends AbstractChallengedMessageHandler

Handles a transaction, keeping track of all responses received in a list.

If credentials are provided, then authentication is automatically handled with the help of a AuthenticationHelper throughout the whole transaction. Responses with a challenge which can be successfully resolved by the helper are not directly propagated to the user, but are recorded in the request responses list anyway.

Field Summary

Fields inherited from class org.cipango.client.AbstractChallengedMessageHandler

HANDLED_ATTRIBUTE

Constructor Summary

Constructors

Constructor and Description
RequestHandler(javax.servlet.sip.SipServletRequest request, long timeout)

Method Summary

Methods

Modifier and Type	Method and Description
javax.servlet.sip.SipServletResponse	getLastResponse()
javax.servlet.sip.SipServletResponse	getNextResponse()
List<javax.servlet.sip.SipServletResponse>	getResponses()
boolean	handleAuthentication(javax.servlet.sip.SipServletResponse response) Handles responses containing a challenge.
void	handleRequest(javax.servlet.sip.SipServletRequest request)
void	handleResponse(javax.servlet.sip.SipServletResponse response)
void	send()
javax.servlet.sip.SipServletResponse	waitForFinalResponse()
javax.servlet.sip.SipServletResponse	waitForNextResponse()

Methods inherited from class org.cipango.client.AbstractChallengedMessageHandler

addToCredentials, doWait, doWait, getAuthenticationHelper, getCredentials, getOrCreateAuthenticationHelper, getTimeout, setCredentials, setTimeout

Methods inherited from class java.lang.Object

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

Constructor Detail

RequestHandler

public RequestHandler(javax.servlet.sip.SipServletRequest request,
              long timeout)

Method Detail

send

public void send()
          throws IOException,
                 javax.servlet.ServletException

Throws:

IOException

javax.servlet.ServletException

getNextResponse

public javax.servlet.sip.SipServletResponse getNextResponse()

getLastResponse

public javax.servlet.sip.SipServletResponse getLastResponse()

waitForNextResponse

public javax.servlet.sip.SipServletResponse waitForNextResponse()

waitForFinalResponse

public javax.servlet.sip.SipServletResponse waitForFinalResponse()

getResponses

public List<javax.servlet.sip.SipServletResponse> getResponses()

handleRequest

public void handleRequest(javax.servlet.sip.SipServletRequest request)
                   throws IOException,
                          javax.servlet.ServletException

Throws:

IOException

javax.servlet.ServletException

handleResponse

public void handleResponse(javax.servlet.sip.SipServletResponse response)
                    throws IOException,
                           javax.servlet.ServletException

Throws:

IOException

javax.servlet.ServletException

handleAuthentication

public boolean handleAuthentication(javax.servlet.sip.SipServletResponse response)
                             throws IOException,
                                    javax.servlet.ServletException

Description copied from interface: ChallengedMessageHandler

Handles responses containing a challenge.

Specified by:

handleAuthentication in interface ChallengedMessageHandler

Overrides:

handleAuthentication in class AbstractChallengedMessageHandler

Returns:

true if the message should be forwarded up to this MessageHandler user, false otherwise.

Throws:

IOException

javax.servlet.ServletException