X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FActionContainer.pm;h=e2292e00346fe92559ea73bffbe7c763e7029118;hb=91772de91ca26edab67f5849eccbfbbe0d2cfd51;hp=eb6bb7464d969853716b37ca5a7ba80bcb71df46;hpb=cfd04b0cabf99346090fe4e3312e393364e571ef;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/ActionContainer.pm b/lib/Catalyst/ActionContainer.pm index eb6bb74..e2292e0 100644 --- a/lib/Catalyst/ActionContainer.pm +++ b/lib/Catalyst/ActionContainer.pm @@ -1,45 +1,87 @@ package Catalyst::ActionContainer; -use strict; -use base qw/Class::Accessor::Fast/; +=head1 NAME + +Catalyst::ActionContainer - Catalyst Action Container + +=head1 SYNOPSIS + +See L. + +=head1 DESCRIPTION + +This is a container for actions. The dispatcher sets up a tree of these +to represent the various dispatch points in your application. + +=cut -__PACKAGE__->mk_accessors(qw/part actions/); +use Moose; use overload ( # Stringify to path part for tree search - q{""} => sub { shift->{part} }, + q{""} => sub { shift->part }, ); -=head1 NAME +has part => (is => 'rw', required => 1, lazy => 1, default => sub { {} }); +has actions => (is => 'rw', required => 1, lazy => 1, default => sub { {} }); -Catalyst::Action - Catalyst Action +around 'new' => sub { + my $next = shift; + my ($self, $params) = @_; + $params = { part => $params } unless ref $params; + $next->($self, $params); +}; -=head1 SYNOPSIS +no Moose; -See L. +sub get_action { + my ( $self, $name ) = @_; + return $self->actions->{$name} if defined $self->actions->{$name}; + return; +} -=head1 DESCRIPTION +sub add_action { + my ( $self, $action, $name ) = @_; + $name ||= $action->name; + $self->actions->{$name} = $action; +} + +__PACKAGE__->meta->make_immutable; + +1; + +__END__ =head1 METHODS -=over 4 +=head2 new(\%data | $part) -=item part +Can be called with { part => $part, actions => \%actions } for full +construction or with just a part, which will result in an empty actions +hashref to be populated via add_action later -=item actions +=head2 get_action($name) -=item new +Returns an action from this container based on the action name, or undef -=cut +=head2 add_action($action, [ $name ]) -sub new { # Dumbass constructor - my ( $class, $attrs ) = @_; - return bless { %{ $attrs || {} } }, $class; -} +Adds an action, optionally providing a name to override $action->name + +=head2 actions + +Accessor to the actions hashref, containing all actions in this container. + +=head2 part + +Accessor to the path part this container resolves to. Also what the container +stringifies to. + +=head2 meta -=back +Provided by Moose =head1 AUTHOR