1 package DBIx::Class::Table;
6 use DBIx::Class::ResultSet;
10 use base qw/DBIx::Class/;
11 __PACKAGE__->load_components(qw/AccessorGroup/);
13 __PACKAGE__->mk_group_accessors('simple' =>
14 qw/_columns _primaries name resultset_class result_class storage/);
18 DBIx::Class::Table - Table object
24 This class is responsible for defining and doing table-level operations on
25 L<DBIx::Class> classes.
32 my ($class, $attrs) = @_;
33 $class = ref $class if ref $class;
34 my $new = bless({ %{$attrs || {}} }, $class);
35 $new->{resultset_class} ||= 'DBIx::Class::ResultSet';
36 $new->{_columns} ||= {};
37 $new->{name} ||= "!!NAME NOT SET!!";
42 my ($self, @cols) = @_;
43 while (my $col = shift @cols) {
44 $self->_columns->{$col} = (ref $cols[0] ? shift : {});
48 *add_column = \&add_columns;
52 $table->add_columns(qw/col1 col2 col3/);
54 $table->add_columns('col1' => \%col1_info, 'col2' => \%col2_info, ...);
56 Adds columns to the table object. If supplied key => hashref pairs uses
57 the hashref as the column_info for that column.
61 $table->add_column('col' => \%info?);
63 Convenience alias to add_columns
69 my $rs_class = $self->resultset_class;
70 eval "use $rs_class;";
71 return $rs_class->new($self);
76 if ($obj->has_column($col)) { ... }
78 Returns 1 if the table has a column of this name, 0 otherwise.
83 my ($self, $column) = @_;
84 return exists $self->_columns->{$column};
89 my $info = $obj->column_info($col);
91 Returns the column metadata hashref for a column.
96 my ($self, $column) = @_;
97 croak "No such column $column" unless exists $self->_columns->{$column};
98 return $self->_columns->{$column};
103 my @column_names = $obj->columns;
108 croak "columns() is a read-only accessor, did you mean add_columns()?" if (@_ > 1);
109 return keys %{shift->_columns};
112 =head2 set_primary_key(@cols)
114 Defines one or more columns as primary key for this table. Should be
115 called after C<add_columns>.
119 sub set_primary_key {
120 my ($self, @cols) = @_;
121 # check if primary key columns are valid columns
123 $self->throw("No such column $_ on table ".$self->name)
124 unless $self->has_column($_);
126 $self->_primaries(\@cols);
129 =head2 primary_columns
131 Read-only accessor which returns the list of primary keys.
135 sub primary_columns {
136 return @{shift->_primaries||[]};
144 Matt S. Trout <mst@shadowcatsystems.co.uk>
148 You may distribute this code under the same terms as Perl itself.