MooseX::Param(3) User Contributed Perl Documentation MooseX::Param(3)NAMEMooseX::Param - Simple role to provide a standard param method
SYNOPSIS
package My::Template::System;
use Moose;
with 'MooseX::Param';
# ...
my $template = My::Template::System->new(
params => {
foo => 10,
bar => 20,
baz => 30,
}
);
# fetching params
$template->param('foo'); # 10
# getting list of params
$template->param(); # foo, bar, baz
# setting params
$template->param(foo => 30, bar => 100);
DESCRIPTION
This is a very simple Moose role which provides a CGI like "param"
method.
I found that I had written this code over and over and over and over
again, and each time it was the same. So I thought, why not put it in a
role?
ATTRIBUTES
params
This role provides a "params" attribute which has a read-only
accessor, and a HashRef type constraint. It also adds a builder
method (see "init_params" method below) to properly initalize it.
METHODS
params
Return the HASH ref in which the parameters are stored.
param
This is your standard CGI style "param" method. If passed no
arguments, it will return a list of param names. If passed a single
name argument it will return the param associated with that name.
If passed a key value pair (or set of key value pairs) it will
assign them into the params.
init_params
This is the params attribute "builder" option, so it is called the
params are initialized.
NOTE: You can override this by defining your own version in your
class, because local class methods beat role methods in
composition.
meta
Returns the role metaclass.
SIMILAR MODULES
The "param" method can be found in several other modules, such as CGI,
CGI::Application and HTML::Template to name a few. This is such a
common Perl idiom that I felt it really deserved it's own role (if for
nothing more than I was sick of re-writing and copy-pasting it all the
time).
There are also a few modules which attempt to solve the same problem as
this module. Those are:
Class::Param
This module is much more ambitious than mine, and provides much
deeper functionality. For most of my purposes, this module would
have been overkill, but if you need really sophisticated param
handling and the ability to provide several different APIs (tied,
etc), this module is probably the way to go.
Mixin::ExtraFields::Param
This module is very similar to mine, but for a different framework.
It works with the Mixin::ExtraFields framework.
BUGS
All complex software has bugs lurking in it, and this module is no
exception. If you find a bug please either email me, or add the bug to
cpan-RT.
AUTHOR
Stevan Little <stevan@iinteractive.com>
COPYRIGHT AND LICENSE
Copyright 2007 by Infinity Interactive, Inc.
<http://www.iinteractive.com>
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.14.1 2011-07-20 MooseX::Param(3)