depends.org.apache.commons.httpclient.cookie

接口 CookieSpec

所有已知实现类:

CookieSpecBase, IgnoreCookiesSpec, NetscapeDraftSpec, RFC2109Spec, RFC2965Spec

public interface CookieSpec

Defines the cookie management specification.

Cookie management specification must define

• rules of parsing "Set-Cookie" header
• rules of validation of parsed cookies
• formatting of "Cookie" header

for a given host, port and path of origin

从以下版本开始:

2.0

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	PATH_DELIM Path delimiter
static char	PATH_DELIM_CHAR Path delimiting charachter

方法概要

方法

限定符和类型	方法和说明
boolean	domainMatch(java.lang.String host, java.lang.String domain) Performs domain-match as defined by the cookie specification.
java.lang.String	formatCookie(Cookie cookie) Create a "Cookie" header value for an array of cookies.
Header	formatCookieHeader(Cookie cookie) Create a "Cookie" Header for single Cookie.
Header	formatCookieHeader(Cookie[] cookies) Create a "Cookie" Header for an array of Cookies.
java.lang.String	formatCookies(Cookie[] cookies) Create a "Cookie" header value for an array of cookies.
java.util.Collection	getValidDateFormats() Returns the Collection of date patterns used for parsing.
boolean	match(java.lang.String host, int port, java.lang.String path, boolean secure, Cookie cookie) Determines if a Cookie matches a location.
Cookie[]	match(java.lang.String host, int port, java.lang.String path, boolean secure, Cookie[] cookies) Determines which of an array of Cookies matches a location.
Cookie[]	parse(java.lang.String host, int port, java.lang.String path, boolean secure, Header header) Parse the "Set-Cookie" Header into an array of Cookies.
Cookie[]	parse(java.lang.String host, int port, java.lang.String path, boolean secure, java.lang.String header) Parse the "Set-Cookie" header value into Cookie array.
void	parseAttribute(NameValuePair attribute, Cookie cookie) Parse the cookie attribute and update the corresponsing Cookie properties.
boolean	pathMatch(java.lang.String path, java.lang.String topmostPath) Performs path-match as defined by the cookie specification.
void	setValidDateFormats(java.util.Collection datepatterns) Sets the Collection of date patterns used for parsing.
void	validate(java.lang.String host, int port, java.lang.String path, boolean secure, Cookie cookie) Validate the cookie according to validation rules defined by the cookie specification.

字段详细资料

PATH_DELIM

static final java.lang.String PATH_DELIM

Path delimiter

另请参阅:

常量字段值

PATH_DELIM_CHAR

static final char PATH_DELIM_CHAR

Path delimiting charachter

方法详细资料

parse

Cookie[] parse(java.lang.String host,
             int port,
             java.lang.String path,
             boolean secure,
             java.lang.String header)
               throws MalformedCookieException,
                      java.lang.IllegalArgumentException

Parse the "Set-Cookie" header value into Cookie array.

This method will not perform the validation of the resultant Cookies

参数:

host - the host which sent the Set-Cookie header

port - the port which sent the Set-Cookie header

path - the path which sent the Set-Cookie header

secure - true when the Set-Cookie header was received over secure conection

header - the Set-Cookie received from the server

返回:

an array of Cookies parsed from the Set-Cookie value

抛出:

MalformedCookieException - if an exception occurs during parsing

java.lang.IllegalArgumentException - if an input parameter is illegal

另请参阅:

validate(String, int, String, boolean, Cookie)

parse

Cookie[] parse(java.lang.String host,
             int port,
             java.lang.String path,
             boolean secure,
             Header header)
               throws MalformedCookieException,
                      java.lang.IllegalArgumentException

Parse the "Set-Cookie" Header into an array of Cookies.

This method will not perform the validation of the resultant Cookies

参数:

host - the host which sent the Set-Cookie header

port - the port which sent the Set-Cookie header

path - the path which sent the Set-Cookie header

secure - true when the Set-Cookie header was received over secure conection

header - the Set-Cookie received from the server

返回:

an array of Cookies parsed from the header

抛出:

MalformedCookieException - if an exception occurs during parsing

java.lang.IllegalArgumentException - if an input parameter is illegal

另请参阅:

validate(String, int, String, boolean, Cookie)

parseAttribute

void parseAttribute(NameValuePair attribute,
                  Cookie cookie)
                    throws MalformedCookieException,
                           java.lang.IllegalArgumentException

Parse the cookie attribute and update the corresponsing Cookie properties.

参数:

attribute - cookie attribute from the Set-Cookie

cookie - the to be updated

抛出:

MalformedCookieException - if an exception occurs during parsing

java.lang.IllegalArgumentException - if an input parameter is illegal

validate

void validate(java.lang.String host,
            int port,
            java.lang.String path,
            boolean secure,
            Cookie cookie)
              throws MalformedCookieException,
                     java.lang.IllegalArgumentException

Validate the cookie according to validation rules defined by the cookie specification.

参数:

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

抛出:

MalformedCookieException - if the cookie is invalid

java.lang.IllegalArgumentException - if an input parameter is illegal

setValidDateFormats

void setValidDateFormats(java.util.Collection datepatterns)

Sets the Collection of date patterns used for parsing. The String patterns must be compatible with SimpleDateFormat.

参数:

datepatterns - collection of date patterns

getValidDateFormats

java.util.Collection getValidDateFormats()

Returns the Collection of date patterns used for parsing. The String patterns are compatible with the SimpleDateFormat.

返回:

collection of date patterns

match

boolean match(java.lang.String host,
            int port,
            java.lang.String path,
            boolean secure,
            Cookie cookie)

Determines if a Cookie matches a location.

参数:

host - the host to which the request is being submitted

port - the port to which the request is being submitted

path - the path to which the request is being submitted

secure - true if the request is using a secure connection

cookie - the Cookie to be matched

返回:

true if the cookie should be submitted with a request with given attributes, false otherwise.

match

Cookie[] match(java.lang.String host,
             int port,
             java.lang.String path,
             boolean secure,
             Cookie[] cookies)

Determines which of an array of Cookies matches a location.

参数:

host - the host to which the request is being submitted

port - the port to which the request is being submitted (currenlty 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

返回:

true if the cookie should be submitted with a request with given attributes, false otherwise.

domainMatch

boolean domainMatch(java.lang.String host,
                  java.lang.String domain)

Performs domain-match as defined by the cookie specification.

参数:

host - The target host.

domain - The cookie domain attribute.

返回:

true if the specified host matches the given domain.

从以下版本开始:

3.0

pathMatch

boolean pathMatch(java.lang.String path,
                java.lang.String topmostPath)

Performs path-match as defined by the cookie specification.

参数:

path - The target path.

topmostPath - The cookie path attribute.

返回:

true if the paths match

从以下版本开始:

3.0

formatCookie

java.lang.String formatCookie(Cookie cookie)

Create a "Cookie" header value for an array of cookies.

参数:

cookie - the cookie to be formatted as string

返回:

a string suitable for sending in a "Cookie" header.

formatCookies

java.lang.String formatCookies(Cookie[] cookies)
                               throws java.lang.IllegalArgumentException

Create a "Cookie" header value for an array of cookies.

参数:

cookies - the Cookies to be formatted

返回:

a string suitable for sending in a Cookie header.

抛出:

java.lang.IllegalArgumentException - if an input parameter is illegal

formatCookieHeader

Header formatCookieHeader(Cookie[] cookies)
                          throws java.lang.IllegalArgumentException

Create a "Cookie" Header for an array of Cookies.

参数:

cookies - the Cookies format into a Cookie header

返回:

a Header for the given Cookies.

抛出:

java.lang.IllegalArgumentException - if an input parameter is illegal

formatCookieHeader

Header formatCookieHeader(Cookie cookie)
                          throws java.lang.IllegalArgumentException

Create a "Cookie" Header for single Cookie.

参数:

cookie - the Cookie format as a Cookie header

返回:

a Cookie header.

抛出:

java.lang.IllegalArgumentException - if an input parameter is illegal