org.apache.http.cookie
Interface Cookie

All Known Subinterfaces:
ClientCookie, SetCookie, SetCookie2
All Known Implementing Classes:
BasicClientCookie, BasicClientCookie2

public interface Cookie

HTTP "magic-cookie" represents a piece of state information that the HTTP agent and the target server can exchange to maintain a session.

Since:
4.0
Author:
Oleg Kalnichevski

Method Summary
 java.lang.String getComment()
          Returns the comment describing the purpose of this cookie, or null if no such comment has been defined.
 java.lang.String getCommentURL()
          If a user agent (web browser) presents this cookie to a user, the cookie's purpose will be described by the information at this URL.
 java.lang.String getDomain()
          Returns domain attribute of the cookie.
 java.util.Date getExpiryDate()
          Returns the expiration Date of the cookie, or null if none exists.
 java.lang.String getName()
          Returns the name.
 java.lang.String getPath()
          Returns the path attribute of the cookie
 int[] getPorts()
          Get the Port attribute.
 java.lang.String getValue()
          Returns the value.
 int getVersion()
          Returns the version of the cookie specification to which this cookie conforms.
 boolean isExpired(java.util.Date date)
          Returns true if this cookie has expired.
 boolean isPersistent()
          Returns false if the cookie should be discarded at the end of the "session"; true otherwise.
 boolean isSecure()
          Indicates whether this cookie requires a secure connection.
 

Method Detail

getName

java.lang.String getName()
Returns the name.

Returns:
String name The name

getValue

java.lang.String getValue()
Returns the value.

Returns:
String value The current value.

getComment

java.lang.String getComment()
Returns the comment describing the purpose of this cookie, or null if no such comment has been defined.

Returns:
comment

getCommentURL

java.lang.String getCommentURL()
If a user agent (web browser) presents this cookie to a user, the cookie's purpose will be described by the information at this URL.


getExpiryDate

java.util.Date getExpiryDate()
Returns the expiration Date of the cookie, or null if none exists.

Note: the object returned by this method is considered immutable. Changing it (e.g. using setTime()) could result in undefined behaviour. Do so at your peril.

Returns:
Expiration Date, or null.

isPersistent

boolean isPersistent()
Returns false if the cookie should be discarded at the end of the "session"; true otherwise.

Returns:
false if the cookie should be discarded at the end of the "session"; true otherwise

getDomain

java.lang.String getDomain()
Returns domain attribute of the cookie.

Returns:
the value of the domain attribute

getPath

java.lang.String getPath()
Returns the path attribute of the cookie

Returns:
The value of the path attribute.

getPorts

int[] getPorts()
Get the Port attribute. It restricts the ports to which a cookie may be returned in a Cookie request header.


isSecure

boolean isSecure()
Indicates whether this cookie requires a secure connection.

Returns:
true if this cookie should only be sent over secure connections, false otherwise.

getVersion

int getVersion()
Returns the version of the cookie specification to which this cookie conforms.

Returns:
the version of the cookie.

isExpired

boolean isExpired(java.util.Date date)
Returns true if this cookie has expired.

Parameters:
date - Current time
Returns:
true if the cookie has expired.


Copyright © 1999-2008 Apache Software Foundation. All Rights Reserved.