/lib/src/org/apache/http/message/BasicHeader.java

 1/*
 2 * ====================================================================
 3 * Licensed to the Apache Software Foundation (ASF) under one
 4 * or more contributor license agreements.  See the NOTICE file
 5 * distributed with this work for additional information
 6 * regarding copyright ownership.  The ASF licenses this file
 7 * to you under the Apache License, Version 2.0 (the
 8 * "License"); you may not use this file except in compliance
 9 * with the License.  You may obtain a copy of the License at
10 *
11 *   http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing,
14 * software distributed under the License is distributed on an
15 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16 * KIND, either express or implied.  See the License for the
17 * specific language governing permissions and limitations
18 * under the License.
19 * ====================================================================
20 *
21 * This software consists of voluntary contributions made by many
22 * individuals on behalf of the Apache Software Foundation.  For more
23 * information on the Apache Software Foundation, please see
24 * <http://www.apache.org/>.
25 *
26 */
27
28package org.apache.http.message;
29
30import org.apache.http.Header;
31import org.apache.http.HeaderElement;
32import org.apache.http.ParseException;
33
34/**
35 * Basic implementation of {@link Header}.
36 * 
37 * @since 4.0
38 */
39public class BasicHeader implements Header, Cloneable {
40
41    private final String name;
42    private final String value;
43    
44    /**
45     * Constructor with name and value
46     *
47     * @param name the header name
48     * @param value the header value
49     */
50    public BasicHeader(final String name, final String value) {
51        super();
52        if (name == null) {
53            throw new IllegalArgumentException("Name may not be null");
54        }
55        this.name = name;
56        this.value = value;
57    }
58
59    public String getName() {
60        return this.name;
61    }
62
63    public String getValue() {
64        return this.value;
65    }
66
67    public String toString() {
68        // no need for non-default formatting in toString()
69        return BasicLineFormatter.DEFAULT.formatHeader(null, this).toString();
70    }
71
72    public HeaderElement[] getElements() throws ParseException {
73        if (this.value != null) {
74            // result intentionally not cached, it's probably not used again
75            return BasicHeaderValueParser.parseElements(this.value, null);
76        } else {
77            return new HeaderElement[] {}; 
78        }
79    }
80
81    public Object clone() throws CloneNotSupportedException {
82        return super.clone();
83    }
84 
85}