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 gov.nist.core.*; 31600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport javax.sip.header.AcceptLanguageHeader; 32600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport javax.sip.InvalidArgumentException; 33600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangimport java.util.Locale; 34600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 35600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang/** 36600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Accept Language body. 37600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 38600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @author M. Ranganathan 39600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @version 1.2 $Revision: 1.8 $ $Date: 2009/10/18 13:46:32 $ 40600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @since 1.1 41600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 42600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 43600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * <pre> 44600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * HTTP RFC 2616 Section 14.4 45600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Accept-Language = "Accept-Language" ":" 46600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 1#( language-range [ ";" "q" "=" qvalue ] ) 47600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * language-range = ( ( 1*8ALPHA *( "-" 1*8ALPHA ) ) | "*" ) 48600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 49600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * </pre> 50600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 51600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @see AcceptLanguageList 52600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 53600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wangpublic final class AcceptLanguage 54600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang extends ParametersHeader 55600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang implements AcceptLanguageHeader { 56600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 57600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 58600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Comment for <code>serialVersionUID</code> 59600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 60600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang private static final long serialVersionUID = -4473982069737324919L; 61600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** languageRange field 62600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 63600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected String languageRange; 64600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 65600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** default constructor 66600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 67600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public AcceptLanguage() { 68600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang super(NAME); 69600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 70600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 71600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** Encode the value of this header to a string. 72600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang *@return encoded header as a string. 73600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 74600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang protected String encodeBody() { 75600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang StringBuffer encoding = new StringBuffer(); 76600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (languageRange != null) { 77600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang encoding.append(languageRange); 78600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 79600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (!parameters.isEmpty()) { 80600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang encoding.append(SEMICOLON).append(parameters.encode()); 81600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 82600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return encoding.toString(); 83600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 84600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 85600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** get the LanguageRange field 86600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return String 87600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 88600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public String getLanguageRange() { 89600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return languageRange; 90600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 91600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 92600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** get the QValue field. Return -1 if the parameter has not been 93600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * set. 94600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return float 95600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 96600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 97600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public float getQValue() { 98600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (!hasParameter("q")) 99600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return -1; 100600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return ((Float) parameters.getValue("q")).floatValue(); 101600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 102600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 103600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 104600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Return true if the q value has been set. 105600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @since 1.0 106600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return boolean 107600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 108600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public boolean hasQValue() { 109600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return hasParameter("q"); 110600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 111600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 112600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 113600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Remove the q value. 114600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @since 1.0 115600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 116600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void removeQValue() { 117600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang removeParameter("q"); 118600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 119600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 120600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 121600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Set the languageRange. 122600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 123600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param languageRange is the language range to set. 124600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 125600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 126600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setLanguageRange(String languageRange) { 127600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.languageRange = languageRange.trim(); 128600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 129600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 130600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 131600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Sets q-value for media-range in AcceptLanguageHeader. Q-values allow the 132600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 133600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * user to indicate the relative degree of preference for that media-range, 134600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 135600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * using the qvalue scale from 0 to 1. If no q-value is present, the 136600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 137600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * media-range should be treated as having a q-value of 1. 138600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 139600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 140600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 141600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param q The new float value of the q-value, a value of -1 resets 142600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * the qValue. 143600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 144600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @throws InvalidArgumentException if the q parameter value is not 145600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 146600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * <code>-1</code> or between <code>0 and 1</code>. 147600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 148600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 149600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setQValue(float q) throws InvalidArgumentException { 150600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (q < 0.0 || q > 1.0) 151600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang throw new InvalidArgumentException("qvalue out of range!"); 152600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (q == -1) 153600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.removeParameter("q"); 154600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang else 155600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.setParameter(new NameValue("q", Float.valueOf(q))); 156600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 157600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 158600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 159600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Gets the language value of the AcceptLanguageHeader. 160600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 161600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 162600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 163600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @return the language Locale value of this AcceptLanguageHeader 164600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 165600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 166600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public Locale getAcceptLanguage() { 167600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (this.languageRange == null) 168600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return null; 169600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang else { 170600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang int dash = languageRange.indexOf('-'); 171600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if (dash>=0) { 172600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang return new Locale( languageRange.substring(0,dash), languageRange.substring(dash+1) ); 173600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } else return new Locale( this.languageRange ); 174600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 175600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 176600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 177600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang /** 178600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * Sets the language parameter of this AcceptLanguageHeader. 179600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 180600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 181600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 182600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * @param language - the new Locale value of the language of 183600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 184600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * AcceptLanguageHeader 185600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 186600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang * 187600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang */ 188600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang public void setAcceptLanguage(Locale language) { 189600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang // JvB: need to take sub-tag into account 190600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang if ( "".equals(language.getCountry())) { 191600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.languageRange = language.getLanguage(); 192600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } else { 193600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang this.languageRange = language.getLanguage() + '-' + language.getCountry(); 194600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 195600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang } 196600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang 197600c7a4bbc7348167293eac928192e695b4ad5baChung-yih Wang} 198