NIST SIP Parser and Stack (v1.2) API

javax.sip.header
Interface ContentDispositionHeader

All Superinterfaces:
Cloneable, Header, Parameters, Serializable
All Known Implementing Classes:
ContentDisposition

public interface ContentDispositionHeader
extends Parameters, Header

The Content-Disposition header field describes how the message body or, for multipart messages, a message body part is to be interpreted by the UAC or UAS. This SIP header field extends the MIME Content-Type. Several new "disposition-types" of the Content-Disposition header are defined by SIP, namely:-

For backward-compatibility, if the Content-Disposition header field is missing, the server SHOULD assume bodies of Content-Type application/sdp are the disposition "session", while other content types are "render".

If this header field is missing, the MIME type determines the default content disposition. If there is none, "render" is assumed.

For Example:
Content-Disposition: session

Since:
1.1
Author:
Sun Microsystems
See Also:
ContentTypeHeader, ContentLengthHeader, ContentEncodingHeader, ContentLanguageHeader

Field Summary
static String ALERT
          Alert Disposition Type Constant
static String ICON
          Icon Disposition Type Constant
static String NAME
          Name of ContentDispositionHeader
static String RENDER
          Render Disposition Type Constant
static String SESSION
          Session Disposition Type Constant
 
Method Summary
 String getDispositionType()
          Gets the interpretation of the message body or message body part of this ContentDispositionHeader.
 String getHandling()
          Gets the handling information of the unknown content disposition of the ContentDispositionHeader.
 void setDispositionType(String dispositionType)
          Sets the interpretation value of the message body or message body part for this ContentDispositionHeader.
 void setHandling(String handling)
          The handling parameter describes how the UAS should react if it receives a message body whose content type or disposition type it does not understand.
 
Methods inherited from interface javax.sip.header.Parameters
getParameter, getParameterNames, removeParameter, setParameter
 
Methods inherited from interface javax.sip.header.Header
clone, equals, getName, toString
 

Field Detail

NAME

public static final String NAME
Name of ContentDispositionHeader

See Also:
Constant Field Values

SESSION

public static final String SESSION
Session Disposition Type Constant

See Also:
Constant Field Values

RENDER

public static final String RENDER
Render Disposition Type Constant

See Also:
Constant Field Values

ICON

public static final String ICON
Icon Disposition Type Constant

See Also:
Constant Field Values

ALERT

public static final String ALERT
Alert Disposition Type Constant

See Also:
Constant Field Values
Method Detail

setDispositionType

public void setDispositionType(String dispositionType)
                        throws ParseException
Sets the interpretation value of the message body or message body part for this ContentDispositionHeader.

Throws:
ParseException - which signals that an error has been reached unexpectedly while parsing the dispositionType parameter.

getDispositionType

public String getDispositionType()
Gets the interpretation of the message body or message body part of this ContentDispositionHeader.

Returns:
interpretation of the message body or message body part

setHandling

public void setHandling(String handling)
                 throws ParseException
The handling parameter describes how the UAS should react if it receives a message body whose content type or disposition type it does not understand. The parameter has defined values of "optional" and "required". If the handling parameter is missing, the value "required" SHOULD be assumed.

Throws:
ParseException - which signals that an error has been reached unexpectedly while parsing the handling parameter.

getHandling

public String getHandling()
Gets the handling information of the unknown content disposition of the ContentDispositionHeader.

Returns:
handling information for unknown content dispositions.

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.