play.core.cookie.encoding

Class ServerCookieEncoder

java.lang.Object

play.core.cookie.encoding.ServerCookieEncoder

public final class ServerCookieEncoder
extends java.lang.Object

A RFC6265 compliant cookie encoder to be used server side, so some fields are sent (Version is typically ignored).

As Netty's Cookie merges Expires and MaxAge into one single field, only Max-Age field is sent.

Note that multiple cookies are supposed to be sent at once in a single "Set-Cookie" header.

See Also:

ServerCookieDecoder

Field Summary

Fields

Modifier and Type	Field and Description
static ServerCookieEncoder	LAX Lax instance that doesn't validate name and value
static ServerCookieEncoder	STRICT Strict encoder that validates that name and value chars are in the valid scope defined in RFC6265

Method Summary

Modifier and Type	Method and Description
java.util.List<java.lang.String>	encode(java.util.Collection<? extends Cookie> cookies) Batch encodes cookies into Set-Cookie header values.
java.util.List<java.lang.String>	encode(Cookie... cookies) Batch encodes cookies into Set-Cookie header values.
java.lang.String	encode(Cookie cookie) Encodes the specified cookie into a Set-Cookie header value.
java.util.List<java.lang.String>	encode(java.lang.Iterable<? extends Cookie> cookies) Batch encodes cookies into Set-Cookie header values.
java.lang.String	encode(java.lang.String name, java.lang.String value) Encodes the specified cookie name-value pair into a Set-Cookie header value.
protected void	validateCookie(java.lang.String name, java.lang.String value)

Methods inherited from class java.lang.Object

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

Field Detail

STRICT

public static final ServerCookieEncoder STRICT

Strict encoder that validates that name and value chars are in the valid scope defined in RFC6265

LAX

public static final ServerCookieEncoder LAX

Lax instance that doesn't validate name and value

Method Detail

encode

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

Encodes the specified cookie name-value pair into a Set-Cookie header value.

Parameters:

name - the cookie name

value - the cookie value

Returns:

a single Set-Cookie header value

encode

public java.lang.String encode(Cookie cookie)

Encodes the specified cookie into a Set-Cookie header value.

Parameters:

cookie - the cookie

Returns:

a single Set-Cookie header value

encode

public java.util.List<java.lang.String> encode(Cookie... cookies)

Batch encodes cookies into Set-Cookie header values.

Parameters:

cookies - a bunch of cookies

Returns:

the corresponding bunch of Set-Cookie headers

encode

public java.util.List<java.lang.String> encode(java.util.Collection<? extends Cookie> cookies)

Batch encodes cookies into Set-Cookie header values.

Parameters:

cookies - a bunch of cookies

Returns:

the corresponding bunch of Set-Cookie headers

encode

public java.util.List<java.lang.String> encode(java.lang.Iterable<? extends Cookie> cookies)

Batch encodes cookies into Set-Cookie header values.

Parameters:

cookies - a bunch of cookies

Returns:

the corresponding bunch of Set-Cookie headers

validateCookie

protected void validateCookie(java.lang.String name,
                              java.lang.String value)