NAME

Contentment::Session - Session management for Contentment

DESCRIPTION

This is a session management module specifically designed for Contentment.

CONTEXT

This class adds the following context methods:

$session_data = $context->session

This method returns a reference to a hash containing the session data.

$session_id = $context->session_id

This method returns a reference to the session ID.

HOOK HANDLERS

This class defines the following hook handlers:

Contentment::install

Deploys the session class into the database.

Contentment::Session::open_session

This handles the "Contentment::Request::begin" hook. It associates session information with the context and calles the "Contentment::Session::begin" hook.

Contentment::Session::save_cookie

This handles the "Contentment::Response::begin" hook and is responsible for making sure a cookie gets set on the client.

Contentment::Session::close_session

This method handles the "Contentment::Request::end" hook. It calls the "Contentment::Session::end" hook and then serializes any changes to the session data.

HOOKS

This class defines and uses the following hooks:

Contentment::Session::begin

This hook is called as soon as the session information has been added to the context. Handlers of this hook can expect a single argument: the current context object.

This hook can be used to perform additional loading or other session data modifications.

Contentment::Session::end

This hook is called immediately before the session information is saved. Handlers of this hook can expect a single argument: the current context object.

This hook can be used to prepare data for serialization, sanitize session data, or perform other session data modifications prior to saving.

SEE ALSO

Contentment::Context

AUTHOR

Andrew Sterling Hanenkamp, <hanenkamp@users.sourceforge.net>

COPYRIGHT AND LICENSE

Copyright 2005 Andrew Sterling Hanenkamp. All Rights Reserved.

Contentment is distributed and licensed under the same terms as Perl itself.