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 Wang 32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/** 33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Parser for the challenge portion of the authentication header. 34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.8 $ $Date: 2009/07/17 18:57:58 $ 36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @since 1.1 37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author Olivier Deruelle <br/> 39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic abstract class ChallengeParser extends HeaderParser { 44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Constructor 47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param String challenge message to parse to set 48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected ChallengeParser(String challenge) { 50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(challenge); 51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Constructor 55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param String challenge message to parse to set 56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected ChallengeParser(Lexer lexer) { 58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(lexer); 59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Get the parameter of the challenge string 63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return NameValue containing the parameter 64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected void parseParameter(AuthenticationHeader header) 66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throws ParseException { 67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (debug) 69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang dbg_enter("parseParameter"); 70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang try { 71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang NameValue nv = this.nameValue('='); 72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang header.setParameter(nv); 73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } finally { 74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (debug) 75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang dbg_leave("parseParameter"); 76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * parser the String message. 82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param header - header structure to fill in. 83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @throws ParseException if the message does not respect the spec. 84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void parse(AuthenticationHeader header) throws ParseException { 86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang // the Scheme: 88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang lexer.match(TokenTypes.ID); 90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang Token type = lexer.getNextToken(); 91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang header.setScheme(type.getTokenValue()); 93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang // The parameters: 95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang try { 96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang while (lexer.lookAhead(0) != '\n') { 97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.parseParameter(header); 98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang char la = lexer.lookAhead(0); 100600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (la == '\n' || la == '\0') 101600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang break; 102600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.match(','); 103600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.lexer.SPorHT(); 104600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 105600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } catch (ParseException ex) { 106600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw ex; 107600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 108600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 109600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang} 110