NAME¶
Mason::Manual::Subclasses - Creating custom subclasses of Mason's classes
DESCRIPTION¶
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.
CREATING A SUBCLASS¶
A subclass should look something like this:
package My::Mason::Interp;
use Moose;
extends 'Mason::Interp';
# put your modifications here
1;
LETTING MASON KNOW ABOUT YOUR SUBCLASSES¶
There are two ways to let Mason know about your subclasses: by naming
convention, and by parameters to "Mason->new".
By naming convention¶
First, create a subclass of Mason itself:
package My::Mason;
use Moose;
extends 'Mason';
1;
and use that in place of "Mason" in construction:
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
By constructor parameter¶
You can specify your subclasses via "base_*" parameters to
"Mason->new()". e.g.
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 Mason::Interp for a complete list.
SEE ALSO¶
Mason
AUTHOR¶
Jonathan Swartz <swartz@pobox.com>
COPYRIGHT AND LICENSE¶
This software is copyright (c) 2012 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.