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* Product of NIST/ITL Advanced Networking Technologies Division (ANTD). * 26600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang*******************************************************************************/ 27600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpackage gov.nist.javax.sip.header; 28600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 29600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport javax.sip.header.*; 30600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport java.text.ParseException; 31600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/** 33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * the SIP-If-Match header. 34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author Jeroen van Bemmel<br/> 36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.3 $ $Date: 2009/07/17 18:57:38 $ 37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @since 1.2 38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic class SIPIfMatch extends SIPHeader implements SIPIfMatchHeader,ExtensionHeader { 40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * unique serial id 43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang private static final long serialVersionUID = 3833745477828359730L; 45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * entity tag field 48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected String entityTag; 50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Default constructor 52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public SIPIfMatch() { 54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(NAME); 55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public SIPIfMatch(String etag) throws ParseException { 58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this(); 59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.setETag( etag ); 60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Encode into canonical form. 64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return String 65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String encodeBody() { 67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return entityTag; 68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * get the priority value. 72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return String 73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getETag() { 75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return entityTag; 76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Set the priority member 80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param etag -- the entity tag to set. 81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setETag(String etag) throws ParseException { 83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (etag == null) 84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw new NullPointerException( 85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "JAIN-SIP Exception," 86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + "SIP-If-Match, setETag(), the etag parameter is null"); 87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.entityTag = etag; 88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * For v 1.1 backwards compatibility. 92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @see javax.sip.header.ExtensionHeader#setValue(java.lang.String) 93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setValue(String value) throws ParseException { 95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.setETag(value); 96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang} 100