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".

    package My::Mason;
    use Moose;
    extends 'Mason';
    1;

    my $interp = My::Mason->new();

    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.