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 Wangimport javax.sip.header.*; 31600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport java.text.ParseException; 32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport javax.sip.InvalidArgumentException; 33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/** 35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * the WarningValue SIPObject. 36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author M. Ranganathan <br/> 38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author Olivier Deruelle <br/> 39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.8 $ $Date: 2009/10/18 13:46:33 $ 40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @see WarningList SIPHeader which strings these together. 44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic class Warning extends SIPHeader implements WarningHeader { 46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Comment for <code>serialVersionUID</code> 49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang private static final long serialVersionUID = -3433328864230783899L; 51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** warn code field, the warn code consists of three digits. 53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected int code; 55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** the name or pseudonym of the server adding 57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * the Warning header, for use in debugging 58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected String agent; 60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** warn-text field 62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected String text; 64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * constructor. 67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public Warning() { 69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(WARNING); 70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Encode the body of the header (return the stuff following name:). 73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *@return the string encoding of the header value. 74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String encodeBody() { 76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return text != null 77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang ? Integer.toString(code) 78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + SP 79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + agent 80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + SP 81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + DOUBLE_QUOTE 82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + text 83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + DOUBLE_QUOTE 84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang : Integer.toString(code) + SP + agent; 85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Gets code of WarningHeader 89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return code of WarningHeader 90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public int getCode() { 92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return code; 93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Gets agent host of WarningHeader 97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return agent host of WarningHeader 98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getAgent() { 100600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return agent; 101600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 102600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 103600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 104600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Gets text of WarningHeader 105600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return text of WarningHeader 106600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 107600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getText() { 108600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return text; 109600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 110600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 111600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 112600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Sets code of WarningHeader 113600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param code int to set 114600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @throws SipParseException if code is not accepted by implementation 115600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 116600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setCode(int code) throws InvalidArgumentException { 117600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (code >99 && code < 1000) { // check this is a 3DIGIT code 118600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.code = code; 119600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } else 120600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw new InvalidArgumentException( 121600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "Code parameter in the Warning header is invalid: code=" 122600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang + code); 123600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 124600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 125600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 126600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Sets host of WarningHeader 127600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param host String to set 128600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @throws ParseException if host is not accepted by implementation 129600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 130600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setAgent(String host) throws ParseException { 131600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (host == null) 132600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw new NullPointerException("the host parameter in the Warning header is null"); 133600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang else { 134600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.agent = host; 135600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 136600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 137600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 138600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 139600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Sets text of WarningHeader 140600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param text String to set 141600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @throws ParseException if text is not accepted by implementation 142600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 143600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setText(String text) throws ParseException { 144600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (text == null) { 145600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw new ParseException( 146600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "The text parameter in the Warning header is null", 147600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 0); 148600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } else 149600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.text = text; 150600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 151600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang} 152600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/* 153600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * $Log: Warning.java,v $ 154600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.8 2009/10/18 13:46:33 deruelle_jean 155600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * FindBugs Fixes (Category Performance Warnings) 156600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 157600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 158600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from: 159600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: Jean Deruelle 160600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: 161600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 162600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.7 2009/07/17 18:57:41 emcho 163600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Converts indentation tabs to spaces so that we have a uniform indentation policy in the whole project. 164600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 165600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.6 2006/07/13 09:01:44 mranga 166600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 167600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from: 168600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: jeroen van bemmel 169600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 170600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Moved some changes from jain-sip-1.2 to java.net 171600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 172600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: ---------------------------------------------------------------------- 173600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Issue number: 174600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change addresses one or more issues, 175600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then enter the issue number(s) here. 176600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Obtained from: 177600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change has been taken from another system, 178600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then name the system in this line, otherwise delete it. 179600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Submitted by: 180600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this code has been contributed to the project by someone else; i.e., 181600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: they sent us a patch or a set of diffs, then include their name/email 182600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: address here. If this is your work then delete this line. 183600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Reviewed by: 184600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If we are doing pre-commit code reviews and someone else has 185600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: reviewed your changes, include their name(s) here. 186600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If you have not had it reviewed then delete this line. 187600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 188600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.3 2006/06/19 06:47:27 mranga 189600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * javadoc fixups 190600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 191600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.2 2006/06/16 15:26:28 mranga 192600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Added NIST disclaimer to all public domain files. Clean up some javadoc. Fixed a leak 193600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 194600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.1.1.1 2005/10/04 17:12:35 mranga 195600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 196600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Import 197600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 198600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 199600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.4 2004/04/22 22:51:16 mranga 200600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: Thomas Froment 201600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 202600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 203600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Fixed corner cases. 204600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 205600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.2 2004/01/22 13:26:30 sverker 206600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 207600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from: 208600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: sverker 209600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 210600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 211600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Major reformat of code to conform with style guide. Resolved compiler and javadoc warnings. Added CVS tags. 212600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 213600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: ---------------------------------------------------------------------- 214600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Issue number: 215600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change addresses one or more issues, 216600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then enter the issue number(s) here. 217600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Obtained from: 218600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change has been taken from another system, 219600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then name the system in this line, otherwise delete it. 220600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Submitted by: 221600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this code has been contributed to the project by someone else; i.e., 222600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: they sent us a patch or a set of diffs, then include their name/email 223600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: address here. If this is your work then delete this line. 224600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Reviewed by: 225600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If we are doing pre-commit code reviews and someone else has 226600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: reviewed your changes, include their name(s) here. 227600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If you have not had it reviewed then delete this line. 228600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 229600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 230