|
HTML Parser Home Page | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.htmlparser.http.Cookie
public class Cookie
A HTTP cookie. This class represents a "Cookie", as used for session management with HTTP and HTTPS protocols. Cookies are used to get user agents (web browsers etc) to hold small amounts of state associated with a user's web browsing. Common applications for cookies include storing user preferences, automating low security user signon facilities, and helping collect data used for "shopping cart" style applications.
Cookies are named, and have a single value. They may have optional attributes, including a comment presented to the user, path and domain qualifiers for which hosts see the cookie, a maximum age, and a version. Current web browsers often have bugs in how they treat those attributes, so interoperability can be improved by not relying on them heavily.
Cookies are assigned by servers, using fields added to HTTP response headers. Cookies are passed back to those servers using fields added to HTTP request headers. Several cookies with the same name can be returned; they have different path attributes, but those attributes will not be visible when using "old format" cookies.
Cookies affect the caching of the web pages used to set their values. At this time, none of the sophisticated HTTP/1.1 cache control models are supported. Standard HTTP/1.0 caches will not cache pages which contain cookies created by this class.
Cookies are being standardized by the IETF. This class supports the original Cookie specification (from Netscape Communications Corp.) as well as the updated RFC 2109 specification.
Field Summary | |
---|---|
protected String |
mComment
Describes the cookie's use. |
protected String |
mDomain
Domain that sees cookie. |
protected Date |
mExpiry
Cookie expires after this date. |
protected String |
mName
The name of the cookie. |
protected String |
mPath
URLs that see the cookie. |
protected boolean |
mSecure
Use SSL. |
protected String |
mValue
The cookie value. |
protected int |
mVersion
If Version=1 it means RFC 2109++ style cookies. |
Constructor Summary | |
---|---|
Cookie(String name,
String value)
Defines a cookie with an initial name/value pair. |
Method Summary | |
---|---|
Object |
clone()
Returns a copy of this object. |
String |
getComment()
Returns the comment describing the purpose of this cookie, or null if no such comment has been defined. |
String |
getDomain()
Returns the domain of this cookie. |
Date |
getExpiryDate()
Returns the expiry date of the cookie. |
String |
getName()
Returns the name of the cookie. |
String |
getPath()
Returns the prefix of all URLs for which this cookie is targetted. |
boolean |
getSecure()
Returns the value of the 'secure' flag. |
String |
getValue()
Returns the value of the cookie. |
int |
getVersion()
Returns the version of the cookie. |
void |
setComment(String purpose)
If a user agent (web browser) presents this cookie to a user, the cookie's purpose will be described using this comment. |
void |
setDomain(String pattern)
This cookie should be presented only to hosts satisfying this domain name pattern. |
void |
setExpiryDate(Date expiry)
Sets the expiry date of the cookie. |
void |
setPath(String uri)
This cookie should be presented only with requests beginning with this URL. |
void |
setSecure(boolean flag)
Indicates to the user agent that the cookie should only be sent using a secure protocol (https). |
void |
setValue(String newValue)
Sets the value of the cookie. |
void |
setVersion(int version)
Sets the version of the cookie protocol used when this cookie saves itself. |
String |
toString()
Convert this cookie into a user friendly string. |
Methods inherited from class java.lang.Object |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
protected String mName
protected String mValue
protected String mComment
protected String mDomain
protected Date mExpiry
protected String mPath
protected boolean mSecure
protected int mVersion
Constructor Detail |
---|
public Cookie(String name, String value) throws IllegalArgumentException
name
- The name of the cookie.value
- The value of the cookie.
IllegalArgumentException
- if the cookie name is not an HTTP/1.1 "token", or if it is
one of the tokens reserved for use by the cookie protocolMethod Detail |
---|
public void setComment(String purpose)
purpose
- The cookie comment.getComment()
public String getComment()
null
if none.setComment(java.lang.String)
public void setDomain(String pattern)
pattern
- The domain name pattern. The pattern is converted to
lower case to accommodate less capable browsers.getDomain()
public String getDomain()
setDomain(java.lang.String)
public void setExpiryDate(Date expiry)
expiry
- The expiry date for this cookie, or null
if
the cookie is persistent.getExpiryDate()
public Date getExpiryDate()
null
if it is persistent.setExpiryDate(java.util.Date)
public void setPath(String uri)
uri
- The exclusion prefix for the cookie.getPath()
public String getPath()
setPath(java.lang.String)
public void setSecure(boolean flag)
flag
- Use true
if the cookie is to be sent using
secure protocols, false
otherwise.getSecure()
public boolean getSecure()
true
if this cookie should only be sent using
a secure protocol, false
otherwise.setSecure(boolean)
public String getName()
public void setValue(String newValue)
With version zero cookies, you need to be careful about the kinds of values you use. Values with various special characters (whitespace, brackets and parentheses, the equals sign, comma, double quote, slashes, question marks, the "at" sign, colon, and semicolon) should be avoided. Empty values may not behave the same way on all browsers.
newValue
- The new value for the cookie.getValue()
public String getValue()
setValue(java.lang.String)
public int getVersion()
setVersion(int)
public void setVersion(int version)
version
- The version of the cookie, either 0 or 1.getVersion()
public Object clone()
clone
in class Object
public String toString()
toString
in class Object
|
© 2006 Derrick Oswald Sep 17, 2006
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
HTML Parser is an open source library released under Common Public License. |