Back to index...

	/*
	* Copyright (c) 2005, 2013, 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 java.net;

	import java.util.List;
	import java.util.StringTokenizer;
	import java.util.NoSuchElementException;
	import java.text.SimpleDateFormat;
	import java.util.TimeZone;
	import java.util.Calendar;
	import java.util.GregorianCalendar;
	import java.util.Date;
	import java.util.Locale;
	import java.util.Objects;

	/**
	* An HttpCookie object represents an HTTP cookie, which carries state
	* information between server and user agent. Cookie is widely adopted
	* to create stateful sessions.
	*
	* <p> There are 3 HTTP cookie specifications:
	* <blockquote>
	* Netscape draft<br>
	* RFC 2109 - <a href="http://www.ietf.org/rfc/rfc2109.txt">
	* <i>http://www.ietf.org/rfc/rfc2109.txt</i></a><br>
	* RFC 2965 - <a href="http://www.ietf.org/rfc/rfc2965.txt">
	* <i>http://www.ietf.org/rfc/rfc2965.txt</i></a>
	* </blockquote>
	*
	* <p> HttpCookie class can accept all these 3 forms of syntax.
	*
	* @author Edward Wang
	* @since 1.6
	*/
	public final class HttpCookie implements Cloneable {
	// ---------------- Fields --------------

	// The value of the cookie itself.
	private final String name; // NAME= ... "$Name" style is reserved
	private String value; // value of NAME

	// Attributes encoded in the header's cookie fields.
	private String comment; // Comment=VALUE ... describes cookie's use
	private String commentURL; // CommentURL="http URL" ... describes cookie's use
	private boolean toDiscard; // Discard ... discard cookie unconditionally
	private String domain; // Domain=VALUE ... domain that sees cookie
	private long maxAge = MAX_AGE_UNSPECIFIED; // Max-Age=VALUE ... cookies auto-expire
	private String path; // Path=VALUE ... URLs that see the cookie
	private String portlist; // Port[="portlist"] ... the port cookie may be returned to
	private boolean secure; // Secure ... e.g. use SSL
	private boolean httpOnly; // HttpOnly ... i.e. not accessible to scripts
	private int version = 1; // Version=1 ... RFC 2965 style

	// The original header this cookie was consructed from, if it was
	// constructed by parsing a header, otherwise null.
	private final String header;

	// Hold the creation time (in seconds) of the http cookie for later
	// expiration calculation
	private final long whenCreated;

	// Since the positive and zero max-age have their meanings,
	// this value serves as a hint as 'not specify max-age'
	private final static long MAX_AGE_UNSPECIFIED = -1;

	// date formats used by Netscape's cookie draft
	// as well as formats seen on various sites
	private final static String[] COOKIE_DATE_FORMATS = {
	"EEE',' dd-MMM-yyyy HH:mm:ss 'GMT'",
	"EEE',' dd MMM yyyy HH:mm:ss 'GMT'",
	"EEE MMM dd yyyy HH:mm:ss 'GMT'Z",
	"EEE',' dd-MMM-yy HH:mm:ss 'GMT'",
	"EEE',' dd MMM yy HH:mm:ss 'GMT'",
	"EEE MMM dd yy HH:mm:ss 'GMT'Z"
	};

	// constant strings represent set-cookie header token
	private final static String SET_COOKIE = "set-cookie:";
	private final static String SET_COOKIE2 = "set-cookie2:";

	// ---------------- Ctors --------------

	/**
	* Constructs a cookie with a specified name and value.
	*
	* <p> The name must conform to RFC 2965. That means it can contain
	* only ASCII alphanumeric characters and cannot contain commas,
	* semicolons, or white space or begin with a $ character. The cookie's
	* name cannot be changed after creation.
	*
	* <p> The value can be anything the server chooses to send. Its
	* value is probably of interest only to the server. The cookie's
	* value can be changed after creation with the
	* {@code setValue} method.
	*
	* <p> By default, cookies are created according to the RFC 2965
	* cookie specification. The version can be changed with the
	* {@code setVersion} method.
	*
	*
	* @param name
	* a {@code String} specifying the name of the cookie
	*
	* @param value
	* a {@code String} specifying the value of the cookie
	*
	* @throws IllegalArgumentException
	* if the cookie name contains illegal characters
	* @throws NullPointerException
	* if {@code name} is {@code null}
	*
	* @see #setValue
	* @see #setVersion
	*/
	public HttpCookie(String name, String value) {
	this(name, value, null /header/);
	}

	private HttpCookie(String name, String value, String header) {
	name = name.trim();
	if (name.length() == 0 \|\| !isToken(name) \|\| name.charAt(0) == '$') {
	throw new IllegalArgumentException("Illegal cookie name");
	}

	this.name = name;
	this.value = value;
	toDiscard = false;
	secure = false;

	whenCreated = System.currentTimeMillis();
	portlist = null;
	this.header = header;
	}

	/**
	* Constructs cookies from set-cookie or set-cookie2 header string.
	* RFC 2965 section 3.2.2 set-cookie2 syntax indicates that one header line
	* may contain more than one cookie definitions, so this is a static
	* utility method instead of another constructor.
	*
	* @param header
	* a {@code String} specifying the set-cookie header. The header
	* should start with "set-cookie", or "set-cookie2" token; or it
	* should have no leading token at all.
	*
	* @return a List of cookie parsed from header line string
	*
	* @throws IllegalArgumentException
	* if header string violates the cookie specification's syntax or
	* the cookie name contains illegal characters.
	* @throws NullPointerException
	* if the header string is {@code null}
	*/
	public static List<HttpCookie> parse(String header) {
	return parse(header, false);
	}

	// Private version of parse() that will store the original header used to
	// create the cookie, in the cookie itself. This can be useful for filtering
	// Set-Cookie[2] headers, using the internal parsing logic defined in this
	// class.
	private static List<HttpCookie> parse(String header, boolean retainHeader) {

	int version = guessCookieVersion(header);

	// if header start with set-cookie or set-cookie2, strip it off
	if (startsWithIgnoreCase(header, SET_COOKIE2)) {
	header = header.substring(SET_COOKIE2.length());
	} else if (startsWithIgnoreCase(header, SET_COOKIE)) {
	header = header.substring(SET_COOKIE.length());
	}

	List<HttpCookie> cookies = new java.util.ArrayList<>();
	// The Netscape cookie may have a comma in its expires attribute, while
	// the comma is the delimiter in rfc 2965/2109 cookie header string.
	// so the parse logic is slightly different
	if (version == 0) {
	// Netscape draft cookie
	HttpCookie cookie = parseInternal(header, retainHeader);
	cookie.setVersion(0);
	cookies.add(cookie);
	} else {
	// rfc2965/2109 cookie
	// if header string contains more than one cookie,
	// it'll separate them with comma
	List<String> cookieStrings = splitMultiCookies(header);
	for (String cookieStr : cookieStrings) {
	HttpCookie cookie = parseInternal(cookieStr, retainHeader);
	cookie.setVersion(1);
	cookies.add(cookie);
	}
	}

	return cookies;
	}

	// ---------------- Public operations --------------

	/**
	* Reports whether this HTTP cookie has expired or not.
	*
	* @return {@code true} to indicate this HTTP cookie has expired;
	* otherwise, {@code false}
	*/
	public boolean hasExpired() {
	if (maxAge == 0) return true;

	// if not specify max-age, this cookie should be
	// discarded when user agent is to be closed, but
	// it is not expired.
	if (maxAge == MAX_AGE_UNSPECIFIED) return false;

	long deltaSecond = (System.currentTimeMillis() - whenCreated) / 1000;
	if (deltaSecond > maxAge)
	return true;
	else
	return false;
	}

	/**
	* Specifies a comment that describes a cookie's purpose.
	* The comment is useful if the browser presents the cookie
	* to the user. Comments are not supported by Netscape Version 0 cookies.
	*
	* @param purpose
	* a {@code String} specifying the comment to display to the user
	*
	* @see #getComment
	*/
	public void setComment(String purpose) {
	comment = purpose;
	}

	/**
	* Returns the comment describing the purpose of this cookie, or
	* {@code null} if the cookie has no comment.
	*
	* @return a {@code String} containing the comment, or {@code null} if none
	*
	* @see #setComment
	*/
	public String getComment() {
	return comment;
	}

	/**
	* Specifies a comment URL that describes a cookie's purpose.
	* The comment URL is useful if the browser presents the cookie
	* to the user. Comment URL is RFC 2965 only.
	*
	* @param purpose
	* a {@code String} specifying the comment URL to display to the user
	*
	* @see #getCommentURL
	*/
	public void setCommentURL(String purpose) {
	commentURL = purpose;
	}

	/**
	* Returns the comment URL describing the purpose of this cookie, or
	* {@code null} if the cookie has no comment URL.
	*
	* @return a {@code String} containing the comment URL, or {@code null}
	* if none
	*
	* @see #setCommentURL
	*/
	public String getCommentURL() {
	return commentURL;
	}

	/**
	* Specify whether user agent should discard the cookie unconditionally.
	* This is RFC 2965 only attribute.
	*
	* @param discard
	* {@code true} indicates to discard cookie unconditionally
	*
	* @see #getDiscard
	*/
	public void setDiscard(boolean discard) {
	toDiscard = discard;
	}

	/**
	* Returns the discard attribute of the cookie
	*
	* @return a {@code boolean} to represent this cookie's discard attribute
	*
	* @see #setDiscard
	*/
	public boolean getDiscard() {
	return toDiscard;
	}

	/**
	* Specify the portlist of the cookie, which restricts the port(s)
	* to which a cookie may be sent back in a Cookie header.
	*
	* @param ports
	* a {@code String} specify the port list, which is comma separated
	* series of digits
	*
	* @see #getPortlist
	*/
	public void setPortlist(String ports) {
	portlist = ports;
	}

	/**
	* Returns the port list attribute of the cookie
	*
	* @return a {@code String} contains the port list or {@code null} if none
	*
	* @see #setPortlist
	*/
	public String getPortlist() {
	return portlist;
	}

	/**
	* Specifies the domain within which this cookie should be presented.
	*
	* <p> The form of the domain name is specified by RFC 2965. A domain
	* name begins with a dot ({@code .foo.com}) and means that
	* the cookie is visible to servers in a specified Domain Name System
	* (DNS) zone (for example, {@code www.foo.com}, but not
	* {@code a.b.foo.com}). By default, cookies are only returned
	* to the server that sent them.
	*
	* @param pattern
	* a {@code String} containing the domain name within which this
	* cookie is visible; form is according to RFC 2965
	*
	* @see #getDomain
	*/
	public void setDomain(String pattern) {
	if (pattern != null)
	domain = pattern.toLowerCase();
	else
	domain = pattern;
	}

	/**
	* Returns the domain name set for this cookie. The form of the domain name
	* is set by RFC 2965.
	*
	* @return a {@code String} containing the domain name
	*
	* @see #setDomain
	*/
	public String getDomain() {
	return domain;
	}

	/**
	* Sets the maximum age of the cookie in seconds.
	*
	* <p> A positive value indicates that the cookie will expire
	* after that many seconds have passed. Note that the value is
	* the <i>maximum</i> age when the cookie will expire, not the cookie's
	* current age.
	*
	* <p> A negative value means that the cookie is not stored persistently
	* and will be deleted when the Web browser exits. A zero value causes the
	* cookie to be deleted.
	*
	* @param expiry
	* an integer specifying the maximum age of the cookie in seconds;
	* if zero, the cookie should be discarded immediately; otherwise,
	* the cookie's max age is unspecified.
	*
	* @see #getMaxAge
	*/
	public void setMaxAge(long expiry) {
	maxAge = expiry;
	}

	/**
	* Returns the maximum age of the cookie, specified in seconds. By default,
	* {@code -1} indicating the cookie will persist until browser shutdown.
	*
	* @return an integer specifying the maximum age of the cookie in seconds
	*
	* @see #setMaxAge
	*/
	public long getMaxAge() {
	return maxAge;
	}

	/**
	* Specifies a path for the cookie to which the client should return
	* the cookie.
	*
	* <p> The cookie is visible to all the pages in the directory
	* you specify, and all the pages in that directory's subdirectories.
	* A cookie's path must include the servlet that set the cookie,
	* for example, <i>/catalog</i>, which makes the cookie
	* visible to all directories on the server under <i>/catalog</i>.
	*
	* <p> Consult RFC 2965 (available on the Internet) for more
	* information on setting path names for cookies.
	*
	* @param uri
	* a {@code String} specifying a path
	*
	* @see #getPath
	*/
	public void setPath(String uri) {
	path = uri;
	}

	/**
	* Returns the path on the server to which the browser returns this cookie.
	* The cookie is visible to all subpaths on the server.
	*
	* @return a {@code String} specifying a path that contains a servlet name,
	* for example, <i>/catalog</i>
	*
	* @see #setPath
	*/
	public String getPath() {
	return path;
	}

	/**
	* Indicates whether the cookie should only be sent using a secure protocol,
	* such as HTTPS or SSL.
	*
	* <p> The default value is {@code false}.
	*
	* @param flag
	* If {@code true}, the cookie can only be sent over a secure
	* protocol like HTTPS. If {@code false}, it can be sent over
	* any protocol.
	*
	* @see #getSecure
	*/
	public void setSecure(boolean flag) {
	secure = flag;
	}

	/**
	* Returns {@code true} if sending this cookie should be restricted to a
	* secure protocol, or {@code false} if the it can be sent using any
	* protocol.
	*
	* @return {@code false} if the cookie can be sent over any standard
	* protocol; otherwise, {@code true}
	*
	* @see #setSecure
	*/
	public boolean getSecure() {
	return secure;
	}

	/**
	* Returns the name of the cookie. The name cannot be changed after
	* creation.
	*
	* @return a {@code String} specifying the cookie's name
	*/
	public String getName() {
	return name;
	}

	/**
	* Assigns a new value to a cookie after the cookie is created.
	* If you use a binary value, you may want to use BASE64 encoding.
	*
	* <p> With Version 0 cookies, values should not contain white space,
	* brackets, parentheses, equals signs, commas, double quotes, slashes,
	* question marks, at signs, colons, and semicolons. Empty values may not
	* behave the same way on all browsers.
	*
	* @param newValue
	* a {@code String} specifying the new value
	*
	* @see #getValue
	*/
	public void setValue(String newValue) {
	value = newValue;
	}

	/**
	* Returns the value of the cookie.
	*
	* @return a {@code String} containing the cookie's present value
	*
	* @see #setValue
	*/
	public String getValue() {
	return value;
	}

	/**
	* Returns the version of the protocol this cookie complies with. Version 1
	* complies with RFC 2965/2109, and version 0 complies with the original
	* cookie specification drafted by Netscape. Cookies provided by a browser
	* use and identify the browser's cookie version.
	*
	* @return 0 if the cookie complies with the original Netscape
	* specification; 1 if the cookie complies with RFC 2965/2109
	*
	* @see #setVersion
	*/
	public int getVersion() {
	return version;
	}

	/**
	* Sets the version of the cookie protocol this cookie complies
	* with. Version 0 complies with the original Netscape cookie
	* specification. Version 1 complies with RFC 2965/2109.
	*
	* @param v
	* 0 if the cookie should comply with the original Netscape
	* specification; 1 if the cookie should comply with RFC 2965/2109
	*
	* @throws IllegalArgumentException
	* if {@code v} is neither 0 nor 1
	*
	* @see #getVersion
	*/
	public void setVersion(int v) {
	if (v != 0 && v != 1) {
	throw new IllegalArgumentException("cookie version should be 0 or 1");
	}

	version = v;
	}

	/**
	* Returns {@code true} if this cookie contains the <i>HttpOnly</i>
	* attribute. This means that the cookie should not be accessible to
	* scripting engines, like javascript.
	*
	* @return {@code true} if this cookie should be considered HTTPOnly
	*
	* @see #setHttpOnly(boolean)
	*/
	public boolean isHttpOnly() {
	return httpOnly;
	}

	/**
	* Indicates whether the cookie should be considered HTTP Only. If set to
	* {@code true} it means the cookie should not be accessible to scripting
	* engines like javascript.
	*
	* @param httpOnly
	* if {@code true} make the cookie HTTP only, i.e. only visible as
	* part of an HTTP request.
	*
	* @see #isHttpOnly()
	*/
	public void setHttpOnly(boolean httpOnly) {
	this.httpOnly = httpOnly;
	}

	/**
	* The utility method to check whether a host name is in a domain or not.
	*
	* <p> This concept is described in the cookie specification.
	* To understand the concept, some terminologies need to be defined first:
	* <blockquote>
	* effective host name = hostname if host name contains dot<br>
	*
	*      or = hostname.local if not
	* </blockquote>
	* <p>Host A's name domain-matches host B's if:
	* <blockquote><ul>
	* <li>their host name strings string-compare equal; or</li>
	* <li>A is a HDN string and has the form NB, where N is a non-empty
	* name string, B has the form .B', and B' is a HDN string. (So,
	* x.y.com domain-matches .Y.com but not Y.com.)</li>
	* </ul></blockquote>
	*
	* <p>A host isn't in a domain (RFC 2965 sec. 3.3.2) if:
	* <blockquote><ul>
	* <li>The value for the Domain attribute contains no embedded dots,
	* and the value is not .local.</li>
	* <li>The effective host name that derives from the request-host does
	* not domain-match the Domain attribute.</li>
	* <li>The request-host is a HDN (not IP address) and has the form HD,
	* where D is the value of the Domain attribute, and H is a string
	* that contains one or more dots.</li>
	* </ul></blockquote>
	*
	* <p>Examples:
	* <blockquote><ul>
	* <li>A Set-Cookie2 from request-host y.x.foo.com for Domain=.foo.com
	* would be rejected, because H is y.x and contains a dot.</li>
	* <li>A Set-Cookie2 from request-host x.foo.com for Domain=.foo.com
	* would be accepted.</li>
	* <li>A Set-Cookie2 with Domain=.com or Domain=.com., will always be
	* rejected, because there is no embedded dot.</li>
	* <li>A Set-Cookie2 from request-host example for Domain=.local will
	* be accepted, because the effective host name for the request-
	* host is example.local, and example.local domain-matches .local.</li>
	* </ul></blockquote>
	*
	* @param domain
	* the domain name to check host name with
	*
	* @param host
	* the host name in question
	*
	* @return {@code true} if they domain-matches; {@code false} if not
	*/
	public static boolean domainMatches(String domain, String host) {
	if (domain == null \|\| host == null)
	return false;

	// if there's no embedded dot in domain and domain is not .local
	boolean isLocalDomain = ".local".equalsIgnoreCase(domain);
	int embeddedDotInDomain = domain.indexOf('.');
	if (embeddedDotInDomain == 0)
	embeddedDotInDomain = domain.indexOf('.', 1);
	if (!isLocalDomain
	&& (embeddedDotInDomain == -1 \|\|
	embeddedDotInDomain == domain.length() - 1))
	return false;

	// if the host name contains no dot and the domain name
	// is .local or host.local
	int firstDotInHost = host.indexOf('.');
	if (firstDotInHost == -1 &&
	(isLocalDomain \|\|
	domain.equalsIgnoreCase(host + ".local"))) {
	return true;
	}

	int domainLength = domain.length();
	int lengthDiff = host.length() - domainLength;
	if (lengthDiff == 0) {
	// if the host name and the domain name are just string-compare euqal
	return host.equalsIgnoreCase(domain);
	}
	else if (lengthDiff > 0) {
	// need to check H & D component
	String H = host.substring(0, lengthDiff);
	String D = host.substring(lengthDiff);

	return (H.indexOf('.') == -1 && D.equalsIgnoreCase(domain));
	}
	else if (lengthDiff == -1) {
	// if domain is actually .host
	return (domain.charAt(0) == '.' &&
	host.equalsIgnoreCase(domain.substring(1)));
	}

	return false;
	}

	/**
	* Constructs a cookie header string representation of this cookie,
	* which is in the format defined by corresponding cookie specification,
	* but without the leading "Cookie:" token.
	*
	* @return a string form of the cookie. The string has the defined format
	*/
	@Override
	public String toString() {
	if (getVersion() > 0) {
	return toRFC2965HeaderString();
	} else {
	return toNetscapeHeaderString();
	}
	}

	/**
	* Test the equality of two HTTP cookies.
	*
	* <p> The result is {@code true} only if two cookies come from same domain
	* (case-insensitive), have same name (case-insensitive), and have same path
	* (case-sensitive).
	*
	* @return {@code true} if two HTTP cookies equal to each other;
	* otherwise, {@code false}
	*/
	@Override
	public boolean equals(Object obj) {
	if (obj == this)
	return true;
	if (!(obj instanceof HttpCookie))
	return false;
	HttpCookie other = (HttpCookie)obj;

	// One http cookie equals to another cookie (RFC 2965 sec. 3.3.3) if:
	// 1. they come from same domain (case-insensitive),
	// 2. have same name (case-insensitive),
	// 3. and have same path (case-sensitive).
	return equalsIgnoreCase(getName(), other.getName()) &&
	equalsIgnoreCase(getDomain(), other.getDomain()) &&
	Objects.equals(getPath(), other.getPath());
	}

	/**
	* Returns the hash code of this HTTP cookie. The result is the sum of
	* hash code value of three significant components of this cookie: name,
	* domain, and path. That is, the hash code is the value of the expression:
	* <blockquote>
	* getName().toLowerCase().hashCode()<br>
	* + getDomain().toLowerCase().hashCode()<br>
	* + getPath().hashCode()
	* </blockquote>
	*
	* @return this HTTP cookie's hash code
	*/
	@Override
	public int hashCode() {
	int h1 = name.toLowerCase().hashCode();
	int h2 = (domain!=null) ? domain.toLowerCase().hashCode() : 0;
	int h3 = (path!=null) ? path.hashCode() : 0;

	return h1 + h2 + h3;
	}

	/**
	* Create and return a copy of this object.
	*
	* @return a clone of this HTTP cookie
	*/
	@Override
	public Object clone() {
	try {
	return super.clone();
	} catch (CloneNotSupportedException e) {
	throw new RuntimeException(e.getMessage());
	}
	}

	// ---------------- Private operations --------------

	// Note -- disabled for now to allow full Netscape compatibility
	// from RFC 2068, token special case characters
	//
	// private static final String tspecials = "()<>@,;:\\\"/[]?={} \t";
	private static final String tspecials = ",; "; // deliberately includes space

	/*
	* Tests a string and returns true if the string counts as a token.
	*
	* @param value
	* the {@code String} to be tested
	*
	* @return {@code true} if the {@code String} is a token;
	* {@code false} if it is not
	*/
	private static boolean isToken(String value) {
	int len = value.length();

	for (int i = 0; i < len; i++) {
	char c = value.charAt(i);

	if (c < 0x20 \|\| c >= 0x7f \|\| tspecials.indexOf(c) != -1)
	return false;
	}
	return true;
	}

	/*
	* Parse header string to cookie object.
	*
	* @param header
	* header string; should contain only one NAME=VALUE pair
	*
	* @return an HttpCookie being extracted
	*
	* @throws IllegalArgumentException
	* if header string violates the cookie specification
	*/
	private static HttpCookie parseInternal(String header,
	boolean retainHeader)
	{
	HttpCookie cookie = null;
	String namevaluePair = null;

	StringTokenizer tokenizer = new StringTokenizer(header, ";");

	// there should always have at least on name-value pair;
	// it's cookie's name
	try {
	namevaluePair = tokenizer.nextToken();
	int index = namevaluePair.indexOf('=');
	if (index != -1) {
	String name = namevaluePair.substring(0, index).trim();
	String value = namevaluePair.substring(index + 1).trim();
	if (retainHeader)
	cookie = new HttpCookie(name,
	stripOffSurroundingQuote(value),
	header);
	else
	cookie = new HttpCookie(name,
	stripOffSurroundingQuote(value));
	} else {
	// no "=" in name-value pair; it's an error
	throw new IllegalArgumentException("Invalid cookie name-value pair");
	}
	} catch (NoSuchElementException ignored) {
	throw new IllegalArgumentException("Empty cookie header string");
	}

	// remaining name-value pairs are cookie's attributes
	while (tokenizer.hasMoreTokens()) {
	namevaluePair = tokenizer.nextToken();
	int index = namevaluePair.indexOf('=');
	String name, value;
	if (index != -1) {
	name = namevaluePair.substring(0, index).trim();
	value = namevaluePair.substring(index + 1).trim();
	} else {
	name = namevaluePair.trim();
	value = null;
	}

	// assign attribute to cookie
	assignAttribute(cookie, name, value);
	}

	return cookie;
	}

	/*
	* assign cookie attribute value to attribute name;
	* use a map to simulate method dispatch
	*/
	static interface CookieAttributeAssignor {
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue);
	}
	static final java.util.Map<String, CookieAttributeAssignor> assignors =
	new java.util.HashMap<>();
	static {
	assignors.put("comment", new CookieAttributeAssignor() {
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	if (cookie.getComment() == null)
	cookie.setComment(attrValue);
	}
	});
	assignors.put("commenturl", new CookieAttributeAssignor() {
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	if (cookie.getCommentURL() == null)
	cookie.setCommentURL(attrValue);
	}
	});
	assignors.put("discard", new CookieAttributeAssignor() {
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	cookie.setDiscard(true);
	}
	});
	assignors.put("domain", new CookieAttributeAssignor(){
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	if (cookie.getDomain() == null)
	cookie.setDomain(attrValue);
	}
	});
	assignors.put("max-age", new CookieAttributeAssignor(){
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	try {
	long maxage = Long.parseLong(attrValue);
	if (cookie.getMaxAge() == MAX_AGE_UNSPECIFIED)
	cookie.setMaxAge(maxage);
	} catch (NumberFormatException ignored) {
	throw new IllegalArgumentException(
	"Illegal cookie max-age attribute");
	}
	}
	});
	assignors.put("path", new CookieAttributeAssignor(){
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	if (cookie.getPath() == null)
	cookie.setPath(attrValue);
	}
	});
	assignors.put("port", new CookieAttributeAssignor(){
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	if (cookie.getPortlist() == null)
	cookie.setPortlist(attrValue == null ? "" : attrValue);
	}
	});
	assignors.put("secure", new CookieAttributeAssignor(){
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	cookie.setSecure(true);
	}
	});
	assignors.put("httponly", new CookieAttributeAssignor(){
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	cookie.setHttpOnly(true);
	}
	});
	assignors.put("version", new CookieAttributeAssignor(){
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	try {
	int version = Integer.parseInt(attrValue);
	cookie.setVersion(version);
	} catch (NumberFormatException ignored) {
	// Just ignore bogus version, it will default to 0 or 1
	}
	}
	});
	assignors.put("expires", new CookieAttributeAssignor(){ // Netscape only
	public void assign(HttpCookie cookie,
	String attrName,
	String attrValue) {
	if (cookie.getMaxAge() == MAX_AGE_UNSPECIFIED) {
	cookie.setMaxAge(cookie.expiryDate2DeltaSeconds(attrValue));
	}
	}
	});
	}
	private static void assignAttribute(HttpCookie cookie,
	String attrName,
	String attrValue)
	{
	// strip off the surrounding "-sign if there's any
	attrValue = stripOffSurroundingQuote(attrValue);

	CookieAttributeAssignor assignor = assignors.get(attrName.toLowerCase());
	if (assignor != null) {
	assignor.assign(cookie, attrName, attrValue);
	} else {
	// Ignore the attribute as per RFC 2965
	}
	}

	static {
	sun.misc.SharedSecrets.setJavaNetHttpCookieAccess(
	new sun.misc.JavaNetHttpCookieAccess() {
	public List<HttpCookie> parse(String header) {
	return HttpCookie.parse(header, true);
	}

	public String header(HttpCookie cookie) {
	return cookie.header;
	}
	}
	);
	}

	/*
	* Returns the original header this cookie was consructed from, if it was
	* constructed by parsing a header, otherwise null.
	*/
	private String header() {
	return header;
	}

	/*
	* Constructs a string representation of this cookie. The string format is
	* as Netscape spec, but without leading "Cookie:" token.
	*/
	private String toNetscapeHeaderString() {
	return getName() + "=" + getValue();
	}

	/*
	* Constructs a string representation of this cookie. The string format is
	* as RFC 2965/2109, but without leading "Cookie:" token.
	*/
	private String toRFC2965HeaderString() {
	StringBuilder sb = new StringBuilder();

	sb.append(getName()).append("=\"").append(getValue()).append('"');
	if (getPath() != null)
	sb.append(";$Path=\"").append(getPath()).append('"');
	if (getDomain() != null)
	sb.append(";$Domain=\"").append(getDomain()).append('"');
	if (getPortlist() != null)
	sb.append(";$Port=\"").append(getPortlist()).append('"');

	return sb.toString();
	}

	static final TimeZone GMT = TimeZone.getTimeZone("GMT");

	/*
	* @param dateString
	* a date string in one of the formats defined in Netscape cookie spec
	*
	* @return delta seconds between this cookie's creation time and the time
	* specified by dateString
	*/
	private long expiryDate2DeltaSeconds(String dateString) {
	Calendar cal = new GregorianCalendar(GMT);
	for (int i = 0; i < COOKIE_DATE_FORMATS.length; i++) {
	SimpleDateFormat df = new SimpleDateFormat(COOKIE_DATE_FORMATS[i],
	Locale.US);
	cal.set(1970, 0, 1, 0, 0, 0);
	df.setTimeZone(GMT);
	df.setLenient(false);
	df.set2DigitYearStart(cal.getTime());
	try {
	cal.setTime(df.parse(dateString));
	if (!COOKIE_DATE_FORMATS[i].contains("yyyy")) {
	// 2-digit years following the standard set
	// out it rfc 6265
	int year = cal.get(Calendar.YEAR);
	year %= 100;
	if (year < 70) {
	year += 2000;
	} else {
	year += 1900;
	}
	cal.set(Calendar.YEAR, year);
	}
	return (cal.getTimeInMillis() - whenCreated) / 1000;
	} catch (Exception e) {
	// Ignore, try the next date format
	}
	}
	return 0;
	}

	/*
	* try to guess the cookie version through set-cookie header string
	*/
	private static int guessCookieVersion(String header) {
	int version = 0;

	header = header.toLowerCase();
	if (header.indexOf("expires=") != -1) {
	// only netscape cookie using 'expires'
	version = 0;
	} else if (header.indexOf("version=") != -1) {
	// version is mandatory for rfc 2965/2109 cookie
	version = 1;
	} else if (header.indexOf("max-age") != -1) {
	// rfc 2965/2109 use 'max-age'
	version = 1;
	} else if (startsWithIgnoreCase(header, SET_COOKIE2)) {
	// only rfc 2965 cookie starts with 'set-cookie2'
	version = 1;
	}

	return version;
	}

	private static String stripOffSurroundingQuote(String str) {
	if (str != null && str.length() > 2 &&
	str.charAt(0) == '"' && str.charAt(str.length() - 1) == '"') {
	return str.substring(1, str.length() - 1);
	}
	if (str != null && str.length() > 2 &&
	str.charAt(0) == '\'' && str.charAt(str.length() - 1) == '\'') {
	return str.substring(1, str.length() - 1);
	}
	return str;
	}

	private static boolean equalsIgnoreCase(String s, String t) {
	if (s == t) return true;
	if ((s != null) && (t != null)) {
	return s.equalsIgnoreCase(t);
	}
	return false;
	}

	private static boolean startsWithIgnoreCase(String s, String start) {
	if (s == null \|\| start == null) return false;

	if (s.length() >= start.length() &&
	start.equalsIgnoreCase(s.substring(0, start.length()))) {
	return true;
	}

	return false;
	}

	/*
	* Split cookie header string according to rfc 2965:
	* 1) split where it is a comma;
	* 2) but not the comma surrounding by double-quotes, which is the comma
	* inside port list or embeded URIs.
	*
	* @param header
	* the cookie header string to split
	*
	* @return list of strings; never null
	*/
	private static List<String> splitMultiCookies(String header) {
	List<String> cookies = new java.util.ArrayList<String>();
	int quoteCount = 0;
	int p, q;

	for (p = 0, q = 0; p < header.length(); p++) {
	char c = header.charAt(p);
	if (c == '"') quoteCount++;
	if (c == ',' && (quoteCount % 2 == 0)) {
	// it is comma and not surrounding by double-quotes
	cookies.add(header.substring(q, p));
	q = p + 1;
	}
	}

	cookies.add(header.substring(q));

	return cookies;
	}
	}

Back to index...