Examples of javax.sip.header.ContactHeader

javax.sip.header.ContactHeader
A Contact header field value provides a URI whose meaning depends on the type of request or response it is in. A Contact header field value can contain a display name, a URI with URI parameters, and header parameters.
The Contact header field provides a SIP or SIPS URI that can be used to contact that specific instance of the User Agent for subsequent requests. The Contact header field MUST be present and contain exactly one SIP or SIPS URI in any request that can result in the establishment of a dialog. For the methods defined in this specification, that includes only the INVITE request. For these requests, the scope of the Contact is global. That is, the Contact header field value contains the URI at which the User Agent would like to receive requests, and this URI MUST be valid even if used in subsequent requests outside of any dialogs.
If the Request-URI or top Route header field value contains a SIPS URI, the Contact header field MUST contain a SIPS URI as well.
Messages and Contact Headers
- Requests: A contact header is mandatory for INVITE's and optional for ACK, OPTIONS and REGISTER requests. This allows the callee to send future Requests, such as BYE Requests, directly to the caller instead of through a series of proxies.
- Informational Responses - A contact header is optional in a Informational Response to an INVITE request. It has the same semantics in an Informational Response as a Success Response.
- Success Responses - A contact header is mandatory in response to INVITE's and optional in response to OPTIONS and REGISTER requests. An user agent server sending a Success Response to an INIVTE must insert a ContactHeader in the Response indicating the SIP address under which it is reachable most directly for future SIP Requests.
- Redirection Responses - A contact header is optional in response to INVITE's, OPTIONS, REGISTER and BYE requests. A proxy may also delete the contact header.
- Ambiguous Header: - A contact header is optional in response to INVITE, OPTIONS, REGISTER and BYE requests.
The ContactHeader defines the Contact parameters "q" and "expires". The q-value value is used to prioritize addresses in a list of contact addresses. The expires value suggests an expiration interval that indicates how long the client would like a registration to be valid for a specific address. These parameters are only used when the Contact is present in a:
- REGISTER request
- REGISTER response
- 3xx response
For Example:
Contact: "Mr. Watson" sip:watson@worcester.jcp.org; q=0.7; expires=3600, "Mr. Watson" mailto:watson@jcp.org.com; q=0.1 @see HeaderAddress @see Parameters @author BEA Systems, NIST @version 1.2

    RegisterSession session = new RegisterSession(getAlicePhone());
    Request request = session.createRegister(null, 1800);
    Response response = 
      session.sendRegistrationMessage(request, Response.OK);
    ListIterator<ContactHeader> contacts = response.getHeaders(ContactHeader.NAME);
    ContactHeader contact = contacts.next();
    assertBetween(1795, 1800, contact.getExpires());
    assertEquals(getAlicePhone().getContactInfo().getContactHeader().getAddress(), contact.getAddress());
    assertFalse(contacts.hasNext());
    


        request = session.createRegister(null, 0);
    response =   session.sendRegistrationMessage(request, Response.OK);

View Full Code Here

  @SuppressWarnings("unchecked")
  public void testMultipleContacts() throws Exception
  {
    RegisterSession session =  new RegisterSession(getAlicePhone());
    Request request = session.createRegister(null, 1800);
    ContactHeader contact2 = newContact("<sip:localhost>");
    contact2.setExpires(1500);
    request.addHeader(contact2);
    Response response = 
      session.sendRegistrationMessage(request, Response.OK);
    ListIterator<ContactHeader> contacts = response.getHeaders(ContactHeader.NAME);
    while (contacts.hasNext()) {
      ContactHeader contact = (ContactHeader) contacts.next();
      if (contact.getExpires() > 1795 && contact.getExpires() <= 1800)
        assertEquals(getAlicePhone().getContactInfo().getContactHeader().getAddress(), contact.getAddress());
      else
      {
        assertBetween(contact2.getExpires() -5, contact2.getExpires(), contact.getExpires());
        assertEquals(contact2.getAddress(), contact.getAddress());  
      }
    }
    
        request = session.createRegister(contact2.getAddress().toString(), 0);
    response =   session.sendRegistrationMessage(request, Response.OK);
    contacts = response.getHeaders(ContactHeader.NAME);
    ContactHeader contact = contacts.next();
    assertBetween(1780, 1800, contact.getExpires());
    assertEquals(getAlicePhone().getContactInfo().getContactHeader().getAddress(), contact.getAddress());
    assertFalse(contacts.hasNext());
  }

View Full Code Here

  
  public void testWilcard() throws Exception
  {
    RegisterSession session =  new RegisterSession(getAlicePhone());
    Request request = session.createRegister(null, 1800);
    ContactHeader contact2 = newContact("<sip:localhost>");
    contact2.setExpires(1500);
    request.addHeader(contact2);
    Response response = 
      session.sendRegistrationMessage(request, Response.OK);
    
        request = session.createRegister("*", 0);

View Full Code Here

  }
  
  public void testInvalidWilcard2() throws Exception {  
    RegisterSession session =  new RegisterSession(getAlicePhone());
    Request request = session.createRegister(null, 0);
    ContactHeader contact = __headerFactory.createContactHeader();
    contact.setWildCard();
    request.addHeader(contact);
    Response response = 
      session.sendRegistrationMessage(request, Response.BAD_REQUEST);
    assertEquals("Invalid wildcard", response.getReasonPhrase());
  }

View Full Code Here

    
    public boolean isRegistered()
    {
      if (lastRegistrationRequest == null)
        return false;
      ContactHeader contact = (ContactHeader) lastRegistrationRequest.getHeader(ContactHeader.NAME);
      if (contact != null)
        return contact.getExpires() != 0;
      ExpiresHeader expires = lastRegistrationRequest.getExpires();
      if (expires != null && expires.getExpires() == 0)
        return false;
      return true;

View Full Code Here

         * 
         * JvB: Should only do this for target refresh requests, ie not for BYE, PRACK, etc
         */


        if (SIPRequest.isTargetRefresh(method)) {
            ContactHeader contactHeader = ((ListeningPointImpl) this.sipProvider
                    .getListeningPoint(lp.getTransport())).createContactHeader();


            ((SipURI) contactHeader.getAddress().getURI()).setSecure(this.isSecure());
            sipRequest.setHeader(contactHeader);
        }


        try {
            /*

View Full Code Here

     * 
     */
    public void logResponse(SIPResponse sipResponse, long receptionTime, String status) {
        int peerport = getPeerPort();
        if (peerport == 0 && sipResponse.getContactHeaders() != null) {
            ContactHeader contact = (ContactHeader) sipResponse.getContactHeaders().getFirst();
            peerport = ((AddressImpl) contact.getAddress()).getPort();


        }
        String from = getPeerAddress().toString() + ":" + peerport;
        String to = this.getHost() + ":" + getPort();
        this.getSIPStack().serverLogger.logMessage(sipResponse, from, to, status, false,

View Full Code Here

                    request);
                FromHeader from = (FromHeader) okResponse.getHeader(FromHeader.NAME);
                from.removeParameter("tag");
                Address address = addressFactory.createAddress("Shootme <sip:"
                    + myAddress + ":" + myPort + ">");
                ContactHeader contactHeader = headerFactory
                .createContactHeader(address);
                ToHeader toHeader = (ToHeader) okResponse.getHeader(ToHeader.NAME);
                toHeader.setTag("4321"); // Application is supposed to set.


                FromHeader fromHeader = (FromHeader)okResponse.getHeader(FromHeader.NAME);
                fromHeader.setTag("12345");
                okResponse.addHeader(contactHeader);
                serverTransaction.sendResponse(okResponse);




              } catch (Exception ex) {
                ex.printStackTrace();
                //System.exit(0);
              }
              if(q%100==0) System.out.println("Send " + q);
            }
            try {
                Response okResponse = messageFactory.createResponse(200,
                        request);
                FromHeader from = (FromHeader) okResponse.getHeader(FromHeader.NAME);
                from.removeParameter("tag");
                Address address = addressFactory.createAddress("Shootme <sip:"
                        + myAddress + ":" + myPort + ">");
                ContactHeader contactHeader = headerFactory
                        .createContactHeader(address);
                ToHeader toHeader = (ToHeader) okResponse.getHeader(ToHeader.NAME);
                toHeader.setTag("4321"); // Application is supposed to set.


                FromHeader fromHeader = (FromHeader)okResponse.getHeader(FromHeader.NAME);

View Full Code Here

         * 
         * JvB: Should only do this for target refresh requests, ie not for BYE, PRACK, etc
         */


        if (SIPRequest.isTargetRefresh(method)) {
            ContactHeader contactHeader = ((ListeningPointImpl) this.sipProvider
                    .getListeningPoint(lp.getTransport())).createContactHeader();


            ((SipURI) contactHeader.getAddress().getURI()).setSecure(this.isSecure());
            sipRequest.setHeader(contactHeader);
        }


        try {
            /*

View Full Code Here

                    request);
                FromHeader from = (FromHeader) okResponse.getHeader(FromHeader.NAME);
                from.removeParameter("tag");
                Address address = addressFactory.createAddress("Shootme <sip:"
                    + myAddress + ":" + myPort + ">");
                ContactHeader contactHeader = headerFactory
                .createContactHeader(address);
                ToHeader toHeader = (ToHeader) okResponse.getHeader(ToHeader.NAME);
                toHeader.setTag("4321"); // Application is supposed to set.


                FromHeader fromHeader = (FromHeader)okResponse.getHeader(FromHeader.NAME);
                fromHeader.setTag("12345");
                okResponse.addHeader(contactHeader);
                serverTransaction.sendResponse(okResponse);




              } catch (Exception ex) {
                ex.printStackTrace();
                //System.exit(0);
              }
              if(q%100==0) System.out.println("Send " + q);
            }
            try {
                Response okResponse = messageFactory.createResponse(200,
                        request);
                FromHeader from = (FromHeader) okResponse.getHeader(FromHeader.NAME);
                from.removeParameter("tag");
                Address address = addressFactory.createAddress("Shootme <sip:"
                        + myAddress + ":" + myPort + ">");
                ContactHeader contactHeader = headerFactory
                        .createContactHeader(address);
                ToHeader toHeader = (ToHeader) okResponse.getHeader(ToHeader.NAME);
                toHeader.setTag("4321"); // Application is supposed to set.


                FromHeader fromHeader = (FromHeader)okResponse.getHeader(FromHeader.NAME);

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of javax.sip.header.ContactHeader

gov.nist.javax.sip.stack.MessageChannel

gov.nist.javax.sip.stack.NioWebSocketMessageChannel

gov.nist.javax.sip.stack.SIPDialog

org.cafesip.reference.jiplet.SipPresence

org.cafesip.reference.jiplet.SipRegistrar

org.cafesip.sipunit.RegisterSession

org.cipango.kaleo.sipunit.RegisterTest

org.mobicents.examples.media.CallSbb

org.mobicents.slee.examples.callcontrol.forwarding.CallForwardingSbb

org.mobicents.slee.examples.callcontrol.voicemail.VoiceMailSbb

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.