mason::plugin::lvalueattributes(3pm) [debian man page]

Mason::Plugin::LvalueAttributes(3pm)			User Contributed Perl Documentation		      Mason::Plugin::LvalueAttributes(3pm)

NAME

       Mason::Plugin::LvalueAttributes - Create lvalue accessors for all rw component attributes

SYNOPSIS

	   <%class>
	   has 'a' => (is => "rw")
	   has 'b' => (is => "ro")
	   </%class>

	   <%init>
	   # set a to 5
	   $.a = 5;

	   # set a to 6
	   $.a(6);

	   # error
	   $.b = 7;
	   </%init>

DESCRIPTION

       This plugins creates an Lvalue accessor for every read/write attribute in the component. Which means that instead of writing:

	   $.name( "Foo" );

       you can use the more natural syntax

	   $.name = "Foo";

WARNING

       Standard Moose setter features such as type checking, triggers, and coercion will not work on Lvalue attributes. You should only use this
       plugin when the convenience of the Lvalue attributes outweighs the need for setter features.

ACKNOWLEDGEMENTS

       Inspired by Christopher Brown's MooseX::Meta::Attribute::Lvalue.

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::Plugin::LvalueAttributes(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)