|
|
|
|
Mason::Manual::Subclasses(3pm) User Contributed Perl Documentation Mason::Manual::Subclasses(3pm) 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) 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. perl v5.14.2 2012-05-02 Mason::Manual::Subclasses(3pm)
