lib/Catalyst/ActionContainer.pm

   1 package Catalyst::ActionContainer;
   2
   3 use strict;
   4 use base qw/Class::Accessor::Fast/;
   5
   6 __PACKAGE__->mk_accessors(qw/part actions/);
   7
   8 use overload (
   9
  10     # Stringify to path part for tree search
  11     q{""} => sub { shift->{part} },
  12
  13 );
  14
  15 sub new {
  16     my ( $class, $fields ) = @_;
  17
  18     $fields = { part => $fields, actions => {} } unless ref $fields;
  19
  20     $class->SUPER::new($fields);
  21 }
  22
  23 =head1 NAME
  24
  25 Catalyst::ActionContainer - Catalyst Action Container
  26
  27 =head1 SYNOPSIS
  28
  29 See L<Catalyst>.
  30
  31 =head1 DESCRIPTION
  32
  33 This is a container for actions. The dispatcher sets up a tree of these
  34 to represent the various dispatch points in your application.
  35
  36 =head1 METHODS
  37
  38 =head2 get_action($name)
  39
  40 Returns an action from this container based on the action name, or undef
  41
  42 =cut
  43
  44 sub get_action {
  45     my ( $self, $name ) = @_;
  46     return $self->actions->{$name} if defined $self->actions->{$name};
  47     return;
  48 }
  49
  50 =head2 add_action($action, [ $name ])
  51
  52 Adds an action, optionally providing a name to override $action->name
  53
  54 =cut
  55
  56 sub add_action {
  57     my ( $self, $action, $name ) = @_;
  58     my $name ||= $action->name;
  59     $self->actions->{$name} = $action;
  60 }
  61
  62 =head2 actions
  63
  64 Accessor to the actions hashref, containing all actions in this container.
  65
  66 =head2 part
  67
  68 Accessor to the path part this container resolves to. Also what the container
  69 stringifies to.
  70
  71 =head1 AUTHOR
  72
  73 Matt S. Trout
  74
  75 =head1 COPYRIGHT
  76
  77 This program is free software, you can redistribute it and/or modify it under
  78 the same terms as Perl itself.
  79
  80 =cut
  81
  82 1;