/ 
Apache2-ASP-2.37
River stage zero No dependents
/ Apache2::ASP::ApplicationStateManager

NAME

Apache2::ASP::ApplicationStateManager - The $Application object

SYNOPSIS

# In a handler, ASP script or your GlobalASA:
$Application->{some_gobal_thing} = "A new value";

# ...then, in all requests to the server...
my $val = $Application->{some_global_thing};

# You can also store objects:
$Application->{some_object} = My::Thing->new( ... );

# You can access the current $Application through the context also:
my $app = Apache2::ASP::HTTPContext->current->application;

DESCRIPTION

All $Application objects are instances of one or another subclass of Apache2::ASP::ApplicationStateManager.

Apache2::ASP::ApplicationStateManager is the base class for all ApplicationStateManagers.

The $Application object is implemented as a simple, blessed hash with no special magick going on anywhere. $Application is not a blessed hash and does not depend on special semantics, nor does it expect special treatment.

Storage

By default, when it is time to store the contents of the $Application object for later retrieval, the venerable Storable module is used. The resulting binary blob is stored in the database referred to in the data_connections/application part of the config.

Configuration

The apache2-asp-config.xml configuration file should contain a section like the following:

<?xml version="1.0" ?>
<config>
  ...
  <data_connections>
    ...
    <application>
      <manager>Apache2::ASP::ApplicationStateManager::SQLite</manager>
      <dsn>DBI:mysql:dbname:hostname</dsn>
      <username>sa</username>
      <password>s3cr3t!</password>
    </application>
    ...
  </data_connections>
  ...
</config>

Database Storage

The table that the $Application object is stored in has the following structure:

CREATE TABLE  asp_applications (
  application_id    varchar(100) NOT NULL,
  application_data  blob,
  PRIMARY KEY  (application_id)
) ENGINE=InnoDB DEFAULT CHARSET=latin1;

Different databases will have different ways of spelling that, but the structure is clear.

PUBLIC METHODS

save( )

Stores the object in the database. Returns true.

BUGS

It's possible that some bugs have found their way into this release.

Use RT http://rt.cpan.org/NoAuth/Bugs.html?Dist=Apache2-ASP to submit bug reports.

HOMEPAGE

Please visit the Apache2::ASP homepage at http://www.devstack.com/ to see examples of Apache2::ASP in action.

AUTHOR

John Drago mailto:jdrago_999@yahoo.com

COPYRIGHT AND LICENSE

Copyright 2007 John Drago, All rights reserved.

This software is free software. It may be used and distributed under the same terms as Perl itself.