org.apache.tapestry.services
Interface CookieSource

All Known Implementing Classes:
CookieSourceImpl

public interface CookieSource

Used by other services to obtain cookie values for the current request.

Since:
4.0
Author:
Howard Lewis Ship

Method Summary
 java.lang.String readCookieValue(java.lang.String name)
          Returns the value of the first cookie whose name matches.
 void removeCookieValue(java.lang.String name)
          Removes a previously written cookie, by writing a new cookie with a maxAge of 0.
 void writeCookieValue(java.lang.String name, java.lang.String value)
          Creates or updates a cookie value.
 void writeCookieValue(java.lang.String name, java.lang.String value, int maxAge)
          As with writeCookieValue(String, String) but an explicit maximum age may be set.
 

Method Detail

readCookieValue

public java.lang.String readCookieValue(java.lang.String name)
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 writeCookieValue(String, String)).


writeCookieValue

public void writeCookieValue(java.lang.String name,
                             java.lang.String value)
Creates or updates a cookie value. The value is stored using a max age (in seconds) defined by the symbol org.apache.tapestry.default-cookie-max-age. The factory default for this value is the equivalent of one week.


writeCookieValue

public void writeCookieValue(java.lang.String name,
                             java.lang.String value,
                             int maxAge)
As with writeCookieValue(String, String) but an explicit maximum age may be set.

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

removeCookieValue

public void removeCookieValue(java.lang.String name)
Removes a previously written cookie, by writing a new cookie with a maxAge of 0.