org.apache.commons.httpclient.cookie
Class NetscapeDraftSpec
java.lang.Object
|
+--org.apache.commons.httpclient.cookie.CookieSpecBase
|
+--org.apache.commons.httpclient.cookie.NetscapeDraftSpec
- All Implemented Interfaces:
- CookieSpec
- public class NetscapeDraftSpec
- extends CookieSpecBase
Netscape cookie draft specific cookie management functions
- Since:
- 2.0
- Author:
- B.C. Holmes, Park, Sung-Gu, Doug Sale, Rod Waldhoff, dIon Gillard, Sean C. Sullivan, John Evans, Marc A. Saegesser, Oleg Kalnichevski, Mike Bowler
Methods inherited from class org.apache.commons.httpclient.cookie.CookieSpecBase |
domainMatch, formatCookie, formatCookieHeader, formatCookieHeader, formatCookies, getValidDateFormats, match, match, parse, pathMatch, setValidDateFormats |
Methods inherited from class java.lang.Object |
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
NetscapeDraftSpec
public NetscapeDraftSpec()
- Default constructor
parse
public Cookie[] parse(String host,
int port,
String path,
boolean secure,
String header)
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.
- Overrides:
parse
in class CookieSpecBase
- Parameters:
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 server- Returns:
- an array of Cookies parsed from the Set-Cookie value
- Throws:
MalformedCookieException
- if an exception occurs during parsing- Since:
- 3.0
parseAttribute
public void parseAttribute(NameValuePair attribute,
Cookie cookie)
throws MalformedCookieException
- Parse the cookie attribute and update the corresponsing
Cookie
properties as defined by the Netscape draft specification
- Overrides:
parseAttribute
in class CookieSpecBase
- Parameters:
attribute
- NameValuePair
cookie attribute from the
Set- Cookiecookie
- Cookie
to be updated- Throws:
MalformedCookieException
- if an exception occurs during parsing
validate
public void validate(String host,
int port,
String path,
boolean secure,
Cookie cookie)
throws MalformedCookieException
- Performs Netscape draft compliant
Cookie
validation
- Overrides:
validate
in class CookieSpecBase
- Parameters:
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 validate.- Throws:
MalformedCookieException
- if an exception occurs during
validation
Copyright © 2001-2004 Apache Software Foundation. All Rights Reserved.