org.apache.commons.httpclient.cookie
public class NetscapeDraftSpec extends CookieSpecBase
Netscape cookie draft specific cookie management functions
Since: 2.0
Constructor Summary | |
---|---|
NetscapeDraftSpec() Default constructor |
Method Summary | |
---|---|
boolean | domainMatch(String host, String domain)
Performs domain-match as described in the Netscape draft. |
Cookie[] | parse(String host, int port, String path, boolean secure, String header)
Parses the Set-Cookie value into an array of Cookies.
|
void | parseAttribute(NameValuePair attribute, Cookie cookie)
Parse the cookie attribute and update the corresponsing {@link Cookie}
properties as defined by the Netscape draft specification
|
void | validate(String host, int port, String path, boolean secure, Cookie cookie)
Performs Netscape draft compliant {@link Cookie} validation
|
Parameters: host The target host. domain The cookie domain attribute.
Returns: true if the specified host matches the given domain.
Syntax of the Set-Cookie HTTP Response Header:
This is the format a CGI script would use to add to the HTTP headers a new piece of data which is to be stored by the client for later retrieval.
Set-Cookie: NAME=VALUE; expires=DATE; path=PATH; domain=DOMAIN_NAME; secure
Please note that Netscape draft specification does not fully conform to the HTTP header format. Netscape draft does not specify whether multiple cookies may be sent in one header. Hence, comma character may be present in unquoted cookie value or unquoted parameter value.
Parameters: host the host from which the Set-Cookie value was received port the port from which the Set-Cookie value was received path the path from which the Set-Cookie value was received secure true when the Set-Cookie value was received over secure conection header the Set-Cookie received from the server
Returns: an array of Cookies parsed from the Set-Cookie value
Throws: MalformedCookieException if an exception occurs during parsing
Since: 3.0
UNKNOWN: http://wp.netscape.com/newsref/std/cookie_spec.html
Parameters: attribute {@link NameValuePair} cookie attribute from the Set- Cookie cookie {@link Cookie} to be updated
Throws: MalformedCookieException if an exception occurs during parsing
Parameters: host the host from which the {@link Cookie} was received port the port from which the {@link Cookie} was received path the path from which the {@link Cookie} was received secure true when the {@link Cookie} was received using a secure connection cookie The cookie to validate.
Throws: MalformedCookieException if an exception occurs during validation