play.mvc

Class Http.Cookie

java.lang.Object

play.mvc.Http.Cookie

Enclosing class:

Http

public static class Http.Cookie
extends java.lang.Object

HTTP Cookie

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Http.Cookie.SameSite The cookie SameSite attribute

Constructor Summary

Constructors

Constructor and Description
Cookie(java.lang.String name, java.lang.String value, java.lang.Integer maxAge, java.lang.String path, java.lang.String domain, boolean secure, boolean httpOnly) Deprecated. as of 2.6.0. Use builder(java.lang.String, java.lang.String).
Cookie(java.lang.String name, java.lang.String value, java.lang.Integer maxAge, java.lang.String path, java.lang.String domain, boolean secure, boolean httpOnly, Http.Cookie.SameSite sameSite) Construct a new cookie.

Method Summary

Modifier and Type	Method and Description
static Http.CookieBuilder	builder(java.lang.String name, java.lang.String value)
java.lang.String	domain()
boolean	httpOnly()
java.lang.Integer	maxAge()
java.lang.String	name()
java.lang.String	path()
java.util.Optional<Http.Cookie.SameSite>	sameSite()
boolean	secure()
java.lang.String	value()

Methods inherited from class java.lang.Object

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

Constructor Detail

Cookie

public Cookie(java.lang.String name,
              java.lang.String value,
              java.lang.Integer maxAge,
              java.lang.String path,
              java.lang.String domain,
              boolean secure,
              boolean httpOnly,
              Http.Cookie.SameSite sameSite)

Construct a new cookie. Prefer builder(java.lang.String, java.lang.String) for creating new cookies in your application.

Parameters:

name - Cookie name, must not be null

value - Cookie value

maxAge - Cookie duration in seconds (null for a transient cookie, 0 or less for one that expires now)

path - Cookie path

domain - Cookie domain

secure - Whether the cookie is secured (for HTTPS requests)

httpOnly - Whether the cookie is HTTP only (i.e. not accessible from client-side JavaScript code)

sameSite - the SameSite attribute for this cookie (for CSRF protection).

Cookie

@Deprecated
public Cookie(java.lang.String name,
                          java.lang.String value,
                          java.lang.Integer maxAge,
                          java.lang.String path,
                          java.lang.String domain,
                          boolean secure,
                          boolean httpOnly)

Deprecated. as of 2.6.0. Use builder(java.lang.String, java.lang.String).

Parameters:

name - Cookie name, must not be null

value - Cookie value

maxAge - Cookie duration in seconds (null for a transient cookie, 0 or less for one that expires now)

path - Cookie path

domain - Cookie domain

secure - Whether the cookie is secured (for HTTPS requests)

httpOnly - Whether the cookie is HTTP only (i.e. not accessible from client-side JavaScript code)

Method Detail

builder

public static Http.CookieBuilder builder(java.lang.String name,
                                         java.lang.String value)

Parameters:

name - the cookie builder name

value - the cookie builder value

Returns:

the cookie builder with the specified name and value

name

public java.lang.String name()

Returns:

the cookie name

value

public java.lang.String value()

Returns:

the cookie value

maxAge

public java.lang.Integer maxAge()

Returns:

the cookie expiration date in seconds, null for a transient cookie, a value less than zero for a cookie that expires now

path

public java.lang.String path()

Returns:

the cookie path

domain

public java.lang.String domain()

Returns:

the cookie domain, or null if not defined

secure

public boolean secure()

Returns:

wether the cookie is secured, sent only for HTTPS requests

httpOnly

public boolean httpOnly()

Returns:

wether the cookie is HTTP only, i.e. not accessible from client-side JavaScript code

sameSite

public java.util.Optional<Http.Cookie.SameSite> sameSite()

Returns:

the SameSite attribute for this cookie