Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Apache::Singleton(3)  User Contributed Perl Documentation Apache::Singleton(3)

NAME
       Apache::Singleton - Singleton class for mod_perl

VERSION
       version 0.17

SYNOPSIS
	 package Printer;
	 # default:
	 #   Request for mod_perl env
	 #   Process for non-mod_perl env
	 use base qw(Apache::Singleton);

	 package Printer::PerRequest;
	 use base qw(Apache::Singleton::Request);

	 package Printer::PerProcess;
	 use base qw(Apache::Singleton::Process);

DESCRIPTION
       Apache::Singleton works the same	as Class::Singleton, but with various
       object lifetime (scope).	See Class::Singleton first.

OBJECT LIFETIME
       By inheriting one of the	following sublasses of Apache::Singleton, you
       can change the scope of your object.

       Request
	     use base qw(Apache::Singleton::Request);

	   One instance	for one	request. Apache::Singleton will	remove
	   instance on each request. Implemented using mod_perl	"pnotes" API.
	   In mod_perl environment (where $ENV{MOD_PERL} is defined), this is
	   the default scope, so inheriting from Apache::Singleton would do
	   the same effect.

	   NOTE: You need "PerlOptions +GlobalRequest" in your apache
	   configuration in order to use the Request lifetime method.

       Process
	     use base qw(Apache::Singleton::Process);

	   One instance	for one	httpd process. Implemented using package
	   global. In non-mod_perl environment,	this is	the default scope, and
	   you may notice this is the same beaviour with Class::Singleton ;)

	   So you can use this module safely under non-mod_perl	environment.

CREDITS
       Original	idea by	Matt Sergeant <matt@sergeant.org> and Perrin Harkins
       <perrin@elem.com>.

       Initial implementation and versions 0.01	to 0.07	by Tatsuhiko Miyagawa
       <miyagawa@bulknews.net>.

SEE ALSO
       Apache::Singleton::Request, Apache::Singleton::Process,
       Class::Singleton

SOURCE
       The development version is on github at
       <https://github.com/mschout/apache-singleton> and may be	cloned from
       <git://github.com/mschout/apache-singleton.git>

BUGS
       Please report any bugs or feature requests to
       bug-apache-singleton@rt.cpan.org	or through the web interface at:
	http://rt.cpan.org/Public/Dist/Display.html?Name=Apache-Singleton

AUTHOR
       Michael Schout <mschout@cpan.org>

COPYRIGHT AND LICENSE
       This software is	copyright (c) 2009 by Michael Schout.

       This is free software; you can redistribute it and/or modify it under
       the same	terms as the Perl 5 programming	language system	itself.

perl v5.32.1			  2017-08-02		  Apache::Singleton(3)

NAME | VERSION | SYNOPSIS | DESCRIPTION | OBJECT LIFETIME | CREDITS | SEE ALSO | SOURCE | BUGS | AUTHOR | COPYRIGHT AND LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Apache::Singleton&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help