public class RFC2965Spec extends CookieSpecBase implements CookieVersionSupport
RFC 2965 specific cookie management functions.
Modifier and Type | Field and Description |
---|---|
static String |
SET_COOKIE2_KEY
Cookie Response Header name for cookies processed
by this spec.
|
PATH_DELIM, PATH_DELIM_CHAR
Constructor and Description |
---|
RFC2965Spec()
Default constructor
|
Modifier and Type | Method and Description |
---|---|
boolean |
domainMatch(String host,
String domain)
Performs domain-match as defined by the RFC2965.
|
String |
formatCookie(Cookie cookie)
Return a string suitable for sending in a "Cookie" header as
defined in RFC 2965
|
String |
formatCookies(Cookie[] cookies)
Create a RFC 2965 compliant "Cookie" header value containing all
Cookie s suitable for
sending in a "Cookie" header |
int |
getVersion() |
Header |
getVersionHeader() |
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[] |
parse(String host,
int port,
String path,
boolean secure,
Header header)
Parses the Set-Cookie2 value into an array of Cookies.
|
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 RFC 2965 specific cookie attribute and update the corresponsing
Cookie properties. |
void |
validate(String host,
int port,
String path,
boolean secure,
Cookie cookie)
Performs RFC 2965 compliant
Cookie validation |
formatCookieHeader, formatCookieHeader, getValidDateFormats, match, pathMatch, setValidDateFormats
public static final String SET_COOKIE2_KEY
public Cookie[] parse(String host, int port, String path, boolean secure, Header header) throws MalformedCookieException
The syntax for the Set-Cookie2 response header is:
set-cookie = "Set-Cookie2:" cookies cookies = 1#cookie cookie = NAME "=" VALUE * (";" cookie-av) NAME = attr VALUE = value cookie-av = "Comment" "=" value | "CommentURL" "=" <"> http_URL <"> | "Discard" | "Domain" "=" value | "Max-Age" "=" value | "Path" "=" value | "Port" [ "=" <"> portlist <"> ] | "Secure" | "Version" "=" 1*DIGIT portlist = 1#portnum portnum = 1*DIGIT
parse
in interface CookieSpec
parse
in class CookieSpecBase
host
- the host from which the Set-Cookie2 value was
receivedport
- the port from which the Set-Cookie2 value was
receivedpath
- the path from which the Set-Cookie2 value was
receivedsecure
- true when the Set-Cookie2 value was
received over secure conectionheader
- the Set-Cookie2 Header received from the serverMalformedCookieException
- if an exception occurs during parsingCookieSpec.validate(String, int, String, boolean, Cookie)
public Cookie[] parse(String host, int port, String path, boolean secure, String header) throws MalformedCookieException
CookieSpecBase
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
parse
in interface CookieSpec
parse
in class CookieSpecBase
host
- the host from which the Set-Cookie value was
receivedport
- the port from which the Set-Cookie value was
receivedpath
- the path from which the Set-Cookie value was
receivedsecure
- true when the Set-Cookie value was
received over secure conectionheader
- the Set-Cookie received from the serverMalformedCookieException
- if an exception occurs during parsingparse(String, int, String, boolean, org.apache.commons.httpclient.Header)
public void parseAttribute(NameValuePair attribute, Cookie cookie) throws MalformedCookieException
Cookie
properties.parseAttribute
in interface CookieSpec
parseAttribute
in class CookieSpecBase
attribute
- NameValuePair
cookie attribute from the
Set-Cookie2 header.cookie
- Cookie
to be updatedMalformedCookieException
- if an exception occurs during parsingpublic void validate(String host, int port, String path, boolean secure, Cookie cookie) throws MalformedCookieException
Cookie
validationvalidate
in interface CookieSpec
validate
in class CookieSpecBase
host
- the host from which the Cookie
was receivedport
- the port from which the Cookie
was receivedpath
- the path from which the Cookie
was receivedsecure
- true when the Cookie
was received using a
secure connectioncookie
- The cookie to validateMalformedCookieException
- if an exception occurs during
validationpublic boolean match(String host, int port, String path, boolean secure, Cookie cookie)
match
in interface CookieSpec
match
in class CookieSpecBase
host
- the host to which the request is being submittedport
- the port to which the request is being submitted (ignored)path
- the path to which the request is being submittedsecure
- true if the request is using a secure connectioncookie
- Cookie
to be matchedpublic String formatCookie(Cookie cookie)
formatCookie
in interface CookieSpec
formatCookie
in class CookieSpecBase
cookie
- a Cookie
to be formatted as stringpublic String formatCookies(Cookie[] cookies)
Cookie
s suitable for
sending in a "Cookie" headerformatCookies
in interface CookieSpec
formatCookies
in class CookieSpecBase
cookies
- an array of Cookie
s to be formattedpublic boolean domainMatch(String host, String domain)
Host A's name domain-matches host B's if
domainMatch
in interface CookieSpec
domainMatch
in class CookieSpecBase
host
- host name where cookie is received from or being sent to.domain
- The cookie domain attribute.public int getVersion()
getVersion
in interface CookieVersionSupport
public Header getVersionHeader()
getVersionHeader
in interface CookieVersionSupport
Copyright © 2010 - 2020 Adobe. All Rights Reserved