diff options
Diffstat (limited to 'src/org/apache/http/message/BasicNameValuePair.java')
-rw-r--r-- | src/org/apache/http/message/BasicNameValuePair.java | 189 |
1 files changed, 0 insertions, 189 deletions
diff --git a/src/org/apache/http/message/BasicNameValuePair.java b/src/org/apache/http/message/BasicNameValuePair.java deleted file mode 100644 index 59fcb42..0000000 --- a/src/org/apache/http/message/BasicNameValuePair.java +++ /dev/null @@ -1,189 +0,0 @@ -/* - * $HeadURL: http://svn.apache.org/repos/asf/httpcomponents/httpcore/trunk/module-main/src/main/java/org/apache/http/message/BasicNameValuePair.java $ - * $Revision: 604625 $ - * $Date: 2007-12-16 06:11:11 -0800 (Sun, 16 Dec 2007) $ - * - * ==================================================================== - * Licensed to the Apache Software Foundation (ASF) under one - * or more contributor license agreements. See the NOTICE file - * distributed with this work for additional information - * regarding copyright ownership. The ASF licenses this file - * to you under the Apache License, Version 2.0 (the - * "License"); you may not use this file except in compliance - * with the License. You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, - * software distributed under the License is distributed on an - * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - * KIND, either express or implied. See the License for the - * specific language governing permissions and limitations - * under the License. - * ==================================================================== - * - * This software consists of voluntary contributions made by many - * individuals on behalf of the Apache Software Foundation. For more - * information on the Apache Software Foundation, please see - * <http://www.apache.org/>. - * - */ - -package org.apache.http.message; - -import org.apache.http.NameValuePair; -import org.apache.http.util.CharArrayBuffer; -import org.apache.http.util.LangUtils; - -/** - * A simple class encapsulating an attribute/value pair. - * <p> - * This class comforms to the generic grammar and formatting rules outlined in the - * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2">Section 2.2</a> - * and - * <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.6">Section 3.6</a> - * of <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616</a> - * </p> - * <h>2.2 Basic Rules</h> - * <p> - * The following rules are used throughout this specification to describe basic parsing constructs. - * The US-ASCII coded character set is defined by ANSI X3.4-1986. - * </p> - * <pre> - * OCTET = <any 8-bit sequence of data> - * CHAR = <any US-ASCII character (octets 0 - 127)> - * UPALPHA = <any US-ASCII uppercase letter "A".."Z"> - * LOALPHA = <any US-ASCII lowercase letter "a".."z"> - * ALPHA = UPALPHA | LOALPHA - * DIGIT = <any US-ASCII digit "0".."9"> - * CTL = <any US-ASCII control character - * (octets 0 - 31) and DEL (127)> - * CR = <US-ASCII CR, carriage return (13)> - * LF = <US-ASCII LF, linefeed (10)> - * SP = <US-ASCII SP, space (32)> - * HT = <US-ASCII HT, horizontal-tab (9)> - * <"> = <US-ASCII double-quote mark (34)> - * </pre> - * <p> - * Many HTTP/1.1 header field values consist of words separated by LWS or special - * characters. These special characters MUST be in a quoted string to be used within - * a parameter value (as defined in section 3.6). - * <p> - * <pre> - * token = 1*<any CHAR except CTLs or separators> - * separators = "(" | ")" | "<" | ">" | "@" - * | "," | ";" | ":" | "\" | <"> - * | "/" | "[" | "]" | "?" | "=" - * | "{" | "}" | SP | HT - * </pre> - * <p> - * A string of text is parsed as a single word if it is quoted using double-quote marks. - * </p> - * <pre> - * quoted-string = ( <"> *(qdtext | quoted-pair ) <"> ) - * qdtext = <any TEXT except <">> - * </pre> - * <p> - * The backslash character ("\") MAY be used as a single-character quoting mechanism only - * within quoted-string and comment constructs. - * </p> - * <pre> - * quoted-pair = "\" CHAR - * </pre> - * <h>3.6 Transfer Codings</h> - * <p> - * Parameters are in the form of attribute/value pairs. - * </p> - * <pre> - * parameter = attribute "=" value - * attribute = token - * value = token | quoted-string - * </pre> - * - * @author <a href="mailto:oleg at ural.com">Oleg Kalnichevski</a> - * - */ -public class BasicNameValuePair implements NameValuePair, Cloneable { - - private final String name; - private final String value; - - /** - * Default Constructor taking a name and a value. The value may be null. - * - * @param name The name. - * @param value The value. - */ - public BasicNameValuePair(final String name, final String value) { - super(); - if (name == null) { - throw new IllegalArgumentException("Name may not be null"); - } - this.name = name; - this.value = value; - } - - /** - * Returns the name. - * - * @return String name The name - */ - public String getName() { - return this.name; - } - - /** - * Returns the value. - * - * @return String value The current value. - */ - public String getValue() { - return this.value; - } - - - /** - * Get a string representation of this pair. - * - * @return A string representation. - */ - public String toString() { - // don't call complex default formatting for a simple toString - - int len = this.name.length(); - if (this.value != null) - len += 1 + this.value.length(); - CharArrayBuffer buffer = new CharArrayBuffer(len); - - buffer.append(this.name); - if (this.value != null) { - buffer.append("="); - buffer.append(this.value); - } - return buffer.toString(); - } - - public boolean equals(final Object object) { - if (object == null) return false; - if (this == object) return true; - if (object instanceof NameValuePair) { - BasicNameValuePair that = (BasicNameValuePair) object; - return this.name.equals(that.name) - && LangUtils.equals(this.value, that.value); - } else { - return false; - } - } - - public int hashCode() { - int hash = LangUtils.HASH_SEED; - hash = LangUtils.hashCode(hash, this.name); - hash = LangUtils.hashCode(hash, this.value); - return hash; - } - - public Object clone() throws CloneNotSupportedException { - return super.clone(); - } - -} |