X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FAction.pm;h=881c120e8dbd126fec459affddbc88704e51583a;hp=af60527acaf016595a73357cbcbf16cc5c629cec;hb=c463b49c849c28a6fa46e9eb1c07a31b51696f1d;hpb=22faeff5f7d88f6f9c4cd73077e9428651cd8713 diff --git a/lib/Catalyst/Action.pm b/lib/Catalyst/Action.pm index af60527..881c120 100644 --- a/lib/Catalyst/Action.pm +++ b/lib/Catalyst/Action.pm @@ -76,6 +76,8 @@ sub match { return scalar( @{ $c->req->args } ) == $args; } +sub match_captures { 1 } + sub compare { my ($a1, $a2) = @_; @@ -101,6 +103,18 @@ sub number_of_captures { return $self->attributes->{CaptureArgs}[0] || 0; } +sub scheme { + return exists $_[0]->attributes->{Scheme} ? $_[0]->attributes->{Scheme}[0] : undef; +} + +sub list_extra_info { + my $self = shift; + return { + Args => $self->attributes->{Args}[0], + CaptureArgs => $self->number_of_captures, + } +} + __PACKAGE__->meta->make_immutable; 1; @@ -117,7 +131,7 @@ and so on. This determines how the action is dispatched to. =head2 class Returns the name of the component where this action is defined. -Derived by calling the L +Derived by calling the L method on each component. =head2 code @@ -138,6 +152,16 @@ context and arguments Check Args attribute, and makes sure number of args matches the setting. Always returns true if Args is omitted. +=head2 match_captures ($c, $captures) + +Can be implemented by action class and action role authors. If the method +exists, then it will be called with the request context and an array reference +of the captures for this action. + +Returning true from this method causes the chain match to continue, returning +makes the chain not match (and alternate, less preferred chains will be attempted). + + =head2 compare Compares 2 actions based on the value of the C attribute, with no C @@ -168,20 +192,17 @@ Returns the number of args this action expects. This is 0 if the action doesn't Returns the number of captures this action expects for L actions. -=head2 meta +=head2 list_extra_info -Provided by Moose. +A HashRef of key-values that an action can provide to a debugging screen -=head1 OPTIONAL METHODS +=head2 scheme -=head2 match_captures +Any defined scheme for the action -Can be implemented by action class and action role authors. If the method -exists, then it will be called with the request context and an array reference -of the captures for this action. +=head2 meta -Returning true from this method causes the chain match to continue, returning -makes the chain not match (and alternate, less preferred chains will be attempted). +Provided by Moose. =head1 AUTHORS