my ( $self, $c ) = @_;
my $begin = ( $c->get_actions( 'begin', $c->namespace ) )[-1];
return 1 unless $begin;
- $begin->execute($c);
+ $begin->dispatch( $c );
return !@{ $c->error };
}
my ( $self, $c ) = @_;
my @auto = $c->get_actions( 'auto', $c->namespace );
foreach my $auto (@auto) {
- $auto->execute($c);
+ $auto->dispatch( $c );
return 0 unless $c->state;
}
return 1;
sub _ACTION : Private {
my ( $self, $c ) = @_;
- $c->action->execute($c);
+ if ( ref $c->action
+ && $c->action->can('execute')
+ && $c->req->action )
+ {
+ $c->action->dispatch( $c );
+ }
return !@{ $c->error };
}
my ( $self, $c ) = @_;
my $end = ( $c->get_actions( 'end', $c->namespace ) )[-1];
return 1 unless $end;
- $end->execute($c);
+ $end->dispatch( $c );
return !@{ $c->error };
}
Catalyst Base Class
+This is the base class for all Catalyst components. It also handles
+dispatch of actions for controllers.
+
=head1 METHODS
-=over 4
+=head2 $self->action_namespace($c)
-=item $self->action_namespace($c)
+Determine the namespace for actions in this component.
=cut
sub action_namespace {
my ( $self, $c ) = @_;
- return Catalyst::Utils::class2prefix( ref $self,
+ return $self->config->{namespace} if exists $self->config->{namespace};
+ return Catalyst::Utils::class2prefix( ref($self) || $self,
$c->config->{case_sensitive} )
|| '';
}
-=item $self->register_actions($c)
+=head2 $self->path_prefix($c)
+
+alias for action_namespace
+
+=cut
+
+sub path_prefix { shift->action_namespace(@_); }
+
+=head2 $self->register_actions($c)
+
+register all actions for this component based on a given context.
=cut
my $code = $cache->[0];
my $method = $methods{$code};
next unless $method;
- my $attrs = $self->_parse_attrs( @{ $cache->[1] } );
+ my $attrs = $self->_parse_attrs( $c, $method, @{ $cache->[1] } );
if ( $attrs->{Private} && ( keys %$attrs > 1 ) ) {
$c->log->debug( 'Bad action definition "'
. join( ' ', @{ $cache->[1] } )
next;
}
my $reverse = $namespace ? "$namespace/$method" : $method;
- my $action = $self->_action_class->new(
- {
- name => $method,
- code => $code,
- reverse => $reverse,
- namespace => $namespace,
- class => $class,
- attributes => $attrs,
- }
+ my $action = $self->create_action(
+ name => $method,
+ code => $code,
+ reverse => $reverse,
+ namespace => $namespace,
+ class => $class,
+ attributes => $attrs,
);
+
$c->dispatcher->register( $c, $action );
}
}
+sub create_action {
+ my $self = shift;
+ my %args = @_;
+
+ my $class = (exists $args{attributes}{ActionClass}
+ ? $args{attributes}{ActionClass}[0]
+ : $self->_action_class);
+
+ unless ( Class::Inspector->loaded($class) ) {
+ $class->require;
+ die "Couldn't load action class ${class}: $@" if $@;
+ }
+
+ return $class->new( \%args );
+}
+
sub _parse_attrs {
- my ( $self, @attrs ) = @_;
+ my ( $self, $c, $name, @attrs ) = @_;
my %attributes;
foreach my $attr (@attrs) {
if ( defined $value ) {
( $value =~ s/^'(.*)'$/$1/ ) || ( $value =~ s/^"(.*)"/$1/ );
}
+ my $meth = "_parse_${key}_attr";
+ if ( $self->can($meth) ) {
+ ( $key, $value ) = $self->$meth( $c, $name, $value );
+ }
push( @{ $attributes{$key} }, $value );
}
}
return \%attributes;
}
-=back
+sub _parse_Global_attr {
+ my ( $self, $c, $name, $value ) = @_;
+ return $self->_parse_Path_attr( $c, $name, "/$name" );
+}
+
+sub _parse_Absolute_attr { shift->_parse_Global_attr(@_); }
+
+sub _parse_Local_attr {
+ my ( $self, $c, $name, $value ) = @_;
+ return $self->_parse_Path_attr( $c, $name, $name );
+}
+
+sub _parse_Relative_attr { shift->_parse_Local_attr(@_); }
+
+sub _parse_Path_attr {
+ my ( $self, $c, $name, $value ) = @_;
+ $value ||= '';
+ if ( $value =~ m!^/! ) {
+ return ( 'Path', $value );
+ }
+ elsif ( length $value ) {
+ return ( 'Path', join( '/', $self->path_prefix($c), $value ) );
+ }
+ else {
+ return ( 'Path', $self->path_prefix($c) );
+ }
+}
+
+sub _parse_Regex_attr {
+ my ( $self, $c, $name, $value ) = @_;
+ return ( 'Regex', $value );
+}
+
+sub _parse_Regexp_attr { shift->_parse_Regex_attr(@_); }
+
+sub _parse_LocalRegex_attr {
+ my ( $self, $c, $name, $value ) = @_;
+ unless ( $value =~ s/^\^// ) { $value = "(?:.*?)$value"; }
+ return ( 'Regex', '^' . $self->path_prefix($c) . "/${value}" );
+}
+
+sub _parse_LocalRegexp_attr { shift->_parse_LocalRegex_attr(@_); }
+
+sub _parse_ActionClass_attr {
+ my ( $self, $c, $name, $value ) = @_;
+ unless ( $value =~ s/^\+// ) {
+ $value = join('::', $self->_action_class, $value );
+ }
+ return ( 'ActionClass', $value );
+}
=head1 SEE ALSO