=head2 $self->list($c)
+Debug output for Path dispatch points
+
=cut
sub list {
my ( $self, $c ) = @_;
- my $paths = Text::SimpleTable->new( [ 36, 'Path' ], [ 37, 'Private' ] );
- for my $path ( sort keys %{ $self->{paths} } ) {
- my $action = $self->{paths}->{$path};
- $path = "/$path" unless $path eq '/';
- $paths->row( "$path", "/$action" );
+ my $paths = Text::SimpleTable->new( [ 35, 'Path' ], [ 36, 'Private' ] );
+ foreach my $path ( sort keys %{ $self->{paths} } ) {
+ my $display_path = $path eq '/' ? $path : "/$path";
+ foreach my $action ( @{ $self->{paths}->{$path} } ) {
+ $paths->row( $display_path, "/$action" );
+ }
}
- $c->log->debug( "Loaded Path actions:\n" . $paths->draw )
+ $c->log->debug( "Loaded Path actions:\n" . $paths->draw . "\n" )
if ( keys %{ $self->{paths} } );
}
=head2 $self->match( $c, $path )
+For each action registered to this exact path, offers the action a chance to
+match the path (in the order in which they were registered). Succeeds on the
+first action that matches, if any; if not, returns 0.
+
=cut
sub match {
my ( $self, $c, $path ) = @_;
- $path ||= '/';
- if ( my $action = $self->{paths}->{$path} ) {
- return 0 unless $action->match($c);
+ $path = '/' if !defined $path || !length $path;
+
+ foreach my $action ( @{ $self->{paths}->{$path} || [] } ) {
+ next unless $action->match($c);
$c->req->action($path);
$c->req->match($path);
$c->action($action);
=head2 $self->register( $c, $action )
+Calls register_path for every Path attribute for the given $action.
+
=cut
sub register {
=head2 $self->register_path($c, $path, $action)
+Registers an action at a given path.
+
=cut
sub register_path {
$path = '/' unless length $path;
$path = URI->new($path)->canonical;
- $self->{paths}{$path} = $action;
+ unshift( @{ $self->{paths}{$path} ||= [] }, $action);
+
+ return 1;
+}
+
+=head2 $self->uri_for_action($action, $captures)
+
+get a URI part for an action; always returns undef is $captures is set
+since Path actions don't have captures
+
+=cut
+
+sub uri_for_action {
+ my ( $self, $action, $captures ) = @_;
+
+ return undef if @$captures;
+
+ if (my $paths = $action->attributes->{Path}) {
+ my $path = $paths->[0];
+ $path = '/' unless length($path);
+ $path = "/${path}" unless ($path =~ m/^\//);
+ $path = URI->new($path)->canonical;
+ return $path;
+ } else {
+ return undef;
+ }
}
-=head1 AUTHOR
+=head1 AUTHORS
-Matt S Trout
-Sebastian Riedel, C<sri@cpan.org>
+Catalyst Contributors, see Catalyst.pm
=head1 COPYRIGHT