Package org.forgerock.http.protocol
Class Cookie
- java.lang.Object
-
- org.forgerock.http.protocol.Cookie
-
public class Cookie extends Object
An HTTP cookie. For more information, see the original Netscape specification, RFC 2109 and RFC 2965.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
Cookie.SameSite
Indicates the SameSite value of the cookie.
-
Constructor Summary
Constructors Constructor Description Cookie()
Creates a new uninitialized cookie.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
equals(Object obj)
String
getComment()
Returns the intended use of a cookie.String
getCommentURL()
Returns the URL identifying the intended use of a cookie.Boolean
getDiscard()
Returnstrue
if the user agent should discard the cookie unconditionally when it terminates.String
getDomain()
Returns the domain for which the cookie is valid.Date
getExpires()
Returns the lifetime of the cookie, expressed as the date and time of expiration.Integer
getMaxAge()
Returns the lifetime of the cookie, expressed in seconds.String
getName()
Returns name of the cookie.String
getPath()
Returns the subset of URLs on the origin server to which this cookie applies.List<Integer>
getPort()
Returns the restricted list of port(s) to which a cookie may be returned.Cookie.SameSite
getSameSite()
Returns the value of the SameSite attribute.String
getValue()
Returns the value of the cookie.Integer
getVersion()
Returns the version of the state management mechanism to which this cookie conforms.int
hashCode()
Boolean
isHttpOnly()
Returnstrue
if the user agent should make the cookie inaccessible to client side script.Boolean
isSecure()
Returnstrue
if the user agent should use only secure means to send back this cookie.Cookie
setComment(String comment)
Sets the intended use of a cookie.Cookie
setCommentURL(String commentURL)
Sets the URL identifying the intended use of a cookie.Cookie
setDiscard(Boolean discard)
Sets the value indicating whether the user agent should discard the cookie unconditionally when it terminates.Cookie
setDomain(String domain)
Sets the domain for which the cookie is valid.Cookie
setExpires(Date expires)
Sets the lifetime of the cookie, expressed as the date and time of expiration.Cookie
setHttpOnly(Boolean httpOnly)
Sets the value indicating whether the user agent should make the cookie inaccessible to client side script.Cookie
setMaxAge(Integer maxAge)
Sets the lifetime of the cookie, expressed in seconds.Cookie
setName(String name)
Sets the name of the cookie.Cookie
setPath(String path)
Sets the subset of URLs on the origin server to which this cookie applies.Cookie
setPort(List<Integer> port)
Set the Port attribute as defined per RFC 2965 forSet-Cookie2
.Cookie
setSameSite(Cookie.SameSite sameSite)
Sets the value of the SameSite attribute.Cookie
setSecure(Boolean secure)
Sets the value indicating whether the user agent should use only secure means to send back this cookie.Cookie
setValue(String value)
Sets the value of the cookie.Cookie
setValueWasQuoted(boolean valueWasQuoted)
Sets the valueWasQuoted flag to indicate if the original cookie value was enclosed in "", used when recreating the cookie header.Cookie
setVersion(Integer version)
Sets the version of the state management mechanism to which this cookie conforms.String
toString()
boolean
valueWasQuoted()
Returns true if the cookie value was enclosed in "" when it was parsed, false otherwise.
-
-
-
Method Detail
-
getComment
public String getComment()
Returns the intended use of a cookie.- Returns:
- The intended use of a cookie.
-
getCommentURL
public String getCommentURL()
Returns the URL identifying the intended use of a cookie.- Returns:
- The URL identifying the intended use of a cookie.
-
getDiscard
public Boolean getDiscard()
Returnstrue
if the user agent should discard the cookie unconditionally when it terminates.- Returns:
true
if the user agent should discard the cookie unconditionally when it terminates.
-
getDomain
public String getDomain()
Returns the domain for which the cookie is valid.- Returns:
- The domain for which the cookie is valid.
-
getExpires
public Date getExpires()
Returns the lifetime of the cookie, expressed as the date and time of expiration.- Returns:
- The lifetime of the cookie, expressed as the date and time of expiration.
-
isHttpOnly
public Boolean isHttpOnly()
Returnstrue
if the user agent should make the cookie inaccessible to client side script.- Returns:
true
if the user agent should make the cookie inaccessible to client side script.
-
getMaxAge
public Integer getMaxAge()
Returns the lifetime of the cookie, expressed in seconds.- Returns:
- The lifetime of the cookie, expressed in seconds.
-
getName
public String getName()
Returns name of the cookie.- Returns:
- The name of the cookie.
-
getPath
public String getPath()
Returns the subset of URLs on the origin server to which this cookie applies.- Returns:
- The subset of URLs on the origin server to which this cookie applies.
-
getPort
public List<Integer> getPort()
Returns the restricted list of port(s) to which a cookie may be returned.- Returns:
- The restricted list of port(s) to which a cookie may be returned.
-
isSecure
public Boolean isSecure()
Returnstrue
if the user agent should use only secure means to send back this cookie.- Returns:
true
if the user agent should use only secure means to send back this cookie.
-
getValue
public String getValue()
Returns the value of the cookie.- Returns:
- The value of the cookie.
-
getVersion
public Integer getVersion()
Returns the version of the state management mechanism to which this cookie conforms.- Returns:
- The version of the state management mechanism to which this cookie conforms.
-
valueWasQuoted
public boolean valueWasQuoted()
Returns true if the cookie value was enclosed in "" when it was parsed, false otherwise.- Returns:
- True if the cookie value was enclosed in "" when it was parsed, false otherwise.
-
getSameSite
public Cookie.SameSite getSameSite()
Returns the value of the SameSite attribute.- Returns:
- the SameSite value, or
null
if not set.
-
setComment
public Cookie setComment(String comment)
Sets the intended use of a cookie.- Parameters:
comment
- The intended use of a cookie.- Returns:
- This cookie.
-
setCommentURL
public Cookie setCommentURL(String commentURL)
Sets the URL identifying the intended use of a cookie.- Parameters:
commentURL
- The URL identifying the intended use of a cookie.- Returns:
- This cookie.
-
setDiscard
public Cookie setDiscard(Boolean discard)
Sets the value indicating whether the user agent should discard the cookie unconditionally when it terminates.- Parameters:
discard
-true
if the user agent should discard the cookie unconditionally when it terminates.- Returns:
- This cookie.
-
setDomain
public Cookie setDomain(String domain)
Sets the domain for which the cookie is valid.- Parameters:
domain
- The domain for which the cookie is valid.- Returns:
- This cookie.
-
setExpires
public Cookie setExpires(Date expires)
Sets the lifetime of the cookie, expressed as the date and time of expiration.- Parameters:
expires
- The lifetime of the cookie, expressed as the date and time of expiration.- Returns:
- This cookie.
-
setHttpOnly
public Cookie setHttpOnly(Boolean httpOnly)
Sets the value indicating whether the user agent should make the cookie inaccessible to client side script.- Parameters:
httpOnly
-true
if the user agent should make the cookie inaccessible to client side script.- Returns:
- this;
-
setMaxAge
public Cookie setMaxAge(Integer maxAge)
Sets the lifetime of the cookie, expressed in seconds. Warning: some user agents (including IE/Edge) do not implement Max-Age, so it is recommended you also ensuresetExpires(Date)
is also called appropriately when calling this method.- Parameters:
maxAge
- The lifetime of the cookie, expressed in seconds.- Returns:
- This cookie.
-
setName
public Cookie setName(String name)
Sets the name of the cookie.- Parameters:
name
- The name of the cookie.- Returns:
- This cookie.
-
setPath
public Cookie setPath(String path)
Sets the subset of URLs on the origin server to which this cookie applies.- Parameters:
path
- The subset of URLs on the origin server to which this cookie applies.- Returns:
- This cookie.
-
setPort
public Cookie setPort(List<Integer> port)
Set the Port attribute as defined per RFC 2965 forSet-Cookie2
. The port attribute restricts the port to which a cookie may be returned in a Cookie request header.- Parameters:
port
- The list of port numbers.- Returns:
- This cookie.
-
setSecure
public Cookie setSecure(Boolean secure)
Sets the value indicating whether the user agent should use only secure means to send back this cookie.- Parameters:
secure
-true
if the user agent should use only secure means to send back this cookie.- Returns:
- This cookie.
-
setSameSite
public Cookie setSameSite(Cookie.SameSite sameSite)
Sets the value of the SameSite attribute.- Parameters:
sameSite
- the samesite policy value.- Returns:
- This cookie.
-
setValue
public Cookie setValue(String value)
Sets the value of the cookie.- Parameters:
value
- The value of the cookie.- Returns:
- This cookie.
-
setVersion
public Cookie setVersion(Integer version)
Sets the version of the state management mechanism to which this cookie conforms.- Parameters:
version
- The version of the state management mechanism to which this cookie conforms.- Returns:
- This cookie.
-
setValueWasQuoted
public Cookie setValueWasQuoted(boolean valueWasQuoted)
Sets the valueWasQuoted flag to indicate if the original cookie value was enclosed in "", used when recreating the cookie header.- Parameters:
valueWasQuoted
- Set to true if the original cookie value was enclosed in quotes when the cookie was parsed, used when recreating the cookie header.- Returns:
- This cookie.
-
-