|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.microsoft.tfs.core.httpclient.NameValuePair
com.microsoft.tfs.core.httpclient.Cookie
public class Cookie
HTTP "magic-cookie" represents a piece of state information that the HTTP agent and the target server can exchange to maintain a session.
Constructor Summary | |
---|---|
Cookie()
Default constructor. |
|
Cookie(java.lang.String domain,
java.lang.String name,
java.lang.String value)
Creates a cookie with the given name, value and domain attribute. |
|
Cookie(java.lang.String domain,
java.lang.String name,
java.lang.String value,
java.lang.String path,
java.util.Date expires,
boolean secure)
Creates a cookie with the given name, value, domain attribute, path attribute, expiration attribute, and secure attribute |
|
Cookie(java.lang.String domain,
java.lang.String name,
java.lang.String value,
java.lang.String path,
int maxAge,
boolean secure)
Creates a cookie with the given name, value, domain attribute, path attribute, maximum age attribute, and secure attribute |
Method Summary | |
---|---|
int |
compare(Cookie c1,
Cookie c2)
Compares two cookies to determine order for cookie header. |
boolean |
equals(java.lang.Object obj)
Two cookies are equal if the name, path and domain match. |
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 |
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 |
getPath()
Returns the path attribute of the cookie |
boolean |
getSecure()
|
int |
getVersion()
Returns the version of the cookie specification to which this cookie conforms. |
int |
hashCode()
Returns a hash code in keeping with the Object.hashCode() general
hashCode contract. |
boolean |
isDomainAttributeSpecified()
Returns true if cookie's domain was set via a domain attribute in the Set-Cookie header. |
boolean |
isExpired()
Returns true if this cookie has expired. |
boolean |
isExpired(java.util.Date now)
Returns true if this cookie has expired according to the time passed in. |
boolean |
isPathAttributeSpecified()
Returns true if cookie's path was set via a path attribute in the Set-Cookie header. |
boolean |
isPersistent()
Returns false if the cookie should be discarded at the end of the "session"; true otherwise. |
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 |
setDomain(java.lang.String domain)
Sets the domain attribute. |
void |
setDomainAttributeSpecified(boolean value)
Indicates whether the cookie had a domain specified in a domain attribute of the Set-Cookie header. |
void |
setExpiryDate(java.util.Date expiryDate)
Sets expiration date. |
void |
setPath(java.lang.String path)
Sets the path attribute. |
void |
setPathAttributeSpecified(boolean value)
Indicates whether the cookie had a path specified in a path attribute of the Set-Cookie header. |
void |
setSecure(boolean secure)
Sets the secure attribute of the cookie. |
void |
setVersion(int version)
Sets the version of the cookie specification to which this cookie conforms. |
java.lang.String |
toExternalForm()
Return a textual representation of the cookie. |
java.lang.String |
toString()
Return a textual representation of the cookie. |
Methods inherited from class com.microsoft.tfs.core.httpclient.NameValuePair |
---|
getName, getValue, setName, setValue |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public Cookie()
public Cookie(java.lang.String domain, java.lang.String name, java.lang.String value)
name
- the cookie namevalue
- the cookie valuedomain
- the domain this cookie can be sent topublic Cookie(java.lang.String domain, java.lang.String name, java.lang.String value, java.lang.String path, java.util.Date expires, boolean secure)
name
- the cookie namevalue
- the cookie valuedomain
- the domain this cookie can be sent topath
- the path prefix for which this cookie can be sentexpires
- the Date
at which this cookie expires, or null if
the cookie expires at the end of the sessionsecure
- if true this cookie can only be sent over secure connections
java.lang.IllegalArgumentException
- If cookie name is null or blank, cookie name contains a blank, or
cookie name starts with character $public Cookie(java.lang.String domain, java.lang.String name, java.lang.String value, java.lang.String path, int maxAge, boolean secure)
name
- the cookie namevalue
- the cookie valuedomain
- the domain this cookie can be sent topath
- the path prefix for which this cookie can be sentmaxAge
- the number of seconds for which this cookie is valid. maxAge is
expected to be a non-negative number. -1 signifies that
the cookie should never expire.secure
- if true this cookie can only be sent over secure
connectionsMethod Detail |
---|
public java.lang.String getComment()
setComment(String)
public void setComment(java.lang.String comment)
comment
- getComment()
public java.util.Date getExpiryDate()
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.
Date
, or null.setExpiryDate(java.util.Date)
public void setExpiryDate(java.util.Date expiryDate)
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.
expiryDate
- the Date
after which this cookie is no longer valid.getExpiryDate()
public boolean isPersistent()
public java.lang.String getDomain()
setDomain(java.lang.String)
public void setDomain(java.lang.String domain)
domain
- The value of the domain attributegetDomain()
public java.lang.String getPath()
setPath(java.lang.String)
public void setPath(java.lang.String path)
path
- The value of the path attributegetPath()
public boolean getSecure()
true
if this cookie should only be sent over secure
connections.setSecure(boolean)
public void setSecure(boolean secure)
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.
secure
- The value of the secure attributegetSecure()
public int getVersion()
setVersion(int)
public void setVersion(int version)
version
- the version of the cookie.getVersion()
public boolean isExpired()
public boolean isExpired(java.util.Date now)
now
- The current time.
public void setPathAttributeSpecified(boolean value)
value
- true if the cookie's path was explicitly set,
false otherwise.isPathAttributeSpecified()
public boolean isPathAttributeSpecified()
setPathAttributeSpecified(boolean)
public void setDomainAttributeSpecified(boolean value)
value
- true if the cookie's domain was explicitly set,
false otherwise.isDomainAttributeSpecified()
public boolean isDomainAttributeSpecified()
setDomainAttributeSpecified(boolean)
public int hashCode()
Object.hashCode()
general
hashCode contract.
hashCode
in class NameValuePair
public boolean equals(java.lang.Object obj)
equals
in interface java.util.Comparator<Cookie>
equals
in class NameValuePair
obj
- The object to compare against.
public java.lang.String toExternalForm()
public int compare(Cookie c1, Cookie c2)
Compares two cookies to determine order for cookie header.
Most specific should be first.
This method is implemented so a cookie can be used as a comparator for a SortedSet of cookies. Specifically it's used above in the createCookieHeader method.
compare
in interface java.util.Comparator<Cookie>
o1
- The first object to be comparedo2
- The second object to be compared
Comparator.compare(Object,Object)
public java.lang.String toString()
toString
in class NameValuePair
toExternalForm()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |