/* * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package com.sun.xml.internal.ws.transport; import java.io.Serializable; import java.util.Comparator; import java.util.LinkedList; import java.util.List; import java.util.Map; import java.util.TreeMap; /** * HTTP request and response headers are represented by this class which implements * the interface {@link java.util.Map}<{@link String}, * {@link List}<{@link String}>>. * The keys are case-insensitive Strings representing the header names and * the value associated with each key is a {@link List}<{@link String}> with one * element for each occurrence of the header name in the request or response. *
* For example, if the request has the the following headers: *
* Then get("hEaDeRnAmE") would give both "value1", and "value2" values in a list ** HeaderName: value1 * HeadernaMe: value2 *
* All the normal {@link Map} methods are provided, but the following * additional convenience methods are most likely to be used: *
* All methods in this class accept null
values for keys and values.
* However, null keys will never will be present in HTTP request headers, and
* will not be output/sent in response headers. Null values can be represented
* as either a null entry for the key (i.e. the list is null) or where the key
* has a list, but one (or more) of the list's values is null. Null values are
* output as a header line containing the key but no associated value.
*
* @author Jitendra Kotamraju
*/
public class Headers extends TreeMap