X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FActionContainer.pm;h=2f98be169cfa466be5b06043eabc2f89897fb7fe;hb=b8ea7be4b18e77f8f3a094d5af64b9e3152ab6d3;hp=eb6bb7464d969853716b37ca5a7ba80bcb71df46;hpb=cfd04b0cabf99346090fe4e3312e393364e571ef;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/ActionContainer.pm b/lib/Catalyst/ActionContainer.pm index eb6bb74..2f98be1 100644 --- a/lib/Catalyst/ActionContainer.pm +++ b/lib/Catalyst/ActionContainer.pm @@ -1,49 +1,82 @@ package Catalyst::ActionContainer; -use strict; -use base qw/Class::Accessor::Fast/; +=head1 NAME -__PACKAGE__->mk_accessors(qw/part actions/); +Catalyst::ActionContainer - Catalyst Action Container -use overload ( +=head1 SYNOPSIS - # Stringify to path part for tree search - q{""} => sub { shift->{part} }, +See L. -); +=head1 DESCRIPTION -=head1 NAME +This is a container for actions. The dispatcher sets up a tree of these +to represent the various dispatch points in your application. -Catalyst::Action - Catalyst Action +=cut -=head1 SYNOPSIS +use Moose; -See L. +has part => (is => 'rw', required => 1); +has actions => (is => 'rw', required => 1, lazy => 1, default => sub { {} }); -=head1 DESCRIPTION +around new => sub { + my ($orig, $self, $params) = @_; + $orig->($self, (ref($params) ? $params : { part => $params } )); +}; + +no Moose; + +sub get_action { + my ( $self, $name ) = @_; + return $self->actions->{$name} if defined $self->actions->{$name}; + return; +} + +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 +=head1 AUTHORS -Matt S. Trout +Catalyst Contributors, see Catalyst.pm =head1 COPYRIGHT