CatalystX::Declare::Keyword::Role - Declare Catalyst Controller Roles
use CatalystX::Declare; controller_role MyApp::Web::ControllerRole::Foo { method provided_method { ... } action foo, under base, is final { ... } around bar_action (Object $ctx) { ... } } controller_role MyApp::Web::ControllerRole::WithParam (Str :$msg!) { final action message under base { $ctx->stash(message => $msg); } }
This handler provides the controller_role keyword. It is an extension of the MooseX::Declare::Syntax::Keyword::Role handler. Like with declared controllers, the method keyword and the modifiers are provided. For details on the syntax for action declarations have a look at CatalystX::Declare::Keyword::Action, which also documents the effects of method modifiers on actions.
controller_role
method
You can use a parameter signature containing named parameters for a role. To apply the controller role in the "SYNOPSIS", you'd use code like this:
controller MyApp::Web::Controller::Hello { with 'MyApp::Web::ControllerRole::WithParam' => { msg => 'Hello!' }; action base under '/' as ''; }
You can currently only use the parameters in action declarations in the body, te name, the as path part and the under base action specification:
as
under
controller_role Foo (Str :$base, Str :$part) { action foo under $base as $part { ... } }
You can specify the parameters either as plain scalar variables or as quoted strings. The latter is especially useful for more complex path parts:
action foo under $base as "$pathpart/fnord" { ... }
To use it in the action name is rather simple:
final action $foo { ... }
You might want to use the as $foo option to specify a path part instead, though. Use the dynamic action name possibility only if you are really concerned with the name of the generated method, not only the path the action is reachable under.
as $foo
Object->add_namespace_customizations (Object $ctx, Str $package)
This hook is called by MooseX::Declare and will set the package up as a role and apply MooseX::MethodAttributes.
ArrayRef[Object] Object->default_inner ()
Same as "default_inner" in CatalystX::Declare::Keyword::Class.
See "AUTHOR" in CatalystX::Declare for author information.
This program is free software; you can redistribute it and/or modify it under the same terms as perl itself.
To install CatalystX::Declare, copy and paste the appropriate command in to your terminal.
cpanm
cpanm CatalystX::Declare
CPAN shell
perl -MCPAN -e shell install CatalystX::Declare
For more information on module installation, please visit the detailed CPAN module installation guide.