ohair@286: /*
alanb@368:  * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved.
ohair@286:  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
ohair@286:  *
ohair@286:  * This code is free software; you can redistribute it and/or modify it
ohair@286:  * under the terms of the GNU General Public License version 2 only, as
ohair@286:  * published by the Free Software Foundation.  Oracle designates this
ohair@286:  * particular file as subject to the "Classpath" exception as provided
ohair@286:  * by Oracle in the LICENSE file that accompanied this code.
ohair@286:  *
ohair@286:  * This code is distributed in the hope that it will be useful, but WITHOUT
ohair@286:  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
ohair@286:  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
ohair@286:  * version 2 for more details (a copy is included in the LICENSE file that
ohair@286:  * accompanied this code).
ohair@286:  *
ohair@286:  * You should have received a copy of the GNU General Public License version
ohair@286:  * 2 along with this work; if not, write to the Free Software Foundation,
ohair@286:  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
ohair@286:  *
ohair@286:  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ohair@286:  * or visit www.oracle.com if you need additional information or have any
ohair@286:  * questions.
ohair@286:  */
ohair@286: 
ohair@286: package com.sun.xml.internal.ws.encoding;
ohair@286: 
ohair@286: import javax.xml.ws.WebServiceException;
ohair@286: import java.util.HashMap;
ohair@286: import java.util.Iterator;
ohair@286: import java.util.Map;
ohair@286: 
ohair@286: /**
ohair@286:  * This class holds MIME parameters (attribute-value pairs).
ohair@286:  *
ohair@286:  * @version 1.10, 03/02/12
ohair@286:  * @author  John Mani
ohair@286:  */
ohair@286: 
ohair@286: final class ParameterList {
ohair@286: 
ohair@286:     private final Map<String, String> list;
ohair@286: 
ohair@286:     /**
ohair@286:      * Constructor that takes a parameter-list string. The String
ohair@286:      * is parsed and the parameters are collected and stored internally.
ohair@286:      * A ParseException is thrown if the parse fails.
ohair@286:      * Note that an empty parameter-list string is valid and will be
ohair@286:      * parsed into an empty ParameterList.
ohair@286:      *
ohair@286:      * @param   s       the parameter-list string.
ohair@286:      * @exception WebServiceException if the parse fails.
ohair@286:      */
ohair@286:     ParameterList(String s) {
ohair@286:         HeaderTokenizer h = new HeaderTokenizer(s, HeaderTokenizer.MIME);
ohair@286:         HeaderTokenizer.Token tk;
ohair@286:         int type;
ohair@286:         String name;
ohair@286: 
ohair@286:         list = new HashMap<String, String>();
ohair@286:         while (true) {
ohair@286:             tk = h.next();
ohair@286:             type = tk.getType();
ohair@286: 
ohair@286:             if (type == HeaderTokenizer.Token.EOF) // done
ohair@286:             return;
ohair@286: 
ohair@286:             if ((char)type == ';') {
ohair@286:                 // expect parameter name
ohair@286:                 tk = h.next();
ohair@286:                 // tolerate trailing semicolon, even though it violates the spec
ohair@286:                 if (tk.getType() == HeaderTokenizer.Token.EOF)
ohair@286:                     return;
ohair@286:                 // parameter name must be a MIME Atom
ohair@286:                 if (tk.getType() != HeaderTokenizer.Token.ATOM)
ohair@286:                     throw new WebServiceException();
ohair@286:                 name = tk.getValue().toLowerCase();
ohair@286: 
ohair@286:                 // expect '='
ohair@286:                 tk = h.next();
ohair@286:                 if ((char)tk.getType() != '=')
ohair@286:                     throw new WebServiceException();
ohair@286: 
ohair@286:                 // expect parameter value
ohair@286:                 tk = h.next();
ohair@286:                 type = tk.getType();
ohair@286:                 // parameter value must be a MIME Atom or Quoted String
ohair@286:                 if (type != HeaderTokenizer.Token.ATOM &&
ohair@286:                     type != HeaderTokenizer.Token.QUOTEDSTRING)
ohair@286:                     throw new WebServiceException();
ohair@286: 
ohair@286:                 list.put(name, tk.getValue());
ohair@286:             } else
ohair@286:                 throw new WebServiceException();
ohair@286:         }
ohair@286:     }
ohair@286: 
ohair@286:     /**
ohair@286:      * Return the number of parameters in this list.
ohair@286:      *
ohair@286:      * @return  number of parameters.
ohair@286:      */
ohair@286:     int size() {
ohair@286:             return list.size();
ohair@286:     }
ohair@286: 
ohair@286:     /**
ohair@286:      * Returns the value of the specified parameter. Note that
ohair@286:      * parameter names are case-insensitive.
ohair@286:      *
ohair@286:      * @param name      parameter name.
ohair@286:      * @return          Value of the parameter. Returns
ohair@286:      *                  <code>null</code> if the parameter is not
ohair@286:      *                  present.
ohair@286:      */
ohair@286:     String get(String name) {
ohair@286:             return list.get(name.trim().toLowerCase());
ohair@286:     }
ohair@286: 
ohair@286: 
ohair@286:     /**
ohair@286:      * Return an enumeration of the names of all parameters in this
ohair@286:      * list.
ohair@286:      *
ohair@286:      * @return Enumeration of all parameter names in this list.
ohair@286:      */
ohair@286:     Iterator<String> getNames() {
ohair@286:             return list.keySet().iterator();
ohair@286:     }
ohair@286: 
ohair@286: }