X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FDBIx%2FClass%2FTable.pm;h=49a9ffe82de1079c151a81fba8668efdac8fa425;hb=9ce9ec1036c3a67b4087b3f4a90bca09463c1e03;hp=16fc291ee4044c8b6fe9be52a25bed5e774e4237;hpb=0a3c5b435bb12d9cf11a403cb2933d106e8a0374;p=dbsrgits%2FDBIx-Class.git diff --git a/lib/DBIx/Class/Table.pm b/lib/DBIx/Class/Table.pm index 16fc291..49a9ffe 100644 --- a/lib/DBIx/Class/Table.pm +++ b/lib/DBIx/Class/Table.pm @@ -5,211 +5,36 @@ use warnings; use DBIx::Class::ResultSet; -use base qw/DBIx::Class/; - -__PACKAGE__->mk_classdata('_columns' => {}); - -__PACKAGE__->mk_classdata('_table_name'); - -__PACKAGE__->mk_classdata('table_alias'); # FIXME: Doesn't actually do anything yet! +use Carp qw/croak/; -__PACKAGE__->mk_classdata('_resultset_class' => 'DBIx::Class::ResultSet'); +use base qw/DBIx::Class/; +__PACKAGE__->load_components(qw/ResultSource AccessorGroup/); -sub iterator_class { shift->_resultset_class(@_) } +__PACKAGE__->mk_group_accessors('simple' => + qw/_columns _primaries name resultset_class result_class schema/); =head1 NAME -DBIx::Class::Table - Basic table methods +DBIx::Class::Table - Table object =head1 SYNOPSIS =head1 DESCRIPTION -This class is responsible for defining and doing basic operations on -L objects. +Table object that inherits from L =head1 METHODS -=over 4 - -=cut - -sub _register_columns { - my ($class, @cols) = @_; - my $names = { %{$class->_columns} }; - while (my $col = shift @cols) { - $names->{$col} = (ref $cols[0] ? shift : {}); - } - $class->_columns($names); -} - -sub _mk_column_accessors { - my ($class, @cols) = @_; - $class->mk_group_accessors('column' => @cols); -} - -=item add_columns - - __PACKAGE__->add_columns(qw/col1 col2 col3/); - -Adds columns to the current package, and creates accessors for them - -=cut - -sub add_columns { - my ($class, @cols) = @_; - $class->_register_columns(@cols); - $class->_mk_column_accessors(@cols); -} - -=item search_literal - - my @obj = $class->search_literal($literal_where_cond, @bind); - my $cursor = $class->search_literal($literal_where_cond, @bind); - -=cut - -sub search_literal { - my ($class, $cond, @vals) = @_; - $cond =~ s/^\s*WHERE//i; - my $attrs = (ref $vals[$#vals] eq 'HASH' ? { %{ pop(@vals) } } : {}); - $attrs->{bind} = \@vals; - return $class->search(\$cond, $attrs); -} - -=item count_literal - - my $count = $class->count_literal($literal_where_cond); - -=cut - -sub count_literal { - my $class = shift; - return $class->search_literal(@_)->count; -} - -=item count - - my $count = $class->count({ foo => 3 }); +=head2 from -=cut - -sub count { - my $class = shift; - return $class->search(@_)->count; -} - -=item search - - my @obj = $class->search({ foo => 3 }); # "... WHERE foo = 3" - my $cursor = $class->search({ foo => 3 }); - -To retrieve all rows, simply call C with no condition parameter, - - my @all = $class->search(); # equivalent to search({}) - -If you need to pass in additional attributes (see -L for details) an empty hash indicates -no condition, - - my @all = $class->search({}, { cols => [qw/foo bar/] }); # "SELECT foo, bar FROM $class_table" - -=cut - -sub resultset { - my $class = shift; - - my $rs_class = $class->_resultset_class; - eval "use $rs_class;"; - my $rs = $rs_class->new($class, @_); -} - -=item search_like - -Identical to search except defaults to 'LIKE' instead of '=' in condition +Returns the FROM entry for the table (i.e. the table name) =cut -sub search_like { - my $class = shift; - my $attrs = { }; - if (@_ > 1 && ref $_[$#_] eq 'HASH') { - $attrs = pop(@_); - } - my $query = ref $_[0] eq "HASH" ? { %{shift()} }: {@_}; - $query->{$_} = { 'like' => $query->{$_} } for keys %$query; - return $class->search($query, { %$attrs }); -} - -sub _select_columns { - return keys %{$_[0]->_columns}; -} - -=item table - - __PACKAGE__->table('tbl_name'); - -=cut - -sub table { - shift->_table_name(@_); -} - -=item find_or_create - - $class->find_or_create({ key => $val, ... }); - -Searches for a record matching the search condition; if it doesn't find one, -creates one and returns that instead - -=cut - -sub find_or_create { - my $class = shift; - my $hash = ref $_[0] eq "HASH" ? shift: {@_}; - my $exists = $class->find($hash); - return defined($exists) ? $exists : $class->create($hash); -} - -=item has_column - - if ($obj->has_column($col)) { ... } - -Returns 1 if the object has a column of this name, 0 otherwise - -=cut - -sub has_column { - my ($self, $column) = @_; - return exists $self->_columns->{$column}; -} - -=item column_info - - my $info = $obj->column_info($col); - -Returns the column metadata hashref for the column - -=cut - -sub column_info { - my ($self, $column) = @_; - die "No such column $column" unless exists $self->_columns->{$column}; - return $self->_columns->{$column}; -} - -=item columns - - my @column_names = $obj->columns; - -=cut - -sub columns { return keys %{shift->_columns}; } +sub from { shift->name; } 1; -=back - =head1 AUTHORS Matt S. Trout