org.apache.http.impl.cookie
Class NetscapeDraftSpec

java.lang.Object
  org.apache.http.impl.cookie.AbstractCookieSpec
      org.apache.http.impl.cookie.CookieSpecBase
          org.apache.http.impl.cookie.NetscapeDraftSpec

All Implemented Interfaces:

CookieSpec

@NotThreadSafe
public class NetscapeDraftSpec
extends CookieSpecBase

This CookieSpec implementation conforms to the original draft specification published by Netscape Communications. It should be avoided unless absolutely necessary for compatibility with legacy code.

Since:

4.0

Field Summary

protected static String

EXPIRES_PATTERN

Constructor Summary

NetscapeDraftSpec()
Default constructor

NetscapeDraftSpec(String[] datepatterns)
Default constructor

Method Summary

List<Header>	formatCookies(List<Cookie> cookies) Create "Cookie" headers for an array of Cookies.
int	getVersion() Returns version of the state management this cookie specification conforms to.
Header	getVersionHeader() Returns a request header identifying what version of the state management specification is understood.
List<Cookie>	parse(Header header, CookieOrigin origin) Parses the Set-Cookie value into an array of Cookies.
String	toString()

Methods inherited from class org.apache.http.impl.cookie.CookieSpecBase

getDefaultDomain, getDefaultPath, match, parse, validate

Methods inherited from class org.apache.http.impl.cookie.AbstractCookieSpec

findAttribHandler, getAttribHandler, getAttribHandlers, registerAttribHandler

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

EXPIRES_PATTERN

protected static final String EXPIRES_PATTERN

See Also:

Constant Field Values

Constructor Detail

NetscapeDraftSpec

public NetscapeDraftSpec(String[] datepatterns)

Default constructor

NetscapeDraftSpec

public NetscapeDraftSpec()

Default constructor

Method Detail

parse

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

Parses the Set-Cookie value into an array of Cookies.

Syntax of the Set-Cookie HTTP Response Header:

This is the format a CGI script would use to add to the HTTP headers a new piece of data which is to be stored by the client for later retrieval.

  Set-Cookie: NAME=VALUE; expires=DATE; path=PATH; domain=DOMAIN_NAME; secure
 

Please note that Netscape draft specification does not fully conform to the HTTP header format. Netscape draft does not specify whether multiple cookies may be sent in one header. Hence, comma character may be present in unquoted cookie value or unquoted parameter value.

Parameters:

header - the Set-Cookie received from the server

origin - details of the cookie origin

Returns:

an array of Cookies parsed from the Set-Cookie value

Throws:

MalformedCookieException - if an exception occurs during parsing

See Also:

The Cookie Spec.

formatCookies

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

Description copied from interface: CookieSpec

Create "Cookie" headers for an array of Cookies.

Parameters:

cookies - the Cookies format into a Cookie header

Returns:

a Header for the given Cookies.

getVersion

public int getVersion()

Description copied from interface: CookieSpec

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

Returns:

version of the state management specification

getVersionHeader

public Header getVersionHeader()

Description copied from interface: CookieSpec

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.

toString

public String toString()

Overrides:

toString in class Object