X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FActionContainer.pm;h=9adab59a23e820068695238cd41e6c23856d9184;hb=250cad0f65cf92f1a48dcbd7db4952970563a3c2;hp=bb21c0916cbde52017406047f7e1b45d9a03ee33;hpb=a13e21ab238a2752262dda5773d5be7a6273d875;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/ActionContainer.pm b/lib/Catalyst/ActionContainer.pm index bb21c09..9adab59 100644 --- a/lib/Catalyst/ActionContainer.pm +++ b/lib/Catalyst/ActionContainer.pm @@ -3,6 +3,21 @@ 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 overload ( @@ -20,45 +35,40 @@ sub new { $class->SUPER::new($fields); } -=head1 NAME -Catalyst::ActionContainer - Catalyst Action Container -=head1 SYNOPSIS +sub get_action { + my ( $self, $name ) = @_; + return $self->actions->{$name} if defined $self->actions->{$name}; + return; +} -See L. +sub add_action { + my ( $self, $action, $name ) = @_; + $name ||= $action->name; + $self->actions->{$name} = $action; +} -=head1 DESCRIPTION +1; -This is a container for actions. The dispatcher sets up a tree of these -to represent the various dispatch points in your application. +__END__ =head1 METHODS -=head2 get_action($name) +=head2 new(\%data | $part) -Returns an action from this container based on the action name, or undef +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 -=cut +=head2 get_action($name) -sub get_action { - my ( $self, $name ) = @_; - return $self->actions->{$name} if defined $self->actions->{$name}; - return; -} +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 -=cut - -sub add_action { - my ( $self, $action, $name ) = @_; - my $name ||= $action->name; - $self->actions->{$name} = $action; -} - =head2 actions Accessor to the actions hashref, containing all actions in this container. @@ -68,9 +78,9 @@ Accessor to the actions hashref, containing all actions in this container. Accessor to the path part this container resolves to. Also what the container stringifies to. -=head1 AUTHOR +=head1 AUTHORS -Matt S. Trout +Catalyst Contributors, see Catalyst.pm =head1 COPYRIGHT