Commit | Line | Data |
80c90f5d |
1 | package DBIx::Class::ResultSourceProxy::Table; |
cda04c3a |
2 | |
3 | use strict; |
4 | use warnings; |
5 | |
80c90f5d |
6 | use base qw/DBIx::Class::ResultSourceProxy/; |
cda04c3a |
7 | |
3e110410 |
8 | use DBIx::Class::ResultSource::Table; |
3d048732 |
9 | use Scalar::Util (); |
3e110410 |
10 | |
11 | __PACKAGE__->mk_classdata(table_class => 'DBIx::Class::ResultSource::Table'); |
cda04c3a |
12 | |
24d67825 |
13 | __PACKAGE__->mk_classdata('table_alias'); # FIXME: Doesn't actually do |
75d07914 |
14 | # anything yet! |
cda04c3a |
15 | |
e60dc79f |
16 | sub _init_result_source_instance { |
17 | my $class = shift; |
18 | |
19 | $class->mk_classdata('result_source_instance') |
20 | unless $class->can('result_source_instance'); |
21 | |
22 | my $table = $class->result_source_instance; |
23 | my $class_has_table_instance = ($table and $table->result_class eq $class); |
24 | return $table if $class_has_table_instance; |
25 | |
26 | if( $table ) { |
27 | $table = $class->table_class->new({ |
28 | %$table, |
29 | result_class => $class, |
30 | source_name => undef, |
31 | schema => undef |
32 | }); |
33 | } |
34 | else { |
35 | $table = $class->table_class->new({ |
36 | name => undef, |
37 | result_class => $class, |
38 | source_name => undef, |
39 | }); |
40 | } |
41 | |
42 | $class->result_source_instance($table); |
43 | |
e60dc79f |
44 | return $table; |
45 | } |
46 | |
75d07914 |
47 | =head1 NAME |
cda04c3a |
48 | |
24d67825 |
49 | DBIx::Class::ResultSourceProxy::Table - provides a classdata table |
50 | object and method proxies |
cda04c3a |
51 | |
52 | =head1 SYNOPSIS |
53 | |
24d67825 |
54 | __PACKAGE__->table('cd'); |
55 | __PACKAGE__->add_columns(qw/cdid artist title year/); |
56 | __PACKAGE__->set_primary_key('cdid'); |
cda04c3a |
57 | |
58 | =head1 METHODS |
59 | |
cda04c3a |
60 | =head2 add_columns |
61 | |
24d67825 |
62 | __PACKAGE__->add_columns(qw/cdid artist title year/); |
cda04c3a |
63 | |
64 | Adds columns to the current class and creates accessors for them. |
65 | |
66 | =cut |
67 | |
cda04c3a |
68 | =head2 table |
69 | |
70 | __PACKAGE__->table('tbl_name'); |
71 | |
72 | Gets or sets the table name. |
73 | |
74 | =cut |
75 | |
76 | sub table { |
77 | my ($class, $table) = @_; |
b98e75f6 |
78 | return $class->result_source_instance->name unless $table; |
c2b7c5dc |
79 | |
80 | unless (Scalar::Util::blessed($table) && $table->isa($class->table_class)) { |
5a879106 |
81 | $table = $class->table_class->new({ |
24d67825 |
82 | $class->can('result_source_instance') ? |
e60dc79f |
83 | %{$class->result_source_instance||{}} : (), |
cda04c3a |
84 | name => $table, |
85 | result_class => $class, |
b1fb2c94 |
86 | source_name => undef, |
5a879106 |
87 | }); |
cda04c3a |
88 | } |
e87bedbe |
89 | |
90 | $class->mk_classdata('result_source_instance') |
91 | unless $class->can('result_source_instance'); |
92 | |
93 | $class->result_source_instance($table); |
94 | |
ade8df5b |
95 | return $class->result_source_instance->name; |
cda04c3a |
96 | } |
97 | |
988bf309 |
98 | =head2 has_column |
99 | |
100 | if ($obj->has_column($col)) { ... } |
101 | |
102 | Returns 1 if the class has a column of this name, 0 otherwise. |
103 | |
104 | =cut |
105 | |
106 | =head2 column_info |
107 | |
108 | my $info = $obj->column_info($col); |
109 | |
110 | Returns the column metadata hashref for a column. For a description of |
111 | the various types of column data in this hashref, see |
75d07914 |
112 | L<DBIx::Class::ResultSource/add_column> |
988bf309 |
113 | |
114 | =cut |
cda04c3a |
115 | |
d7156e50 |
116 | =head2 columns |
117 | |
988bf309 |
118 | my @column_names = $obj->columns; |
119 | |
120 | =cut |
cda04c3a |
121 | |
cda04c3a |
122 | 1; |
123 | |
124 | =head1 AUTHORS |
125 | |
126 | Matt S. Trout <mst@shadowcatsystems.co.uk> |
127 | |
128 | =head1 LICENSE |
129 | |
130 | You may distribute this code under the same terms as Perl itself. |
131 | |
132 | =cut |
133 | |