Package org.apache.tapestry5.internal.services

Class CookiesImpl

org.apache.tapestry5.internal.services.CookiesImpl

All Implemented Interfaces:

Cookies

public class CookiesImpl
extends 
implements Cookies

Implementation of the Cookies service interface.

Constructor Summary

Constructors

Constructor	Description
CookiesImpl(Request request, CookieSource cookieSource, CookieSink cookieSink, contextPath, long defaultMaxAge)

Method Summary

Modifier and Type	Method	Description
CookieBuilder	name, value)	Returns a .
	name)	Returns the value of the first cookie whose name matches.
void	name)	Removes a previously written cookie, by writing a new cookie with a maxAge of 0.
void	name, value)	Creates or updates a cookie value.
void	name, value, int maxAge)	As with Cookies.writeCookieValue(String, String) but an explicit maximum age may be set.
void	name, value, path)	As with Cookies.writeCookieValue(String, String) but an explicit path may be set.
void	name, value, path, domain)	As with Cookies.writeCookieValue(String, String, String) but an explicit domain and path may be set.
void	name, value, domain)	As with Cookies.writeCookieValue(String, String) but an explicit domain may be set.
void	name, value, domain, int maxAge)	As with Cookies.writeCookieValue(String, String) but an explicit domain and maximum age may be set.

Methods inherited from class java.lang.

, , , , , , , , , ,

Constructor Detail

CookiesImpl

public CookiesImpl(Request request,
                   CookieSource cookieSource,
                   CookieSink cookieSink,
                   @Symbol("tapestry.context-path")
                    contextPath,
                   @Symbol("tapestry.default-cookie-max-age") @IntermediateType(TimeInterval.class)
                   long defaultMaxAge)

Parameters:

request -

cookieSource -

cookieSink -

contextPath -

defaultMaxAge - default cookie expiration time in milliseconds

Method Detail

readCookieValue

public   name)

Description copied from interface: Cookies

Returns the value of the first cookie whose name matches. Returns null if no such cookie exists. This method is only aware of cookies that are part of the incoming request; it does not know about additional cookies added since then (via Cookies.writeCookieValue(String, String)).

Specified by:

readCookieValue in interface Cookies

writeCookieValue

public void  name,
                              value)

Description copied from interface: Cookies

Creates or updates a cookie value. The value is stored using a max age (in seconds) defined by the symbol org.apache.tapestry5.default-cookie-max-age. The factory default for this value is the equivalent of one week.

Specified by:

writeCookieValue in interface Cookies

writeCookieValue

public void  name,
                              value,
                             int maxAge)

Description copied from interface: Cookies

As with Cookies.writeCookieValue(String, String) but an explicit maximum age may be set.

Specified by:

writeCookieValue in interface Cookies

Parameters:

name - the name of the cookie

value - the value to be stored in the cookie

maxAge - the maximum age, in seconds, to store the cookie

writeCookieValue

public void  name,
                              value,
                              path)

Description copied from interface: Cookies

As with Cookies.writeCookieValue(String, String) but an explicit path may be set.

Specified by:

writeCookieValue in interface Cookies

writeDomainCookieValue

public void  name,
                                    value,
                                    domain)

Description copied from interface: Cookies

As with Cookies.writeCookieValue(String, String) but an explicit domain may be set.

Specified by:

writeDomainCookieValue in interface Cookies

writeDomainCookieValue

public void  name,
                                    value,
                                    domain,
                                   int maxAge)

Description copied from interface: Cookies

As with Cookies.writeCookieValue(String, String) but an explicit domain and maximum age may be set.

Specified by:

writeDomainCookieValue in interface Cookies

writeCookieValue

public void  name,
                              value,
                              path,
                              domain)

Description copied from interface: Cookies

As with Cookies.writeCookieValue(String, String, String) but an explicit domain and path may be set.

Specified by:

writeCookieValue in interface Cookies

removeCookieValue

public void  name)

Description copied from interface: Cookies

Removes a previously written cookie, by writing a new cookie with a maxAge of 0. Only deletes a cookie with the default path and no domain set. For deleting other cookies use CookieBuilder.delete(). An instance of the CookieBuilder API can be obtained with Cookies.getBuilder(String, String).

Specified by:

removeCookieValue in interface Cookies

getBuilder

public  name,
                                 value)

Description copied from interface: Cookies

Returns a . The default implementation creates a cookie who's value is stored using a max age (in seconds) defined by the symbol org.apache.tapestry5.default-cookie-max-age. The factory default for this value is the equivalent of one week. The default path is the context path (see Request.getContextPath()) of the current Request, the default secure setting is to send the cookie over secure channels only, if the original request was secure (see Request.isSecure()

Specified by:

getBuilder in interface Cookies

Parameters:

name - the name of the cookie

value - the value of the cookie

Returns:

a CookieBuilder for setting additional cookie attributes and writing it out