Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public interface

CookieSpec

org.apache.http.cookie.CookieSpec
Known Indirect Subclasses

Class Overview

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

Summary

Public Methods
abstract List < Header > )">formatCookies ( List < Cookie > cookies)
Create "Cookie" headers for an array of Cookies.
abstract int getVersion ()
Returns version of the state management this cookie specification conforms to.
abstract Header getVersionHeader ()
Returns a request header identifying what version of the state management specification is understood.
abstract boolean match ( Cookie cookie, CookieOrigin origin)
Determines if a Cookie matches the target location.
abstract List < Cookie > parse ( Header header, CookieOrigin origin)
Parse the "Set-Cookie" Header into an array of Cookies.
abstract void validate ( Cookie cookie, CookieOrigin origin)
Validate the cookie according to validation rules defined by the cookie specification.

Public Methods

)">

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

Added in API level 1

Create "Cookie" headers for an array of Cookies.

Parameters
cookies the Cookies format into a Cookie header
Returns
  • a Header for the given Cookies.
Throws
IllegalArgumentException if an input parameter is illegal

public abstract int getVersion ()

Added in API level 1

Returns version of the state management this cookie specification conforms to.

Returns
  • version of the state management specification

public abstract Header getVersionHeader ()

Added in API level 1

Returns a request header identifying what version of the state management specification is understood. May be null if the cookie specification does not support Cookie2 header.

public abstract boolean match ( Cookie cookie, CookieOrigin origin)

Added in API level 1

Determines if a Cookie matches the target location.

Parameters
cookie the Cookie to be matched
origin the target to test against
Returns
  • true if the cookie should be submitted with a request with given attributes, false otherwise.

public abstract List < Cookie > parse ( Header header, CookieOrigin origin)

Added in API level 1

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

This method will not perform the validation of the resultant Cookie s

Parameters
header the Set-Cookie received from the server
origin details of the cookie origin
Returns
  • an array of Cookie s parsed from the header
Throws
MalformedCookieException if an exception occurs during parsing

public abstract void validate ( Cookie cookie, CookieOrigin origin)

Added in API level 1

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

Parameters
cookie the Cookie to validate
origin details of the cookie origin
Throws
MalformedCookieException if the cookie is invalid