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=97b9235a4f978abacefa73fa2069725cac69acd6;hp=6c9e9a1e386e92c68a5dd8753ea8f3ba0203da0c;hb=cf1fb734a3ab53b536aac54bcb3d382c845b46a8;hpb=0bf7ab7160f4f2fd0f00cd3d53ac311e9ad50241 diff --git a/lib/Catalyst/Action.pm b/lib/Catalyst/Action.pm index 6c9e9a1..97b9235 100644 --- a/lib/Catalyst/Action.pm +++ b/lib/Catalyst/Action.pm @@ -1,27 +1,33 @@ package Catalyst::Action; -use strict; -use base qw/Class::Accessor::Fast/; - - =head1 NAME Catalyst::Action - Catalyst Action =head1 SYNOPSIS -
+ =head1 DESCRIPTION -This class represents a Catalyst Action. You can access the object for the +This class represents a Catalyst Action. You can access the object for the currently dispatched action via $c->action. See the L for more information on how actions are dispatched. Actions are defined in L subclasses. =cut -__PACKAGE__->mk_accessors(qw/class namespace reverse attributes name code/); +use Moose; +use Scalar::Util 'looks_like_number'; +with 'MooseX::Emulate::Class::Accessor::Fast'; +use namespace::clean -except => 'meta'; + +has class => (is => 'rw'); +has namespace => (is => 'rw'); +has 'reverse' => (is => 'rw'); +has attributes => (is => 'rw'); +has name => (is => 'rw'); +has code => (is => 'rw'); use overload ( @@ -31,11 +37,21 @@ use overload ( # Codulate to execute to invoke the encapsulated action coderef '&{}' => sub { my $self = shift; sub { $self->execute(@_); }; }, + # Which action takes precedence + 'cmp' => 'compare', + '<=>' => 'compare', + # Make general $stuff still work fallback => 1, ); + + +no warnings 'recursion'; + +#__PACKAGE__->mk_accessors(qw/class namespace reverse attributes name code/); + sub dispatch { # Execute ourselves against a context my ( $self, $c ) = @_; return $c->execute( $self->class, $self ); @@ -43,17 +59,38 @@ sub dispatch { # Execute ourselves against a context sub execute { my $self = shift; - $self->{code}->(@_); + $self->code->(@_); } sub match { my ( $self, $c ) = @_; + #would it be unreasonable to store the number of arguments + #the action has as its own attribute? + #it would basically eliminate the code below. ehhh. small fish return 1 unless exists $self->attributes->{Args}; my $args = $self->attributes->{Args}[0]; return 1 unless defined($args) && length($args); return scalar( @{ $c->req->args } ) == $args; } +sub sort_order { + my $self = shift; + + my ($args) = @{ $self->attributes->{Args} || [] }; + + return $args if looks_like_number($args); + + return ~0; +} + +sub compare { + my ($a1, $a2) = @_; + + return $a1->sort_order <=> $a2->sort_order; +} + +__PACKAGE__->meta->make_immutable; + 1; __END__ @@ -87,6 +124,14 @@ context and arguments Check Args attribute, and makes sure number of args matches the setting. Always returns true if Args is omitted. +=head2 sort_order + +Returns the value of the C attribute, or C<~0> if it has no value. + +=head2 compare + +Returns C<< $a->sort_order <=> $b->sort_order >> . + =head2 namespace Returns the private namespace this action lives in. @@ -99,13 +144,17 @@ Returns the private path for this action. returns the sub name of this action. +=head2 meta + +Provided by Moose + =head1 AUTHORS Catalyst Contributors, see Catalyst.pm =head1 COPYRIGHT -This program is free software, you can redistribute it and/or modify it under +This library is free software. You can redistribute it and/or modify it under the same terms as Perl itself. =cut