Package org.apache.http.impl.cookie

Class BasicClientCookie

java.lang.Object

org.apache.http.impl.cookie.BasicClientCookie

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, ClientCookie, Cookie, SetCookie

Direct Known Subclasses:

BasicClientCookie2

public class BasicClientCookie
extends java.lang.Object
implements SetCookie, ClientCookie, java.lang.Cloneable, java.io.Serializable

Default implementation of SetCookie.

Since:

4.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.Map<java.lang.String,java.lang.String>	attribs	Cookie attributes as specified by the origin server
private java.lang.String	cookieComment	Comment attribute.
private java.lang.String	cookieDomain	Domain attribute.
private java.util.Date	cookieExpiryDate	Expiration Date.
private java.lang.String	cookiePath	Path attribute.
private int	cookieVersion	The version of the cookie specification I was created from.
private java.util.Date	creationDate
private boolean	isSecure	My secure flag.
private java.lang.String	name	Cookie name
private static long	serialVersionUID
private java.lang.String	value	Cookie value

Fields inherited from interface org.apache.http.cookie.ClientCookie

COMMENT_ATTR, COMMENTURL_ATTR, DISCARD_ATTR, DOMAIN_ATTR, EXPIRES_ATTR, MAX_AGE_ATTR, PATH_ATTR, PORT_ATTR, SECURE_ATTR, VERSION_ATTR

Constructor Summary

Constructors

Constructor	Description
BasicClientCookie(java.lang.String name, java.lang.String value)	Default Constructor taking a name and a value.

Method Summary

Modifier and Type	Method	Description
java.lang.Object	clone()
boolean	containsAttribute(java.lang.String name)
java.lang.String	getAttribute(java.lang.String name)
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()	Returns null.
java.util.Date	getCreationDate()
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()	Returns null.
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.
boolean	removeAttribute(java.lang.String name)
void	setAttribute(java.lang.String name, java.lang.String value)
void	setComment(java.lang.String comment)	If a user agent (web browser) presents this cookie to a user, the cookie's purpose will be described using this comment.
void	setCreationDate(java.util.Date creationDate)
void	setDomain(java.lang.String domain)	Sets the domain attribute.
void	setExpiryDate(java.util.Date expiryDate)	Sets expiration date.
void	setPath(java.lang.String path)	Sets the path attribute.
void	setSecure(boolean secure)	Sets the secure attribute of the cookie.
void	setValue(java.lang.String value)	Sets the value
void	setVersion(int version)	Sets the version of the cookie specification to which this cookie conforms.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

name

private final java.lang.String name

Cookie name

attribs

private java.util.Map<java.lang.String,java.lang.String> attribs

Cookie attributes as specified by the origin server

value

private java.lang.String value

Cookie value

cookieComment

private java.lang.String cookieComment

Comment attribute.

cookieDomain

private java.lang.String cookieDomain

Domain attribute.

cookieExpiryDate

private java.util.Date cookieExpiryDate

Expiration Date.

cookiePath

private java.lang.String cookiePath

Path attribute.

isSecure

private boolean isSecure

My secure flag.

cookieVersion

private int cookieVersion

The version of the cookie specification I was created from.

creationDate

private java.util.Date creationDate

Constructor Detail

BasicClientCookie

public BasicClientCookie(java.lang.String name,
                         java.lang.String value)

Default Constructor taking a name and a value. The value may be null.

Parameters:

name - The name.

value - The value.

Method Detail

getName

public java.lang.String getName()

Returns the name.

Specified by:

getName in interface Cookie

Returns:

String name The name

getValue

public java.lang.String getValue()

Returns the value.

Specified by:

getValue in interface Cookie

Returns:

String value The current value.

setValue

public void setValue(java.lang.String value)

Sets the value

Specified by:

setValue in interface SetCookie

Parameters:

value -

getComment

public java.lang.String getComment()

Returns the comment describing the purpose of this cookie, or null if no such comment has been defined.

Specified by:

getComment in interface Cookie

Returns:

comment

See Also:

setComment(String)

setComment

public void setComment(java.lang.String comment)

If a user agent (web browser) presents this cookie to a user, the cookie's purpose will be described using this comment.

Specified by:

setComment in interface SetCookie

Parameters:

comment -

See Also:

getComment()

getCommentURL

public java.lang.String getCommentURL()

Returns null. Cookies prior to RFC2965 do not set this attribute

Specified by:

getCommentURL in interface Cookie

getExpiryDate

public 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.

Specified by:

getExpiryDate in interface Cookie

Returns:

Expiration Date, or null.

See Also:

setExpiryDate(java.util.Date)

setExpiryDate

public void setExpiryDate(java.util.Date expiryDate)

Sets expiration date.

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.

Specified by:

setExpiryDate in interface SetCookie

Parameters:

expiryDate - the Date after which this cookie is no longer valid.

See Also:

getExpiryDate()

isPersistent

public boolean isPersistent()

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

Specified by:

isPersistent in interface Cookie

Returns:

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

getDomain

public java.lang.String getDomain()

Returns domain attribute of the cookie.

Specified by:

getDomain in interface Cookie

Returns:

the value of the domain attribute

See Also:

setDomain(java.lang.String)

setDomain

public void setDomain(java.lang.String domain)

Sets the domain attribute.

Specified by:

setDomain in interface SetCookie

Parameters:

domain - The value of the domain attribute

See Also:

getDomain()

getPath

public java.lang.String getPath()

Returns the path attribute of the cookie

Specified by:

getPath in interface Cookie

Returns:

The value of the path attribute.

See Also:

setPath(java.lang.String)

setPath

public void setPath(java.lang.String path)

Sets the path attribute.

Specified by:

setPath in interface SetCookie

Parameters:

path - The value of the path attribute

See Also:

getPath()

isSecure

public boolean isSecure()

Description copied from interface: Cookie

Indicates whether this cookie requires a secure connection.

Specified by:

isSecure in interface Cookie

Returns:

true if this cookie should only be sent over secure connections.

See Also:

setSecure(boolean)

setSecure

public void setSecure(boolean secure)

Sets the secure attribute of the cookie.

When true the cookie should only be sent using a secure protocol (https). This should only be set when the cookie's originating server used a secure protocol to set the cookie's value.

Specified by:

setSecure in interface SetCookie

Parameters:

secure - The value of the secure attribute

See Also:

isSecure()

getPorts

public int[] getPorts()

Returns null. Cookies prior to RFC2965 do not set this attribute

Specified by:

getPorts in interface Cookie

getVersion

public int getVersion()

Returns the version of the cookie specification to which this cookie conforms.

Specified by:

getVersion in interface Cookie

Returns:

the version of the cookie.

See Also:

setVersion(int)

setVersion

public void setVersion(int version)

Sets the version of the cookie specification to which this cookie conforms.

Specified by:

setVersion in interface SetCookie

Parameters:

version - the version of the cookie.

See Also:

getVersion()

isExpired

public boolean isExpired(java.util.Date date)

Returns true if this cookie has expired.

Specified by:

isExpired in interface Cookie

Parameters:

date - Current time

Returns:

true if the cookie has expired.

getCreationDate

public java.util.Date getCreationDate()

Since:

4.4

setCreationDate

public void setCreationDate(java.util.Date creationDate)

Since:

4.4

setAttribute

public void setAttribute(java.lang.String name,
                         java.lang.String value)

getAttribute

public java.lang.String getAttribute(java.lang.String name)

Specified by:

getAttribute in interface ClientCookie

containsAttribute

public boolean containsAttribute(java.lang.String name)

Specified by:

containsAttribute in interface ClientCookie

removeAttribute

public boolean removeAttribute(java.lang.String name)

Since:

4.4

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Overrides:

clone in class java.lang.Object

Throws:

java.lang.CloneNotSupportedException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object