org.apache.commons.httpclient.cookie
public class CookieSpecBase extends Object implements CookieSpec
Since: 2.0
Field Summary | |
---|---|
protected static Log | LOG Log object |
Constructor Summary | |
---|---|
CookieSpecBase() Default constructor |
Method Summary | |
---|---|
boolean | domainMatch(String host, String domain)
Performs domain-match as implemented in common browsers. |
String | formatCookie(Cookie cookie)
Return a string suitable for sending in a "Cookie" header |
Header | formatCookieHeader(Cookie[] cookies) |
Header | formatCookieHeader(Cookie cookie) |
String | formatCookies(Cookie[] cookies)
Create a "Cookie" header value containing all Cookies in
cookies suitable for sending in a "Cookie" header |
Collection | getValidDateFormats() |
boolean | match(String host, int port, String path, boolean secure, Cookie cookie)
Return true if the cookie should be submitted with a request
with given attributes, false otherwise. |
Cookie[] | match(String host, int port, String path, boolean secure, Cookie[] cookies)
Return an array of Cookies that should be submitted with a
request with given attributes, false otherwise. |
Cookie[] | parse(String host, int port, String path, boolean secure, String header)
Parses the Set-Cookie value into an array of Cookies.
|
Cookie[] | parse(String host, int port, String path, boolean secure, Header header) |
void | parseAttribute(NameValuePair attribute, Cookie cookie)
Parse the cookie attribute and update the corresponsing Cookie
properties.
|
boolean | pathMatch(String path, String topmostPath)
Performs path-match as implemented in common browsers. |
void | setValidDateFormats(Collection datepatterns) |
void | validate(String host, int port, String path, boolean secure, Cookie cookie)
Performs most common Cookie validation
|
Parameters: host The target host. domain The cookie domain attribute.
Returns: true if the specified host matches the given domain.
Parameters: cookie a Cookie to be formatted as string
Returns: a string suitable for sending in a "Cookie" header.
Parameters: cookies an array of Cookies to be formatted as a " Cookie" header
Returns: a "Cookie" Header.
Parameters: cookie Cookies to be formatted as a Cookie header
Returns: a Cookie header.
Parameters: cookies an array of Cookies to be formatted
Returns: a string suitable for sending in a Cookie header.
Throws: IllegalArgumentException if an input parameter is illegal
Parameters: host the host to which the request is being submitted port the port to which the request is being submitted (ignored) path the path to which the request is being submitted secure true if the request is using a secure connection cookie Cookie to be matched
Returns: true if the cookie matches the criterium
Parameters: host the host to which the request is being submitted port the port to which the request is being submitted (currently ignored) path the path to which the request is being submitted secure true if the request is using a secure protocol cookies an array of Cookies to be matched
Returns: an array of Cookies matching the criterium
The syntax for the Set-Cookie response header is:
set-cookie = "Set-Cookie:" cookies cookies = 1#cookie cookie = NAME "=" VALUE * (";" cookie-av) NAME = attr VALUE = value cookie-av = "Comment" "=" value | "Domain" "=" value | "Max-Age" "=" value | "Path" "=" value | "Secure" | "Version" "=" 1*DIGIT
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
The syntax for the Set-Cookie response header is:
set-cookie = "Set-Cookie:" cookies cookies = 1#cookie cookie = NAME "=" VALUE * (";" cookie-av) NAME = attr VALUE = value cookie-av = "Comment" "=" value | "Domain" "=" value | "Max-Age" "=" value | "Path" "=" value | "Secure" | "Version" "=" 1*DIGIT
Parameters: host the host from which the Set-Cookie header was received port the port from which the Set-Cookie header was received path the path from which the Set-Cookie header was received secure true when the Set-Cookie header was received over secure conection header the Set-Cookie received from the server
Returns: an array of Cookies parsed from the "Set-Cookie" header
Throws: MalformedCookieException if an exception occurs during parsing
Parameters: attribute HeaderElement cookie attribute from the Set- Cookie cookie Cookie to be updated
Throws: MalformedCookieException if an exception occurs during parsing
Parameters: path The target path. topmostPath The cookie path attribute.
Returns: true if the paths match
Parameters: host the host from which the Cookie was received port the port from which the Cookie was received path the path from which the Cookie was received secure true when the Cookie was received using a secure connection cookie The cookie to validate.
Throws: MalformedCookieException if an exception occurs during validation