1 package Catalyst::Action;
5 Catalyst::Action - Catalyst Action
9 <form action="[%c.uri_for(c.action.reverse)%]">
13 This class represents a Catalyst Action. You can access the object for the
14 currently dispatched action via $c->action. See the L<Catalyst::Dispatcher>
15 for more information on how actions are dispatched. Actions are defined in
16 L<Catalyst::Controller> subclasses.
23 has class => (is => 'rw');
24 has namespace => (is => 'rw');
25 has 'reverse' => (is => 'rw');
26 has attributes => (is => 'rw');
27 has name => (is => 'rw');
28 has code => (is => 'rw');
32 no warnings 'recursion';
34 #__PACKAGE__->mk_accessors(qw/class namespace reverse attributes name code/);
38 # Stringify to reverse for debug output etc.
39 q{""} => sub { shift->reverse() },
41 # Codulate to execute to invoke the encapsulated action coderef
42 '&{}' => sub { my $self = shift; sub { $self->execute(@_); }; },
44 # Make general $stuff still work
49 sub dispatch { # Execute ourselves against a context
50 my ( $self, $c ) = @_;
51 #Moose todo: grrrrrr. this is no good. i don't know enough about it to
52 # debug it though. why can't we just call the accessor?
53 #local $c->{namespace} = $self->namespace;
54 #return $c->execute( $self->class, $self );
56 #believed to be equivalent:
57 my $orig = $c->namespace;
58 $c->namespace($self->namespace);
59 my $ret = $c->execute( $self->class, $self );
70 my ( $self, $c ) = @_;
71 #would it be unreasonable to store the number of arguments
72 #the action has as it's own attribute?
73 #it would basically eliminate the code below. ehhh. small fish
74 return 1 unless exists $self->attributes->{Args};
75 my $args = $self->attributes->{Args}[0];
76 return 1 unless defined($args) && length($args);
77 return scalar( @{ $c->req->args } ) == $args;
80 __PACKAGE__->meta->make_immutable;
90 The sub attributes that are set for this action, like Local, Path, Private
91 and so on. This determines how the action is dispatched to.
95 Returns the class name where this action is defined.
99 Returns a code reference to this action.
101 =head2 dispatch( $c )
103 Dispatch this action against a context
105 =head2 execute( $controller, $c, @args )
107 Execute this action's coderef against a given controller with a given
108 context and arguments
112 Check Args attribute, and makes sure number of args matches the setting.
113 Always returns true if Args is omitted.
117 Returns the private namespace this action lives in.
121 Returns the private path for this action.
125 returns the sub name of this action.
137 This program is free software, you can redistribute it and/or modify it under
138 the same terms as Perl itself.