Examples of javax.sip.message.Response

javax.sip.message.Response
etf.org/rfc/rfc3262.txt">RFC 3262. When the UAC creates a new request, it can insist on reliable delivery of provisional responses for that request. To do that, it inserts a Require header field with the option tag 100rel into the request. A Require header with the value 100rel MUST NOT be present in any requests excepting INVITE, although other extensions to SIP may allow its usage with other request methods. If the UAC does not wish to insist on usage of reliable provisional responses, but merely indicate that it supports them if the UAS needs to send one, a Supported header MUST be included in the request with the option tag 100rel. The UAC SHOULD include this in all INVITE requests.
A UAS MAY send any non-100 provisional response to INVITE reliably, so long as the initial INVITE request (the request whose provisional response is being sent reliably) contained a Supported header field with the option tag 100rel. The provisional response to be sent reliably is constructed by the UAS and MUST contain a Require header field containing the option tag 100rel, and MUST include an RSeq header field. Retransmissions of the reliable provisional response cease when a matching PRACK is received by the UA core. PRACK is like any other request within a dialog, and is treated likewise. A matching PRACK is defined as one within the same dialog as the response, and whose method, CSeq-num, and RSeq-num in the RAck header field match, respectively, the method and sequence number from the CSeq and the sequence number from the RSeq of the reliable provisional response.

2xx: Success -- the action was successfully received, understood, and accepted.

3xx: Redirection -- further action needs to be taken in order to complete the request; 3xx responses give information about the user's new location, or about alternative services that might be able to satisfy the call.

4xx: Client Error -- the request contains bad syntax or cannot be fulfilled at this server; 4xx responses are definite failure responses from a particular server. The client SHOULD NOT retry the same request without modification. However, the same request to a different server might be successful.

5xx: Server Error -- the server failed to fulfill an apparently valid request; 5xx responses are failure responses given when a server itself has erred.

6xx: Global Failure -- the request cannot be fulfilled at any server; 6xx responses indicate that a server has definitive information about a particular user, not just the particular instance indicated in the Request-URI. SIP status codes are extensible. The response codes are consistent with, and extend, HTTP/1.1 response codes. Not all HTTP/1.1 response codes are appropriate, and only those that are appropriate are given here. Other HTTP/1.1 response codes SHOULD NOT be used. Also, SIP defines a new class, 6xx.

SIP applications are not required to understand the meaning of all registered response codes, though such understanding is obviously desirable. However, applications must understand the class of any status code, as indicated by the first digit and outlined above. Applications treat any unrecognized status code as being equivalent to the x00 status code of that class, with the exception that an unrecognized status code must not be cached. For example, if a client receives an unrecognized status code of 431, it can safely assume that there was something wrong with its request and treat the Response as if it had received a BAD_REQUEST(400) status code. In such cases, user agents should present to the user the message body returned with the Response, since that message body is likely to include human-readable information which will explain the unusual status.

This specification supports the response codes defined in RFC3261 and also the response code extensions for the event notification framework and PUBLISH, documented in RFC3265 and RFC3909, these are highlighted in italic. Class status codes (x00, i.e. 100) are are highlighted in bold.

Class	Code
PROVISIONAL (1xx)	TRYING - 100 RINGING - 180 CALL_IS_BEING_FORWARDED - 181 QUEUED - 182 SESSION_PROGRESS - 183
SUCCESS (2xx)	OK - 200 ACCEPTED - 202 (Extension RFC3265)
REDIRECTION (3xx)	MULTIPLE_CHOICES - 300 MOVED_PERMANENTLY - 301 MOVED_TEMPORARILY - 302 USE_PROXY - 305 ALTERNATIVE_SERVICE - 380
CLIENT_ERROR (4xx)	BAD_REQUEST - 400 UNAUTHORIZED - 401 PAYMENT_REQUIRED - 402 FORBIDDEN - 403 NOT_FOUND - 404 METHOD_NOT_ALLOWED - 405 NOT_ACCEPTABLE - 406 PROXY_AUTHENTICATION_REQUIRED - 407 REQUEST_TIMEOUT - 408 GONE - 410 CONDITIONAL_REQUEST_FAILED - 412 (Extension RFC3909) REQUEST_ENTITY_TOO_LARGE - 413 REQUEST_URI_TOO_LONG - 414 UNSUPPORTED_MEDIA_TYPE - 415 UNSUPPORTED_URI_SCHEME - 416 BAD_EXTENSION - 420 EXTENSION_REQUIRED - 421 INTERVAL_TOO_BRIEF - 423 TEMPORARILY_UNAVAILABLE - 480 CALL_OR_TRANSACTION_DOES_NOT_EXIST - 481 LOOP_DETECTED - 482 TOO_MANY_HOPS - 483 ADDRESS_INCOMPLETE - 484 AMBIGUOUS - 485 BUSY_HERE - 486 REQUEST_TERMINATED - 487 NOT_ACCEPTABLE_HERE - 488 BAD EVENT - 489 (Extension RFC3265) REQUEST_PENDING - 491 UNDECIPHERABLE - 493
SERVER_ERROR (5xx)	SERVER_INTERNAL_ERROR - 500 NOT_IMPLEMENTED - 501 BAD_GATEWAY - 502 SERVICE_UNAVAILABLE - 503 SERVER_TIMEOUT - 504 VERSION_NOT_SUPPORTED - 505 MESSAGE_TOO_LARGE - 513
GLOBAL_ERROR (6xx)	BUSY_EVERYWHERE - 600 DECLINE - 603 DOES_NOT_EXIST_ANYWHERE - 604 SESSION_NOT_ACCEPTABLE - 606

@author BEA Systems, NIST @version 1.2

  public void testRequires() throws Exception {  
    RegisterSession session =  new RegisterSession(getAlicePhone());
    Request request = session.createRegister(null, 1800);
    request.addHeader(__headerFactory.createRequireHeader("ext1"));
    request.addHeader(__headerFactory.createRequireHeader("ext2"));
    Response response = 
      session.sendRegistrationMessage(request, Response.BAD_EXTENSION);


    assertHeaderContains(response, UnsupportedHeader.NAME, "ext1");
    assertHeaderContains(response, UnsupportedHeader.NAME, "ext2");

  protected void sendRegisterNoContact(RegisterSession session, List<String> expectedContacts) throws Exception
  {
    Request request = session.createRegister(null, 1800);
    request.removeHeader(ContactHeader.NAME);
    request.removeHeader(ExpiresHeader.NAME);
    Response response = 
      session.sendRegistrationMessage(request, Response.OK);
    
    List<String> noParams = new ArrayList<String>();
    Iterator<String> it1 = expectedContacts.iterator();
    while (it1.hasNext()) {
      String uri = (String) it1.next();
      int index = uri.indexOf(';');
      if (index != -1)
        uri = uri.substring(0, index);
      noParams.add(uri);
    }
    
    Iterator<ContactHeader> it = response.getHeaders(ContactHeader.NAME);
    while (it.hasNext()) {
      String uri = it.next().getAddress().getURI().toString();
      int index = uri.indexOf(';');
      if (index != -1)
        uri = uri.substring(0, index);

  
    public void testMinExpires() throws Exception
    {       
        SubscribeSession session = new SubscribeSession(getAlicePhone(), "presence.winfo");
        Request request = session.newInitialSubscribe(1, getAliceUri());
        Response response = session.sendRequest(request, SipResponse.INTERVAL_TOO_BRIEF);
        MinExpiresHeader minExpiresHeader = (MinExpiresHeader) response.getHeader(MinExpiresHeader.NAME);
        assertNotNull(minExpiresHeader);
    }

    
    public void testEtags() throws Exception
    {       
       PublishSession publishSession = new PublishSession(getBobPhone());
         Request publish = publishSession.newPublish(getClass().getResourceAsStream("publish1.xml"), 20);
         Response response = publishSession.sendRequest(publish, SipResponse.OK);
         
         SIPETagHeader etagHeader = (SIPETagHeader) response.getHeader(SIPETagHeader.NAME);
         assertNotNull(etagHeader);
         String etag = etagHeader.getETag();
         
         publish = publishSession.newPublish(getClass().getResourceAsStream("publish2.xml"), 20);
         HeaderFactory hf = publishSession.getHeaderFactory();
         publish.setHeader(hf.createSIPIfMatchHeader(etag));
         response = publishSession.sendRequest(publish, SipResponse.OK);
         etagHeader = (SIPETagHeader) response.getHeader(SIPETagHeader.NAME);
         assertNotNull(etagHeader);
         
         publish = publishSession.newPublish(getClass().getResourceAsStream("publish1.xml"), 20);
         publish.setHeader(hf.createSIPIfMatchHeader(etag)); //Use old etag
         response = publishSession.sendRequest(publish, SipServletResponse.SC_CONDITIONAL_REQUEST_FAILED);

      int expectedResponseCode)
  {
    SipTransaction trans = _sipPhone.sendRequestWithTransaction(request,
        true, null);


    Response response = waitResponse(trans);
    int status_code = response.getStatusCode();


    while (status_code != expectedResponseCode)
    {
      if (status_code == Response.TRYING)
      {
        response = waitResponse(trans);
        status_code = response.getStatusCode();
      }
      else if ((status_code == Response.UNAUTHORIZED)
          || (status_code == Response.PROXY_AUTHENTICATION_REQUIRED))
      {
        // modify the request to include user authorization info
        request = _sipPhone.processAuthChallenge(response, request,
            user, password);
        if (request == null)
          return null;


        // clean up last transaction
        _sipPhone.clearTransaction(trans);


        // send the request again
        trans = _sipPhone.sendRequestWithTransaction(request, true,
            null);


        response = waitResponse(trans);
        status_code = response.getStatusCode();
      }
      else
      {
        fail("The status code " + status_code + " "
            + response.getReasonPhrase()
            + " was received from the server when expected "
            + expectedResponseCode);
      }
    }

    public Response sendRegistrationMessage(Request request, String user,
              String password, int expectedResponseCode)
      {
        SipTransaction trans = _sipPhone.sendRequestWithTransaction(request, true, null);


        Response response = waitResponse(trans);
        int status_code = response.getStatusCode();


        while (status_code != expectedResponseCode)
        {
            if (status_code == Response.TRYING)
            {
                response = waitResponse(trans);
                status_code = response.getStatusCode();
            }
            else if ((status_code == Response.UNAUTHORIZED)
                    || (status_code == Response.PROXY_AUTHENTICATION_REQUIRED))
            {
                // modify the request to include user authorization info
                request = _sipPhone.processAuthChallenge(response, request, user, password);
                if (request == null)
                    return null;


                _cseq++;
                // clean up last transaction
                _sipPhone.clearTransaction(trans);


                // send the request again
                trans = _sipPhone.sendRequestWithTransaction(request, true, null);


                response = waitResponse(trans);
                status_code = response.getStatusCode();
            }
            else
            {
                fail("The status code " + status_code + " " + response.getReasonPhrase() +
                    " was received from the server when expected " + expectedResponseCode);
            }
        }


        lastRegistrationRequest = request;

Examples of javax.sip.message.Response

Related Classes of javax.sip.message.Response