MAN page from Other HTML-Embperl-1.3.29_1.3.6-3sls.i586.rpm

Session

Section: User Contributed Perl Documentation (3)
Updated: 2001-11-13
Index

NAME

HTML::Embperl::Session

DESCRIPTION

An adaptation of Apache::Session to work with HTML::Embperl

SYNOPSIS

Addtional Attributes for TIE

lazy: By Specifing this attribute, you tell Apache::Session to not do anyaccess to the object store, until the first read or write access tothe tied hash. Otherwise the tie function will make sure the hashexist or creates a new one.
create_unknown: Setting this to one causes Apache::Session to create a new sessionwith the given id (or a new id, depending on "recreate_id")when the specified session id does not exists. Otherwise it will die.
recreate_id: Setting this to one causes Apache::Session to create a new session idwhen the specified session id does not exists.
object_store: Specify the class for the object store. (The Apache::Session:: prefix isoptional) Only for Apache::Session 1.00.
lock_manager: Specify the class for the lock manager. (The Apache::Session:: prefix isoptional) Only for Apache::Session 1.00.
Store: Specify the class for the object store. (The Apache::Session::Store prefix isoptional) Only for Apache::Session 1.5x.
Lock: Specify the class for the lock manager. (The Apache::Session::Lock prefix isoptional) Only for Apache::Session 1.5x.
Generate: Specify the class for the id generator. (The Apache::Session::Generate prefix isoptional) Only for Apache::Session 1.5x.
Serialize: Specify the class for the data serializer. (The Apache::Session::Serialize prefix isoptional) Only for Apache::Session 1.5x.

Example using attrubtes to specfiy store and object classes instead ofa derived class:

 use HTML::Embperl::Session;

 tie %session, 'HTML::Embperl::Session', undef,    {     object_store => 'DBIStore',    lock_manager => 'SysVSemaphoreLocker',    DataSource => 'dbi:Oracle:db'     };

NOTE: HTML::Embperl::Session will require the nessecary additional perl modules for you.

Addtional Methods

setid: Set the session id for futher accesses.
getid: Get the session id. The difference to using $session{_session_id} is,that in lazy mode, getid will not create a new session id, if itdoesn't exists.
cleanup: Writes any pending data, releases all locks and deletes all data from memory.

AUTHORS

Gerald Richter <richterAATTdev.ecos.de> is the current maintainer.

This class was written by Jeffrey Baker (jeffreyAATTkathyandjeffrey.net)but it is taken wholesale from a patch that Gerald Richter(richterAATTecos.de) sent me against Apache::Session.

This document was created byman2html,using the manual pages.