take advantage of join_query_parts to clean up
[scpubgit/Q-Branch.git] / lib / SQL / Abstract / Clauses.pm
CommitLineData
bbe638af 1package SQL::Abstract::Clauses;
2
3use strict;
4use warnings;
ccb7f3d6 5use if $] < '5.010', 'MRO::Compat';
bbe638af 6use mro 'c3';
7use base 'SQL::Abstract';
8
1bcd361f 9BEGIN { *puke = \&SQL::Abstract::puke }
10
bbe638af 11sub new {
12 shift->next::method(@_)->register_defaults
13}
14
15sub register_defaults {
16 my ($self) = @_;
17 $self->{clauses_of}{select} = [ qw(select from where order_by) ];
18 $self->{expand}{select} = sub { shift->_expand_statement(@_) };
a01911a2 19 $self->{render}{select} = sub { shift->_render_statement(@_) };
df0f5af9 20 $self->{expand_clause}{"select.$_"} = "_expand_select_clause_$_"
21 for @{$self->{clauses_of}{select}};
46158aa8 22 $self->{clauses_of}{update} = [ qw(target set where returning) ];
1bcd361f 23 $self->{expand}{update} = sub { shift->_expand_statement(@_) };
a01911a2 24 $self->{render}{update} = sub { shift->_render_statement(@_) };
889fdd38 25 $self->{expand_clause}{"update.$_"} = "_expand_update_clause_$_"
26 for @{$self->{clauses_of}{update}};
46158aa8 27 $self->{expand_clause}{'update.update'} = '_expand_update_clause_target';
28 $self->{render_clause}{'update.target'} = sub {
fe8b493f 29 my ($self, undef, $target) = @_;
46158aa8 30 my ($sql, @bind) = $self->render_aqt($target);
31 ($self->_sqlcase('update ').$sql, @bind);
32 };
33 $self->{clauses_of}{delete} = [ qw(target where returning) ];
77e8c03d 34 $self->{expand}{delete} = sub { shift->_expand_statement(@_) };
a01911a2 35 $self->{render}{delete} = sub { shift->_render_statement(@_) };
44296b4e 36 $self->{expand_clause}{"delete.$_"} = "_expand_delete_clause_$_"
37 for @{$self->{clauses_of}{delete}};
46158aa8 38 $self->{expand_clause}{"delete.from"} = '_expand_delete_clause_target';
39 $self->{render_clause}{'delete.target'} = sub {
fe8b493f 40 my ($self, undef, $from) = @_;
46158aa8 41 my ($sql, @bind) = $self->render_aqt($from);
42 ($self->_sqlcase('delete from ').$sql, @bind);
43 };
2b057b28 44 $self->{clauses_of}{insert} = [
93253a11 45 'target', 'fields', 'from', 'returning'
2b057b28 46 ];
39544e0e 47 $self->{expand}{insert} = sub { shift->_expand_statement(@_) };
a01911a2 48 $self->{render}{insert} = sub { shift->_render_statement(@_) };
46158aa8 49 $self->{expand_clause}{'insert.into'} = '_expand_insert_clause_target';
50 $self->{expand_clause}{'insert.target'} = '_expand_insert_clause_target';
7958f5c6 51 $self->{expand_clause}{'insert.fields'} = sub {
52 return +{ -row => [
fe8b493f 53 shift->_expand_maybe_list_expr($_[2], -ident)
54 ] } if ref($_[2]) eq 'ARRAY';
55 return $_[2]; # should maybe still expand somewhat?
7958f5c6 56 };
f33d93b5 57 $self->{expand_clause}{'insert.values'} = '_expand_insert_clause_values';
39544e0e 58 $self->{expand_clause}{'insert.returning'} = sub {
59 shift->_expand_maybe_list_expr(@_, -ident);
60 };
2b057b28 61 $self->{render_clause}{'insert.fields'} = sub {
fe8b493f 62 return $_[0]->render_aqt($_[2]);
2b057b28 63 };
46158aa8 64 $self->{render_clause}{'insert.target'} = sub {
fe8b493f 65 my ($self, undef, $from) = @_;
46158aa8 66 my ($sql, @bind) = $self->render_aqt($from);
67 ($self->_sqlcase('insert into ').$sql, @bind);
68 };
93253a11 69 $self->{render_clause}{'insert.from'} = sub {
fe8b493f 70 return $_[0]->render_aqt($_[2], 1);
f8d50921 71 };
01222ad2 72 $self->{expand}{values} = '_expand_values';
73 $self->{render}{values} = '_render_values';
7250aa13 74 $self->{expand}{exists} = sub {
75 $_[0]->_expand_op(undef, [ exists => $_[2] ]);
76 };
38c5397d 77 $self->{render}{convert_where} = sub {
78 my $self = shift;
79 local $self->{convert_where} = $self->{convert};
80 $self->render_aqt($_[0]);
81 };
bbe638af 82 return $self;
83}
84
df0f5af9 85sub _expand_select_clause_select {
fe8b493f 86 my ($self, undef, $select) = @_;
df0f5af9 87 +(select => $self->_expand_maybe_list_expr($select, -ident));
88}
89
90sub _expand_select_clause_from {
fe8b493f 91 my ($self, undef, $from) = @_;
df0f5af9 92 +(from => $self->_expand_maybe_list_expr($from, -ident));
93}
94
95sub _expand_select_clause_where {
fe8b493f 96 my ($self, undef, $where) = @_;
38c5397d 97 my $exp = $self->expand_expr($where);
98 +(where => ($self->{convert} ? { -convert_where => $exp } : $exp));
df0f5af9 99}
100
101sub _expand_select_clause_order_by {
fe8b493f 102 my ($self, undef, $order_by) = @_;
df0f5af9 103 +(order_by => $self->_expand_order_by($order_by));
104}
105
46158aa8 106sub _expand_update_clause_target {
fe8b493f 107 my ($self, undef, $target) = @_;
e0eb8d26 108 +(target => $self->_expand_maybe_list_expr($target, -ident));
889fdd38 109}
110
111sub _expand_update_clause_set {
fe8b493f 112 return $_[2] if ref($_[2]) eq 'HASH' and ($_[2]->{-op}||[''])->[0] eq ',';
113 +(set => $_[0]->_expand_update_set_values($_[1], $_[2]));
889fdd38 114}
115
116sub _expand_update_clause_where {
fe8b493f 117 +(where => $_[0]->expand_expr($_[2]));
889fdd38 118}
119
120sub _expand_update_clause_returning {
fe8b493f 121 +(returning => $_[0]->_expand_maybe_list_expr($_[2], -ident));
889fdd38 122}
123
46158aa8 124sub _expand_delete_clause_target {
fe8b493f 125 +(target => $_[0]->_expand_maybe_list_expr($_[2], -ident));
44296b4e 126}
127
fe8b493f 128sub _expand_delete_clause_where { +(where => $_[0]->expand_expr($_[2])); }
44296b4e 129
130sub _expand_delete_clause_returning {
fe8b493f 131 +(returning => $_[0]->_expand_maybe_list_expr($_[2], -ident));
44296b4e 132}
133
bbe638af 134sub _expand_statement {
135 my ($self, $type, $args) = @_;
136 my $ec = $self->{expand_clause};
f9f1fdcd 137 if ($args->{_}) {
138 $args = { %$args };
139 $args->{$type} = delete $args->{_}
140 }
27d61b67 141 return +{ "-${type}" => +{
c79c67d7 142 map {
bbe638af 143 my $val = $args->{$_};
144 if (defined($val) and my $exp = $ec->{"${type}.$_"}) {
fe8b493f 145 if ((my (@exp) = $self->$exp($_ => $val)) == 1) {
c79c67d7 146 ($_ => $exp[0])
147 } else {
148 @exp
149 }
bbe638af 150 } else {
93253a11 151 ($_ => $self->expand_expr($val))
bbe638af 152 }
c79c67d7 153 } sort keys %$args
27d61b67 154 } };
bbe638af 155}
156
157sub _render_statement {
158 my ($self, $type, $args) = @_;
159 my @parts;
160 foreach my $clause (@{$self->{clauses_of}{$type}}) {
161 next unless my $clause_expr = $args->{$clause};
5e4aaea3 162 my @part = do {
2b057b28 163 if (my $rdr = $self->{render_clause}{"${type}.${clause}"}) {
fe8b493f 164 $self->$rdr($clause, $clause_expr);
2b057b28 165 } else {
01222ad2 166 my ($clause_sql, @bind) = $self->render_aqt($clause_expr, 1);
2b057b28 167 my $sql = join ' ',
168 $self->_sqlcase(join ' ', split '_', $clause),
169 $clause_sql;
170 ($sql, @bind);
171 }
172 };
2b057b28 173 push @parts, \@part;
bbe638af 174 }
0236f122 175 my ($sql, @bind) = $self->join_query_parts(' ', @parts);
01222ad2 176 return (
177 (our $Render_Top_Level ? $sql : '('.$sql.')'),
178 @bind
179 );
180}
181
182sub render_aqt {
183 my ($self, $aqt, $top_level) = @_;
184 local our $Render_Top_Level = $top_level;
185 return $self->next::method($aqt);
186}
187
188sub render_statement {
189 my ($self, $expr, $default_scalar_to) = @_;
190 my ($sql, @bind) = $self->render_aqt(
191 $self->expand_expr($expr, $default_scalar_to), 1
192 );
193 return (wantarray ? ($sql, @bind) : $sql);
bbe638af 194}
195
81b270e7 196sub select {
197 my ($self, @args) = @_;
7958f5c6 198
01222ad2 199 return $self->render_statement({ -select => $_[1] }) if ref($_[1]) eq 'HASH';
7958f5c6 200
81b270e7 201 my %clauses;
202 @clauses{qw(from select where order_by)} = @args;
8e6988ce 203
81b270e7 204 # This oddity is to literalify since historically SQLA doesn't quote
8e6988ce 205 # a single identifier argument, so we convert it into a literal
206
4ee74413 207 $clauses{select} = { -literal => [ $clauses{select}||'*' ] }
208 unless ref($clauses{select});
209
01222ad2 210 return $self->render_statement({ -select => \%clauses });
81b270e7 211}
212
1bcd361f 213sub update {
214 my ($self, $table, $set, $where, $options) = @_;
7958f5c6 215
01222ad2 216 return $self->render_statement({ -update => $_[1] }) if ref($_[1]) eq 'HASH';
7958f5c6 217
1bcd361f 218 my %clauses;
46158aa8 219 @clauses{qw(target set where)} = ($table, $set, $where);
1bcd361f 220 puke "Unsupported data type specified to \$sql->update"
221 unless ref($clauses{set}) eq 'HASH';
222 @clauses{keys %$options} = values %$options;
01222ad2 223 return $self->render_statement({ -update => \%clauses });
1bcd361f 224}
225
77e8c03d 226sub delete {
227 my ($self, $table, $where, $options) = @_;
7958f5c6 228
01222ad2 229 return $self->render_statement({ -delete => $_[1] }) if ref($_[1]) eq 'HASH';
7958f5c6 230
46158aa8 231 my %clauses = (target => $table, where => $where, %{$options||{}});
01222ad2 232 return $self->render_statement({ -delete => \%clauses });
77e8c03d 233}
234
39544e0e 235sub insert {
236 my ($self, $table, $data, $options) = @_;
7958f5c6 237
01222ad2 238 return $self->render_statement({ -insert => $_[1] }) if ref($_[1]) eq 'HASH';
7958f5c6 239
46158aa8 240 my %clauses = (target => $table, values => $data, %{$options||{}});
01222ad2 241 return $self->render_statement({ -insert => \%clauses });
39544e0e 242}
243
46158aa8 244sub _expand_insert_clause_target {
fe8b493f 245 +(target => $_[0]->_expand_maybe_list_expr($_[2], -ident));
46158aa8 246}
247
f33d93b5 248sub _expand_insert_clause_values {
fe8b493f 249 my ($self, undef, $data) = @_;
f8d50921 250 if (ref($data) eq 'HASH' and (keys(%$data))[0] =~ /^-/) {
251 return $self->expand_expr($data);
252 }
e5feec9f 253 return $data if ref($data) eq 'HASH' and $data->{-row};
f33d93b5 254 my ($f_aqt, $v_aqt) = $self->_expand_insert_values($data);
93253a11 255 return (from => { -values => $v_aqt }, ($f_aqt ? (fields => $f_aqt) : ()));
f33d93b5 256}
257
01222ad2 258sub _expand_values {
259 my ($self, undef, $values) = @_;
260 return { -values => [
261 map +(
262 ref($_) eq 'HASH'
263 ? $self->expand_expr($_)
264 : +{ -row => [ map $self->expand_expr($_), @$_ ] }
265 ), ref($values) eq 'ARRAY' ? @$values : $values
266 ] };
267}
268
269sub _render_values {
a01911a2 270 my ($self, undef, $values) = @_;
0236f122 271 my ($v_sql, @bind) = $self->join_query_parts(
01222ad2 272 ', ',
a1f8b6ef 273 ref($values) eq 'ARRAY' ? @$values : $values
01222ad2 274 );
275 my $sql = $self->_sqlcase('values').' '.$v_sql;
276 return (
277 (our $Render_Top_Level ? $sql : '('.$sql.')'),
278 @bind
279 );
280}
281
34570093 282sub _ext_rw {
283 my ($self, $name, $key, $value) = @_;
2b0b3d43 284 return $self->{$name}{$key} unless @_ > 3;
34570093 285 $self->{$name}{$key} = $value;
286 return $self;
287}
288
d390df44 289BEGIN {
290 foreach my $type (qw(
2b0b3d43 291 expand op_expand render op_render clause_expand clause_render
d390df44 292 )) {
3f9899e5 293 my $name = join '_', reverse split '_', $type;
58ebc7fa 294 my $singular = "${type}er";
3f9899e5 295 eval qq{sub ${singular} { shift->_ext_rw($name => \@_) }; 1 }
296 or die "Method builder failed for ${singular}: $@";
297 eval qq{sub wrap_${singular} {
298 my (\$self, \$key, \$builder) = \@_;
299 my \$orig = \$self->_ext_rw('${name}', \$key);
300 \$self->_ext_rw(
301 '${name}', \$key,
302 \$builder->(\$orig, '${name}', \$key)
303 );
304 }; 1 } or die "Method builder failed for wrap_${singular}: $@";
58ebc7fa 305 eval qq{sub ${singular}s {
306 my (\$self, \@args) = \@_;
307 while (my (\$this_key, \$this_value) = splice(\@args, 0, 2)) {
3f9899e5 308 \$self->{${name}}{\$this_key} = \$this_value;
58ebc7fa 309 }
310 return \$self;
311 }; 1 } or die "Method builder failed for ${singular}s: $@";
3f9899e5 312 eval qq{sub ${singular}_list { sort keys %{\$_[0]->{\$name}} }; 1; }
313 or die "Method builder failed for ${singular}_list: $@";
d390df44 314 }
315}
34570093 316
a17df223 317sub statement_list { sort keys %{$_[0]->{clauses_of}} }
54a2a1e5 318
34570093 319sub clauses_of {
320 my ($self, $of, @clauses) = @_;
321 unless (@clauses) {
322 return @{$self->{clauses_of}{$of}||[]};
323 }
ee706e89 324 if (ref($clauses[0]) eq 'CODE') {
325 @clauses = $self->${\($clauses[0])}(@{$self->{clauses_of}{$of}||[]});
326 }
34570093 327 $self->{clauses_of}{$of} = \@clauses;
328 return $self;
329}
330
331sub clone {
332 my ($self) = @_;
333 bless(
334 {
335 (map +($_ => (
336 ref($self->{$_}) eq 'HASH'
337 ? { %{$self->{$_}} }
338 : $self->{$_}
339 )), keys %$self),
340 },
341 ref($self)
342 );
343}
344
bbe638af 3451;