NIST SIP Parser and Stack (v1.2) API

javax.sip.header
Interface CallIdHeader

All Superinterfaces:
Cloneable, Header, Serializable
All Known Implementing Classes:
CallID

public interface CallIdHeader
extends Header

The Call-ID header field uniquely identifies a particular invitation or all registrations of a particular client. A single multimedia conference can give rise to several calls with different Call-IDs, for example, if a user invites a single individual several times to the same (long-running) conference. Call-IDs are case-sensitive and are simply compared byte-by-byte.

Call-ID is generated by the combination of a random string and the softphone's host name or IP address. The combination of the To tag, From tag, and Call-ID completely defines a peer-to-peer SIP relationship between two users and is referred to as a dialog. It MUST be the same for all requests and responses sent by either User Agent in a dialog. It SHOULD be the same in each registration from a User Agent.

All SIP User Agents must have a means to guarantee that the Call-ID header fields they produce will not be inadvertently generated by any other User Agent. Note that when requests are retried after certain failure responses that solicit an amendment to a request (for example, a challenge for authentication), these retried requests are not considered new requests, and therefore do not need new Call-ID header fields.

Use of cryptographically random identifiers in the generation of Call-IDs is RECOMMENDED. Implementations MAY use the form "localid@host".

For Example:
Call-ID: f81d4fae-7dec-11d0-a765-00a0c91e6bf6@jcp.org

Version:
1.1
Author:
Sun Microsystems

Field Summary
static String NAME
          Name of CallIdHeader
 
Method Summary
 String getCallId()
          Returns the Call-Id of CallIdHeader.
 void setCallId(String callId)
          Sets the Call-Id of the CallIdHeader.
 
Methods inherited from interface javax.sip.header.Header
clone, equals, getName, toString
 

Field Detail

NAME

public static final String NAME
Name of CallIdHeader

See Also:
Constant Field Values
Method Detail

setCallId

public void setCallId(String callId)
               throws ParseException
Sets the Call-Id of the CallIdHeader. The CallId parameter uniquely identifies a serious of messages within a dialogue.

Parameters:
callId - - the string value of the Call-Id of this CallIdHeader.
Throws:
ParseException - which signals that an error has been reached unexpectedly while parsing the callId value.

getCallId

public String getCallId()
Returns the Call-Id of CallIdHeader. The CallId parameter uniquely identifies a series of messages within a dialogue.

Returns:
the String value of the Call-Id of this CallIdHeader

NIST SIP Parser and Stack (v1.2) API

A product of the NIST/ITL Advanced Networking Technologies Division.
See conditions of use.
Get the latest distribution.
Submit a bug report or feature request.