NAME

       Data::Session::ID::UUID34 - A persistent session manager

Synopsis

       See Data::Session for details.

Description

       Data::Session::ID::UUID34 allows Data::Session to generate session ids using Data::UUID.

       To use this module do this:

       o Specify an id generator of type UUID34, as Data::Session -> new(type => '... id:UUID34
       ...')

Case-sensitive Options

       See "Case-sensitive Options" in Data::Session for important information.

Method: new()

       Creates a new object of type Data::Session::ID::UUID34.

       "new()" takes a hash of key/value pairs, some of which might mandatory. Further, some
       combinations might be mandatory.

       The keys are listed here in alphabetical order.

       They are lower-case because they are (also) method names, meaning they can be called to
       set or get the value at any time.

       o verbose => $integer
           Print to STDERR more or less information.

           Typical values are 0, 1 and 2.

           This key is normally passed in as Data::Session -> new(verbose => $integer).

           This key is optional.

Method: generate()

       Generates the next session id, or dies if it can't.

       The algorithm is Data::UUID -> new -> create_hex.

       Returns the new id.

       Note: Data::UUID returns '0x' as the prefix of the 34-byte hex digest. You have been
       warned.

Method: id_length()

       Returns 34 because that's the number of bytes in a UUID34 digest.

       This can be used to generate the SQL to create the sessions table.

       See scripts/digest.pl.

Support

       Log a bug on RT: <https://rt.cpan.org/Public/Dist/Display.html?Name=Data-Session>.

Author

       Data::Session was written by Ron Savage <ron@savage.net.au> in 2010.

       Home page: <http://savage.net.au/index.html>.

Copyright

       Australian copyright (c) 2010, Ron Savage.

               All Programs of mine are 'OSI Certified Open Source Software';
               you can redistribute them and/or modify them under the terms of
               The Artistic License, a copy of which is available at:
               http://www.opensource.org/licenses/index.html