יובל קוג'מן (Yuval Kogman) > Catalyst-Controller-BindLex-0.03 > Catalyst::Controller::BindLex

Download:
Catalyst-Controller-BindLex-0.03.tar.gz

Dependencies

Annotate this POD

Related Modules

Inline::Java
more...
By perlmonks.org

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.03   Source   Latest Release: Catalyst-Controller-BindLex-0.05

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.
syntax highlighting: