lib/DBIx/Class/Table.pm

   1 package DBIx::Class::Table;
   2
   3 use strict;
   4 use warnings;
   5
   6 use DBIx::Class::ResultSet;
   7
   8 use base qw/DBIx::Class/;
   9
  10 __PACKAGE__->mk_classdata('_columns' => {});
  11
  12 __PACKAGE__->mk_classdata('_table_name');
  13
  14 __PACKAGE__->mk_classdata('table_alias'); # FIXME: Doesn't actually do anything yet!
  15
  16 __PACKAGE__->mk_classdata('_resultset_class' => 'DBIx::Class::ResultSet');
  17
  18 sub iterator_class { shift->_resultset_class(@_) }
  19
  20 =head1 NAME
  21
  22 DBIx::Class::Table - Basic table methods
  23
  24 =head1 SYNOPSIS
  25
  26 =head1 DESCRIPTION
  27
  28 This class is responsible for defining and doing basic operations on
  29 L<DBIx::Class> objects.
  30
  31 =head1 METHODS
  32
  33 =over 4
  34
  35 =cut
  36
  37 sub _register_columns {
  38   my ($class, @cols) = @_;
  39   my $names = { %{$class->_columns} };
  40   while (my $col = shift @cols) {
  41     $names->{$col} = (ref $cols[0] ? shift : {});
  42   }
  43   $class->_columns($names);
  44 }
  45
  46 sub _mk_column_accessors {
  47   my ($class, @cols) = @_;
  48   $class->mk_group_accessors('column' => @cols);
  49 }
  50
  51 =item add_columns
  52
  53   __PACKAGE__->add_columns(qw/col1 col2 col3/);
  54
  55 Adds columns to the current package, and creates accessors for them
  56
  57 =cut
  58
  59 sub add_columns {
  60   my ($class, @cols) = @_;
  61   $class->_register_columns(@cols);
  62   $class->_mk_column_accessors(@cols);
  63 }
  64
  65 sub resultset {
  66   my $class = shift;
  67
  68   my $rs_class = $class->_resultset_class;
  69   eval "use $rs_class;";
  70   my $rs = $rs_class->new($class, @_);
  71 }
  72
  73 =item search_like
  74
  75 Identical to search except defaults to 'LIKE' instead of '=' in condition
  76
  77 =cut
  78
  79 sub search_like {
  80   my $class    = shift;
  81   my $attrs = { };
  82   if (@_ > 1 && ref $_[$#_] eq 'HASH') {
  83     $attrs = pop(@_);
  84   }
  85   my $query    = ref $_[0] eq "HASH" ? { %{shift()} }: {@_};
  86   $query->{$_} = { 'like' => $query->{$_} } for keys %$query;
  87   return $class->search($query, { %$attrs });
  88 }
  89
  90 sub _select_columns {
  91   return keys %{$_[0]->_columns};
  92 }
  93
  94 =item table
  95
  96   __PACKAGE__->table('tbl_name');
  97
  98 =cut
  99
 100 sub table {
 101   shift->_table_name(@_);
 102 }
 103
 104 =item find_or_create
 105
 106   $class->find_or_create({ key => $val, ... });
 107
 108 Searches for a record matching the search condition; if it doesn't find one,
 109 creates one and returns that instead
 110
 111 =cut
 112
 113 sub find_or_create {
 114   my $class    = shift;
 115   my $hash     = ref $_[0] eq "HASH" ? shift: {@_};
 116   my $exists = $class->find($hash);
 117   return defined($exists) ? $exists : $class->create($hash);
 118 }
 119
 120 =item has_column
 121
 122   if ($obj->has_column($col)) { ... }
 123
 124 Returns 1 if the object has a column of this name, 0 otherwise
 125
 126 =cut
 127
 128 sub has_column {
 129   my ($self, $column) = @_;
 130   return exists $self->_columns->{$column};
 131 }
 132
 133 =item column_info
 134
 135   my $info = $obj->column_info($col);
 136
 137 Returns the column metadata hashref for the column
 138
 139 =cut
 140
 141 sub column_info {
 142   my ($self, $column) = @_;
 143   die "No such column $column" unless exists $self->_columns->{$column};
 144   return $self->_columns->{$column};
 145 }
 146
 147 =item columns
 148
 149   my @column_names = $obj->columns;
 150
 151 =cut
 152
 153 sub columns {
 154   die "columns() is a read-only accessor, did you mean add_columns()?" if (@_ > 1);
 155   return keys %{shift->_columns};
 156 }
 157
 158 1;
 159
 160 =back
 161
 162 =head1 AUTHORS
 163
 164 Matt S. Trout <mst@shadowcatsystems.co.uk>
 165
 166 =head1 LICENSE
 167
 168 You may distribute this code under the same terms as Perl itself.
 169
 170 =cut
 171