AutoRunmode::FileDelegUser3Contributed Perl DocumeAutoRunmode::FileDelegate(3)NAMECGI::Application::Plugin::AutoRunmode::FileDelegate - delegate CGI::App
run modes to a directory of files
SYNOPSIS
# in file runmodes/my_run_mode.pl
sub {
my ($app, $delegate) = @_;
# do something here
};
# in file runmodes/another_run_mode.pl
sub {
# do something else
};
package MyApp;
use base 'CGI::Application';
use CGI::Application::Plugin::AutoRunmode
qw [ cgiapp_prerun];
use CGI::Application::Plugin::AutoRunmode::FileDelegate();
sub setup{
my ($self) = @_;
my $delegate = new CGI::Application::Plugin::AutoRunmode::FileDelegate
('/path/to/runmodes')
$self->param('::Plugin::AutoRunmode::delegate' => $delegate);
}
# you now have two run modes
# "my_run_mode" and "another_run_mode"
DESCRIPTION
Using this module, you can place the definition of your run modes for a
CGI::Application into directory of files (as opposed to into a Perl
module).
Each run mode is contained in its own file, named foo.pl for a run mode
called foo. The run modes are lazily evaluated (on demand) for each
request. In the case of mod_perl this means you can update them
without restarting your web server. In the case of plain CGI it means a
reduced startup cost if you have many run modes (because only the one
that you need gets parsed and loaded, along with dependent modules).
Using more than one directory with runmodes
You can pass multiple directory paths to the constructor for the
delegate:
my $delegate = new CGI::Application::Plugin::AutoRunmode::FileDelegate
('/path/to/runmodes', '/path/to/more_runmodes')
In this case, they will be searched in order. The first matching file
becomes the run mode. In the case of errors with that file, the module
will croak (and not continue the search in the remaining directories).
BUGS
With all the namespace nesting going on the name of this module has
reached an intolerable Java-esque length.
SEE ALSO
If you like the idea of moving everything outside of Perl modules into
seperate files, you should also have a look at
CGI::Application::Plugin::TemplateRunner, which does a similar thing
for HTML templates and the Perl code needed to provide them with data.
AUTHOR
Thilo Planz, <thilo@cpan.org>
COPYRIGHT AND LICENSE
Copyright 2005 by Thilo Planz
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.14.1 2011-02-18 AutoRunmode::FileDelegate(3)
