X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FActionContainer.pm;h=ca36862d0d4874e57c2b871cb184e28d40d4b887;hb=b6d4ee6e9d0c627982cd2da23702ee900a1b1796;hp=337fdf6ed5492f95ce0e4669382fca5ad713c5ca;hpb=2633d7dc3bb9c0cf7bf3e7cf936d6411fe3ba5aa;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/ActionContainer.pm b/lib/Catalyst/ActionContainer.pm index 337fdf6..ca36862 100644 --- a/lib/Catalyst/ActionContainer.pm +++ b/lib/Catalyst/ActionContainer.pm @@ -1,40 +1,89 @@ package Catalyst::ActionContainer; -use strict; -use base qw/Class::Accessor::Fast/; +=head1 NAME + +Catalyst::ActionContainer - Catalyst Action Container + +=head1 SYNOPSIS + +See L. -__PACKAGE__->mk_accessors(qw/part actions/); +=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 + +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::ActionContainer - Catalyst Action Container +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; +} + +1; + +__END__ =head1 METHODS -=over 4 +=head2 new(\%data | $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 + +=head2 get_action($name) + +Returns an action from this container based on the action name, or undef + +=head2 add_action($action, [ $name ]) + +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 -=item part +Accessor to the path part this container resolves to. Also what the container +stringifies to. -=item actions +=head2 meta -=back +Provided by Moose =head1 AUTHOR -Matt S. Trout +Matt S. Trout =head1 COPYRIGHT