X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FAction.pm;h=555c939589f97967f084b83b73257cbffb5a4f7f;hb=f9bdcfacb19ab17ed0b889ed6366272d8bf166fc;hp=af60527acaf016595a73357cbcbf16cc5c629cec;hpb=22faeff5f7d88f6f9c4cd73077e9428651cd8713;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Action.pm b/lib/Catalyst/Action.pm index af60527..555c939 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,14 @@ sub number_of_captures { return $self->attributes->{CaptureArgs}[0] || 0; } +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 +127,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 +148,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 +188,13 @@ 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 - -Provided by Moose. +=head2 list_extra_info -=head1 OPTIONAL METHODS +A HashRef of key-values that an action can provide to a debugging screen -=head2 match_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. +=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