X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?p=catagits%2FCatalyst-Runtime.git;a=blobdiff_plain;f=lib%2FCatalyst%2FBase.pm;h=0703b5c102218b53e13c89c5ae5ec56b4d467487;hp=f0138cf8a70f91c6931ea7102f949ebef7764b41;hb=a9dc674c99f36ff40d94b80753a1504074ba5e22;hpb=748161c4ad23fb071c9906201f98d7aaaad29222 diff --git a/lib/Catalyst/Base.pm b/lib/Catalyst/Base.pm index f0138cf..0703b5c 100644 --- a/lib/Catalyst/Base.pm +++ b/lib/Catalyst/Base.pm @@ -1,10 +1,56 @@ package Catalyst::Base; use strict; -use base qw/Class::Data::Inheritable Class::Accessor::Fast/; +use base qw/Catalyst::AttrContainer Class::Accessor::Fast/; + +use Catalyst::Exception; use NEXT; -__PACKAGE__->mk_classdata('_config'); +__PACKAGE__->mk_classdata($_) for qw/_config _dispatch_steps/; + +__PACKAGE__->_dispatch_steps( [qw/_BEGIN _AUTO _ACTION/] ); + +sub _DISPATCH : Private { + my ( $self, $c ) = @_; + + foreach my $disp ( @{ $self->_dispatch_steps } ) { + last unless $c->forward($disp); + } + + $c->forward('_END'); +} + +sub _BEGIN : Private { + my ( $self, $c ) = @_; + my $begin = ($c->get_actions( 'begin', $c->namespace))[-1]; + return 1 unless $begin; + $begin->execute($c); + return !@{ $c->error }; +} + +sub _AUTO : Private { + my ( $self, $c ) = @_; + my @auto = $c->get_actions('auto', $c->namespace); + foreach my $auto (@auto) { + $auto->execute($c); + return 0 unless $c->state; + } + return 1; +} + +sub _ACTION : Private { + my ( $self, $c ) = @_; + $c->action->execute($c); + return !@{ $c->error }; +} + +sub _END : Private { + my ( $self, $c ) = @_; + my $end = ($c->get_actions( 'end', $c->namespace))[-1]; + return 1 unless $end; + $end->execute($c); + return !@{ $c->error }; +} =head1 NAME @@ -33,7 +79,6 @@ Catalyst::Base - Catalyst Universal Base Class # Methods can be a request step $c->forward(qw/MyApp::Model::Something forward_to_me/); - MyApp->action( 'index.html' => \&MyApp::Model::Something::forward_to_me ); # Or just methods print $c->comp('MyApp::Model::Something')->test; @@ -48,25 +93,39 @@ This is the universal base class for Catalyst components It provides you with a generic new() for instantiation through Catalyst's component loader with config() support and a process() method placeholder. -=head2 METHODS +=head1 METHODS + +=over 4 + +=item new($c) -=head3 new =cut sub new { my ( $self, $c ) = @_; - return $self->NEXT::new( $self->config ); + + # Temporary fix, some components does not pass context to constructor + my $arguments = ( ref( $_[-1] ) eq 'HASH' ) ? $_[-1] : {}; + + return $self->NEXT::new( { %{ $self->config }, %{$arguments} } ); } -=head3 config +# remember to leave blank lines between the consecutive =item's +# otherwise the pod tools don't recognize the subsequent =items + +=item $c->config + +=item $c->config($hashref) + +=item $c->config($key, $value, ...) =cut sub config { my $self = shift; $self->_config( {} ) unless $self->_config; - if ( $_[0] ) { - my $config = $_[1] ? {@_} : $_[0]; + if (@_) { + my $config = @_ > 1 ? {@_} : $_[0]; while ( my ( $key, $val ) = each %$config ) { $self->_config->{$key} = $val; } @@ -74,11 +133,17 @@ sub config { return $self->_config; } -=head3 process +=item $c->process() =cut -sub process { 1 } +sub process { + + Catalyst::Exception->throw( message => ( ref $_[0] || $_[0] ) + . " did not override Catalyst::Base::process" ); +} + +=back =head1 SEE ALSO @@ -87,6 +152,8 @@ L. =head1 AUTHOR Sebastian Riedel, C +Marcus Ramberg, C +Matt S Trout, C =head1 COPYRIGHT