NAME

CGI::Session::AUS - Session management for Schema::RDBMS::AUS

SYNOPSIS

use CGI::Session::AUS;
$ENV{AUS_DB_DSN} = 'DBI:Pg:';
$session = new CGI::Session::AUS();
$session->login($user, $password);
$session->param('foo');
etc..

DESCRIPTION

CGI::Session::AUS is a subclass of CGI::Session that provides access to sessions being used under Schema::RDBMS::AUS. It automatically configures the session object to use AUS's driver, and also provides access to the extra information that is stored on a session in the AUS schema.

USAGE

Create a CGI::Session::AUS object the same way as you would create a CGI::Session object; just always make sure the driver is specified as "aus". By default, CGI::Session::AUS will use the Storable serializer to save information to the database. For full details on the CGI::Session interface, see CGI::Session. The extensions that CGI::Session::AUS provides are described below:

METADATA METHODS

The following methods can be used to obtain extra information about the session:

user

Returns a Schema::RDBMS::AUS::User object if this session is logged in, undef otherwise.

When a session is flushed, if there is an associated user, that user is always saved as well. However, a session is only flushed if it has changed. If you have only changed the user and have not changed the session, you will have to save the user yourself!

created

Returns the time that this session was created. The format of this time will depend on your database engine. Future versions may convert this to epoch for you (I'm still debating this).

time_last

Returns the last time that this session was used.

AUTHOR

Tyler "Crackerjack" MacDonald <japh@crackerjack.net>

LICENSE

Copyright 2006 Tyler "Crackerjack" MacDonald <japh@crackerjack.net>

This is free software; You may distribute it under the same terms as perl itself.

SEE ALSO

CGI::Session, Schema::RDBMS::AUS, Schema::RDBMS::AUS::User.