|<B>retrieve($id)B>||Look for a session with the given id, return the session object if found, undef if not.|
|<B>B>create()<B>B>||Create a new session, return the session object.|
|<B>B>flush()<B>B>||Write the session object to the storage engine.|
|<B>B>destroy()<B>B>||Remove the current session object from the storage engine.|
Returns a string with the name of cookie used for storing the session ID.
You should probably not override this; the user can control the cookie name using the session_name setting.
|<B>get_value($key)B>||Retrieves the value associated with the key.|
|<B>set_value($key, B>$value<B>)B>||Stores the value associated with the key.|
The following methods are not supposed to be overloaded, they are generic and should be OK for each session engine.
<B>build_idB> Build a new uniq id. <B>read_session_idB> Reads the dancer.session cookie. <B>write_session_idB> Write the current session id to the dancer.session cookie. <B>is_lazyB> Default is false. If true, session data will not be flushed after every modification and the session engine (or application) will need to ensure that a flush is called before the end of the request.
<B>roleB> A Dancer::Session object represents a session engine and should provide anything needed to manipulate a session, whatever its storing engine is. <B>idB> The session id will be written to a cookie, by default named dancer.session, it is assumed that a client must accept cookies to be able to use a session-aware Dancer webapp. (The cookie name can be change using the session_name config setting.) <B>storage engineB> When the session engine is enabled, a before filter takes care to initialize the appropriate session engine (according to the setting session).
Then, the filter looks for a cookie named dancer.session (or whatever youve set the session_name setting to, if youve used it) in order to retrieve the current session object. If not found, a new session object is created and its id written to the cookie.
Whenever a session call is made within a route handler, the singleton representing the current session object is modified.
A flush is made to the session object after every modification unless the session engine overrides the is_lazy method to return true.
Dancer Core Developers
This software is copyright (c) 2010 by Alexis Sukrieh.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
|perl v5.20.3||DANCER::SESSION::ABSTRACT (3)||2015-06-12|