JSIP API v1.2
November 2006

javax.sip.header
Interface RequireHeader

All Superinterfaces:
java.lang.Cloneable, Header, OptionTag, java.io.Serializable
All Known Subinterfaces:
ProxyRequireHeader

public interface RequireHeader
extends OptionTag, Header

The Require header field is used by UACs to tell UASs about options that the UAC expects the UAS to support in order to process the request. Although an optional header field, the Require MUST NOT be ignored if it is present.

The Require header field contains a list of option tags. Each option tag defines a SIP extension that MUST be understood to process the request. Frequently, this is used to indicate that a specific set of extension header fields need to be understood. A UAC compliant to this specification MUST only include option tags corresponding to standards-track RFCs.

If a server does not understand the option, it must respond by returning a BAD_EXTENSION Response and list those options it does not understand in the UnsupportedHeader.

Proxy and redirect servers must ignore features that are not understood. If a particular extension requires that intermediate devices support it, the extension must be tagged in the ProxyRequireHeader as well.

For Example:
Require: 100rel

Author:
BEA Systems, NIST
See Also:
ProxyRequireHeader, OptionTag

Field Summary
static java.lang.String NAME
          Name of RequireHeader
 
Method Summary
 
Methods inherited from interface javax.sip.header.OptionTag
getOptionTag, setOptionTag
 
Methods inherited from interface javax.sip.header.Header
clone, equals, getName, hashCode, toString
 

Field Detail

NAME

static final java.lang.String NAME
Name of RequireHeader

See Also:
Constant Field Values

JSIP API v1.2
November 2006

If you have any comments, please mail them to JAIN-SIP-INTEREST@java.sun.com after subscribing at http://archives.java.sun.com
Copyright - 2006 BEA Systems and Sun Microsystems