org.springframework.http

Class ResponseCookie

java.lang.Object

org.springframework.http.HttpCookie

org.springframework.http.ResponseCookie

public final class ResponseCookie
extends HttpCookie

An HttpCookie sub-class with the additional attributes allowed in the "Set-Cookie" response header. To build an instance use the from(java.lang.String, java.lang.String) static method.

Since:

5.0

Author:

Rossen Stoyanchev

See Also:

RFC 6265

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ResponseCookie.ResponseCookieBuilder A builder for a server-defined HttpCookie with attributes.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Optional<java.lang.String>	domain
private boolean	httpOnly
private java.time.Duration	maxAge
private java.util.Optional<java.lang.String>	path
private boolean	secure

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ResponseCookie(java.lang.String name, java.lang.String value, java.time.Duration maxAge, java.lang.String domain, java.lang.String path, boolean secure, boolean httpOnly) Private constructor.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object other)
static ResponseCookie.ResponseCookieBuilder	from(java.lang.String name, java.lang.String value) Factory method to obtain a builder for a server-defined cookie that starts with a name-value pair and may also include attributes.
java.util.Optional<java.lang.String>	getDomain() Return the cookie "Domain" attribute.
java.time.Duration	getMaxAge() Return the cookie "Max-Age" attribute in seconds.
java.util.Optional<java.lang.String>	getPath() Return the cookie "Path" attribute.
int	hashCode()
boolean	isHttpOnly() Return true if the cookie has the "HttpOnly" attribute.
boolean	isSecure() Return true if the cookie has the "Secure" attribute.

Methods inherited from class org.springframework.http.HttpCookie

getName, getValue

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

maxAge

private final java.time.Duration maxAge

domain

private final java.util.Optional<java.lang.String> domain

path

private final java.util.Optional<java.lang.String> path

secure

private final boolean secure

httpOnly

private final boolean httpOnly

Constructor Detail

ResponseCookie

private ResponseCookie(java.lang.String name,
                       java.lang.String value,
                       java.time.Duration maxAge,
                       java.lang.String domain,
                       java.lang.String path,
                       boolean secure,
                       boolean httpOnly)

Private constructor. See from(String, String).

Method Detail

getMaxAge

public java.time.Duration getMaxAge()

Return the cookie "Max-Age" attribute in seconds.

A positive value indicates when the cookie expires relative to the current time. A value of 0 means the cookie should expire immediately. A negative value means no "Max-Age" attribute in which case the cookie is removed when the browser is closed.

getDomain

public java.util.Optional<java.lang.String> getDomain()

Return the cookie "Domain" attribute.

getPath

public java.util.Optional<java.lang.String> getPath()

Return the cookie "Path" attribute.

isSecure

public boolean isSecure()

Return true if the cookie has the "Secure" attribute.

isHttpOnly

public boolean isHttpOnly()

Return true if the cookie has the "HttpOnly" attribute.

See Also:

http://www.owasp.org/index.php/HTTPOnly

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class HttpCookie

hashCode

public int hashCode()

Overrides:

hashCode in class HttpCookie

from

public static ResponseCookie.ResponseCookieBuilder from(java.lang.String name,
                                                        java.lang.String value)

Factory method to obtain a builder for a server-defined cookie that starts with a name-value pair and may also include attributes.

Parameters:

name - the cookie name

value - the cookie value

Returns:

the created cookie instance