Beau E. Cox > MasonX-Request-WithApache2Session-0.04 > MasonX::Request::WithMulti2Session

NAME  top

MasonX::Request::WithMulti2Session - Multiple sub-sessions within one ``parent'' session

SYNOPSIS  top top  NAME
  PerlSetVar  MasonRequestClass  MasonX::Request::WithMulti2Session

DESCRIPTION  top top  SYNOPSIS

MasonX::Request::WithMulti2Session is experimental ( beta ) and should only be used in a test environment.

MasonX::Request::WithMulti2Session is a clone of MasonX::Request::WithMultiSession changed to work under a pure mod_perl2 environment. The external interface is unchanged, see the MasonX::Request::WithMultiSession manpage.

The actual changes I made can be found in the distribution in diff/WithMultiSession.diff ( made with 'diff -Naru' ... ).

A HOWTO for MasonX::Apache2Handler and friends may be found at the Mason-with-mod_perl2 manpage.

The following documentation is from MasonX::Request::WithMultiSession.

This module subclasses MasonX::Request::WithApache2Session in order to allow multiple ``sub-sessions'' to exist within one parent session.

This can be quite useful for a web app where you want to allow the user to open multiple windows, each with a different session, but session ids are stored in a cookie.

Like MasonX::Request::WithApache2Session, sub-sessions are shared between a request and any subrequests it creates.

METHODS  top top  DESCRIPTION

This class has an interface quite similar to that of MasonX::Request::WithApache2Session.

Parameters  top top  METHODS

This module takes two parameters besides those inherited from MasonX::Request::WithApache2Session:

USAGE  top top  METHODS

You will need to manually set the sub-session id argument parameter for each request. The easiest way to do this is to make sure that all URLs contain the sub-session id. This can be done by using a < <%filter >> block in a top-level autohandler (although this won't catch redirects), or by making sure all URLs are generated by a single component/function.

SUPPORT  top top  USAGE

Bug reports and requests for help should be sent <mason@beaucox.com>.

AUTHOR  top top  SUPPORT

Beau E. Cox <mason@beaucox.com> http://beaucox.com.

The real authors (I just made mod_perl2 changes) is Dave Rolsky, <autarch@urth.org>

Version 0.01 as of January, 2004.

SEE ALSO  top top  AUTHOR

My documents, including: HOWTO Run Mason with mod_perl2, MasonX::Apache2Handler, MasonX::Request::WithApache2Session.

Original Mason documents, including: HTML::Mason::ApacheHandler, MasonX::Request::WithApacheSession, MasonX::Request::WithMultiSession.

Also see the Mason documentation at http://masonhq.com/docs/manual/.

Beau E. Cox > MasonX-Request-WithApache2Session-0.04 > MasonX::Request::WithMulti2Session