| /* |
| * Copyright (c) 2005, 2016, 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; |
| import jdk.internal.misc.JavaNetHttpCookieAccess; |
| import jdk.internal.misc.SharedSecrets; |
| |
| /** |
| * 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 constructed 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 static final long MAX_AGE_UNSPECIFIED = -1; |
| |
| // date formats used by Netscape's cookie draft |
| // as well as formats seen on various sites |
| private static final 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 static final String SET_COOKIE = "set-cookie:"; |
| private static final 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 < 0) 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) { |
| long delta = cookie.expiryDate2DeltaSeconds(attrValue); |
| cookie.setMaxAge(delta > 0 ? delta : 0); |
| } |
| } |
| }); |
| } |
| 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 { |
| SharedSecrets.setJavaNetHttpCookieAccess( |
| new 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 constructed 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<>(); |
| 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; |
| } |
| } |