lib/Catalyst/Base.pm

   1 package Catalyst::Base;
   2
   3 use strict;
   4 use base qw/Class::Data::Inheritable Class::Accessor::Fast/;
   5 use NEXT;
   6
   7 __PACKAGE__->mk_classdata('_config');
   8
   9 =head1 NAME
  10
  11 Catalyst::Base - Catalyst Universal Base Class
  12
  13 =head1 SYNOPSIS
  14
  15     # lib/MyApp/Model/Something.pm
  16     package MyApp::Model::Something;
  17
  18     use base 'Catalyst::Base';
  19
  20     __PACKAGE__->config( foo => 'bar' );
  21
  22     sub test {
  23         my $self = shift;
  24         return $self->{foo};
  25     }
  26
  27     sub forward_to_me {
  28         my ( $self, $c ) = @_;
  29         $c->response->output( $self->{foo} );
  30     }
  31
  32     1;
  33
  34     # Methods can be a request step
  35     $c->forward(qw/MyApp::Model::Something forward_to_me/);
  36     MyApp->action( 'index.html' => \&MyApp::Model::Something::forward_to_me );
  37
  38     # Or just methods
  39     print $c->comp('MyApp::Model::Something')->test;
  40
  41     print $c->comp('MyApp::Model::Something')->{foo};
  42
  43 =head1 DESCRIPTION
  44
  45 This is the universal base class for Catalyst components
  46 (Model/View/Controller).
  47
  48 It provides you with a generic new() for instantiation through Catalyst's
  49 component loader with config() support and a process() method placeholder.
  50
  51 =head2 METHODS
  52
  53 =cut
  54
  55 sub new {
  56     my ( $self, $c ) = @_;
  57     return $self->NEXT::new( $self->config );
  58 }
  59
  60 =head3 config
  61
  62 =cut
  63
  64 sub config {
  65     my $self = shift;
  66     $self->_config( {} ) unless $self->_config;
  67     if ( $_[0] ) {
  68         my $config = $_[1] ? {@_} : $_[0];
  69         while ( my ( $key, $val ) = each %$config ) {
  70             $self->_config->{$key} = $val;
  71         }
  72     }
  73     return $self->_config;
  74 }
  75
  76 =head3 process
  77
  78 =cut
  79
  80 sub process { 1 }
  81
  82 =head1 SEE ALSO
  83
  84 L<Catalyst>.
  85
  86 =head1 AUTHOR
  87
  88 Sebastian Riedel, C<sri@cpan.org>
  89
  90 =head1 COPYRIGHT
  91
  92 This program is free software, you can redistribute it and/or modify it under
  93 the same terms as Perl itself.
  94
  95 =cut
  96
  97 1;