The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Apache2::ASP::GlobalASA - Base GlobalASA class

SYNOPSIS

In your apache2-asp-config.xml:

  <?xml version="1.0" ?>
  <config>
    ...
    <web>
      ...
      <application_name>MyApp</application_name>
      ...
    </web>
    ...
  </config>

Then, in htdocs/GlobalASA.pm:

  package MyApp::GlobalASA;
  
  use strict;
  use warnings;
  use base 'Apache2::ASP::GlobalASA';
  use vars __PACKAGE__->VARS;
  
  # Called when the apache httpd process first initializes, 
  # before Application_OnStart is called
  sub Server_OnStart
  {
    warn "Server_OnStart()";
  }# end Server_OnStart()
  
  # Called the first time an application is actually fired up:
  sub Application_OnStart
  {
    warn "Application_OnStart()";
  }# end Application_OnStart()
  
  # Called on the first request received from a client:
  sub Session_OnStart
  {
    warn "Session_OnStart()";
  }# end Session_OnStart()
  
  # Called *after* RequestFilters, but before the ASP script (or handler)
  sub Script_OnStart
  {
    warn "Script_OnStart()";
  }# end Session_OnStart()
  
  # Called after the ASP script or handler, but before any PerlCleanupHandlers
  sub Script_OnEnd
  {
    warn "Script_OnEnd()";
  }# end Script_OnEnd()
  
  1;# return true:

DESCRIPTION

In "Classic ASP" the Global.ASA provided a means of hooking into the Application_OnStart and Session_OnStart events.

In Apache2::ASP more events are provided, taking the same idea a little further.

EVENTS

Server_OnStart

Called once per Apache httpd process, before Application_OnStart.

Application_OnStart

Called once in the lifetime of an Application.

Session_OnStart

Called once at the beginning of a browser session.

This is a good place to initialize any session variables.

Script_OnStart

Called after any/all Apache2::ASP::RequestFilters have finished.

This event won't get used much anymore, since we have Apache2::ASP::RequestFilters now, but we keep it around just in case you want it for something quick.

Script_OnEnd

Called after the script has ended, before any PerlCleanupHandlers are called.

NOTE: This event is not raised if an error is thrown while executing the request.

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 <jdrago_999@yahoo.com>

COPYRIGHT

Copyright 2008 John Drago. All rights reserved.

LICENSE

This software is Free software and is licensed under the same terms as perl itself.