-package Apache::MVC::Model::Base;
+package Maypole::Model::Base;
our %remember;
sub MODIFY_CODE_ATTRIBUTES { $remember{$_[1]} = $_[2]; () }
sub process {
my ($class, $r) = @_;
- $r->template( my $method = $r->action );
- $r->objects([ $class->retrieve(shift @{$r->{args}}) ]);
+ my $method = $r->action;
+ return if $r->{template}; # Authentication has set this, we're done.
+
+ $r->{template} = $method;
+ $r->objects([]);
+ my $obj = $class->retrieve( $r->{args}->[0] );
+ if ($obj) {
+ $r->objects([ $obj ]);
+ shift @{$r->{args}};
+ }
$class->$method($r);
}
+sub display_columns {
+ sort shift->columns;
+}
+
=head1 NAME
-Apache::MVC::Model::Base - Base class for model classes
+Maypole::Model::Base - Base class for model classes
=head1 DESCRIPTION
sub do_edit { die "This is an abstract method" }
+=head2 setup_database
+
+ $model->setup_database($config, $namespace, @data)
+
+Uses the user-defined data in C<@data> to specify a database- for
+example, by passing in a DSN. The model class should open the database,
+and create a class for each table in the database. These classes will
+then be C<adopt>ed. It should also populate C<< $config->{tables} >> and
+C<< $config->{classes} >> with the names of the classes and tables
+respectively. The classes should be placed under the specified
+namespace. For instance, C<beer> should be mapped to the class
+C<BeerDB::Beer>.
+
+=head2 class_of
+
+ $model->class_of($r, $table)
+
+This maps between a table name and its associated class.
+
=head2 retrieve
This turns an ID into an object of the appropriate class.
=head2 columns
-This is a list of the columns in a table.
+This is a list of all the columns in a table. You may also override
+C<display_columns>, which is the list of columns you want to view, in
+the right order.
=head2 table
=cut
+sub class_of { die "This is an abstract method" }
+sub setup_database { die "This is an abstract method" }
sub list :Exported { die "This is an abstract method" };
=pod
-Also, see the exported commands in C<Apache::MVC::Model::CDBI>.
+Also, see the exported commands in C<Maypole::Model::CDBI>.
=head1 Other overrides
=cut
-sub column_names { my $class = shift; map { $_ => ucfirst $_ } $class->columns }
+sub column_names { my $class = shift; map {
+ my $col = $_;
+ $col =~ s/_+(\w)?/ \U\1/g;
+ $_ => ucfirst $col } $class->columns }
=head2 description