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 Wangpackage gov.nist.javax.sip.parser; 27600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 28600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport gov.nist.javax.sip.header.*; 29600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport gov.nist.core.*; 30600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport java.text.ParseException; 31600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport javax.sip.*; 32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/** 34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Parser for SubscriptionState header. 35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.7 $ $Date: 2009/07/17 18:58:05 $ 37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author Olivier Deruelle 39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author M. Ranganathan 40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic class SubscriptionStateParser extends HeaderParser { 43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Creates a new instance of SubscriptionStateParser 46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param subscriptionState the header to parse 47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public SubscriptionStateParser(String subscriptionState) { 49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(subscriptionState); 50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Constructor 54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param lexer the lexer to use to parse the header 55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected SubscriptionStateParser(Lexer lexer) { 57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(lexer); 58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * parse the String message 62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return SIPHeader (SubscriptionState object) 63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @throws SIPParseException if the message does not respect the spec. 64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public SIPHeader parse() throws ParseException { 66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (debug) 68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang dbg_enter("SubscriptionStateParser.parse"); 69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang SubscriptionState subscriptionState = new SubscriptionState(); 71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang try { 72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang headerName(TokenTypes.SUBSCRIPTION_STATE); 73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang subscriptionState.setHeaderName(SIPHeaderNames.SUBSCRIPTION_STATE); 75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang // State: 77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang lexer.match(TokenTypes.ID); 78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang Token token = lexer.getNextToken(); 79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang subscriptionState.setState(token.getTokenValue()); 80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang while (lexer.lookAhead(0) == ';') { 82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.match(';'); 83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang lexer.match(TokenTypes.ID); 85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang token = lexer.getNextToken(); 86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang String value = token.getTokenValue(); 87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (value.equalsIgnoreCase("reason")) { 88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.match('='); 89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang lexer.match(TokenTypes.ID); 91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang token = lexer.getNextToken(); 92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang value = token.getTokenValue(); 93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang subscriptionState.setReasonCode(value); 94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } else if (value.equalsIgnoreCase("expires")) { 95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.match('='); 96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang lexer.match(TokenTypes.ID); 98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang token = lexer.getNextToken(); 99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang value = token.getTokenValue(); 100600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang try { 101600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang int expires = Integer.parseInt(value); 102600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang subscriptionState.setExpires(expires); 103600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } catch (NumberFormatException ex) { 104600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw createParseException(ex.getMessage()); 105600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } catch (InvalidArgumentException ex) { 106600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw createParseException(ex.getMessage()); 107600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 108600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } else if (value.equalsIgnoreCase("retry-after")) { 109600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.match('='); 110600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 111600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang lexer.match(TokenTypes.ID); 112600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang token = lexer.getNextToken(); 113600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang value = token.getTokenValue(); 114600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang try { 115600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang int retryAfter = Integer.parseInt(value); 116600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang subscriptionState.setRetryAfter(retryAfter); 117600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } catch (NumberFormatException ex) { 118600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw createParseException(ex.getMessage()); 119600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } catch (InvalidArgumentException ex) { 120600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw createParseException(ex.getMessage()); 121600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 122600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } else { 123600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.match('='); 124600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 125600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang lexer.match(TokenTypes.ID); 126600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang Token secondToken = lexer.getNextToken(); 127600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang String secondValue = secondToken.getTokenValue(); 128600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang subscriptionState.setParameter(value, secondValue); 129600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 130600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 131600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 132600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } finally { 133600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (debug) 134600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang dbg_leave("SubscriptionStateParser.parse"); 135600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 136600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 137600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return subscriptionState; 138600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 139600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 140600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Test program 141600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public static void main(String args[]) throws ParseException { 142600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang String subscriptionState[] = { 143600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "Subscription-State: active \n", 144600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "Subscription-State: terminated;reason=rejected \n", 145600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "Subscription-State: pending;reason=probation;expires=36\n", 146600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "Subscription-State: pending;retry-after=10;expires=36\n", 147600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang "Subscription-State: pending;generic=void\n" 148600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang }; 149600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 150600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang for (int i = 0; i < subscriptionState.length; i++ ) { 151600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang SubscriptionStateParser parser = 152600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang new SubscriptionStateParser(subscriptionState[i]); 153600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang SubscriptionState ss= (SubscriptionState) parser.parse(); 154600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang System.out.println("encoded = " + ss.encode()); 155600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 156600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 157600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 158600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang} 159600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/* 160600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * $Log: SubscriptionStateParser.java,v $ 161600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.7 2009/07/17 18:58:05 emcho 162600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Converts indentation tabs to spaces so that we have a uniform indentation policy in the whole project. 163600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 164600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.6 2006/07/13 09:02:25 mranga 165600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 166600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from: 167600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: jeroen van bemmel 168600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 169600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Moved some changes from jain-sip-1.2 to java.net 170600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 171600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: ---------------------------------------------------------------------- 172600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Issue number: 173600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change addresses one or more issues, 174600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then enter the issue number(s) here. 175600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Obtained from: 176600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change has been taken from another system, 177600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then name the system in this line, otherwise delete it. 178600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Submitted by: 179600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this code has been contributed to the project by someone else; i.e., 180600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: they sent us a patch or a set of diffs, then include their name/email 181600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: address here. If this is your work then delete this line. 182600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Reviewed by: 183600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If we are doing pre-commit code reviews and someone else has 184600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: reviewed your changes, include their name(s) here. 185600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If you have not had it reviewed then delete this line. 186600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 187600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.3 2006/06/19 06:47:27 mranga 188600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * javadoc fixups 189600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 190600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.2 2006/06/16 15:26:28 mranga 191600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Added NIST disclaimer to all public domain files. Clean up some javadoc. Fixed a leak 192600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 193600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.1.1.1 2005/10/04 17:12:36 mranga 194600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 195600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Import 196600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 197600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 198600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Revision 1.4 2004/01/22 13:26:32 sverker 199600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Issue number: 200600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Obtained from: 201600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Submitted by: sverker 202600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Reviewed by: mranga 203600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 204600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Major reformat of code to conform with style guide. Resolved compiler and javadoc warnings. Added CVS tags. 205600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 206600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: ---------------------------------------------------------------------- 207600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Issue number: 208600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change addresses one or more issues, 209600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then enter the issue number(s) here. 210600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Obtained from: 211600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this change has been taken from another system, 212600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: then name the system in this line, otherwise delete it. 213600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Submitted by: 214600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If this code has been contributed to the project by someone else; i.e., 215600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: they sent us a patch or a set of diffs, then include their name/email 216600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: address here. If this is your work then delete this line. 217600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: Reviewed by: 218600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If we are doing pre-commit code reviews and someone else has 219600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: reviewed your changes, include their name(s) here. 220600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * CVS: If you have not had it reviewed then delete this line. 221600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 222600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 223