NIST-SIP: The Reference Implementation for JAIN-SIP 1.2

javax.sip.header
Interface RecordRouteHeader

All Superinterfaces:
Cloneable, Header, HeaderAddress, Parameters, Serializable
All Known Implementing Classes:
RecordRoute

public interface RecordRouteHeader
extends HeaderAddress, Parameters, Header

The Record-Route header field is inserted by proxies in a request to force future requests in the dialog to be routed through the proxy. The SipProvider (as opposed to the application) should attach Record-Route headers to messages explicitly when forwarding them if necessary.

The RecordRouteHeader is added to a Request by any proxy that insists on being in the path of subsequent Requests for the same call leg. It contains a globally reachable RequestURI that identifies the proxy server. Each proxy server adds its Address URI to the beginning of the list.

The calling user agent client copies the RecordRouteHeaders into RouteHeaders of subsequent Requests within the same call leg, reversing the order, so that the first entry is closest to the user agent client. If the Response contained a ContactHeader field, the calling user agent adds its content as the last RouteHeader. Unless this would cause a loop, a client must send subsequent Requests for this call leg to the Address URI in the first RouteHeader and remove that entry.

Some proxies, such as those controlling firewalls or in an automatic call distribution (ACD) system, need to maintain call state and thus need to receive any BYE and ACK Requests for the call.

For Example:
Record-Route: sip:server10.jcp.org;lr, sip:bigbox3.duke.jcp.org;lr

Version:
1.2
Author:
BEA Systems, NIST
See Also:
RouteHeader, HeaderAddress, Parameters

Field Summary
static String NAME
          Name of RecordRouteHeader
 
Method Summary
 
Methods inherited from interface javax.sip.header.HeaderAddress
getAddress, setAddress
 
Methods inherited from interface javax.sip.header.Parameters
getParameter, getParameterNames, removeParameter, setParameter
 
Methods inherited from interface javax.sip.header.Header
clone, equals, getName, hashCode, toString
 

Field Detail

NAME

static final String NAME
Name of RecordRouteHeader

See Also:
Constant Field Values

NIST-SIP: The Reference Implementation for JAIN-SIP 1.2

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