| Mason::Manual::Subclasses(3pm) | User Contributed Perl Documentation | Mason::Manual::Subclasses(3pm) |
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".
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
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.
Mason
Jonathan Swartz <swartz@pobox.com>
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.
| 2022-05-27 | perl v5.34.0 |