Mason::Manual::Subclasses - Creating custom subclasses of Mason's classes
You can subclass the following Mason classes for your application:
Mason::CodeCache Mason::Compilation Mason::Component Mason::Component::ClassMeta Mason::Component::Import Mason::Component::Moose Mason::Interp Mason::Request Mason::Result
and arrange things so that Mason always uses your subclass instead of its default class.
Note: if you want to create a general purpose modification to Mason to use in multiple applications, you should probably create a plugin instead of a subclass.
A subclass should look something like this:
package My::Mason::Interp; use Moose; extends 'Mason::Interp'; # put your modifications here 1;
There are two ways to let Mason know about your subclasses: by naming convention, and by parameters to Mason->new.
Mason->new
First, create a subclass of Mason itself:
package My::Mason; use Moose; extends 'Mason'; 1;
and use that in place of Mason in construction:
Mason
my $interp = My::Mason->new();
Now, you can place any subclasses under 'My::Mason' and they'll automatically be picked up. e.g.
My::Mason::Compilation My::Mason::Interp My::Mason::Request
You can specify your subclasses via "base_*" parameters to Mason->new(). e.g.
Mason->new()
my $interp = Mason->new( base_compilation_class => 'My::Mason::Compilation', base_interp_class => 'My::Mason::Interp' base_request_class => 'Some::Other::Mason::Request' );
See "CUSTOM MASON CLASSES" in Interp for a complete list.
Jonathan Swartz <swartz@pobox.com>
This software is copyright (c) 2011 by Jonathan Swartz.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Mason, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mason
CPAN shell
perl -MCPAN -e shell install Mason
For more information on module installation, please visit the detailed CPAN module installation guide.