MasonX::Resolver::ExtendedCompRoot.3pm

Langue: en

Version: 2004-02-18 (mandriva - 22/10/07)

Section: 3 (Bibliothèques de fonctions)

NAME

MasonX::Resolver::ExtendedCompRoot - Extend functionality of "HTML::Mason::Resolver::File" to allow specific comp_roots to be called

SYNOPSIS

In your httpd.conf file:
   PerlSetVar   MasonResolverClass   MasonX::Resolver::ExtendedCompRoot
 
 

Or when creating an ApacheHandler object:

   my $ah =
       HTML::Mason::ApacheHandler->new
           ( 
            resolver_class => 'MasonX::Resolver::ExtendedCompRoot',
           );
 
 

Or when using Mason in standalone mode:

   my $resolver = MasonX::Resolver::ExtendedCompRoot->new( comp_root => '/var/www/mason' );
 
 
   my $info = $resolver->get_info('/some/comp.html');
 
 

DESCRIPTION

This subclass of HTML::Mason::Resolver::File, the basic default Mason resolver, enables calls to specific component roots to be made, eg.
   <& comp_root_name=>path/to/comp &>
 
 

It is dependent on "MasonX::Request::ExtendedCompRoot" - otherwise its behaviour is identical to that of "HTML::Mason::Resolver::File".

USAGE

To use this module you need to tell Mason to use this class for its resolver and "MasonX::Request::ExtendedCompRoot" for requests. This can be done in two ways. If you are configuring Mason via your httpd.conf file, simply add this:
   PerlSetVar  MasonRequestClass    MasonX::Request::ExtendedCompRoot
   PerlSetVar  MasonResolverClass   MasonX::Resolver::ExtendedCompRoot
 
 

If you are using a handler.pl file, simply add this parameter to the parameters given to the ApacheHandler constructor:

   request_class  => 'MasonX::Request::ExtendedCompRoot'
   resolver_class => 'MasonX::Resolver::ExtendedCompRoot'
 
 

PREREQUISITES

HTML::Mason

BUGS

No known bugs.

VERSION

0.03

SEE ALSO

HTML::Mason::Resolver::File, MasonX::Request::ExtendedCompRoot, MasonX::Request::ExtendedCompRoot::WithApacheSession

AUTHOR

Alex Robinson, <cpan[@]alex.cloudband.com>

LICENSE

MasonX::Resolver::ExtendedCompRoot is free software and can be used under the same terms as Perl, i.e. either the GNU Public Licence or the Artistic License.