mason::component::classmeta(3pm) [debian man page]

Mason::Component::ClassMeta(3pm)			User Contributed Perl Documentation			  Mason::Component::ClassMeta(3pm)

NAME

       Mason::Component::ClassMeta - Meta-information about Mason component class

SYNOPSIS

	   # In a component:
	   My path is <% $.cmeta->path %>
	   My source file is <% $.cmeta->source_file %>

DESCRIPTION

       Every Mason::Component class has an associated Mason::Component::ClassMeta object, containing meta-information such as the component's path
       and source file. It can be accessed with the cmeta method.

       class
	   The component class that this meta object is associated with.

       dir_path
	   The directory of the component path, relative to the component root - e.g. for a component '/foo/bar', the dir_path is '/foo'.

       is_top_level
	   Whether the component is considered "top level", accessible directly from "$interp->run" or a web request. See "top_level_extensions"
	   in Mason::Interp.

       name
	   The component base name, e.g. 'bar' for component '/foo/bar'.

       object_file
	   The object file produced from compiling the component.

       path
	   The component path, relative to the component root - e.g. '/foo/bar'.

       source_file
	   The component source file.

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::Component::ClassMeta(3pm)

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)