X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FAction.pm;h=1649f35f725b2acb5da6d1b28fc18556a53b414e;hb=4dcffe42e2dc781d2942bd4935cb1d3c96ce6464;hp=6758e862243f94c3960d896bacd492fe86f9c146;hpb=4090e3bb3fea1a73ac369250e31584d61428b808;p=catagits%2FCatalyst-Runtime.git diff --git a/lib/Catalyst/Action.pm b/lib/Catalyst/Action.pm index 6758e86..1649f35 100644 --- a/lib/Catalyst/Action.pm +++ b/lib/Catalyst/Action.pm @@ -6,11 +6,11 @@ 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. @@ -18,6 +18,9 @@ L subclasses. =cut 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'); @@ -26,7 +29,23 @@ has attributes => (is => 'rw'); has name => (is => 'rw'); has code => (is => 'rw'); -no Moose; +use overload ( + + # Stringify to reverse for debug output etc. + q{""} => sub { shift->{reverse} }, + + # Codulate to execute to invoke the encapsulated action coderef + '&{}' => sub { my $self = shift; sub { $self->execute(@_); }; }, + + # Which action takes precedence + '<=>' => 'compare', + + # Make general $stuff still work + fallback => 1, + +); + + no warnings 'recursion'; @@ -34,17 +53,7 @@ no warnings 'recursion'; sub dispatch { # Execute ourselves against a context my ( $self, $c ) = @_; - #Moose todo: grrrrrr. this is no good. i don't know enough about it to - # debug it though. why can't we just call the accessor? - #local $c->{namespace} = $self->namespace; - #return $c->execute( $self->class, $self ); - - #believed to be equivalent: - my $orig = $c->namespace; - $c->namespace($self->namespace); - my $ret = $c->execute( $self->class, $self ); - $c->namespace($orig); - return $ret; + return $c->execute( $self->class, $self ); } sub execute { @@ -55,7 +64,7 @@ sub execute { sub match { my ( $self, $c ) = @_; #would it be unreasonable to store the number of arguments - #the action has as it's own attribute? + #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]; @@ -63,6 +72,18 @@ sub match { return scalar( @{ $c->req->args } ) == $args; } +sub compare { + my ($a1, $a2) = @_; + + my ($a1_args) = @{ $a1->attributes->{Args} || [] }; + my ($a2_args) = @{ $a2->attributes->{Args} || [] }; + + $_ = looks_like_number($_) ? $_ : ~0 + for $a1_args, $a2_args; + + return $a1_args <=> $a2_args; +} + __PACKAGE__->meta->make_immutable; 1; @@ -98,6 +119,13 @@ context and arguments Check Args attribute, and makes sure number of args matches the setting. Always returns true if Args is omitted. +=head2 compare + +Compares 2 actions based on the value of the C attribute, with no C +having the highest precedence. + +C<< <=> >> is overloaded to use this method. + =head2 namespace Returns the private namespace this action lives in. @@ -114,13 +142,13 @@ returns the sub name of this action. Provided by Moose -=head1 AUTHOR +=head1 AUTHORS -Matt S. Trout +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