package SQL::Translator::Schema::Object;
# ----------------------------------------------------------------------
-# $Id: Object.pm,v 1.1 2004-11-04 16:29:56 grommit Exp $
+# $Id: Object.pm,v 1.2 2004-11-05 13:19:31 grommit Exp $
# ----------------------------------------------------------------------
# Copyright (C) 2002-4 SQLFairy Authors
#
=head1 DESCSIPTION
-Doesn't currently provide any functionaliy apart from sub classing
-L<Class::Base>. Here to provide a single place to impliment global Schema
-object functionality.
+Base class for Schema objects. Sub classes L<Class::Base> and adds the following
+extra functionality.
=cut
use strict;
use Class::Base;
+use base 'Class::Data::Inheritable';
use base 'Class::Base';
use vars qw[ $VERSION ];
-$VERSION = sprintf "%d.%02d", q$Revision: 1.1 $ =~ /(\d+)\.(\d+)/;
+$VERSION = sprintf "%d.%02d", q$Revision: 1.2 $ =~ /(\d+)\.(\d+)/;
-1;
+=head1 Construction
-# ----------------------------------------------------------------------
+Derived classes should decalare their attributes using the C<_attributes>
+method. They can then inherit the C<init> method from here which will call
+accessors of the same name for any values given in the hash passed to C<new>.
+Note that you will have to impliment the accessors your self and we expect perl
+style methods; call with no args to get and with arg to set.
+
+e.g. If we setup our class as follows;
+
+ package SQL::Translator::Schema::Table;
+ use base qw/SQL::Translator::Schema::Object/;
+
+ __PACKAGE__->_attributes( qw/schema name/ );
+
+ sub name { ... }
+ sub schema { ... }
+
+Then we can construct it with
+
+ my $table = SQL::Translator::Schema::Table->new(
+ schema => $schema,
+ name => 'foo',
+ );
+
+and init will call C<< $table->name("foo") >> and C<< $table->schema($schema) >>
+to set it up. Any undefined args will be ignored.
+
+Multiple calls to C<_attributes> are cumulative and sub classes will inherit
+their parents attribute names.
+
+This is currently experimental, but will hopefull go on to form an introspection
+API for the Schema objects.
+
+=cut
+
+
+__PACKAGE__->mk_classdata("__attributes");
+__PACKAGE__->__attributes([]);
+
+# Set the classes attribute names. Multiple calls are cumulative.
+# We need to be careful to create a new ref so that all classes don't end up
+# with the same ref and hence the same attributes!
+sub _attributes {
+ my $class = shift;
+ if (@_) { $class->__attributes( [ @{$class->__attributes}, @_ ] ); }
+ return @{$class->__attributes};
+}
+
+# Call accessors for any args in hashref passed
+sub init {
+ my ( $self, $config ) = @_;
+
+ for my $arg ( $self->_attributes ) {
+ next unless defined $config->{$arg};
+ defined $self->$arg( $config->{$arg} ) or return;
+ }
+
+ return $self;
+}
+
+
+#=============================================================================
+
+1;
=pod