NAME
Catalyst::Controller::BindLex - Stash your lexical goodness.
SYNOPSIS
package MyApp::Controller::Moose;
use base qw/Catalyst::Controller::BindLex/;
sub bar : Local {
my ( $self, $c ) = @_;
my $x : Stashed;
my %y : Stashed;
$x = 100;
do_something( $c->stash->{x} ); # 100
$c->forward( "gorch" );
}
sub gorch : Private {
my ( $self, $c ) = @_;
my $x : Stashed;
do_something( $x ); # still 100
}
sub counter : Local {
my ( $self, $c ) = @_;
my $count : Session;
$c->res->body( "request number " . ++$count );
}
DESCRIPTION
This plugin lets you put your lexicals on the stash and elsewhere very
easily.
It uses some funky modules to get it's job done: PadWalker,
Array::RefElem, Devel::Caller, Devel::LexAlias and attributes. In some
people's opinion this hurts this plugin's reputation ;-).
If you use the same name for two variables with the same storage binding
attribute they will be aliased to each other, so you can use this for
reading as well as writing values across controller subs. This is almost
like sharing your lexical scope.
WHY ISN'T THIS A PLUGIN?
The way attributes are handled this can't be a plugin - the
MODIFY_SCALAR_ATTRIBUTES methods and friends need to be in the class
where the lexical is attributed, and this is typically a controller.
CONFIGURATION
You can add attributes to the configaration by mapping attributes to
handlers.
Handlers are either strings of methods to be called on $c with no
arguments, which are expected to return a hash reference (like "stash",
"session", etc), or code references invoked with $c, a reference to the
variable we're binding, and the name of the variable we're binding, also
expected to return a hash reference.
DEFAULT ATTRIBUTES
Some default attributes are pre-configured:
Stash, Stashed
Session, Sessioned
Flash, Flashed
Bind the variable to a key in "stash", "session" or "flash"
respetively.
The latter two require the use of
RECIPES
Param
To get
my $username : Param;
add
__PACKAGE__->config->{bindlex}{Param} => sub { $_[0]->req->params };
AUTHORS
Matt S. Trout
Yuval Kogman
SEE ALSO
PadWalker, Array::RefElem, Devel::Caller, Devel::LexAlias,
Sub::Parameters
COPYRIGHT & LICENSE
Copyright (c) 2005 the aforementioned authors. All rights
reserved. This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.
