org.apache.hc.client5.http.cookie

接口 CookieSpec

所有已知实现类:

AbstractCookieSpec, CookieSpecBase, IgnoreSpecSpec, RFC6265CookieSpec, RFC6265LaxSpec, RFC6265StrictSpec

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

从以下版本开始:

4.0

方法概要

限定符和类型	方法和说明
List<Header>	formatCookies(List<Cookie> cookies) Create "Cookie" headers for an array of Cookies.
boolean	match(Cookie cookie, CookieOrigin origin) Determines if a Cookie matches the target location.
List<Cookie>	parse(Header header, CookieOrigin origin) Parse the "Set-Cookie" Header into an array of Cookies.
void	validate(Cookie cookie, CookieOrigin origin) Validate the cookie according to validation rules defined by the cookie specification.

方法详细资料

parse

List<Cookie> parse(Header header,
                   CookieOrigin origin)
            throws MalformedCookieException

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

This method will not perform the validation of the resultant Cookies

参数:

header - the Set-Cookie received from the server

origin - details of the cookie origin

返回:

an array of Cookies parsed from the header

抛出:

MalformedCookieException - if an exception occurs during parsing

另请参阅:

validate(org.apache.hc.client5.http.cookie.Cookie, org.apache.hc.client5.http.cookie.CookieOrigin)

validate

void validate(Cookie cookie,
              CookieOrigin origin)
       throws MalformedCookieException

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

参数:

cookie - the Cookie to validate

origin - details of the cookie origin

抛出:

MalformedCookieException - if the cookie is invalid

match

boolean match(Cookie cookie,
              CookieOrigin origin)

Determines if a Cookie matches the target location.

参数:

cookie - the Cookie to be matched

origin - the target to test against

返回:

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

formatCookies

List<Header> formatCookies(List<Cookie> cookies)

Create "Cookie" headers for an array of Cookies.

参数:

cookies - the Cookies format into a Cookie header

返回:

a Header for the given Cookies.

抛出:

IllegalArgumentException - if an input parameter is illegal