X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FDispatchType%2FRegex.pm;h=4d8d28abd5cd606ad3b8ccfac056322279c02e18;hp=c40be54e5c30433450c3402708470065a7b6115b;hb=2f3812528068bc1d9f7840067f0c03d36cd47e6d;hpb=ea0e58d9d85d93bf94c3ffa6b4d7b71b200bbdf1 diff --git a/lib/Catalyst/DispatchType/Regex.pm b/lib/Catalyst/DispatchType/Regex.pm index c40be54..4d8d28a 100644 --- a/lib/Catalyst/DispatchType/Regex.pm +++ b/lib/Catalyst/DispatchType/Regex.pm @@ -1,10 +1,20 @@ package Catalyst::DispatchType::Regex; -use strict; -use base qw/Catalyst::DispatchType::Path/; +use Moose; +extends 'Catalyst::DispatchType::Path'; + use Text::SimpleTable; use Text::Balanced (); +has _compiled => ( + is => 'rw', + isa => 'ArrayRef', + required => 1, + default => sub{ [] }, + ); + +no Moose; + =head1 NAME Catalyst::DispatchType::Regex - Regex DispatchType @@ -26,18 +36,20 @@ Output a table of all regex actions, and their private equivalent. sub list { my ( $self, $c ) = @_; my $re = Text::SimpleTable->new( [ 35, 'Regex' ], [ 36, 'Private' ] ); - for my $regex ( @{ $self->{compiled} } ) { + for my $regex ( @{ $self->_compiled } ) { my $action = $regex->{action}; $re->row( $regex->{path}, "/$action" ); } - $c->log->debug( "Loaded Regex actions:\n" . $re->draw ) - if ( @{ $self->{compiled} } ); + $c->log->debug( "Loaded Regex actions:\n" . $re->draw . "\n" ) + if ( @{ $self->_compiled } ); } =head2 $self->match( $c, $path ) -Check path against compiled regexes, and set action to any matching -action. Returns 1 on success and 0 on failure. +Checks path against every compiled regex, and offers the action for any regex +which matches a chance to match the request. If it succeeds, sets action, +match and captures on $c->req and returns 1. If not, returns 0 without +altering $c. =cut @@ -48,7 +60,7 @@ sub match { # Check path against plain text first - foreach my $compiled ( @{ $self->{compiled} || [] } ) { + foreach my $compiled ( @{ $self->_compiled } ) { if ( my @captures = ( $path =~ $compiled->{re} ) ) { next unless $compiled->{action}->match($c); $c->req->action( $compiled->{path} ); @@ -65,10 +77,10 @@ sub match { =head2 $self->register( $c, $action ) -Registers one or more regex actions for an action object.\ +Registers one or more regex actions for an action object. Also registers them as literal paths. -Returns 1 on if any regexps were registered. +Returns 1 if any regexps were registered. =cut @@ -88,15 +100,15 @@ sub register { =head2 $self->register_regex($c, $re, $action) -Register an individual regex on the action. Usually called from the -register action. +Register an individual regex on the action. Usually called from the +register method. =cut sub register_regex { my ( $self, $c, $re, $action ) = @_; push( - @{ $self->{compiled} }, # and compiled regex for us + @{ $self->_compiled }, # and compiled regex for us { re => qr#$re#, action => $action, @@ -137,10 +149,9 @@ sub uri_for_action { return undef; } -=head1 AUTHOR +=head1 AUTHORS -Matt S Trout -Sebastian Riedel, C +Catalyst Contributors, see Catalyst.pm =head1 COPYRIGHT @@ -149,4 +160,6 @@ the same terms as Perl itself. =cut +__PACKAGE__->meta->make_immutable; + 1;