apache::singleton(3pm) [debian man page]

Apache::Singleton(3pm)					User Contributed Perl Documentation				    Apache::Singleton(3pm)

NAME

       Apache::Singleton - Singleton class for mod_perl

VERSION

       version 0.15

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 http://github.com/mschout/apache-singleton <http://github.com/mschout/apache-singleton> and may be
       cloned from git://github.com/mschout/apache-singleton.git <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.14.2							    2012-04-02						    Apache::Singleton(3pm)

Check Out this Related Man Page

MooseX::Singleton(3)					User Contributed Perl Documentation				      MooseX::Singleton(3)

NAME

       MooseX::Singleton - turn your Moose class into a singleton

VERSION

       version 0.29

SYNOPSIS

	   package MyApp;
	   use MooseX::Singleton;

	   has env => (
	       is      => 'rw',
	       isa     => 'HashRef[Str]',
	       default => sub { \%ENV },
	   );

	   package main;

	   delete MyApp->env->{PATH};
	   my $instance = MyApp->instance;
	   my $same = MyApp->instance;

DESCRIPTION

       A singleton is a class that has only one instance in an application.  "MooseX::Singleton" lets you easily upgrade (or downgrade, as it
       were) your Moose class to a singleton.

       All you should need to do to transform your class is to change "use Moose" to "use MooseX::Singleton". This module uses metaclass roles to
       do its magic, so it should cooperate with most other "MooseX" modules.

METHODS

       A singleton class will have the following additional methods:

   Singleton->instance
       This returns the singleton instance for the given package. This method does not accept any arguments. If the instance does not yet exist,
       it is created with its defaults values. This means that if your singleton requires arguments, calling "instance" will die if the object has
       not already been initialized.

   Singleton->initialize(%args)
       This method can be called only once per class. It explicitly initializes the singleton object with the given arguments.

   Singleton->_clear_instance
       This clears the existing singleton instance for the class. Obviously, this is meant for use only inside the class itself.

   Singleton->new
       This method currently works like a hybrid of "initialize" and "instance". However, calling "new" directly will probably be deprecated in a
       future release. Instead, call "initialize" or "instance" as appropriate.

BUGS

       Please report any bugs or feature requests to "bug-moosex-singleton@rt.cpan.org", or through the web interface at <http://rt.cpan.org>. We
       will be notified, and then you'll automatically be notified of progress on your bug as we make changes.

SOME CODE STOLEN FROM

       Anders Nor Berle <debolaz@gmail.com>

AND PATCHES FROM

       Ricardo SIGNES <rjbs@cpan.org>

AUTHOR

       Shawn M Moore <sartak@gmail.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2011 by Shawn M Moore.

       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.18.2							    2011-12-08						      MooseX::Singleton(3)

Linux and UNIX Man Pages

apache::singleton(3pm) [debian man page]

Check Out this Related Man Page