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 Wang/** 32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Root class from which all SIPHeader objects are subclassed. 33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author M. Ranganathan <br/> 35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.7 $ $Date: 2009/07/17 18:57:37 $ 36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic abstract class SIPHeader 40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang extends SIPObject 41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang implements SIPHeaderNames, javax.sip.header.Header, HeaderExt { 42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** name of this header 44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected String headerName; 46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Value of the header. 48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Constructor 51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param hname String to set 52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected SIPHeader(String hname) { 54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang headerName = hname; 55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Default constructor 58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public SIPHeader() { 60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Name of the SIPHeader 64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return String 65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getHeaderName() { 67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return headerName; 68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Alias for getHaderName above. 71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *@return String headerName 73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getName() { 76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return this.headerName; 77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Set the name of the header . 81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param hdrname String to set 82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setHeaderName(String hdrname) { 84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang headerName = hdrname; 85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Get the header value (i.e. what follows the name:). 88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * This merely goes through and lops off the portion that follows 89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * the headerName: 90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getHeaderValue() { 92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang String encodedHdr = null; 93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang try { 94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang encodedHdr = this.encode(); 95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } catch (Exception ex) { 96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return null; 97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang StringBuffer buffer = new StringBuffer(encodedHdr); 99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang while (buffer.length() > 0 && buffer.charAt(0) != ':') { 100600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang buffer.deleteCharAt(0); 101600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 102600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (buffer.length() > 0) 103600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang buffer.deleteCharAt(0); 104600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return buffer.toString().trim(); 105600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 106600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 107600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Return false if this is not a header list 108600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * (SIPHeaderList overrrides this method). 109600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *@return false 110600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 111600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public boolean isHeaderList() { 112600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return false; 113600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 114600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 115600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Encode this header into canonical form. 116600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 117600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String encode() { 118600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return encode(new StringBuffer()).toString(); 119600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 120600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 121600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public StringBuffer encode(StringBuffer buffer) { 122600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang buffer.append(this.headerName).append(COLON).append(SP); 123600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.encodeBody(buffer); 124600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang buffer.append(NEWLINE); 125600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return buffer; 126600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 127600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 128600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Encode the body of this header (the stuff that follows headerName). 129600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * A.K.A headerValue. 130600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 131600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected abstract String encodeBody(); 132600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 133600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Encode the body of this header in the given buffer. 134600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Default implementation calls encodeBody(); 135600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 136600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected StringBuffer encodeBody(StringBuffer buffer) { 137600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return buffer.append(encodeBody()); 138600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 139600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 140600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Alias for getHeaderValue. 141600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 142600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getValue() { 143600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return this.getHeaderValue(); 144600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 145600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 146600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 147600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * This is a pretty simple hashCode but satisfies requirements. 148600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 149600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 150600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public int hashCode() { 151600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return this.headerName.hashCode(); 152600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 153600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 154600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public final String toString() { 155600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return this.encode(); 156600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 157600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang} 158