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.util.*; 32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport java.text.ParseException; 33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport javax.sip.header.*; 34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/** 36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * the UserAgent SIPObject. 37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author Olivier Deruelle <br/> 39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.8 $ $Date: 2009/07/17 18:57:40 $ 40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic class UserAgent extends SIPHeader implements UserAgentHeader { 45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Comment for <code>serialVersionUID</code> 48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang private static final long serialVersionUID = 4561239179796364295L; 50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Product tokens. 51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected List productTokens; 53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Return canonical form. 56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * pmusgrave - put a space between products (preserves format of header) 57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return String 58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang private String encodeProduct() { 60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang StringBuffer tokens = new StringBuffer(); 61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang ListIterator it = productTokens.listIterator(); 62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang while (it.hasNext()) { 64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang tokens.append((String) it.next()); 65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return tokens.toString(); 68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** set the productToken field 71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param pt String to set 72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void addProductToken(String pt) { 74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang productTokens.add(pt); 75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Constructor. 79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public UserAgent() { 81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(NAME); 82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang productTokens = new LinkedList(); 83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Encode only the body of this header. 86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *@return encoded value of the header. 87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String encodeBody() { 89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return encodeProduct(); 90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Returns the list value of the product parameter. 94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return the software of this UserAgentHeader 96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public ListIterator getProduct() { 98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (productTokens == null || productTokens.isEmpty()) 99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return null; 100600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang else 101600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return productTokens.listIterator(); 102600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 103600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 104600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 105600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Sets the product value of the UserAgentHeader. 106600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 107600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param product - a List specifying the product value 108600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @throws ParseException which signals that an error has been reached 109600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * unexpectedly while parsing the product value. 110600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 111600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setProduct(List product) throws ParseException { 112600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (product == null) 113600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw new NullPointerException( 114600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "JAIN-SIP Exception, UserAgent, " 115600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + "setProduct(), the " 116600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + " product parameter is null"); 117600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang productTokens = product; 118600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 119600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 120600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public Object clone() { 121600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang UserAgent retval = (UserAgent) super.clone(); 122600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (productTokens != null) 123600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang retval.productTokens = new LinkedList (productTokens); 124600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return retval; 125600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 126600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 127600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang} 128600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/* 129600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * $Log: UserAgent.java,v $ 130600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.8 2009/07/17 18:57:40 emcho 131600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Converts indentation tabs to spaces so that we have a uniform indentation policy in the whole project. 132600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 133600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.7 2008/07/30 14:36:06 mranga 134600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 135600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from: 136600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: mranga 137600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 138600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Fix minor issue in encoding of user-agent header. 139600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 140600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.6 2006/10/12 11:57:55 pmusgrave 141600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 79, 80 142600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: pmusgrave@newheights.com 143600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 144600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 145600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.5 2006/07/13 09:01:48 mranga 146600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 147600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from: 148600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: jeroen van bemmel 149600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 150600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Moved some changes from jain-sip-1.2 to java.net 151600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 152600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: ---------------------------------------------------------------------- 153600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Issue number: 154600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change addresses one or more issues, 155600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then enter the issue number(s) here. 156600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Obtained from: 157600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change has been taken from another system, 158600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then name the system in this line, otherwise delete it. 159600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Submitted by: 160600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this code has been contributed to the project by someone else; i.e., 161600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: they sent us a patch or a set of diffs, then include their name/email 162600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: address here. If this is your work then delete this line. 163600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Reviewed by: 164600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If we are doing pre-commit code reviews and someone else has 165600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: reviewed your changes, include their name(s) here. 166600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If you have not had it reviewed then delete this line. 167600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 168600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.3 2006/06/19 06:47:27 mranga 169600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * javadoc fixups 170600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 171600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.2 2006/06/16 15:26:28 mranga 172600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Added NIST disclaimer to all public domain files. Clean up some javadoc. Fixed a leak 173600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 174600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.1.1.1 2005/10/04 17:12:35 mranga 175600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 176600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Import 177600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 178600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 179600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.3 2005/04/16 20:38:51 dmuresan 180600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Canonical clone() implementations for the GenericObject and GenericObjectList hierarchies 181600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 182600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.2 2004/01/22 13:26:30 sverker 183600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 184600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from: 185600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: sverker 186600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 187600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 188600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Major reformat of code to conform with style guide. Resolved compiler and javadoc warnings. Added CVS tags. 189600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 190600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: ---------------------------------------------------------------------- 191600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Issue number: 192600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change addresses one or more issues, 193600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then enter the issue number(s) here. 194600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Obtained from: 195600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change has been taken from another system, 196600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then name the system in this line, otherwise delete it. 197600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Submitted by: 198600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this code has been contributed to the project by someone else; i.e., 199600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: they sent us a patch or a set of diffs, then include their name/email 200600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: address here. If this is your work then delete this line. 201600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Reviewed by: 202600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If we are doing pre-commit code reviews and someone else has 203600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: reviewed your changes, include their name(s) here. 204600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If you have not had it reviewed then delete this line. 205600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 206600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 207