package Catalyst::ActionChain;
-use strict;
-use base qw/Catalyst::Action/;
+use Moose;
+extends qw(Catalyst::Action);
+has chain => (is => 'rw');
+no Moose;
=head1 NAME
=cut
-__PACKAGE__->mk_accessors(qw/chain/);
-
-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(@_); }; },
-
- # Make general $stuff still work
- fallback => 1,
-
-);
-
-
sub dispatch {
my ( $self, $c ) = @_;
my @captures = @{$c->req->captures||[]};
my $last = pop(@chain);
foreach my $action ( @chain ) {
my @args;
- if (my $cap = $action->attributes->{CaptureArgs}) {
- @args = splice(@captures, 0, $cap->[0]);
+ if (my $cap = $action->number_of_captures) {
+ @args = splice(@captures, 0, $cap);
}
local $c->request->{arguments} = \@args;
$action->dispatch( $c );
+
+ # break the chain if exception occurs in the middle of chain. We
+ # check the global config flag 'abort_chain_on_error_fix', but this
+ # is now considered true by default, so unless someone explicitly sets
+ # it to false we default it to true (if its not defined).
+ my $abort = defined($c->config->{abort_chain_on_error_fix}) ?
+ $c->config->{abort_chain_on_error_fix} : 1;
+ return if ($c->has_errors && $abort);
}
$last->dispatch( $c );
}
return $self->new({ %$final, chain => $actions });
}
+sub number_of_captures {
+ my ( $self ) = @_;
+ my $chain = $self->chain;
+ my $captures = 0;
+
+ $captures += $_->number_of_captures for @$chain;
+ return $captures;
+}
+
+sub match_captures {
+ my ($self, $c, $captures) = @_;
+ my @captures = @{$captures||[]};
+
+ foreach my $link(@{$self->chain}) {
+ my @local_captures = splice @captures,0,$link->number_of_captures;
+ return unless $link->match_captures($c, \@local_captures);
+ }
+ return 1;
+}
+sub match_captures_constraints {
+ my ($self, $c, $captures) = @_;
+ my @captures = @{$captures||[]};
+
+ foreach my $link(@{$self->chain}) {
+ my @local_captures = splice @captures,0,$link->number_of_captures;
+ next unless $link->has_captures_constraints;
+ return unless $link->match_captures_constraints($c, \@local_captures);
+ }
+ return 1;
+}
+
+# the scheme defined at the end of the chain is the one we use
+# but warn if too many.
+
+sub scheme {
+ my $self = shift;
+ my @chain = @{ $self->chain };
+ my ($scheme, @more) = map {
+ exists $_->attributes->{Scheme} ? $_->attributes->{Scheme}[0] : ();
+ } reverse @chain;
+
+ warn "$self is a chain with two many Scheme attributes (only one is allowed)"
+ if @more;
+
+ return $scheme;
+}
+
+__PACKAGE__->meta->make_immutable;
1;
__END__
Takes a list of Catalyst::Action objects and constructs and returns a
Catalyst::ActionChain object representing a chain of these actions
-=cut
+=head2 number_of_captures
+
+Returns the total number of captures for the entire chain of actions.
+
+=head2 match_captures
+
+Match all the captures that this chain encloses, if any.
+
+=head2 scheme
+
+Any defined scheme for the actionchain
+
+=head2 meta
+
+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