SipServletMessage (Sip Servlets Specification Implementation 3.1.662 API)

All Superinterfaces:

Cloneable

All Known Subinterfaces:

SipServletRequest, SipServletResponse
```
public interface SipServletMessage
extends Cloneable
```
Defines common aspects of SIP requests and responses. The Servlet API is defined with an implicit assumption that servlets receives requests from clients, inspects various aspects of the corresponding ServletRequest object, and generates a response by setting various attributes of a ServletResponse object. This model fits HTTP well, because HTTP servlets always execute origin servers; they execute only to process incoming requests and never initiates HTTP requests of their own. SIP services, on the other hand, does need to be able to initiate requests of their own. This implies that SIP request and response classes are more symmetric, that is, requests must be writable as well as readable, and likewise, responses must be readable as well as writable. The SipServletMessage interface defines a number of methods which are common to SipServletRequest and SipServletResponse, for example setters and getters for message headers and content. System Headers Applications must not add, delete, or modify so-called "system" headers. These are header fields that the servlet container manages: From, To, Call-ID, CSeq, Via, Route (except through pushRoute), Record-Route. Contact is a system header field in messages other than REGISTER requests and responses, 3xx and 485 responses, and 200/OPTIONS responses. Additionally, for containers implementing the reliable provisional responses extension, RAck and RSeq are considered system headers also. Note that From and To are system header fields only with respect to their tags (i.e., tag parameters on these headers are not allowed to be modified but modifications are allowed to the other parts). Implicit Transaction State SipServletMessage objects always implicitly belong to a SIP transaction, and the transaction state machine (as defined by the SIP specification) constrains what messages can legally be sent at various points of processing. If a servlet attempts to send a message which would violate the SIP specification (for example, the transaction state machine), the container throws an IllegalStateException.

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static class SipServletMessage.HeaderForm
Type header forms.

Nested Classes
Modifier and Type	Interface and Description
`static class`	`SipServletMessage.HeaderForm` Type header forms.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addAcceptLanguage(Locale locale)` Adds an acceptable Locale of this user agent.
`void`	`addAddressHeader(String name, Address addr, boolean first)` Adds the specified Address as a new value of the named header field.
`void`	`addHeader(String name, String value)` Adds a header with the given name and value.
`void`	`addParameterableHeader(String name, Parameterable param, boolean first)` Adds the specified Parameterable as a new value of the named header field.
`Locale`	`getAcceptLanguage()` Returns the preferred Locale that the UA originating this message will accept content in, based on the Accept-Language header.
`Iterator<Locale>`	`getAcceptLanguages()` Returns an Iterator over Locale objects indicating, in decreasing order starting with the preferred locale, the locales that are acceptable to the sending UA based on the Accept-Language header.
`Address`	`getAddressHeader(String name)` Returns the value of the specified header as a Address object.
`ListIterator<Address>`	`getAddressHeaders(String name)` Returns a ListIterator over all Address header field values for the specified header.
`SipApplicationSession`	`getApplicationSession()` Returns the application session to which this message belongs.
`SipApplicationSession`	`getApplicationSession(boolean create)` Returns the app session to which this message belongs.
`Object`	`getAttribute(String name)` Returns the value of the named attribute as an Object, or null if no attribute of the given name exists.
`Enumeration<String>`	`getAttributeNames()` Returns an Enumeration containing the names of the attributes available to this message object.
`String`	`getCallId()` Returns the value of the Call-ID header in this SipServletMessage.
`String`	`getCharacterEncoding()` Returns the name of the charset used for the MIME body sent in this message.
`Object`	`getContent()` Returns the content as a Java object.
`Locale`	`getContentLanguage()` Returns the locale of this message.
`int`	`getContentLength()` Returns the length in number of bytes of the content part of this message.
`String`	`getContentType()` Returns the value of the Content-Type header field.
`int`	`getExpires()` Returns the value of the Expires header.
`Address`	`getFrom()` Returns the value of the From header.
`String`	`getHeader(String name)` Returns the value of the specified header as a String.
`SipServletMessage.HeaderForm`	`getHeaderForm()`
`Iterator<String>`	`getHeaderNames()` Returns an Iterator over all the header names this message contains.
`ListIterator<String>`	`getHeaders(String name)` Returns all the values of the specified request header as a ListIterator over a number of String objects.
`String`	`getInitialRemoteAddr()` Returns the IP address of the upstream/downstream hop from which this message was initially received by the container.
`int`	`getInitialRemotePort()` Returns the port number of the upstream/downstream hop from which this message initially received by the container.
`String`	`getInitialTransport()` Returns the name of the protocol with which this message was initially received by the container, e.g.
`String`	`getLocalAddr()` Returns the IP address of the interface this message was received on.
`int`	`getLocalPort()` Returns the local port this message was received on.
`String`	`getMethod()` Returns the SIP method of this message.
`Parameterable`	`getParameterableHeader(String name)` Returns the value of the specified header field as a Parameterable object.
`ListIterator<? extends Parameterable>`	`getParameterableHeaders(String name)` Returns a ListIterator over all Parameterable header field values for the specified header name.
`String`	`getProtocol()` Returns the name and version of the protocol of this message.
`byte[]`	`getRawContent()` Returns message content as a byte array.
`String`	`getRemoteAddr()` Returns the IP address of the next upstream/downstream hop from which this message was received.
`int`	`getRemotePort()` Returns the port number of the next upstream/downstream hop from which this message was received.
`String`	`getRemoteUser()` Returns the login of the user sending this message, if the user has been authenticated, or null if the user has not been authenticated.
`SipSession`	`getSession()` Returns the SipSession to which this message belongs.
`SipSession`	`getSession(boolean create)` Returns the SipSession to which this message belongs.
`Address`	`getTo()` Returns the value of the To header.
`String`	`getTransport()` Returns the name of the protocol with which this message was received, e.g.
`Principal`	`getUserPrincipal()` Returns a java.security.Principal object containing the name of the authenticated user agent sending this message.
`boolean`	`isCommitted()` Returns true if this message is committed, that is, if one of the following conditions is true: This message is an incoming request for which a final response has already been generated.
`boolean`	`isSecure()` Returns a boolean indicating whether this message was received over a secure channel, such as TLS.
`boolean`	`isUserInRole(String role)` Returns a boolean indicating whether the authenticated user is included in the specified logical "role".
`void`	`removeAttribute(String name)` Removes the named attribute from this message.
`void`	`removeHeader(String name)` Removes the specified header.
`void`	`send()` Sends this SipServletMessage.
`void`	`setAcceptLanguage(Locale locale)` Sets the preferred Locale that this user agent will accept content, reason phrases, warnings, etc.
`void`	`setAddressHeader(String name, Address addr)` Sets the header with the specified name to have the value specified by the address argument.
`void`	`setAttribute(String name, Object o)` Stores an attribute in this message.
`void`	`setCharacterEncoding(String enc)` Overrides the name of the character encoding that will be used to convert the body of this message from bytes to characters or vice versa.
`void`	`setContent(Object content, String contentType)` Sets the content of this message to the specified Object.
`void`	`setContentLanguage(Locale locale)` Sets the locale of this message, setting the headers (Content-Language and the Content-Type's charset) as appropriate.
`void`	`setContentLength(int len)` Sets the value of the Content-Length header.
`void`	`setContentType(String type)` Sets the content type of the response being sent to the client.
`void`	`setExpires(int seconds)` Sets the value of the Expires header in this message.
`void`	`setHeader(String name, String value)` Sets a header with the given name and value.
`void`	`setHeaderForm(SipServletMessage.HeaderForm form)` Indicates which of the compact or long form should the headers in this message have.
`void`	`setParameterableHeader(String name, Parameterable param)` Sets the header with the specified name to have the value specified by the address argument.

- Method Detail
  - addAcceptLanguage
```
void addAcceptLanguage(Locale locale)
```
    Adds an acceptable Locale of this user agent. The language identified by the Locale will be listed in an Accept-Language header with a lower q-value than any existing Accept-Language value, meaning the locale is less preferred than those already identified in this message.
  - addAddressHeader
```
void addAddressHeader(String name,
                    Address addr,
                    boolean first)
```
    Adds the specified Address as a new value of the named header field. The address is added as the last header field value. This method can be used with headers which are defined to contain one or more entries matching (name-addr | addr-spec) *(SEMI generic-param) as defined in RFC 3261. This includes, for example, Contact and Route. Either the long or compact name can be used to access the header field, as both are treated as equivalent.
  - addHeader
```
void addHeader(String name,
             String value)
```
    Adds a header with the given name and value. This method allows headers to have multiple values. The container MAY check that the specified header field can legally appear in the this message. Either the long or compact name can be used to access the header field, as both are treated as equivalent. The list of assigned compact form is available in the IANA registry at http://www.isi.edu/in-notes/iana/assignments/sip-parameters Note: applications should never attempt to set the From, To, Call-ID, CSeq, Via, Record-Route, and Route headers. Also, setting of the Contact header is subject to the constraints mentioned in the introduction.
  - addParameterableHeader
```
void addParameterableHeader(String name,
                          Parameterable param,
                          boolean first)
```
    Adds the specified Parameterable as a new value of the named header field. The parameterable is added as the last header field value. This method can be used with headers which are defined to contain one or more entries matching field-value *(;parameter-name=parameter-value) as defined in RFC 3261. This includes, for example, Event and Via. Either the long or compact name can be used to access the header field, as both are treated as equivalent.
  - getAcceptLanguage
```
Locale getAcceptLanguage()
```
    Returns the preferred Locale that the UA originating this message will accept content in, based on the Accept-Language header. If this message doesn't contain an Accept-Language header, this method returns the default locale for the server.
  - getAcceptLanguages
```
Iterator<Locale> getAcceptLanguages()
```
    Returns an Iterator over Locale objects indicating, in decreasing order starting with the preferred locale, the locales that are acceptable to the sending UA based on the Accept-Language header. If this message doesn't provide an Accept-Language header, this method returns an Iterator containing one Locale, the default locale for the server.
  - getAddressHeader
```
Address getAddressHeader(String name)
                         throws ServletParseException
```
    Returns the value of the specified header as a Address object. This method can be used with headers which are defined to contain one or more entries matching (name-addr | addr-spec) *(SEMI generic-param) as defined in RFC 3261. This includes, for example, Contact and Route. Either the long or compact name can be used to access the header field, as both are treated as equivalent. If there is more than one header field value the first is returned.
    
    Throws:
    
    ServletParseException
  - getAddressHeaders
```
ListIterator<Address> getAddressHeaders(String name)
                                        throws ServletParseException
```
    Returns a ListIterator over all Address header field values for the specified header. The values returned by the Iterator follow the order in which they appear in the message header. This method can be used with headers which are defined to contain one or more entries matching (name-addr | addr-spec) *(SEMI generic-param) as defined in RFC 3261. This includes, for example, Contact and Route. Either the long or compact name can be used to access the header field, as both are treated as equivalent. Attempts to modify the specified header field through the returned list iterator must fail with an IllegalStateException if the header field is a system header. For non-system headers the argument to the add and set methods of the iterator returned by getAddressHeaders must be Address objects. Note: This is a fail-fast iterator and can throw ConcurrentModificationException if the underlying implementation does not allow modification after the iterator is created.
    
    Throws:
    
    ServletParseException
  - getApplicationSession
```
SipApplicationSession getApplicationSession()
```
    Returns the application session to which this message belongs. If the session doesn't already exist it is created.
  - getApplicationSession
```
SipApplicationSession getApplicationSession(boolean create)
```
    Returns the app session to which this message belongs.
  - getAttribute
```
Object getAttribute(String name)
```
    Returns the value of the named attribute as an Object, or null if no attribute of the given name exists. Attributes can be set two ways. The servlet container may set attributes to make available custom information about a request or a response. For example, for requests made using HTTPS, the attribute javax.servlet.request.X509Certificate can be used to retrieve information on the certificate of the client. Attributes can also be set programatically using setAttribute(String, Object). This allows information to be embedded into a request or response before a RequestDispatcher call. Attribute names should follow the same conventions as package names. Names beginning with javax.servlet.sip. are reserved for definition by the SIP Servlet API.
  - getAttributeNames
```
Enumeration<String> getAttributeNames()
```
    Returns an Enumeration containing the names of the attributes available to this message object. This method returns an empty Enumeration if the request has no attributes available to it.
  - getCallId
```
String getCallId()
```
    Returns the value of the Call-ID header in this SipServletMessage.
  - getCharacterEncoding
```
String getCharacterEncoding()
```
    Returns the name of the charset used for the MIME body sent in this message. This method returns null if the message does not specify a character encoding. The message character encoding is used when converting between bytes and characters. If the character encoding hasn't been set explicitly UTF-8 will be used for this purpose. For more information about character encodings and MIME see RFC 2045 (http://www.ietf.org/rfc/rfc2045.txt).
  - getContent
```
Object getContent()
                  throws IOException,
                         UnsupportedEncodingException
```
    Returns the content as a Java object. The actual type of the returned object depends on the MIME type of the content itself (the Content-Type). Containers are required to return a String object for MIME type text/plain as for other text/* MIME types for which the container doesn't have specific knowledge. It is encouraged that the object returned for "multipart" MIME content is a javax.mail.Multipart object. A byte array is returned for content-types that are unknown to the container. The message's character encoding is used when the MIME type indicates that the content consists of character data. Note: This method, together with setContent, is modelled over similar methods in the JavaMail API. Whereas the JavaMail API mandates the use of the Java Activation Framework (JAF) as the underlying data handling system, the SIP servlet API doesn't currently require JAF.
    
    Throws:
    
    IOException
    
    UnsupportedEncodingException
  - getContentLanguage
```
Locale getContentLanguage()
```
    Returns the locale of this message. This method returns the Locale identified by the Content-Language header of the message, or null if the Content-Language header is not present.
  - getContentLength
```
int getContentLength()
```
    Returns the length in number of bytes of the content part of this message. This directly reflects the value of the Content-Length header field.
  - getContentType
```
String getContentType()
```
    Returns the value of the Content-Type header field.
  - getExpires
```
int getExpires()
```
    Returns the value of the Expires header. The Expires header field gives the relative time after which the message (or content) expires. The unit of measure is seconds.
  - getFrom
```
Address getFrom()
```
    Returns the value of the From header.
  - getHeader
```
String getHeader(String name)
```
    Returns the value of the specified header as a String. If the request did not include a header of the specified name, this method returns null. If multiple headers exist, the first one is returned. The header name is case insensitive. Either the long or compact name can be used to access the header field, as both are treated as equivalent. The list of assigned compact form is available in the IANA registry at http://www.isi.edu/in-notes/iana/assignments/sip-parameters For example, getHeader("Content-Type"); getHeader("c"); will both return the same value.
  - getHeaderForm
```
SipServletMessage.HeaderForm getHeaderForm()
```
  - getHeaderNames
```
Iterator<String> getHeaderNames()
```
    Returns an Iterator over all the header names this message contains. If the message has no headers, this method returns an empty Iterator. Note: This is a fail-fast iterator and can throw ConcurrentModificationException if the underlying implementation does not allow modification after the iterator is created. Some servlet containers do not allow servlets to access headers using this method, in which case this method returns null.
  - getHeaders
```
ListIterator<String> getHeaders(String name)
```
    Returns all the values of the specified request header as a ListIterator over a number of String objects. The values returned by the Iterator follow the order in which they appear in the message header. Either the long or compact name can be used to access the header field, as both are treated as equivalent. The list of assigned compact form is available in the IANA registry at http://www.isi.edu/in-notes/iana/assignments/sip-parameters Some headers, such as Accept-Language can be sent by clients as several headers each with a different value rather than sending the header as a comma separated list. If the request did not include any headers of the specified name, this method returns an empty Iterator. The header name is case insensitive. Note: This is a fail-fast iterator and can throw ConcurrentModificationException if the underlying implementation does not allow modification after the iterator is created. Attempts to modify the specified header field through the returned list iterator must fail with an IllegalStateException if the header field is a system header.
  - getInitialRemoteAddr
```
String getInitialRemoteAddr()
```
    Returns the IP address of the upstream/downstream hop from which this message was initially received by the container. Unlike getRemoteAddr(), this method returns the same value regardless of which application invokes it in the same application composition chain of a specific application router.
    
    Returns:
    a String containing the IP address of the sender of this message, or null if it was locally generated
    Since:
    
    1.1
  - getInitialRemotePort
```
int getInitialRemotePort()
```
    Returns the port number of the upstream/downstream hop from which this message initially received by the container. Unlike getRemotePort(), this method returns the same value regardless of which application invokes it in the same application composition chain of a specific application router.
    
    Returns:
    the port number of the sender of this message, or -1 if it was locally generated.
    Since:
    
    1.1
  - getInitialTransport
```
String getInitialTransport()
```
    Returns the name of the protocol with which this message was initially received by the container, e.g. "UDP", "TCP", "TLS", or "SCTP".
    
    Returns:
    name of the protocol this message was initially received with, or null if it was locally generated.
    Since:
    
    1.1
  - getLocalAddr
```
String getLocalAddr()
```
    Returns the IP address of the interface this message was received on.
  - getLocalPort
```
int getLocalPort()
```
    Returns the local port this message was received on.
  - getMethod
```
String getMethod()
```
    Returns the SIP method of this message. This is a token consisting of all upper-case letters, for example "INVITE". For requests, the SIP method is in the request line while for responses it may be extracted from the CSeq header.
  - getParameterableHeader
```
Parameterable getParameterableHeader(String name)
                                     throws ServletParseException
```
    Returns the value of the specified header field as a Parameterable object. This method can be used with headers which are defined to contain one or more entries matching field-value *(;parameter-name=parameter-value) as defined in RFC 3261. This includes, for example, Event and Via. Either the long or compact name can be used to access the header field, as both are treated as equivalent. If there is more than one header field value the first is returned.
    
    Throws:
    
    ServletParseException
  - getParameterableHeaders
```
ListIterator<? extends Parameterable> getParameterableHeaders(String name)
                                                              throws ServletParseException
```
    Returns a ListIterator over all Parameterable header field values for the specified header name. The values returned by the Iterator follow the order in which they appear in the message header. This method can be used with headers which are defined to contain one or more entries matching field-value *(;parameter-name=parameter-value) as defined in RFC 3261. This includes, for example, Event and Via. Either the long or compact name can be used to access the header field, as both are treated as equivalent. Attempts to modify the specified header field through the returned list iterator must fail with an IllegalStateException if the header field is a system header. Note: This is a fail-fast iterator and can throw ConcurrentModificationException if the underlying implementation does not allow modification after the iterator is created.
    
    Throws:
    
    ServletParseException
  - getProtocol
```
String getProtocol()
```
    Returns the name and version of the protocol of this message. This is in the form protocol> "/" major-version-number> "." minor-version-number>, for example "SIP/2.0". For this version of the SIP Servlet API this is always "SIP/2.0".
  - getRawContent
```
byte[] getRawContent()
                     throws IOException
```
    Returns message content as a byte array. The reference is returned if the application wants to re-use the content for another message it should make a copy.
    
    Throws:
    
    IOException
  - getRemoteAddr
```
String getRemoteAddr()
```
    Returns the IP address of the next upstream/downstream hop from which this message was received. Applications can determine the actual IP address of the UA that originated the message from the message Via header fields.
    If the message was internally routed (from one application to the next within the same container), then this method returns the address of the container's SIP interface.
  - getRemotePort
```
int getRemotePort()
```
    Returns the port number of the next upstream/downstream hop from which this message was received.
    If the message was internally routed (from one application to the next within the same container), then this method returns a valid port number chosen by the container or the host TCP/IP stack.
  - getRemoteUser
```
String getRemoteUser()
```
    Returns the login of the user sending this message, if the user has been authenticated, or null if the user has not been authenticated.
  - getSession
```
SipSession getSession()
```
    Returns the SipSession to which this message belongs. If the session didn't already exist it is created. This method is equivalent to calling getSession(true).
  - getSession
```
SipSession getSession(boolean create)
```
    Returns the SipSession to which this message belongs.
  - getTo
```
Address getTo()
```
    Returns the value of the To header.
  - getTransport
```
String getTransport()
```
    Returns the name of the protocol with which this message was received, e.g. "UDP", "TCP", "TLS", or "SCTP".
  - getUserPrincipal
```
Principal getUserPrincipal()
```
    Returns a java.security.Principal object containing the name of the authenticated user agent sending this message. If the user agent has not been authenticated, the method returns null.
  - isCommitted
```
boolean isCommitted()
```
    Returns true if this message is committed, that is, if one of the following conditions is true: This message is an incoming request for which a final response has already been generated. This message is an outgoing request which has already been sent. This message is an incoming response received by a servlet acting as a UAC. If this is a response to an INVITE then the response is not committed until the ACK has been generated. This message is a response which has already been forwarded upstream
  - isSecure
```
boolean isSecure()
```
    Returns a boolean indicating whether this message was received over a secure channel, such as TLS.
  - isUserInRole
```
boolean isUserInRole(String role)
```
    Returns a boolean indicating whether the authenticated user is included in the specified logical "role". Roles and role membership can be defined using deployment descriptors. If the user has not been authenticated, the method returns false.
  - removeAttribute
```
void removeAttribute(String name)
```
    Removes the named attribute from this message. Nothing is done if the message did not already contain the specified attribute. Attribute names should follow the same conventions as package names. Names beginning with javax.servlet.sip.* are reserved for definition by the SIP Servlet API.
    
    Parameters:
    name - a String specifying the name of the attribute
    
    Throws:
    
    NullPointerException - if name is null.
  - removeHeader
```
void removeHeader(String name)
```
    Removes the specified header. If multiple headers exists with the given name, they're all removed. Either the long or compact name can be used to access the header field, as both are treated as equivalent.
  - send
```
void send()
          throws IOException
```
    Sends this SipServletMessage.
    
    Throws:
    
    IOException
  - setAcceptLanguage
```
void setAcceptLanguage(Locale locale)
```
    Sets the preferred Locale that this user agent will accept content, reason phrases, warnings, etc. in. The language identified by the Locale will be listed in an Accept-Language header. A null argument is valid and removes and existing Accept-Language headers.
  - setAddressHeader
```
void setAddressHeader(String name,
                    Address addr)
```
    Sets the header with the specified name to have the value specified by the address argument. This method can be used with headers which are defined to contain one or more entries matching (name-addr | addr-spec) *(SEMI generic-param) as defined in RFC 3261. This includes, for example, Contact and Route. Either the long or compact name can be used to access the header field, as both are treated as equivalent.
    If the message did not include any headers of the specified name, this method returns an empty Iterator. If the message included headers of the specified name with no values, this method returns an Iterator over empty Strings.
    
    Throws:
    
    IllegalArgumentException - if the specified header isn't defined to hold address values or if the specified header field is a system header
  - setAttribute
```
void setAttribute(String name,
                Object o)
```
    Stores an attribute in this message. Attributes are reset between messages. This method is most often used in conjunction with RequestDispatcher. Attribute names should follow the same conventions as package names. Names beginning with javax.servlet.sip.* are reserved for definition by the SIP Servlet API.
  - setCharacterEncoding
```
void setCharacterEncoding(String enc)
                          throws UnsupportedEncodingException
```
    Overrides the name of the character encoding that will be used to convert the body of this message from bytes to characters or vice versa. Explicitly setting a message's character encoding potentially affects the behavior of subsequent calls to getContent() and setContent(java.lang.Object, java.lang.String). This method must be called prior to calling either of those methods.
    
    Throws:
    
    UnsupportedEncodingException
  - setContent
```
void setContent(Object content,
              String contentType)
                throws UnsupportedEncodingException
```
    Sets the content of this message to the specified Object. This method only works if the implementation "knows about" the specified object and MIME type. Containers are required to handle byte[] content with any MIME type. Furthermore, containers are required to handle String content when used with a text/* content type. When invoked with non-String objects and a text/* content type, containers may invoke toString() on the content Object in order to obtain the body's character data. It is also recommended that implementations know how to handle javax.mail.Multipart content when used together with "multipart" MIME types. When converting String content, this method may use the the message's character encoding (as set by setCharacterEncoding(java.lang.String), setContentType(java.lang.String) or setContentLanguage(java.util.Locale)) to map the String to a byte array. Note: This method, together with getContent(), is modelled over a similar method in the JavaMail API. Whereas the JavaMail API mandates the use of the Java Activation Framework (JAF) as the underlying data handling system, the SIP servlet API doesn't currently require JAF.
    
    Throws:
    
    UnsupportedEncodingException
  - setContentLanguage
```
void setContentLanguage(Locale locale)
```
    Sets the locale of this message, setting the headers (Content-Language and the Content-Type's charset) as appropriate. This method should be called before a call to setContent.
  - setContentLength
```
void setContentLength(int len)
```
    Sets the value of the Content-Length header. Applications are discouraged from setting the Content-Length directly using this method; they should instead use the setContent methods which guarantees that the Content-Length is computed and set correctly.
  - setContentType
```
void setContentType(String type)
```
    Sets the content type of the response being sent to the client. The content type may include the type of character encoding used, for example, text/html; charset=UTF-8. This will cause the message's current character encoding to be set. If obtaining a PrintWriter or calling setContent, this method should be called first.
  - setExpires
```
void setExpires(int seconds)
```
    Sets the value of the Expires header in this message. This method is equivalent to: setHeader("Expires", String.valueOf(seconds));
  - setHeader
```
void setHeader(String name,
             String value)
```
    Sets a header with the given name and value. If the header had already been set, the new value overwrites the previous one. Either the long or compact name can be used to access the header field, as both are treated as equivalent. The applications choice of long or compact form shall take effect only of the HeaderForm parameter is set to SipServletMessage.HeaderForm.DEFAULT. Note: applications should never attempt to set the From, To, Call-ID, CSeq, Via, Record-Route, and Route headers. Also, setting of the Contact header is subject to the constraints mentioned in the introduction.
  - setHeaderForm
```
void setHeaderForm(SipServletMessage.HeaderForm form)
```
    Indicates which of the compact or long form should the headers in this message have. If compact is selected then all the headers that have compact names should be represented with them, regardless of how they were added to the message. When long is selected then all headers change to their long form. Instead if the applications wish to mix the compact and long form then they must not invoke the setUseCompactForm method or set it to use and instead set the non-system headers directly using the compact or long form . eg. SipServletMessage message; ..... message.setHeader("s", "Meeting at 5pm"); // Subject header compact form message.setHeader("Allow-Events", "telephone-event"); // Long form ..... For applications to set each header individually the value of the HeaderForm MUST be The list of assigned compact form is available in the IANA registry at http://www.isi.edu/in-notes/iana/assignments/sip-parameters
  - setParameterableHeader
```
void setParameterableHeader(String name,
                          Parameterable param)
```
    Sets the header with the specified name to have the value specified by the address argument. This method can be used with headers which are defined to contain one or more entries matching field-value *(;parameter-name=parameter-value) as defined in RFC 3261. This includes, for example, Event and Via. Either the long or compact name can be used to access the header field, as both are treated as equivalent.
    If the message did not include any headers of the specified name, this method returns an empty Iterator. If the message included headers of the specified name with no values, this method returns an Iterator over empty Strings.
    
    Throws:
    
    IllegalArgumentException - if the specified header isn't defined to hold address values or if the specified header field is a system header

Interface SipServletMessage

Nested Class Summary

Method Summary

Method Detail

addAcceptLanguage

addAddressHeader

addHeader

addParameterableHeader

getAcceptLanguage

getAcceptLanguages

getAddressHeader

getAddressHeaders

getApplicationSession

getApplicationSession

getAttribute

getAttributeNames

getCallId

getCharacterEncoding

getContent

getContentLanguage

getContentLength

getContentType

getExpires

getFrom

getHeader

getHeaderForm

getHeaderNames

getHeaders

getInitialRemoteAddr

getInitialRemotePort

getInitialTransport

getLocalAddr

getLocalPort

getMethod

getParameterableHeader

getParameterableHeaders

getProtocol

getRawContent

getRemoteAddr

getRemotePort

getRemoteUser

getSession

getSession

getTo

getTransport

getUserPrincipal

isCommitted

isSecure

isUserInRole

removeAttribute

removeHeader

send

setAcceptLanguage

setAddressHeader

setAttribute

setCharacterEncoding

setContent

setContentLanguage

setContentLength

setContentType

setExpires

setHeader

setHeaderForm

setParameterableHeader