1600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/* 2600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Conditions Of Use 3600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* 4600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* This software was developed by employees of the National Institute of 5600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Standards and Technology (NIST), an agency of the Federal Government. 6600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Pursuant to title 15 Untied States Code Section 105, works of NIST 7600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* employees are not subject to copyright protection in the United States 8600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* and are considered to be in the public domain. As a result, a formal 9600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* license is not needed to use the software. 10600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* 11600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* This software is provided by NIST as a service and is expressly 12600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* provided "AS IS." NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED 13600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF 14600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT 15600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* AND DATA ACCURACY. NIST does not warrant or make any representations 16600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* regarding the use of the software or the results thereof, including but 17600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* not limited to the correctness, accuracy, reliability or usefulness of 18600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* the software. 19600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* 20600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Permission to use this software is contingent upon your acceptance 21600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* of the terms of this agreement 22600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* 23600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* . 24600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* 25600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*/ 26600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/******************************************************************************* 27600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang* Product of NIST/ITL Advanced Networking Technologies Division (ANTD). * 28600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*******************************************************************************/ 29600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpackage gov.nist.javax.sip.header; 30600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 31600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport java.text.ParseException; 32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/** 34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Content encoding part of a content encoding header list. 35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @see ContentEncodingList 36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *<pre> 37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * From HTTP RFC 2616 38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *14.11 Content-Encoding 39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * The Content-Encoding entity-header field is used as a modifier to the 41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * media-type. When present, its value indicates what additional content 42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * codings have been applied to the entity-body, and thus what decoding 43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * mechanisms must be applied in order to obtain the media-type 44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * referenced by the Content-Type header field. Content-Encoding is 45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * primarily used to allow a document to be compressed without losing 46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * the identity of its underlying media type. 47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Content-Encoding = "Content-Encoding" ":" 1#content-coding 49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Content codings are defined in section 3.5. An example of its use is 51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Content-Encoding: gzip 53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * The content-coding is a characteristic of the entity identified by 55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * the Request-URI. Typically, the entity-body is stored with this 56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * encoding and is only decoded before rendering or analogous usage. 57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * However, a non-transparent proxy MAY modify the content-coding if the 58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * new coding is known to be acceptable to the recipient, unless the 59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * "no-transform" cache-control directive is present in the message. 60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * If the content-coding of an entity is not "identity", then the 62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * response MUST include a Content-Encoding entity-header (section 63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 14.11) that lists the non-identity content-coding(s) used. 64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * If the content-coding of an entity in a request message is not 66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * acceptable to the origin server, the server SHOULD respond with a 67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * status code of 415 (Unsupported Media Type). 68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * If multiple encodings have been applied to an entity, the content 70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * codings MUST be listed in the order in which they were applied. 71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Additional information about the encoding parameters MAY be provided 72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * by other entity-header fields not defined by this specification. 73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *</pre> 74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author M. Ranganathan <br/> 76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author Olivier Deruelle <br/> 77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.5 $ $Date: 2009/07/17 18:57:29 $ 78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @since 1.1 79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic class ContentEncoding 81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang extends SIPHeader 82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang implements javax.sip.header.ContentEncodingHeader { 83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Comment for <code>serialVersionUID</code> 86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang private static final long serialVersionUID = 2034230276579558857L; 88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * ContentEncoding field. 90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected String contentEncoding; 92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Default constructor. 95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public ContentEncoding() { 97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(CONTENT_ENCODING); 98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 100600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 101600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Constructor. 102600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param enc String to set. 103600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 104600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public ContentEncoding(String enc) { 105600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(CONTENT_ENCODING); 106600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang contentEncoding = enc; 107600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 108600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 109600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 110600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Canonical encoding of body of the header. 111600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return encoded body of the header. 112600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 113600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String encodeBody() { 114600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return contentEncoding; 115600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 116600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 117600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 118600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Get the ContentEncoding field. 119600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return String 120600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 121600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getEncoding() { 122600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return contentEncoding; 123600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 124600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 125600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 126600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Set the ConentEncoding field. 127600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param encoding String to set 128600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 129600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setEncoding(String encoding) throws ParseException { 130600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (encoding == null) 131600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw new NullPointerException( 132600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "JAIN-SIP Exception, " + " encoding is null"); 133600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang contentEncoding = encoding; 134600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 135600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang} 136