Apache::Session::Store::Oracle - Store persistent data in a Oracle database

Author

       This modules was written by Jeffrey William Baker <jwbaker@acm.org>

       A fix for the commit policy was contributed by Michael Schout <mschout@gkg.net>

Configuration

       The module must know what datasource, username, and password to use when connecting to the database.
       These values can be set using the options hash (see Apache::Session documentation).  The options are
       DataSource, UserName, and Password.

       Example:

        tie %hash, 'Apache::Session::Oracle', $id, {
            DataSource => 'dbi:Oracle:database',
            UserName   => 'database_user',
            Password   => 'K00l'
        };

       Instead, you may pass in an already-opened DBI handle to your database.

        tie %hash, 'Apache::Session::Oracle', $id, {
            Handle => $dbh
        };

       The last option is LongReadLen, which specifies the maximum size of the session object.  If not supplied,
       the default maximum size is 8 KB.

Description

       Apache::Session::Store::Oracle fulfills the storage interface of Apache::Session. Session data is stored
       in a Oracle database.

Name

       Apache::Session::Store::Oracle - Store persistent data in a Oracle database

Schema

       To use this module, you will need at least these columns in a table called 'sessions':

        id varchar2(32)     # or however long your session IDs are.
        a_session long

       To create this schema, you can execute this command using the sqlplus program:

        CREATE TABLE sessions (
           id varchar2(32) not null primary key,
           a_session long
        );

       If you use some other command, ensure that there is a unique index on the table's id column.

Synopsis

        use Apache::Session::Store::Oracle;

        my $store = new Apache::Session::Store::Oracle;

        $store->insert($ref);
        $store->update($ref);
        $store->materialize($ref);
        $store->remove($ref);