... | ... |
@@ -1,527 +0,0 @@ |
1 |
-0.1710 |
|
2 |
- - use more DBIx::Custom information in sub modules to decrease bugs |
|
3 |
- (very sorry, this change can't keep backword compatible, |
|
4 |
- but maybe no effects, |
|
5 |
- because the attributes is automatically set by DBIx::Custom, not user). |
|
6 |
- - Fixed fisrt executed where clause failed in some condition. |
|
7 |
-0.1709 |
|
8 |
- - fixed named placeholder bug and added escape syntax |
|
9 |
-0.1708 |
|
10 |
- - improved execute method performance |
|
11 |
-0.1707 |
|
12 |
- - I call :title named placeholder, stoping calling it parameter |
|
13 |
- - removed some EXPERIMENTAL status |
|
14 |
- - fixed performance |
|
15 |
-0.1706 |
|
16 |
- - Added execute method's query option document |
|
17 |
- You can get more performance. |
|
18 |
- - DBIx::Custom::Query table and filters attribute method and |
|
19 |
- filter method is DEPRECATED! |
|
20 |
- because I think query object must have only the information |
|
21 |
- for statement handle caching. |
|
22 |
-0.1705 |
|
23 |
- - insert and update method's param can set constant value by scalara reference |
|
24 |
- such as {date => \"NOW()"} This is EXPERIMENTAL. |
|
25 |
-0.1704 |
|
26 |
- - added quote method's two character support like [] |
|
27 |
- for Microsoft SQL Server and Access |
|
28 |
- - added EXPERIMENTAL parameter new syntax :name{operator} |
|
29 |
-0.1703 |
|
30 |
- - added EXPERIMENTAL join new syntax. |
|
31 |
-0.1702 |
|
32 |
- - removed EXPERIMENTAL status of some methods. |
|
33 |
- - fixed some join bug |
|
34 |
-0.1701 |
|
35 |
- - added DBIx::Cusotm::Order prepend method automatically quoted syntax |
|
36 |
- - simplified arguments check |
|
37 |
- - added EXPERIMENTAL each_table method |
|
38 |
- - select method column option [COLUMN, as => ALIAS] format is DEPRECATED! |
|
39 |
- changed to [COLUMN => ALIAS] |
|
40 |
- - added EXPERIMENTAL DBIx::Custom::Result header method |
|
41 |
- - added EXPERIMENTAL last_sql attribute method |
|
42 |
-0.1700 |
|
43 |
- - fixed end_filter DEPRECATED warnings bug |
|
44 |
-0.1699 |
|
45 |
- - added tag_parse attribute. |
|
46 |
- - added EXPERIMENTAL order method |
|
47 |
- - added EXPERIMENTAL DBIx::Custom::Order module |
|
48 |
- - changed backword compatible policy |
|
49 |
- ------------------------------------------------------------------------ |
|
50 |
- If a functionality is DEPRECATED, you can know it by DEPRECATED warnings |
|
51 |
- except for attribute method. |
|
52 |
- You can check all DEPRECATED functionalities by document. |
|
53 |
- DEPRECATED functionality is removed after five years, |
|
54 |
- but if at least one person use the functionality and tell me that thing |
|
55 |
- I extend one year each time you tell me it. |
|
56 |
- |
|
57 |
- EXPERIMENTAL functionality will be changed without warnings. |
|
58 |
- ------------------------------------------------------------------------ |
|
59 |
-0.1698 |
|
60 |
- - fixed DBIx::Custom::Where to_string method small bug |
|
61 |
- - added EXPERIMENTAL execute method table_alias option |
|
62 |
-0.1697 |
|
63 |
- - added EXPERIMENTAL map_param method |
|
64 |
-0.1696 |
|
65 |
- - added new argument format update, delete, select method where option |
|
66 |
- - create_query is DEPRECATED! use query option of each method instead. |
|
67 |
- - added EXPERIMENTAL insert, update, and select method prefix option |
|
68 |
- - fixed small insert, update, delete, select method id option bug |
|
69 |
-0.1695 |
|
70 |
- - changed EXPERIMENTAL DBIx::Custom::Result type_rule_off method argument |
|
71 |
- - added EXPERIMENTAL DBIx::Custom::Result type_rule_on method |
|
72 |
- - changed EXPERIMENTAL DBIx::Custom::Result type_rule1_off method argument |
|
73 |
- - added EXPERIMENTAL DBIx::Custom::Result type_rule1_on method |
|
74 |
- - changed EXPERIMENTAL DBIx::Custom::Result type_rule2_off method argument |
|
75 |
- - added EXPERIMENTAL DBIx::Custom::Result type_rule2_on method |
|
76 |
- - changed EXPERIMENTAL DBIx::Custom::Result filter_off method argument |
|
77 |
- - added EXPERIMENTAL DBIx::Custom::Result filter_on method |
|
78 |
-0.1694 |
|
79 |
- - EXPERIMENTAL type_rule argument format is changed |
|
80 |
- - DBIx::Custom::Result type_rule method on setting return self |
|
81 |
- - reserved_word_quote is DEPRECATED! this is renamed to quote |
|
82 |
- - DBIx::Custom::Model type attribute is DEPRECATED! |
|
83 |
- this is renamed to bind_type. |
|
84 |
-0.1693 |
|
85 |
- - separate DBIx::Custom type_rule from filter |
|
86 |
- - DBIx::Custom::Model filter attrribute is DEPRECATED! |
|
87 |
- - DBIx::Custom::Model name attribute is DEPRECATED! |
|
88 |
- - removed EXPERIMENTAL DBIx::Custom::Model alias_table |
|
89 |
- - added DBIx::Custom column method's table option |
|
90 |
- - separate DBIx::Custom::Result type_rule from filter again |
|
91 |
-0.1692 |
|
92 |
- - removed EXPERIMENTAL DBIx::Model result_filter |
|
93 |
- - DBIx::Custom::Result filter override type_rule |
|
94 |
- - added EXPERIMENTAL DBIx::Custom::Result type_rule |
|
95 |
- - added EXPERIMENTAL available_type_name method |
|
96 |
- - EXPERIMENTAL type_rule_off is not passed form execute method |
|
97 |
- to DBIx::Custom::Result object |
|
98 |
-0.1691 |
|
99 |
- - DBIx::Custom::Result end_filter, remove_filter, remove_end_filter is DEPRECATED! |
|
100 |
- - apply_filter is DEPRECATED! |
|
101 |
- - EXPERIMETAL column method and table_alias think about "-" separator |
|
102 |
- - EXPERIMTANL column method think about separator |
|
103 |
- - removed EXPERIMENTAL col method. |
|
104 |
- - added EXPERIMENTAL separater method |
|
105 |
- - added EXPERIMENTAL select prefix option. |
|
106 |
- - fixed bug that data_source DEPRECATED warnings pirnt STDERR |
|
107 |
- - fixed bug that type_rule from option can't receive filter name |
|
108 |
-0.1690 |
|
109 |
- - use latest Object::Simple features |
|
110 |
-0.1689 |
|
111 |
- - added EXPERIMENTAL available_data_type |
|
112 |
- - simplified type_rule |
|
113 |
- - changed type_rule arguments format |
|
114 |
- - added EXPERIMENTAL DBIx::Custom::Model result_filter attribute |
|
115 |
- - added EXPERIMETNAL DBIx::Custom::Result filter_off method |
|
116 |
- - EXPERIMENTAL type_rule can receive filter name |
|
117 |
-0.1688 |
|
118 |
- - fixed bug that model insert, update, delete select can't |
|
119 |
- odd number arguments |
|
120 |
- - improved type_rule method |
|
121 |
-0.1687 |
|
122 |
- - added EXPERIMENTAL type_rule method |
|
123 |
- - added EXPERIMENTAL execute() type_rule_off option |
|
124 |
- - execute method can second argument as parameter |
|
125 |
-0.1686 |
|
126 |
- - select() column option can receive array reference in array. |
|
127 |
- This is EXPERIMENTAL |
|
128 |
- - select() EXPERIMETNAL column option hash format |
|
129 |
- return table.column, not table__column |
|
130 |
- - added EXPERIMENTAL col method. |
|
131 |
- - set reserved_word_quote automatically from driver name |
|
132 |
-0.1685 |
|
133 |
- - insert_at, update_at, delete_at, select_at is DEPRECATED! |
|
134 |
- use insert, update, delete, select method and id option. |
|
135 |
- - insert, insert_at, update, update_at can receive odd number arguments, |
|
136 |
- first one is parameter. |
|
137 |
-0.1684 |
|
138 |
- - added DBIx::Custom::Result all method, this is alias for fetch_hash_all |
|
139 |
- - added DBIx::Custom::Result one method, this is alias for fetch_hash_first |
|
140 |
- - DBIx::Custom::Result fetch_hash_first can recieve argument |
|
141 |
- - select() column option can receive hash reference. This is EXPERIMENTAL |
|
142 |
- - update_param_tag is DEPRECATED! use update_param instead. |
|
143 |
- - insert_param_tag is DEPRECATED! use insert_param instead. |
|
144 |
- - assing_param_tag is DEPRECATED! use assign_param instead. |
|
145 |
- - Tag system such as {? title}, {= title} is DEPRECATED! |
|
146 |
- and added paramter system such as :title. |
|
147 |
-0.1683 |
|
148 |
- - data_source is DEPRECATED! It is renamed to dsn |
|
149 |
-0.1682 |
|
150 |
- - improved debug message |
|
151 |
- - fixed merge_param bug |
|
152 |
-0.1681 |
|
153 |
- - added EXPERIMENTAL assign_tag() method |
|
154 |
-0.1680 |
|
155 |
- - DEPRECATED select() param option, this is renamed to where_param |
|
156 |
- - added select(), update(), and delete() where_param option |
|
157 |
-0.1679 |
|
158 |
- - added EXPERIMENTAL select() wrap option to support Oracle ROWNUM |
|
159 |
-0.1678 |
|
160 |
- - DBIx::Custom::Model filter attribute can receive hash reference |
|
161 |
- - DBIx::Custom::Where clause attribute can receive clause without column name |
|
162 |
- - improved error messages |
|
163 |
-0.1677 |
|
164 |
- - improved table search in column and join clause |
|
165 |
- - DEPRECATED table tag. use table option. |
|
166 |
-0.1676 |
|
167 |
- - fixed test bug |
|
168 |
-0.1675 |
|
169 |
- - removed DEPRECATED DBIx::Custom::MySQL and DBIx::Custom::SQLite |
|
170 |
- these implementations remine in https://github.com/yuki-kimoto/DBIx-Custom/wiki |
|
171 |
- for some users. |
|
172 |
- - removed EXPERIMENTAL replace(). |
|
173 |
- - removed EXPERIMENTAL mark from many methods. |
|
174 |
-0.1674 |
|
175 |
- - fixed test bug |
|
176 |
-0.1673 |
|
177 |
- - fixed dbh() method bug. |
|
178 |
-0.1672 |
|
179 |
- - removed EXPERIMENTAL Prefork server safe implementation, my implementation is very buggy. |
|
180 |
- - added EXPERIMETNAL connector() attribute. |
|
181 |
- - change retern value to array refrence of EXPERIMENTAL replace() |
|
182 |
-0,1671 |
|
183 |
- - added environment variable DBIX_CUSTOM_DEBUG |
|
184 |
-0.1670 |
|
185 |
- - removed EXPERIMETNAL select() column hash option. it's a little complex. |
|
186 |
- - added EXPERIMENTAL select() param option. |
|
187 |
- - added EXPERIMENTAL replace(). |
|
188 |
-0.1669 |
|
189 |
- - renamed update_param to update_param_tag, update_param is DEPRECATED! |
|
190 |
- - renamed insert_param to insert_param_tag, insert_param is DEPRECATED! |
|
191 |
-0.1668 |
|
192 |
- - added EXPERIMENTAL update_param no_set option. |
|
193 |
- - added EXPERIMENTAL reserved_word_quote attribute. |
|
194 |
-0.1666 |
|
195 |
- - removed from cache() and cache_method() document for a while and cache() value |
|
196 |
- become 0 because I find something bug. |
|
197 |
- - create_model() return model. |
|
198 |
- - added document of hash filter |
|
199 |
- - adeed EXPERIMENTAL DBIx::Custom::Model method() |
|
200 |
-0.1665 |
|
201 |
- - removed EXPERIMETNAL flag from insert_at(), update_at(), delete_at(), select_at(), insert_param(), not_exists(), select()'s query option, update_param(), where, table tag, each column, safety_character, DBIx::Where, where(). |
|
202 |
- - added EXPERIMETNAL create_model() |
|
203 |
-0.1664 |
|
204 |
- - where can recieve array refrence, which contains where cluase and paramter. |
|
205 |
-0.1663 |
|
206 |
- - added EXPERIMENTAL type() attribute to DBIx::Custom::Model |
|
207 |
- - added EXPERIMENTAL bind_param_option can set bind_param option |
|
208 |
- to insert(), update(), delete(), select(), insert_at(), |
|
209 |
- update_at(), delete_at(), select_at(), delete_all(), update_all() |
|
210 |
-0.1662 |
|
211 |
- - removed EXPERIMENTAL DBIx::Custom::Model column_clause |
|
212 |
- - added EXPERIMENTAL column() |
|
213 |
- - added EXPERIMENTAL mycolumn() |
|
214 |
-0.1661 |
|
215 |
- - added EXPERIMENTAL DBIx::Custom::Model table_alias attribute |
|
216 |
- - added EXPERIMENTAL DBIx::Custom::Model mycolumn() |
|
217 |
- - added EXPERIMENTAL DBIx::Custom::Model column() |
|
218 |
- - fixed autoloading bug |
|
219 |
- - added EXPERIMETNAL select() prepend table option |
|
220 |
- - added EXPERIMETNAL select() column table option |
|
221 |
- - added EXPERIMETNAL select() column all option |
|
222 |
- - removed EXPERIMETNAL select() all_column option |
|
223 |
- - removed EXPERIMENTAL view() |
|
224 |
-0.1660 |
|
225 |
- - added EXPERIMENTAL DBIx::Custom::Model view() |
|
226 |
- - added EXPERIMENTAL view() |
|
227 |
- - DBIx::Custom::Model inherit DBIx::Custom |
|
228 |
- - removed EXPERIMETNAL DBIx::Custom::Model method() |
|
229 |
- - added table choice feature to select() EXPERIMENTAL all_column option |
|
230 |
- - removed EXPERIMENTAL DBIx::Custom::Model column attribute for side effect |
|
231 |
-0.1659 |
|
232 |
- - EXPERIMETAL fork safety implementaion. |
|
233 |
- - removed EXPERIMENTAL selection |
|
234 |
- - added select() all_column option |
|
235 |
-0.1658 |
|
236 |
- - added EXPERIMENTAL DBIx::Custom::Model column() prefix option. |
|
237 |
- - fixed select_at join column invalid bug |
|
238 |
- - added DBIx::Custom::Model column() attribute |
|
239 |
-0.1657 |
|
240 |
- - remaned EXPERIMENTAL safty_charcter to safty_name |
|
241 |
- - safty_charcter is changed, set only one character regex. |
|
242 |
-0.1656 |
|
243 |
- - fixed some select() join opition bug |
|
244 |
-0.1655 |
|
245 |
- - added EXPERIMENTAL DBIx::Custom::Model join attribute |
|
246 |
- - added EXPERIMENTAL select() join option |
|
247 |
- - deprecated select() relation option |
|
248 |
- - added EXPERIMENTAL update_param and insert_param |
|
249 |
- - remove EXPERIMENTAL DBIx::Custom::Model relation |
|
250 |
-0.1654 |
|
251 |
- - selection can contain where clause. |
|
252 |
-0.1653 |
|
253 |
- - added EXPERIMENTAL DBIx::Custom::Result remove_filter() |
|
254 |
- - added EXPERIMENTAL DBIx::Custom::Result remove_end_filter() |
|
255 |
- - added EXPERIMENTAL DBIx::Custom::Model insert_at() |
|
256 |
- - added EXPERIMENTAL insert_at() |
|
257 |
- - improved error message |
|
258 |
-0.1652 |
|
259 |
- - all filter can receive array reference and receiving hash reference is DEPRECATED! |
|
260 |
-0.1651 |
|
261 |
- - add EXPERIMENTAL DBIx::Custom::Model filter attribute. |
|
262 |
-0.1650 |
|
263 |
- - add EXPERIMENTAL DBIx::Custom::Model name() attribute |
|
264 |
-0.1649 |
|
265 |
- - add EXPERIMENTAL DBIx::Custom::Model column_clause() method. |
|
266 |
- - select method column option can receive string. |
|
267 |
- - DBIx::Custom::Model select() and select_at() think about relation attirbute |
|
268 |
-0.1648 |
|
269 |
- - add EXPERIMENTAL DBIx::Custom::Model relation() attribute |
|
270 |
- - add EXPERIMENTAL update_at(), delete_at(), select_at() |
|
271 |
- - add EXPERIMENTAL setup_model() |
|
272 |
- - add EXPERIMENTAL DBIx::Custom::Model columns attirbute |
|
273 |
- - add EXPERIMENTAL DBIx::Custom::Model foreign_key() attribute |
|
274 |
- - add EXPERIMENTAL models() attribute |
|
275 |
-0.1647 |
|
276 |
- - add default_dbi_option() |
|
277 |
-0.1646 |
|
278 |
- - add feture. all model class in namespace is included by include_model |
|
279 |
- - rename EXPERIMENTAL include_table to include_model |
|
280 |
- - rename EXPERIMENTAL table to model |
|
281 |
- - rename EXPERIMENTAL DBIx::Custom::Table to DBIx::Custom::Model |
|
282 |
- - remame EXPERIMENTAL DBIx::Custom::Table::name() to DBIx::Custom::Model::table(); |
|
283 |
-0.1645 |
|
284 |
- - removed EXPERIMENTAL base_table() for class expandability. |
|
285 |
- - EXPERIMENTAL table() can't set table object any more. |
|
286 |
- - added EXPERIMENTAL include_table(). |
|
287 |
-0.1644 |
|
288 |
- - update pod |
|
289 |
-0.1643 |
|
290 |
- - add EXPERIMENTAL selection option to select() |
|
291 |
- - add EXPERIMENTAL table tag |
|
292 |
- - fix bug : filter can't overwirite undef value. |
|
293 |
- - add EXPERIMENTAL feature to apply_filter(). you can apply end filter. |
|
294 |
- - add EXPERIMENTAL feature to apply_filter(). TABLE__COLUMN is filterded now. |
|
295 |
-0.1642 |
|
296 |
- - removed EXPERIMENTAL DBIx::Custom::Table base() method |
|
297 |
- - table created by tabled method can call base_$method correponding to base_table's one |
|
298 |
-0.1641 |
|
299 |
- - select() where can't receive array reference to prevend SQL injection easily(not backward compatible. sorry. use where() instead) |
|
300 |
- - added EXPERIMENTAL safety_column_name attribute |
|
301 |
- - fix SQL injection security hole about column name |
|
302 |
-0.1640 |
|
303 |
- - autoload DBI method |
|
304 |
- - removed EXPERIMENTAL expand |
|
305 |
-0.1639 |
|
306 |
- - improved delete() and update() where option. you can use DBIx::Custom::Where object |
|
307 |
- - added EXPERIMENTAL not_exists() |
|
308 |
-0.1638 |
|
309 |
- - table object call dbi object method if not found method. |
|
310 |
- - added EXPERIMENTAL base_table attribute and removed EXPERIMENTAL table_class attribute |
|
311 |
- - renamed helper to method. |
|
312 |
- - added EXPERIMENTAL DBIx::Custom::Result::stash() |
|
313 |
- - renamed EXPERIMENTAL DBIx::Custom::Table helper to method |
|
314 |
-0.1637 |
|
315 |
- - renamed dbi_options to dbi_option. dbi_options is available, but deprecated. |
|
316 |
- - renamed DBIx::Custom::TagProcessor to DBIx::Custom::Tag, and function names is cleanuped. |
|
317 |
- - renamed register_tag_processor to register_tag. register_tag_processor is available, but deprecated. |
|
318 |
- - renamed tag_processors to tags. tag_prosessors is available, but deprecated. |
|
319 |
- - improved error message |
|
320 |
- - build all clause if param is undefined. |
|
321 |
- - each_column callback receive self as first argument. |
|
322 |
- - removed EXPERIMENTAL txn_scope |
|
323 |
-0.1636 |
|
324 |
- - added tests and cleanup |
|
325 |
-0.1635 |
|
326 |
- - renamed iterate_all_columns to each_column |
|
327 |
-0.1634 |
|
328 |
- - became more useful where method |
|
329 |
- - changed DBIx::Custom::Where greatly |
|
330 |
-0.1633 |
|
331 |
- - fixed test |
|
332 |
-0.1632 |
|
333 |
- - added EXPERIMENTAL where method |
|
334 |
- - added EXPERIMENTAL DBIx::Custom::Where. |
|
335 |
- - removed DBIx::Custom::Or |
|
336 |
-0.1631 |
|
337 |
- - added EXPERIMENTAL DBIx::Custom::Result end_filter method |
|
338 |
- - EXPERIMENTAL extended select method's where option |
|
339 |
- - fix select method empty where failed bug |
|
340 |
- - added EXPERIMENTAL suger method query option |
|
341 |
- - added EXPERIMENTAL or method |
|
342 |
-0.1630 |
|
343 |
- - fix test bug |
|
344 |
-0.1629 |
|
345 |
- - renamed auto_filter to apply_filter |
|
346 |
- - changed apply_filter method arguments |
|
347 |
- - deprecated cache_method |
|
348 |
-0.1628 |
|
349 |
- - remove DBIx::Custom::Model |
|
350 |
- - move table method and table_class attribute to DBIx::Custom |
|
351 |
- - added examples |
|
352 |
- - fixed connect method bug |
|
353 |
-0.1627 |
|
354 |
- - added insert, update, update_all, delete, delete_all, select method to DBIx::Custom::Table |
|
355 |
- - added EXPERIMENTAL txn_scope |
|
356 |
-0.1626 |
|
357 |
- - simplified DBIx::Custom::Model and DBIx::Custom::Table |
|
358 |
-0.1625 |
|
359 |
- - added EXPERIMENTAL DBIx::Custom::Model and DBIx::Custom::Table |
|
360 |
-0.1624 |
|
361 |
- - added EXPERIMENTAL iterate_all_columns method. |
|
362 |
-0.1623 |
|
363 |
- - added EXPERIMENTAL auto_filter method |
|
364 |
- - deprecated default_bind_filter and default_fetch_filter because these are global effect. |
|
365 |
- - changed defautl_bind_filter and default_fetch_filter attributes to methods. |
|
366 |
- - changed DBIx::Custom::Result default_filter attribute to method |
|
367 |
- - changed DBIx::Custom::Result filter attribute to method. |
|
368 |
- - filter_check is always done for usability |
|
369 |
-0.1622 |
|
370 |
- - deprecated DBIx::Custom::SQLite and DBIx::Custom::MySQL |
|
371 |
- - added dbi_options attribute |
|
372 |
- - checked attributes passed to connect method |
|
373 |
-0.1621 |
|
374 |
- - cleanup (removed undocumented features) |
|
375 |
-0.1620 |
|
376 |
- - updated document |
|
377 |
-0.1619 |
|
378 |
- - updated document |
|
379 |
- - added EXPERIMENTAL expand method |
|
380 |
-0.1618 |
|
381 |
- - added helper method |
|
382 |
- - added begin_work, commit, and rollback method |
|
383 |
-0.1617 |
|
384 |
- - L<DBIx::Custom> is now stable. APIs keep backword compatible in the feature. |
|
385 |
-0.1616 |
|
386 |
- - removed EXPERIMENTAL register_method(), and methods attribute, because it is too magical |
|
387 |
-0.1615 |
|
388 |
- - fixed DBIx::Custom::QueryBuilder build_query() bug |
|
389 |
- - required Perl 5.008001 to use @CARP_NOT |
|
390 |
-0.1614 |
|
391 |
- - removed DBIx::Custom::Query start_tag and end tag attributes |
|
392 |
- - enable escaping '{' and '}' in the source of SQL |
|
393 |
- - fixed Carp Carp trust relationship |
|
394 |
-0.1613 |
|
395 |
- - added EXPERIMENTAL register_method() method |
|
396 |
- - added EXPERIMENTAL methods attribute |
|
397 |
-0.1612 |
|
398 |
- - added tests |
|
399 |
- - updated document |
|
400 |
- - removed DBIx::Custom::SQLite last_insert_rawid() mehtod(not backword compatible) |
|
401 |
- - removed DBIx::Custom::MySQL last_insert_id() method(not backword compatible) |
|
402 |
-0.1611 |
|
403 |
- - renamed update tag to update_param |
|
404 |
- - renamed insert tag to insert_param |
|
405 |
- - renamed sql_builder to query_builder |
|
406 |
-0.1610 |
|
407 |
- - added filter_check attribute. |
|
408 |
-0.1609 |
|
409 |
- - updated document. |
|
410 |
-0.1608 |
|
411 |
- - update document |
|
412 |
- - renamed DBIx::Custom::QueryBuilder::TagProcessors functions(not backword compatible) |
|
413 |
-0.1607 |
|
414 |
- - where argument of select() method can specify array(string, parameters) |
|
415 |
- - renamed build_query() to create_query()(not backword compatible) |
|
416 |
-0.1606 |
|
417 |
- - fix testing bug |
|
418 |
-0.1605 |
|
419 |
- - remove DBIx::Custom::QueryBuilder::tag_syntax() (not backword compatible) |
|
420 |
- - renamed DBIx::Custom::TagProcessor to DBIx::Custom::TagProcessors (not backword compatible) |
|
421 |
- - changed arguments of tag processor(not backword compatible) |
|
422 |
- - renamed DBIx::Custom::QueryBuilder::TagProcessors functions(not backword compatible) |
|
423 |
-0.1604 |
|
424 |
- - changed argument of tag processor(not backword compatible) |
|
425 |
- - renamed default_query_filter to default_bind_filter(not backword compatible) |
|
426 |
- - renamed DBIx::Custom::SQLTemplate to DBIx::Custom::SQLBuilder(not backword compatible) |
|
427 |
- - renamed create_query to build_query(not backword compatible) |
|
428 |
- - renamed sql_template to sql_builder(not backword compatible) |
|
429 |
- - removed DESTROY method(not backword compatible) |
|
430 |
- - removed disconnect method(not backword compatible) |
|
431 |
- - fixed DBIx::Custom::MySQL connect_memory |
|
432 |
-0.1603 |
|
433 |
- - removed DBIx::Custom commit method (not backword compatible) |
|
434 |
- - removed DBIx::Custom rollback method (not backword compatible) |
|
435 |
- - removed DBIx::Custom auto_commit method (not backword compatible) |
|
436 |
-0.1602 |
|
437 |
- - added cache_method attribute |
|
438 |
-0.1601 |
|
439 |
- - added cache attribute |
|
440 |
- - select, insert, update, update_all, delete, delete_all, execute only receive hash argument(not backword compatible) |
|
441 |
-0.1503 |
|
442 |
- - removed reconnect method |
|
443 |
- - removed connected method |
|
444 |
- - removed reconnect_memroy method |
|
445 |
- - renamed fetch_single to fetch_first |
|
446 |
- - renamed fetch_hash_single to fetch_hash_first |
|
447 |
- - updated document |
|
448 |
-0.1502 |
|
449 |
- - added commit method |
|
450 |
- - added rollback method |
|
451 |
- - changed select argument, added relation option |
|
452 |
- - moved host attribute to DBIx::Custom::MySQL |
|
453 |
- - moved port attribute to DBIx::Custom::MySQL |
|
454 |
- - moved database attribute to DBIx::Custom::MySQL and DBIx::Custom::SQLite |
|
455 |
-0.1501 |
|
456 |
- - removed register_format() |
|
457 |
- - removed formats() |
|
458 |
- - removed run_transaction() |
|
459 |
- - removed create_table() |
|
460 |
- - removed drop_table() |
|
461 |
- - changed select() arguments |
|
462 |
- - changed insert() arguments |
|
463 |
- - changed update() arguments |
|
464 |
- - changed update_all() arguments |
|
465 |
- - changed delete() arguments |
|
466 |
- - changed delete_all() arguments |
|
467 |
- - changed execute() arguments |
|
468 |
-0.1402 |
|
469 |
- - remove finish(), error() |
|
470 |
- - can receive code ref to filter() |
|
471 |
- - renamed resist to register |
|
472 |
-0.1401 |
|
473 |
- - renamed fetch_rows to fetch_multi |
|
474 |
- - renamed fetch_hash_rows to fetch_hash_multi |
|
475 |
-0.1301 |
|
476 |
- - Changed many(not backword compatible) |
|
477 |
-0.1201 |
|
478 |
- - Changed many(not backword compatible) |
|
479 |
-0.1101 |
|
480 |
- - rename DBIx::Custom::SQLite last_insert_id to last_insert_rowid |
|
481 |
-0.1001 |
|
482 |
- - remove run_transaction(). |
|
483 |
- - add transaction() and DBIx::Custom::Transaction |
|
484 |
- - rename fetch_first to fetch_single |
|
485 |
- - rename fetch_hash_first to fetch_hash_single |
|
486 |
-0.0906 |
|
487 |
- - fix some bug |
|
488 |
-0.0905 |
|
489 |
- - catch up with Object::Simple update |
|
490 |
-0.0904 |
|
491 |
- - cleanup |
|
492 |
-0.0903 |
|
493 |
- - catch up with Object::Simple update |
|
494 |
-0.0902 |
|
495 |
- - cleanup |
|
496 |
-0.0901 |
|
497 |
- - DBIx::Basic filter 'encode_utf8' utf8::upgrade process is deleted |
|
498 |
-0.0801 |
|
499 |
- - add 'create_table', 'drop_table' methods |
|
500 |
-0.0701 |
|
501 |
- - rename sql_template to sql_tmpl (not backword compatible) |
|
502 |
- - rename dbi_options to options (not backword compatible) |
|
503 |
-0.0605 |
|
504 |
- - fix encode_utf8 filter |
|
505 |
-0.0604 |
|
506 |
- - fix timeformat tests |
|
507 |
-0.0603 |
|
508 |
- - fix cache system bug |
|
509 |
-0.0602 |
|
510 |
- - update document |
|
511 |
-0.0601 |
|
512 |
- - bind_filter argument is changed to ($value, $key, $dbi, $infos) (not backword compatible) |
|
513 |
- - fetch_filter argument is changed to ($value, $key, $dbi, $infos) (not backword compatible) |
|
514 |
- - run_transaction argument is changed to ($dbi) |
|
515 |
-0.0502 |
|
516 |
- - update document |
|
517 |
-0.0501 |
|
518 |
- - packaging DBIx::Custom::Result DBIx::Custom::Query DBIx::Custom::MySQL DBIx::Custom::SQLite DBIx::Custom::SQL::Template |
|
519 |
-0.0401 |
|
520 |
- - catch up with DBIx::Custom::Result version up |
|
521 |
-0.0301 |
|
522 |
- - exchange filter argument 'key', 'value' (not backword compatible) |
|
523 |
-0.0201 |
|
524 |
- - rename tranzaction to transaction |
|
525 |
- - add filter_off |
|
526 |
-0.0101 |
|
527 |
- - First release |
... | ... |
@@ -1,527 +0,0 @@ |
1 |
-0.1710 |
|
2 |
- - use more DBIx::Custom information in sub modules to decrease bugs |
|
3 |
- (very sorry, this change can't keep backword compatible, |
|
4 |
- but maybe no effects, |
|
5 |
- because the attributes is automatically set by DBIx::Custom, not user). |
|
6 |
- - Fixed fisrt executed where clause failed in some condition. |
|
7 |
-0.1709 |
|
8 |
- - fixed named placeholder bug and added escape syntax |
|
9 |
-0.1708 |
|
10 |
- - improved execute method performance |
|
11 |
-0.1707 |
|
12 |
- - I call :title named placeholder, stoping calling it parameter |
|
13 |
- - removed some EXPERIMENTAL status |
|
14 |
- - fixed performance |
|
15 |
-0.1706 |
|
16 |
- - Added execute method's query option document |
|
17 |
- You can get more performance. |
|
18 |
- - DBIx::Custom::Query table and filters attribute method and |
|
19 |
- filter method is DEPRECATED! |
|
20 |
- because I think query object must have only the information |
|
21 |
- for statement handle caching. |
|
22 |
-0.1705 |
|
23 |
- - insert and update method's param can set constant value by scalara reference |
|
24 |
- such as {date => \"NOW()"} This is EXPERIMENTAL. |
|
25 |
-0.1704 |
|
26 |
- - added quote method's two character support like [] |
|
27 |
- for Microsoft SQL Server and Access |
|
28 |
- - added EXPERIMENTAL parameter new syntax :name{operator} |
|
29 |
-0.1703 |
|
30 |
- - added EXPERIMENTAL join new syntax. |
|
31 |
-0.1702 |
|
32 |
- - removed EXPERIMENTAL status of some methods. |
|
33 |
- - fixed some join bug |
|
34 |
-0.1701 |
|
35 |
- - added DBIx::Cusotm::Order prepend method automatically quoted syntax |
|
36 |
- - simplified arguments check |
|
37 |
- - added EXPERIMENTAL each_table method |
|
38 |
- - select method column option [COLUMN, as => ALIAS] format is DEPRECATED! |
|
39 |
- changed to [COLUMN => ALIAS] |
|
40 |
- - added EXPERIMENTAL DBIx::Custom::Result header method |
|
41 |
- - added EXPERIMENTAL last_sql attribute method |
|
42 |
-0.1700 |
|
43 |
- - fixed end_filter DEPRECATED warnings bug |
|
44 |
-0.1699 |
|
45 |
- - added tag_parse attribute. |
|
46 |
- - added EXPERIMENTAL order method |
|
47 |
- - added EXPERIMENTAL DBIx::Custom::Order module |
|
48 |
- - changed backword compatible policy |
|
49 |
- ------------------------------------------------------------------------ |
|
50 |
- If a functionality is DEPRECATED, you can know it by DEPRECATED warnings |
|
51 |
- except for attribute method. |
|
52 |
- You can check all DEPRECATED functionalities by document. |
|
53 |
- DEPRECATED functionality is removed after five years, |
|
54 |
- but if at least one person use the functionality and tell me that thing |
|
55 |
- I extend one year each time you tell me it. |
|
56 |
- |
|
57 |
- EXPERIMENTAL functionality will be changed without warnings. |
|
58 |
- ------------------------------------------------------------------------ |
|
59 |
-0.1698 |
|
60 |
- - fixed DBIx::Custom::Where to_string method small bug |
|
61 |
- - added EXPERIMENTAL execute method table_alias option |
|
62 |
-0.1697 |
|
63 |
- - added EXPERIMENTAL map_param method |
|
64 |
-0.1696 |
|
65 |
- - added new argument format update, delete, select method where option |
|
66 |
- - create_query is DEPRECATED! use query option of each method instead. |
|
67 |
- - added EXPERIMENTAL insert, update, and select method prefix option |
|
68 |
- - fixed small insert, update, delete, select method id option bug |
|
69 |
-0.1695 |
|
70 |
- - changed EXPERIMENTAL DBIx::Custom::Result type_rule_off method argument |
|
71 |
- - added EXPERIMENTAL DBIx::Custom::Result type_rule_on method |
|
72 |
- - changed EXPERIMENTAL DBIx::Custom::Result type_rule1_off method argument |
|
73 |
- - added EXPERIMENTAL DBIx::Custom::Result type_rule1_on method |
|
74 |
- - changed EXPERIMENTAL DBIx::Custom::Result type_rule2_off method argument |
|
75 |
- - added EXPERIMENTAL DBIx::Custom::Result type_rule2_on method |
|
76 |
- - changed EXPERIMENTAL DBIx::Custom::Result filter_off method argument |
|
77 |
- - added EXPERIMENTAL DBIx::Custom::Result filter_on method |
|
78 |
-0.1694 |
|
79 |
- - EXPERIMENTAL type_rule argument format is changed |
|
80 |
- - DBIx::Custom::Result type_rule method on setting return self |
|
81 |
- - reserved_word_quote is DEPRECATED! this is renamed to quote |
|
82 |
- - DBIx::Custom::Model type attribute is DEPRECATED! |
|
83 |
- this is renamed to bind_type. |
|
84 |
-0.1693 |
|
85 |
- - separate DBIx::Custom type_rule from filter |
|
86 |
- - DBIx::Custom::Model filter attrribute is DEPRECATED! |
|
87 |
- - DBIx::Custom::Model name attribute is DEPRECATED! |
|
88 |
- - removed EXPERIMENTAL DBIx::Custom::Model alias_table |
|
89 |
- - added DBIx::Custom column method's table option |
|
90 |
- - separate DBIx::Custom::Result type_rule from filter again |
|
91 |
-0.1692 |
|
92 |
- - removed EXPERIMENTAL DBIx::Model result_filter |
|
93 |
- - DBIx::Custom::Result filter override type_rule |
|
94 |
- - added EXPERIMENTAL DBIx::Custom::Result type_rule |
|
95 |
- - added EXPERIMENTAL available_type_name method |
|
96 |
- - EXPERIMENTAL type_rule_off is not passed form execute method |
|
97 |
- to DBIx::Custom::Result object |
|
98 |
-0.1691 |
|
99 |
- - DBIx::Custom::Result end_filter, remove_filter, remove_end_filter is DEPRECATED! |
|
100 |
- - apply_filter is DEPRECATED! |
|
101 |
- - EXPERIMETAL column method and table_alias think about "-" separator |
|
102 |
- - EXPERIMTANL column method think about separator |
|
103 |
- - removed EXPERIMENTAL col method. |
|
104 |
- - added EXPERIMENTAL separater method |
|
105 |
- - added EXPERIMENTAL select prefix option. |
|
106 |
- - fixed bug that data_source DEPRECATED warnings pirnt STDERR |
|
107 |
- - fixed bug that type_rule from option can't receive filter name |
|
108 |
-0.1690 |
|
109 |
- - use latest Object::Simple features |
|
110 |
-0.1689 |
|
111 |
- - added EXPERIMENTAL available_data_type |
|
112 |
- - simplified type_rule |
|
113 |
- - changed type_rule arguments format |
|
114 |
- - added EXPERIMENTAL DBIx::Custom::Model result_filter attribute |
|
115 |
- - added EXPERIMETNAL DBIx::Custom::Result filter_off method |
|
116 |
- - EXPERIMENTAL type_rule can receive filter name |
|
117 |
-0.1688 |
|
118 |
- - fixed bug that model insert, update, delete select can't |
|
119 |
- odd number arguments |
|
120 |
- - improved type_rule method |
|
121 |
-0.1687 |
|
122 |
- - added EXPERIMENTAL type_rule method |
|
123 |
- - added EXPERIMENTAL execute() type_rule_off option |
|
124 |
- - execute method can second argument as parameter |
|
125 |
-0.1686 |
|
126 |
- - select() column option can receive array reference in array. |
|
127 |
- This is EXPERIMENTAL |
|
128 |
- - select() EXPERIMETNAL column option hash format |
|
129 |
- return table.column, not table__column |
|
130 |
- - added EXPERIMENTAL col method. |
|
131 |
- - set reserved_word_quote automatically from driver name |
|
132 |
-0.1685 |
|
133 |
- - insert_at, update_at, delete_at, select_at is DEPRECATED! |
|
134 |
- use insert, update, delete, select method and id option. |
|
135 |
- - insert, insert_at, update, update_at can receive odd number arguments, |
|
136 |
- first one is parameter. |
|
137 |
-0.1684 |
|
138 |
- - added DBIx::Custom::Result all method, this is alias for fetch_hash_all |
|
139 |
- - added DBIx::Custom::Result one method, this is alias for fetch_hash_first |
|
140 |
- - DBIx::Custom::Result fetch_hash_first can recieve argument |
|
141 |
- - select() column option can receive hash reference. This is EXPERIMENTAL |
|
142 |
- - update_param_tag is DEPRECATED! use update_param instead. |
|
143 |
- - insert_param_tag is DEPRECATED! use insert_param instead. |
|
144 |
- - assing_param_tag is DEPRECATED! use assign_param instead. |
|
145 |
- - Tag system such as {? title}, {= title} is DEPRECATED! |
|
146 |
- and added paramter system such as :title. |
|
147 |
-0.1683 |
|
148 |
- - data_source is DEPRECATED! It is renamed to dsn |
|
149 |
-0.1682 |
|
150 |
- - improved debug message |
|
151 |
- - fixed merge_param bug |
|
152 |
-0.1681 |
|
153 |
- - added EXPERIMENTAL assign_tag() method |
|
154 |
-0.1680 |
|
155 |
- - DEPRECATED select() param option, this is renamed to where_param |
|
156 |
- - added select(), update(), and delete() where_param option |
|
157 |
-0.1679 |
|
158 |
- - added EXPERIMENTAL select() wrap option to support Oracle ROWNUM |
|
159 |
-0.1678 |
|
160 |
- - DBIx::Custom::Model filter attribute can receive hash reference |
|
161 |
- - DBIx::Custom::Where clause attribute can receive clause without column name |
|
162 |
- - improved error messages |
|
163 |
-0.1677 |
|
164 |
- - improved table search in column and join clause |
|
165 |
- - DEPRECATED table tag. use table option. |
|
166 |
-0.1676 |
|
167 |
- - fixed test bug |
|
168 |
-0.1675 |
|
169 |
- - removed DEPRECATED DBIx::Custom::MySQL and DBIx::Custom::SQLite |
|
170 |
- these implementations remine in https://github.com/yuki-kimoto/DBIx-Custom/wiki |
|
171 |
- for some users. |
|
172 |
- - removed EXPERIMENTAL replace(). |
|
173 |
- - removed EXPERIMENTAL mark from many methods. |
|
174 |
-0.1674 |
|
175 |
- - fixed test bug |
|
176 |
-0.1673 |
|
177 |
- - fixed dbh() method bug. |
|
178 |
-0.1672 |
|
179 |
- - removed EXPERIMENTAL Prefork server safe implementation, my implementation is very buggy. |
|
180 |
- - added EXPERIMETNAL connector() attribute. |
|
181 |
- - change retern value to array refrence of EXPERIMENTAL replace() |
|
182 |
-0,1671 |
|
183 |
- - added environment variable DBIX_CUSTOM_DEBUG |
|
184 |
-0.1670 |
|
185 |
- - removed EXPERIMETNAL select() column hash option. it's a little complex. |
|
186 |
- - added EXPERIMENTAL select() param option. |
|
187 |
- - added EXPERIMENTAL replace(). |
|
188 |
-0.1669 |
|
189 |
- - renamed update_param to update_param_tag, update_param is DEPRECATED! |
|
190 |
- - renamed insert_param to insert_param_tag, insert_param is DEPRECATED! |
|
191 |
-0.1668 |
|
192 |
- - added EXPERIMENTAL update_param no_set option. |
|
193 |
- - added EXPERIMENTAL reserved_word_quote attribute. |
|
194 |
-0.1666 |
|
195 |
- - removed from cache() and cache_method() document for a while and cache() value |
|
196 |
- become 0 because I find something bug. |
|
197 |
- - create_model() return model. |
|
198 |
- - added document of hash filter |
|
199 |
- - adeed EXPERIMENTAL DBIx::Custom::Model method() |
|
200 |
-0.1665 |
|
201 |
- - removed EXPERIMETNAL flag from insert_at(), update_at(), delete_at(), select_at(), insert_param(), not_exists(), select()'s query option, update_param(), where, table tag, each column, safety_character, DBIx::Where, where(). |
|
202 |
- - added EXPERIMETNAL create_model() |
|
203 |
-0.1664 |
|
204 |
- - where can recieve array refrence, which contains where cluase and paramter. |
|
205 |
-0.1663 |
|
206 |
- - added EXPERIMENTAL type() attribute to DBIx::Custom::Model |
|
207 |
- - added EXPERIMENTAL bind_param_option can set bind_param option |
|
208 |
- to insert(), update(), delete(), select(), insert_at(), |
|
209 |
- update_at(), delete_at(), select_at(), delete_all(), update_all() |
|
210 |
-0.1662 |
|
211 |
- - removed EXPERIMENTAL DBIx::Custom::Model column_clause |
|
212 |
- - added EXPERIMENTAL column() |
|
213 |
- - added EXPERIMENTAL mycolumn() |
|
214 |
-0.1661 |
|
215 |
- - added EXPERIMENTAL DBIx::Custom::Model table_alias attribute |
|
216 |
- - added EXPERIMENTAL DBIx::Custom::Model mycolumn() |
|
217 |
- - added EXPERIMENTAL DBIx::Custom::Model column() |
|
218 |
- - fixed autoloading bug |
|
219 |
- - added EXPERIMETNAL select() prepend table option |
|
220 |
- - added EXPERIMETNAL select() column table option |
|
221 |
- - added EXPERIMETNAL select() column all option |
|
222 |
- - removed EXPERIMETNAL select() all_column option |
|
223 |
- - removed EXPERIMENTAL view() |
|
224 |
-0.1660 |
|
225 |
- - added EXPERIMENTAL DBIx::Custom::Model view() |
|
226 |
- - added EXPERIMENTAL view() |
|
227 |
- - DBIx::Custom::Model inherit DBIx::Custom |
|
228 |
- - removed EXPERIMETNAL DBIx::Custom::Model method() |
|
229 |
- - added table choice feature to select() EXPERIMENTAL all_column option |
|
230 |
- - removed EXPERIMENTAL DBIx::Custom::Model column attribute for side effect |
|
231 |
-0.1659 |
|
232 |
- - EXPERIMETAL fork safety implementaion. |
|
233 |
- - removed EXPERIMENTAL selection |
|
234 |
- - added select() all_column option |
|
235 |
-0.1658 |
|
236 |
- - added EXPERIMENTAL DBIx::Custom::Model column() prefix option. |
|
237 |
- - fixed select_at join column invalid bug |
|
238 |
- - added DBIx::Custom::Model column() attribute |
|
239 |
-0.1657 |
|
240 |
- - remaned EXPERIMENTAL safty_charcter to safty_name |
|
241 |
- - safty_charcter is changed, set only one character regex. |
|
242 |
-0.1656 |
|
243 |
- - fixed some select() join opition bug |
|
244 |
-0.1655 |
|
245 |
- - added EXPERIMENTAL DBIx::Custom::Model join attribute |
|
246 |
- - added EXPERIMENTAL select() join option |
|
247 |
- - deprecated select() relation option |
|
248 |
- - added EXPERIMENTAL update_param and insert_param |
|
249 |
- - remove EXPERIMENTAL DBIx::Custom::Model relation |
|
250 |
-0.1654 |
|
251 |
- - selection can contain where clause. |
|
252 |
-0.1653 |
|
253 |
- - added EXPERIMENTAL DBIx::Custom::Result remove_filter() |
|
254 |
- - added EXPERIMENTAL DBIx::Custom::Result remove_end_filter() |
|
255 |
- - added EXPERIMENTAL DBIx::Custom::Model insert_at() |
|
256 |
- - added EXPERIMENTAL insert_at() |
|
257 |
- - improved error message |
|
258 |
-0.1652 |
|
259 |
- - all filter can receive array reference and receiving hash reference is DEPRECATED! |
|
260 |
-0.1651 |
|
261 |
- - add EXPERIMENTAL DBIx::Custom::Model filter attribute. |
|
262 |
-0.1650 |
|
263 |
- - add EXPERIMENTAL DBIx::Custom::Model name() attribute |
|
264 |
-0.1649 |
|
265 |
- - add EXPERIMENTAL DBIx::Custom::Model column_clause() method. |
|
266 |
- - select method column option can receive string. |
|
267 |
- - DBIx::Custom::Model select() and select_at() think about relation attirbute |
|
268 |
-0.1648 |
|
269 |
- - add EXPERIMENTAL DBIx::Custom::Model relation() attribute |
|
270 |
- - add EXPERIMENTAL update_at(), delete_at(), select_at() |
|
271 |
- - add EXPERIMENTAL setup_model() |
|
272 |
- - add EXPERIMENTAL DBIx::Custom::Model columns attirbute |
|
273 |
- - add EXPERIMENTAL DBIx::Custom::Model foreign_key() attribute |
|
274 |
- - add EXPERIMENTAL models() attribute |
|
275 |
-0.1647 |
|
276 |
- - add default_dbi_option() |
|
277 |
-0.1646 |
|
278 |
- - add feture. all model class in namespace is included by include_model |
|
279 |
- - rename EXPERIMENTAL include_table to include_model |
|
280 |
- - rename EXPERIMENTAL table to model |
|
281 |
- - rename EXPERIMENTAL DBIx::Custom::Table to DBIx::Custom::Model |
|
282 |
- - remame EXPERIMENTAL DBIx::Custom::Table::name() to DBIx::Custom::Model::table(); |
|
283 |
-0.1645 |
|
284 |
- - removed EXPERIMENTAL base_table() for class expandability. |
|
285 |
- - EXPERIMENTAL table() can't set table object any more. |
|
286 |
- - added EXPERIMENTAL include_table(). |
|
287 |
-0.1644 |
|
288 |
- - update pod |
|
289 |
-0.1643 |
|
290 |
- - add EXPERIMENTAL selection option to select() |
|
291 |
- - add EXPERIMENTAL table tag |
|
292 |
- - fix bug : filter can't overwirite undef value. |
|
293 |
- - add EXPERIMENTAL feature to apply_filter(). you can apply end filter. |
|
294 |
- - add EXPERIMENTAL feature to apply_filter(). TABLE__COLUMN is filterded now. |
|
295 |
-0.1642 |
|
296 |
- - removed EXPERIMENTAL DBIx::Custom::Table base() method |
|
297 |
- - table created by tabled method can call base_$method correponding to base_table's one |
|
298 |
-0.1641 |
|
299 |
- - select() where can't receive array reference to prevend SQL injection easily(not backward compatible. sorry. use where() instead) |
|
300 |
- - added EXPERIMENTAL safety_column_name attribute |
|
301 |
- - fix SQL injection security hole about column name |
|
302 |
-0.1640 |
|
303 |
- - autoload DBI method |
|
304 |
- - removed EXPERIMENTAL expand |
|
305 |
-0.1639 |
|
306 |
- - improved delete() and update() where option. you can use DBIx::Custom::Where object |
|
307 |
- - added EXPERIMENTAL not_exists() |
|
308 |
-0.1638 |
|
309 |
- - table object call dbi object method if not found method. |
|
310 |
- - added EXPERIMENTAL base_table attribute and removed EXPERIMENTAL table_class attribute |
|
311 |
- - renamed helper to method. |
|
312 |
- - added EXPERIMENTAL DBIx::Custom::Result::stash() |
|
313 |
- - renamed EXPERIMENTAL DBIx::Custom::Table helper to method |
|
314 |
-0.1637 |
|
315 |
- - renamed dbi_options to dbi_option. dbi_options is available, but deprecated. |
|
316 |
- - renamed DBIx::Custom::TagProcessor to DBIx::Custom::Tag, and function names is cleanuped. |
|
317 |
- - renamed register_tag_processor to register_tag. register_tag_processor is available, but deprecated. |
|
318 |
- - renamed tag_processors to tags. tag_prosessors is available, but deprecated. |
|
319 |
- - improved error message |
|
320 |
- - build all clause if param is undefined. |
|
321 |
- - each_column callback receive self as first argument. |
|
322 |
- - removed EXPERIMENTAL txn_scope |
|
323 |
-0.1636 |
|
324 |
- - added tests and cleanup |
|
325 |
-0.1635 |
|
326 |
- - renamed iterate_all_columns to each_column |
|
327 |
-0.1634 |
|
328 |
- - became more useful where method |
|
329 |
- - changed DBIx::Custom::Where greatly |
|
330 |
-0.1633 |
|
331 |
- - fixed test |
|
332 |
-0.1632 |
|
333 |
- - added EXPERIMENTAL where method |
|
334 |
- - added EXPERIMENTAL DBIx::Custom::Where. |
|
335 |
- - removed DBIx::Custom::Or |
|
336 |
-0.1631 |
|
337 |
- - added EXPERIMENTAL DBIx::Custom::Result end_filter method |
|
338 |
- - EXPERIMENTAL extended select method's where option |
|
339 |
- - fix select method empty where failed bug |
|
340 |
- - added EXPERIMENTAL suger method query option |
|
341 |
- - added EXPERIMENTAL or method |
|
342 |
-0.1630 |
|
343 |
- - fix test bug |
|
344 |
-0.1629 |
|
345 |
- - renamed auto_filter to apply_filter |
|
346 |
- - changed apply_filter method arguments |
|
347 |
- - deprecated cache_method |
|
348 |
-0.1628 |
|
349 |
- - remove DBIx::Custom::Model |
|
350 |
- - move table method and table_class attribute to DBIx::Custom |
|
351 |
- - added examples |
|
352 |
- - fixed connect method bug |
|
353 |
-0.1627 |
|
354 |
- - added insert, update, update_all, delete, delete_all, select method to DBIx::Custom::Table |
|
355 |
- - added EXPERIMENTAL txn_scope |
|
356 |
-0.1626 |
|
357 |
- - simplified DBIx::Custom::Model and DBIx::Custom::Table |
|
358 |
-0.1625 |
|
359 |
- - added EXPERIMENTAL DBIx::Custom::Model and DBIx::Custom::Table |
|
360 |
-0.1624 |
|
361 |
- - added EXPERIMENTAL iterate_all_columns method. |
|
362 |
-0.1623 |
|
363 |
- - added EXPERIMENTAL auto_filter method |
|
364 |
- - deprecated default_bind_filter and default_fetch_filter because these are global effect. |
|
365 |
- - changed defautl_bind_filter and default_fetch_filter attributes to methods. |
|
366 |
- - changed DBIx::Custom::Result default_filter attribute to method |
|
367 |
- - changed DBIx::Custom::Result filter attribute to method. |
|
368 |
- - filter_check is always done for usability |
|
369 |
-0.1622 |
|
370 |
- - deprecated DBIx::Custom::SQLite and DBIx::Custom::MySQL |
|
371 |
- - added dbi_options attribute |
|
372 |
- - checked attributes passed to connect method |
|
373 |
-0.1621 |
|
374 |
- - cleanup (removed undocumented features) |
|
375 |
-0.1620 |
|
376 |
- - updated document |
|
377 |
-0.1619 |
|
378 |
- - updated document |
|
379 |
- - added EXPERIMENTAL expand method |
|
380 |
-0.1618 |
|
381 |
- - added helper method |
|
382 |
- - added begin_work, commit, and rollback method |
|
383 |
-0.1617 |
|
384 |
- - L<DBIx::Custom> is now stable. APIs keep backword compatible in the feature. |
|
385 |
-0.1616 |
|
386 |
- - removed EXPERIMENTAL register_method(), and methods attribute, because it is too magical |
|
387 |
-0.1615 |
|
388 |
- - fixed DBIx::Custom::QueryBuilder build_query() bug |
|
389 |
- - required Perl 5.008001 to use @CARP_NOT |
|
390 |
-0.1614 |
|
391 |
- - removed DBIx::Custom::Query start_tag and end tag attributes |
|
392 |
- - enable escaping '{' and '}' in the source of SQL |
|
393 |
- - fixed Carp Carp trust relationship |
|
394 |
-0.1613 |
|
395 |
- - added EXPERIMENTAL register_method() method |
|
396 |
- - added EXPERIMENTAL methods attribute |
|
397 |
-0.1612 |
|
398 |
- - added tests |
|
399 |
- - updated document |
|
400 |
- - removed DBIx::Custom::SQLite last_insert_rawid() mehtod(not backword compatible) |
|
401 |
- - removed DBIx::Custom::MySQL last_insert_id() method(not backword compatible) |
|
402 |
-0.1611 |
|
403 |
- - renamed update tag to update_param |
|
404 |
- - renamed insert tag to insert_param |
|
405 |
- - renamed sql_builder to query_builder |
|
406 |
-0.1610 |
|
407 |
- - added filter_check attribute. |
|
408 |
-0.1609 |
|
409 |
- - updated document. |
|
410 |
-0.1608 |
|
411 |
- - update document |
|
412 |
- - renamed DBIx::Custom::QueryBuilder::TagProcessors functions(not backword compatible) |
|
413 |
-0.1607 |
|
414 |
- - where argument of select() method can specify array(string, parameters) |
|
415 |
- - renamed build_query() to create_query()(not backword compatible) |
|
416 |
-0.1606 |
|
417 |
- - fix testing bug |
|
418 |
-0.1605 |
|
419 |
- - remove DBIx::Custom::QueryBuilder::tag_syntax() (not backword compatible) |
|
420 |
- - renamed DBIx::Custom::TagProcessor to DBIx::Custom::TagProcessors (not backword compatible) |
|
421 |
- - changed arguments of tag processor(not backword compatible) |
|
422 |
- - renamed DBIx::Custom::QueryBuilder::TagProcessors functions(not backword compatible) |
|
423 |
-0.1604 |
|
424 |
- - changed argument of tag processor(not backword compatible) |
|
425 |
- - renamed default_query_filter to default_bind_filter(not backword compatible) |
|
426 |
- - renamed DBIx::Custom::SQLTemplate to DBIx::Custom::SQLBuilder(not backword compatible) |
|
427 |
- - renamed create_query to build_query(not backword compatible) |
|
428 |
- - renamed sql_template to sql_builder(not backword compatible) |
|
429 |
- - removed DESTROY method(not backword compatible) |
|
430 |
- - removed disconnect method(not backword compatible) |
|
431 |
- - fixed DBIx::Custom::MySQL connect_memory |
|
432 |
-0.1603 |
|
433 |
- - removed DBIx::Custom commit method (not backword compatible) |
|
434 |
- - removed DBIx::Custom rollback method (not backword compatible) |
|
435 |
- - removed DBIx::Custom auto_commit method (not backword compatible) |
|
436 |
-0.1602 |
|
437 |
- - added cache_method attribute |
|
438 |
-0.1601 |
|
439 |
- - added cache attribute |
|
440 |
- - select, insert, update, update_all, delete, delete_all, execute only receive hash argument(not backword compatible) |
|
441 |
-0.1503 |
|
442 |
- - removed reconnect method |
|
443 |
- - removed connected method |
|
444 |
- - removed reconnect_memroy method |
|
445 |
- - renamed fetch_single to fetch_first |
|
446 |
- - renamed fetch_hash_single to fetch_hash_first |
|
447 |
- - updated document |
|
448 |
-0.1502 |
|
449 |
- - added commit method |
|
450 |
- - added rollback method |
|
451 |
- - changed select argument, added relation option |
|
452 |
- - moved host attribute to DBIx::Custom::MySQL |
|
453 |
- - moved port attribute to DBIx::Custom::MySQL |
|
454 |
- - moved database attribute to DBIx::Custom::MySQL and DBIx::Custom::SQLite |
|
455 |
-0.1501 |
|
456 |
- - removed register_format() |
|
457 |
- - removed formats() |
|
458 |
- - removed run_transaction() |
|
459 |
- - removed create_table() |
|
460 |
- - removed drop_table() |
|
461 |
- - changed select() arguments |
|
462 |
- - changed insert() arguments |
|
463 |
- - changed update() arguments |
|
464 |
- - changed update_all() arguments |
|
465 |
- - changed delete() arguments |
|
466 |
- - changed delete_all() arguments |
|
467 |
- - changed execute() arguments |
|
468 |
-0.1402 |
|
469 |
- - remove finish(), error() |
|
470 |
- - can receive code ref to filter() |
|
471 |
- - renamed resist to register |
|
472 |
-0.1401 |
|
473 |
- - renamed fetch_rows to fetch_multi |
|
474 |
- - renamed fetch_hash_rows to fetch_hash_multi |
|
475 |
-0.1301 |
|
476 |
- - Changed many(not backword compatible) |
|
477 |
-0.1201 |
|
478 |
- - Changed many(not backword compatible) |
|
479 |
-0.1101 |
|
480 |
- - rename DBIx::Custom::SQLite last_insert_id to last_insert_rowid |
|
481 |
-0.1001 |
|
482 |
- - remove run_transaction(). |
|
483 |
- - add transaction() and DBIx::Custom::Transaction |
|
484 |
- - rename fetch_first to fetch_single |
|
485 |
- - rename fetch_hash_first to fetch_hash_single |
|
486 |
-0.0906 |
|
487 |
- - fix some bug |
|
488 |
-0.0905 |
|
489 |
- - catch up with Object::Simple update |
|
490 |
-0.0904 |
|
491 |
- - cleanup |
|
492 |
-0.0903 |
|
493 |
- - catch up with Object::Simple update |
|
494 |
-0.0902 |
|
495 |
- - cleanup |
|
496 |
-0.0901 |
|
497 |
- - DBIx::Basic filter 'encode_utf8' utf8::upgrade process is deleted |
|
498 |
-0.0801 |
|
499 |
- - add 'create_table', 'drop_table' methods |
|
500 |
-0.0701 |
|
501 |
- - rename sql_template to sql_tmpl (not backword compatible) |
|
502 |
- - rename dbi_options to options (not backword compatible) |
|
503 |
-0.0605 |
|
504 |
- - fix encode_utf8 filter |
|
505 |
-0.0604 |
|
506 |
- - fix timeformat tests |
|
507 |
-0.0603 |
|
508 |
- - fix cache system bug |
|
509 |
-0.0602 |
|
510 |
- - update document |
|
511 |
-0.0601 |
|
512 |
- - bind_filter argument is changed to ($value, $key, $dbi, $infos) (not backword compatible) |
|
513 |
- - fetch_filter argument is changed to ($value, $key, $dbi, $infos) (not backword compatible) |
|
514 |
- - run_transaction argument is changed to ($dbi) |
|
515 |
-0.0502 |
|
516 |
- - update document |
|
517 |
-0.0501 |
|
518 |
- - packaging DBIx::Custom::Result DBIx::Custom::Query DBIx::Custom::MySQL DBIx::Custom::SQLite DBIx::Custom::SQL::Template |
|
519 |
-0.0401 |
|
520 |
- - catch up with DBIx::Custom::Result version up |
|
521 |
-0.0301 |
|
522 |
- - exchange filter argument 'key', 'value' (not backword compatible) |
|
523 |
-0.0201 |
|
524 |
- - rename tranzaction to transaction |
|
525 |
- - add filter_off |
|
526 |
-0.0101 |
|
527 |
- - First release |
... | ... |
@@ -1,3203 +0,0 @@ |
1 |
-package DBIx::Custom; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-our $VERSION = '0.1711'; |
|
5 |
-use 5.008001; |
|
6 |
- |
|
7 |
-use Carp 'croak'; |
|
8 |
-use DBI; |
|
9 |
-use DBIx::Custom::Result; |
|
10 |
-use DBIx::Custom::Query; |
|
11 |
-use DBIx::Custom::QueryBuilder; |
|
12 |
-use DBIx::Custom::Where; |
|
13 |
-use DBIx::Custom::Model; |
|
14 |
-use DBIx::Custom::Tag; |
|
15 |
-use DBIx::Custom::Order; |
|
16 |
-use DBIx::Custom::Util qw/_array_to_hash _subname/; |
|
17 |
-use Encode qw/encode encode_utf8 decode_utf8/; |
|
18 |
- |
|
19 |
-use constant DEBUG => $ENV{DBIX_CUSTOM_DEBUG} || 0; |
|
20 |
-use constant DEBUG_ENCODING => $ENV{DBIX_CUSTOM_DEBUG_ENCODING} || 'UTF-8'; |
|
21 |
- |
|
22 |
-has [qw/connector dsn password quote user/], |
|
23 |
- cache => 0, |
|
24 |
- cache_method => sub { |
|
25 |
- sub { |
|
26 |
- my $self = shift; |
|
27 |
- |
|
28 |
- $self->{_cached} ||= {}; |
|
29 |
- |
|
30 |
- if (@_ > 1) { |
|
31 |
- $self->{_cached}{$_[0]} = $_[1]; |
|
32 |
- } |
|
33 |
- else { |
|
34 |
- return $self->{_cached}{$_[0]}; |
|
35 |
- } |
|
36 |
- } |
|
37 |
- }, |
|
38 |
- dbi_option => sub { {} }, |
|
39 |
- default_dbi_option => sub { |
|
40 |
- { |
|
41 |
- RaiseError => 1, |
|
42 |
- PrintError => 0, |
|
43 |
- AutoCommit => 1 |
|
44 |
- } |
|
45 |
- }, |
|
46 |
- filters => sub { |
|
47 |
- { |
|
48 |
- encode_utf8 => sub { encode_utf8($_[0]) }, |
|
49 |
- decode_utf8 => sub { decode_utf8($_[0]) } |
|
50 |
- } |
|
51 |
- }, |
|
52 |
- last_sql => '', |
|
53 |
- models => sub { {} }, |
|
54 |
- query_builder => sub { DBIx::Custom::QueryBuilder->new(dbi => shift) }, |
|
55 |
- result_class => 'DBIx::Custom::Result', |
|
56 |
- safety_character => '\w', |
|
57 |
- stash => sub { {} }, |
|
58 |
- tag_parse => 1; |
|
59 |
- |
|
60 |
-our $AUTOLOAD; |
|
61 |
-sub AUTOLOAD { |
|
62 |
- my $self = shift; |
|
63 |
- |
|
64 |
- # Method name |
|
65 |
- my ($package, $mname) = $AUTOLOAD =~ /^([\w\:]+)\:\:(\w+)$/; |
|
66 |
- |
|
67 |
- # Call method |
|
68 |
- $self->{_methods} ||= {}; |
|
69 |
- if (my $method = $self->{_methods}->{$mname}) { |
|
70 |
- return $self->$method(@_) |
|
71 |
- } |
|
72 |
- elsif ($self->{dbh} && (my $dbh_method = $self->dbh->can($mname))) { |
|
73 |
- $self->dbh->$dbh_method(@_); |
|
74 |
- } |
|
75 |
- else { |
|
76 |
- croak qq{Can't locate object method "$mname" via "$package" } |
|
77 |
- . _subname; |
|
78 |
- } |
|
79 |
-} |
|
80 |
- |
|
81 |
-sub assign_param { |
|
82 |
- my ($self, $param) = @_; |
|
83 |
- |
|
84 |
- # Create set tag |
|
85 |
- my @params; |
|
86 |
- my $safety = $self->safety_character; |
|
87 |
- foreach my $column (sort keys %$param) { |
|
88 |
- croak qq{"$column" is not safety column name } . _subname |
|
89 |
- unless $column =~ /^[$safety\.]+$/; |
|
90 |
- my $column_quote = $self->_q($column); |
|
91 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
92 |
- push @params, ref $param->{$column} eq 'SCALAR' |
|
93 |
- ? "$column_quote = " . ${$param->{$column}} |
|
94 |
- : "$column_quote = :$column"; |
|
95 |
- |
|
96 |
- } |
|
97 |
- my $tag = join(', ', @params); |
|
98 |
- |
|
99 |
- return $tag; |
|
100 |
-} |
|
101 |
- |
|
102 |
-sub column { |
|
103 |
- my $self = shift; |
|
104 |
- my $option = pop if ref $_[-1] eq 'HASH'; |
|
105 |
- my $real_table = shift; |
|
106 |
- my $columns = shift; |
|
107 |
- my $table = $option->{alias} || $real_table; |
|
108 |
- |
|
109 |
- # Columns |
|
110 |
- unless ($columns) { |
|
111 |
- $columns ||= $self->model($real_table)->columns; |
|
112 |
- } |
|
113 |
- |
|
114 |
- # Separator |
|
115 |
- my $separator = $self->separator; |
|
116 |
- |
|
117 |
- # Column clause |
|
118 |
- my @column; |
|
119 |
- $columns ||= []; |
|
120 |
- push @column, $self->_q($table) . "." . $self->_q($_) . |
|
121 |
- " as " . $self->_q("${table}${separator}$_") |
|
122 |
- for @$columns; |
|
123 |
- |
|
124 |
- return join (', ', @column); |
|
125 |
-} |
|
126 |
- |
|
127 |
-sub connect { |
|
128 |
- my $self = ref $_[0] ? shift : shift->new(@_);; |
|
129 |
- |
|
130 |
- # Connect |
|
131 |
- $self->dbh; |
|
132 |
- |
|
133 |
- return $self; |
|
134 |
-} |
|
135 |
- |
|
136 |
-sub dbh { |
|
137 |
- my $self = shift; |
|
138 |
- |
|
139 |
- # Set |
|
140 |
- if (@_) { |
|
141 |
- $self->{dbh} = $_[0]; |
|
142 |
- |
|
143 |
- return $self; |
|
144 |
- } |
|
145 |
- |
|
146 |
- # Get |
|
147 |
- else { |
|
148 |
- # From Connction manager |
|
149 |
- if (my $connector = $self->connector) { |
|
150 |
- croak "connector must have dbh() method " . _subname |
|
151 |
- unless ref $connector && $connector->can('dbh'); |
|
152 |
- |
|
153 |
- $self->{dbh} = $connector->dbh; |
|
154 |
- } |
|
155 |
- |
|
156 |
- # Connect |
|
157 |
- $self->{dbh} ||= $self->_connect; |
|
158 |
- |
|
159 |
- # Quote |
|
160 |
- if (!defined $self->reserved_word_quote && !defined $self->quote) { |
|
161 |
- my $driver = $self->{dbh}->{Driver}->{Name}; |
|
162 |
- my $quote = $driver eq 'mysql' ? '`' : '"'; |
|
163 |
- $self->quote($quote); |
|
164 |
- } |
|
165 |
- |
|
166 |
- return $self->{dbh}; |
|
167 |
- } |
|
168 |
-} |
|
169 |
- |
|
170 |
-sub delete { |
|
171 |
- my ($self, %args) = @_; |
|
172 |
- |
|
173 |
- # Arguments |
|
174 |
- my $table = $args{table} || ''; |
|
175 |
- croak qq{"table" option must be specified. } . _subname |
|
176 |
- unless $table; |
|
177 |
- my $where = delete $args{where} || {}; |
|
178 |
- my $append = delete $args{append}; |
|
179 |
- my $allow_delete_all = delete $args{allow_delete_all}; |
|
180 |
- my $where_param = delete $args{where_param} || {}; |
|
181 |
- my $id = delete $args{id}; |
|
182 |
- my $primary_key = delete $args{primary_key}; |
|
183 |
- croak "update method primary_key option " . |
|
184 |
- "must be specified when id is specified " . _subname |
|
185 |
- if defined $id && !defined $primary_key; |
|
186 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
187 |
- my $prefix = delete $args{prefix}; |
|
188 |
- |
|
189 |
- # Where |
|
190 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
191 |
- my $where_clause = ''; |
|
192 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
193 |
- $where_clause = "where " . $where->[0]; |
|
194 |
- $where_param = $where->[1]; |
|
195 |
- } |
|
196 |
- elsif (ref $where) { |
|
197 |
- $where = $self->_where_to_obj($where); |
|
198 |
- $where_param = keys %$where_param |
|
199 |
- ? $self->merge_param($where_param, $where->param) |
|
200 |
- : $where->param; |
|
201 |
- |
|
202 |
- # String where |
|
203 |
- $where_clause = $where->to_string; |
|
204 |
- } |
|
205 |
- elsif ($where) { $where_clause = "where $where" } |
|
206 |
- croak qq{"where" must be specified } . _subname |
|
207 |
- if $where_clause eq '' && !$allow_delete_all; |
|
208 |
- |
|
209 |
- # Delete statement |
|
210 |
- my @sql; |
|
211 |
- push @sql, "delete"; |
|
212 |
- push @sql, $prefix if defined $prefix; |
|
213 |
- push @sql, "from " . $self->_q($table) . " $where_clause"; |
|
214 |
- push @sql, $append if defined $append; |
|
215 |
- my $sql = join(' ', @sql); |
|
216 |
- |
|
217 |
- # Execute query |
|
218 |
- return $self->execute($sql, $where_param, table => $table, %args); |
|
219 |
-} |
|
220 |
- |
|
221 |
-sub delete_all { shift->delete(allow_delete_all => 1, @_) } |
|
222 |
- |
|
223 |
-sub DESTROY { } |
|
224 |
- |
|
225 |
-sub create_model { |
|
226 |
- my $self = shift; |
|
227 |
- |
|
228 |
- # Arguments |
|
229 |
- my $args = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
230 |
- $args->{dbi} = $self; |
|
231 |
- my $model_class = delete $args->{model_class} || 'DBIx::Custom::Model'; |
|
232 |
- my $model_name = delete $args->{name}; |
|
233 |
- my $model_table = delete $args->{table}; |
|
234 |
- $model_name ||= $model_table; |
|
235 |
- |
|
236 |
- # Create model |
|
237 |
- my $model = $model_class->new($args); |
|
238 |
- $model->name($model_name) unless $model->name; |
|
239 |
- $model->table($model_table) unless $model->table; |
|
240 |
- |
|
241 |
- # Apply filter(DEPRECATED logic) |
|
242 |
- if ($model->{filter}) { |
|
243 |
- my $filter = ref $model->filter eq 'HASH' |
|
244 |
- ? [%{$model->filter}] |
|
245 |
- : $model->filter; |
|
246 |
- $filter ||= []; |
|
247 |
- warn "DBIx::Custom::Model filter method is DEPRECATED!" |
|
248 |
- if @$filter; |
|
249 |
- $self->_apply_filter($model->table, @$filter); |
|
250 |
- } |
|
251 |
- |
|
252 |
- # Set model |
|
253 |
- $self->model($model->name, $model); |
|
254 |
- |
|
255 |
- return $self->model($model->name); |
|
256 |
-} |
|
257 |
- |
|
258 |
-sub each_column { |
|
259 |
- my ($self, $cb) = @_; |
|
260 |
- |
|
261 |
- # Iterate all tables |
|
262 |
- my $sth_tables = $self->dbh->table_info; |
|
263 |
- while (my $table_info = $sth_tables->fetchrow_hashref) { |
|
264 |
- |
|
265 |
- # Table |
|
266 |
- my $table = $table_info->{TABLE_NAME}; |
|
267 |
- |
|
268 |
- # Iterate all columns |
|
269 |
- my $sth_columns = $self->dbh->column_info(undef, undef, $table, '%'); |
|
270 |
- while (my $column_info = $sth_columns->fetchrow_hashref) { |
|
271 |
- my $column = $column_info->{COLUMN_NAME}; |
|
272 |
- $self->$cb($table, $column, $column_info); |
|
273 |
- } |
|
274 |
- } |
|
275 |
-} |
|
276 |
- |
|
277 |
-sub each_table { |
|
278 |
- my ($self, $cb) = @_; |
|
279 |
- |
|
280 |
- # Iterate all tables |
|
281 |
- my $sth_tables = $self->dbh->table_info; |
|
282 |
- while (my $table_info = $sth_tables->fetchrow_hashref) { |
|
283 |
- |
|
284 |
- # Table |
|
285 |
- my $table = $table_info->{TABLE_NAME}; |
|
286 |
- $self->$cb($table, $table_info); |
|
287 |
- } |
|
288 |
-} |
|
289 |
- |
|
290 |
-our %VALID_ARGS = map { $_ => 1 } qw/append allow_delete_all |
|
291 |
- allow_update_all bind_type column filter id join param prefix primary_key |
|
292 |
- query relation table table_alias type type_rule_off type_rule1_off |
|
293 |
- type_rule2_off wrap/; |
|
294 |
- |
|
295 |
-sub execute { |
|
296 |
- my $self = shift; |
|
297 |
- my $query = shift; |
|
298 |
- my $param; |
|
299 |
- $param = shift if @_ % 2; |
|
300 |
- my %args = @_; |
|
301 |
- |
|
302 |
- # Arguments |
|
303 |
- my $p = delete $args{param} || {}; |
|
304 |
- $param ||= $p; |
|
305 |
- my $tables = delete $args{table} || []; |
|
306 |
- $tables = [$tables] unless ref $tables eq 'ARRAY'; |
|
307 |
- my $filter = delete $args{filter}; |
|
308 |
- $filter = _array_to_hash($filter); |
|
309 |
- my $bind_type = delete $args{bind_type} || delete $args{type}; |
|
310 |
- $bind_type = _array_to_hash($bind_type); |
|
311 |
- my $type_rule_off = delete $args{type_rule_off}; |
|
312 |
- my $type_rule_off_parts = { |
|
313 |
- 1 => delete $args{type_rule1_off}, |
|
314 |
- 2 => delete $args{type_rule2_off} |
|
315 |
- }; |
|
316 |
- my $query_return = delete $args{query}; |
|
317 |
- my $table_alias = delete $args{table_alias} || {}; |
|
318 |
- |
|
319 |
- # Check argument names |
|
320 |
- foreach my $name (keys %args) { |
|
321 |
- croak qq{"$name" is wrong option } . _subname |
|
322 |
- unless $VALID_ARGS{$name}; |
|
323 |
- } |
|
324 |
- |
|
325 |
- # Create query |
|
326 |
- $query = $self->_create_query($query) unless ref $query; |
|
327 |
- |
|
328 |
- # Save query |
|
329 |
- $self->last_sql($query->sql); |
|
330 |
- |
|
331 |
- return $query if $query_return; |
|
332 |
- |
|
333 |
- # DEPRECATED! Merge query filter |
|
334 |
- $filter ||= $query->{filter} || {}; |
|
335 |
- |
|
336 |
- # Tables |
|
337 |
- unshift @$tables, @{$query->{tables} || []}; |
|
338 |
- my $main_table = @{$tables}[-1]; |
|
339 |
- |
|
340 |
- # DEPRECATED! Cleanup tables |
|
341 |
- $tables = $self->_remove_duplicate_table($tables, $main_table) |
|
342 |
- if @$tables > 1; |
|
343 |
- |
|
344 |
- # Type rule |
|
345 |
- my $type_filters = {}; |
|
346 |
- unless ($type_rule_off) { |
|
347 |
- foreach my $i (1, 2) { |
|
348 |
- unless ($type_rule_off_parts->{$i}) { |
|
349 |
- $type_filters->{$i} = {}; |
|
350 |
- foreach my $alias (keys %$table_alias) { |
|
351 |
- my $table = $table_alias->{$alias}; |
|
352 |
- |
|
353 |
- foreach my $column (keys %{$self->{"_into$i"}{key}{$table} || {}}) { |
|
354 |
- $type_filters->{$i}->{"$alias.$column"} = $self->{"_into$i"}{key}{$table}{$column}; |
|
355 |
- } |
|
356 |
- } |
|
357 |
- $type_filters->{$i} = {%{$type_filters->{$i}}, %{$self->{"_into$i"}{key}{$main_table} || {}}} |
|
358 |
- if $main_table; |
|
359 |
- } |
|
360 |
- } |
|
361 |
- } |
|
362 |
- |
|
363 |
- # DEPRECATED! Applied filter |
|
364 |
- if ($self->{filter}{on}) { |
|
365 |
- my $applied_filter = {}; |
|
366 |
- foreach my $table (@$tables) { |
|
367 |
- $applied_filter = { |
|
368 |
- %$applied_filter, |
|
369 |
- %{$self->{filter}{out}->{$table} || {}} |
|
370 |
- } |
|
371 |
- } |
|
372 |
- $filter = {%$applied_filter, %$filter}; |
|
373 |
- } |
|
374 |
- |
|
375 |
- # Replace filter name to code |
|
376 |
- foreach my $column (keys %$filter) { |
|
377 |
- my $name = $filter->{$column}; |
|
378 |
- if (!defined $name) { |
|
379 |
- $filter->{$column} = undef; |
|
380 |
- } |
|
381 |
- elsif (ref $name ne 'CODE') { |
|
382 |
- croak qq{Filter "$name" is not registered" } . _subname |
|
383 |
- unless exists $self->filters->{$name}; |
|
384 |
- $filter->{$column} = $self->filters->{$name}; |
|
385 |
- } |
|
386 |
- } |
|
387 |
- |
|
388 |
- # Create bind values |
|
389 |
- my $bind = $self->_create_bind_values( |
|
390 |
- $param, |
|
391 |
- $query->columns, |
|
392 |
- $filter, |
|
393 |
- $type_filters, |
|
394 |
- $bind_type |
|
395 |
- ); |
|
396 |
- |
|
397 |
- # Execute |
|
398 |
- my $sth = $query->sth; |
|
399 |
- my $affected; |
|
400 |
- eval { |
|
401 |
- for (my $i = 0; $i < @$bind; $i++) { |
|
402 |
- my $bind_type = $bind->[$i]->{bind_type}; |
|
403 |
- $sth->bind_param( |
|
404 |
- $i + 1, |
|
405 |
- $bind->[$i]->{value}, |
|
406 |
- $bind_type ? $bind_type : () |
|
407 |
- ); |
|
408 |
- } |
|
409 |
- $affected = $sth->execute; |
|
410 |
- }; |
|
411 |
- |
|
412 |
- $self->_croak($@, qq{. Following SQL is executed.\n} |
|
413 |
- . qq{$query->{sql}\n} . _subname) if $@; |
|
414 |
- |
|
415 |
- # DEBUG message |
|
416 |
- if (DEBUG) { |
|
417 |
- print STDERR "SQL:\n" . $query->sql . "\n"; |
|
418 |
- my @output; |
|
419 |
- foreach my $b (@$bind) { |
|
420 |
- my $value = $b->{value}; |
|
421 |
- $value = 'undef' unless defined $value; |
|
422 |
- $value = encode(DEBUG_ENCODING(), $value) |
|
423 |
- if utf8::is_utf8($value); |
|
424 |
- push @output, $value; |
|
425 |
- } |
|
426 |
- print STDERR "Bind values: " . join(', ', @output) . "\n\n"; |
|
427 |
- } |
|
428 |
- |
|
429 |
- # Select statement |
|
430 |
- if ($sth->{NUM_OF_FIELDS}) { |
|
431 |
- |
|
432 |
- # DEPRECATED! Filter |
|
433 |
- my $filter = {}; |
|
434 |
- if ($self->{filter}{on}) { |
|
435 |
- $filter->{in} = {}; |
|
436 |
- $filter->{end} = {}; |
|
437 |
- push @$tables, $main_table if $main_table; |
|
438 |
- foreach my $table (@$tables) { |
|
439 |
- foreach my $way (qw/in end/) { |
|
440 |
- $filter->{$way} = { |
|
441 |
- %{$filter->{$way}}, |
|
442 |
- %{$self->{filter}{$way}{$table} || {}} |
|
443 |
- }; |
|
444 |
- } |
|
445 |
- } |
|
446 |
- } |
|
447 |
- |
|
448 |
- # Result |
|
449 |
- my $result = $self->result_class->new( |
|
450 |
- sth => $sth, |
|
451 |
- dbi => $self, |
|
452 |
- default_filter => $self->{default_in_filter}, |
|
453 |
- filter => $filter->{in} || {}, |
|
454 |
- end_filter => $filter->{end} || {}, |
|
455 |
- type_rule => { |
|
456 |
- from1 => $self->type_rule->{from1}, |
|
457 |
- from2 => $self->type_rule->{from2} |
|
458 |
- }, |
|
459 |
- ); |
|
460 |
- |
|
461 |
- return $result; |
|
462 |
- } |
|
463 |
- |
|
464 |
- # Not select statement |
|
465 |
- else { return $affected } |
|
466 |
-} |
|
467 |
- |
|
468 |
-sub insert { |
|
469 |
- my $self = shift; |
|
470 |
- |
|
471 |
- # Arguments |
|
472 |
- my $param; |
|
473 |
- $param = shift if @_ % 2; |
|
474 |
- my %args = @_; |
|
475 |
- my $table = delete $args{table}; |
|
476 |
- croak qq{"table" option must be specified } . _subname |
|
477 |
- unless defined $table; |
|
478 |
- my $p = delete $args{param} || {}; |
|
479 |
- $param ||= $p; |
|
480 |
- my $append = delete $args{append} || ''; |
|
481 |
- my $id = delete $args{id}; |
|
482 |
- my $primary_key = delete $args{primary_key}; |
|
483 |
- croak "insert method primary_key option " . |
|
484 |
- "must be specified when id is specified " . _subname |
|
485 |
- if defined $id && !defined $primary_key; |
|
486 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
487 |
- my $prefix = delete $args{prefix}; |
|
488 |
- |
|
489 |
- # Merge parameter |
|
490 |
- if (defined $id) { |
|
491 |
- my $id_param = $self->_create_param_from_id($id, $primary_key); |
|
492 |
- $param = $self->merge_param($id_param, $param); |
|
493 |
- } |
|
494 |
- |
|
495 |
- # Insert statement |
|
496 |
- my @sql; |
|
497 |
- push @sql, "insert"; |
|
498 |
- push @sql, $prefix if defined $prefix; |
|
499 |
- push @sql, "into " . $self->_q($table) . " " . $self->insert_param($param); |
|
500 |
- push @sql, $append if defined $append; |
|
501 |
- my $sql = join (' ', @sql); |
|
502 |
- |
|
503 |
- # Execute query |
|
504 |
- return $self->execute($sql, $param, table => $table, %args); |
|
505 |
-} |
|
506 |
- |
|
507 |
-sub insert_param { |
|
508 |
- my ($self, $param) = @_; |
|
509 |
- |
|
510 |
- # Create insert parameter tag |
|
511 |
- my $safety = $self->safety_character; |
|
512 |
- my @columns; |
|
513 |
- my @placeholders; |
|
514 |
- foreach my $column (sort keys %$param) { |
|
515 |
- croak qq{"$column" is not safety column name } . _subname |
|
516 |
- unless $column =~ /^[$safety\.]+$/; |
|
517 |
- my $column_quote = $self->_q($column); |
|
518 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
519 |
- push @columns, $column_quote; |
|
520 |
- push @placeholders, ref $param->{$column} eq 'SCALAR' |
|
521 |
- ? ${$param->{$column}} : ":$column"; |
|
522 |
- } |
|
523 |
- |
|
524 |
- return '(' . join(', ', @columns) . ') ' . 'values ' . |
|
525 |
- '(' . join(', ', @placeholders) . ')' |
|
526 |
-} |
|
527 |
- |
|
528 |
-sub include_model { |
|
529 |
- my ($self, $name_space, $model_infos) = @_; |
|
530 |
- |
|
531 |
- # Name space |
|
532 |
- $name_space ||= ''; |
|
533 |
- |
|
534 |
- # Get Model infomations |
|
535 |
- unless ($model_infos) { |
|
536 |
- |
|
537 |
- # Load name space module |
|
538 |
- croak qq{"$name_space" is invalid class name } . _subname |
|
539 |
- if $name_space =~ /[^\w:]/; |
|
540 |
- eval "use $name_space"; |
|
541 |
- croak qq{Name space module "$name_space.pm" is needed. $@ } |
|
542 |
- . _subname |
|
543 |
- if $@; |
|
544 |
- |
|
545 |
- # Search model modules |
|
546 |
- my $path = $INC{"$name_space.pm"}; |
|
547 |
- $path =~ s/\.pm$//; |
|
548 |
- opendir my $dh, $path |
|
549 |
- or croak qq{Can't open directory "$path": $! } . _subname |
|
550 |
- $model_infos = []; |
|
551 |
- while (my $module = readdir $dh) { |
|
552 |
- push @$model_infos, $module |
|
553 |
- if $module =~ s/\.pm$//; |
|
554 |
- } |
|
555 |
- close $dh; |
|
556 |
- } |
|
557 |
- |
|
558 |
- # Include models |
|
559 |
- foreach my $model_info (@$model_infos) { |
|
560 |
- |
|
561 |
- # Load model |
|
562 |
- my $model_class; |
|
563 |
- my $model_name; |
|
564 |
- my $model_table; |
|
565 |
- if (ref $model_info eq 'HASH') { |
|
566 |
- $model_class = $model_info->{class}; |
|
567 |
- $model_name = $model_info->{name}; |
|
568 |
- $model_table = $model_info->{table}; |
|
569 |
- |
|
570 |
- $model_name ||= $model_class; |
|
571 |
- $model_table ||= $model_name; |
|
572 |
- } |
|
573 |
- else { $model_class = $model_name = $model_table = $model_info } |
|
574 |
- my $mclass = "${name_space}::$model_class"; |
|
575 |
- croak qq{"$mclass" is invalid class name } . _subname |
|
576 |
- if $mclass =~ /[^\w:]/; |
|
577 |
- unless ($mclass->can('isa')) { |
|
578 |
- eval "use $mclass"; |
|
579 |
- croak "$@ " . _subname if $@; |
|
580 |
- } |
|
581 |
- |
|
582 |
- # Create model |
|
583 |
- my $args = {}; |
|
584 |
- $args->{model_class} = $mclass if $mclass; |
|
585 |
- $args->{name} = $model_name if $model_name; |
|
586 |
- $args->{table} = $model_table if $model_table; |
|
587 |
- $self->create_model($args); |
|
588 |
- } |
|
589 |
- |
|
590 |
- return $self; |
|
591 |
-} |
|
592 |
- |
|
593 |
-sub map_param { |
|
594 |
- my $self = shift; |
|
595 |
- my $param = shift; |
|
596 |
- my %map = @_; |
|
597 |
- |
|
598 |
- # Mapping |
|
599 |
- my $map_param = {}; |
|
600 |
- foreach my $key (keys %map) { |
|
601 |
- my $value_cb; |
|
602 |
- my $condition; |
|
603 |
- my $map_key; |
|
604 |
- |
|
605 |
- # Get mapping information |
|
606 |
- if (ref $map{$key} eq 'ARRAY') { |
|
607 |
- foreach my $some (@{$map{$key}}) { |
|
608 |
- $map_key = $some unless ref $some; |
|
609 |
- $condition = $some->{if} if ref $some eq 'HASH'; |
|
610 |
- $value_cb = $some if ref $some eq 'CODE'; |
|
611 |
- } |
|
612 |
- } |
|
613 |
- else { |
|
614 |
- $map_key = $map{$key}; |
|
615 |
- } |
|
616 |
- $value_cb ||= sub { $_[0] }; |
|
617 |
- $condition ||= sub { defined $_[0] && length $_[0] }; |
|
618 |
- |
|
619 |
- # Map parameter |
|
620 |
- my $value; |
|
621 |
- if (ref $condition eq 'CODE') { |
|
622 |
- $map_param->{$map_key} = $value_cb->($param->{$key}) |
|
623 |
- if $condition->($param->{$key}); |
|
624 |
- } |
|
625 |
- elsif ($condition eq 'exists') { |
|
626 |
- $map_param->{$map_key} = $value_cb->($param->{$key}) |
|
627 |
- if exists $param->{$key}; |
|
628 |
- } |
|
629 |
- else { croak qq/Condition must be code reference or "exists" / . _subname } |
|
630 |
- } |
|
631 |
- |
|
632 |
- return $map_param; |
|
633 |
-} |
|
634 |
- |
|
635 |
-sub merge_param { |
|
636 |
- my ($self, @params) = @_; |
|
637 |
- |
|
638 |
- # Merge parameters |
|
639 |
- my $merge = {}; |
|
640 |
- foreach my $param (@params) { |
|
641 |
- foreach my $column (keys %$param) { |
|
642 |
- my $param_is_array = ref $param->{$column} eq 'ARRAY' ? 1 : 0; |
|
643 |
- |
|
644 |
- if (exists $merge->{$column}) { |
|
645 |
- $merge->{$column} = [$merge->{$column}] |
|
646 |
- unless ref $merge->{$column} eq 'ARRAY'; |
|
647 |
- push @{$merge->{$column}}, |
|
648 |
- ref $param->{$column} ? @{$param->{$column}} : $param->{$column}; |
|
649 |
- } |
|
650 |
- else { |
|
651 |
- $merge->{$column} = $param->{$column}; |
|
652 |
- } |
|
653 |
- } |
|
654 |
- } |
|
655 |
- |
|
656 |
- return $merge; |
|
657 |
-} |
|
658 |
- |
|
659 |
-sub method { |
|
660 |
- my $self = shift; |
|
661 |
- |
|
662 |
- # Register method |
|
663 |
- my $methods = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
664 |
- $self->{_methods} = {%{$self->{_methods} || {}}, %$methods}; |
|
665 |
- |
|
666 |
- return $self; |
|
667 |
-} |
|
668 |
- |
|
669 |
-sub model { |
|
670 |
- my ($self, $name, $model) = @_; |
|
671 |
- |
|
672 |
- # Set model |
|
673 |
- if ($model) { |
|
674 |
- $self->models->{$name} = $model; |
|
675 |
- return $self; |
|
676 |
- } |
|
677 |
- |
|
678 |
- # Check model existance |
|
679 |
- croak qq{Model "$name" is not included } . _subname |
|
680 |
- unless $self->models->{$name}; |
|
681 |
- |
|
682 |
- # Get model |
|
683 |
- return $self->models->{$name}; |
|
684 |
-} |
|
685 |
- |
|
686 |
-sub mycolumn { |
|
687 |
- my ($self, $table, $columns) = @_; |
|
688 |
- |
|
689 |
- # Create column clause |
|
690 |
- my @column; |
|
691 |
- $columns ||= []; |
|
692 |
- push @column, $self->_q($table) . "." . $self->_q($_) . |
|
693 |
- " as " . $self->_q($_) |
|
694 |
- for @$columns; |
|
695 |
- |
|
696 |
- return join (', ', @column); |
|
697 |
-} |
|
698 |
- |
|
699 |
-sub new { |
|
700 |
- my $self = shift->SUPER::new(@_); |
|
701 |
- |
|
702 |
- # Check attributes |
|
703 |
- my @attrs = keys %$self; |
|
704 |
- foreach my $attr (@attrs) { |
|
705 |
- croak qq{"$attr" is wrong name } . _subname |
|
706 |
- unless $self->can($attr); |
|
707 |
- } |
|
708 |
- |
|
709 |
- # DEPRECATED! |
|
710 |
- $self->query_builder->{tags} = { |
|
711 |
- '?' => \&DBIx::Custom::Tag::placeholder, |
|
712 |
- '=' => \&DBIx::Custom::Tag::equal, |
|
713 |
- '<>' => \&DBIx::Custom::Tag::not_equal, |
|
714 |
- '>' => \&DBIx::Custom::Tag::greater_than, |
|
715 |
- '<' => \&DBIx::Custom::Tag::lower_than, |
|
716 |
- '>=' => \&DBIx::Custom::Tag::greater_than_equal, |
|
717 |
- '<=' => \&DBIx::Custom::Tag::lower_than_equal, |
|
718 |
- 'like' => \&DBIx::Custom::Tag::like, |
|
719 |
- 'in' => \&DBIx::Custom::Tag::in, |
|
720 |
- 'insert_param' => \&DBIx::Custom::Tag::insert_param, |
|
721 |
- 'update_param' => \&DBIx::Custom::Tag::update_param |
|
722 |
- }; |
|
723 |
- |
|
724 |
- return $self; |
|
725 |
-} |
|
726 |
- |
|
727 |
-sub not_exists { bless {}, 'DBIx::Custom::NotExists' } |
|
728 |
- |
|
729 |
-sub order { |
|
730 |
- my $self = shift; |
|
731 |
- return DBIx::Custom::Order->new(dbi => $self, @_); |
|
732 |
-} |
|
733 |
- |
|
734 |
-sub register_filter { |
|
735 |
- my $self = shift; |
|
736 |
- |
|
737 |
- # Register filter |
|
738 |
- my $filters = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
739 |
- $self->filters({%{$self->filters}, %$filters}); |
|
740 |
- |
|
741 |
- return $self; |
|
742 |
-} |
|
743 |
- |
|
744 |
-sub select { |
|
745 |
- my ($self, %args) = @_; |
|
746 |
- |
|
747 |
- # Arguments |
|
748 |
- my $table = delete $args{table}; |
|
749 |
- my $tables = ref $table eq 'ARRAY' ? $table |
|
750 |
- : defined $table ? [$table] |
|
751 |
- : []; |
|
752 |
- my $columns = delete $args{column}; |
|
753 |
- my $where = delete $args{where} || {}; |
|
754 |
- my $append = delete $args{append}; |
|
755 |
- my $join = delete $args{join} || []; |
|
756 |
- croak qq{"join" must be array reference } . _subname |
|
757 |
- unless ref $join eq 'ARRAY'; |
|
758 |
- my $relation = delete $args{relation}; |
|
759 |
- warn "select() relation option is DEPRECATED!" |
|
760 |
- if $relation; |
|
761 |
- my $param = delete $args{param} || {}; # DEPRECATED! |
|
762 |
- warn "select() param option is DEPRECATED!" |
|
763 |
- if keys %$param; |
|
764 |
- my $where_param = delete $args{where_param} || $param || {}; |
|
765 |
- my $wrap = delete $args{wrap}; |
|
766 |
- my $id = delete $args{id}; |
|
767 |
- my $primary_key = delete $args{primary_key}; |
|
768 |
- croak "update method primary_key option " . |
|
769 |
- "must be specified when id is specified " . _subname |
|
770 |
- if defined $id && !defined $primary_key; |
|
771 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
772 |
- my $prefix = delete $args{prefix}; |
|
773 |
- |
|
774 |
- # Add relation tables(DEPRECATED!); |
|
775 |
- $self->_add_relation_table($tables, $relation); |
|
776 |
- |
|
777 |
- # Select statement |
|
778 |
- my @sql; |
|
779 |
- push @sql, 'select'; |
|
780 |
- |
|
781 |
- # Prefix |
|
782 |
- push @sql, $prefix if defined $prefix; |
|
783 |
- |
|
784 |
- # Column clause |
|
785 |
- if ($columns) { |
|
786 |
- $columns = [$columns] unless ref $columns eq 'ARRAY'; |
|
787 |
- foreach my $column (@$columns) { |
|
788 |
- if (ref $column eq 'HASH') { |
|
789 |
- $column = $self->column(%$column) if ref $column eq 'HASH'; |
|
790 |
- } |
|
791 |
- elsif (ref $column eq 'ARRAY') { |
|
792 |
- if (@$column == 3 && $column->[1] eq 'as') { |
|
793 |
- warn "[COLUMN, as => ALIAS] is DEPRECATED! use [COLUMN => ALIAS]"; |
|
794 |
- splice @$column, 1, 1; |
|
795 |
- } |
|
796 |
- |
|
797 |
- $column = join(' ', $column->[0], 'as', $self->_q($column->[1])); |
|
798 |
- } |
|
799 |
- unshift @$tables, @{$self->_search_tables($column)}; |
|
800 |
- push @sql, ($column, ','); |
|
801 |
- } |
|
802 |
- pop @sql if $sql[-1] eq ','; |
|
803 |
- } |
|
804 |
- else { push @sql, '*' } |
|
805 |
- |
|
806 |
- # Table |
|
807 |
- push @sql, 'from'; |
|
808 |
- if ($relation) { |
|
809 |
- my $found = {}; |
|
810 |
- foreach my $table (@$tables) { |
|
811 |
- push @sql, ($self->_q($table), ',') unless $found->{$table}; |
|
812 |
- $found->{$table} = 1; |
|
813 |
- } |
|
814 |
- } |
|
815 |
- else { |
|
816 |
- my $main_table = $tables->[-1] || ''; |
|
817 |
- push @sql, $self->_q($main_table); |
|
818 |
- } |
|
819 |
- pop @sql if ($sql[-1] || '') eq ','; |
|
820 |
- croak "Not found table name " . _subname |
|
821 |
- unless $tables->[-1]; |
|
822 |
- |
|
823 |
- # Add tables in parameter |
|
824 |
- unshift @$tables, |
|
825 |
- @{$self->_search_tables(join(' ', keys %$where_param) || '')}; |
|
826 |
- |
|
827 |
- # Where |
|
828 |
- my $where_clause = ''; |
|
829 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
830 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
831 |
- $where_clause = "where " . $where->[0]; |
|
832 |
- $where_param = $where->[1]; |
|
833 |
- } |
|
834 |
- elsif (ref $where) { |
|
835 |
- $where = $self->_where_to_obj($where); |
|
836 |
- $where_param = keys %$where_param |
|
837 |
- ? $self->merge_param($where_param, $where->param) |
|
838 |
- : $where->param; |
|
839 |
- |
|
840 |
- # String where |
|
841 |
- $where_clause = $where->to_string; |
|
842 |
- } |
|
843 |
- elsif ($where) { $where_clause = "where $where" } |
|
844 |
- |
|
845 |
- # Add table names in where clause |
|
846 |
- unshift @$tables, @{$self->_search_tables($where_clause)}; |
|
847 |
- |
|
848 |
- # Push join |
|
849 |
- $self->_push_join(\@sql, $join, $tables); |
|
850 |
- |
|
851 |
- # Add where clause |
|
852 |
- push @sql, $where_clause; |
|
853 |
- |
|
854 |
- # Relation(DEPRECATED!); |
|
855 |
- $self->_push_relation(\@sql, $tables, $relation, $where_clause eq '' ? 1 : 0); |
|
856 |
- |
|
857 |
- # Append |
|
858 |
- push @sql, $append if defined $append; |
|
859 |
- |
|
860 |
- # Wrap |
|
861 |
- if ($wrap) { |
|
862 |
- croak "wrap option must be array refrence " . _subname |
|
863 |
- unless ref $wrap eq 'ARRAY'; |
|
864 |
- unshift @sql, $wrap->[0]; |
|
865 |
- push @sql, $wrap->[1]; |
|
866 |
- } |
|
867 |
- |
|
868 |
- # SQL |
|
869 |
- my $sql = join (' ', @sql); |
|
870 |
- |
|
871 |
- # Execute query |
|
872 |
- my $result = $self->execute($sql, $where_param, table => $tables, %args); |
|
873 |
- |
|
874 |
- return $result; |
|
875 |
-} |
|
876 |
- |
|
877 |
-sub separator { |
|
878 |
- my $self = shift; |
|
879 |
- |
|
880 |
- if (@_) { |
|
881 |
- my $separator = $_[0] || ''; |
|
882 |
- croak qq{Separator must be "." or "__" or "-" } . _subname |
|
883 |
- unless $separator eq '.' || $separator eq '__' |
|
884 |
- || $separator eq '-'; |
|
885 |
- |
|
886 |
- $self->{separator} = $separator; |
|
887 |
- |
|
888 |
- return $self; |
|
889 |
- } |
|
890 |
- return $self->{separator} ||= '.'; |
|
891 |
-} |
|
892 |
- |
|
893 |
-sub setup_model { |
|
894 |
- my $self = shift; |
|
895 |
- |
|
896 |
- # Setup model |
|
897 |
- $self->each_column( |
|
898 |
- sub { |
|
899 |
- my ($self, $table, $column, $column_info) = @_; |
|
900 |
- if (my $model = $self->models->{$table}) { |
|
901 |
- push @{$model->columns}, $column; |
|
902 |
- } |
|
903 |
- } |
|
904 |
- ); |
|
905 |
- return $self; |
|
906 |
-} |
|
907 |
- |
|
908 |
-sub available_data_type { |
|
909 |
- my $self = shift; |
|
910 |
- |
|
911 |
- my $data_types = ''; |
|
912 |
- foreach my $i (-1000 .. 1000) { |
|
913 |
- my $type_info = $self->dbh->type_info($i); |
|
914 |
- my $data_type = $type_info->{DATA_TYPE}; |
|
915 |
- my $type_name = $type_info->{TYPE_NAME}; |
|
916 |
- $data_types .= "$data_type ($type_name)\n" |
|
917 |
- if defined $data_type; |
|
918 |
- } |
|
919 |
- return "Data Type maybe equal to Type Name" unless $data_types; |
|
920 |
- $data_types = "Data Type (Type name)\n" . $data_types; |
|
921 |
- return $data_types; |
|
922 |
-} |
|
923 |
- |
|
924 |
-sub available_type_name { |
|
925 |
- my $self = shift; |
|
926 |
- |
|
927 |
- # Type Names |
|
928 |
- my $type_names = {}; |
|
929 |
- $self->each_column(sub { |
|
930 |
- my ($self, $table, $column, $column_info) = @_; |
|
931 |
- $type_names->{$column_info->{TYPE_NAME}} = 1 |
|
932 |
- if $column_info->{TYPE_NAME}; |
|
933 |
- }); |
|
934 |
- my @output = sort keys %$type_names; |
|
935 |
- unshift @output, "Type Name"; |
|
936 |
- return join "\n", @output; |
|
937 |
-} |
|
938 |
- |
|
939 |
-sub type_rule { |
|
940 |
- my $self = shift; |
|
941 |
- |
|
942 |
- if (@_) { |
|
943 |
- my $type_rule = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
944 |
- |
|
945 |
- # Into |
|
946 |
- foreach my $i (1 .. 2) { |
|
947 |
- my $into = "into$i"; |
|
948 |
- $type_rule->{$into} = _array_to_hash($type_rule->{$into}); |
|
949 |
- $self->{type_rule} = $type_rule; |
|
950 |
- $self->{"_$into"} = {}; |
|
951 |
- foreach my $type_name (keys %{$type_rule->{$into} || {}}) { |
|
952 |
- croak qq{type name of $into section must be lower case} |
|
953 |
- if $type_name =~ /[A-Z]/; |
|
954 |
- } |
|
955 |
- $self->each_column(sub { |
|
956 |
- my ($dbi, $table, $column, $column_info) = @_; |
|
957 |
- |
|
958 |
- my $type_name = lc $column_info->{TYPE_NAME}; |
|
959 |
- if ($type_rule->{$into} && |
|
960 |
- (my $filter = $type_rule->{$into}->{$type_name})) |
|
961 |
- { |
|
962 |
- return unless exists $type_rule->{$into}->{$type_name}; |
|
963 |
- if (defined $filter && ref $filter ne 'CODE') |
|
964 |
- { |
|
965 |
- my $fname = $filter; |
|
966 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
967 |
- unless exists $self->filters->{$fname}; |
|
968 |
- |
|
969 |
- $filter = $self->filters->{$fname}; |
|
970 |
- } |
|
971 |
- |
|
972 |
- $self->{"_$into"}{key}{$table}{$column} = $filter; |
|
973 |
- $self->{"_$into"}{dot}{"$table.$column"} = $filter; |
|
974 |
- } |
|
975 |
- }); |
|
976 |
- } |
|
977 |
- |
|
978 |
- # From |
|
979 |
- foreach my $i (1 .. 2) { |
|
980 |
- $type_rule->{"from$i"} = _array_to_hash($type_rule->{"from$i"}); |
|
981 |
- foreach my $data_type (keys %{$type_rule->{"from$i"} || {}}) { |
|
982 |
- croak qq{data type of from$i section must be lower case or number} |
|
983 |
- if $data_type =~ /[A-Z]/; |
|
984 |
- my $fname = $type_rule->{"from$i"}{$data_type}; |
|
985 |
- if (defined $fname && ref $fname ne 'CODE') { |
|
986 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
987 |
- unless exists $self->filters->{$fname}; |
|
988 |
- |
|
989 |
- $type_rule->{"from$i"}{$data_type} = $self->filters->{$fname}; |
|
990 |
- } |
|
991 |
- } |
|
992 |
- } |
|
993 |
- |
|
994 |
- return $self; |
|
995 |
- } |
|
996 |
- |
|
997 |
- return $self->{type_rule} || {}; |
|
998 |
-} |
|
999 |
- |
|
1000 |
-sub update { |
|
1001 |
- my $self = shift; |
|
1002 |
- |
|
1003 |
- # Arguments |
|
1004 |
- my $param; |
|
1005 |
- $param = shift if @_ % 2; |
|
1006 |
- my %args = @_; |
|
1007 |
- my $table = delete $args{table} || ''; |
|
1008 |
- croak qq{"table" option must be specified } . _subname |
|
1009 |
- unless $table; |
|
1010 |
- my $p = delete $args{param} || {}; |
|
1011 |
- $param ||= $p; |
|
1012 |
- my $where = delete $args{where} || {}; |
|
1013 |
- my $where_param = delete $args{where_param} || {}; |
|
1014 |
- my $append = delete $args{append} || ''; |
|
1015 |
- my $allow_update_all = delete $args{allow_update_all}; |
|
1016 |
- my $id = delete $args{id}; |
|
1017 |
- my $primary_key = delete $args{primary_key}; |
|
1018 |
- croak "update method primary_key option " . |
|
1019 |
- "must be specified when id is specified " . _subname |
|
1020 |
- if defined $id && !defined $primary_key; |
|
1021 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
1022 |
- my $prefix = delete $args{prefix}; |
|
1023 |
- |
|
1024 |
- # Update clause |
|
1025 |
- my $update_clause = $self->update_param($param); |
|
1026 |
- |
|
1027 |
- # Where |
|
1028 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
1029 |
- my $where_clause = ''; |
|
1030 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
1031 |
- $where_clause = "where " . $where->[0]; |
|
1032 |
- $where_param = $where->[1]; |
|
1033 |
- } |
|
1034 |
- elsif (ref $where) { |
|
1035 |
- $where = $self->_where_to_obj($where); |
|
1036 |
- $where_param = keys %$where_param |
|
1037 |
- ? $self->merge_param($where_param, $where->param) |
|
1038 |
- : $where->param; |
|
1039 |
- |
|
1040 |
- # String where |
|
1041 |
- $where_clause = $where->to_string; |
|
1042 |
- } |
|
1043 |
- elsif ($where) { $where_clause = "where $where" } |
|
1044 |
- croak qq{"where" must be specified } . _subname |
|
1045 |
- if "$where_clause" eq '' && !$allow_update_all; |
|
1046 |
- |
|
1047 |
- # Merge param |
|
1048 |
- $param = $self->merge_param($param, $where_param) if keys %$where_param; |
|
1049 |
- |
|
1050 |
- # Update statement |
|
1051 |
- my @sql; |
|
1052 |
- push @sql, "update"; |
|
1053 |
- push @sql, $prefix if defined $prefix; |
|
1054 |
- push @sql, $self->_q($table) . " $update_clause $where_clause"; |
|
1055 |
- push @sql, $append if defined $append; |
|
1056 |
- |
|
1057 |
- # SQL |
|
1058 |
- my $sql = join(' ', @sql); |
|
1059 |
- |
|
1060 |
- # Execute query |
|
1061 |
- return $self->execute($sql, $param, table => $table, %args); |
|
1062 |
-} |
|
1063 |
- |
|
1064 |
-sub update_all { shift->update(allow_update_all => 1, @_) }; |
|
1065 |
- |
|
1066 |
-sub update_param { |
|
1067 |
- my ($self, $param, $opt) = @_; |
|
1068 |
- |
|
1069 |
- # Create update parameter tag |
|
1070 |
- my $tag = $self->assign_param($param); |
|
1071 |
- $tag = "set $tag" unless $opt->{no_set}; |
|
1072 |
- |
|
1073 |
- return $tag; |
|
1074 |
-} |
|
1075 |
- |
|
1076 |
-sub where { DBIx::Custom::Where->new(dbi => shift, @_) } |
|
1077 |
- |
|
1078 |
-sub _create_query { |
|
1079 |
- |
|
1080 |
- my ($self, $source) = @_; |
|
1081 |
- |
|
1082 |
- # Cache |
|
1083 |
- my $cache = $self->cache; |
|
1084 |
- |
|
1085 |
- # Query |
|
1086 |
- my $query; |
|
1087 |
- |
|
1088 |
- # Get cached query |
|
1089 |
- if ($cache) { |
|
1090 |
- |
|
1091 |
- # Get query |
|
1092 |
- my $q = $self->cache_method->($self, $source); |
|
1093 |
- |
|
1094 |
- # Create query |
|
1095 |
- if ($q) { |
|
1096 |
- $query = DBIx::Custom::Query->new($q); |
|
1097 |
- $query->{filters} = $self->filters; |
|
1098 |
- } |
|
1099 |
- } |
|
1100 |
- |
|
1101 |
- # Create query |
|
1102 |
- unless ($query) { |
|
1103 |
- |
|
1104 |
- # Create query |
|
1105 |
- my $builder = $self->query_builder; |
|
1106 |
- $query = $builder->build_query($source); |
|
1107 |
- |
|
1108 |
- # Remove reserved word quote |
|
1109 |
- if (my $q = $self->_quote) { |
|
1110 |
- $q = quotemeta($q); |
|
1111 |
- $_ =~ s/[$q]//g for @{$query->columns} |
|
1112 |
- } |
|
1113 |
- |
|
1114 |
- # Save query to cache |
|
1115 |
- $self->cache_method->( |
|
1116 |
- $self, $source, |
|
1117 |
- { |
|
1118 |
- sql => $query->sql, |
|
1119 |
- columns => $query->columns, |
|
1120 |
- tables => $query->{tables} || [] |
|
1121 |
- } |
|
1122 |
- ) if $cache; |
|
1123 |
- } |
|
1124 |
- |
|
1125 |
- # Save sql |
|
1126 |
- $self->last_sql($query->sql); |
|
1127 |
- |
|
1128 |
- # Prepare statement handle |
|
1129 |
- my $sth; |
|
1130 |
- eval { $sth = $self->dbh->prepare($query->{sql})}; |
|
1131 |
- |
|
1132 |
- if ($@) { |
|
1133 |
- $self->_croak($@, qq{. Following SQL is executed.\n} |
|
1134 |
- . qq{$query->{sql}\n} . _subname); |
|
1135 |
- } |
|
1136 |
- |
|
1137 |
- # Set statement handle |
|
1138 |
- $query->sth($sth); |
|
1139 |
- |
|
1140 |
- # Set filters |
|
1141 |
- $query->{filters} = $self->filters; |
|
1142 |
- |
|
1143 |
- return $query; |
|
1144 |
-} |
|
1145 |
- |
|
1146 |
-sub _create_bind_values { |
|
1147 |
- my ($self, $params, $columns, $filter, $type_filters, $bind_type) = @_; |
|
1148 |
- |
|
1149 |
- # Create bind values |
|
1150 |
- my $bind = []; |
|
1151 |
- my $count = {}; |
|
1152 |
- my $not_exists = {}; |
|
1153 |
- foreach my $column (@$columns) { |
|
1154 |
- |
|
1155 |
- # Value |
|
1156 |
- my $value; |
|
1157 |
- if(ref $params->{$column} eq 'ARRAY') { |
|
1158 |
- my $i = $count->{$column} || 0; |
|
1159 |
- $i += $not_exists->{$column} || 0; |
|
1160 |
- my $found; |
|
1161 |
- for (my $k = $i; $i < @{$params->{$column}}; $k++) { |
|
1162 |
- if (ref $params->{$column}->[$k] eq 'DBIx::Custom::NotExists') { |
|
1163 |
- $not_exists->{$column}++; |
|
1164 |
- } |
|
1165 |
- else { |
|
1166 |
- $value = $params->{$column}->[$k]; |
|
1167 |
- $found = 1; |
|
1168 |
- last |
|
1169 |
- } |
|
1170 |
- } |
|
1171 |
- next unless $found; |
|
1172 |
- } |
|
1173 |
- else { $value = $params->{$column} } |
|
1174 |
- |
|
1175 |
- # Filter |
|
1176 |
- my $f = $filter->{$column} || $self->{default_out_filter} || ''; |
|
1177 |
- $value = $f->($value) if $f; |
|
1178 |
- |
|
1179 |
- # Type rule |
|
1180 |
- foreach my $i (1 .. 2) { |
|
1181 |
- my $type_filter = $type_filters->{$i}; |
|
1182 |
- my $tf = $self->{"_into$i"}->{dot}->{$column} || $type_filter->{$column}; |
|
1183 |
- $value = $tf->($value) if $tf; |
|
1184 |
- } |
|
1185 |
- |
|
1186 |
- # Bind values |
|
1187 |
- push @$bind, {value => $value, bind_type => $bind_type->{$column}}; |
|
1188 |
- |
|
1189 |
- # Count up |
|
1190 |
- $count->{$column}++; |
|
1191 |
- } |
|
1192 |
- |
|
1193 |
- return $bind; |
|
1194 |
-} |
|
1195 |
- |
|
1196 |
-sub _create_param_from_id { |
|
1197 |
- my ($self, $id, $primary_keys) = @_; |
|
1198 |
- |
|
1199 |
- # Create parameter |
|
1200 |
- my $param = {}; |
|
1201 |
- if (defined $id) { |
|
1202 |
- $id = [$id] unless ref $id; |
|
1203 |
- croak qq{"id" must be constant value or array reference} |
|
1204 |
- . " (" . (caller 1)[3] . ")" |
|
1205 |
- unless !ref $id || ref $id eq 'ARRAY'; |
|
1206 |
- croak qq{"id" must contain values same count as primary key} |
|
1207 |
- . " (" . (caller 1)[3] . ")" |
|
1208 |
- unless @$primary_keys eq @$id; |
|
1209 |
- for(my $i = 0; $i < @$primary_keys; $i ++) { |
|
1210 |
- $param->{$primary_keys->[$i]} = $id->[$i]; |
|
1211 |
- } |
|
1212 |
- } |
|
1213 |
- |
|
1214 |
- return $param; |
|
1215 |
-} |
|
1216 |
- |
|
1217 |
-sub _connect { |
|
1218 |
- my $self = shift; |
|
1219 |
- |
|
1220 |
- # Attributes |
|
1221 |
- my $dsn = $self->data_source; |
|
1222 |
- warn "data_source is DEPRECATED!\n" |
|
1223 |
- if $dsn; |
|
1224 |
- $dsn ||= $self->dsn; |
|
1225 |
- croak qq{"dsn" must be specified } . _subname |
|
1226 |
- unless $dsn; |
|
1227 |
- my $user = $self->user; |
|
1228 |
- my $password = $self->password; |
|
1229 |
- my $dbi_option = {%{$self->dbi_options}, %{$self->dbi_option}}; |
|
1230 |
- warn "dbi_options is DEPRECATED! use dbi_option instead\n" |
|
1231 |
- if keys %{$self->dbi_options}; |
|
1232 |
- |
|
1233 |
- # Connect |
|
1234 |
- my $dbh = eval {DBI->connect( |
|
1235 |
- $dsn, |
|
1236 |
- $user, |
|
1237 |
- $password, |
|
1238 |
- { |
|
1239 |
- %{$self->default_dbi_option}, |
|
1240 |
- %$dbi_option |
|
1241 |
- } |
|
1242 |
- )}; |
|
1243 |
- |
|
1244 |
- # Connect error |
|
1245 |
- croak "$@ " . _subname if $@; |
|
1246 |
- |
|
1247 |
- return $dbh; |
|
1248 |
-} |
|
1249 |
- |
|
1250 |
-sub _croak { |
|
1251 |
- my ($self, $error, $append) = @_; |
|
1252 |
- |
|
1253 |
- # Append |
|
1254 |
- $append ||= ""; |
|
1255 |
- |
|
1256 |
- # Verbose |
|
1257 |
- if ($Carp::Verbose) { croak $error } |
|
1258 |
- |
|
1259 |
- # Not verbose |
|
1260 |
- else { |
|
1261 |
- |
|
1262 |
- # Remove line and module infromation |
|
1263 |
- my $at_pos = rindex($error, ' at '); |
|
1264 |
- $error = substr($error, 0, $at_pos); |
|
1265 |
- $error =~ s/\s+$//; |
|
1266 |
- croak "$error$append"; |
|
1267 |
- } |
|
1268 |
-} |
|
1269 |
- |
|
1270 |
-sub _need_tables { |
|
1271 |
- my ($self, $tree, $need_tables, $tables) = @_; |
|
1272 |
- |
|
1273 |
- # Get needed tables |
|
1274 |
- foreach my $table (@$tables) { |
|
1275 |
- if ($tree->{$table}) { |
|
1276 |
- $need_tables->{$table} = 1; |
|
1277 |
- $self->_need_tables($tree, $need_tables, [$tree->{$table}{parent}]) |
|
1278 |
- } |
|
1279 |
- } |
|
1280 |
-} |
|
1281 |
- |
|
1282 |
-sub _push_join { |
|
1283 |
- my ($self, $sql, $join, $join_tables) = @_; |
|
1284 |
- |
|
1285 |
- # No join |
|
1286 |
- return unless @$join; |
|
1287 |
- |
|
1288 |
- # Push join clause |
|
1289 |
- my $tree = {}; |
|
1290 |
- for (my $i = 0; $i < @$join; $i++) { |
|
1291 |
- |
|
1292 |
- # Arrange |
|
1293 |
- my $join_clause;; |
|
1294 |
- my $option; |
|
1295 |
- if (ref $join->[$i] eq 'HASH') { |
|
1296 |
- $join_clause = $join->[$i]->{clause}; |
|
1297 |
- $option = {table => $join->[$i]->{table}}; |
|
1298 |
- } |
|
1299 |
- else { |
|
1300 |
- $join_clause = $join->[$i]; |
|
1301 |
- $option = {}; |
|
1302 |
- }; |
|
1303 |
- |
|
1304 |
- # Find tables in join clause |
|
1305 |
- my $table1; |
|
1306 |
- my $table2; |
|
1307 |
- if (my $table = $option->{table}) { |
|
1308 |
- $table1 = $table->[0]; |
|
1309 |
- $table2 = $table->[1]; |
|
1310 |
- } |
|
1311 |
- else { |
|
1312 |
- my $q = $self->_quote; |
|
1313 |
- my $j_clause = (split /\s+on\s+/, $join_clause)[-1]; |
|
1314 |
- $j_clause =~ s/'.+?'//g; |
|
1315 |
- my $q_re = quotemeta($q); |
|
1316 |
- $j_clause =~ s/[$q_re]//g; |
|
1317 |
- my $c = $self->safety_character; |
|
1318 |
- my $join_re = qr/(?:^|\s)($c+)\.$c+\s+=\s+($c+)\.$c+/; |
|
1319 |
- if ($j_clause =~ $join_re) { |
|
1320 |
- $table1 = $1; |
|
1321 |
- $table2 = $2; |
|
1322 |
- } |
|
1323 |
- } |
|
1324 |
- croak qq{join clause must have two table name after "on" keyword. } . |
|
1325 |
- qq{"$join_clause" is passed } . _subname |
|
1326 |
- unless defined $table1 && defined $table2; |
|
1327 |
- croak qq{right side table of "$join_clause" must be unique } |
|
1328 |
- . _subname |
|
1329 |
- if exists $tree->{$table2}; |
|
1330 |
- croak qq{Same table "$table1" is specified} . _subname |
|
1331 |
- if $table1 eq $table2; |
|
1332 |
- $tree->{$table2} |
|
1333 |
- = {position => $i, parent => $table1, join => $join_clause}; |
|
1334 |
- } |
|
1335 |
- |
|
1336 |
- # Search need tables |
|
1337 |
- my $need_tables = {}; |
|
1338 |
- $self->_need_tables($tree, $need_tables, $join_tables); |
|
1339 |
- my @need_tables = sort { $tree->{$a}{position} <=> $tree->{$b}{position} } keys %$need_tables; |
|
1340 |
- |
|
1341 |
- # Add join clause |
|
1342 |
- foreach my $need_table (@need_tables) { |
|
1343 |
- push @$sql, $tree->{$need_table}{join}; |
|
1344 |
- } |
|
1345 |
-} |
|
1346 |
- |
|
1347 |
-sub _quote { |
|
1348 |
- my $self = shift; |
|
1349 |
- |
|
1350 |
- return defined $self->reserved_word_quote ? $self->reserved_word_quote |
|
1351 |
- : defined $self->quote ? $self->quote |
|
1352 |
- : ''; |
|
1353 |
-} |
|
1354 |
- |
|
1355 |
-sub _q { |
|
1356 |
- my ($self, $value) = @_; |
|
1357 |
- |
|
1358 |
- my $quote = $self->_quote; |
|
1359 |
- my $q = substr($quote, 0, 1) || ''; |
|
1360 |
- my $p; |
|
1361 |
- if (defined $quote && length $quote > 1) { |
|
1362 |
- $p = substr($quote, 1, 1); |
|
1363 |
- } |
|
1364 |
- else { $p = $q } |
|
1365 |
- |
|
1366 |
- return "$q$value$p"; |
|
1367 |
-} |
|
1368 |
- |
|
1369 |
-sub _remove_duplicate_table { |
|
1370 |
- my ($self, $tables, $main_table) = @_; |
|
1371 |
- |
|
1372 |
- # Remove duplicate table |
|
1373 |
- my %tables = map {defined $_ ? ($_ => 1) : ()} @$tables; |
|
1374 |
- delete $tables{$main_table} if $main_table; |
|
1375 |
- |
|
1376 |
- my $new_tables = [keys %tables, $main_table ? $main_table : ()]; |
|
1377 |
- if (my $q = $self->_quote) { |
|
1378 |
- $q = quotemeta($q); |
|
1379 |
- $_ =~ s/[$q]//g for @$new_tables; |
|
1380 |
- } |
|
1381 |
- |
|
1382 |
- return $new_tables; |
|
1383 |
-} |
|
1384 |
- |
|
1385 |
-sub _search_tables { |
|
1386 |
- my ($self, $source) = @_; |
|
1387 |
- |
|
1388 |
- # Search tables |
|
1389 |
- my $tables = []; |
|
1390 |
- my $safety_character = $self->safety_character; |
|
1391 |
- my $q = $self->_quote; |
|
1392 |
- my $q_re = quotemeta($q); |
|
1393 |
- my $quoted_safety_character_re = $self->_q("?([$safety_character]+)"); |
|
1394 |
- my $table_re = $q ? qr/(?:^|[^$safety_character])$quoted_safety_character_re?\./ |
|
1395 |
- : qr/(?:^|[^$safety_character])([$safety_character]+)\./; |
|
1396 |
- while ($source =~ /$table_re/g) { |
|
1397 |
- push @$tables, $1; |
|
1398 |
- } |
|
1399 |
- |
|
1400 |
- return $tables; |
|
1401 |
-} |
|
1402 |
- |
|
1403 |
-sub _where_to_obj { |
|
1404 |
- my ($self, $where) = @_; |
|
1405 |
- |
|
1406 |
- my $obj; |
|
1407 |
- |
|
1408 |
- # Hash |
|
1409 |
- if (ref $where eq 'HASH') { |
|
1410 |
- my $clause = ['and']; |
|
1411 |
- my $q = $self->_quote; |
|
1412 |
- foreach my $column (keys %$where) { |
|
1413 |
- my $column_quote = $self->_q($column); |
|
1414 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
1415 |
- push @$clause, "$column_quote = :$column" for keys %$where; |
|
1416 |
- } |
|
1417 |
- $obj = $self->where(clause => $clause, param => $where); |
|
1418 |
- } |
|
1419 |
- |
|
1420 |
- # DBIx::Custom::Where object |
|
1421 |
- elsif (ref $where eq 'DBIx::Custom::Where') { |
|
1422 |
- $obj = $where; |
|
1423 |
- } |
|
1424 |
- |
|
1425 |
- # Array |
|
1426 |
- elsif (ref $where eq 'ARRAY') { |
|
1427 |
- $obj = $self->where( |
|
1428 |
- clause => $where->[0], |
|
1429 |
- param => $where->[1] |
|
1430 |
- ); |
|
1431 |
- } |
|
1432 |
- |
|
1433 |
- # Check where argument |
|
1434 |
- croak qq{"where" must be hash reference or DBIx::Custom::Where object} |
|
1435 |
- . qq{or array reference, which contains where clause and parameter} |
|
1436 |
- . _subname |
|
1437 |
- unless ref $obj eq 'DBIx::Custom::Where'; |
|
1438 |
- |
|
1439 |
- return $obj; |
|
1440 |
-} |
|
1441 |
- |
|
1442 |
-sub _apply_filter { |
|
1443 |
- my ($self, $table, @cinfos) = @_; |
|
1444 |
- |
|
1445 |
- # Initialize filters |
|
1446 |
- $self->{filter} ||= {}; |
|
1447 |
- $self->{filter}{on} = 1; |
|
1448 |
- $self->{filter}{out} ||= {}; |
|
1449 |
- $self->{filter}{in} ||= {}; |
|
1450 |
- $self->{filter}{end} ||= {}; |
|
1451 |
- |
|
1452 |
- # Usage |
|
1453 |
- my $usage = "Usage: \$dbi->apply_filter(" . |
|
1454 |
- "TABLE, COLUMN1, {in => INFILTER1, out => OUTFILTER1, end => ENDFILTER1}, " . |
|
1455 |
- "COLUMN2, {in => INFILTER2, out => OUTFILTER2, end => ENDFILTER2}, ...)"; |
|
1456 |
- |
|
1457 |
- # Apply filter |
|
1458 |
- for (my $i = 0; $i < @cinfos; $i += 2) { |
|
1459 |
- |
|
1460 |
- # Column |
|
1461 |
- my $column = $cinfos[$i]; |
|
1462 |
- if (ref $column eq 'ARRAY') { |
|
1463 |
- foreach my $c (@$column) { |
|
1464 |
- push @cinfos, $c, $cinfos[$i + 1]; |
|
1465 |
- } |
|
1466 |
- next; |
|
1467 |
- } |
|
1468 |
- |
|
1469 |
- # Filter infomation |
|
1470 |
- my $finfo = $cinfos[$i + 1] || {}; |
|
1471 |
- croak "$usage (table: $table) " . _subname |
|
1472 |
- unless ref $finfo eq 'HASH'; |
|
1473 |
- foreach my $ftype (keys %$finfo) { |
|
1474 |
- croak "$usage (table: $table) " . _subname |
|
1475 |
- unless $ftype eq 'in' || $ftype eq 'out' || $ftype eq 'end'; |
|
1476 |
- } |
|
1477 |
- |
|
1478 |
- # Set filters |
|
1479 |
- foreach my $way (qw/in out end/) { |
|
1480 |
- |
|
1481 |
- # Filter |
|
1482 |
- my $filter = $finfo->{$way}; |
|
1483 |
- |
|
1484 |
- # Filter state |
|
1485 |
- my $state = !exists $finfo->{$way} ? 'not_exists' |
|
1486 |
- : !defined $filter ? 'not_defined' |
|
1487 |
- : ref $filter eq 'CODE' ? 'code' |
|
1488 |
- : 'name'; |
|
1489 |
- |
|
1490 |
- # Filter is not exists |
|
1491 |
- next if $state eq 'not_exists'; |
|
1492 |
- |
|
1493 |
- # Check filter name |
|
1494 |
- croak qq{Filter "$filter" is not registered } . _subname |
|
1495 |
- if $state eq 'name' |
|
1496 |
- && ! exists $self->filters->{$filter}; |
|
1497 |
- |
|
1498 |
- # Set filter |
|
1499 |
- my $f = $state eq 'not_defined' ? undef |
|
1500 |
- : $state eq 'code' ? $filter |
|
1501 |
- : $self->filters->{$filter}; |
|
1502 |
- $self->{filter}{$way}{$table}{$column} = $f; |
|
1503 |
- $self->{filter}{$way}{$table}{"$table.$column"} = $f; |
|
1504 |
- $self->{filter}{$way}{$table}{"${table}__$column"} = $f; |
|
1505 |
- $self->{filter}{$way}{$table}{"${table}-$column"} = $f; |
|
1506 |
- } |
|
1507 |
- } |
|
1508 |
- |
|
1509 |
- return $self; |
|
1510 |
-} |
|
1511 |
- |
|
1512 |
-# DEPRECATED! |
|
1513 |
-sub create_query { |
|
1514 |
- warn "create_query is DEPRECATED! use query option of each method"; |
|
1515 |
- shift->_create_query(@_); |
|
1516 |
-} |
|
1517 |
- |
|
1518 |
-# DEPRECATED! |
|
1519 |
-sub apply_filter { |
|
1520 |
- my $self = shift; |
|
1521 |
- |
|
1522 |
- warn "apply_filter is DEPRECATED!"; |
|
1523 |
- return $self->_apply_filter(@_); |
|
1524 |
-} |
|
1525 |
- |
|
1526 |
-# DEPRECATED! |
|
1527 |
-our %SELECT_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1528 |
-sub select_at { |
|
1529 |
- my ($self, %args) = @_; |
|
1530 |
- |
|
1531 |
- warn "select_at is DEPRECATED! use update and id option instead"; |
|
1532 |
- |
|
1533 |
- # Arguments |
|
1534 |
- my $primary_keys = delete $args{primary_key}; |
|
1535 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1536 |
- my $where = delete $args{where}; |
|
1537 |
- my $param = delete $args{param}; |
|
1538 |
- |
|
1539 |
- # Check arguments |
|
1540 |
- foreach my $name (keys %args) { |
|
1541 |
- croak qq{"$name" is wrong option } . _subname |
|
1542 |
- unless $SELECT_AT_ARGS{$name}; |
|
1543 |
- } |
|
1544 |
- |
|
1545 |
- # Table |
|
1546 |
- croak qq{"table" option must be specified } . _subname |
|
1547 |
- unless $args{table}; |
|
1548 |
- my $table = ref $args{table} ? $args{table}->[-1] : $args{table}; |
|
1549 |
- |
|
1550 |
- # Create where parameter |
|
1551 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1552 |
- |
|
1553 |
- return $self->select(where => $where_param, %args); |
|
1554 |
-} |
|
1555 |
- |
|
1556 |
-# DEPRECATED! |
|
1557 |
-our %DELETE_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1558 |
-sub delete_at { |
|
1559 |
- my ($self, %args) = @_; |
|
1560 |
- |
|
1561 |
- warn "delete_at is DEPRECATED! use update and id option instead"; |
|
1562 |
- |
|
1563 |
- # Arguments |
|
1564 |
- my $primary_keys = delete $args{primary_key}; |
|
1565 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1566 |
- my $where = delete $args{where}; |
|
1567 |
- |
|
1568 |
- # Check arguments |
|
1569 |
- foreach my $name (keys %args) { |
|
1570 |
- croak qq{"$name" is wrong option } . _subname |
|
1571 |
- unless $DELETE_AT_ARGS{$name}; |
|
1572 |
- } |
|
1573 |
- |
|
1574 |
- # Create where parameter |
|
1575 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1576 |
- |
|
1577 |
- return $self->delete(where => $where_param, %args); |
|
1578 |
-} |
|
1579 |
- |
|
1580 |
-# DEPRECATED! |
|
1581 |
-our %UPDATE_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1582 |
-sub update_at { |
|
1583 |
- my $self = shift; |
|
1584 |
- |
|
1585 |
- warn "update_at is DEPRECATED! use update and id option instead"; |
|
1586 |
- |
|
1587 |
- # Arguments |
|
1588 |
- my $param; |
|
1589 |
- $param = shift if @_ % 2; |
|
1590 |
- my %args = @_; |
|
1591 |
- my $primary_keys = delete $args{primary_key}; |
|
1592 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1593 |
- my $where = delete $args{where}; |
|
1594 |
- my $p = delete $args{param} || {}; |
|
1595 |
- $param ||= $p; |
|
1596 |
- |
|
1597 |
- # Check arguments |
|
1598 |
- foreach my $name (keys %args) { |
|
1599 |
- croak qq{"$name" is wrong option } . _subname |
|
1600 |
- unless $UPDATE_AT_ARGS{$name}; |
|
1601 |
- } |
|
1602 |
- |
|
1603 |
- # Create where parameter |
|
1604 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1605 |
- |
|
1606 |
- return $self->update(where => $where_param, param => $param, %args); |
|
1607 |
-} |
|
1608 |
- |
|
1609 |
-# DEPRECATED! |
|
1610 |
-our %INSERT_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1611 |
-sub insert_at { |
|
1612 |
- my $self = shift; |
|
1613 |
- |
|
1614 |
- warn "insert_at is DEPRECATED! use insert and id option instead"; |
|
1615 |
- |
|
1616 |
- # Arguments |
|
1617 |
- my $param; |
|
1618 |
- $param = shift if @_ % 2; |
|
1619 |
- my %args = @_; |
|
1620 |
- my $primary_key = delete $args{primary_key}; |
|
1621 |
- $primary_key = [$primary_key] unless ref $primary_key; |
|
1622 |
- my $where = delete $args{where}; |
|
1623 |
- my $p = delete $args{param} || {}; |
|
1624 |
- $param ||= $p; |
|
1625 |
- |
|
1626 |
- # Check arguments |
|
1627 |
- foreach my $name (keys %args) { |
|
1628 |
- croak qq{"$name" is wrong option } . _subname |
|
1629 |
- unless $INSERT_AT_ARGS{$name}; |
|
1630 |
- } |
|
1631 |
- |
|
1632 |
- # Create where parameter |
|
1633 |
- my $where_param = $self->_create_param_from_id($where, $primary_key); |
|
1634 |
- $param = $self->merge_param($where_param, $param); |
|
1635 |
- |
|
1636 |
- return $self->insert(param => $param, %args); |
|
1637 |
-} |
|
1638 |
- |
|
1639 |
-# DEPRECATED! |
|
1640 |
-sub register_tag { |
|
1641 |
- warn "register_tag is DEPRECATED!"; |
|
1642 |
- shift->query_builder->register_tag(@_) |
|
1643 |
-} |
|
1644 |
- |
|
1645 |
-# DEPRECATED! |
|
1646 |
-has 'data_source'; |
|
1647 |
-has dbi_options => sub { {} }; |
|
1648 |
-has filter_check => 1; |
|
1649 |
-has 'reserved_word_quote'; |
|
1650 |
- |
|
1651 |
-# DEPRECATED! |
|
1652 |
-sub default_bind_filter { |
|
1653 |
- my $self = shift; |
|
1654 |
- |
|
1655 |
- warn "default_bind_filter is DEPRECATED!"; |
|
1656 |
- |
|
1657 |
- if (@_) { |
|
1658 |
- my $fname = $_[0]; |
|
1659 |
- |
|
1660 |
- if (@_ && !$fname) { |
|
1661 |
- $self->{default_out_filter} = undef; |
|
1662 |
- } |
|
1663 |
- else { |
|
1664 |
- croak qq{Filter "$fname" is not registered} |
|
1665 |
- unless exists $self->filters->{$fname}; |
|
1666 |
- |
|
1667 |
- $self->{default_out_filter} = $self->filters->{$fname}; |
|
1668 |
- } |
|
1669 |
- return $self; |
|
1670 |
- } |
|
1671 |
- |
|
1672 |
- return $self->{default_out_filter}; |
|
1673 |
-} |
|
1674 |
- |
|
1675 |
-# DEPRECATED! |
|
1676 |
-sub default_fetch_filter { |
|
1677 |
- my $self = shift; |
|
1678 |
- |
|
1679 |
- warn "default_fetch_filter is DEPRECATED!"; |
|
1680 |
- |
|
1681 |
- if (@_) { |
|
1682 |
- my $fname = $_[0]; |
|
1683 |
- |
|
1684 |
- if (@_ && !$fname) { |
|
1685 |
- $self->{default_in_filter} = undef; |
|
1686 |
- } |
|
1687 |
- else { |
|
1688 |
- croak qq{Filter "$fname" is not registered} |
|
1689 |
- unless exists $self->filters->{$fname}; |
|
1690 |
- |
|
1691 |
- $self->{default_in_filter} = $self->filters->{$fname}; |
|
1692 |
- } |
|
1693 |
- |
|
1694 |
- return $self; |
|
1695 |
- } |
|
1696 |
- |
|
1697 |
- return $self->{default_in_filter}; |
|
1698 |
-} |
|
1699 |
- |
|
1700 |
-# DEPRECATED! |
|
1701 |
-sub insert_param_tag { |
|
1702 |
- warn "insert_param_tag is DEPRECATED! " . |
|
1703 |
- "use insert_param instead!"; |
|
1704 |
- return shift->insert_param(@_); |
|
1705 |
-} |
|
1706 |
- |
|
1707 |
-# DEPRECATED! |
|
1708 |
-sub register_tag_processor { |
|
1709 |
- warn "register_tag_processor is DEPRECATED!"; |
|
1710 |
- return shift->query_builder->register_tag_processor(@_); |
|
1711 |
-} |
|
1712 |
- |
|
1713 |
-# DEPRECATED! |
|
1714 |
-sub update_param_tag { |
|
1715 |
- warn "update_param_tag is DEPRECATED! " . |
|
1716 |
- "use update_param instead"; |
|
1717 |
- return shift->update_param(@_); |
|
1718 |
-} |
|
1719 |
-# DEPRECATED! |
|
1720 |
-sub _push_relation { |
|
1721 |
- my ($self, $sql, $tables, $relation, $need_where) = @_; |
|
1722 |
- |
|
1723 |
- if (keys %{$relation || {}}) { |
|
1724 |
- push @$sql, $need_where ? 'where' : 'and'; |
|
1725 |
- foreach my $rcolumn (keys %$relation) { |
|
1726 |
- my $table1 = (split (/\./, $rcolumn))[0]; |
|
1727 |
- my $table2 = (split (/\./, $relation->{$rcolumn}))[0]; |
|
1728 |
- push @$tables, ($table1, $table2); |
|
1729 |
- push @$sql, ("$rcolumn = " . $relation->{$rcolumn}, 'and'); |
|
1730 |
- } |
|
1731 |
- } |
|
1732 |
- pop @$sql if $sql->[-1] eq 'and'; |
|
1733 |
-} |
|
1734 |
- |
|
1735 |
-# DEPRECATED! |
|
1736 |
-sub _add_relation_table { |
|
1737 |
- my ($self, $tables, $relation) = @_; |
|
1738 |
- |
|
1739 |
- if (keys %{$relation || {}}) { |
|
1740 |
- foreach my $rcolumn (keys %$relation) { |
|
1741 |
- my $table1 = (split (/\./, $rcolumn))[0]; |
|
1742 |
- my $table2 = (split (/\./, $relation->{$rcolumn}))[0]; |
|
1743 |
- my $table1_exists; |
|
1744 |
- my $table2_exists; |
|
1745 |
- foreach my $table (@$tables) { |
|
1746 |
- $table1_exists = 1 if $table eq $table1; |
|
1747 |
- $table2_exists = 1 if $table eq $table2; |
|
1748 |
- } |
|
1749 |
- unshift @$tables, $table1 unless $table1_exists; |
|
1750 |
- unshift @$tables, $table2 unless $table2_exists; |
|
1751 |
- } |
|
1752 |
- } |
|
1753 |
-} |
|
1754 |
- |
|
1755 |
-1; |
|
1756 |
- |
|
1757 |
-=head1 NAME |
|
1758 |
- |
|
1759 |
-DBIx::Custom - Execute insert, update, delete, and select statement easily |
|
1760 |
- |
|
1761 |
-=head1 SYNOPSYS |
|
1762 |
- |
|
1763 |
- use DBIx::Custom; |
|
1764 |
- |
|
1765 |
- # Connect |
|
1766 |
- my $dbi = DBIx::Custom->connect( |
|
1767 |
- dsn => "dbi:mysql:database=dbname", |
|
1768 |
- user => 'ken', |
|
1769 |
- password => '!LFKD%$&', |
|
1770 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
1771 |
- ); |
|
1772 |
- |
|
1773 |
- # Insert |
|
1774 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
1775 |
- |
|
1776 |
- # Update |
|
1777 |
- $dbi->update({title => 'Perl', author => 'Ken'}, table => 'book', |
|
1778 |
- where => {id => 5}); |
|
1779 |
- |
|
1780 |
- # Delete |
|
1781 |
- $dbi->delete(table => 'book', where => {author => 'Ken'}); |
|
1782 |
- |
|
1783 |
- # Select |
|
1784 |
- my $result = $dbi->select(table => 'book', |
|
1785 |
- column => ['title', 'author'], where => {author => 'Ken'}); |
|
1786 |
- |
|
1787 |
- # Select, more complex |
|
1788 |
- my $result = $dbi->select( |
|
1789 |
- table => 'book', |
|
1790 |
- column => [ |
|
1791 |
- {book => [qw/title author/]}, |
|
1792 |
- {company => ['name']} |
|
1793 |
- ], |
|
1794 |
- where => {'book.author' => 'Ken'}, |
|
1795 |
- join => ['left outer join company on book.company_id = company.id'], |
|
1796 |
- append => 'order by id limit 5' |
|
1797 |
- ); |
|
1798 |
- |
|
1799 |
- # Fetch |
|
1800 |
- while (my $row = $result->fetch) { |
|
1801 |
- |
|
1802 |
- } |
|
1803 |
- |
|
1804 |
- # Fetch as hash |
|
1805 |
- while (my $row = $result->fetch_hash) { |
|
1806 |
- |
|
1807 |
- } |
|
1808 |
- |
|
1809 |
- # Execute SQL with parameter. |
|
1810 |
- $dbi->execute( |
|
1811 |
- "select id from book where author = :author and title like :title", |
|
1812 |
- {author => 'ken', title => '%Perl%'} |
|
1813 |
- ); |
|
1814 |
- |
|
1815 |
-=head1 DESCRIPTIONS |
|
1816 |
- |
|
1817 |
-L<DBIx::Custom> is L<DBI> wrapper module to execute SQL easily. |
|
1818 |
-This module have the following features. |
|
1819 |
- |
|
1820 |
-=over 4 |
|
1821 |
- |
|
1822 |
-=item * |
|
1823 |
- |
|
1824 |
-Execute C<insert>, C<update>, C<delete>, or C<select> statement easily |
|
1825 |
- |
|
1826 |
-=item * |
|
1827 |
- |
|
1828 |
-Create C<where> clause flexibly |
|
1829 |
- |
|
1830 |
-=item * |
|
1831 |
- |
|
1832 |
-Named place holder support |
|
1833 |
- |
|
1834 |
-=item * |
|
1835 |
- |
|
1836 |
-Model support |
|
1837 |
- |
|
1838 |
-=item * |
|
1839 |
- |
|
1840 |
-Connection manager support |
|
1841 |
- |
|
1842 |
-=item * |
|
1843 |
- |
|
1844 |
-Choice your favorite relational database management system, |
|
1845 |
-C<MySQL>, C<SQLite>, C<PostgreSQL>, C<Oracle>, |
|
1846 |
-C<Microsoft SQL Server>, C<Microsoft Access>, C<DB2> or anything, |
|
1847 |
- |
|
1848 |
-=item * |
|
1849 |
- |
|
1850 |
-Filtering by data type or column name(EXPERIMENTAL) |
|
1851 |
- |
|
1852 |
-=item * |
|
1853 |
- |
|
1854 |
-Create C<order by> clause flexibly(EXPERIMENTAL) |
|
1855 |
- |
|
1856 |
-=back |
|
1857 |
- |
|
1858 |
-=head1 DOCUMENTATIONS |
|
1859 |
- |
|
1860 |
-L<DBIx::Custom::Guide> - How to use L<DBIx::Custom> |
|
1861 |
- |
|
1862 |
-L<DBIx::Custom Wiki|https://github.com/yuki-kimoto/DBIx-Custom/wiki> |
|
1863 |
-- Theare are various examples. |
|
1864 |
- |
|
1865 |
-Module documentations - |
|
1866 |
-L<DBIx::Custom::Result>, |
|
1867 |
-L<DBIx::Custom::Query>, |
|
1868 |
-L<DBIx::Custom::Where>, |
|
1869 |
-L<DBIx::Custom::Model>, |
|
1870 |
-L<DBIx::Custom::Order> |
|
1871 |
- |
|
1872 |
-=head1 ATTRIBUTES |
|
1873 |
- |
|
1874 |
-=head2 C<connector> |
|
1875 |
- |
|
1876 |
- my $connector = $dbi->connector; |
|
1877 |
- $dbi = $dbi->connector($connector); |
|
1878 |
- |
|
1879 |
-Connection manager object. if C<connector> is set, you can get C<dbh> |
|
1880 |
-through connection manager. Conection manager object must have C<dbh> mehtod. |
|
1881 |
- |
|
1882 |
-This is L<DBIx::Connector> example. Please pass |
|
1883 |
-C<default_dbi_option> to L<DBIx::Connector> C<new> method. |
|
1884 |
- |
|
1885 |
- my $connector = DBIx::Connector->new( |
|
1886 |
- "dbi:mysql:database=$DATABASE", |
|
1887 |
- $USER, |
|
1888 |
- $PASSWORD, |
|
1889 |
- DBIx::Custom->new->default_dbi_option |
|
1890 |
- ); |
|
1891 |
- |
|
1892 |
- my $dbi = DBIx::Custom->connect(connector => $connector); |
|
1893 |
- |
|
1894 |
-=head2 C<dsn> |
|
1895 |
- |
|
1896 |
- my $dsn = $dbi->dsn; |
|
1897 |
- $dbi = $dbi->dsn("DBI:mysql:database=dbname"); |
|
1898 |
- |
|
1899 |
-Data source name, used when C<connect> method is executed. |
|
1900 |
- |
|
1901 |
-=head2 C<dbi_option> |
|
1902 |
- |
|
1903 |
- my $dbi_option = $dbi->dbi_option; |
|
1904 |
- $dbi = $dbi->dbi_option($dbi_option); |
|
1905 |
- |
|
1906 |
-L<DBI> option, used when C<connect> method is executed. |
|
1907 |
-Each value in option override the value of C<default_dbi_option>. |
|
1908 |
- |
|
1909 |
-=head2 C<default_dbi_option> |
|
1910 |
- |
|
1911 |
- my $default_dbi_option = $dbi->default_dbi_option; |
|
1912 |
- $dbi = $dbi->default_dbi_option($default_dbi_option); |
|
1913 |
- |
|
1914 |
-L<DBI> default option, used when C<connect> method is executed, |
|
1915 |
-default to the following values. |
|
1916 |
- |
|
1917 |
- { |
|
1918 |
- RaiseError => 1, |
|
1919 |
- PrintError => 0, |
|
1920 |
- AutoCommit => 1, |
|
1921 |
- } |
|
1922 |
- |
|
1923 |
-=head2 C<filters> |
|
1924 |
- |
|
1925 |
- my $filters = $dbi->filters; |
|
1926 |
- $dbi = $dbi->filters(\%filters); |
|
1927 |
- |
|
1928 |
-Filters, registered by C<register_filter> method. |
|
1929 |
- |
|
1930 |
-=head2 C<last_sql> |
|
1931 |
- |
|
1932 |
- my $last_sql = $dbi->last_sql; |
|
1933 |
- $dbi = $dbi->last_sql($last_sql); |
|
1934 |
- |
|
1935 |
-Get last successed SQL executed by C<execute> method. |
|
1936 |
- |
|
1937 |
-=head2 C<models> |
|
1938 |
- |
|
1939 |
- my $models = $dbi->models; |
|
1940 |
- $dbi = $dbi->models(\%models); |
|
1941 |
- |
|
1942 |
-Models, included by C<include_model> method. |
|
1943 |
- |
|
1944 |
-=head2 C<password> |
|
1945 |
- |
|
1946 |
- my $password = $dbi->password; |
|
1947 |
- $dbi = $dbi->password('lkj&le`@s'); |
|
1948 |
- |
|
1949 |
-Password, used when C<connect> method is executed. |
|
1950 |
- |
|
1951 |
-=head2 C<query_builder> |
|
1952 |
- |
|
1953 |
- my $sql_class = $dbi->query_builder; |
|
1954 |
- $dbi = $dbi->query_builder(DBIx::Custom::QueryBuilder->new); |
|
1955 |
- |
|
1956 |
-Query builder, default to L<DBIx::Custom::QueryBuilder> object. |
|
1957 |
- |
|
1958 |
-=head2 C<quote> |
|
1959 |
- |
|
1960 |
- my quote = $dbi->quote; |
|
1961 |
- $dbi = $dbi->quote('"'); |
|
1962 |
- |
|
1963 |
-Reserved word quote. |
|
1964 |
-Default to double quote '"' except for mysql. |
|
1965 |
-In mysql, default to back quote '`' |
|
1966 |
- |
|
1967 |
-You can set quote pair. |
|
1968 |
- |
|
1969 |
- $dbi->quote('[]'); |
|
1970 |
- |
|
1971 |
-=head2 C<result_class> |
|
1972 |
- |
|
1973 |
- my $result_class = $dbi->result_class; |
|
1974 |
- $dbi = $dbi->result_class('DBIx::Custom::Result'); |
|
1975 |
- |
|
1976 |
-Result class, default to L<DBIx::Custom::Result>. |
|
1977 |
- |
|
1978 |
-=head2 C<safety_character> |
|
1979 |
- |
|
1980 |
- my $safety_character = $self->safety_character; |
|
1981 |
- $dbi = $self->safety_character($character); |
|
1982 |
- |
|
1983 |
-Regex of safety character for table and column name, default to '\w'. |
|
1984 |
-Note that you don't have to specify like '[\w]'. |
|
1985 |
- |
|
1986 |
-=head2 C<tag_parse> |
|
1987 |
- |
|
1988 |
- my $tag_parse = $dbi->tag_parse(0); |
|
1989 |
- $dbi = $dbi->tag_parse; |
|
1990 |
- |
|
1991 |
-Enable DEPRECATED tag parsing functionality, default to 1. |
|
1992 |
-If you want to disable tag parsing functionality, set to 0. |
|
1993 |
- |
|
1994 |
-=head2 C<user> |
|
1995 |
- |
|
1996 |
- my $user = $dbi->user; |
|
1997 |
- $dbi = $dbi->user('Ken'); |
|
1998 |
- |
|
1999 |
-User name, used when C<connect> method is executed. |
|
2000 |
- |
|
2001 |
-=head1 METHODS |
|
2002 |
- |
|
2003 |
-L<DBIx::Custom> inherits all methods from L<Object::Simple> |
|
2004 |
-and use all methods of L<DBI> |
|
2005 |
-and implements the following new ones. |
|
2006 |
- |
|
2007 |
-=head2 C<available_data_type> EXPERIMENTAL |
|
2008 |
- |
|
2009 |
- print $dbi->available_data_type; |
|
2010 |
- |
|
2011 |
-Get available data types. You can use these data types |
|
2012 |
-in C<type rule>'s C<from1> and C<from2> section. |
|
2013 |
- |
|
2014 |
-=head2 C<available_type_name> EXPERIMENTAL |
|
2015 |
- |
|
2016 |
- print $dbi->available_type_name; |
|
2017 |
- |
|
2018 |
-Get available type names. You can use these type names in |
|
2019 |
-C<type_rule>'s C<into1> and C<into2> section. |
|
2020 |
- |
|
2021 |
-=head2 C<assign_param> EXPERIMENTAL |
|
2022 |
- |
|
2023 |
- my $assign_param = $dbi->assign_param({title => 'a', age => 2}); |
|
2024 |
- |
|
2025 |
-Create assign parameter. |
|
2026 |
- |
|
2027 |
- title = :title, author = :author |
|
2028 |
- |
|
2029 |
-This is equal to C<update_param> exept that set is not added. |
|
2030 |
- |
|
2031 |
-=head2 C<column> |
|
2032 |
- |
|
2033 |
- my $column = $dbi->column(book => ['author', 'title']); |
|
2034 |
- |
|
2035 |
-Create column clause. The follwoing column clause is created. |
|
2036 |
- |
|
2037 |
- book.author as "book.author", |
|
2038 |
- book.title as "book.title" |
|
2039 |
- |
|
2040 |
-You can change separator by C<separator> method. |
|
2041 |
- |
|
2042 |
- # Separator is double underbar |
|
2043 |
- $dbi->separator('__'); |
|
2044 |
- |
|
2045 |
- book.author as "book__author", |
|
2046 |
- book.title as "book__title" |
|
2047 |
- |
|
2048 |
- # Separator is hyphen |
|
2049 |
- $dbi->separator('-'); |
|
2050 |
- |
|
2051 |
- book.author as "book-author", |
|
2052 |
- book.title as "book-title" |
|
2053 |
- |
|
2054 |
-=head2 C<connect> |
|
2055 |
- |
|
2056 |
- my $dbi = DBIx::Custom->connect( |
|
2057 |
- dsn => "dbi:mysql:database=dbname", |
|
2058 |
- user => 'ken', |
|
2059 |
- password => '!LFKD%$&', |
|
2060 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
2061 |
- ); |
|
2062 |
- |
|
2063 |
-Connect to the database and create a new L<DBIx::Custom> object. |
|
2064 |
- |
|
2065 |
-L<DBIx::Custom> is a wrapper of L<DBI>. |
|
2066 |
-C<AutoCommit> and C<RaiseError> options are true, |
|
2067 |
-and C<PrintError> option is false by default. |
|
2068 |
- |
|
2069 |
-=head2 create_model |
|
2070 |
- |
|
2071 |
- my $model = $dbi->create_model( |
|
2072 |
- table => 'book', |
|
2073 |
- primary_key => 'id', |
|
2074 |
- join => [ |
|
2075 |
- 'inner join company on book.comparny_id = company.id' |
|
2076 |
- ], |
|
2077 |
- ); |
|
2078 |
- |
|
2079 |
-Create L<DBIx::Custom::Model> object and initialize model. |
|
2080 |
-the module is also used from C<model> method. |
|
2081 |
- |
|
2082 |
- $dbi->model('book')->select(...); |
|
2083 |
- |
|
2084 |
-=head2 C<dbh> |
|
2085 |
- |
|
2086 |
- my $dbh = $dbi->dbh; |
|
2087 |
- |
|
2088 |
-Get L<DBI> database handle. if C<connector> is set, you can get |
|
2089 |
-database handle through C<connector> object. |
|
2090 |
- |
|
2091 |
-=head2 C<each_column> |
|
2092 |
- |
|
2093 |
- $dbi->each_column( |
|
2094 |
- sub { |
|
2095 |
- my ($dbi, $table, $column, $column_info) = @_; |
|
2096 |
- |
|
2097 |
- my $type = $column_info->{TYPE_NAME}; |
|
2098 |
- |
|
2099 |
- if ($type eq 'DATE') { |
|
2100 |
- # ... |
|
2101 |
- } |
|
2102 |
- } |
|
2103 |
- ); |
|
2104 |
- |
|
2105 |
-Iterate all column informations of all table from database. |
|
2106 |
-Argument is callback when one column is found. |
|
2107 |
-Callback receive four arguments, dbi object, table name, |
|
2108 |
-column name and column information. |
|
2109 |
- |
|
2110 |
-=head2 C<each_table> |
|
2111 |
- |
|
2112 |
- $dbi->each_table( |
|
2113 |
- sub { |
|
2114 |
- my ($dbi, $table, $table_info) = @_; |
|
2115 |
- |
|
2116 |
- my $table_name = $table_info->{TABLE_NAME}; |
|
2117 |
- } |
|
2118 |
- ); |
|
2119 |
- |
|
2120 |
-Iterate all table informationsfrom database. |
|
2121 |
-Argument is callback when one table is found. |
|
2122 |
-Callback receive three arguments, dbi object, table name, |
|
2123 |
-table information. |
|
2124 |
- |
|
2125 |
-=head2 C<execute> |
|
2126 |
- |
|
2127 |
- my $result = $dbi->execute( |
|
2128 |
- "select * from book where title = :title and author like :author", |
|
2129 |
- {title => 'Perl', author => '%Ken%'} |
|
2130 |
- ); |
|
2131 |
- |
|
2132 |
- my $result = $dbi->execute( |
|
2133 |
- "select * from book where title = :book.title and author like :book.author", |
|
2134 |
- {'book.title' => 'Perl', 'book.author' => '%Ken%'} |
|
2135 |
- ); |
|
2136 |
- |
|
2137 |
-Execute SQL. SQL can contain column parameter such as :author and :title. |
|
2138 |
-You can append table name to column name such as :book.title and :book.author. |
|
2139 |
-Second argunet is data, embedded into column parameter. |
|
2140 |
-Return value is L<DBIx::Custom::Result> object when select statement is executed, |
|
2141 |
-or the count of affected rows when insert, update, delete statement is executed. |
|
2142 |
- |
|
2143 |
-Named placeholder such as C<:title> is replaced by placeholder C<?>. |
|
2144 |
- |
|
2145 |
- # Original |
|
2146 |
- select * from book where title = :title and author like :author |
|
2147 |
- |
|
2148 |
- # Replaced |
|
2149 |
- select * from where title = ? and author like ?; |
|
2150 |
- |
|
2151 |
-You can specify operator with named placeholder |
|
2152 |
- by C<name{operator}> syntax. |
|
2153 |
- |
|
2154 |
- # Original |
|
2155 |
- select * from book where :title{=} and :author{like} |
|
2156 |
- |
|
2157 |
- # Replaced |
|
2158 |
- select * from where title = ? and author like ?; |
|
2159 |
- |
|
2160 |
-Note that colons in time format such as 12:13:15 is exeption, |
|
2161 |
-it is not parsed as named placeholder. |
|
2162 |
-If you want to use colon generally, you must escape it by C<\\> |
|
2163 |
- |
|
2164 |
- select * from where title = "aa\\:bb"; |
|
2165 |
- |
|
2166 |
-The following opitons are available. |
|
2167 |
- |
|
2168 |
-=over 4 |
|
2169 |
- |
|
2170 |
-=item C<filter> |
|
2171 |
- |
|
2172 |
- filter => { |
|
2173 |
- title => sub { uc $_[0] } |
|
2174 |
- author => sub { uc $_[0] } |
|
2175 |
- } |
|
2176 |
- |
|
2177 |
- # Filter name |
|
2178 |
- filter => { |
|
2179 |
- title => 'upper_case', |
|
2180 |
- author => 'upper_case' |
|
2181 |
- } |
|
2182 |
- |
|
2183 |
- # At once |
|
2184 |
- filter => [ |
|
2185 |
- [qw/title author/] => sub { uc $_[0] } |
|
2186 |
- ] |
|
2187 |
- |
|
2188 |
-Filter. You can set subroutine or filter name |
|
2189 |
-registered by by C<register_filter>. |
|
2190 |
-This filter is executed before data is saved into database. |
|
2191 |
-and before type rule filter is executed. |
|
2192 |
- |
|
2193 |
-=item C<query> |
|
2194 |
- |
|
2195 |
- query => 1 |
|
2196 |
- |
|
2197 |
-C<execute> method return L<DBIx::Custom::Query> object, not executing SQL. |
|
2198 |
-You can check SQL or get statment handle. |
|
2199 |
- |
|
2200 |
- my $sql = $query->sql; |
|
2201 |
- my $sth = $query->sth; |
|
2202 |
- my $columns = $query->columns; |
|
2203 |
- |
|
2204 |
-If you want to execute SQL fast, you can do the following way. |
|
2205 |
- |
|
2206 |
- my $query; |
|
2207 |
- foreach my $row (@$rows) { |
|
2208 |
- $query ||= $dbi->insert($row, table => 'table1', query => 1); |
|
2209 |
- $dbi->execute($query, $row, filter => {ab => sub { $_[0] * 2 }}); |
|
2210 |
- } |
|
2211 |
- |
|
2212 |
-Statement handle is reused and SQL parsing is finished, |
|
2213 |
-so you can get more performance than normal way. |
|
2214 |
- |
|
2215 |
-If you want to execute SQL as possible as fast and don't need filtering. |
|
2216 |
-You can do the following way. |
|
2217 |
- |
|
2218 |
- my $query; |
|
2219 |
- my $sth; |
|
2220 |
- foreach my $row (@$rows) { |
|
2221 |
- $query ||= $dbi->insert($row, table => 'book', query => 1); |
|
2222 |
- $sth ||= $query->sth; |
|
2223 |
- $sth->execute(map { $row->{$_} } sort keys %$row); |
|
2224 |
- } |
|
2225 |
- |
|
2226 |
-Note that $row must be simple hash reference, such as |
|
2227 |
-{title => 'Perl', author => 'Ken'}. |
|
2228 |
-and don't forget to sort $row values by $row key asc order. |
|
2229 |
- |
|
2230 |
-=item C<table> |
|
2231 |
- |
|
2232 |
- table => 'author' |
|
2233 |
- |
|
2234 |
-If you want to omit table name in column name |
|
2235 |
-and enable C<into1> and C<into2> type filter, |
|
2236 |
-You must set C<table> option. |
|
2237 |
- |
|
2238 |
- $dbi->execute("select * from book where title = :title and author = :author", |
|
2239 |
- {title => 'Perl', author => 'Ken', table => 'book'); |
|
2240 |
- |
|
2241 |
- # Same |
|
2242 |
- $dbi->execute( |
|
2243 |
- "select * from book where title = :book.title and author = :book.author", |
|
2244 |
- {title => 'Perl', author => 'Ken'); |
|
2245 |
- |
|
2246 |
-=item C<bind_type> |
|
2247 |
- |
|
2248 |
-Specify database bind data type. |
|
2249 |
- |
|
2250 |
- bind_type => [image => DBI::SQL_BLOB] |
|
2251 |
- bind_type => [[qw/image audio/] => DBI::SQL_BLOB] |
|
2252 |
- |
|
2253 |
-This is used to bind parameter by C<bind_param> of statment handle. |
|
2254 |
- |
|
2255 |
- $sth->bind_param($pos, $value, DBI::SQL_BLOB); |
|
2256 |
- |
|
2257 |
-=item C<table_alias> EXPERIMENTAL |
|
2258 |
- |
|
2259 |
- table_alias => {user => 'hiker'} |
|
2260 |
- |
|
2261 |
-Table alias. Key is real table name, value is alias table name. |
|
2262 |
-If you set C<table_alias>, you can enable C<into1> and C<into2> type rule |
|
2263 |
-on alias table name. |
|
2264 |
- |
|
2265 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2266 |
- |
|
2267 |
- type_rule_off => 1 |
|
2268 |
- |
|
2269 |
-Turn C<into1> and C<into2> type rule off. |
|
2270 |
- |
|
2271 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2272 |
- |
|
2273 |
- type_rule1_off => 1 |
|
2274 |
- |
|
2275 |
-Turn C<into1> type rule off. |
|
2276 |
- |
|
2277 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2278 |
- |
|
2279 |
- type_rule2_off => 1 |
|
2280 |
- |
|
2281 |
-Turn C<into2> type rule off. |
|
2282 |
- |
|
2283 |
-=back |
|
2284 |
- |
|
2285 |
-=head2 C<delete> |
|
2286 |
- |
|
2287 |
- $dbi->delete(table => 'book', where => {title => 'Perl'}); |
|
2288 |
- |
|
2289 |
-Execute delete statement. |
|
2290 |
- |
|
2291 |
-The following opitons are available. |
|
2292 |
- |
|
2293 |
-=over 4 |
|
2294 |
- |
|
2295 |
-=item C<append> |
|
2296 |
- |
|
2297 |
-Same as C<select> method's C<append> option. |
|
2298 |
- |
|
2299 |
-=item C<filter> |
|
2300 |
- |
|
2301 |
-Same as C<execute> method's C<filter> option. |
|
2302 |
- |
|
2303 |
-=item C<id> |
|
2304 |
- |
|
2305 |
- id => 4 |
|
2306 |
- id => [4, 5] |
|
2307 |
- |
|
2308 |
-ID corresponding to C<primary_key>. |
|
2309 |
-You can delete rows by C<id> and C<primary_key>. |
|
2310 |
- |
|
2311 |
- $dbi->delete( |
|
2312 |
- parimary_key => ['id1', 'id2'], |
|
2313 |
- id => [4, 5], |
|
2314 |
- table => 'book', |
|
2315 |
- ); |
|
2316 |
- |
|
2317 |
-The above is same as the followin one. |
|
2318 |
- |
|
2319 |
- $dbi->delete(where => {id1 => 4, id2 => 5}, table => 'book'); |
|
2320 |
- |
|
2321 |
-=item C<prefix> |
|
2322 |
- |
|
2323 |
- prefix => 'some' |
|
2324 |
- |
|
2325 |
-prefix before table name section. |
|
2326 |
- |
|
2327 |
- delete some from book |
|
2328 |
- |
|
2329 |
-=item C<query> |
|
2330 |
- |
|
2331 |
-Same as C<execute> method's C<query> option. |
|
2332 |
- |
|
2333 |
-=item C<table> |
|
2334 |
- |
|
2335 |
- table => 'book' |
|
2336 |
- |
|
2337 |
-Table name. |
|
2338 |
- |
|
2339 |
-=item C<where> |
|
2340 |
- |
|
2341 |
-Same as C<select> method's C<where> option. |
|
2342 |
- |
|
2343 |
-=item C<primary_key> |
|
2344 |
- |
|
2345 |
-See C<id> option. |
|
2346 |
- |
|
2347 |
-=item C<bind_type> |
|
2348 |
- |
|
2349 |
-Same as C<execute> method's C<bind_type> option. |
|
2350 |
- |
|
2351 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2352 |
- |
|
2353 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2354 |
- |
|
2355 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2356 |
- |
|
2357 |
- type_rule1_off => 1 |
|
2358 |
- |
|
2359 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2360 |
- |
|
2361 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2362 |
- |
|
2363 |
- type_rule2_off => 1 |
|
2364 |
- |
|
2365 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2366 |
- |
|
2367 |
-=back |
|
2368 |
- |
|
2369 |
-=head2 C<delete_all> |
|
2370 |
- |
|
2371 |
- $dbi->delete_all(table => $table); |
|
2372 |
- |
|
2373 |
-Execute delete statement for all rows. |
|
2374 |
-Options is same as C<delete>. |
|
2375 |
- |
|
2376 |
-=head2 C<insert> |
|
2377 |
- |
|
2378 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
2379 |
- |
|
2380 |
-Execute insert statement. First argument is row data. Return value is |
|
2381 |
-affected row count. |
|
2382 |
- |
|
2383 |
-If you want to set constant value to row data, use scalar reference |
|
2384 |
-as parameter value. |
|
2385 |
- |
|
2386 |
- {date => \"NOW()"} |
|
2387 |
- |
|
2388 |
-The following opitons are available. |
|
2389 |
- |
|
2390 |
-=over 4 |
|
2391 |
- |
|
2392 |
-=item C<append> |
|
2393 |
- |
|
2394 |
-Same as C<select> method's C<append> option. |
|
2395 |
- |
|
2396 |
-=item C<filter> |
|
2397 |
- |
|
2398 |
-Same as C<execute> method's C<filter> option. |
|
2399 |
- |
|
2400 |
-=item C<id> |
|
2401 |
- |
|
2402 |
- id => 4 |
|
2403 |
- id => [4, 5] |
|
2404 |
- |
|
2405 |
-ID corresponding to C<primary_key>. |
|
2406 |
-You can insert a row by C<id> and C<primary_key>. |
|
2407 |
- |
|
2408 |
- $dbi->insert( |
|
2409 |
- {title => 'Perl', author => 'Ken'} |
|
2410 |
- parimary_key => ['id1', 'id2'], |
|
2411 |
- id => [4, 5], |
|
2412 |
- table => 'book' |
|
2413 |
- ); |
|
2414 |
- |
|
2415 |
-The above is same as the followin one. |
|
2416 |
- |
|
2417 |
- $dbi->insert( |
|
2418 |
- {id1 => 4, id2 => 5, title => 'Perl', author => 'Ken'}, |
|
2419 |
- table => 'book' |
|
2420 |
- ); |
|
2421 |
- |
|
2422 |
-=item C<prefix> |
|
2423 |
- |
|
2424 |
- prefix => 'or replace' |
|
2425 |
- |
|
2426 |
-prefix before table name section |
|
2427 |
- |
|
2428 |
- insert or replace into book |
|
2429 |
- |
|
2430 |
-=item C<primary_key> |
|
2431 |
- |
|
2432 |
- primary_key => 'id' |
|
2433 |
- primary_key => ['id1', 'id2'] |
|
2434 |
- |
|
2435 |
-Primary key. This is used by C<id> option. |
|
2436 |
- |
|
2437 |
-=item C<query> |
|
2438 |
- |
|
2439 |
-Same as C<execute> method's C<query> option. |
|
2440 |
- |
|
2441 |
-=item C<table> |
|
2442 |
- |
|
2443 |
- table => 'book' |
|
2444 |
- |
|
2445 |
-Table name. |
|
2446 |
- |
|
2447 |
-=item C<bind_type> |
|
2448 |
- |
|
2449 |
-Same as C<execute> method's C<bind_type> option. |
|
2450 |
- |
|
2451 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2452 |
- |
|
2453 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2454 |
- |
|
2455 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2456 |
- |
|
2457 |
- type_rule1_off => 1 |
|
2458 |
- |
|
2459 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2460 |
- |
|
2461 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2462 |
- |
|
2463 |
- type_rule2_off => 1 |
|
2464 |
- |
|
2465 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2466 |
- |
|
2467 |
-=back |
|
2468 |
- |
|
2469 |
-=over 4 |
|
2470 |
- |
|
2471 |
-=head2 C<insert_param> |
|
2472 |
- |
|
2473 |
- my $insert_param = $dbi->insert_param({title => 'a', age => 2}); |
|
2474 |
- |
|
2475 |
-Create insert parameters. |
|
2476 |
- |
|
2477 |
- (title, author) values (title = :title, age = :age); |
|
2478 |
- |
|
2479 |
-=head2 C<include_model> |
|
2480 |
- |
|
2481 |
- $dbi->include_model('MyModel'); |
|
2482 |
- |
|
2483 |
-Include models from specified namespace, |
|
2484 |
-the following layout is needed to include models. |
|
2485 |
- |
|
2486 |
- lib / MyModel.pm |
|
2487 |
- / MyModel / book.pm |
|
2488 |
- / company.pm |
|
2489 |
- |
|
2490 |
-Name space module, extending L<DBIx::Custom::Model>. |
|
2491 |
- |
|
2492 |
-B<MyModel.pm> |
|
2493 |
- |
|
2494 |
- package MyModel; |
|
2495 |
- use DBIx::Custom::Model -base; |
|
2496 |
- |
|
2497 |
- 1; |
|
2498 |
- |
|
2499 |
-Model modules, extending name space module. |
|
2500 |
- |
|
2501 |
-B<MyModel/book.pm> |
|
2502 |
- |
|
2503 |
- package MyModel::book; |
|
2504 |
- use MyModel -base; |
|
2505 |
- |
|
2506 |
- 1; |
|
2507 |
- |
|
2508 |
-B<MyModel/company.pm> |
|
2509 |
- |
|
2510 |
- package MyModel::company; |
|
2511 |
- use MyModel -base; |
|
2512 |
- |
|
2513 |
- 1; |
|
2514 |
- |
|
2515 |
-MyModel::book and MyModel::company is included by C<include_model>. |
|
2516 |
- |
|
2517 |
-You can get model object by C<model>. |
|
2518 |
- |
|
2519 |
- my $book_model = $dbi->model('book'); |
|
2520 |
- my $company_model = $dbi->model('company'); |
|
2521 |
- |
|
2522 |
-See L<DBIx::Custom::Model> to know model features. |
|
2523 |
- |
|
2524 |
-=head2 C<map_param> EXPERIMENTAL |
|
2525 |
- |
|
2526 |
- my $map_param = $dbi->map_param( |
|
2527 |
- {id => 1, authro => 'Ken', price => 1900}, |
|
2528 |
- 'id' => 'book.id', |
|
2529 |
- 'author' => ['book.author' => sub { '%' . $_[0] . '%' }], |
|
2530 |
- 'price' => [ |
|
2531 |
- 'book.price', {if => sub { length $_[0] }} |
|
2532 |
- ] |
|
2533 |
- ); |
|
2534 |
- |
|
2535 |
-Map paramters to other key and value. First argument is original |
|
2536 |
-parameter. this is hash reference. Rest argument is mapping. |
|
2537 |
-By default, Mapping is done if the value length is not zero. |
|
2538 |
- |
|
2539 |
-=over 4 |
|
2540 |
- |
|
2541 |
-=item Key mapping |
|
2542 |
- |
|
2543 |
- 'id' => 'book.id' |
|
2544 |
- |
|
2545 |
-This is only key mapping. Value is same as original one. |
|
2546 |
- |
|
2547 |
- (id => 1) is mapped to ('book.id' => 1) if value length is not zero. |
|
2548 |
- |
|
2549 |
-=item Key and value mapping |
|
2550 |
- |
|
2551 |
- 'author' => ['book.author' => sub { '%' . $_[0] . '%' }] |
|
2552 |
- |
|
2553 |
-This is key and value mapping. Frist element of array reference |
|
2554 |
-is mapped key name, second element is code reference to map the value. |
|
2555 |
- |
|
2556 |
- (author => 'Ken') is mapped to ('book.author' => '%Ken%') |
|
2557 |
- if value length is not zero. |
|
2558 |
- |
|
2559 |
-=item Condition |
|
2560 |
- |
|
2561 |
- 'price' => ['book.price', {if => 'exists'}] |
|
2562 |
- 'price' => ['book.price', sub { '%' . $_[0] . '%' }, {if => 'exists'}] |
|
2563 |
- 'price' => ['book.price', {if => sub { defined shift }}] |
|
2564 |
- |
|
2565 |
-If you need condition, you can sepecify it. this is code reference |
|
2566 |
-or 'exists'. By default, condition is the following one. |
|
2567 |
- |
|
2568 |
- sub { defined $_[0] && length $_[0] } |
|
2569 |
- |
|
2570 |
-=back |
|
2571 |
- |
|
2572 |
-=head2 C<merge_param> |
|
2573 |
- |
|
2574 |
- my $param = $dbi->merge_param({key1 => 1}, {key1 => 1, key2 => 2}); |
|
2575 |
- |
|
2576 |
-Merge parameters. |
|
2577 |
- |
|
2578 |
- {key1 => [1, 1], key2 => 2} |
|
2579 |
- |
|
2580 |
-=head2 C<method> |
|
2581 |
- |
|
2582 |
- $dbi->method( |
|
2583 |
- update_or_insert => sub { |
|
2584 |
- my $self = shift; |
|
2585 |
- |
|
2586 |
- # Process |
|
2587 |
- }, |
|
2588 |
- find_or_create => sub { |
|
2589 |
- my $self = shift; |
|
2590 |
- |
|
2591 |
- # Process |
|
2592 |
- } |
|
2593 |
- ); |
|
2594 |
- |
|
2595 |
-Register method. These method is called directly from L<DBIx::Custom> object. |
|
2596 |
- |
|
2597 |
- $dbi->update_or_insert; |
|
2598 |
- $dbi->find_or_create; |
|
2599 |
- |
|
2600 |
-=head2 C<model> |
|
2601 |
- |
|
2602 |
- my $model = $dbi->model('book'); |
|
2603 |
- |
|
2604 |
-Get a L<DBIx::Custom::Model> object, |
|
2605 |
- |
|
2606 |
-=head2 C<mycolumn> |
|
2607 |
- |
|
2608 |
- my $column = $self->mycolumn(book => ['author', 'title']); |
|
2609 |
- |
|
2610 |
-Create column clause for myself. The follwoing column clause is created. |
|
2611 |
- |
|
2612 |
- book.author as author, |
|
2613 |
- book.title as title |
|
2614 |
- |
|
2615 |
-=head2 C<new> |
|
2616 |
- |
|
2617 |
- my $dbi = DBIx::Custom->new( |
|
2618 |
- dsn => "dbi:mysql:database=dbname", |
|
2619 |
- user => 'ken', |
|
2620 |
- password => '!LFKD%$&', |
|
2621 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
2622 |
- ); |
|
2623 |
- |
|
2624 |
-Create a new L<DBIx::Custom> object. |
|
2625 |
- |
|
2626 |
-=head2 C<not_exists> |
|
2627 |
- |
|
2628 |
- my $not_exists = $dbi->not_exists; |
|
2629 |
- |
|
2630 |
-DBIx::Custom::NotExists object, indicating the column is not exists. |
|
2631 |
-This is used by C<clause> of L<DBIx::Custom::Where> . |
|
2632 |
- |
|
2633 |
-=head2 C<order> EXPERIMENTAL |
|
2634 |
- |
|
2635 |
- my $order = $dbi->order; |
|
2636 |
- |
|
2637 |
-Create a new L<DBIx::Custom::Order> object. |
|
2638 |
- |
|
2639 |
-=head2 C<register_filter> |
|
2640 |
- |
|
2641 |
- $dbi->register_filter( |
|
2642 |
- # Time::Piece object to database DATE format |
|
2643 |
- tp_to_date => sub { |
|
2644 |
- my $tp = shift; |
|
2645 |
- return $tp->strftime('%Y-%m-%d'); |
|
2646 |
- }, |
|
2647 |
- # database DATE format to Time::Piece object |
|
2648 |
- date_to_tp => sub { |
|
2649 |
- my $date = shift; |
|
2650 |
- return Time::Piece->strptime($date, '%Y-%m-%d'); |
|
2651 |
- } |
|
2652 |
- ); |
|
2653 |
- |
|
2654 |
-Register filters, used by C<filter> option of many methods. |
|
2655 |
- |
|
2656 |
-=head2 C<type_rule> EXPERIMENTAL |
|
2657 |
- |
|
2658 |
- $dbi->type_rule( |
|
2659 |
- into1 => { |
|
2660 |
- date => sub { ... }, |
|
2661 |
- datetime => sub { ... } |
|
2662 |
- }, |
|
2663 |
- into2 => { |
|
2664 |
- date => sub { ... }, |
|
2665 |
- datetime => sub { ... } |
|
2666 |
- }, |
|
2667 |
- from1 => { |
|
2668 |
- # DATE |
|
2669 |
- 9 => sub { ... }, |
|
2670 |
- # DATETIME or TIMESTAMP |
|
2671 |
- 11 => sub { ... }, |
|
2672 |
- } |
|
2673 |
- from2 => { |
|
2674 |
- # DATE |
|
2675 |
- 9 => sub { ... }, |
|
2676 |
- # DATETIME or TIMESTAMP |
|
2677 |
- 11 => sub { ... }, |
|
2678 |
- } |
|
2679 |
- ); |
|
2680 |
- |
|
2681 |
-Filtering rule when data is send into and get from database. |
|
2682 |
-This has a little complex problem. |
|
2683 |
- |
|
2684 |
-In C<into1> and C<into2> you can specify |
|
2685 |
-type name as same as type name defined |
|
2686 |
-by create table, such as C<DATETIME> or C<DATE>. |
|
2687 |
- |
|
2688 |
-Note that type name and data type don't contain upper case. |
|
2689 |
-If these contain upper case charactor, you convert it to lower case. |
|
2690 |
- |
|
2691 |
-C<into2> is executed after C<into1>. |
|
2692 |
- |
|
2693 |
-Type rule of C<into1> and C<into2> is enabled on the following |
|
2694 |
-column name. |
|
2695 |
- |
|
2696 |
-=over 4 |
|
2697 |
- |
|
2698 |
-=item 1. column name |
|
2699 |
- |
|
2700 |
- issue_date |
|
2701 |
- issue_datetime |
|
2702 |
- |
|
2703 |
-This need C<table> option in each method. |
|
2704 |
- |
|
2705 |
-=item 2. table name and column name, separator is dot |
|
2706 |
- |
|
2707 |
- book.issue_date |
|
2708 |
- book.issue_datetime |
|
2709 |
- |
|
2710 |
-=back |
|
2711 |
- |
|
2712 |
-You get all type name used in database by C<available_type_name>. |
|
2713 |
- |
|
2714 |
- print $dbi->available_type_name; |
|
2715 |
- |
|
2716 |
-In C<from1> and C<from2> you specify data type, not type name. |
|
2717 |
-C<from2> is executed after C<from1>. |
|
2718 |
-You get all data type by C<available_data_type>. |
|
2719 |
- |
|
2720 |
- print $dbi->available_data_type; |
|
2721 |
- |
|
2722 |
-You can also specify multiple types at once. |
|
2723 |
- |
|
2724 |
- $dbi->type_rule( |
|
2725 |
- into1 => [ |
|
2726 |
- [qw/DATE DATETIME/] => sub { ... }, |
|
2727 |
- ], |
|
2728 |
- ); |
|
2729 |
- |
|
2730 |
-=head2 C<select> |
|
2731 |
- |
|
2732 |
- my $result = $dbi->select( |
|
2733 |
- table => 'book', |
|
2734 |
- column => ['author', 'title'], |
|
2735 |
- where => {author => 'Ken'}, |
|
2736 |
- ); |
|
2737 |
- |
|
2738 |
-Execute select statement. |
|
2739 |
- |
|
2740 |
-The following opitons are available. |
|
2741 |
- |
|
2742 |
-=over 4 |
|
2743 |
- |
|
2744 |
-=item C<append> |
|
2745 |
- |
|
2746 |
- append => 'order by title' |
|
2747 |
- |
|
2748 |
-Append statement to last of SQL. |
|
2749 |
- |
|
2750 |
-=item C<column> |
|
2751 |
- |
|
2752 |
- column => 'author' |
|
2753 |
- column => ['author', 'title'] |
|
2754 |
- |
|
2755 |
-Column clause. |
|
2756 |
- |
|
2757 |
-if C<column> is not specified, '*' is set. |
|
2758 |
- |
|
2759 |
- column => '*' |
|
2760 |
- |
|
2761 |
-You can specify hash of array reference. |
|
2762 |
- |
|
2763 |
- column => [ |
|
2764 |
- {book => [qw/author title/]}, |
|
2765 |
- {person => [qw/name age/]} |
|
2766 |
- ] |
|
2767 |
- |
|
2768 |
-This is expanded to the following one by using C<colomn> method. |
|
2769 |
- |
|
2770 |
- book.author as "book.author", |
|
2771 |
- book.title as "book.title", |
|
2772 |
- person.name as "person.name", |
|
2773 |
- person.age as "person.age" |
|
2774 |
- |
|
2775 |
-You can specify array of array reference, first argument is |
|
2776 |
-column name, second argument is alias. |
|
2777 |
- |
|
2778 |
- column => [ |
|
2779 |
- ['date(book.register_datetime)' => 'book.register_date'] |
|
2780 |
- ]; |
|
2781 |
- |
|
2782 |
-Alias is quoted properly and joined. |
|
2783 |
- |
|
2784 |
- date(book.register_datetime) as "book.register_date" |
|
2785 |
- |
|
2786 |
-=item C<filter> |
|
2787 |
- |
|
2788 |
-Same as C<execute> method's C<filter> option. |
|
2789 |
- |
|
2790 |
-=item C<id> |
|
2791 |
- |
|
2792 |
- id => 4 |
|
2793 |
- id => [4, 5] |
|
2794 |
- |
|
2795 |
-ID corresponding to C<primary_key>. |
|
2796 |
-You can select rows by C<id> and C<primary_key>. |
|
2797 |
- |
|
2798 |
- $dbi->select( |
|
2799 |
- parimary_key => ['id1', 'id2'], |
|
2800 |
- id => [4, 5], |
|
2801 |
- table => 'book' |
|
2802 |
- ); |
|
2803 |
- |
|
2804 |
-The above is same as the followin one. |
|
2805 |
- |
|
2806 |
- $dbi->select( |
|
2807 |
- where => {id1 => 4, id2 => 5}, |
|
2808 |
- table => 'book' |
|
2809 |
- ); |
|
2810 |
- |
|
2811 |
-=item C<param> EXPERIMETNAL |
|
2812 |
- |
|
2813 |
- param => {'table2.key3' => 5} |
|
2814 |
- |
|
2815 |
-Parameter shown before where clause. |
|
2816 |
- |
|
2817 |
-For example, if you want to contain tag in join clause, |
|
2818 |
-you can pass parameter by C<param> option. |
|
2819 |
- |
|
2820 |
- join => ['inner join (select * from table2 where table2.key3 = :table2.key3)' . |
|
2821 |
- ' as table2 on table1.key1 = table2.key1'] |
|
2822 |
- |
|
2823 |
-=itme C<prefix> |
|
2824 |
- |
|
2825 |
- prefix => 'SQL_CALC_FOUND_ROWS' |
|
2826 |
- |
|
2827 |
-Prefix of column cluase |
|
2828 |
- |
|
2829 |
- select SQL_CALC_FOUND_ROWS title, author from book; |
|
2830 |
- |
|
2831 |
-=item C<join> |
|
2832 |
- |
|
2833 |
- join => [ |
|
2834 |
- 'left outer join company on book.company_id = company_id', |
|
2835 |
- 'left outer join location on company.location_id = location.id' |
|
2836 |
- ] |
|
2837 |
- |
|
2838 |
-Join clause. If column cluase or where clause contain table name like "company.name", |
|
2839 |
-join clausees needed when SQL is created is used automatically. |
|
2840 |
- |
|
2841 |
- $dbi->select( |
|
2842 |
- table => 'book', |
|
2843 |
- column => ['company.location_id as location_id'], |
|
2844 |
- where => {'company.name' => 'Orange'}, |
|
2845 |
- join => [ |
|
2846 |
- 'left outer join company on book.company_id = company.id', |
|
2847 |
- 'left outer join location on company.location_id = location.id' |
|
2848 |
- ] |
|
2849 |
- ); |
|
2850 |
- |
|
2851 |
-In above select, column and where clause contain "company" table, |
|
2852 |
-the following SQL is created |
|
2853 |
- |
|
2854 |
- select company.location_id as location_id |
|
2855 |
- from book |
|
2856 |
- left outer join company on book.company_id = company.id |
|
2857 |
- where company.name = ?; |
|
2858 |
- |
|
2859 |
-You can specify two table by yourself. This is useful when join parser can't parse |
|
2860 |
-the join clause correctly. This is EXPERIMENTAL. |
|
2861 |
- |
|
2862 |
- $dbi->select( |
|
2863 |
- table => 'book', |
|
2864 |
- column => ['company.location_id as location_id'], |
|
2865 |
- where => {'company.name' => 'Orange'}, |
|
2866 |
- join => [ |
|
2867 |
- { |
|
2868 |
- clause => 'left outer join location on company.location_id = location.id', |
|
2869 |
- table => ['company', 'location'] |
|
2870 |
- } |
|
2871 |
- ] |
|
2872 |
- ); |
|
2873 |
- |
|
2874 |
-=item C<primary_key> |
|
2875 |
- |
|
2876 |
- primary_key => 'id' |
|
2877 |
- primary_key => ['id1', 'id2'] |
|
2878 |
- |
|
2879 |
-Primary key. This is used by C<id> option. |
|
2880 |
- |
|
2881 |
-=item C<query> |
|
2882 |
- |
|
2883 |
-Same as C<execute> method's C<query> option. |
|
2884 |
- |
|
2885 |
-=item C<bind_type> |
|
2886 |
- |
|
2887 |
-Same as C<execute> method's C<bind_type> option. |
|
2888 |
- |
|
2889 |
-=item C<table> |
|
2890 |
- |
|
2891 |
- table => 'book' |
|
2892 |
- |
|
2893 |
-Table name. |
|
2894 |
- |
|
2895 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2896 |
- |
|
2897 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2898 |
- |
|
2899 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2900 |
- |
|
2901 |
- type_rule1_off => 1 |
|
2902 |
- |
|
2903 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2904 |
- |
|
2905 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2906 |
- |
|
2907 |
- type_rule2_off => 1 |
|
2908 |
- |
|
2909 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2910 |
- |
|
2911 |
-=item C<where> |
|
2912 |
- |
|
2913 |
- # Hash refrence |
|
2914 |
- where => {author => 'Ken', 'title' => 'Perl'} |
|
2915 |
- |
|
2916 |
- # DBIx::Custom::Where object |
|
2917 |
- where => $dbi->where( |
|
2918 |
- clause => ['and', 'author = :author', 'title like :title'], |
|
2919 |
- param => {author => 'Ken', title => '%Perl%'} |
|
2920 |
- ); |
|
2921 |
- |
|
2922 |
- # Array reference 1 (array reference, hash referenc). same as above |
|
2923 |
- where => [ |
|
2924 |
- ['and', 'author = :author', 'title like :title'], |
|
2925 |
- {author => 'Ken', title => '%Perl%'} |
|
2926 |
- ]; |
|
2927 |
- |
|
2928 |
- # Array reference 2 (String, hash reference) |
|
2929 |
- where => [ |
|
2930 |
- 'title like :title', |
|
2931 |
- {title => '%Perl%'} |
|
2932 |
- ] |
|
2933 |
- |
|
2934 |
- # String |
|
2935 |
- where => 'title is null' |
|
2936 |
- |
|
2937 |
-Where clause. |
|
2938 |
- |
|
2939 |
-=item C<wrap> EXPERIMENTAL |
|
2940 |
- |
|
2941 |
-Wrap statement. This is array reference. |
|
2942 |
- |
|
2943 |
- $dbi->select(wrap => ['select * from (', ') as t where ROWNUM < 10']); |
|
2944 |
- |
|
2945 |
-This option is for Oracle and SQL Server paging process. |
|
2946 |
- |
|
2947 |
-=back |
|
2948 |
- |
|
2949 |
-=head2 C<update> |
|
2950 |
- |
|
2951 |
- $dbi->update({title => 'Perl'}, table => 'book', where => {id => 4}); |
|
2952 |
- |
|
2953 |
-Execute update statement. First argument is update row data. |
|
2954 |
- |
|
2955 |
-If you want to set constant value to row data, use scalar reference |
|
2956 |
-as parameter value. |
|
2957 |
- |
|
2958 |
- {date => \"NOW()"} |
|
2959 |
- |
|
2960 |
-The following opitons are available. |
|
2961 |
- |
|
2962 |
-=over 4 |
|
2963 |
- |
|
2964 |
-=item C<append> |
|
2965 |
- |
|
2966 |
-Same as C<select> method's C<append> option. |
|
2967 |
- |
|
2968 |
-=item C<filter> |
|
2969 |
- |
|
2970 |
-Same as C<execute> method's C<filter> option. |
|
2971 |
- |
|
2972 |
-=item C<id> |
|
2973 |
- |
|
2974 |
- id => 4 |
|
2975 |
- id => [4, 5] |
|
2976 |
- |
|
2977 |
-ID corresponding to C<primary_key>. |
|
2978 |
-You can update rows by C<id> and C<primary_key>. |
|
2979 |
- |
|
2980 |
- $dbi->update( |
|
2981 |
- {title => 'Perl', author => 'Ken'} |
|
2982 |
- parimary_key => ['id1', 'id2'], |
|
2983 |
- id => [4, 5], |
|
2984 |
- table => 'book' |
|
2985 |
- ); |
|
2986 |
- |
|
2987 |
-The above is same as the followin one. |
|
2988 |
- |
|
2989 |
- $dbi->update( |
|
2990 |
- {title => 'Perl', author => 'Ken'} |
|
2991 |
- where => {id1 => 4, id2 => 5}, |
|
2992 |
- table => 'book' |
|
2993 |
- ); |
|
2994 |
- |
|
2995 |
-=item C<prefix> |
|
2996 |
- |
|
2997 |
- prefix => 'or replace' |
|
2998 |
- |
|
2999 |
-prefix before table name section |
|
3000 |
- |
|
3001 |
- update or replace book |
|
3002 |
- |
|
3003 |
-=item C<primary_key> |
|
3004 |
- |
|
3005 |
- primary_key => 'id' |
|
3006 |
- primary_key => ['id1', 'id2'] |
|
3007 |
- |
|
3008 |
-Primary key. This is used by C<id> option. |
|
3009 |
- |
|
3010 |
-=item C<query> |
|
3011 |
- |
|
3012 |
-Same as C<execute> method's C<query> option. |
|
3013 |
- |
|
3014 |
-=item C<table> |
|
3015 |
- |
|
3016 |
- table => 'book' |
|
3017 |
- |
|
3018 |
-Table name. |
|
3019 |
- |
|
3020 |
-=item C<where> |
|
3021 |
- |
|
3022 |
-Same as C<select> method's C<where> option. |
|
3023 |
- |
|
3024 |
-=item C<bind_type> |
|
3025 |
- |
|
3026 |
-Same as C<execute> method's C<bind_type> option. |
|
3027 |
- |
|
3028 |
-=item C<type_rule_off> EXPERIMENTAL |
|
3029 |
- |
|
3030 |
-Same as C<execute> method's C<type_rule_off> option. |
|
3031 |
- |
|
3032 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
3033 |
- |
|
3034 |
- type_rule1_off => 1 |
|
3035 |
- |
|
3036 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
3037 |
- |
|
3038 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
3039 |
- |
|
3040 |
- type_rule2_off => 1 |
|
3041 |
- |
|
3042 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
3043 |
- |
|
3044 |
-=back |
|
3045 |
- |
|
3046 |
-=head2 C<update_all> |
|
3047 |
- |
|
3048 |
- $dbi->update_all({title => 'Perl'}, table => 'book', ); |
|
3049 |
- |
|
3050 |
-Execute update statement for all rows. |
|
3051 |
-Options is same as C<update> method. |
|
3052 |
- |
|
3053 |
-=head2 C<update_param> |
|
3054 |
- |
|
3055 |
- my $update_param = $dbi->update_param({title => 'a', age => 2}); |
|
3056 |
- |
|
3057 |
-Create update parameter tag. |
|
3058 |
- |
|
3059 |
- set title = :title, author = :author |
|
3060 |
- |
|
3061 |
-=head2 C<where> |
|
3062 |
- |
|
3063 |
- my $where = $dbi->where( |
|
3064 |
- clause => ['and', 'title = :title', 'author = :author'], |
|
3065 |
- param => {title => 'Perl', author => 'Ken'} |
|
3066 |
- ); |
|
3067 |
- |
|
3068 |
-Create a new L<DBIx::Custom::Where> object. |
|
3069 |
- |
|
3070 |
-=head2 C<setup_model> |
|
3071 |
- |
|
3072 |
- $dbi->setup_model; |
|
3073 |
- |
|
3074 |
-Setup all model objects. |
|
3075 |
-C<columns> of model object is automatically set, parsing database information. |
|
3076 |
- |
|
3077 |
-=head1 ENVIRONMENT VARIABLE |
|
3078 |
- |
|
3079 |
-=head2 C<DBIX_CUSTOM_DEBUG> |
|
3080 |
- |
|
3081 |
-If environment variable C<DBIX_CUSTOM_DEBUG> is set to true, |
|
3082 |
-executed SQL and bind values are printed to STDERR. |
|
3083 |
- |
|
3084 |
-=head2 C<DBIX_CUSTOM_DEBUG_ENCODING> |
|
3085 |
- |
|
3086 |
-DEBUG output encoding. Default to UTF-8. |
|
3087 |
- |
|
3088 |
-=head1 DEPRECATED FUNCTIONALITIES |
|
3089 |
- |
|
3090 |
-L<DBIx::Custom> |
|
3091 |
- |
|
3092 |
- # Attribute methods |
|
3093 |
- data_source # will be removed at 2017/1/1 |
|
3094 |
- dbi_options # will be removed at 2017/1/1 |
|
3095 |
- filter_check # will be removed at 2017/1/1 |
|
3096 |
- reserved_word_quote # will be removed at 2017/1/1 |
|
3097 |
- cache_method # will be removed at 2017/1/1 |
|
3098 |
- |
|
3099 |
- # Methods |
|
3100 |
- create_query # will be removed at 2017/1/1 |
|
3101 |
- apply_filter # will be removed at 2017/1/1 |
|
3102 |
- select_at # will be removed at 2017/1/1 |
|
3103 |
- delete_at # will be removed at 2017/1/1 |
|
3104 |
- update_at # will be removed at 2017/1/1 |
|
3105 |
- insert_at # will be removed at 2017/1/1 |
|
3106 |
- register_tag # will be removed at 2017/1/1 |
|
3107 |
- default_bind_filter # will be removed at 2017/1/1 |
|
3108 |
- default_fetch_filter # will be removed at 2017/1/1 |
|
3109 |
- insert_param_tag # will be removed at 2017/1/1 |
|
3110 |
- register_tag_processor # will be removed at 2017/1/1 |
|
3111 |
- update_param_tag # will be removed at 2017/1/1 |
|
3112 |
- |
|
3113 |
- # Options |
|
3114 |
- select method relation option # will be removed at 2017/1/1 |
|
3115 |
- select method param option # will be removed at 2017/1/1 |
|
3116 |
- select method column option [COLUMN, as => ALIAS] format |
|
3117 |
- # will be removed at 2017/1/1 |
|
3118 |
- |
|
3119 |
- # Others |
|
3120 |
- execute("select * from {= title}"); # execute method's |
|
3121 |
- # tag parsing functionality |
|
3122 |
- # will be removed at 2017/1/1 |
|
3123 |
- Query caching # will be removed at 2017/1/1 |
|
3124 |
- |
|
3125 |
-L<DBIx::Custom::Model> |
|
3126 |
- |
|
3127 |
- # Attribute methods |
|
3128 |
- filter # will be removed at 2017/1/1 |
|
3129 |
- name # will be removed at 2017/1/1 |
|
3130 |
- type # will be removed at 2017/1/1 |
|
3131 |
- |
|
3132 |
-L<DBIx::Custom::Query> |
|
3133 |
- |
|
3134 |
- # Attribute methods |
|
3135 |
- default_filter # will be removed at 2017/1/1 |
|
3136 |
- table # will be removed at 2017/1/1 |
|
3137 |
- filters # will be removed at 2017/1/1 |
|
3138 |
- |
|
3139 |
- # Methods |
|
3140 |
- filter # will be removed at 2017/1/1 |
|
3141 |
- |
|
3142 |
-L<DBIx::Custom::QueryBuilder> |
|
3143 |
- |
|
3144 |
- # Attribute methods |
|
3145 |
- tags # will be removed at 2017/1/1 |
|
3146 |
- tag_processors # will be removed at 2017/1/1 |
|
3147 |
- |
|
3148 |
- # Methods |
|
3149 |
- register_tag # will be removed at 2017/1/1 |
|
3150 |
- register_tag_processor # will be removed at 2017/1/1 |
|
3151 |
- |
|
3152 |
- # Others |
|
3153 |
- build_query("select * from {= title}"); # tag parsing functionality |
|
3154 |
- # will be removed at 2017/1/1 |
|
3155 |
- |
|
3156 |
-L<DBIx::Custom::Result> |
|
3157 |
- |
|
3158 |
- # Attribute methods |
|
3159 |
- filter_check # will be removed at 2017/1/1 |
|
3160 |
- |
|
3161 |
- # Methods |
|
3162 |
- end_filter # will be removed at 2017/1/1 |
|
3163 |
- remove_end_filter # will be removed at 2017/1/1 |
|
3164 |
- remove_filter # will be removed at 2017/1/1 |
|
3165 |
- default_filter # will be removed at 2017/1/1 |
|
3166 |
- |
|
3167 |
-L<DBIx::Custom::Tag> |
|
3168 |
- |
|
3169 |
- This module is DEPRECATED! # will be removed at 2017/1/1 |
|
3170 |
- |
|
3171 |
-=head1 BACKWORD COMPATIBLE POLICY |
|
3172 |
- |
|
3173 |
-If a functionality is DEPRECATED, you can know it by DEPRECATED warnings |
|
3174 |
-except for attribute method. |
|
3175 |
-You can check all DEPRECATED functionalities by document. |
|
3176 |
-DEPRECATED functionality is removed after five years, |
|
3177 |
-but if at least one person use the functionality and tell me that thing |
|
3178 |
-I extend one year each time he tell me it. |
|
3179 |
- |
|
3180 |
-EXPERIMENTAL functionality will be changed without warnings. |
|
3181 |
- |
|
3182 |
-This policy was changed at 2011/6/28 |
|
3183 |
- |
|
3184 |
-=head1 BUGS |
|
3185 |
- |
|
3186 |
-Please tell me bugs if found. |
|
3187 |
- |
|
3188 |
-C<< <kimoto.yuki at gmail.com> >> |
|
3189 |
- |
|
3190 |
-L<http://github.com/yuki-kimoto/DBIx-Custom> |
|
3191 |
- |
|
3192 |
-=head1 AUTHOR |
|
3193 |
- |
|
3194 |
-Yuki Kimoto, C<< <kimoto.yuki at gmail.com> >> |
|
3195 |
- |
|
3196 |
-=head1 COPYRIGHT & LICENSE |
|
3197 |
- |
|
3198 |
-Copyright 2009-2011 Yuki Kimoto, all rights reserved. |
|
3199 |
- |
|
3200 |
-This program is free software; you can redistribute it and/or modify it |
|
3201 |
-under the same terms as Perl itself. |
|
3202 |
- |
|
3203 |
-=cut |
... | ... |
@@ -1,603 +0,0 @@ |
1 |
-=encoding utf8 |
|
2 |
- |
|
3 |
-=head1 NAME |
|
4 |
- |
|
5 |
-DBIx::Custom::Guide - DBIx::Custom Guide |
|
6 |
- |
|
7 |
-=head1 FEATURES |
|
8 |
- |
|
9 |
-L<DBIx::Custom> is the wrapper class of L<DBI> to execute SQL easily. |
|
10 |
-This module have the following features. |
|
11 |
- |
|
12 |
-=over 4 |
|
13 |
- |
|
14 |
-=item * Execute INSERT, UPDATE, DELETE, SELECT statement easily |
|
15 |
- |
|
16 |
-=item * You can specify bind values by hash reference |
|
17 |
- |
|
18 |
-=item * Filtering by data type. and you can set filter to any column |
|
19 |
- |
|
20 |
-=item * Creating where clause and order by clause flexibly |
|
21 |
- |
|
22 |
-=item * Support model |
|
23 |
- |
|
24 |
-=back |
|
25 |
- |
|
26 |
-=head1 GUIDE |
|
27 |
- |
|
28 |
-=head2 Connect to database |
|
29 |
- |
|
30 |
- use DBIx::Custom; |
|
31 |
- my $dbi = DBIx::Custom->connect( |
|
32 |
- dsn => "dbi:mysql:database=bookshop", |
|
33 |
- user => 'ken', |
|
34 |
- password => '!LFKD%$&', |
|
35 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
36 |
- ); |
|
37 |
- |
|
38 |
-You can connect to database by C<connect> method. |
|
39 |
-C<dsn> is data source name, C<user> is user name, C<password> is password. |
|
40 |
- |
|
41 |
-C<dbi_option> is L<DBI> option. |
|
42 |
-By default, the following option is set. |
|
43 |
-Exeption is thrown when fatal error occur and commit mode is auto commit. |
|
44 |
- |
|
45 |
- { |
|
46 |
- RaiseError => 1 |
|
47 |
- PrintError => 0 |
|
48 |
- AutoCommit => 1 |
|
49 |
- } |
|
50 |
- |
|
51 |
-=head2 Execute query |
|
52 |
- |
|
53 |
-=head3 Insert Statement : C<insert> |
|
54 |
- |
|
55 |
-If you want to execute insert statement, use C<insert> method. |
|
56 |
- |
|
57 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
58 |
- |
|
59 |
-First argument is insert row data, C<table> is table name. |
|
60 |
- |
|
61 |
-=head3 Update Statement : C<update> |
|
62 |
- |
|
63 |
-If you want to execute update stateimuse, use C<update> method. |
|
64 |
- |
|
65 |
- $dbi->update( |
|
66 |
- {title => 'Perl', author => 'Ken'}, |
|
67 |
- table => 'book', |
|
68 |
- where => {id => 5} |
|
69 |
- ); |
|
70 |
- |
|
71 |
-First argument is update row data, C<table> is table name, C<where> is condition. |
|
72 |
- |
|
73 |
-Note that you can't execute C<update> method without C<where>. |
|
74 |
-If you want to update all rows, use update_all. |
|
75 |
- |
|
76 |
- $dbi->update_all({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
77 |
- |
|
78 |
-=head3 Delete Statement : C<delete> |
|
79 |
- |
|
80 |
-If you want to execute delete statement, use C<delete> method. |
|
81 |
- |
|
82 |
- $dbi->delete(table => 'book', where => {author => 'Ken'}); |
|
83 |
- |
|
84 |
-C<table> is table name, C<where> is condition. |
|
85 |
- |
|
86 |
-Note that you can't execute C<delete> method without C<where>. |
|
87 |
-If you want to delete all rows, use C<delete_all> method. |
|
88 |
- |
|
89 |
- $dbi->delete_all(table => 'book'); |
|
90 |
- |
|
91 |
-=head3 Select Statement : C<select> |
|
92 |
- |
|
93 |
-If you want to execute select statement, use C<select> method. |
|
94 |
- |
|
95 |
- my $result = $dbi->select(table => 'book'); |
|
96 |
- |
|
97 |
-Return value is L<DBIx::Custom::Result> object. |
|
98 |
-You can fetch rows by C<fetch> method. |
|
99 |
- |
|
100 |
- while (my $row = $result->fetch) { |
|
101 |
- my $title = $row->[0]; |
|
102 |
- my $author = $row->[1]; |
|
103 |
- } |
|
104 |
- |
|
105 |
-See also L<Fetch row/"Fetch row"> about L<DBIx::Custom::Result>. |
|
106 |
- |
|
107 |
-You can specify column names by C<column> option |
|
108 |
-and condition by C<where> option. |
|
109 |
- |
|
110 |
- my $result = $dbi->select( |
|
111 |
- table => 'book', |
|
112 |
- column => ['author', 'title'], |
|
113 |
- where => {author => 'Ken'} |
|
114 |
- ); |
|
115 |
- |
|
116 |
-You can specify join clause by C<join> option. |
|
117 |
- |
|
118 |
- my $result = $dbi->select( |
|
119 |
- table => 'book', |
|
120 |
- column => ['company.name as company_name'] |
|
121 |
- where => {'book.name' => 'Perl'}, |
|
122 |
- join => ['left outer join company on book.company_id = company.id] |
|
123 |
- ); |
|
124 |
- |
|
125 |
-Note that join clause is joined only when C<where> or C<column> option contains table name, |
|
126 |
-such as book.name. |
|
127 |
- |
|
128 |
-You can append statement to the end of whole statement by C<append> option. |
|
129 |
- |
|
130 |
- my $result = $dbi->select( |
|
131 |
- table => 'book', |
|
132 |
- where => {author => 'Ken'}, |
|
133 |
- append => 'for update', |
|
134 |
- ); |
|
135 |
- |
|
136 |
-=head3 C<execute> |
|
137 |
- |
|
138 |
-If you want to execute SQL, use C<execute> method. |
|
139 |
- |
|
140 |
- $dbi->execute("select * from book;"); |
|
141 |
- |
|
142 |
-You can specify named placeholder. |
|
143 |
- |
|
144 |
- $dbi->execute( |
|
145 |
- "select * from book title = :title and author = :author;" |
|
146 |
- {title => 'Perl', author => 'Ken'} |
|
147 |
- ); |
|
148 |
- |
|
149 |
-:title and :author is named placeholder, which is replaced to placeholers. |
|
150 |
- |
|
151 |
- select * from book title = ? and author = ?; |
|
152 |
- |
|
153 |
-=head3 C<dbh> |
|
154 |
- |
|
155 |
- my $dbh = $dbi->dbh; |
|
156 |
- |
|
157 |
-Get get database handle object of L<DBI>. |
|
158 |
- |
|
159 |
-=head3 C<DBI> methods |
|
160 |
- |
|
161 |
- $dbi->do(...); |
|
162 |
- $dbi->begin_work; |
|
163 |
- |
|
164 |
-You can call all methods of L<DBI> from L<DBIx::Custom> object. |
|
165 |
- |
|
166 |
-=head2 Fetch Rows |
|
167 |
- |
|
168 |
-C<select> method return value is L<DBIx::Custom::Result> object. |
|
169 |
-You can fetch a row or rows by various methods. |
|
170 |
- |
|
171 |
-=head3 Fetch a row (array) : C<fetch> |
|
172 |
- |
|
173 |
- my $row = $result->fetch; |
|
174 |
- |
|
175 |
-C<fetch> method fetch a row and put it into array reference. |
|
176 |
-You can continue to fetch |
|
177 |
- |
|
178 |
- while (my $row = $result->fetch) { |
|
179 |
- my $title = $row->[0]; |
|
180 |
- my $author = $row->[1]; |
|
181 |
- } |
|
182 |
- |
|
183 |
-=head3 Fetch only first row (array) : C<fetch_first> |
|
184 |
- |
|
185 |
- my $row = $result->fetch_first; |
|
186 |
- |
|
187 |
-C<fetch_first> fetch a only first row and finish statment handle, |
|
188 |
-and put it into array refrence. |
|
189 |
- |
|
190 |
-=head3 Fetch all rows (array) : C<fetch_all> |
|
191 |
- |
|
192 |
- my $rows = $result->fetch_all; |
|
193 |
- |
|
194 |
-C<fetch_all> fetch all rows and put them into array of array reference. |
|
195 |
- |
|
196 |
-=head3 Fetch a row (hash) : C<fetch_hash> |
|
197 |
- |
|
198 |
- my $row = $result->fetch_hash; |
|
199 |
- |
|
200 |
-C<fetch_hash> fetch a row and put it into hash reference. |
|
201 |
-You can fetch a row while row exists. |
|
202 |
- |
|
203 |
- while (my $row = $result->fetch_hash) { |
|
204 |
- my $title = $row->{title}; |
|
205 |
- my $author = $row->{author}; |
|
206 |
- } |
|
207 |
- |
|
208 |
-=head3 Fetch only a first row (hash) : C<fetch_hash_first> |
|
209 |
- |
|
210 |
- my $row = $result->fetch_hash_first; |
|
211 |
- |
|
212 |
-C<fetch_hash_first> fetch only a first row and finish statement handle, |
|
213 |
-and put them into hash refrence. |
|
214 |
- |
|
215 |
-C<one> is C<fetch_hash_first> synonym to save word typing. |
|
216 |
- |
|
217 |
- my $row = $result->one; |
|
218 |
- |
|
219 |
-=head3 Fetch all rows (hash) : C<fetch_hash_all> |
|
220 |
- |
|
221 |
- my $rows = $result->fetch_hash_all; |
|
222 |
- |
|
223 |
-C<fetch_hash_all> fetch all rows and put them into array of hash reference. |
|
224 |
- |
|
225 |
-=head3 Statement Handle : C<sth> |
|
226 |
- |
|
227 |
- my $sth = $result->sth; |
|
228 |
- |
|
229 |
-If you want to get statment handle, use <sth> method. |
|
230 |
- |
|
231 |
-=head2 Named placeholder |
|
232 |
- |
|
233 |
-=head3 Basic of Parameter |
|
234 |
- |
|
235 |
-You can embedd named placeholder into SQL. |
|
236 |
- |
|
237 |
- select * from book where title = :title and author like :author; |
|
238 |
- |
|
239 |
-:title and :author is named placeholder |
|
240 |
- |
|
241 |
-Named placeholder is replaced by place holder. |
|
242 |
- |
|
243 |
- select * from book where title = ? and author like ?; |
|
244 |
- |
|
245 |
-use C<execute> to execute SQL. |
|
246 |
- |
|
247 |
- my $sql = "select * from book where title = :title and author like :author;" |
|
248 |
- $dbi->execute($sql, {title => 'Perl', author => '%Ken%'}); |
|
249 |
- |
|
250 |
-You can specify C<filter> at C<execute>. |
|
251 |
- |
|
252 |
- $dbi->execute($sql, {title => 'Perl', author => '%Ken%'} |
|
253 |
- filter => {title => 'to_something'); |
|
254 |
- |
|
255 |
-=head3 Manipulate same name's columns |
|
256 |
- |
|
257 |
-It is ok if there are same name's columns. |
|
258 |
-Let's think two date comparison. |
|
259 |
- |
|
260 |
- my $sql = "select * from table where date > :date and date < :date;"; |
|
261 |
- |
|
262 |
-In this case, You specify parameter values as array reference. |
|
263 |
- |
|
264 |
- my $dbi->execute($sql, {date => ['2010-10-01', '2012-02-10']}); |
|
265 |
- |
|
266 |
-=head2 Create where clause |
|
267 |
- |
|
268 |
-=head3 Dinamically create where clause : where |
|
269 |
- |
|
270 |
-You want to search multiple conditions in many times. |
|
271 |
-Let's think the following three cases. |
|
272 |
- |
|
273 |
-Case1: Search only C<title> |
|
274 |
- |
|
275 |
- where title = :title |
|
276 |
- |
|
277 |
-Case2: Search only C<author> |
|
278 |
- |
|
279 |
- where author = :author |
|
280 |
- |
|
281 |
-Case3: Search C<title> and C<author> |
|
282 |
- |
|
283 |
- where title = :title and author = :author |
|
284 |
- |
|
285 |
-L<DBIx::Custom> support dinamic where clause creating. |
|
286 |
-At first, create L<DBIx::Custom::Where> object by C<where>. |
|
287 |
- |
|
288 |
- my $where = $dbi->where; |
|
289 |
- |
|
290 |
-Set clause by C<clause> |
|
291 |
- |
|
292 |
- $where->clause( |
|
293 |
- ['and', 'title = :title, 'author = :author'] |
|
294 |
- ); |
|
295 |
- |
|
296 |
-C<clause> is the following format. |
|
297 |
- |
|
298 |
- ['or' or 'and', PART1, PART1, PART1] |
|
299 |
- |
|
300 |
-First argument is 'or' or 'and'. |
|
301 |
-Later than first argument are part which contains named placeholder. |
|
302 |
- |
|
303 |
-You can write more complex format. |
|
304 |
- |
|
305 |
- ['and', |
|
306 |
- 'title = :title', |
|
307 |
- ['or', 'author = :author', 'date like :date'] |
|
308 |
- ] |
|
309 |
- |
|
310 |
-This mean "title = :title and ( author = :author or date like :date )". |
|
311 |
- |
|
312 |
-After setting C<clause>, set C<param>. |
|
313 |
- |
|
314 |
- $where->param({title => 'Perl'}); |
|
315 |
- |
|
316 |
-In this example, parameter contains only title. |
|
317 |
- |
|
318 |
-If you execute C<string_to>, you can get where clause |
|
319 |
-which contain only named placeholder. |
|
320 |
- |
|
321 |
- my $where_clause = $where->to_string; |
|
322 |
- |
|
323 |
-Parameter name is only title, the following where clause is created. |
|
324 |
- |
|
325 |
- where title = :title |
|
326 |
- |
|
327 |
-You can also create where clause by stringification. |
|
328 |
- |
|
329 |
- my $where_clause = "$where"; |
|
330 |
- |
|
331 |
-This is useful to embbed it into SQL. |
|
332 |
- |
|
333 |
-=head3 In case where clause contains same name columns |
|
334 |
- |
|
335 |
-Even if same name parameters exists, you can create where clause. |
|
336 |
-Let's think that there are starting date and ending date. |
|
337 |
- |
|
338 |
- my $param = {start_date => '2010-11-15', end_date => '2011-11-21'}; |
|
339 |
- |
|
340 |
-In this case, you set parameter value as array reference. |
|
341 |
- |
|
342 |
- my $p = {date => ['2010-11-15', '2011-11-21']}; |
|
343 |
- |
|
344 |
-You can embbed these values into same name parameters. |
|
345 |
- |
|
346 |
- $where->clause( |
|
347 |
- ['and', 'date > :date', 'date < :date'] |
|
348 |
- ); |
|
349 |
- $where->param($p); |
|
350 |
- |
|
351 |
-If starting date isn't exists, create the following parameter. |
|
352 |
- |
|
353 |
- my $p = {date => [$dbi->not_exists, '2011-11-21']}; |
|
354 |
- |
|
355 |
-You can get DBIx::Custom::NotExists object by C<not_exists> |
|
356 |
-This mean correnspondinf value isn't exists. |
|
357 |
- |
|
358 |
-If ending date isn't exists, create the following parameter. |
|
359 |
- |
|
360 |
- my $p = {date => ['2010-11-15']}; |
|
361 |
- |
|
362 |
-If both date isn't exists, create the following parameter. |
|
363 |
- |
|
364 |
- my $p = {date => []}; |
|
365 |
- |
|
366 |
-This logic is a little difficut. See the following ones. |
|
367 |
- |
|
368 |
- my @date; |
|
369 |
- push @date, exists $param->{start_date} ? $param->{start_date} |
|
370 |
- : $dbi->not_exists; |
|
371 |
- push @date, $param->{end_date} if exists $param->{end_date}; |
|
372 |
- my $p = {date => \@date}; |
|
373 |
- |
|
374 |
-=head3 With C<select> |
|
375 |
- |
|
376 |
-You can pass L<DBIx::Custom::Where> object to C<where> of C<select>. |
|
377 |
- |
|
378 |
- my $where = $dbi->where; |
|
379 |
- $where->clause(['and', 'title = :title', 'author = :author']); |
|
380 |
- $where->param({title => 'Perl'}); |
|
381 |
- my $result = $dbi->select(table => 'book', where => $where); |
|
382 |
- |
|
383 |
-You can also pass it to C<where> of C<update>AC<delete> |
|
384 |
- |
|
385 |
-=head3 With C<execute> |
|
386 |
- |
|
387 |
-L<DBIx::Custom::Where> object is embedded into SQL. |
|
388 |
- |
|
389 |
- my $where = $dbi->where; |
|
390 |
- $where->clause(['and', 'title = :title', 'author = :author']); |
|
391 |
- $where->param({title => 'Perl'}); |
|
392 |
- |
|
393 |
- my $sql = <<"EOS"; |
|
394 |
- select * from book; |
|
395 |
- $where |
|
396 |
- EOS |
|
397 |
- |
|
398 |
- $dbi->execute($sql, $param, table => 'book'); |
|
399 |
- |
|
400 |
-=head2 Filtering |
|
401 |
- |
|
402 |
-=head3 Register filter : C<register_filter> |
|
403 |
- |
|
404 |
-If you want to register filter, use C<register_filter>. |
|
405 |
- |
|
406 |
- $dbi->register_filter( |
|
407 |
- # Time::Piece object to DATE format |
|
408 |
- tp_to_date => sub { |
|
409 |
- my $date = shift; |
|
410 |
- return $tp->strftime('%Y-%m-%d'); |
|
411 |
- }, |
|
412 |
- |
|
413 |
- # DATE to Time::Piece object |
|
414 |
- date_to_tp => sub { |
|
415 |
- my $date = shift; |
|
416 |
- return Time::Piece->strptime($date, '%Y-%m-%d'); |
|
417 |
- }, |
|
418 |
- ); |
|
419 |
- |
|
420 |
-=head3 Filter before sending data into database : C<filter> option |
|
421 |
- |
|
422 |
-If you filter sending data, use C<filter> option. |
|
423 |
- |
|
424 |
- $dbi->execute( |
|
425 |
- 'insert into book (date) values (:date)', |
|
426 |
- {date => $tp}, |
|
427 |
- filter => {date => 'tp_to_date'} |
|
428 |
- ); |
|
429 |
- |
|
430 |
-You can use C<filter> option in C<insert>, C<update>, C<delete>, C<select> method. |
|
431 |
- |
|
432 |
- $dbi->insert( |
|
433 |
- {date => $tp}, |
|
434 |
- table => 'book', |
|
435 |
- filter => {date => 'tp_to_date'} |
|
436 |
- ); |
|
437 |
- |
|
438 |
-=head3 Filter after fetching data from database. |
|
439 |
- |
|
440 |
-If you filter fetch data, use L<DBIx::Custom::Result>'s C<filter> method. |
|
441 |
- |
|
442 |
- my $result = $dbi->select(column => 'date', table => 'book'); |
|
443 |
- $result->filter(date => 'date_to_tp'); |
|
444 |
- my $row = $result->one; |
|
445 |
- |
|
446 |
-=head2 7. Model |
|
447 |
- |
|
448 |
-=head3 Model |
|
449 |
- |
|
450 |
-you can define model extending L<DBIx::Custom::Model> |
|
451 |
-to improve source code view. |
|
452 |
- |
|
453 |
-At first, you create basic model class extending <DBIx::Custom::Model>. |
|
454 |
-Each L<DBIx::Custom> class inherit L<Object::Simple>. |
|
455 |
-so you can inherit the following way. |
|
456 |
- |
|
457 |
- package MyModel; |
|
458 |
- use DBIx::Custom::Model -base; |
|
459 |
- |
|
460 |
-Next, you create each model classes. |
|
461 |
- |
|
462 |
-MyModel::book |
|
463 |
- |
|
464 |
- package MyModel::book; |
|
465 |
- use MyModel -base; |
|
466 |
- |
|
467 |
- sub insert { ... } |
|
468 |
- sub list { ... } |
|
469 |
- |
|
470 |
-MyModel::company |
|
471 |
- |
|
472 |
- package MyModel::company; |
|
473 |
- use MyModel -base; |
|
474 |
- |
|
475 |
- sub insert { ... } |
|
476 |
- sub list { ... } |
|
477 |
- |
|
478 |
-The follwoing modules location is needed. |
|
479 |
- |
|
480 |
- MyModel.pm |
|
481 |
- MyModel / book.pm |
|
482 |
- / company.pm |
|
483 |
- |
|
484 |
-You can include these models by C<include_model> |
|
485 |
- |
|
486 |
- $dbi->include_model('MyModel'); |
|
487 |
- |
|
488 |
-First argument is name space of model. |
|
489 |
- |
|
490 |
-You can use model like this. |
|
491 |
- |
|
492 |
- my $result = $dbi->model('book')->list; |
|
493 |
- |
|
494 |
-In mode, You can use such as methods, |
|
495 |
-C<insert>, C<update>, C<update_all>, |
|
496 |
-C<delete>, C<delete_all>, C<select> |
|
497 |
-without C<table> option. |
|
498 |
- |
|
499 |
- $dbi->model('book')->insert($param); |
|
500 |
- |
|
501 |
-Model is L<DBIx::Custom::Model>. |
|
502 |
- |
|
503 |
-If you need table nameAyou can get it by C<table>. |
|
504 |
- |
|
505 |
- my $table = $model->table; |
|
506 |
- |
|
507 |
-You can get L<DBIx::Custom>. |
|
508 |
- |
|
509 |
- my $dbi = $model->dbi; |
|
510 |
- |
|
511 |
-You can also call all methods of L<DBIx::Custom> and L<DBI>. |
|
512 |
- |
|
513 |
- # DBIx::Custom method |
|
514 |
- $model->execute($sql); |
|
515 |
- |
|
516 |
- # DBI method |
|
517 |
- $model->begin_work; |
|
518 |
- $model->commit; |
|
519 |
- |
|
520 |
-If you want to get all models, you can get them by keys of C<models>. |
|
521 |
- |
|
522 |
- my @models = keys %{$self->models}; |
|
523 |
- |
|
524 |
-You can set primary key to model. |
|
525 |
- |
|
526 |
- $model->primary_key(['id', 'number_id']); |
|
527 |
- |
|
528 |
-Primary key is used by C<insert>, C<update>, C<delete>, |
|
529 |
-and C<select> methods. |
|
530 |
- |
|
531 |
-You can set column names |
|
532 |
- |
|
533 |
- $model->columns(['id', 'number_id']); |
|
534 |
- |
|
535 |
-Column names is automarically set by C<setup_model>. |
|
536 |
-This method is needed to be call after C<include_model>. |
|
537 |
- |
|
538 |
- $dbi->setup_model; |
|
539 |
- |
|
540 |
-You can set C<join> |
|
541 |
- |
|
542 |
- $model->join(['left outer join company on book.company_id = company.id']); |
|
543 |
- |
|
544 |
-C<join> is used by C<select> method. |
|
545 |
- |
|
546 |
-=head2 Create column clause automatically : mycolumn, column |
|
547 |
- |
|
548 |
-To create column clause automatically, use C<mycolumn>. |
|
549 |
-Valude of C<table> and C<columns> is used. |
|
550 |
- |
|
551 |
- my $mycolumns = $model->mycolumn; |
|
552 |
- |
|
553 |
-If C<table> is 'book'AC<column> is ['id', 'name'], |
|
554 |
-the following clause is created. |
|
555 |
- |
|
556 |
- book.id as id, book.name as name |
|
557 |
- |
|
558 |
-These column name is for removing column name ambiguities. |
|
559 |
- |
|
560 |
-You can create column clause from columns of other table. |
|
561 |
- |
|
562 |
- my $columns = $model->column('company'); |
|
563 |
- |
|
564 |
-If C<table> is "company", C<column> return ['id', 'name'], |
|
565 |
-the following clause is created. |
|
566 |
- |
|
567 |
- company.id as "company.id", company.name as "company.name" |
|
568 |
- |
|
569 |
-=head2 Model Examples |
|
570 |
- |
|
571 |
-Model examples |
|
572 |
- |
|
573 |
- package MyDBI; |
|
574 |
- use DBIx::Custom -base; |
|
575 |
- |
|
576 |
- sub connect { |
|
577 |
- my $self = shift->SUPER::connect(@_); |
|
578 |
- |
|
579 |
- $self->include_model( |
|
580 |
- MyModel => [ |
|
581 |
- 'book', |
|
582 |
- 'company' |
|
583 |
- ] |
|
584 |
- ); |
|
585 |
- } |
|
586 |
- |
|
587 |
- package MyModel::book; |
|
588 |
- use DBIx::Custom::Model -base; |
|
589 |
- |
|
590 |
- has primary_key => sub { ['id'] }; |
|
591 |
- |
|
592 |
- sub insert { ... } |
|
593 |
- sub list { ... } |
|
594 |
- |
|
595 |
- package MyModel::company; |
|
596 |
- use DBIx::Custom::Model -base; |
|
597 |
- |
|
598 |
- has primary_key => sub { ['id'] }; |
|
599 |
- |
|
600 |
- sub insert { ... } |
|
601 |
- sub list { ... } |
|
602 |
- |
|
603 |
-=cut |
... | ... |
@@ -1,13 +0,0 @@ |
1 |
-=encoding utf8 |
|
2 |
- |
|
3 |
-=head1 NAME |
|
4 |
- |
|
5 |
-DBIx::Custom::Guide - DBIx::Customガイド |
|
6 |
- |
|
7 |
-=head1 LINK |
|
8 |
- |
|
9 |
-ドキュメントは以下のリンクに移動しました。 |
|
10 |
- |
|
11 |
-L<http://d.hatena.ne.jp/perlcodesample/20110401/1305597081> |
|
12 |
- |
|
13 |
-=cut |
... | ... |
@@ -1,116 +0,0 @@ |
1 |
-package DBIx::Custom::Query; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util '_subname'; |
|
6 |
- |
|
7 |
-has 'sth', |
|
8 |
- sql => '', |
|
9 |
- columns => sub { [] }; |
|
10 |
- |
|
11 |
-# DEPRECATED! |
|
12 |
-has 'default_filter'; |
|
13 |
-sub filters { |
|
14 |
- warn "DBIx::Custom::Query filters attribute method is DEPRECATED!"; |
|
15 |
- my $self = shift; |
|
16 |
- if (@_) { |
|
17 |
- $self->{filters} = $_[0]; |
|
18 |
- return $self; |
|
19 |
- } |
|
20 |
- return $self->{filters}; |
|
21 |
-} |
|
22 |
- |
|
23 |
-# DEPRECATED! |
|
24 |
-sub tables { |
|
25 |
- warn "DBIx::Custom::Query tables attribute method is DEPRECATED!"; |
|
26 |
- my $self = shift; |
|
27 |
- if (@_) { |
|
28 |
- $self->{tables} = $_[0]; |
|
29 |
- return $self; |
|
30 |
- } |
|
31 |
- return $self->{tables} ||= []; |
|
32 |
-} |
|
33 |
- |
|
34 |
-#DEPRECATED! |
|
35 |
-sub filter { |
|
36 |
- Carp::carp "DBIx::Custom::Query filter method is DEPRECATED!"; |
|
37 |
- my $self = shift; |
|
38 |
- if (@_) { |
|
39 |
- my $filter = {}; |
|
40 |
- if (ref $_[0] eq 'HASH') { |
|
41 |
- $filter = $_[0]; |
|
42 |
- } |
|
43 |
- else { |
|
44 |
- my $ef = @_ > 1 ? [@_] : $_[0]; |
|
45 |
- for (my $i = 0; $i < @$ef; $i += 2) { |
|
46 |
- my $column = $ef->[$i]; |
|
47 |
- my $f = $ef->[$i + 1]; |
|
48 |
- if (ref $column eq 'ARRAY') { |
|
49 |
- foreach my $c (@$column) { |
|
50 |
- $filter->{$c} = $f; |
|
51 |
- } |
|
52 |
- } |
|
53 |
- else { |
|
54 |
- $filter->{$column} = $f; |
|
55 |
- } |
|
56 |
- } |
|
57 |
- } |
|
58 |
- foreach my $column (keys %$filter) { |
|
59 |
- my $fname = $filter->{$column}; |
|
60 |
- if (exists $filter->{$column} |
|
61 |
- && defined $fname |
|
62 |
- && ref $fname ne 'CODE') |
|
63 |
- { |
|
64 |
- my $filters = $self->{filters} || {}; |
|
65 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
66 |
- unless exists $filters->{$fname}; |
|
67 |
- $filter->{$column} = $filters->{$fname}; |
|
68 |
- } |
|
69 |
- } |
|
70 |
- $self->{filter} = {%{$self->{filter} || {}}, %$filter}; |
|
71 |
- return $self; |
|
72 |
- } |
|
73 |
- return $self->{filter} ||= {}; |
|
74 |
-} |
|
75 |
- |
|
76 |
-1; |
|
77 |
- |
|
78 |
-=head1 NAME |
|
79 |
- |
|
80 |
-DBIx::Custom::Query - Query |
|
81 |
- |
|
82 |
-=head1 SYNOPSIS |
|
83 |
- |
|
84 |
- my $query = DBIx::Custom::Query->new; |
|
85 |
- my $sth = $query->sth; |
|
86 |
- my $sql = $query->sql; |
|
87 |
- my $columns = $query->columns; |
|
88 |
- |
|
89 |
-=head1 ATTRIBUTES |
|
90 |
- |
|
91 |
-=head2 C<columns> |
|
92 |
- |
|
93 |
- my $columns = $query->columns; |
|
94 |
- $query = $query->columns(['auhtor', 'title']); |
|
95 |
- |
|
96 |
-Column names. |
|
97 |
- |
|
98 |
-=head2 C<sql> |
|
99 |
- |
|
100 |
- my $sql = $query->sql; |
|
101 |
- $query = $query->sql('select * from books where author = ?;'); |
|
102 |
- |
|
103 |
-SQL statement. |
|
104 |
- |
|
105 |
-=head2 C<sth> |
|
106 |
- |
|
107 |
- my $sth = $query->sth; |
|
108 |
- $query = $query->sth($sth); |
|
109 |
- |
|
110 |
-Statement handle of L<DBI> |
|
111 |
- |
|
112 |
-=head1 METHODS |
|
113 |
- |
|
114 |
-L<DBIx::Custom::Query> inherits all methods from L<Object::Simple>. |
|
115 |
- |
|
116 |
-=cut |
... | ... |
@@ -1,329 +0,0 @@ |
1 |
-package DBIx::Custom::QueryBuilder; |
|
2 |
- |
|
3 |
-use Object::Simple -base; |
|
4 |
- |
|
5 |
-use Carp 'croak'; |
|
6 |
-use DBIx::Custom::Query; |
|
7 |
-use DBIx::Custom::Util '_subname'; |
|
8 |
- |
|
9 |
-# Carp trust relationship |
|
10 |
-push @DBIx::Custom::CARP_NOT, __PACKAGE__; |
|
11 |
-push @DBIx::Custom::Where::CARP_NOT, __PACKAGE__; |
|
12 |
- |
|
13 |
-has 'dbi'; |
|
14 |
- |
|
15 |
-sub build_query { |
|
16 |
- my ($self, $source) = @_; |
|
17 |
- |
|
18 |
- my $query; |
|
19 |
- |
|
20 |
- # Parse tag. tag is DEPRECATED! |
|
21 |
- if ($self->dbi->tag_parse && $source =~ /(\s|^)\{/) { |
|
22 |
- $query = $self->_parse_tag($source); |
|
23 |
- my $tag_count = delete $query->{tag_count}; |
|
24 |
- warn qq/Tag system such as {? name} is DEPRECATED! / . |
|
25 |
- qq/use parameter system such as :name instead/ |
|
26 |
- if $tag_count; |
|
27 |
- my $query2 = $self->_parse_parameter($query->sql); |
|
28 |
- $query->sql($query2->sql); |
|
29 |
- for (my $i =0; $i < @{$query->columns}; $i++) { |
|
30 |
- my $column = $query->columns->[$i]; |
|
31 |
- if ($column eq 'RESERVED_PARAMETER') { |
|
32 |
- my $column2 = shift @{$query2->columns}; |
|
33 |
- croak ":name syntax is wrong" |
|
34 |
- unless defined $column2; |
|
35 |
- $query->columns->[$i] = $column2; |
|
36 |
- } |
|
37 |
- } |
|
38 |
- } |
|
39 |
- |
|
40 |
- # Parse parameter |
|
41 |
- else { $query = $self->_parse_parameter($source) } |
|
42 |
- |
|
43 |
- my $sql = $query->sql; |
|
44 |
- $sql .= ';' unless $source =~ /;$/; |
|
45 |
- $query->sql($sql); |
|
46 |
- |
|
47 |
- # Check placeholder count |
|
48 |
- croak qq{Placeholder count in "$sql" must be same as column count} |
|
49 |
- . _subname |
|
50 |
- unless $self->_placeholder_count($sql) eq @{$query->columns}; |
|
51 |
- |
|
52 |
- return $query; |
|
53 |
-} |
|
54 |
- |
|
55 |
-sub _placeholder_count { |
|
56 |
- my ($self, $sql) = @_; |
|
57 |
- |
|
58 |
- # Count |
|
59 |
- $sql ||= ''; |
|
60 |
- my $count = 0; |
|
61 |
- my $pos = -1; |
|
62 |
- while (($pos = index($sql, '?', $pos + 1)) != -1) { |
|
63 |
- $count++; |
|
64 |
- } |
|
65 |
- return $count; |
|
66 |
-} |
|
67 |
- |
|
68 |
-sub _parse_parameter { |
|
69 |
- my ($self, $source) = @_; |
|
70 |
- |
|
71 |
- # Get and replace parameters |
|
72 |
- my $sql = $source || ''; |
|
73 |
- my $columns = []; |
|
74 |
- my $c = $self->dbi->safety_character; |
|
75 |
- # Parameter regex |
|
76 |
- $sql =~ s/([^:]):(\d+):([^:])/$1\\:$2\\:$3/g; |
|
77 |
- my $re = qr/(^|.*?[^\\]):([$c\.]+)(?:\{(.*?)\})?(.*)/s; |
|
78 |
- while ($sql =~ /$re/g) { |
|
79 |
- push @$columns, $2; |
|
80 |
- $sql = defined $3 ? "$1$2 $3 ?$4" : "$1?$4"; |
|
81 |
- } |
|
82 |
- $sql =~ s/\\:/:/g; |
|
83 |
- |
|
84 |
- # Create query |
|
85 |
- my $query = DBIx::Custom::Query->new( |
|
86 |
- sql => $sql, |
|
87 |
- columns => $columns |
|
88 |
- ); |
|
89 |
- |
|
90 |
- return $query; |
|
91 |
-} |
|
92 |
- |
|
93 |
-# DEPRECATED! |
|
94 |
-has tags => sub { {} }; |
|
95 |
- |
|
96 |
-# DEPRECATED! |
|
97 |
-sub register_tag { |
|
98 |
- my $self = shift; |
|
99 |
- |
|
100 |
- warn "register_tag is DEPRECATED!"; |
|
101 |
- |
|
102 |
- # Merge tag |
|
103 |
- my $tags = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
104 |
- $self->tags({%{$self->tags}, %$tags}); |
|
105 |
- |
|
106 |
- return $self; |
|
107 |
-} |
|
108 |
- |
|
109 |
-# DEPRECATED! |
|
110 |
-sub _parse_tag { |
|
111 |
- my ($self, $source) = @_; |
|
112 |
- # Source |
|
113 |
- $source ||= ''; |
|
114 |
- # Tree |
|
115 |
- my @tree; |
|
116 |
- # Value |
|
117 |
- my $value = ''; |
|
118 |
- # State |
|
119 |
- my $state = 'text'; |
|
120 |
- # Before charactor |
|
121 |
- my $before = ''; |
|
122 |
- # Position |
|
123 |
- my $pos = 0; |
|
124 |
- # Parse |
|
125 |
- my $original = $source; |
|
126 |
- my $tag_count = 0; |
|
127 |
- while (defined(my $c = substr($source, $pos, 1))) { |
|
128 |
- # Last |
|
129 |
- last unless length $c; |
|
130 |
- # Parameter |
|
131 |
- if ($c eq ':' && (substr($source, $pos + 1, 1) || '') =~ /\w/) { |
|
132 |
- push @tree, {type => 'param'};; |
|
133 |
- } |
|
134 |
- # State is text |
|
135 |
- if ($state eq 'text') { |
|
136 |
- # Tag start charactor |
|
137 |
- if ($c eq '{') { |
|
138 |
- # Escaped charactor |
|
139 |
- if ($before eq "\\") { |
|
140 |
- substr($value, -1, 1, ''); |
|
141 |
- $value .= $c; |
|
142 |
- } |
|
143 |
- # Tag start |
|
144 |
- else { |
|
145 |
- # Change state |
|
146 |
- $state = 'tag'; |
|
147 |
- # Add text |
|
148 |
- push @tree, {type => 'text', value => $value} |
|
149 |
- if $value; |
|
150 |
- # Clear |
|
151 |
- $value = ''; |
|
152 |
- } |
|
153 |
- } |
|
154 |
- # Tag end charactor |
|
155 |
- elsif ($c eq '}') { |
|
156 |
- # Escaped charactor |
|
157 |
- if ($before eq "\\") { |
|
158 |
- substr($value, -1, 1, ''); |
|
159 |
- $value .= $c; |
|
160 |
- } |
|
161 |
- # Unexpected |
|
162 |
- else { |
|
163 |
- croak qq{Parsing error. unexpected "\}". } |
|
164 |
- . qq{pos $pos of "$original" } . _subname |
|
165 |
- } |
|
166 |
- } |
|
167 |
- # Normal charactor |
|
168 |
- else { $value .= $c } |
|
169 |
- } |
|
170 |
- # State is tags |
|
171 |
- else { |
|
172 |
- # Tag start charactor |
|
173 |
- if ($c eq '{') { |
|
174 |
- # Escaped charactor |
|
175 |
- if ($before eq "\\") { |
|
176 |
- substr($value, -1, 1, ''); |
|
177 |
- $value .= $c; |
|
178 |
- } |
|
179 |
- # Unexpected |
|
180 |
- else { |
|
181 |
- croak qq{Parsing error. unexpected "\{". } |
|
182 |
- . qq{pos $pos of "$original" } . _subname |
|
183 |
- } |
|
184 |
- } |
|
185 |
- # Tag end charactor |
|
186 |
- elsif ($c eq '}') { |
|
187 |
- # Escaped charactor |
|
188 |
- if ($before eq "\\") { |
|
189 |
- substr($value, -1, 1, ''); |
|
190 |
- $value .= $c; |
|
191 |
- } |
|
192 |
- # Tag end |
|
193 |
- else { |
|
194 |
- # Change state |
|
195 |
- $state = 'text'; |
|
196 |
- # Add tag |
|
197 |
- my ($tag_name, @tag_args) = split /\s+/, $value; |
|
198 |
- push @tree, {type => 'tag', tag_name => $tag_name, |
|
199 |
- tag_args => \@tag_args}; |
|
200 |
- # Clear |
|
201 |
- $value = ''; |
|
202 |
- # Countup |
|
203 |
- $tag_count++; |
|
204 |
- } |
|
205 |
- } |
|
206 |
- # Normal charactor |
|
207 |
- else { $value .= $c } |
|
208 |
- } |
|
209 |
- # Save before charactor |
|
210 |
- $before = $c; |
|
211 |
- # increment position |
|
212 |
- $pos++; |
|
213 |
- } |
|
214 |
- # Tag not finished |
|
215 |
- croak qq{Tag not finished. "$original" } . _subname |
|
216 |
- if $state eq 'tag'; |
|
217 |
- # Not contains tag |
|
218 |
- return DBIx::Custom::Query->new(sql => $source, tag_count => $tag_count) |
|
219 |
- if $tag_count == 0; |
|
220 |
- # Add rest text |
|
221 |
- push @tree, {type => 'text', value => $value} |
|
222 |
- if $value; |
|
223 |
- # SQL |
|
224 |
- my $sql = ''; |
|
225 |
- # All Columns |
|
226 |
- my $all_columns = []; |
|
227 |
- # Tables |
|
228 |
- my $tables = []; |
|
229 |
- # Build SQL |
|
230 |
- foreach my $node (@tree) { |
|
231 |
- # Text |
|
232 |
- if ($node->{type} eq 'text') { $sql .= $node->{value} } |
|
233 |
- # Parameter |
|
234 |
- elsif ($node->{type} eq 'param') { |
|
235 |
- push @$all_columns, 'RESERVED_PARAMETER'; |
|
236 |
- } |
|
237 |
- # Tag |
|
238 |
- else { |
|
239 |
- # Tag name |
|
240 |
- my $tag_name = $node->{tag_name}; |
|
241 |
- # Tag arguments |
|
242 |
- my $tag_args = $node->{tag_args}; |
|
243 |
- # Table |
|
244 |
- if ($tag_name eq 'table') { |
|
245 |
- my $table = $tag_args->[0]; |
|
246 |
- push @$tables, $table; |
|
247 |
- $sql .= $table; |
|
248 |
- next; |
|
249 |
- } |
|
250 |
- # Get tag |
|
251 |
- my $tag = $self->tag_processors->{$tag_name} |
|
252 |
- || $self->tags->{$tag_name}; |
|
253 |
- # Tag is not registered |
|
254 |
- croak qq{Tag "$tag_name" is not registered } . _subname |
|
255 |
- unless $tag; |
|
256 |
- # Tag not sub reference |
|
257 |
- croak qq{Tag "$tag_name" must be sub reference } . _subname |
|
258 |
- unless ref $tag eq 'CODE'; |
|
259 |
- # Execute tag |
|
260 |
- my $r = $tag->(@$tag_args); |
|
261 |
- # Check tag return value |
|
262 |
- croak qq{Tag "$tag_name" must return [STRING, ARRAY_REFERENCE] } |
|
263 |
- . _subname |
|
264 |
- unless ref $r eq 'ARRAY' && defined $r->[0] && ref $r->[1] eq 'ARRAY'; |
|
265 |
- # Part of SQL statement and colum names |
|
266 |
- my ($part, $columns) = @$r; |
|
267 |
- # Add columns |
|
268 |
- push @$all_columns, @$columns; |
|
269 |
- # Join part tag to SQL |
|
270 |
- $sql .= $part; |
|
271 |
- } |
|
272 |
- } |
|
273 |
- # Query |
|
274 |
- my $query = DBIx::Custom::Query->new( |
|
275 |
- sql => $sql, |
|
276 |
- columns => $all_columns, |
|
277 |
- tables => $tables, |
|
278 |
- tag_count => $tag_count |
|
279 |
- ); |
|
280 |
- return $query; |
|
281 |
-} |
|
282 |
- |
|
283 |
-# DEPRECATED! |
|
284 |
-has tag_processors => sub { {} }; |
|
285 |
- |
|
286 |
-# DEPRECATED! |
|
287 |
-sub register_tag_processor { |
|
288 |
- my $self = shift; |
|
289 |
- warn "register_tag_processor is DEPRECATED!"; |
|
290 |
- # Merge tag |
|
291 |
- my $tag_processors = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
292 |
- $self->tag_processors({%{$self->tag_processors}, %{$tag_processors}}); |
|
293 |
- return $self; |
|
294 |
-} |
|
295 |
- |
|
296 |
-1; |
|
297 |
- |
|
298 |
-=head1 NAME |
|
299 |
- |
|
300 |
-DBIx::Custom::QueryBuilder - Query builder |
|
301 |
- |
|
302 |
-=head1 SYNOPSIS |
|
303 |
- |
|
304 |
- my $builder = DBIx::Custom::QueryBuilder->new; |
|
305 |
- my $query = $builder->build_query( |
|
306 |
- "select from table title = :title and author = :author" |
|
307 |
- ); |
|
308 |
- |
|
309 |
-=head1 ATTRIBUTES |
|
310 |
- |
|
311 |
-=head2 C<dbi> |
|
312 |
- |
|
313 |
- my $dbi = $builder->dbi; |
|
314 |
- $builder = $builder->dbi($dbi); |
|
315 |
- |
|
316 |
-L<DBIx::Custom> object. |
|
317 |
- |
|
318 |
-=head1 METHODS |
|
319 |
- |
|
320 |
-L<DBIx::Custom::QueryBuilder> inherits all methods from L<Object::Simple> |
|
321 |
-and implements the following new ones. |
|
322 |
- |
|
323 |
-=head2 C<build_query> |
|
324 |
- |
|
325 |
- my $query = $builder->build_query($source); |
|
326 |
- |
|
327 |
-Create a new L<DBIx::Custom::Query> object from SQL source. |
|
328 |
- |
|
329 |
-=cut |
... | ... |
@@ -1,41 +0,0 @@ |
1 |
-package DBIx::Custom::Util; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'Exporter'; |
|
7 |
- |
|
8 |
-our @EXPORT_OK = qw/_array_to_hash _subname/; |
|
9 |
- |
|
10 |
-sub _array_to_hash { |
|
11 |
- my $array = shift; |
|
12 |
- |
|
13 |
- return $array if ref $array eq 'HASH'; |
|
14 |
- return unless $array; |
|
15 |
- |
|
16 |
- my $hash = {}; |
|
17 |
- |
|
18 |
- for (my $i = 0; $i < @$array; $i += 2) { |
|
19 |
- my $key = $array->[$i]; |
|
20 |
- my $f = $array->[$i + 1]; |
|
21 |
- |
|
22 |
- if (ref $key eq 'ARRAY') { |
|
23 |
- foreach my $k (@$key) { |
|
24 |
- $hash->{$k} = $f; |
|
25 |
- } |
|
26 |
- } |
|
27 |
- else { |
|
28 |
- $hash->{$key} = $f; |
|
29 |
- } |
|
30 |
- } |
|
31 |
- return $hash; |
|
32 |
-} |
|
33 |
- |
|
34 |
-sub _subname { '(' . (caller 1)[3] . ')' } |
|
35 |
- |
|
36 |
-1; |
|
37 |
- |
|
38 |
-=head1 NAME |
|
39 |
- |
|
40 |
-DBIx::Custom::Util - Utility class |
|
41 |
- |
... | ... |
@@ -1,11 +0,0 @@ |
1 |
-# Change quote for tests |
|
2 |
-use DBIx::Custom; |
|
3 |
-{ |
|
4 |
- package DBIx::Custom; |
|
5 |
- no warnings 'redefine'; |
|
6 |
- sub quote { '""' } |
|
7 |
-} |
|
8 |
- |
|
9 |
-use FindBin; |
|
10 |
- |
|
11 |
-require "$FindBin::Bin/basic.t"; |
... | ... |
@@ -1,19 +0,0 @@ |
1 |
-package MyDBI1; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'DBIx::Custom'; |
|
7 |
- |
|
8 |
-sub connect { |
|
9 |
- my $self = shift->SUPER::connect(@_); |
|
10 |
- |
|
11 |
- $self->include_model( |
|
12 |
- MyModel1 => [ |
|
13 |
- 'book', |
|
14 |
- {class => 'Company', name => 'company'} |
|
15 |
- ] |
|
16 |
- ); |
|
17 |
-} |
|
18 |
- |
|
19 |
-1; |
... | ... |
@@ -1,13 +0,0 @@ |
1 |
-package MyModel1::book; |
|
2 |
- |
|
3 |
-use DBIx::Custom::Model -base; |
|
4 |
- |
|
5 |
-sub insert { |
|
6 |
- my ($self, $param) = @_; |
|
7 |
- |
|
8 |
- return $self->SUPER::insert(param => $param); |
|
9 |
-} |
|
10 |
- |
|
11 |
-sub list { shift->select; } |
|
12 |
- |
|
13 |
-1; |
... | ... |
@@ -1,8 +0,0 @@ |
1 |
-package MyModel4::company; |
|
2 |
- |
|
3 |
-use base 'MyModel4'; |
|
4 |
- |
|
5 |
-sub insert { shift->SUPER::insert(param => $_[0]) } |
|
6 |
-sub list { shift->select } |
|
7 |
- |
|
8 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel5; |
|
2 |
- |
|
3 |
-use base 'DBIx::Custom::Model'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,7 +0,0 @@ |
1 |
-package MyModel5::table1; |
|
2 |
- |
|
3 |
-use MyModel5 -base; |
|
4 |
- |
|
5 |
-has primary_key => sub { ['key1', 'key2'] }; |
|
6 |
- |
|
7 |
-1; |
... | ... |
@@ -1,12 +0,0 @@ |
1 |
-package MyModel5::table1_1; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'MyModel5'; |
|
7 |
- |
|
8 |
-__PACKAGE__->attr(table => 'table2'); |
|
9 |
- |
|
10 |
-__PACKAGE__->attr('primary_key' => sub { ['key1', 'key2'] }); |
|
11 |
- |
|
12 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel6; |
|
2 |
- |
|
3 |
-use base 'DBIx::Custom::Model'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,14 +0,0 @@ |
1 |
-package MyModel6::table1; |
|
2 |
- |
|
3 |
-use base 'MyModel6'; |
|
4 |
- |
|
5 |
-__PACKAGE__->attr( |
|
6 |
- join => sub { |
|
7 |
- [ |
|
8 |
- 'left outer join table2 on table1.key1 = table2.key1' |
|
9 |
- ] |
|
10 |
- }, |
|
11 |
- primary_key => sub { ['key1'] } |
|
12 |
-); |
|
13 |
- |
|
14 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel7; |
|
2 |
- |
|
3 |
-use base 'DBIx::Custom::Model'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,14 +0,0 @@ |
1 |
-package MyModel7::table1; |
|
2 |
- |
|
3 |
-use base 'MyModel7'; |
|
4 |
- |
|
5 |
-__PACKAGE__->attr( |
|
6 |
- primary_key => sub { ['key1'] }, |
|
7 |
- join => sub { |
|
8 |
- [ |
|
9 |
- 'left outer join table2 on table1.key1 = table2.key1' |
|
10 |
- ] |
|
11 |
- }, |
|
12 |
-); |
|
13 |
- |
|
14 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel7::table2; |
|
2 |
- |
|
3 |
-use base 'MyModel7'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,11 +0,0 @@ |
1 |
- |
|
2 |
-use strict; |
|
3 |
-use warnings; |
|
4 |
-use Test::More; |
|
5 |
- |
|
6 |
-# Ensure a recent version of Test::Pod |
|
7 |
-my $min_tp = 1.22; |
|
8 |
-eval "use Test::Pod $min_tp"; |
|
9 |
-plan skip_all => "Test::Pod $min_tp required for testing POD" if $@; |
|
10 |
- |
|
11 |
-all_pod_files_ok(); |
... | ... |
@@ -1,22 +0,0 @@ |
1 |
-use strict; |
|
2 |
-use warnings; |
|
3 |
-use ExtUtils::MakeMaker; |
|
4 |
- |
|
5 |
-WriteMakefile( |
|
6 |
- NAME => 'DBIx::Custom', |
|
7 |
- AUTHOR => 'Yuki Kimoto <kimoto.yuki@gmail.com>', |
|
8 |
- VERSION_FROM => 'lib/DBIx/Custom.pm', |
|
9 |
- ABSTRACT_FROM => 'lib/DBIx/Custom.pm', |
|
10 |
- ($ExtUtils::MakeMaker::VERSION >= 6.3002 |
|
11 |
- ? ('LICENSE'=> 'perl') |
|
12 |
- : ()), |
|
13 |
- PL_FILES => {}, |
|
14 |
- PREREQ_PM => { |
|
15 |
- 'Test::More' => 0, |
|
16 |
- 'Object::Simple' => 3.0621, |
|
17 |
- 'DBD::SQLite' => '1.25', |
|
18 |
- 'DBI' => '1.605' |
|
19 |
- }, |
|
20 |
- dist => { COMPRESS => 'gzip -9f', SUFFIX => 'gz', }, |
|
21 |
- clean => { FILES => 'DBIx-Custom-*' }, |
|
22 |
-); |
... | ... |
@@ -1,15 +0,0 @@ |
1 |
-DBIx-Custom |
|
2 |
- |
|
3 |
-DBI interface, having hash parameter binding and filtering system |
|
4 |
- |
|
5 |
-INSTALLATION |
|
6 |
- |
|
7 |
-cpan DBIx::Custom |
|
8 |
- |
|
9 |
-COPYRIGHT AND LICENCE |
|
10 |
- |
|
11 |
-Copyright (C) 2009 Yuki Kimoto |
|
12 |
- |
|
13 |
-This program is free software; you can redistribute it and/or modify it |
|
14 |
-under the same terms as Perl itself. |
|
15 |
- |
... | ... |
@@ -1,3203 +0,0 @@ |
1 |
-package DBIx::Custom; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-our $VERSION = '0.1711'; |
|
5 |
-use 5.008001; |
|
6 |
- |
|
7 |
-use Carp 'croak'; |
|
8 |
-use DBI; |
|
9 |
-use DBIx::Custom::Result; |
|
10 |
-use DBIx::Custom::Query; |
|
11 |
-use DBIx::Custom::QueryBuilder; |
|
12 |
-use DBIx::Custom::Where; |
|
13 |
-use DBIx::Custom::Model; |
|
14 |
-use DBIx::Custom::Tag; |
|
15 |
-use DBIx::Custom::Order; |
|
16 |
-use DBIx::Custom::Util qw/_array_to_hash _subname/; |
|
17 |
-use Encode qw/encode encode_utf8 decode_utf8/; |
|
18 |
- |
|
19 |
-use constant DEBUG => $ENV{DBIX_CUSTOM_DEBUG} || 0; |
|
20 |
-use constant DEBUG_ENCODING => $ENV{DBIX_CUSTOM_DEBUG_ENCODING} || 'UTF-8'; |
|
21 |
- |
|
22 |
-has [qw/connector dsn password quote user/], |
|
23 |
- cache => 0, |
|
24 |
- cache_method => sub { |
|
25 |
- sub { |
|
26 |
- my $self = shift; |
|
27 |
- |
|
28 |
- $self->{_cached} ||= {}; |
|
29 |
- |
|
30 |
- if (@_ > 1) { |
|
31 |
- $self->{_cached}{$_[0]} = $_[1]; |
|
32 |
- } |
|
33 |
- else { |
|
34 |
- return $self->{_cached}{$_[0]}; |
|
35 |
- } |
|
36 |
- } |
|
37 |
- }, |
|
38 |
- dbi_option => sub { {} }, |
|
39 |
- default_dbi_option => sub { |
|
40 |
- { |
|
41 |
- RaiseError => 1, |
|
42 |
- PrintError => 0, |
|
43 |
- AutoCommit => 1 |
|
44 |
- } |
|
45 |
- }, |
|
46 |
- filters => sub { |
|
47 |
- { |
|
48 |
- encode_utf8 => sub { encode_utf8($_[0]) }, |
|
49 |
- decode_utf8 => sub { decode_utf8($_[0]) } |
|
50 |
- } |
|
51 |
- }, |
|
52 |
- last_sql => '', |
|
53 |
- models => sub { {} }, |
|
54 |
- query_builder => sub { DBIx::Custom::QueryBuilder->new(dbi => shift) }, |
|
55 |
- result_class => 'DBIx::Custom::Result', |
|
56 |
- safety_character => '\w', |
|
57 |
- stash => sub { {} }, |
|
58 |
- tag_parse => 1; |
|
59 |
- |
|
60 |
-our $AUTOLOAD; |
|
61 |
-sub AUTOLOAD { |
|
62 |
- my $self = shift; |
|
63 |
- |
|
64 |
- # Method name |
|
65 |
- my ($package, $mname) = $AUTOLOAD =~ /^([\w\:]+)\:\:(\w+)$/; |
|
66 |
- |
|
67 |
- # Call method |
|
68 |
- $self->{_methods} ||= {}; |
|
69 |
- if (my $method = $self->{_methods}->{$mname}) { |
|
70 |
- return $self->$method(@_) |
|
71 |
- } |
|
72 |
- elsif ($self->{dbh} && (my $dbh_method = $self->dbh->can($mname))) { |
|
73 |
- $self->dbh->$dbh_method(@_); |
|
74 |
- } |
|
75 |
- else { |
|
76 |
- croak qq{Can't locate object method "$mname" via "$package" } |
|
77 |
- . _subname; |
|
78 |
- } |
|
79 |
-} |
|
80 |
- |
|
81 |
-sub assign_param { |
|
82 |
- my ($self, $param) = @_; |
|
83 |
- |
|
84 |
- # Create set tag |
|
85 |
- my @params; |
|
86 |
- my $safety = $self->safety_character; |
|
87 |
- foreach my $column (sort keys %$param) { |
|
88 |
- croak qq{"$column" is not safety column name } . _subname |
|
89 |
- unless $column =~ /^[$safety\.]+$/; |
|
90 |
- my $column_quote = $self->_q($column); |
|
91 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
92 |
- push @params, ref $param->{$column} eq 'SCALAR' |
|
93 |
- ? "$column_quote = " . ${$param->{$column}} |
|
94 |
- : "$column_quote = :$column"; |
|
95 |
- |
|
96 |
- } |
|
97 |
- my $tag = join(', ', @params); |
|
98 |
- |
|
99 |
- return $tag; |
|
100 |
-} |
|
101 |
- |
|
102 |
-sub column { |
|
103 |
- my $self = shift; |
|
104 |
- my $option = pop if ref $_[-1] eq 'HASH'; |
|
105 |
- my $real_table = shift; |
|
106 |
- my $columns = shift; |
|
107 |
- my $table = $option->{alias} || $real_table; |
|
108 |
- |
|
109 |
- # Columns |
|
110 |
- unless ($columns) { |
|
111 |
- $columns ||= $self->model($real_table)->columns; |
|
112 |
- } |
|
113 |
- |
|
114 |
- # Separator |
|
115 |
- my $separator = $self->separator; |
|
116 |
- |
|
117 |
- # Column clause |
|
118 |
- my @column; |
|
119 |
- $columns ||= []; |
|
120 |
- push @column, $self->_q($table) . "." . $self->_q($_) . |
|
121 |
- " as " . $self->_q("${table}${separator}$_") |
|
122 |
- for @$columns; |
|
123 |
- |
|
124 |
- return join (', ', @column); |
|
125 |
-} |
|
126 |
- |
|
127 |
-sub connect { |
|
128 |
- my $self = ref $_[0] ? shift : shift->new(@_);; |
|
129 |
- |
|
130 |
- # Connect |
|
131 |
- $self->dbh; |
|
132 |
- |
|
133 |
- return $self; |
|
134 |
-} |
|
135 |
- |
|
136 |
-sub dbh { |
|
137 |
- my $self = shift; |
|
138 |
- |
|
139 |
- # Set |
|
140 |
- if (@_) { |
|
141 |
- $self->{dbh} = $_[0]; |
|
142 |
- |
|
143 |
- return $self; |
|
144 |
- } |
|
145 |
- |
|
146 |
- # Get |
|
147 |
- else { |
|
148 |
- # From Connction manager |
|
149 |
- if (my $connector = $self->connector) { |
|
150 |
- croak "connector must have dbh() method " . _subname |
|
151 |
- unless ref $connector && $connector->can('dbh'); |
|
152 |
- |
|
153 |
- $self->{dbh} = $connector->dbh; |
|
154 |
- } |
|
155 |
- |
|
156 |
- # Connect |
|
157 |
- $self->{dbh} ||= $self->_connect; |
|
158 |
- |
|
159 |
- # Quote |
|
160 |
- if (!defined $self->reserved_word_quote && !defined $self->quote) { |
|
161 |
- my $driver = $self->{dbh}->{Driver}->{Name}; |
|
162 |
- my $quote = $driver eq 'mysql' ? '`' : '"'; |
|
163 |
- $self->quote($quote); |
|
164 |
- } |
|
165 |
- |
|
166 |
- return $self->{dbh}; |
|
167 |
- } |
|
168 |
-} |
|
169 |
- |
|
170 |
-sub delete { |
|
171 |
- my ($self, %args) = @_; |
|
172 |
- |
|
173 |
- # Arguments |
|
174 |
- my $table = $args{table} || ''; |
|
175 |
- croak qq{"table" option must be specified. } . _subname |
|
176 |
- unless $table; |
|
177 |
- my $where = delete $args{where} || {}; |
|
178 |
- my $append = delete $args{append}; |
|
179 |
- my $allow_delete_all = delete $args{allow_delete_all}; |
|
180 |
- my $where_param = delete $args{where_param} || {}; |
|
181 |
- my $id = delete $args{id}; |
|
182 |
- my $primary_key = delete $args{primary_key}; |
|
183 |
- croak "update method primary_key option " . |
|
184 |
- "must be specified when id is specified " . _subname |
|
185 |
- if defined $id && !defined $primary_key; |
|
186 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
187 |
- my $prefix = delete $args{prefix}; |
|
188 |
- |
|
189 |
- # Where |
|
190 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
191 |
- my $where_clause = ''; |
|
192 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
193 |
- $where_clause = "where " . $where->[0]; |
|
194 |
- $where_param = $where->[1]; |
|
195 |
- } |
|
196 |
- elsif (ref $where) { |
|
197 |
- $where = $self->_where_to_obj($where); |
|
198 |
- $where_param = keys %$where_param |
|
199 |
- ? $self->merge_param($where_param, $where->param) |
|
200 |
- : $where->param; |
|
201 |
- |
|
202 |
- # String where |
|
203 |
- $where_clause = $where->to_string; |
|
204 |
- } |
|
205 |
- elsif ($where) { $where_clause = "where $where" } |
|
206 |
- croak qq{"where" must be specified } . _subname |
|
207 |
- if $where_clause eq '' && !$allow_delete_all; |
|
208 |
- |
|
209 |
- # Delete statement |
|
210 |
- my @sql; |
|
211 |
- push @sql, "delete"; |
|
212 |
- push @sql, $prefix if defined $prefix; |
|
213 |
- push @sql, "from " . $self->_q($table) . " $where_clause"; |
|
214 |
- push @sql, $append if defined $append; |
|
215 |
- my $sql = join(' ', @sql); |
|
216 |
- |
|
217 |
- # Execute query |
|
218 |
- return $self->execute($sql, $where_param, table => $table, %args); |
|
219 |
-} |
|
220 |
- |
|
221 |
-sub delete_all { shift->delete(allow_delete_all => 1, @_) } |
|
222 |
- |
|
223 |
-sub DESTROY { } |
|
224 |
- |
|
225 |
-sub create_model { |
|
226 |
- my $self = shift; |
|
227 |
- |
|
228 |
- # Arguments |
|
229 |
- my $args = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
230 |
- $args->{dbi} = $self; |
|
231 |
- my $model_class = delete $args->{model_class} || 'DBIx::Custom::Model'; |
|
232 |
- my $model_name = delete $args->{name}; |
|
233 |
- my $model_table = delete $args->{table}; |
|
234 |
- $model_name ||= $model_table; |
|
235 |
- |
|
236 |
- # Create model |
|
237 |
- my $model = $model_class->new($args); |
|
238 |
- $model->name($model_name) unless $model->name; |
|
239 |
- $model->table($model_table) unless $model->table; |
|
240 |
- |
|
241 |
- # Apply filter(DEPRECATED logic) |
|
242 |
- if ($model->{filter}) { |
|
243 |
- my $filter = ref $model->filter eq 'HASH' |
|
244 |
- ? [%{$model->filter}] |
|
245 |
- : $model->filter; |
|
246 |
- $filter ||= []; |
|
247 |
- warn "DBIx::Custom::Model filter method is DEPRECATED!" |
|
248 |
- if @$filter; |
|
249 |
- $self->_apply_filter($model->table, @$filter); |
|
250 |
- } |
|
251 |
- |
|
252 |
- # Set model |
|
253 |
- $self->model($model->name, $model); |
|
254 |
- |
|
255 |
- return $self->model($model->name); |
|
256 |
-} |
|
257 |
- |
|
258 |
-sub each_column { |
|
259 |
- my ($self, $cb) = @_; |
|
260 |
- |
|
261 |
- # Iterate all tables |
|
262 |
- my $sth_tables = $self->dbh->table_info; |
|
263 |
- while (my $table_info = $sth_tables->fetchrow_hashref) { |
|
264 |
- |
|
265 |
- # Table |
|
266 |
- my $table = $table_info->{TABLE_NAME}; |
|
267 |
- |
|
268 |
- # Iterate all columns |
|
269 |
- my $sth_columns = $self->dbh->column_info(undef, undef, $table, '%'); |
|
270 |
- while (my $column_info = $sth_columns->fetchrow_hashref) { |
|
271 |
- my $column = $column_info->{COLUMN_NAME}; |
|
272 |
- $self->$cb($table, $column, $column_info); |
|
273 |
- } |
|
274 |
- } |
|
275 |
-} |
|
276 |
- |
|
277 |
-sub each_table { |
|
278 |
- my ($self, $cb) = @_; |
|
279 |
- |
|
280 |
- # Iterate all tables |
|
281 |
- my $sth_tables = $self->dbh->table_info; |
|
282 |
- while (my $table_info = $sth_tables->fetchrow_hashref) { |
|
283 |
- |
|
284 |
- # Table |
|
285 |
- my $table = $table_info->{TABLE_NAME}; |
|
286 |
- $self->$cb($table, $table_info); |
|
287 |
- } |
|
288 |
-} |
|
289 |
- |
|
290 |
-our %VALID_ARGS = map { $_ => 1 } qw/append allow_delete_all |
|
291 |
- allow_update_all bind_type column filter id join param prefix primary_key |
|
292 |
- query relation table table_alias type type_rule_off type_rule1_off |
|
293 |
- type_rule2_off wrap/; |
|
294 |
- |
|
295 |
-sub execute { |
|
296 |
- my $self = shift; |
|
297 |
- my $query = shift; |
|
298 |
- my $param; |
|
299 |
- $param = shift if @_ % 2; |
|
300 |
- my %args = @_; |
|
301 |
- |
|
302 |
- # Arguments |
|
303 |
- my $p = delete $args{param} || {}; |
|
304 |
- $param ||= $p; |
|
305 |
- my $tables = delete $args{table} || []; |
|
306 |
- $tables = [$tables] unless ref $tables eq 'ARRAY'; |
|
307 |
- my $filter = delete $args{filter}; |
|
308 |
- $filter = _array_to_hash($filter); |
|
309 |
- my $bind_type = delete $args{bind_type} || delete $args{type}; |
|
310 |
- $bind_type = _array_to_hash($bind_type); |
|
311 |
- my $type_rule_off = delete $args{type_rule_off}; |
|
312 |
- my $type_rule_off_parts = { |
|
313 |
- 1 => delete $args{type_rule1_off}, |
|
314 |
- 2 => delete $args{type_rule2_off} |
|
315 |
- }; |
|
316 |
- my $query_return = delete $args{query}; |
|
317 |
- my $table_alias = delete $args{table_alias} || {}; |
|
318 |
- |
|
319 |
- # Check argument names |
|
320 |
- foreach my $name (keys %args) { |
|
321 |
- croak qq{"$name" is wrong option } . _subname |
|
322 |
- unless $VALID_ARGS{$name}; |
|
323 |
- } |
|
324 |
- |
|
325 |
- # Create query |
|
326 |
- $query = $self->_create_query($query) unless ref $query; |
|
327 |
- |
|
328 |
- # Save query |
|
329 |
- $self->last_sql($query->sql); |
|
330 |
- |
|
331 |
- return $query if $query_return; |
|
332 |
- |
|
333 |
- # DEPRECATED! Merge query filter |
|
334 |
- $filter ||= $query->{filter} || {}; |
|
335 |
- |
|
336 |
- # Tables |
|
337 |
- unshift @$tables, @{$query->{tables} || []}; |
|
338 |
- my $main_table = @{$tables}[-1]; |
|
339 |
- |
|
340 |
- # DEPRECATED! Cleanup tables |
|
341 |
- $tables = $self->_remove_duplicate_table($tables, $main_table) |
|
342 |
- if @$tables > 1; |
|
343 |
- |
|
344 |
- # Type rule |
|
345 |
- my $type_filters = {}; |
|
346 |
- unless ($type_rule_off) { |
|
347 |
- foreach my $i (1, 2) { |
|
348 |
- unless ($type_rule_off_parts->{$i}) { |
|
349 |
- $type_filters->{$i} = {}; |
|
350 |
- foreach my $alias (keys %$table_alias) { |
|
351 |
- my $table = $table_alias->{$alias}; |
|
352 |
- |
|
353 |
- foreach my $column (keys %{$self->{"_into$i"}{key}{$table} || {}}) { |
|
354 |
- $type_filters->{$i}->{"$alias.$column"} = $self->{"_into$i"}{key}{$table}{$column}; |
|
355 |
- } |
|
356 |
- } |
|
357 |
- $type_filters->{$i} = {%{$type_filters->{$i}}, %{$self->{"_into$i"}{key}{$main_table} || {}}} |
|
358 |
- if $main_table; |
|
359 |
- } |
|
360 |
- } |
|
361 |
- } |
|
362 |
- |
|
363 |
- # DEPRECATED! Applied filter |
|
364 |
- if ($self->{filter}{on}) { |
|
365 |
- my $applied_filter = {}; |
|
366 |
- foreach my $table (@$tables) { |
|
367 |
- $applied_filter = { |
|
368 |
- %$applied_filter, |
|
369 |
- %{$self->{filter}{out}->{$table} || {}} |
|
370 |
- } |
|
371 |
- } |
|
372 |
- $filter = {%$applied_filter, %$filter}; |
|
373 |
- } |
|
374 |
- |
|
375 |
- # Replace filter name to code |
|
376 |
- foreach my $column (keys %$filter) { |
|
377 |
- my $name = $filter->{$column}; |
|
378 |
- if (!defined $name) { |
|
379 |
- $filter->{$column} = undef; |
|
380 |
- } |
|
381 |
- elsif (ref $name ne 'CODE') { |
|
382 |
- croak qq{Filter "$name" is not registered" } . _subname |
|
383 |
- unless exists $self->filters->{$name}; |
|
384 |
- $filter->{$column} = $self->filters->{$name}; |
|
385 |
- } |
|
386 |
- } |
|
387 |
- |
|
388 |
- # Create bind values |
|
389 |
- my $bind = $self->_create_bind_values( |
|
390 |
- $param, |
|
391 |
- $query->columns, |
|
392 |
- $filter, |
|
393 |
- $type_filters, |
|
394 |
- $bind_type |
|
395 |
- ); |
|
396 |
- |
|
397 |
- # Execute |
|
398 |
- my $sth = $query->sth; |
|
399 |
- my $affected; |
|
400 |
- eval { |
|
401 |
- for (my $i = 0; $i < @$bind; $i++) { |
|
402 |
- my $bind_type = $bind->[$i]->{bind_type}; |
|
403 |
- $sth->bind_param( |
|
404 |
- $i + 1, |
|
405 |
- $bind->[$i]->{value}, |
|
406 |
- $bind_type ? $bind_type : () |
|
407 |
- ); |
|
408 |
- } |
|
409 |
- $affected = $sth->execute; |
|
410 |
- }; |
|
411 |
- |
|
412 |
- $self->_croak($@, qq{. Following SQL is executed.\n} |
|
413 |
- . qq{$query->{sql}\n} . _subname) if $@; |
|
414 |
- |
|
415 |
- # DEBUG message |
|
416 |
- if (DEBUG) { |
|
417 |
- print STDERR "SQL:\n" . $query->sql . "\n"; |
|
418 |
- my @output; |
|
419 |
- foreach my $b (@$bind) { |
|
420 |
- my $value = $b->{value}; |
|
421 |
- $value = 'undef' unless defined $value; |
|
422 |
- $value = encode(DEBUG_ENCODING(), $value) |
|
423 |
- if utf8::is_utf8($value); |
|
424 |
- push @output, $value; |
|
425 |
- } |
|
426 |
- print STDERR "Bind values: " . join(', ', @output) . "\n\n"; |
|
427 |
- } |
|
428 |
- |
|
429 |
- # Select statement |
|
430 |
- if ($sth->{NUM_OF_FIELDS}) { |
|
431 |
- |
|
432 |
- # DEPRECATED! Filter |
|
433 |
- my $filter = {}; |
|
434 |
- if ($self->{filter}{on}) { |
|
435 |
- $filter->{in} = {}; |
|
436 |
- $filter->{end} = {}; |
|
437 |
- push @$tables, $main_table if $main_table; |
|
438 |
- foreach my $table (@$tables) { |
|
439 |
- foreach my $way (qw/in end/) { |
|
440 |
- $filter->{$way} = { |
|
441 |
- %{$filter->{$way}}, |
|
442 |
- %{$self->{filter}{$way}{$table} || {}} |
|
443 |
- }; |
|
444 |
- } |
|
445 |
- } |
|
446 |
- } |
|
447 |
- |
|
448 |
- # Result |
|
449 |
- my $result = $self->result_class->new( |
|
450 |
- sth => $sth, |
|
451 |
- dbi => $self, |
|
452 |
- default_filter => $self->{default_in_filter}, |
|
453 |
- filter => $filter->{in} || {}, |
|
454 |
- end_filter => $filter->{end} || {}, |
|
455 |
- type_rule => { |
|
456 |
- from1 => $self->type_rule->{from1}, |
|
457 |
- from2 => $self->type_rule->{from2} |
|
458 |
- }, |
|
459 |
- ); |
|
460 |
- |
|
461 |
- return $result; |
|
462 |
- } |
|
463 |
- |
|
464 |
- # Not select statement |
|
465 |
- else { return $affected } |
|
466 |
-} |
|
467 |
- |
|
468 |
-sub insert { |
|
469 |
- my $self = shift; |
|
470 |
- |
|
471 |
- # Arguments |
|
472 |
- my $param; |
|
473 |
- $param = shift if @_ % 2; |
|
474 |
- my %args = @_; |
|
475 |
- my $table = delete $args{table}; |
|
476 |
- croak qq{"table" option must be specified } . _subname |
|
477 |
- unless defined $table; |
|
478 |
- my $p = delete $args{param} || {}; |
|
479 |
- $param ||= $p; |
|
480 |
- my $append = delete $args{append} || ''; |
|
481 |
- my $id = delete $args{id}; |
|
482 |
- my $primary_key = delete $args{primary_key}; |
|
483 |
- croak "insert method primary_key option " . |
|
484 |
- "must be specified when id is specified " . _subname |
|
485 |
- if defined $id && !defined $primary_key; |
|
486 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
487 |
- my $prefix = delete $args{prefix}; |
|
488 |
- |
|
489 |
- # Merge parameter |
|
490 |
- if (defined $id) { |
|
491 |
- my $id_param = $self->_create_param_from_id($id, $primary_key); |
|
492 |
- $param = $self->merge_param($id_param, $param); |
|
493 |
- } |
|
494 |
- |
|
495 |
- # Insert statement |
|
496 |
- my @sql; |
|
497 |
- push @sql, "insert"; |
|
498 |
- push @sql, $prefix if defined $prefix; |
|
499 |
- push @sql, "into " . $self->_q($table) . " " . $self->insert_param($param); |
|
500 |
- push @sql, $append if defined $append; |
|
501 |
- my $sql = join (' ', @sql); |
|
502 |
- |
|
503 |
- # Execute query |
|
504 |
- return $self->execute($sql, $param, table => $table, %args); |
|
505 |
-} |
|
506 |
- |
|
507 |
-sub insert_param { |
|
508 |
- my ($self, $param) = @_; |
|
509 |
- |
|
510 |
- # Create insert parameter tag |
|
511 |
- my $safety = $self->safety_character; |
|
512 |
- my @columns; |
|
513 |
- my @placeholders; |
|
514 |
- foreach my $column (sort keys %$param) { |
|
515 |
- croak qq{"$column" is not safety column name } . _subname |
|
516 |
- unless $column =~ /^[$safety\.]+$/; |
|
517 |
- my $column_quote = $self->_q($column); |
|
518 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
519 |
- push @columns, $column_quote; |
|
520 |
- push @placeholders, ref $param->{$column} eq 'SCALAR' |
|
521 |
- ? ${$param->{$column}} : ":$column"; |
|
522 |
- } |
|
523 |
- |
|
524 |
- return '(' . join(', ', @columns) . ') ' . 'values ' . |
|
525 |
- '(' . join(', ', @placeholders) . ')' |
|
526 |
-} |
|
527 |
- |
|
528 |
-sub include_model { |
|
529 |
- my ($self, $name_space, $model_infos) = @_; |
|
530 |
- |
|
531 |
- # Name space |
|
532 |
- $name_space ||= ''; |
|
533 |
- |
|
534 |
- # Get Model infomations |
|
535 |
- unless ($model_infos) { |
|
536 |
- |
|
537 |
- # Load name space module |
|
538 |
- croak qq{"$name_space" is invalid class name } . _subname |
|
539 |
- if $name_space =~ /[^\w:]/; |
|
540 |
- eval "use $name_space"; |
|
541 |
- croak qq{Name space module "$name_space.pm" is needed. $@ } |
|
542 |
- . _subname |
|
543 |
- if $@; |
|
544 |
- |
|
545 |
- # Search model modules |
|
546 |
- my $path = $INC{"$name_space.pm"}; |
|
547 |
- $path =~ s/\.pm$//; |
|
548 |
- opendir my $dh, $path |
|
549 |
- or croak qq{Can't open directory "$path": $! } . _subname |
|
550 |
- $model_infos = []; |
|
551 |
- while (my $module = readdir $dh) { |
|
552 |
- push @$model_infos, $module |
|
553 |
- if $module =~ s/\.pm$//; |
|
554 |
- } |
|
555 |
- close $dh; |
|
556 |
- } |
|
557 |
- |
|
558 |
- # Include models |
|
559 |
- foreach my $model_info (@$model_infos) { |
|
560 |
- |
|
561 |
- # Load model |
|
562 |
- my $model_class; |
|
563 |
- my $model_name; |
|
564 |
- my $model_table; |
|
565 |
- if (ref $model_info eq 'HASH') { |
|
566 |
- $model_class = $model_info->{class}; |
|
567 |
- $model_name = $model_info->{name}; |
|
568 |
- $model_table = $model_info->{table}; |
|
569 |
- |
|
570 |
- $model_name ||= $model_class; |
|
571 |
- $model_table ||= $model_name; |
|
572 |
- } |
|
573 |
- else { $model_class = $model_name = $model_table = $model_info } |
|
574 |
- my $mclass = "${name_space}::$model_class"; |
|
575 |
- croak qq{"$mclass" is invalid class name } . _subname |
|
576 |
- if $mclass =~ /[^\w:]/; |
|
577 |
- unless ($mclass->can('isa')) { |
|
578 |
- eval "use $mclass"; |
|
579 |
- croak "$@ " . _subname if $@; |
|
580 |
- } |
|
581 |
- |
|
582 |
- # Create model |
|
583 |
- my $args = {}; |
|
584 |
- $args->{model_class} = $mclass if $mclass; |
|
585 |
- $args->{name} = $model_name if $model_name; |
|
586 |
- $args->{table} = $model_table if $model_table; |
|
587 |
- $self->create_model($args); |
|
588 |
- } |
|
589 |
- |
|
590 |
- return $self; |
|
591 |
-} |
|
592 |
- |
|
593 |
-sub map_param { |
|
594 |
- my $self = shift; |
|
595 |
- my $param = shift; |
|
596 |
- my %map = @_; |
|
597 |
- |
|
598 |
- # Mapping |
|
599 |
- my $map_param = {}; |
|
600 |
- foreach my $key (keys %map) { |
|
601 |
- my $value_cb; |
|
602 |
- my $condition; |
|
603 |
- my $map_key; |
|
604 |
- |
|
605 |
- # Get mapping information |
|
606 |
- if (ref $map{$key} eq 'ARRAY') { |
|
607 |
- foreach my $some (@{$map{$key}}) { |
|
608 |
- $map_key = $some unless ref $some; |
|
609 |
- $condition = $some->{if} if ref $some eq 'HASH'; |
|
610 |
- $value_cb = $some if ref $some eq 'CODE'; |
|
611 |
- } |
|
612 |
- } |
|
613 |
- else { |
|
614 |
- $map_key = $map{$key}; |
|
615 |
- } |
|
616 |
- $value_cb ||= sub { $_[0] }; |
|
617 |
- $condition ||= sub { defined $_[0] && length $_[0] }; |
|
618 |
- |
|
619 |
- # Map parameter |
|
620 |
- my $value; |
|
621 |
- if (ref $condition eq 'CODE') { |
|
622 |
- $map_param->{$map_key} = $value_cb->($param->{$key}) |
|
623 |
- if $condition->($param->{$key}); |
|
624 |
- } |
|
625 |
- elsif ($condition eq 'exists') { |
|
626 |
- $map_param->{$map_key} = $value_cb->($param->{$key}) |
|
627 |
- if exists $param->{$key}; |
|
628 |
- } |
|
629 |
- else { croak qq/Condition must be code reference or "exists" / . _subname } |
|
630 |
- } |
|
631 |
- |
|
632 |
- return $map_param; |
|
633 |
-} |
|
634 |
- |
|
635 |
-sub merge_param { |
|
636 |
- my ($self, @params) = @_; |
|
637 |
- |
|
638 |
- # Merge parameters |
|
639 |
- my $merge = {}; |
|
640 |
- foreach my $param (@params) { |
|
641 |
- foreach my $column (keys %$param) { |
|
642 |
- my $param_is_array = ref $param->{$column} eq 'ARRAY' ? 1 : 0; |
|
643 |
- |
|
644 |
- if (exists $merge->{$column}) { |
|
645 |
- $merge->{$column} = [$merge->{$column}] |
|
646 |
- unless ref $merge->{$column} eq 'ARRAY'; |
|
647 |
- push @{$merge->{$column}}, |
|
648 |
- ref $param->{$column} ? @{$param->{$column}} : $param->{$column}; |
|
649 |
- } |
|
650 |
- else { |
|
651 |
- $merge->{$column} = $param->{$column}; |
|
652 |
- } |
|
653 |
- } |
|
654 |
- } |
|
655 |
- |
|
656 |
- return $merge; |
|
657 |
-} |
|
658 |
- |
|
659 |
-sub method { |
|
660 |
- my $self = shift; |
|
661 |
- |
|
662 |
- # Register method |
|
663 |
- my $methods = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
664 |
- $self->{_methods} = {%{$self->{_methods} || {}}, %$methods}; |
|
665 |
- |
|
666 |
- return $self; |
|
667 |
-} |
|
668 |
- |
|
669 |
-sub model { |
|
670 |
- my ($self, $name, $model) = @_; |
|
671 |
- |
|
672 |
- # Set model |
|
673 |
- if ($model) { |
|
674 |
- $self->models->{$name} = $model; |
|
675 |
- return $self; |
|
676 |
- } |
|
677 |
- |
|
678 |
- # Check model existance |
|
679 |
- croak qq{Model "$name" is not included } . _subname |
|
680 |
- unless $self->models->{$name}; |
|
681 |
- |
|
682 |
- # Get model |
|
683 |
- return $self->models->{$name}; |
|
684 |
-} |
|
685 |
- |
|
686 |
-sub mycolumn { |
|
687 |
- my ($self, $table, $columns) = @_; |
|
688 |
- |
|
689 |
- # Create column clause |
|
690 |
- my @column; |
|
691 |
- $columns ||= []; |
|
692 |
- push @column, $self->_q($table) . "." . $self->_q($_) . |
|
693 |
- " as " . $self->_q($_) |
|
694 |
- for @$columns; |
|
695 |
- |
|
696 |
- return join (', ', @column); |
|
697 |
-} |
|
698 |
- |
|
699 |
-sub new { |
|
700 |
- my $self = shift->SUPER::new(@_); |
|
701 |
- |
|
702 |
- # Check attributes |
|
703 |
- my @attrs = keys %$self; |
|
704 |
- foreach my $attr (@attrs) { |
|
705 |
- croak qq{"$attr" is wrong name } . _subname |
|
706 |
- unless $self->can($attr); |
|
707 |
- } |
|
708 |
- |
|
709 |
- # DEPRECATED! |
|
710 |
- $self->query_builder->{tags} = { |
|
711 |
- '?' => \&DBIx::Custom::Tag::placeholder, |
|
712 |
- '=' => \&DBIx::Custom::Tag::equal, |
|
713 |
- '<>' => \&DBIx::Custom::Tag::not_equal, |
|
714 |
- '>' => \&DBIx::Custom::Tag::greater_than, |
|
715 |
- '<' => \&DBIx::Custom::Tag::lower_than, |
|
716 |
- '>=' => \&DBIx::Custom::Tag::greater_than_equal, |
|
717 |
- '<=' => \&DBIx::Custom::Tag::lower_than_equal, |
|
718 |
- 'like' => \&DBIx::Custom::Tag::like, |
|
719 |
- 'in' => \&DBIx::Custom::Tag::in, |
|
720 |
- 'insert_param' => \&DBIx::Custom::Tag::insert_param, |
|
721 |
- 'update_param' => \&DBIx::Custom::Tag::update_param |
|
722 |
- }; |
|
723 |
- |
|
724 |
- return $self; |
|
725 |
-} |
|
726 |
- |
|
727 |
-sub not_exists { bless {}, 'DBIx::Custom::NotExists' } |
|
728 |
- |
|
729 |
-sub order { |
|
730 |
- my $self = shift; |
|
731 |
- return DBIx::Custom::Order->new(dbi => $self, @_); |
|
732 |
-} |
|
733 |
- |
|
734 |
-sub register_filter { |
|
735 |
- my $self = shift; |
|
736 |
- |
|
737 |
- # Register filter |
|
738 |
- my $filters = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
739 |
- $self->filters({%{$self->filters}, %$filters}); |
|
740 |
- |
|
741 |
- return $self; |
|
742 |
-} |
|
743 |
- |
|
744 |
-sub select { |
|
745 |
- my ($self, %args) = @_; |
|
746 |
- |
|
747 |
- # Arguments |
|
748 |
- my $table = delete $args{table}; |
|
749 |
- my $tables = ref $table eq 'ARRAY' ? $table |
|
750 |
- : defined $table ? [$table] |
|
751 |
- : []; |
|
752 |
- my $columns = delete $args{column}; |
|
753 |
- my $where = delete $args{where} || {}; |
|
754 |
- my $append = delete $args{append}; |
|
755 |
- my $join = delete $args{join} || []; |
|
756 |
- croak qq{"join" must be array reference } . _subname |
|
757 |
- unless ref $join eq 'ARRAY'; |
|
758 |
- my $relation = delete $args{relation}; |
|
759 |
- warn "select() relation option is DEPRECATED!" |
|
760 |
- if $relation; |
|
761 |
- my $param = delete $args{param} || {}; # DEPRECATED! |
|
762 |
- warn "select() param option is DEPRECATED!" |
|
763 |
- if keys %$param; |
|
764 |
- my $where_param = delete $args{where_param} || $param || {}; |
|
765 |
- my $wrap = delete $args{wrap}; |
|
766 |
- my $id = delete $args{id}; |
|
767 |
- my $primary_key = delete $args{primary_key}; |
|
768 |
- croak "update method primary_key option " . |
|
769 |
- "must be specified when id is specified " . _subname |
|
770 |
- if defined $id && !defined $primary_key; |
|
771 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
772 |
- my $prefix = delete $args{prefix}; |
|
773 |
- |
|
774 |
- # Add relation tables(DEPRECATED!); |
|
775 |
- $self->_add_relation_table($tables, $relation); |
|
776 |
- |
|
777 |
- # Select statement |
|
778 |
- my @sql; |
|
779 |
- push @sql, 'select'; |
|
780 |
- |
|
781 |
- # Prefix |
|
782 |
- push @sql, $prefix if defined $prefix; |
|
783 |
- |
|
784 |
- # Column clause |
|
785 |
- if ($columns) { |
|
786 |
- $columns = [$columns] unless ref $columns eq 'ARRAY'; |
|
787 |
- foreach my $column (@$columns) { |
|
788 |
- if (ref $column eq 'HASH') { |
|
789 |
- $column = $self->column(%$column) if ref $column eq 'HASH'; |
|
790 |
- } |
|
791 |
- elsif (ref $column eq 'ARRAY') { |
|
792 |
- if (@$column == 3 && $column->[1] eq 'as') { |
|
793 |
- warn "[COLUMN, as => ALIAS] is DEPRECATED! use [COLUMN => ALIAS]"; |
|
794 |
- splice @$column, 1, 1; |
|
795 |
- } |
|
796 |
- |
|
797 |
- $column = join(' ', $column->[0], 'as', $self->_q($column->[1])); |
|
798 |
- } |
|
799 |
- unshift @$tables, @{$self->_search_tables($column)}; |
|
800 |
- push @sql, ($column, ','); |
|
801 |
- } |
|
802 |
- pop @sql if $sql[-1] eq ','; |
|
803 |
- } |
|
804 |
- else { push @sql, '*' } |
|
805 |
- |
|
806 |
- # Table |
|
807 |
- push @sql, 'from'; |
|
808 |
- if ($relation) { |
|
809 |
- my $found = {}; |
|
810 |
- foreach my $table (@$tables) { |
|
811 |
- push @sql, ($self->_q($table), ',') unless $found->{$table}; |
|
812 |
- $found->{$table} = 1; |
|
813 |
- } |
|
814 |
- } |
|
815 |
- else { |
|
816 |
- my $main_table = $tables->[-1] || ''; |
|
817 |
- push @sql, $self->_q($main_table); |
|
818 |
- } |
|
819 |
- pop @sql if ($sql[-1] || '') eq ','; |
|
820 |
- croak "Not found table name " . _subname |
|
821 |
- unless $tables->[-1]; |
|
822 |
- |
|
823 |
- # Add tables in parameter |
|
824 |
- unshift @$tables, |
|
825 |
- @{$self->_search_tables(join(' ', keys %$where_param) || '')}; |
|
826 |
- |
|
827 |
- # Where |
|
828 |
- my $where_clause = ''; |
|
829 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
830 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
831 |
- $where_clause = "where " . $where->[0]; |
|
832 |
- $where_param = $where->[1]; |
|
833 |
- } |
|
834 |
- elsif (ref $where) { |
|
835 |
- $where = $self->_where_to_obj($where); |
|
836 |
- $where_param = keys %$where_param |
|
837 |
- ? $self->merge_param($where_param, $where->param) |
|
838 |
- : $where->param; |
|
839 |
- |
|
840 |
- # String where |
|
841 |
- $where_clause = $where->to_string; |
|
842 |
- } |
|
843 |
- elsif ($where) { $where_clause = "where $where" } |
|
844 |
- |
|
845 |
- # Add table names in where clause |
|
846 |
- unshift @$tables, @{$self->_search_tables($where_clause)}; |
|
847 |
- |
|
848 |
- # Push join |
|
849 |
- $self->_push_join(\@sql, $join, $tables); |
|
850 |
- |
|
851 |
- # Add where clause |
|
852 |
- push @sql, $where_clause; |
|
853 |
- |
|
854 |
- # Relation(DEPRECATED!); |
|
855 |
- $self->_push_relation(\@sql, $tables, $relation, $where_clause eq '' ? 1 : 0); |
|
856 |
- |
|
857 |
- # Append |
|
858 |
- push @sql, $append if defined $append; |
|
859 |
- |
|
860 |
- # Wrap |
|
861 |
- if ($wrap) { |
|
862 |
- croak "wrap option must be array refrence " . _subname |
|
863 |
- unless ref $wrap eq 'ARRAY'; |
|
864 |
- unshift @sql, $wrap->[0]; |
|
865 |
- push @sql, $wrap->[1]; |
|
866 |
- } |
|
867 |
- |
|
868 |
- # SQL |
|
869 |
- my $sql = join (' ', @sql); |
|
870 |
- |
|
871 |
- # Execute query |
|
872 |
- my $result = $self->execute($sql, $where_param, table => $tables, %args); |
|
873 |
- |
|
874 |
- return $result; |
|
875 |
-} |
|
876 |
- |
|
877 |
-sub separator { |
|
878 |
- my $self = shift; |
|
879 |
- |
|
880 |
- if (@_) { |
|
881 |
- my $separator = $_[0] || ''; |
|
882 |
- croak qq{Separator must be "." or "__" or "-" } . _subname |
|
883 |
- unless $separator eq '.' || $separator eq '__' |
|
884 |
- || $separator eq '-'; |
|
885 |
- |
|
886 |
- $self->{separator} = $separator; |
|
887 |
- |
|
888 |
- return $self; |
|
889 |
- } |
|
890 |
- return $self->{separator} ||= '.'; |
|
891 |
-} |
|
892 |
- |
|
893 |
-sub setup_model { |
|
894 |
- my $self = shift; |
|
895 |
- |
|
896 |
- # Setup model |
|
897 |
- $self->each_column( |
|
898 |
- sub { |
|
899 |
- my ($self, $table, $column, $column_info) = @_; |
|
900 |
- if (my $model = $self->models->{$table}) { |
|
901 |
- push @{$model->columns}, $column; |
|
902 |
- } |
|
903 |
- } |
|
904 |
- ); |
|
905 |
- return $self; |
|
906 |
-} |
|
907 |
- |
|
908 |
-sub available_data_type { |
|
909 |
- my $self = shift; |
|
910 |
- |
|
911 |
- my $data_types = ''; |
|
912 |
- foreach my $i (-1000 .. 1000) { |
|
913 |
- my $type_info = $self->dbh->type_info($i); |
|
914 |
- my $data_type = $type_info->{DATA_TYPE}; |
|
915 |
- my $type_name = $type_info->{TYPE_NAME}; |
|
916 |
- $data_types .= "$data_type ($type_name)\n" |
|
917 |
- if defined $data_type; |
|
918 |
- } |
|
919 |
- return "Data Type maybe equal to Type Name" unless $data_types; |
|
920 |
- $data_types = "Data Type (Type name)\n" . $data_types; |
|
921 |
- return $data_types; |
|
922 |
-} |
|
923 |
- |
|
924 |
-sub available_type_name { |
|
925 |
- my $self = shift; |
|
926 |
- |
|
927 |
- # Type Names |
|
928 |
- my $type_names = {}; |
|
929 |
- $self->each_column(sub { |
|
930 |
- my ($self, $table, $column, $column_info) = @_; |
|
931 |
- $type_names->{$column_info->{TYPE_NAME}} = 1 |
|
932 |
- if $column_info->{TYPE_NAME}; |
|
933 |
- }); |
|
934 |
- my @output = sort keys %$type_names; |
|
935 |
- unshift @output, "Type Name"; |
|
936 |
- return join "\n", @output; |
|
937 |
-} |
|
938 |
- |
|
939 |
-sub type_rule { |
|
940 |
- my $self = shift; |
|
941 |
- |
|
942 |
- if (@_) { |
|
943 |
- my $type_rule = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
944 |
- |
|
945 |
- # Into |
|
946 |
- foreach my $i (1 .. 2) { |
|
947 |
- my $into = "into$i"; |
|
948 |
- $type_rule->{$into} = _array_to_hash($type_rule->{$into}); |
|
949 |
- $self->{type_rule} = $type_rule; |
|
950 |
- $self->{"_$into"} = {}; |
|
951 |
- foreach my $type_name (keys %{$type_rule->{$into} || {}}) { |
|
952 |
- croak qq{type name of $into section must be lower case} |
|
953 |
- if $type_name =~ /[A-Z]/; |
|
954 |
- } |
|
955 |
- $self->each_column(sub { |
|
956 |
- my ($dbi, $table, $column, $column_info) = @_; |
|
957 |
- |
|
958 |
- my $type_name = lc $column_info->{TYPE_NAME}; |
|
959 |
- if ($type_rule->{$into} && |
|
960 |
- (my $filter = $type_rule->{$into}->{$type_name})) |
|
961 |
- { |
|
962 |
- return unless exists $type_rule->{$into}->{$type_name}; |
|
963 |
- if (defined $filter && ref $filter ne 'CODE') |
|
964 |
- { |
|
965 |
- my $fname = $filter; |
|
966 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
967 |
- unless exists $self->filters->{$fname}; |
|
968 |
- |
|
969 |
- $filter = $self->filters->{$fname}; |
|
970 |
- } |
|
971 |
- |
|
972 |
- $self->{"_$into"}{key}{$table}{$column} = $filter; |
|
973 |
- $self->{"_$into"}{dot}{"$table.$column"} = $filter; |
|
974 |
- } |
|
975 |
- }); |
|
976 |
- } |
|
977 |
- |
|
978 |
- # From |
|
979 |
- foreach my $i (1 .. 2) { |
|
980 |
- $type_rule->{"from$i"} = _array_to_hash($type_rule->{"from$i"}); |
|
981 |
- foreach my $data_type (keys %{$type_rule->{"from$i"} || {}}) { |
|
982 |
- croak qq{data type of from$i section must be lower case or number} |
|
983 |
- if $data_type =~ /[A-Z]/; |
|
984 |
- my $fname = $type_rule->{"from$i"}{$data_type}; |
|
985 |
- if (defined $fname && ref $fname ne 'CODE') { |
|
986 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
987 |
- unless exists $self->filters->{$fname}; |
|
988 |
- |
|
989 |
- $type_rule->{"from$i"}{$data_type} = $self->filters->{$fname}; |
|
990 |
- } |
|
991 |
- } |
|
992 |
- } |
|
993 |
- |
|
994 |
- return $self; |
|
995 |
- } |
|
996 |
- |
|
997 |
- return $self->{type_rule} || {}; |
|
998 |
-} |
|
999 |
- |
|
1000 |
-sub update { |
|
1001 |
- my $self = shift; |
|
1002 |
- |
|
1003 |
- # Arguments |
|
1004 |
- my $param; |
|
1005 |
- $param = shift if @_ % 2; |
|
1006 |
- my %args = @_; |
|
1007 |
- my $table = delete $args{table} || ''; |
|
1008 |
- croak qq{"table" option must be specified } . _subname |
|
1009 |
- unless $table; |
|
1010 |
- my $p = delete $args{param} || {}; |
|
1011 |
- $param ||= $p; |
|
1012 |
- my $where = delete $args{where} || {}; |
|
1013 |
- my $where_param = delete $args{where_param} || {}; |
|
1014 |
- my $append = delete $args{append} || ''; |
|
1015 |
- my $allow_update_all = delete $args{allow_update_all}; |
|
1016 |
- my $id = delete $args{id}; |
|
1017 |
- my $primary_key = delete $args{primary_key}; |
|
1018 |
- croak "update method primary_key option " . |
|
1019 |
- "must be specified when id is specified " . _subname |
|
1020 |
- if defined $id && !defined $primary_key; |
|
1021 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
1022 |
- my $prefix = delete $args{prefix}; |
|
1023 |
- |
|
1024 |
- # Update clause |
|
1025 |
- my $update_clause = $self->update_param($param); |
|
1026 |
- |
|
1027 |
- # Where |
|
1028 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
1029 |
- my $where_clause = ''; |
|
1030 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
1031 |
- $where_clause = "where " . $where->[0]; |
|
1032 |
- $where_param = $where->[1]; |
|
1033 |
- } |
|
1034 |
- elsif (ref $where) { |
|
1035 |
- $where = $self->_where_to_obj($where); |
|
1036 |
- $where_param = keys %$where_param |
|
1037 |
- ? $self->merge_param($where_param, $where->param) |
|
1038 |
- : $where->param; |
|
1039 |
- |
|
1040 |
- # String where |
|
1041 |
- $where_clause = $where->to_string; |
|
1042 |
- } |
|
1043 |
- elsif ($where) { $where_clause = "where $where" } |
|
1044 |
- croak qq{"where" must be specified } . _subname |
|
1045 |
- if "$where_clause" eq '' && !$allow_update_all; |
|
1046 |
- |
|
1047 |
- # Merge param |
|
1048 |
- $param = $self->merge_param($param, $where_param) if keys %$where_param; |
|
1049 |
- |
|
1050 |
- # Update statement |
|
1051 |
- my @sql; |
|
1052 |
- push @sql, "update"; |
|
1053 |
- push @sql, $prefix if defined $prefix; |
|
1054 |
- push @sql, $self->_q($table) . " $update_clause $where_clause"; |
|
1055 |
- push @sql, $append if defined $append; |
|
1056 |
- |
|
1057 |
- # SQL |
|
1058 |
- my $sql = join(' ', @sql); |
|
1059 |
- |
|
1060 |
- # Execute query |
|
1061 |
- return $self->execute($sql, $param, table => $table, %args); |
|
1062 |
-} |
|
1063 |
- |
|
1064 |
-sub update_all { shift->update(allow_update_all => 1, @_) }; |
|
1065 |
- |
|
1066 |
-sub update_param { |
|
1067 |
- my ($self, $param, $opt) = @_; |
|
1068 |
- |
|
1069 |
- # Create update parameter tag |
|
1070 |
- my $tag = $self->assign_param($param); |
|
1071 |
- $tag = "set $tag" unless $opt->{no_set}; |
|
1072 |
- |
|
1073 |
- return $tag; |
|
1074 |
-} |
|
1075 |
- |
|
1076 |
-sub where { DBIx::Custom::Where->new(dbi => shift, @_) } |
|
1077 |
- |
|
1078 |
-sub _create_query { |
|
1079 |
- |
|
1080 |
- my ($self, $source) = @_; |
|
1081 |
- |
|
1082 |
- # Cache |
|
1083 |
- my $cache = $self->cache; |
|
1084 |
- |
|
1085 |
- # Query |
|
1086 |
- my $query; |
|
1087 |
- |
|
1088 |
- # Get cached query |
|
1089 |
- if ($cache) { |
|
1090 |
- |
|
1091 |
- # Get query |
|
1092 |
- my $q = $self->cache_method->($self, $source); |
|
1093 |
- |
|
1094 |
- # Create query |
|
1095 |
- if ($q) { |
|
1096 |
- $query = DBIx::Custom::Query->new($q); |
|
1097 |
- $query->{filters} = $self->filters; |
|
1098 |
- } |
|
1099 |
- } |
|
1100 |
- |
|
1101 |
- # Create query |
|
1102 |
- unless ($query) { |
|
1103 |
- |
|
1104 |
- # Create query |
|
1105 |
- my $builder = $self->query_builder; |
|
1106 |
- $query = $builder->build_query($source); |
|
1107 |
- |
|
1108 |
- # Remove reserved word quote |
|
1109 |
- if (my $q = $self->_quote) { |
|
1110 |
- $q = quotemeta($q); |
|
1111 |
- $_ =~ s/[$q]//g for @{$query->columns} |
|
1112 |
- } |
|
1113 |
- |
|
1114 |
- # Save query to cache |
|
1115 |
- $self->cache_method->( |
|
1116 |
- $self, $source, |
|
1117 |
- { |
|
1118 |
- sql => $query->sql, |
|
1119 |
- columns => $query->columns, |
|
1120 |
- tables => $query->{tables} || [] |
|
1121 |
- } |
|
1122 |
- ) if $cache; |
|
1123 |
- } |
|
1124 |
- |
|
1125 |
- # Save sql |
|
1126 |
- $self->last_sql($query->sql); |
|
1127 |
- |
|
1128 |
- # Prepare statement handle |
|
1129 |
- my $sth; |
|
1130 |
- eval { $sth = $self->dbh->prepare($query->{sql})}; |
|
1131 |
- |
|
1132 |
- if ($@) { |
|
1133 |
- $self->_croak($@, qq{. Following SQL is executed.\n} |
|
1134 |
- . qq{$query->{sql}\n} . _subname); |
|
1135 |
- } |
|
1136 |
- |
|
1137 |
- # Set statement handle |
|
1138 |
- $query->sth($sth); |
|
1139 |
- |
|
1140 |
- # Set filters |
|
1141 |
- $query->{filters} = $self->filters; |
|
1142 |
- |
|
1143 |
- return $query; |
|
1144 |
-} |
|
1145 |
- |
|
1146 |
-sub _create_bind_values { |
|
1147 |
- my ($self, $params, $columns, $filter, $type_filters, $bind_type) = @_; |
|
1148 |
- |
|
1149 |
- # Create bind values |
|
1150 |
- my $bind = []; |
|
1151 |
- my $count = {}; |
|
1152 |
- my $not_exists = {}; |
|
1153 |
- foreach my $column (@$columns) { |
|
1154 |
- |
|
1155 |
- # Value |
|
1156 |
- my $value; |
|
1157 |
- if(ref $params->{$column} eq 'ARRAY') { |
|
1158 |
- my $i = $count->{$column} || 0; |
|
1159 |
- $i += $not_exists->{$column} || 0; |
|
1160 |
- my $found; |
|
1161 |
- for (my $k = $i; $i < @{$params->{$column}}; $k++) { |
|
1162 |
- if (ref $params->{$column}->[$k] eq 'DBIx::Custom::NotExists') { |
|
1163 |
- $not_exists->{$column}++; |
|
1164 |
- } |
|
1165 |
- else { |
|
1166 |
- $value = $params->{$column}->[$k]; |
|
1167 |
- $found = 1; |
|
1168 |
- last |
|
1169 |
- } |
|
1170 |
- } |
|
1171 |
- next unless $found; |
|
1172 |
- } |
|
1173 |
- else { $value = $params->{$column} } |
|
1174 |
- |
|
1175 |
- # Filter |
|
1176 |
- my $f = $filter->{$column} || $self->{default_out_filter} || ''; |
|
1177 |
- $value = $f->($value) if $f; |
|
1178 |
- |
|
1179 |
- # Type rule |
|
1180 |
- foreach my $i (1 .. 2) { |
|
1181 |
- my $type_filter = $type_filters->{$i}; |
|
1182 |
- my $tf = $self->{"_into$i"}->{dot}->{$column} || $type_filter->{$column}; |
|
1183 |
- $value = $tf->($value) if $tf; |
|
1184 |
- } |
|
1185 |
- |
|
1186 |
- # Bind values |
|
1187 |
- push @$bind, {value => $value, bind_type => $bind_type->{$column}}; |
|
1188 |
- |
|
1189 |
- # Count up |
|
1190 |
- $count->{$column}++; |
|
1191 |
- } |
|
1192 |
- |
|
1193 |
- return $bind; |
|
1194 |
-} |
|
1195 |
- |
|
1196 |
-sub _create_param_from_id { |
|
1197 |
- my ($self, $id, $primary_keys) = @_; |
|
1198 |
- |
|
1199 |
- # Create parameter |
|
1200 |
- my $param = {}; |
|
1201 |
- if (defined $id) { |
|
1202 |
- $id = [$id] unless ref $id; |
|
1203 |
- croak qq{"id" must be constant value or array reference} |
|
1204 |
- . " (" . (caller 1)[3] . ")" |
|
1205 |
- unless !ref $id || ref $id eq 'ARRAY'; |
|
1206 |
- croak qq{"id" must contain values same count as primary key} |
|
1207 |
- . " (" . (caller 1)[3] . ")" |
|
1208 |
- unless @$primary_keys eq @$id; |
|
1209 |
- for(my $i = 0; $i < @$primary_keys; $i ++) { |
|
1210 |
- $param->{$primary_keys->[$i]} = $id->[$i]; |
|
1211 |
- } |
|
1212 |
- } |
|
1213 |
- |
|
1214 |
- return $param; |
|
1215 |
-} |
|
1216 |
- |
|
1217 |
-sub _connect { |
|
1218 |
- my $self = shift; |
|
1219 |
- |
|
1220 |
- # Attributes |
|
1221 |
- my $dsn = $self->data_source; |
|
1222 |
- warn "data_source is DEPRECATED!\n" |
|
1223 |
- if $dsn; |
|
1224 |
- $dsn ||= $self->dsn; |
|
1225 |
- croak qq{"dsn" must be specified } . _subname |
|
1226 |
- unless $dsn; |
|
1227 |
- my $user = $self->user; |
|
1228 |
- my $password = $self->password; |
|
1229 |
- my $dbi_option = {%{$self->dbi_options}, %{$self->dbi_option}}; |
|
1230 |
- warn "dbi_options is DEPRECATED! use dbi_option instead\n" |
|
1231 |
- if keys %{$self->dbi_options}; |
|
1232 |
- |
|
1233 |
- # Connect |
|
1234 |
- my $dbh = eval {DBI->connect( |
|
1235 |
- $dsn, |
|
1236 |
- $user, |
|
1237 |
- $password, |
|
1238 |
- { |
|
1239 |
- %{$self->default_dbi_option}, |
|
1240 |
- %$dbi_option |
|
1241 |
- } |
|
1242 |
- )}; |
|
1243 |
- |
|
1244 |
- # Connect error |
|
1245 |
- croak "$@ " . _subname if $@; |
|
1246 |
- |
|
1247 |
- return $dbh; |
|
1248 |
-} |
|
1249 |
- |
|
1250 |
-sub _croak { |
|
1251 |
- my ($self, $error, $append) = @_; |
|
1252 |
- |
|
1253 |
- # Append |
|
1254 |
- $append ||= ""; |
|
1255 |
- |
|
1256 |
- # Verbose |
|
1257 |
- if ($Carp::Verbose) { croak $error } |
|
1258 |
- |
|
1259 |
- # Not verbose |
|
1260 |
- else { |
|
1261 |
- |
|
1262 |
- # Remove line and module infromation |
|
1263 |
- my $at_pos = rindex($error, ' at '); |
|
1264 |
- $error = substr($error, 0, $at_pos); |
|
1265 |
- $error =~ s/\s+$//; |
|
1266 |
- croak "$error$append"; |
|
1267 |
- } |
|
1268 |
-} |
|
1269 |
- |
|
1270 |
-sub _need_tables { |
|
1271 |
- my ($self, $tree, $need_tables, $tables) = @_; |
|
1272 |
- |
|
1273 |
- # Get needed tables |
|
1274 |
- foreach my $table (@$tables) { |
|
1275 |
- if ($tree->{$table}) { |
|
1276 |
- $need_tables->{$table} = 1; |
|
1277 |
- $self->_need_tables($tree, $need_tables, [$tree->{$table}{parent}]) |
|
1278 |
- } |
|
1279 |
- } |
|
1280 |
-} |
|
1281 |
- |
|
1282 |
-sub _push_join { |
|
1283 |
- my ($self, $sql, $join, $join_tables) = @_; |
|
1284 |
- |
|
1285 |
- # No join |
|
1286 |
- return unless @$join; |
|
1287 |
- |
|
1288 |
- # Push join clause |
|
1289 |
- my $tree = {}; |
|
1290 |
- for (my $i = 0; $i < @$join; $i++) { |
|
1291 |
- |
|
1292 |
- # Arrange |
|
1293 |
- my $join_clause;; |
|
1294 |
- my $option; |
|
1295 |
- if (ref $join->[$i] eq 'HASH') { |
|
1296 |
- $join_clause = $join->[$i]->{clause}; |
|
1297 |
- $option = {table => $join->[$i]->{table}}; |
|
1298 |
- } |
|
1299 |
- else { |
|
1300 |
- $join_clause = $join->[$i]; |
|
1301 |
- $option = {}; |
|
1302 |
- }; |
|
1303 |
- |
|
1304 |
- # Find tables in join clause |
|
1305 |
- my $table1; |
|
1306 |
- my $table2; |
|
1307 |
- if (my $table = $option->{table}) { |
|
1308 |
- $table1 = $table->[0]; |
|
1309 |
- $table2 = $table->[1]; |
|
1310 |
- } |
|
1311 |
- else { |
|
1312 |
- my $q = $self->_quote; |
|
1313 |
- my $j_clause = (split /\s+on\s+/, $join_clause)[-1]; |
|
1314 |
- $j_clause =~ s/'.+?'//g; |
|
1315 |
- my $q_re = quotemeta($q); |
|
1316 |
- $j_clause =~ s/[$q_re]//g; |
|
1317 |
- my $c = $self->safety_character; |
|
1318 |
- my $join_re = qr/(?:^|\s)($c+)\.$c+\s+=\s+($c+)\.$c+/; |
|
1319 |
- if ($j_clause =~ $join_re) { |
|
1320 |
- $table1 = $1; |
|
1321 |
- $table2 = $2; |
|
1322 |
- } |
|
1323 |
- } |
|
1324 |
- croak qq{join clause must have two table name after "on" keyword. } . |
|
1325 |
- qq{"$join_clause" is passed } . _subname |
|
1326 |
- unless defined $table1 && defined $table2; |
|
1327 |
- croak qq{right side table of "$join_clause" must be unique } |
|
1328 |
- . _subname |
|
1329 |
- if exists $tree->{$table2}; |
|
1330 |
- croak qq{Same table "$table1" is specified} . _subname |
|
1331 |
- if $table1 eq $table2; |
|
1332 |
- $tree->{$table2} |
|
1333 |
- = {position => $i, parent => $table1, join => $join_clause}; |
|
1334 |
- } |
|
1335 |
- |
|
1336 |
- # Search need tables |
|
1337 |
- my $need_tables = {}; |
|
1338 |
- $self->_need_tables($tree, $need_tables, $join_tables); |
|
1339 |
- my @need_tables = sort { $tree->{$a}{position} <=> $tree->{$b}{position} } keys %$need_tables; |
|
1340 |
- |
|
1341 |
- # Add join clause |
|
1342 |
- foreach my $need_table (@need_tables) { |
|
1343 |
- push @$sql, $tree->{$need_table}{join}; |
|
1344 |
- } |
|
1345 |
-} |
|
1346 |
- |
|
1347 |
-sub _quote { |
|
1348 |
- my $self = shift; |
|
1349 |
- |
|
1350 |
- return defined $self->reserved_word_quote ? $self->reserved_word_quote |
|
1351 |
- : defined $self->quote ? $self->quote |
|
1352 |
- : ''; |
|
1353 |
-} |
|
1354 |
- |
|
1355 |
-sub _q { |
|
1356 |
- my ($self, $value) = @_; |
|
1357 |
- |
|
1358 |
- my $quote = $self->_quote; |
|
1359 |
- my $q = substr($quote, 0, 1) || ''; |
|
1360 |
- my $p; |
|
1361 |
- if (defined $quote && length $quote > 1) { |
|
1362 |
- $p = substr($quote, 1, 1); |
|
1363 |
- } |
|
1364 |
- else { $p = $q } |
|
1365 |
- |
|
1366 |
- return "$q$value$p"; |
|
1367 |
-} |
|
1368 |
- |
|
1369 |
-sub _remove_duplicate_table { |
|
1370 |
- my ($self, $tables, $main_table) = @_; |
|
1371 |
- |
|
1372 |
- # Remove duplicate table |
|
1373 |
- my %tables = map {defined $_ ? ($_ => 1) : ()} @$tables; |
|
1374 |
- delete $tables{$main_table} if $main_table; |
|
1375 |
- |
|
1376 |
- my $new_tables = [keys %tables, $main_table ? $main_table : ()]; |
|
1377 |
- if (my $q = $self->_quote) { |
|
1378 |
- $q = quotemeta($q); |
|
1379 |
- $_ =~ s/[$q]//g for @$new_tables; |
|
1380 |
- } |
|
1381 |
- |
|
1382 |
- return $new_tables; |
|
1383 |
-} |
|
1384 |
- |
|
1385 |
-sub _search_tables { |
|
1386 |
- my ($self, $source) = @_; |
|
1387 |
- |
|
1388 |
- # Search tables |
|
1389 |
- my $tables = []; |
|
1390 |
- my $safety_character = $self->safety_character; |
|
1391 |
- my $q = $self->_quote; |
|
1392 |
- my $q_re = quotemeta($q); |
|
1393 |
- my $quoted_safety_character_re = $self->_q("?([$safety_character]+)"); |
|
1394 |
- my $table_re = $q ? qr/(?:^|[^$safety_character])$quoted_safety_character_re?\./ |
|
1395 |
- : qr/(?:^|[^$safety_character])([$safety_character]+)\./; |
|
1396 |
- while ($source =~ /$table_re/g) { |
|
1397 |
- push @$tables, $1; |
|
1398 |
- } |
|
1399 |
- |
|
1400 |
- return $tables; |
|
1401 |
-} |
|
1402 |
- |
|
1403 |
-sub _where_to_obj { |
|
1404 |
- my ($self, $where) = @_; |
|
1405 |
- |
|
1406 |
- my $obj; |
|
1407 |
- |
|
1408 |
- # Hash |
|
1409 |
- if (ref $where eq 'HASH') { |
|
1410 |
- my $clause = ['and']; |
|
1411 |
- my $q = $self->_quote; |
|
1412 |
- foreach my $column (keys %$where) { |
|
1413 |
- my $column_quote = $self->_q($column); |
|
1414 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
1415 |
- push @$clause, "$column_quote = :$column" for keys %$where; |
|
1416 |
- } |
|
1417 |
- $obj = $self->where(clause => $clause, param => $where); |
|
1418 |
- } |
|
1419 |
- |
|
1420 |
- # DBIx::Custom::Where object |
|
1421 |
- elsif (ref $where eq 'DBIx::Custom::Where') { |
|
1422 |
- $obj = $where; |
|
1423 |
- } |
|
1424 |
- |
|
1425 |
- # Array |
|
1426 |
- elsif (ref $where eq 'ARRAY') { |
|
1427 |
- $obj = $self->where( |
|
1428 |
- clause => $where->[0], |
|
1429 |
- param => $where->[1] |
|
1430 |
- ); |
|
1431 |
- } |
|
1432 |
- |
|
1433 |
- # Check where argument |
|
1434 |
- croak qq{"where" must be hash reference or DBIx::Custom::Where object} |
|
1435 |
- . qq{or array reference, which contains where clause and parameter} |
|
1436 |
- . _subname |
|
1437 |
- unless ref $obj eq 'DBIx::Custom::Where'; |
|
1438 |
- |
|
1439 |
- return $obj; |
|
1440 |
-} |
|
1441 |
- |
|
1442 |
-sub _apply_filter { |
|
1443 |
- my ($self, $table, @cinfos) = @_; |
|
1444 |
- |
|
1445 |
- # Initialize filters |
|
1446 |
- $self->{filter} ||= {}; |
|
1447 |
- $self->{filter}{on} = 1; |
|
1448 |
- $self->{filter}{out} ||= {}; |
|
1449 |
- $self->{filter}{in} ||= {}; |
|
1450 |
- $self->{filter}{end} ||= {}; |
|
1451 |
- |
|
1452 |
- # Usage |
|
1453 |
- my $usage = "Usage: \$dbi->apply_filter(" . |
|
1454 |
- "TABLE, COLUMN1, {in => INFILTER1, out => OUTFILTER1, end => ENDFILTER1}, " . |
|
1455 |
- "COLUMN2, {in => INFILTER2, out => OUTFILTER2, end => ENDFILTER2}, ...)"; |
|
1456 |
- |
|
1457 |
- # Apply filter |
|
1458 |
- for (my $i = 0; $i < @cinfos; $i += 2) { |
|
1459 |
- |
|
1460 |
- # Column |
|
1461 |
- my $column = $cinfos[$i]; |
|
1462 |
- if (ref $column eq 'ARRAY') { |
|
1463 |
- foreach my $c (@$column) { |
|
1464 |
- push @cinfos, $c, $cinfos[$i + 1]; |
|
1465 |
- } |
|
1466 |
- next; |
|
1467 |
- } |
|
1468 |
- |
|
1469 |
- # Filter infomation |
|
1470 |
- my $finfo = $cinfos[$i + 1] || {}; |
|
1471 |
- croak "$usage (table: $table) " . _subname |
|
1472 |
- unless ref $finfo eq 'HASH'; |
|
1473 |
- foreach my $ftype (keys %$finfo) { |
|
1474 |
- croak "$usage (table: $table) " . _subname |
|
1475 |
- unless $ftype eq 'in' || $ftype eq 'out' || $ftype eq 'end'; |
|
1476 |
- } |
|
1477 |
- |
|
1478 |
- # Set filters |
|
1479 |
- foreach my $way (qw/in out end/) { |
|
1480 |
- |
|
1481 |
- # Filter |
|
1482 |
- my $filter = $finfo->{$way}; |
|
1483 |
- |
|
1484 |
- # Filter state |
|
1485 |
- my $state = !exists $finfo->{$way} ? 'not_exists' |
|
1486 |
- : !defined $filter ? 'not_defined' |
|
1487 |
- : ref $filter eq 'CODE' ? 'code' |
|
1488 |
- : 'name'; |
|
1489 |
- |
|
1490 |
- # Filter is not exists |
|
1491 |
- next if $state eq 'not_exists'; |
|
1492 |
- |
|
1493 |
- # Check filter name |
|
1494 |
- croak qq{Filter "$filter" is not registered } . _subname |
|
1495 |
- if $state eq 'name' |
|
1496 |
- && ! exists $self->filters->{$filter}; |
|
1497 |
- |
|
1498 |
- # Set filter |
|
1499 |
- my $f = $state eq 'not_defined' ? undef |
|
1500 |
- : $state eq 'code' ? $filter |
|
1501 |
- : $self->filters->{$filter}; |
|
1502 |
- $self->{filter}{$way}{$table}{$column} = $f; |
|
1503 |
- $self->{filter}{$way}{$table}{"$table.$column"} = $f; |
|
1504 |
- $self->{filter}{$way}{$table}{"${table}__$column"} = $f; |
|
1505 |
- $self->{filter}{$way}{$table}{"${table}-$column"} = $f; |
|
1506 |
- } |
|
1507 |
- } |
|
1508 |
- |
|
1509 |
- return $self; |
|
1510 |
-} |
|
1511 |
- |
|
1512 |
-# DEPRECATED! |
|
1513 |
-sub create_query { |
|
1514 |
- warn "create_query is DEPRECATED! use query option of each method"; |
|
1515 |
- shift->_create_query(@_); |
|
1516 |
-} |
|
1517 |
- |
|
1518 |
-# DEPRECATED! |
|
1519 |
-sub apply_filter { |
|
1520 |
- my $self = shift; |
|
1521 |
- |
|
1522 |
- warn "apply_filter is DEPRECATED!"; |
|
1523 |
- return $self->_apply_filter(@_); |
|
1524 |
-} |
|
1525 |
- |
|
1526 |
-# DEPRECATED! |
|
1527 |
-our %SELECT_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1528 |
-sub select_at { |
|
1529 |
- my ($self, %args) = @_; |
|
1530 |
- |
|
1531 |
- warn "select_at is DEPRECATED! use update and id option instead"; |
|
1532 |
- |
|
1533 |
- # Arguments |
|
1534 |
- my $primary_keys = delete $args{primary_key}; |
|
1535 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1536 |
- my $where = delete $args{where}; |
|
1537 |
- my $param = delete $args{param}; |
|
1538 |
- |
|
1539 |
- # Check arguments |
|
1540 |
- foreach my $name (keys %args) { |
|
1541 |
- croak qq{"$name" is wrong option } . _subname |
|
1542 |
- unless $SELECT_AT_ARGS{$name}; |
|
1543 |
- } |
|
1544 |
- |
|
1545 |
- # Table |
|
1546 |
- croak qq{"table" option must be specified } . _subname |
|
1547 |
- unless $args{table}; |
|
1548 |
- my $table = ref $args{table} ? $args{table}->[-1] : $args{table}; |
|
1549 |
- |
|
1550 |
- # Create where parameter |
|
1551 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1552 |
- |
|
1553 |
- return $self->select(where => $where_param, %args); |
|
1554 |
-} |
|
1555 |
- |
|
1556 |
-# DEPRECATED! |
|
1557 |
-our %DELETE_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1558 |
-sub delete_at { |
|
1559 |
- my ($self, %args) = @_; |
|
1560 |
- |
|
1561 |
- warn "delete_at is DEPRECATED! use update and id option instead"; |
|
1562 |
- |
|
1563 |
- # Arguments |
|
1564 |
- my $primary_keys = delete $args{primary_key}; |
|
1565 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1566 |
- my $where = delete $args{where}; |
|
1567 |
- |
|
1568 |
- # Check arguments |
|
1569 |
- foreach my $name (keys %args) { |
|
1570 |
- croak qq{"$name" is wrong option } . _subname |
|
1571 |
- unless $DELETE_AT_ARGS{$name}; |
|
1572 |
- } |
|
1573 |
- |
|
1574 |
- # Create where parameter |
|
1575 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1576 |
- |
|
1577 |
- return $self->delete(where => $where_param, %args); |
|
1578 |
-} |
|
1579 |
- |
|
1580 |
-# DEPRECATED! |
|
1581 |
-our %UPDATE_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1582 |
-sub update_at { |
|
1583 |
- my $self = shift; |
|
1584 |
- |
|
1585 |
- warn "update_at is DEPRECATED! use update and id option instead"; |
|
1586 |
- |
|
1587 |
- # Arguments |
|
1588 |
- my $param; |
|
1589 |
- $param = shift if @_ % 2; |
|
1590 |
- my %args = @_; |
|
1591 |
- my $primary_keys = delete $args{primary_key}; |
|
1592 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1593 |
- my $where = delete $args{where}; |
|
1594 |
- my $p = delete $args{param} || {}; |
|
1595 |
- $param ||= $p; |
|
1596 |
- |
|
1597 |
- # Check arguments |
|
1598 |
- foreach my $name (keys %args) { |
|
1599 |
- croak qq{"$name" is wrong option } . _subname |
|
1600 |
- unless $UPDATE_AT_ARGS{$name}; |
|
1601 |
- } |
|
1602 |
- |
|
1603 |
- # Create where parameter |
|
1604 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1605 |
- |
|
1606 |
- return $self->update(where => $where_param, param => $param, %args); |
|
1607 |
-} |
|
1608 |
- |
|
1609 |
-# DEPRECATED! |
|
1610 |
-our %INSERT_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1611 |
-sub insert_at { |
|
1612 |
- my $self = shift; |
|
1613 |
- |
|
1614 |
- warn "insert_at is DEPRECATED! use insert and id option instead"; |
|
1615 |
- |
|
1616 |
- # Arguments |
|
1617 |
- my $param; |
|
1618 |
- $param = shift if @_ % 2; |
|
1619 |
- my %args = @_; |
|
1620 |
- my $primary_key = delete $args{primary_key}; |
|
1621 |
- $primary_key = [$primary_key] unless ref $primary_key; |
|
1622 |
- my $where = delete $args{where}; |
|
1623 |
- my $p = delete $args{param} || {}; |
|
1624 |
- $param ||= $p; |
|
1625 |
- |
|
1626 |
- # Check arguments |
|
1627 |
- foreach my $name (keys %args) { |
|
1628 |
- croak qq{"$name" is wrong option } . _subname |
|
1629 |
- unless $INSERT_AT_ARGS{$name}; |
|
1630 |
- } |
|
1631 |
- |
|
1632 |
- # Create where parameter |
|
1633 |
- my $where_param = $self->_create_param_from_id($where, $primary_key); |
|
1634 |
- $param = $self->merge_param($where_param, $param); |
|
1635 |
- |
|
1636 |
- return $self->insert(param => $param, %args); |
|
1637 |
-} |
|
1638 |
- |
|
1639 |
-# DEPRECATED! |
|
1640 |
-sub register_tag { |
|
1641 |
- warn "register_tag is DEPRECATED!"; |
|
1642 |
- shift->query_builder->register_tag(@_) |
|
1643 |
-} |
|
1644 |
- |
|
1645 |
-# DEPRECATED! |
|
1646 |
-has 'data_source'; |
|
1647 |
-has dbi_options => sub { {} }; |
|
1648 |
-has filter_check => 1; |
|
1649 |
-has 'reserved_word_quote'; |
|
1650 |
- |
|
1651 |
-# DEPRECATED! |
|
1652 |
-sub default_bind_filter { |
|
1653 |
- my $self = shift; |
|
1654 |
- |
|
1655 |
- warn "default_bind_filter is DEPRECATED!"; |
|
1656 |
- |
|
1657 |
- if (@_) { |
|
1658 |
- my $fname = $_[0]; |
|
1659 |
- |
|
1660 |
- if (@_ && !$fname) { |
|
1661 |
- $self->{default_out_filter} = undef; |
|
1662 |
- } |
|
1663 |
- else { |
|
1664 |
- croak qq{Filter "$fname" is not registered} |
|
1665 |
- unless exists $self->filters->{$fname}; |
|
1666 |
- |
|
1667 |
- $self->{default_out_filter} = $self->filters->{$fname}; |
|
1668 |
- } |
|
1669 |
- return $self; |
|
1670 |
- } |
|
1671 |
- |
|
1672 |
- return $self->{default_out_filter}; |
|
1673 |
-} |
|
1674 |
- |
|
1675 |
-# DEPRECATED! |
|
1676 |
-sub default_fetch_filter { |
|
1677 |
- my $self = shift; |
|
1678 |
- |
|
1679 |
- warn "default_fetch_filter is DEPRECATED!"; |
|
1680 |
- |
|
1681 |
- if (@_) { |
|
1682 |
- my $fname = $_[0]; |
|
1683 |
- |
|
1684 |
- if (@_ && !$fname) { |
|
1685 |
- $self->{default_in_filter} = undef; |
|
1686 |
- } |
|
1687 |
- else { |
|
1688 |
- croak qq{Filter "$fname" is not registered} |
|
1689 |
- unless exists $self->filters->{$fname}; |
|
1690 |
- |
|
1691 |
- $self->{default_in_filter} = $self->filters->{$fname}; |
|
1692 |
- } |
|
1693 |
- |
|
1694 |
- return $self; |
|
1695 |
- } |
|
1696 |
- |
|
1697 |
- return $self->{default_in_filter}; |
|
1698 |
-} |
|
1699 |
- |
|
1700 |
-# DEPRECATED! |
|
1701 |
-sub insert_param_tag { |
|
1702 |
- warn "insert_param_tag is DEPRECATED! " . |
|
1703 |
- "use insert_param instead!"; |
|
1704 |
- return shift->insert_param(@_); |
|
1705 |
-} |
|
1706 |
- |
|
1707 |
-# DEPRECATED! |
|
1708 |
-sub register_tag_processor { |
|
1709 |
- warn "register_tag_processor is DEPRECATED!"; |
|
1710 |
- return shift->query_builder->register_tag_processor(@_); |
|
1711 |
-} |
|
1712 |
- |
|
1713 |
-# DEPRECATED! |
|
1714 |
-sub update_param_tag { |
|
1715 |
- warn "update_param_tag is DEPRECATED! " . |
|
1716 |
- "use update_param instead"; |
|
1717 |
- return shift->update_param(@_); |
|
1718 |
-} |
|
1719 |
-# DEPRECATED! |
|
1720 |
-sub _push_relation { |
|
1721 |
- my ($self, $sql, $tables, $relation, $need_where) = @_; |
|
1722 |
- |
|
1723 |
- if (keys %{$relation || {}}) { |
|
1724 |
- push @$sql, $need_where ? 'where' : 'and'; |
|
1725 |
- foreach my $rcolumn (keys %$relation) { |
|
1726 |
- my $table1 = (split (/\./, $rcolumn))[0]; |
|
1727 |
- my $table2 = (split (/\./, $relation->{$rcolumn}))[0]; |
|
1728 |
- push @$tables, ($table1, $table2); |
|
1729 |
- push @$sql, ("$rcolumn = " . $relation->{$rcolumn}, 'and'); |
|
1730 |
- } |
|
1731 |
- } |
|
1732 |
- pop @$sql if $sql->[-1] eq 'and'; |
|
1733 |
-} |
|
1734 |
- |
|
1735 |
-# DEPRECATED! |
|
1736 |
-sub _add_relation_table { |
|
1737 |
- my ($self, $tables, $relation) = @_; |
|
1738 |
- |
|
1739 |
- if (keys %{$relation || {}}) { |
|
1740 |
- foreach my $rcolumn (keys %$relation) { |
|
1741 |
- my $table1 = (split (/\./, $rcolumn))[0]; |
|
1742 |
- my $table2 = (split (/\./, $relation->{$rcolumn}))[0]; |
|
1743 |
- my $table1_exists; |
|
1744 |
- my $table2_exists; |
|
1745 |
- foreach my $table (@$tables) { |
|
1746 |
- $table1_exists = 1 if $table eq $table1; |
|
1747 |
- $table2_exists = 1 if $table eq $table2; |
|
1748 |
- } |
|
1749 |
- unshift @$tables, $table1 unless $table1_exists; |
|
1750 |
- unshift @$tables, $table2 unless $table2_exists; |
|
1751 |
- } |
|
1752 |
- } |
|
1753 |
-} |
|
1754 |
- |
|
1755 |
-1; |
|
1756 |
- |
|
1757 |
-=head1 NAME |
|
1758 |
- |
|
1759 |
-DBIx::Custom - Execute insert, update, delete, and select statement easily |
|
1760 |
- |
|
1761 |
-=head1 SYNOPSYS |
|
1762 |
- |
|
1763 |
- use DBIx::Custom; |
|
1764 |
- |
|
1765 |
- # Connect |
|
1766 |
- my $dbi = DBIx::Custom->connect( |
|
1767 |
- dsn => "dbi:mysql:database=dbname", |
|
1768 |
- user => 'ken', |
|
1769 |
- password => '!LFKD%$&', |
|
1770 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
1771 |
- ); |
|
1772 |
- |
|
1773 |
- # Insert |
|
1774 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
1775 |
- |
|
1776 |
- # Update |
|
1777 |
- $dbi->update({title => 'Perl', author => 'Ken'}, table => 'book', |
|
1778 |
- where => {id => 5}); |
|
1779 |
- |
|
1780 |
- # Delete |
|
1781 |
- $dbi->delete(table => 'book', where => {author => 'Ken'}); |
|
1782 |
- |
|
1783 |
- # Select |
|
1784 |
- my $result = $dbi->select(table => 'book', |
|
1785 |
- column => ['title', 'author'], where => {author => 'Ken'}); |
|
1786 |
- |
|
1787 |
- # Select, more complex |
|
1788 |
- my $result = $dbi->select( |
|
1789 |
- table => 'book', |
|
1790 |
- column => [ |
|
1791 |
- {book => [qw/title author/]}, |
|
1792 |
- {company => ['name']} |
|
1793 |
- ], |
|
1794 |
- where => {'book.author' => 'Ken'}, |
|
1795 |
- join => ['left outer join company on book.company_id = company.id'], |
|
1796 |
- append => 'order by id limit 5' |
|
1797 |
- ); |
|
1798 |
- |
|
1799 |
- # Fetch |
|
1800 |
- while (my $row = $result->fetch) { |
|
1801 |
- |
|
1802 |
- } |
|
1803 |
- |
|
1804 |
- # Fetch as hash |
|
1805 |
- while (my $row = $result->fetch_hash) { |
|
1806 |
- |
|
1807 |
- } |
|
1808 |
- |
|
1809 |
- # Execute SQL with parameter. |
|
1810 |
- $dbi->execute( |
|
1811 |
- "select id from book where author = :author and title like :title", |
|
1812 |
- {author => 'ken', title => '%Perl%'} |
|
1813 |
- ); |
|
1814 |
- |
|
1815 |
-=head1 DESCRIPTIONS |
|
1816 |
- |
|
1817 |
-L<DBIx::Custom> is L<DBI> wrapper module to execute SQL easily. |
|
1818 |
-This module have the following features. |
|
1819 |
- |
|
1820 |
-=over 4 |
|
1821 |
- |
|
1822 |
-=item * |
|
1823 |
- |
|
1824 |
-Execute C<insert>, C<update>, C<delete>, or C<select> statement easily |
|
1825 |
- |
|
1826 |
-=item * |
|
1827 |
- |
|
1828 |
-Create C<where> clause flexibly |
|
1829 |
- |
|
1830 |
-=item * |
|
1831 |
- |
|
1832 |
-Named place holder support |
|
1833 |
- |
|
1834 |
-=item * |
|
1835 |
- |
|
1836 |
-Model support |
|
1837 |
- |
|
1838 |
-=item * |
|
1839 |
- |
|
1840 |
-Connection manager support |
|
1841 |
- |
|
1842 |
-=item * |
|
1843 |
- |
|
1844 |
-Choice your favorite relational database management system, |
|
1845 |
-C<MySQL>, C<SQLite>, C<PostgreSQL>, C<Oracle>, |
|
1846 |
-C<Microsoft SQL Server>, C<Microsoft Access>, C<DB2> or anything, |
|
1847 |
- |
|
1848 |
-=item * |
|
1849 |
- |
|
1850 |
-Filtering by data type or column name(EXPERIMENTAL) |
|
1851 |
- |
|
1852 |
-=item * |
|
1853 |
- |
|
1854 |
-Create C<order by> clause flexibly(EXPERIMENTAL) |
|
1855 |
- |
|
1856 |
-=back |
|
1857 |
- |
|
1858 |
-=head1 DOCUMENTATIONS |
|
1859 |
- |
|
1860 |
-L<DBIx::Custom::Guide> - How to use L<DBIx::Custom> |
|
1861 |
- |
|
1862 |
-L<DBIx::Custom Wiki|https://github.com/yuki-kimoto/DBIx-Custom/wiki> |
|
1863 |
-- Theare are various examples. |
|
1864 |
- |
|
1865 |
-Module documentations - |
|
1866 |
-L<DBIx::Custom::Result>, |
|
1867 |
-L<DBIx::Custom::Query>, |
|
1868 |
-L<DBIx::Custom::Where>, |
|
1869 |
-L<DBIx::Custom::Model>, |
|
1870 |
-L<DBIx::Custom::Order> |
|
1871 |
- |
|
1872 |
-=head1 ATTRIBUTES |
|
1873 |
- |
|
1874 |
-=head2 C<connector> |
|
1875 |
- |
|
1876 |
- my $connector = $dbi->connector; |
|
1877 |
- $dbi = $dbi->connector($connector); |
|
1878 |
- |
|
1879 |
-Connection manager object. if C<connector> is set, you can get C<dbh> |
|
1880 |
-through connection manager. Conection manager object must have C<dbh> mehtod. |
|
1881 |
- |
|
1882 |
-This is L<DBIx::Connector> example. Please pass |
|
1883 |
-C<default_dbi_option> to L<DBIx::Connector> C<new> method. |
|
1884 |
- |
|
1885 |
- my $connector = DBIx::Connector->new( |
|
1886 |
- "dbi:mysql:database=$DATABASE", |
|
1887 |
- $USER, |
|
1888 |
- $PASSWORD, |
|
1889 |
- DBIx::Custom->new->default_dbi_option |
|
1890 |
- ); |
|
1891 |
- |
|
1892 |
- my $dbi = DBIx::Custom->connect(connector => $connector); |
|
1893 |
- |
|
1894 |
-=head2 C<dsn> |
|
1895 |
- |
|
1896 |
- my $dsn = $dbi->dsn; |
|
1897 |
- $dbi = $dbi->dsn("DBI:mysql:database=dbname"); |
|
1898 |
- |
|
1899 |
-Data source name, used when C<connect> method is executed. |
|
1900 |
- |
|
1901 |
-=head2 C<dbi_option> |
|
1902 |
- |
|
1903 |
- my $dbi_option = $dbi->dbi_option; |
|
1904 |
- $dbi = $dbi->dbi_option($dbi_option); |
|
1905 |
- |
|
1906 |
-L<DBI> option, used when C<connect> method is executed. |
|
1907 |
-Each value in option override the value of C<default_dbi_option>. |
|
1908 |
- |
|
1909 |
-=head2 C<default_dbi_option> |
|
1910 |
- |
|
1911 |
- my $default_dbi_option = $dbi->default_dbi_option; |
|
1912 |
- $dbi = $dbi->default_dbi_option($default_dbi_option); |
|
1913 |
- |
|
1914 |
-L<DBI> default option, used when C<connect> method is executed, |
|
1915 |
-default to the following values. |
|
1916 |
- |
|
1917 |
- { |
|
1918 |
- RaiseError => 1, |
|
1919 |
- PrintError => 0, |
|
1920 |
- AutoCommit => 1, |
|
1921 |
- } |
|
1922 |
- |
|
1923 |
-=head2 C<filters> |
|
1924 |
- |
|
1925 |
- my $filters = $dbi->filters; |
|
1926 |
- $dbi = $dbi->filters(\%filters); |
|
1927 |
- |
|
1928 |
-Filters, registered by C<register_filter> method. |
|
1929 |
- |
|
1930 |
-=head2 C<last_sql> |
|
1931 |
- |
|
1932 |
- my $last_sql = $dbi->last_sql; |
|
1933 |
- $dbi = $dbi->last_sql($last_sql); |
|
1934 |
- |
|
1935 |
-Get last successed SQL executed by C<execute> method. |
|
1936 |
- |
|
1937 |
-=head2 C<models> |
|
1938 |
- |
|
1939 |
- my $models = $dbi->models; |
|
1940 |
- $dbi = $dbi->models(\%models); |
|
1941 |
- |
|
1942 |
-Models, included by C<include_model> method. |
|
1943 |
- |
|
1944 |
-=head2 C<password> |
|
1945 |
- |
|
1946 |
- my $password = $dbi->password; |
|
1947 |
- $dbi = $dbi->password('lkj&le`@s'); |
|
1948 |
- |
|
1949 |
-Password, used when C<connect> method is executed. |
|
1950 |
- |
|
1951 |
-=head2 C<query_builder> |
|
1952 |
- |
|
1953 |
- my $sql_class = $dbi->query_builder; |
|
1954 |
- $dbi = $dbi->query_builder(DBIx::Custom::QueryBuilder->new); |
|
1955 |
- |
|
1956 |
-Query builder, default to L<DBIx::Custom::QueryBuilder> object. |
|
1957 |
- |
|
1958 |
-=head2 C<quote> |
|
1959 |
- |
|
1960 |
- my quote = $dbi->quote; |
|
1961 |
- $dbi = $dbi->quote('"'); |
|
1962 |
- |
|
1963 |
-Reserved word quote. |
|
1964 |
-Default to double quote '"' except for mysql. |
|
1965 |
-In mysql, default to back quote '`' |
|
1966 |
- |
|
1967 |
-You can set quote pair. |
|
1968 |
- |
|
1969 |
- $dbi->quote('[]'); |
|
1970 |
- |
|
1971 |
-=head2 C<result_class> |
|
1972 |
- |
|
1973 |
- my $result_class = $dbi->result_class; |
|
1974 |
- $dbi = $dbi->result_class('DBIx::Custom::Result'); |
|
1975 |
- |
|
1976 |
-Result class, default to L<DBIx::Custom::Result>. |
|
1977 |
- |
|
1978 |
-=head2 C<safety_character> |
|
1979 |
- |
|
1980 |
- my $safety_character = $self->safety_character; |
|
1981 |
- $dbi = $self->safety_character($character); |
|
1982 |
- |
|
1983 |
-Regex of safety character for table and column name, default to '\w'. |
|
1984 |
-Note that you don't have to specify like '[\w]'. |
|
1985 |
- |
|
1986 |
-=head2 C<tag_parse> |
|
1987 |
- |
|
1988 |
- my $tag_parse = $dbi->tag_parse(0); |
|
1989 |
- $dbi = $dbi->tag_parse; |
|
1990 |
- |
|
1991 |
-Enable DEPRECATED tag parsing functionality, default to 1. |
|
1992 |
-If you want to disable tag parsing functionality, set to 0. |
|
1993 |
- |
|
1994 |
-=head2 C<user> |
|
1995 |
- |
|
1996 |
- my $user = $dbi->user; |
|
1997 |
- $dbi = $dbi->user('Ken'); |
|
1998 |
- |
|
1999 |
-User name, used when C<connect> method is executed. |
|
2000 |
- |
|
2001 |
-=head1 METHODS |
|
2002 |
- |
|
2003 |
-L<DBIx::Custom> inherits all methods from L<Object::Simple> |
|
2004 |
-and use all methods of L<DBI> |
|
2005 |
-and implements the following new ones. |
|
2006 |
- |
|
2007 |
-=head2 C<available_data_type> EXPERIMENTAL |
|
2008 |
- |
|
2009 |
- print $dbi->available_data_type; |
|
2010 |
- |
|
2011 |
-Get available data types. You can use these data types |
|
2012 |
-in C<type rule>'s C<from1> and C<from2> section. |
|
2013 |
- |
|
2014 |
-=head2 C<available_type_name> EXPERIMENTAL |
|
2015 |
- |
|
2016 |
- print $dbi->available_type_name; |
|
2017 |
- |
|
2018 |
-Get available type names. You can use these type names in |
|
2019 |
-C<type_rule>'s C<into1> and C<into2> section. |
|
2020 |
- |
|
2021 |
-=head2 C<assign_param> EXPERIMENTAL |
|
2022 |
- |
|
2023 |
- my $assign_param = $dbi->assign_param({title => 'a', age => 2}); |
|
2024 |
- |
|
2025 |
-Create assign parameter. |
|
2026 |
- |
|
2027 |
- title = :title, author = :author |
|
2028 |
- |
|
2029 |
-This is equal to C<update_param> exept that set is not added. |
|
2030 |
- |
|
2031 |
-=head2 C<column> |
|
2032 |
- |
|
2033 |
- my $column = $dbi->column(book => ['author', 'title']); |
|
2034 |
- |
|
2035 |
-Create column clause. The follwoing column clause is created. |
|
2036 |
- |
|
2037 |
- book.author as "book.author", |
|
2038 |
- book.title as "book.title" |
|
2039 |
- |
|
2040 |
-You can change separator by C<separator> method. |
|
2041 |
- |
|
2042 |
- # Separator is double underbar |
|
2043 |
- $dbi->separator('__'); |
|
2044 |
- |
|
2045 |
- book.author as "book__author", |
|
2046 |
- book.title as "book__title" |
|
2047 |
- |
|
2048 |
- # Separator is hyphen |
|
2049 |
- $dbi->separator('-'); |
|
2050 |
- |
|
2051 |
- book.author as "book-author", |
|
2052 |
- book.title as "book-title" |
|
2053 |
- |
|
2054 |
-=head2 C<connect> |
|
2055 |
- |
|
2056 |
- my $dbi = DBIx::Custom->connect( |
|
2057 |
- dsn => "dbi:mysql:database=dbname", |
|
2058 |
- user => 'ken', |
|
2059 |
- password => '!LFKD%$&', |
|
2060 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
2061 |
- ); |
|
2062 |
- |
|
2063 |
-Connect to the database and create a new L<DBIx::Custom> object. |
|
2064 |
- |
|
2065 |
-L<DBIx::Custom> is a wrapper of L<DBI>. |
|
2066 |
-C<AutoCommit> and C<RaiseError> options are true, |
|
2067 |
-and C<PrintError> option is false by default. |
|
2068 |
- |
|
2069 |
-=head2 create_model |
|
2070 |
- |
|
2071 |
- my $model = $dbi->create_model( |
|
2072 |
- table => 'book', |
|
2073 |
- primary_key => 'id', |
|
2074 |
- join => [ |
|
2075 |
- 'inner join company on book.comparny_id = company.id' |
|
2076 |
- ], |
|
2077 |
- ); |
|
2078 |
- |
|
2079 |
-Create L<DBIx::Custom::Model> object and initialize model. |
|
2080 |
-the module is also used from C<model> method. |
|
2081 |
- |
|
2082 |
- $dbi->model('book')->select(...); |
|
2083 |
- |
|
2084 |
-=head2 C<dbh> |
|
2085 |
- |
|
2086 |
- my $dbh = $dbi->dbh; |
|
2087 |
- |
|
2088 |
-Get L<DBI> database handle. if C<connector> is set, you can get |
|
2089 |
-database handle through C<connector> object. |
|
2090 |
- |
|
2091 |
-=head2 C<each_column> |
|
2092 |
- |
|
2093 |
- $dbi->each_column( |
|
2094 |
- sub { |
|
2095 |
- my ($dbi, $table, $column, $column_info) = @_; |
|
2096 |
- |
|
2097 |
- my $type = $column_info->{TYPE_NAME}; |
|
2098 |
- |
|
2099 |
- if ($type eq 'DATE') { |
|
2100 |
- # ... |
|
2101 |
- } |
|
2102 |
- } |
|
2103 |
- ); |
|
2104 |
- |
|
2105 |
-Iterate all column informations of all table from database. |
|
2106 |
-Argument is callback when one column is found. |
|
2107 |
-Callback receive four arguments, dbi object, table name, |
|
2108 |
-column name and column information. |
|
2109 |
- |
|
2110 |
-=head2 C<each_table> |
|
2111 |
- |
|
2112 |
- $dbi->each_table( |
|
2113 |
- sub { |
|
2114 |
- my ($dbi, $table, $table_info) = @_; |
|
2115 |
- |
|
2116 |
- my $table_name = $table_info->{TABLE_NAME}; |
|
2117 |
- } |
|
2118 |
- ); |
|
2119 |
- |
|
2120 |
-Iterate all table informationsfrom database. |
|
2121 |
-Argument is callback when one table is found. |
|
2122 |
-Callback receive three arguments, dbi object, table name, |
|
2123 |
-table information. |
|
2124 |
- |
|
2125 |
-=head2 C<execute> |
|
2126 |
- |
|
2127 |
- my $result = $dbi->execute( |
|
2128 |
- "select * from book where title = :title and author like :author", |
|
2129 |
- {title => 'Perl', author => '%Ken%'} |
|
2130 |
- ); |
|
2131 |
- |
|
2132 |
- my $result = $dbi->execute( |
|
2133 |
- "select * from book where title = :book.title and author like :book.author", |
|
2134 |
- {'book.title' => 'Perl', 'book.author' => '%Ken%'} |
|
2135 |
- ); |
|
2136 |
- |
|
2137 |
-Execute SQL. SQL can contain column parameter such as :author and :title. |
|
2138 |
-You can append table name to column name such as :book.title and :book.author. |
|
2139 |
-Second argunet is data, embedded into column parameter. |
|
2140 |
-Return value is L<DBIx::Custom::Result> object when select statement is executed, |
|
2141 |
-or the count of affected rows when insert, update, delete statement is executed. |
|
2142 |
- |
|
2143 |
-Named placeholder such as C<:title> is replaced by placeholder C<?>. |
|
2144 |
- |
|
2145 |
- # Original |
|
2146 |
- select * from book where title = :title and author like :author |
|
2147 |
- |
|
2148 |
- # Replaced |
|
2149 |
- select * from where title = ? and author like ?; |
|
2150 |
- |
|
2151 |
-You can specify operator with named placeholder |
|
2152 |
- by C<name{operator}> syntax. |
|
2153 |
- |
|
2154 |
- # Original |
|
2155 |
- select * from book where :title{=} and :author{like} |
|
2156 |
- |
|
2157 |
- # Replaced |
|
2158 |
- select * from where title = ? and author like ?; |
|
2159 |
- |
|
2160 |
-Note that colons in time format such as 12:13:15 is exeption, |
|
2161 |
-it is not parsed as named placeholder. |
|
2162 |
-If you want to use colon generally, you must escape it by C<\\> |
|
2163 |
- |
|
2164 |
- select * from where title = "aa\\:bb"; |
|
2165 |
- |
|
2166 |
-The following opitons are available. |
|
2167 |
- |
|
2168 |
-=over 4 |
|
2169 |
- |
|
2170 |
-=item C<filter> |
|
2171 |
- |
|
2172 |
- filter => { |
|
2173 |
- title => sub { uc $_[0] } |
|
2174 |
- author => sub { uc $_[0] } |
|
2175 |
- } |
|
2176 |
- |
|
2177 |
- # Filter name |
|
2178 |
- filter => { |
|
2179 |
- title => 'upper_case', |
|
2180 |
- author => 'upper_case' |
|
2181 |
- } |
|
2182 |
- |
|
2183 |
- # At once |
|
2184 |
- filter => [ |
|
2185 |
- [qw/title author/] => sub { uc $_[0] } |
|
2186 |
- ] |
|
2187 |
- |
|
2188 |
-Filter. You can set subroutine or filter name |
|
2189 |
-registered by by C<register_filter>. |
|
2190 |
-This filter is executed before data is saved into database. |
|
2191 |
-and before type rule filter is executed. |
|
2192 |
- |
|
2193 |
-=item C<query> |
|
2194 |
- |
|
2195 |
- query => 1 |
|
2196 |
- |
|
2197 |
-C<execute> method return L<DBIx::Custom::Query> object, not executing SQL. |
|
2198 |
-You can check SQL or get statment handle. |
|
2199 |
- |
|
2200 |
- my $sql = $query->sql; |
|
2201 |
- my $sth = $query->sth; |
|
2202 |
- my $columns = $query->columns; |
|
2203 |
- |
|
2204 |
-If you want to execute SQL fast, you can do the following way. |
|
2205 |
- |
|
2206 |
- my $query; |
|
2207 |
- foreach my $row (@$rows) { |
|
2208 |
- $query ||= $dbi->insert($row, table => 'table1', query => 1); |
|
2209 |
- $dbi->execute($query, $row, filter => {ab => sub { $_[0] * 2 }}); |
|
2210 |
- } |
|
2211 |
- |
|
2212 |
-Statement handle is reused and SQL parsing is finished, |
|
2213 |
-so you can get more performance than normal way. |
|
2214 |
- |
|
2215 |
-If you want to execute SQL as possible as fast and don't need filtering. |
|
2216 |
-You can do the following way. |
|
2217 |
- |
|
2218 |
- my $query; |
|
2219 |
- my $sth; |
|
2220 |
- foreach my $row (@$rows) { |
|
2221 |
- $query ||= $dbi->insert($row, table => 'book', query => 1); |
|
2222 |
- $sth ||= $query->sth; |
|
2223 |
- $sth->execute(map { $row->{$_} } sort keys %$row); |
|
2224 |
- } |
|
2225 |
- |
|
2226 |
-Note that $row must be simple hash reference, such as |
|
2227 |
-{title => 'Perl', author => 'Ken'}. |
|
2228 |
-and don't forget to sort $row values by $row key asc order. |
|
2229 |
- |
|
2230 |
-=item C<table> |
|
2231 |
- |
|
2232 |
- table => 'author' |
|
2233 |
- |
|
2234 |
-If you want to omit table name in column name |
|
2235 |
-and enable C<into1> and C<into2> type filter, |
|
2236 |
-You must set C<table> option. |
|
2237 |
- |
|
2238 |
- $dbi->execute("select * from book where title = :title and author = :author", |
|
2239 |
- {title => 'Perl', author => 'Ken', table => 'book'); |
|
2240 |
- |
|
2241 |
- # Same |
|
2242 |
- $dbi->execute( |
|
2243 |
- "select * from book where title = :book.title and author = :book.author", |
|
2244 |
- {title => 'Perl', author => 'Ken'); |
|
2245 |
- |
|
2246 |
-=item C<bind_type> |
|
2247 |
- |
|
2248 |
-Specify database bind data type. |
|
2249 |
- |
|
2250 |
- bind_type => [image => DBI::SQL_BLOB] |
|
2251 |
- bind_type => [[qw/image audio/] => DBI::SQL_BLOB] |
|
2252 |
- |
|
2253 |
-This is used to bind parameter by C<bind_param> of statment handle. |
|
2254 |
- |
|
2255 |
- $sth->bind_param($pos, $value, DBI::SQL_BLOB); |
|
2256 |
- |
|
2257 |
-=item C<table_alias> EXPERIMENTAL |
|
2258 |
- |
|
2259 |
- table_alias => {user => 'hiker'} |
|
2260 |
- |
|
2261 |
-Table alias. Key is real table name, value is alias table name. |
|
2262 |
-If you set C<table_alias>, you can enable C<into1> and C<into2> type rule |
|
2263 |
-on alias table name. |
|
2264 |
- |
|
2265 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2266 |
- |
|
2267 |
- type_rule_off => 1 |
|
2268 |
- |
|
2269 |
-Turn C<into1> and C<into2> type rule off. |
|
2270 |
- |
|
2271 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2272 |
- |
|
2273 |
- type_rule1_off => 1 |
|
2274 |
- |
|
2275 |
-Turn C<into1> type rule off. |
|
2276 |
- |
|
2277 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2278 |
- |
|
2279 |
- type_rule2_off => 1 |
|
2280 |
- |
|
2281 |
-Turn C<into2> type rule off. |
|
2282 |
- |
|
2283 |
-=back |
|
2284 |
- |
|
2285 |
-=head2 C<delete> |
|
2286 |
- |
|
2287 |
- $dbi->delete(table => 'book', where => {title => 'Perl'}); |
|
2288 |
- |
|
2289 |
-Execute delete statement. |
|
2290 |
- |
|
2291 |
-The following opitons are available. |
|
2292 |
- |
|
2293 |
-=over 4 |
|
2294 |
- |
|
2295 |
-=item C<append> |
|
2296 |
- |
|
2297 |
-Same as C<select> method's C<append> option. |
|
2298 |
- |
|
2299 |
-=item C<filter> |
|
2300 |
- |
|
2301 |
-Same as C<execute> method's C<filter> option. |
|
2302 |
- |
|
2303 |
-=item C<id> |
|
2304 |
- |
|
2305 |
- id => 4 |
|
2306 |
- id => [4, 5] |
|
2307 |
- |
|
2308 |
-ID corresponding to C<primary_key>. |
|
2309 |
-You can delete rows by C<id> and C<primary_key>. |
|
2310 |
- |
|
2311 |
- $dbi->delete( |
|
2312 |
- parimary_key => ['id1', 'id2'], |
|
2313 |
- id => [4, 5], |
|
2314 |
- table => 'book', |
|
2315 |
- ); |
|
2316 |
- |
|
2317 |
-The above is same as the followin one. |
|
2318 |
- |
|
2319 |
- $dbi->delete(where => {id1 => 4, id2 => 5}, table => 'book'); |
|
2320 |
- |
|
2321 |
-=item C<prefix> |
|
2322 |
- |
|
2323 |
- prefix => 'some' |
|
2324 |
- |
|
2325 |
-prefix before table name section. |
|
2326 |
- |
|
2327 |
- delete some from book |
|
2328 |
- |
|
2329 |
-=item C<query> |
|
2330 |
- |
|
2331 |
-Same as C<execute> method's C<query> option. |
|
2332 |
- |
|
2333 |
-=item C<table> |
|
2334 |
- |
|
2335 |
- table => 'book' |
|
2336 |
- |
|
2337 |
-Table name. |
|
2338 |
- |
|
2339 |
-=item C<where> |
|
2340 |
- |
|
2341 |
-Same as C<select> method's C<where> option. |
|
2342 |
- |
|
2343 |
-=item C<primary_key> |
|
2344 |
- |
|
2345 |
-See C<id> option. |
|
2346 |
- |
|
2347 |
-=item C<bind_type> |
|
2348 |
- |
|
2349 |
-Same as C<execute> method's C<bind_type> option. |
|
2350 |
- |
|
2351 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2352 |
- |
|
2353 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2354 |
- |
|
2355 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2356 |
- |
|
2357 |
- type_rule1_off => 1 |
|
2358 |
- |
|
2359 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2360 |
- |
|
2361 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2362 |
- |
|
2363 |
- type_rule2_off => 1 |
|
2364 |
- |
|
2365 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2366 |
- |
|
2367 |
-=back |
|
2368 |
- |
|
2369 |
-=head2 C<delete_all> |
|
2370 |
- |
|
2371 |
- $dbi->delete_all(table => $table); |
|
2372 |
- |
|
2373 |
-Execute delete statement for all rows. |
|
2374 |
-Options is same as C<delete>. |
|
2375 |
- |
|
2376 |
-=head2 C<insert> |
|
2377 |
- |
|
2378 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
2379 |
- |
|
2380 |
-Execute insert statement. First argument is row data. Return value is |
|
2381 |
-affected row count. |
|
2382 |
- |
|
2383 |
-If you want to set constant value to row data, use scalar reference |
|
2384 |
-as parameter value. |
|
2385 |
- |
|
2386 |
- {date => \"NOW()"} |
|
2387 |
- |
|
2388 |
-The following opitons are available. |
|
2389 |
- |
|
2390 |
-=over 4 |
|
2391 |
- |
|
2392 |
-=item C<append> |
|
2393 |
- |
|
2394 |
-Same as C<select> method's C<append> option. |
|
2395 |
- |
|
2396 |
-=item C<filter> |
|
2397 |
- |
|
2398 |
-Same as C<execute> method's C<filter> option. |
|
2399 |
- |
|
2400 |
-=item C<id> |
|
2401 |
- |
|
2402 |
- id => 4 |
|
2403 |
- id => [4, 5] |
|
2404 |
- |
|
2405 |
-ID corresponding to C<primary_key>. |
|
2406 |
-You can insert a row by C<id> and C<primary_key>. |
|
2407 |
- |
|
2408 |
- $dbi->insert( |
|
2409 |
- {title => 'Perl', author => 'Ken'} |
|
2410 |
- parimary_key => ['id1', 'id2'], |
|
2411 |
- id => [4, 5], |
|
2412 |
- table => 'book' |
|
2413 |
- ); |
|
2414 |
- |
|
2415 |
-The above is same as the followin one. |
|
2416 |
- |
|
2417 |
- $dbi->insert( |
|
2418 |
- {id1 => 4, id2 => 5, title => 'Perl', author => 'Ken'}, |
|
2419 |
- table => 'book' |
|
2420 |
- ); |
|
2421 |
- |
|
2422 |
-=item C<prefix> |
|
2423 |
- |
|
2424 |
- prefix => 'or replace' |
|
2425 |
- |
|
2426 |
-prefix before table name section |
|
2427 |
- |
|
2428 |
- insert or replace into book |
|
2429 |
- |
|
2430 |
-=item C<primary_key> |
|
2431 |
- |
|
2432 |
- primary_key => 'id' |
|
2433 |
- primary_key => ['id1', 'id2'] |
|
2434 |
- |
|
2435 |
-Primary key. This is used by C<id> option. |
|
2436 |
- |
|
2437 |
-=item C<query> |
|
2438 |
- |
|
2439 |
-Same as C<execute> method's C<query> option. |
|
2440 |
- |
|
2441 |
-=item C<table> |
|
2442 |
- |
|
2443 |
- table => 'book' |
|
2444 |
- |
|
2445 |
-Table name. |
|
2446 |
- |
|
2447 |
-=item C<bind_type> |
|
2448 |
- |
|
2449 |
-Same as C<execute> method's C<bind_type> option. |
|
2450 |
- |
|
2451 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2452 |
- |
|
2453 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2454 |
- |
|
2455 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2456 |
- |
|
2457 |
- type_rule1_off => 1 |
|
2458 |
- |
|
2459 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2460 |
- |
|
2461 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2462 |
- |
|
2463 |
- type_rule2_off => 1 |
|
2464 |
- |
|
2465 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2466 |
- |
|
2467 |
-=back |
|
2468 |
- |
|
2469 |
-=over 4 |
|
2470 |
- |
|
2471 |
-=head2 C<insert_param> |
|
2472 |
- |
|
2473 |
- my $insert_param = $dbi->insert_param({title => 'a', age => 2}); |
|
2474 |
- |
|
2475 |
-Create insert parameters. |
|
2476 |
- |
|
2477 |
- (title, author) values (title = :title, age = :age); |
|
2478 |
- |
|
2479 |
-=head2 C<include_model> |
|
2480 |
- |
|
2481 |
- $dbi->include_model('MyModel'); |
|
2482 |
- |
|
2483 |
-Include models from specified namespace, |
|
2484 |
-the following layout is needed to include models. |
|
2485 |
- |
|
2486 |
- lib / MyModel.pm |
|
2487 |
- / MyModel / book.pm |
|
2488 |
- / company.pm |
|
2489 |
- |
|
2490 |
-Name space module, extending L<DBIx::Custom::Model>. |
|
2491 |
- |
|
2492 |
-B<MyModel.pm> |
|
2493 |
- |
|
2494 |
- package MyModel; |
|
2495 |
- use DBIx::Custom::Model -base; |
|
2496 |
- |
|
2497 |
- 1; |
|
2498 |
- |
|
2499 |
-Model modules, extending name space module. |
|
2500 |
- |
|
2501 |
-B<MyModel/book.pm> |
|
2502 |
- |
|
2503 |
- package MyModel::book; |
|
2504 |
- use MyModel -base; |
|
2505 |
- |
|
2506 |
- 1; |
|
2507 |
- |
|
2508 |
-B<MyModel/company.pm> |
|
2509 |
- |
|
2510 |
- package MyModel::company; |
|
2511 |
- use MyModel -base; |
|
2512 |
- |
|
2513 |
- 1; |
|
2514 |
- |
|
2515 |
-MyModel::book and MyModel::company is included by C<include_model>. |
|
2516 |
- |
|
2517 |
-You can get model object by C<model>. |
|
2518 |
- |
|
2519 |
- my $book_model = $dbi->model('book'); |
|
2520 |
- my $company_model = $dbi->model('company'); |
|
2521 |
- |
|
2522 |
-See L<DBIx::Custom::Model> to know model features. |
|
2523 |
- |
|
2524 |
-=head2 C<map_param> EXPERIMENTAL |
|
2525 |
- |
|
2526 |
- my $map_param = $dbi->map_param( |
|
2527 |
- {id => 1, authro => 'Ken', price => 1900}, |
|
2528 |
- 'id' => 'book.id', |
|
2529 |
- 'author' => ['book.author' => sub { '%' . $_[0] . '%' }], |
|
2530 |
- 'price' => [ |
|
2531 |
- 'book.price', {if => sub { length $_[0] }} |
|
2532 |
- ] |
|
2533 |
- ); |
|
2534 |
- |
|
2535 |
-Map paramters to other key and value. First argument is original |
|
2536 |
-parameter. this is hash reference. Rest argument is mapping. |
|
2537 |
-By default, Mapping is done if the value length is not zero. |
|
2538 |
- |
|
2539 |
-=over 4 |
|
2540 |
- |
|
2541 |
-=item Key mapping |
|
2542 |
- |
|
2543 |
- 'id' => 'book.id' |
|
2544 |
- |
|
2545 |
-This is only key mapping. Value is same as original one. |
|
2546 |
- |
|
2547 |
- (id => 1) is mapped to ('book.id' => 1) if value length is not zero. |
|
2548 |
- |
|
2549 |
-=item Key and value mapping |
|
2550 |
- |
|
2551 |
- 'author' => ['book.author' => sub { '%' . $_[0] . '%' }] |
|
2552 |
- |
|
2553 |
-This is key and value mapping. Frist element of array reference |
|
2554 |
-is mapped key name, second element is code reference to map the value. |
|
2555 |
- |
|
2556 |
- (author => 'Ken') is mapped to ('book.author' => '%Ken%') |
|
2557 |
- if value length is not zero. |
|
2558 |
- |
|
2559 |
-=item Condition |
|
2560 |
- |
|
2561 |
- 'price' => ['book.price', {if => 'exists'}] |
|
2562 |
- 'price' => ['book.price', sub { '%' . $_[0] . '%' }, {if => 'exists'}] |
|
2563 |
- 'price' => ['book.price', {if => sub { defined shift }}] |
|
2564 |
- |
|
2565 |
-If you need condition, you can sepecify it. this is code reference |
|
2566 |
-or 'exists'. By default, condition is the following one. |
|
2567 |
- |
|
2568 |
- sub { defined $_[0] && length $_[0] } |
|
2569 |
- |
|
2570 |
-=back |
|
2571 |
- |
|
2572 |
-=head2 C<merge_param> |
|
2573 |
- |
|
2574 |
- my $param = $dbi->merge_param({key1 => 1}, {key1 => 1, key2 => 2}); |
|
2575 |
- |
|
2576 |
-Merge parameters. |
|
2577 |
- |
|
2578 |
- {key1 => [1, 1], key2 => 2} |
|
2579 |
- |
|
2580 |
-=head2 C<method> |
|
2581 |
- |
|
2582 |
- $dbi->method( |
|
2583 |
- update_or_insert => sub { |
|
2584 |
- my $self = shift; |
|
2585 |
- |
|
2586 |
- # Process |
|
2587 |
- }, |
|
2588 |
- find_or_create => sub { |
|
2589 |
- my $self = shift; |
|
2590 |
- |
|
2591 |
- # Process |
|
2592 |
- } |
|
2593 |
- ); |
|
2594 |
- |
|
2595 |
-Register method. These method is called directly from L<DBIx::Custom> object. |
|
2596 |
- |
|
2597 |
- $dbi->update_or_insert; |
|
2598 |
- $dbi->find_or_create; |
|
2599 |
- |
|
2600 |
-=head2 C<model> |
|
2601 |
- |
|
2602 |
- my $model = $dbi->model('book'); |
|
2603 |
- |
|
2604 |
-Get a L<DBIx::Custom::Model> object, |
|
2605 |
- |
|
2606 |
-=head2 C<mycolumn> |
|
2607 |
- |
|
2608 |
- my $column = $self->mycolumn(book => ['author', 'title']); |
|
2609 |
- |
|
2610 |
-Create column clause for myself. The follwoing column clause is created. |
|
2611 |
- |
|
2612 |
- book.author as author, |
|
2613 |
- book.title as title |
|
2614 |
- |
|
2615 |
-=head2 C<new> |
|
2616 |
- |
|
2617 |
- my $dbi = DBIx::Custom->new( |
|
2618 |
- dsn => "dbi:mysql:database=dbname", |
|
2619 |
- user => 'ken', |
|
2620 |
- password => '!LFKD%$&', |
|
2621 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
2622 |
- ); |
|
2623 |
- |
|
2624 |
-Create a new L<DBIx::Custom> object. |
|
2625 |
- |
|
2626 |
-=head2 C<not_exists> |
|
2627 |
- |
|
2628 |
- my $not_exists = $dbi->not_exists; |
|
2629 |
- |
|
2630 |
-DBIx::Custom::NotExists object, indicating the column is not exists. |
|
2631 |
-This is used by C<clause> of L<DBIx::Custom::Where> . |
|
2632 |
- |
|
2633 |
-=head2 C<order> EXPERIMENTAL |
|
2634 |
- |
|
2635 |
- my $order = $dbi->order; |
|
2636 |
- |
|
2637 |
-Create a new L<DBIx::Custom::Order> object. |
|
2638 |
- |
|
2639 |
-=head2 C<register_filter> |
|
2640 |
- |
|
2641 |
- $dbi->register_filter( |
|
2642 |
- # Time::Piece object to database DATE format |
|
2643 |
- tp_to_date => sub { |
|
2644 |
- my $tp = shift; |
|
2645 |
- return $tp->strftime('%Y-%m-%d'); |
|
2646 |
- }, |
|
2647 |
- # database DATE format to Time::Piece object |
|
2648 |
- date_to_tp => sub { |
|
2649 |
- my $date = shift; |
|
2650 |
- return Time::Piece->strptime($date, '%Y-%m-%d'); |
|
2651 |
- } |
|
2652 |
- ); |
|
2653 |
- |
|
2654 |
-Register filters, used by C<filter> option of many methods. |
|
2655 |
- |
|
2656 |
-=head2 C<type_rule> EXPERIMENTAL |
|
2657 |
- |
|
2658 |
- $dbi->type_rule( |
|
2659 |
- into1 => { |
|
2660 |
- date => sub { ... }, |
|
2661 |
- datetime => sub { ... } |
|
2662 |
- }, |
|
2663 |
- into2 => { |
|
2664 |
- date => sub { ... }, |
|
2665 |
- datetime => sub { ... } |
|
2666 |
- }, |
|
2667 |
- from1 => { |
|
2668 |
- # DATE |
|
2669 |
- 9 => sub { ... }, |
|
2670 |
- # DATETIME or TIMESTAMP |
|
2671 |
- 11 => sub { ... }, |
|
2672 |
- } |
|
2673 |
- from2 => { |
|
2674 |
- # DATE |
|
2675 |
- 9 => sub { ... }, |
|
2676 |
- # DATETIME or TIMESTAMP |
|
2677 |
- 11 => sub { ... }, |
|
2678 |
- } |
|
2679 |
- ); |
|
2680 |
- |
|
2681 |
-Filtering rule when data is send into and get from database. |
|
2682 |
-This has a little complex problem. |
|
2683 |
- |
|
2684 |
-In C<into1> and C<into2> you can specify |
|
2685 |
-type name as same as type name defined |
|
2686 |
-by create table, such as C<DATETIME> or C<DATE>. |
|
2687 |
- |
|
2688 |
-Note that type name and data type don't contain upper case. |
|
2689 |
-If these contain upper case charactor, you convert it to lower case. |
|
2690 |
- |
|
2691 |
-C<into2> is executed after C<into1>. |
|
2692 |
- |
|
2693 |
-Type rule of C<into1> and C<into2> is enabled on the following |
|
2694 |
-column name. |
|
2695 |
- |
|
2696 |
-=over 4 |
|
2697 |
- |
|
2698 |
-=item 1. column name |
|
2699 |
- |
|
2700 |
- issue_date |
|
2701 |
- issue_datetime |
|
2702 |
- |
|
2703 |
-This need C<table> option in each method. |
|
2704 |
- |
|
2705 |
-=item 2. table name and column name, separator is dot |
|
2706 |
- |
|
2707 |
- book.issue_date |
|
2708 |
- book.issue_datetime |
|
2709 |
- |
|
2710 |
-=back |
|
2711 |
- |
|
2712 |
-You get all type name used in database by C<available_type_name>. |
|
2713 |
- |
|
2714 |
- print $dbi->available_type_name; |
|
2715 |
- |
|
2716 |
-In C<from1> and C<from2> you specify data type, not type name. |
|
2717 |
-C<from2> is executed after C<from1>. |
|
2718 |
-You get all data type by C<available_data_type>. |
|
2719 |
- |
|
2720 |
- print $dbi->available_data_type; |
|
2721 |
- |
|
2722 |
-You can also specify multiple types at once. |
|
2723 |
- |
|
2724 |
- $dbi->type_rule( |
|
2725 |
- into1 => [ |
|
2726 |
- [qw/DATE DATETIME/] => sub { ... }, |
|
2727 |
- ], |
|
2728 |
- ); |
|
2729 |
- |
|
2730 |
-=head2 C<select> |
|
2731 |
- |
|
2732 |
- my $result = $dbi->select( |
|
2733 |
- table => 'book', |
|
2734 |
- column => ['author', 'title'], |
|
2735 |
- where => {author => 'Ken'}, |
|
2736 |
- ); |
|
2737 |
- |
|
2738 |
-Execute select statement. |
|
2739 |
- |
|
2740 |
-The following opitons are available. |
|
2741 |
- |
|
2742 |
-=over 4 |
|
2743 |
- |
|
2744 |
-=item C<append> |
|
2745 |
- |
|
2746 |
- append => 'order by title' |
|
2747 |
- |
|
2748 |
-Append statement to last of SQL. |
|
2749 |
- |
|
2750 |
-=item C<column> |
|
2751 |
- |
|
2752 |
- column => 'author' |
|
2753 |
- column => ['author', 'title'] |
|
2754 |
- |
|
2755 |
-Column clause. |
|
2756 |
- |
|
2757 |
-if C<column> is not specified, '*' is set. |
|
2758 |
- |
|
2759 |
- column => '*' |
|
2760 |
- |
|
2761 |
-You can specify hash of array reference. |
|
2762 |
- |
|
2763 |
- column => [ |
|
2764 |
- {book => [qw/author title/]}, |
|
2765 |
- {person => [qw/name age/]} |
|
2766 |
- ] |
|
2767 |
- |
|
2768 |
-This is expanded to the following one by using C<colomn> method. |
|
2769 |
- |
|
2770 |
- book.author as "book.author", |
|
2771 |
- book.title as "book.title", |
|
2772 |
- person.name as "person.name", |
|
2773 |
- person.age as "person.age" |
|
2774 |
- |
|
2775 |
-You can specify array of array reference, first argument is |
|
2776 |
-column name, second argument is alias. |
|
2777 |
- |
|
2778 |
- column => [ |
|
2779 |
- ['date(book.register_datetime)' => 'book.register_date'] |
|
2780 |
- ]; |
|
2781 |
- |
|
2782 |
-Alias is quoted properly and joined. |
|
2783 |
- |
|
2784 |
- date(book.register_datetime) as "book.register_date" |
|
2785 |
- |
|
2786 |
-=item C<filter> |
|
2787 |
- |
|
2788 |
-Same as C<execute> method's C<filter> option. |
|
2789 |
- |
|
2790 |
-=item C<id> |
|
2791 |
- |
|
2792 |
- id => 4 |
|
2793 |
- id => [4, 5] |
|
2794 |
- |
|
2795 |
-ID corresponding to C<primary_key>. |
|
2796 |
-You can select rows by C<id> and C<primary_key>. |
|
2797 |
- |
|
2798 |
- $dbi->select( |
|
2799 |
- parimary_key => ['id1', 'id2'], |
|
2800 |
- id => [4, 5], |
|
2801 |
- table => 'book' |
|
2802 |
- ); |
|
2803 |
- |
|
2804 |
-The above is same as the followin one. |
|
2805 |
- |
|
2806 |
- $dbi->select( |
|
2807 |
- where => {id1 => 4, id2 => 5}, |
|
2808 |
- table => 'book' |
|
2809 |
- ); |
|
2810 |
- |
|
2811 |
-=item C<param> EXPERIMETNAL |
|
2812 |
- |
|
2813 |
- param => {'table2.key3' => 5} |
|
2814 |
- |
|
2815 |
-Parameter shown before where clause. |
|
2816 |
- |
|
2817 |
-For example, if you want to contain tag in join clause, |
|
2818 |
-you can pass parameter by C<param> option. |
|
2819 |
- |
|
2820 |
- join => ['inner join (select * from table2 where table2.key3 = :table2.key3)' . |
|
2821 |
- ' as table2 on table1.key1 = table2.key1'] |
|
2822 |
- |
|
2823 |
-=itme C<prefix> |
|
2824 |
- |
|
2825 |
- prefix => 'SQL_CALC_FOUND_ROWS' |
|
2826 |
- |
|
2827 |
-Prefix of column cluase |
|
2828 |
- |
|
2829 |
- select SQL_CALC_FOUND_ROWS title, author from book; |
|
2830 |
- |
|
2831 |
-=item C<join> |
|
2832 |
- |
|
2833 |
- join => [ |
|
2834 |
- 'left outer join company on book.company_id = company_id', |
|
2835 |
- 'left outer join location on company.location_id = location.id' |
|
2836 |
- ] |
|
2837 |
- |
|
2838 |
-Join clause. If column cluase or where clause contain table name like "company.name", |
|
2839 |
-join clausees needed when SQL is created is used automatically. |
|
2840 |
- |
|
2841 |
- $dbi->select( |
|
2842 |
- table => 'book', |
|
2843 |
- column => ['company.location_id as location_id'], |
|
2844 |
- where => {'company.name' => 'Orange'}, |
|
2845 |
- join => [ |
|
2846 |
- 'left outer join company on book.company_id = company.id', |
|
2847 |
- 'left outer join location on company.location_id = location.id' |
|
2848 |
- ] |
|
2849 |
- ); |
|
2850 |
- |
|
2851 |
-In above select, column and where clause contain "company" table, |
|
2852 |
-the following SQL is created |
|
2853 |
- |
|
2854 |
- select company.location_id as location_id |
|
2855 |
- from book |
|
2856 |
- left outer join company on book.company_id = company.id |
|
2857 |
- where company.name = ?; |
|
2858 |
- |
|
2859 |
-You can specify two table by yourself. This is useful when join parser can't parse |
|
2860 |
-the join clause correctly. This is EXPERIMENTAL. |
|
2861 |
- |
|
2862 |
- $dbi->select( |
|
2863 |
- table => 'book', |
|
2864 |
- column => ['company.location_id as location_id'], |
|
2865 |
- where => {'company.name' => 'Orange'}, |
|
2866 |
- join => [ |
|
2867 |
- { |
|
2868 |
- clause => 'left outer join location on company.location_id = location.id', |
|
2869 |
- table => ['company', 'location'] |
|
2870 |
- } |
|
2871 |
- ] |
|
2872 |
- ); |
|
2873 |
- |
|
2874 |
-=item C<primary_key> |
|
2875 |
- |
|
2876 |
- primary_key => 'id' |
|
2877 |
- primary_key => ['id1', 'id2'] |
|
2878 |
- |
|
2879 |
-Primary key. This is used by C<id> option. |
|
2880 |
- |
|
2881 |
-=item C<query> |
|
2882 |
- |
|
2883 |
-Same as C<execute> method's C<query> option. |
|
2884 |
- |
|
2885 |
-=item C<bind_type> |
|
2886 |
- |
|
2887 |
-Same as C<execute> method's C<bind_type> option. |
|
2888 |
- |
|
2889 |
-=item C<table> |
|
2890 |
- |
|
2891 |
- table => 'book' |
|
2892 |
- |
|
2893 |
-Table name. |
|
2894 |
- |
|
2895 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2896 |
- |
|
2897 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2898 |
- |
|
2899 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2900 |
- |
|
2901 |
- type_rule1_off => 1 |
|
2902 |
- |
|
2903 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2904 |
- |
|
2905 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2906 |
- |
|
2907 |
- type_rule2_off => 1 |
|
2908 |
- |
|
2909 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2910 |
- |
|
2911 |
-=item C<where> |
|
2912 |
- |
|
2913 |
- # Hash refrence |
|
2914 |
- where => {author => 'Ken', 'title' => 'Perl'} |
|
2915 |
- |
|
2916 |
- # DBIx::Custom::Where object |
|
2917 |
- where => $dbi->where( |
|
2918 |
- clause => ['and', 'author = :author', 'title like :title'], |
|
2919 |
- param => {author => 'Ken', title => '%Perl%'} |
|
2920 |
- ); |
|
2921 |
- |
|
2922 |
- # Array reference 1 (array reference, hash referenc). same as above |
|
2923 |
- where => [ |
|
2924 |
- ['and', 'author = :author', 'title like :title'], |
|
2925 |
- {author => 'Ken', title => '%Perl%'} |
|
2926 |
- ]; |
|
2927 |
- |
|
2928 |
- # Array reference 2 (String, hash reference) |
|
2929 |
- where => [ |
|
2930 |
- 'title like :title', |
|
2931 |
- {title => '%Perl%'} |
|
2932 |
- ] |
|
2933 |
- |
|
2934 |
- # String |
|
2935 |
- where => 'title is null' |
|
2936 |
- |
|
2937 |
-Where clause. |
|
2938 |
- |
|
2939 |
-=item C<wrap> EXPERIMENTAL |
|
2940 |
- |
|
2941 |
-Wrap statement. This is array reference. |
|
2942 |
- |
|
2943 |
- $dbi->select(wrap => ['select * from (', ') as t where ROWNUM < 10']); |
|
2944 |
- |
|
2945 |
-This option is for Oracle and SQL Server paging process. |
|
2946 |
- |
|
2947 |
-=back |
|
2948 |
- |
|
2949 |
-=head2 C<update> |
|
2950 |
- |
|
2951 |
- $dbi->update({title => 'Perl'}, table => 'book', where => {id => 4}); |
|
2952 |
- |
|
2953 |
-Execute update statement. First argument is update row data. |
|
2954 |
- |
|
2955 |
-If you want to set constant value to row data, use scalar reference |
|
2956 |
-as parameter value. |
|
2957 |
- |
|
2958 |
- {date => \"NOW()"} |
|
2959 |
- |
|
2960 |
-The following opitons are available. |
|
2961 |
- |
|
2962 |
-=over 4 |
|
2963 |
- |
|
2964 |
-=item C<append> |
|
2965 |
- |
|
2966 |
-Same as C<select> method's C<append> option. |
|
2967 |
- |
|
2968 |
-=item C<filter> |
|
2969 |
- |
|
2970 |
-Same as C<execute> method's C<filter> option. |
|
2971 |
- |
|
2972 |
-=item C<id> |
|
2973 |
- |
|
2974 |
- id => 4 |
|
2975 |
- id => [4, 5] |
|
2976 |
- |
|
2977 |
-ID corresponding to C<primary_key>. |
|
2978 |
-You can update rows by C<id> and C<primary_key>. |
|
2979 |
- |
|
2980 |
- $dbi->update( |
|
2981 |
- {title => 'Perl', author => 'Ken'} |
|
2982 |
- parimary_key => ['id1', 'id2'], |
|
2983 |
- id => [4, 5], |
|
2984 |
- table => 'book' |
|
2985 |
- ); |
|
2986 |
- |
|
2987 |
-The above is same as the followin one. |
|
2988 |
- |
|
2989 |
- $dbi->update( |
|
2990 |
- {title => 'Perl', author => 'Ken'} |
|
2991 |
- where => {id1 => 4, id2 => 5}, |
|
2992 |
- table => 'book' |
|
2993 |
- ); |
|
2994 |
- |
|
2995 |
-=item C<prefix> |
|
2996 |
- |
|
2997 |
- prefix => 'or replace' |
|
2998 |
- |
|
2999 |
-prefix before table name section |
|
3000 |
- |
|
3001 |
- update or replace book |
|
3002 |
- |
|
3003 |
-=item C<primary_key> |
|
3004 |
- |
|
3005 |
- primary_key => 'id' |
|
3006 |
- primary_key => ['id1', 'id2'] |
|
3007 |
- |
|
3008 |
-Primary key. This is used by C<id> option. |
|
3009 |
- |
|
3010 |
-=item C<query> |
|
3011 |
- |
|
3012 |
-Same as C<execute> method's C<query> option. |
|
3013 |
- |
|
3014 |
-=item C<table> |
|
3015 |
- |
|
3016 |
- table => 'book' |
|
3017 |
- |
|
3018 |
-Table name. |
|
3019 |
- |
|
3020 |
-=item C<where> |
|
3021 |
- |
|
3022 |
-Same as C<select> method's C<where> option. |
|
3023 |
- |
|
3024 |
-=item C<bind_type> |
|
3025 |
- |
|
3026 |
-Same as C<execute> method's C<bind_type> option. |
|
3027 |
- |
|
3028 |
-=item C<type_rule_off> EXPERIMENTAL |
|
3029 |
- |
|
3030 |
-Same as C<execute> method's C<type_rule_off> option. |
|
3031 |
- |
|
3032 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
3033 |
- |
|
3034 |
- type_rule1_off => 1 |
|
3035 |
- |
|
3036 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
3037 |
- |
|
3038 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
3039 |
- |
|
3040 |
- type_rule2_off => 1 |
|
3041 |
- |
|
3042 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
3043 |
- |
|
3044 |
-=back |
|
3045 |
- |
|
3046 |
-=head2 C<update_all> |
|
3047 |
- |
|
3048 |
- $dbi->update_all({title => 'Perl'}, table => 'book', ); |
|
3049 |
- |
|
3050 |
-Execute update statement for all rows. |
|
3051 |
-Options is same as C<update> method. |
|
3052 |
- |
|
3053 |
-=head2 C<update_param> |
|
3054 |
- |
|
3055 |
- my $update_param = $dbi->update_param({title => 'a', age => 2}); |
|
3056 |
- |
|
3057 |
-Create update parameter tag. |
|
3058 |
- |
|
3059 |
- set title = :title, author = :author |
|
3060 |
- |
|
3061 |
-=head2 C<where> |
|
3062 |
- |
|
3063 |
- my $where = $dbi->where( |
|
3064 |
- clause => ['and', 'title = :title', 'author = :author'], |
|
3065 |
- param => {title => 'Perl', author => 'Ken'} |
|
3066 |
- ); |
|
3067 |
- |
|
3068 |
-Create a new L<DBIx::Custom::Where> object. |
|
3069 |
- |
|
3070 |
-=head2 C<setup_model> |
|
3071 |
- |
|
3072 |
- $dbi->setup_model; |
|
3073 |
- |
|
3074 |
-Setup all model objects. |
|
3075 |
-C<columns> of model object is automatically set, parsing database information. |
|
3076 |
- |
|
3077 |
-=head1 ENVIRONMENT VARIABLE |
|
3078 |
- |
|
3079 |
-=head2 C<DBIX_CUSTOM_DEBUG> |
|
3080 |
- |
|
3081 |
-If environment variable C<DBIX_CUSTOM_DEBUG> is set to true, |
|
3082 |
-executed SQL and bind values are printed to STDERR. |
|
3083 |
- |
|
3084 |
-=head2 C<DBIX_CUSTOM_DEBUG_ENCODING> |
|
3085 |
- |
|
3086 |
-DEBUG output encoding. Default to UTF-8. |
|
3087 |
- |
|
3088 |
-=head1 DEPRECATED FUNCTIONALITIES |
|
3089 |
- |
|
3090 |
-L<DBIx::Custom> |
|
3091 |
- |
|
3092 |
- # Attribute methods |
|
3093 |
- data_source # will be removed at 2017/1/1 |
|
3094 |
- dbi_options # will be removed at 2017/1/1 |
|
3095 |
- filter_check # will be removed at 2017/1/1 |
|
3096 |
- reserved_word_quote # will be removed at 2017/1/1 |
|
3097 |
- cache_method # will be removed at 2017/1/1 |
|
3098 |
- |
|
3099 |
- # Methods |
|
3100 |
- create_query # will be removed at 2017/1/1 |
|
3101 |
- apply_filter # will be removed at 2017/1/1 |
|
3102 |
- select_at # will be removed at 2017/1/1 |
|
3103 |
- delete_at # will be removed at 2017/1/1 |
|
3104 |
- update_at # will be removed at 2017/1/1 |
|
3105 |
- insert_at # will be removed at 2017/1/1 |
|
3106 |
- register_tag # will be removed at 2017/1/1 |
|
3107 |
- default_bind_filter # will be removed at 2017/1/1 |
|
3108 |
- default_fetch_filter # will be removed at 2017/1/1 |
|
3109 |
- insert_param_tag # will be removed at 2017/1/1 |
|
3110 |
- register_tag_processor # will be removed at 2017/1/1 |
|
3111 |
- update_param_tag # will be removed at 2017/1/1 |
|
3112 |
- |
|
3113 |
- # Options |
|
3114 |
- select method relation option # will be removed at 2017/1/1 |
|
3115 |
- select method param option # will be removed at 2017/1/1 |
|
3116 |
- select method column option [COLUMN, as => ALIAS] format |
|
3117 |
- # will be removed at 2017/1/1 |
|
3118 |
- |
|
3119 |
- # Others |
|
3120 |
- execute("select * from {= title}"); # execute method's |
|
3121 |
- # tag parsing functionality |
|
3122 |
- # will be removed at 2017/1/1 |
|
3123 |
- Query caching # will be removed at 2017/1/1 |
|
3124 |
- |
|
3125 |
-L<DBIx::Custom::Model> |
|
3126 |
- |
|
3127 |
- # Attribute methods |
|
3128 |
- filter # will be removed at 2017/1/1 |
|
3129 |
- name # will be removed at 2017/1/1 |
|
3130 |
- type # will be removed at 2017/1/1 |
|
3131 |
- |
|
3132 |
-L<DBIx::Custom::Query> |
|
3133 |
- |
|
3134 |
- # Attribute methods |
|
3135 |
- default_filter # will be removed at 2017/1/1 |
|
3136 |
- table # will be removed at 2017/1/1 |
|
3137 |
- filters # will be removed at 2017/1/1 |
|
3138 |
- |
|
3139 |
- # Methods |
|
3140 |
- filter # will be removed at 2017/1/1 |
|
3141 |
- |
|
3142 |
-L<DBIx::Custom::QueryBuilder> |
|
3143 |
- |
|
3144 |
- # Attribute methods |
|
3145 |
- tags # will be removed at 2017/1/1 |
|
3146 |
- tag_processors # will be removed at 2017/1/1 |
|
3147 |
- |
|
3148 |
- # Methods |
|
3149 |
- register_tag # will be removed at 2017/1/1 |
|
3150 |
- register_tag_processor # will be removed at 2017/1/1 |
|
3151 |
- |
|
3152 |
- # Others |
|
3153 |
- build_query("select * from {= title}"); # tag parsing functionality |
|
3154 |
- # will be removed at 2017/1/1 |
|
3155 |
- |
|
3156 |
-L<DBIx::Custom::Result> |
|
3157 |
- |
|
3158 |
- # Attribute methods |
|
3159 |
- filter_check # will be removed at 2017/1/1 |
|
3160 |
- |
|
3161 |
- # Methods |
|
3162 |
- end_filter # will be removed at 2017/1/1 |
|
3163 |
- remove_end_filter # will be removed at 2017/1/1 |
|
3164 |
- remove_filter # will be removed at 2017/1/1 |
|
3165 |
- default_filter # will be removed at 2017/1/1 |
|
3166 |
- |
|
3167 |
-L<DBIx::Custom::Tag> |
|
3168 |
- |
|
3169 |
- This module is DEPRECATED! # will be removed at 2017/1/1 |
|
3170 |
- |
|
3171 |
-=head1 BACKWORD COMPATIBLE POLICY |
|
3172 |
- |
|
3173 |
-If a functionality is DEPRECATED, you can know it by DEPRECATED warnings |
|
3174 |
-except for attribute method. |
|
3175 |
-You can check all DEPRECATED functionalities by document. |
|
3176 |
-DEPRECATED functionality is removed after five years, |
|
3177 |
-but if at least one person use the functionality and tell me that thing |
|
3178 |
-I extend one year each time he tell me it. |
|
3179 |
- |
|
3180 |
-EXPERIMENTAL functionality will be changed without warnings. |
|
3181 |
- |
|
3182 |
-This policy was changed at 2011/6/28 |
|
3183 |
- |
|
3184 |
-=head1 BUGS |
|
3185 |
- |
|
3186 |
-Please tell me bugs if found. |
|
3187 |
- |
|
3188 |
-C<< <kimoto.yuki at gmail.com> >> |
|
3189 |
- |
|
3190 |
-L<http://github.com/yuki-kimoto/DBIx-Custom> |
|
3191 |
- |
|
3192 |
-=head1 AUTHOR |
|
3193 |
- |
|
3194 |
-Yuki Kimoto, C<< <kimoto.yuki at gmail.com> >> |
|
3195 |
- |
|
3196 |
-=head1 COPYRIGHT & LICENSE |
|
3197 |
- |
|
3198 |
-Copyright 2009-2011 Yuki Kimoto, all rights reserved. |
|
3199 |
- |
|
3200 |
-This program is free software; you can redistribute it and/or modify it |
|
3201 |
-under the same terms as Perl itself. |
|
3202 |
- |
|
3203 |
-=cut |
... | ... |
@@ -1,603 +0,0 @@ |
1 |
-=encoding utf8 |
|
2 |
- |
|
3 |
-=head1 NAME |
|
4 |
- |
|
5 |
-DBIx::Custom::Guide - DBIx::Custom Guide |
|
6 |
- |
|
7 |
-=head1 FEATURES |
|
8 |
- |
|
9 |
-L<DBIx::Custom> is the wrapper class of L<DBI> to execute SQL easily. |
|
10 |
-This module have the following features. |
|
11 |
- |
|
12 |
-=over 4 |
|
13 |
- |
|
14 |
-=item * Execute INSERT, UPDATE, DELETE, SELECT statement easily |
|
15 |
- |
|
16 |
-=item * You can specify bind values by hash reference |
|
17 |
- |
|
18 |
-=item * Filtering by data type. and you can set filter to any column |
|
19 |
- |
|
20 |
-=item * Creating where clause and order by clause flexibly |
|
21 |
- |
|
22 |
-=item * Support model |
|
23 |
- |
|
24 |
-=back |
|
25 |
- |
|
26 |
-=head1 GUIDE |
|
27 |
- |
|
28 |
-=head2 Connect to database |
|
29 |
- |
|
30 |
- use DBIx::Custom; |
|
31 |
- my $dbi = DBIx::Custom->connect( |
|
32 |
- dsn => "dbi:mysql:database=bookshop", |
|
33 |
- user => 'ken', |
|
34 |
- password => '!LFKD%$&', |
|
35 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
36 |
- ); |
|
37 |
- |
|
38 |
-You can connect to database by C<connect> method. |
|
39 |
-C<dsn> is data source name, C<user> is user name, C<password> is password. |
|
40 |
- |
|
41 |
-C<dbi_option> is L<DBI> option. |
|
42 |
-By default, the following option is set. |
|
43 |
-Exeption is thrown when fatal error occur and commit mode is auto commit. |
|
44 |
- |
|
45 |
- { |
|
46 |
- RaiseError => 1 |
|
47 |
- PrintError => 0 |
|
48 |
- AutoCommit => 1 |
|
49 |
- } |
|
50 |
- |
|
51 |
-=head2 Execute query |
|
52 |
- |
|
53 |
-=head3 Insert Statement : C<insert> |
|
54 |
- |
|
55 |
-If you want to execute insert statement, use C<insert> method. |
|
56 |
- |
|
57 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
58 |
- |
|
59 |
-First argument is insert row data, C<table> is table name. |
|
60 |
- |
|
61 |
-=head3 Update Statement : C<update> |
|
62 |
- |
|
63 |
-If you want to execute update stateimuse, use C<update> method. |
|
64 |
- |
|
65 |
- $dbi->update( |
|
66 |
- {title => 'Perl', author => 'Ken'}, |
|
67 |
- table => 'book', |
|
68 |
- where => {id => 5} |
|
69 |
- ); |
|
70 |
- |
|
71 |
-First argument is update row data, C<table> is table name, C<where> is condition. |
|
72 |
- |
|
73 |
-Note that you can't execute C<update> method without C<where>. |
|
74 |
-If you want to update all rows, use update_all. |
|
75 |
- |
|
76 |
- $dbi->update_all({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
77 |
- |
|
78 |
-=head3 Delete Statement : C<delete> |
|
79 |
- |
|
80 |
-If you want to execute delete statement, use C<delete> method. |
|
81 |
- |
|
82 |
- $dbi->delete(table => 'book', where => {author => 'Ken'}); |
|
83 |
- |
|
84 |
-C<table> is table name, C<where> is condition. |
|
85 |
- |
|
86 |
-Note that you can't execute C<delete> method without C<where>. |
|
87 |
-If you want to delete all rows, use C<delete_all> method. |
|
88 |
- |
|
89 |
- $dbi->delete_all(table => 'book'); |
|
90 |
- |
|
91 |
-=head3 Select Statement : C<select> |
|
92 |
- |
|
93 |
-If you want to execute select statement, use C<select> method. |
|
94 |
- |
|
95 |
- my $result = $dbi->select(table => 'book'); |
|
96 |
- |
|
97 |
-Return value is L<DBIx::Custom::Result> object. |
|
98 |
-You can fetch rows by C<fetch> method. |
|
99 |
- |
|
100 |
- while (my $row = $result->fetch) { |
|
101 |
- my $title = $row->[0]; |
|
102 |
- my $author = $row->[1]; |
|
103 |
- } |
|
104 |
- |
|
105 |
-See also L<Fetch row/"Fetch row"> about L<DBIx::Custom::Result>. |
|
106 |
- |
|
107 |
-You can specify column names by C<column> option |
|
108 |
-and condition by C<where> option. |
|
109 |
- |
|
110 |
- my $result = $dbi->select( |
|
111 |
- table => 'book', |
|
112 |
- column => ['author', 'title'], |
|
113 |
- where => {author => 'Ken'} |
|
114 |
- ); |
|
115 |
- |
|
116 |
-You can specify join clause by C<join> option. |
|
117 |
- |
|
118 |
- my $result = $dbi->select( |
|
119 |
- table => 'book', |
|
120 |
- column => ['company.name as company_name'] |
|
121 |
- where => {'book.name' => 'Perl'}, |
|
122 |
- join => ['left outer join company on book.company_id = company.id] |
|
123 |
- ); |
|
124 |
- |
|
125 |
-Note that join clause is joined only when C<where> or C<column> option contains table name, |
|
126 |
-such as book.name. |
|
127 |
- |
|
128 |
-You can append statement to the end of whole statement by C<append> option. |
|
129 |
- |
|
130 |
- my $result = $dbi->select( |
|
131 |
- table => 'book', |
|
132 |
- where => {author => 'Ken'}, |
|
133 |
- append => 'for update', |
|
134 |
- ); |
|
135 |
- |
|
136 |
-=head3 C<execute> |
|
137 |
- |
|
138 |
-If you want to execute SQL, use C<execute> method. |
|
139 |
- |
|
140 |
- $dbi->execute("select * from book;"); |
|
141 |
- |
|
142 |
-You can specify named placeholder. |
|
143 |
- |
|
144 |
- $dbi->execute( |
|
145 |
- "select * from book title = :title and author = :author;" |
|
146 |
- {title => 'Perl', author => 'Ken'} |
|
147 |
- ); |
|
148 |
- |
|
149 |
-:title and :author is named placeholder, which is replaced to placeholers. |
|
150 |
- |
|
151 |
- select * from book title = ? and author = ?; |
|
152 |
- |
|
153 |
-=head3 C<dbh> |
|
154 |
- |
|
155 |
- my $dbh = $dbi->dbh; |
|
156 |
- |
|
157 |
-Get get database handle object of L<DBI>. |
|
158 |
- |
|
159 |
-=head3 C<DBI> methods |
|
160 |
- |
|
161 |
- $dbi->do(...); |
|
162 |
- $dbi->begin_work; |
|
163 |
- |
|
164 |
-You can call all methods of L<DBI> from L<DBIx::Custom> object. |
|
165 |
- |
|
166 |
-=head2 Fetch Rows |
|
167 |
- |
|
168 |
-C<select> method return value is L<DBIx::Custom::Result> object. |
|
169 |
-You can fetch a row or rows by various methods. |
|
170 |
- |
|
171 |
-=head3 Fetch a row (array) : C<fetch> |
|
172 |
- |
|
173 |
- my $row = $result->fetch; |
|
174 |
- |
|
175 |
-C<fetch> method fetch a row and put it into array reference. |
|
176 |
-You can continue to fetch |
|
177 |
- |
|
178 |
- while (my $row = $result->fetch) { |
|
179 |
- my $title = $row->[0]; |
|
180 |
- my $author = $row->[1]; |
|
181 |
- } |
|
182 |
- |
|
183 |
-=head3 Fetch only first row (array) : C<fetch_first> |
|
184 |
- |
|
185 |
- my $row = $result->fetch_first; |
|
186 |
- |
|
187 |
-C<fetch_first> fetch a only first row and finish statment handle, |
|
188 |
-and put it into array refrence. |
|
189 |
- |
|
190 |
-=head3 Fetch all rows (array) : C<fetch_all> |
|
191 |
- |
|
192 |
- my $rows = $result->fetch_all; |
|
193 |
- |
|
194 |
-C<fetch_all> fetch all rows and put them into array of array reference. |
|
195 |
- |
|
196 |
-=head3 Fetch a row (hash) : C<fetch_hash> |
|
197 |
- |
|
198 |
- my $row = $result->fetch_hash; |
|
199 |
- |
|
200 |
-C<fetch_hash> fetch a row and put it into hash reference. |
|
201 |
-You can fetch a row while row exists. |
|
202 |
- |
|
203 |
- while (my $row = $result->fetch_hash) { |
|
204 |
- my $title = $row->{title}; |
|
205 |
- my $author = $row->{author}; |
|
206 |
- } |
|
207 |
- |
|
208 |
-=head3 Fetch only a first row (hash) : C<fetch_hash_first> |
|
209 |
- |
|
210 |
- my $row = $result->fetch_hash_first; |
|
211 |
- |
|
212 |
-C<fetch_hash_first> fetch only a first row and finish statement handle, |
|
213 |
-and put them into hash refrence. |
|
214 |
- |
|
215 |
-C<one> is C<fetch_hash_first> synonym to save word typing. |
|
216 |
- |
|
217 |
- my $row = $result->one; |
|
218 |
- |
|
219 |
-=head3 Fetch all rows (hash) : C<fetch_hash_all> |
|
220 |
- |
|
221 |
- my $rows = $result->fetch_hash_all; |
|
222 |
- |
|
223 |
-C<fetch_hash_all> fetch all rows and put them into array of hash reference. |
|
224 |
- |
|
225 |
-=head3 Statement Handle : C<sth> |
|
226 |
- |
|
227 |
- my $sth = $result->sth; |
|
228 |
- |
|
229 |
-If you want to get statment handle, use <sth> method. |
|
230 |
- |
|
231 |
-=head2 Named placeholder |
|
232 |
- |
|
233 |
-=head3 Basic of Parameter |
|
234 |
- |
|
235 |
-You can embedd named placeholder into SQL. |
|
236 |
- |
|
237 |
- select * from book where title = :title and author like :author; |
|
238 |
- |
|
239 |
-:title and :author is named placeholder |
|
240 |
- |
|
241 |
-Named placeholder is replaced by place holder. |
|
242 |
- |
|
243 |
- select * from book where title = ? and author like ?; |
|
244 |
- |
|
245 |
-use C<execute> to execute SQL. |
|
246 |
- |
|
247 |
- my $sql = "select * from book where title = :title and author like :author;" |
|
248 |
- $dbi->execute($sql, {title => 'Perl', author => '%Ken%'}); |
|
249 |
- |
|
250 |
-You can specify C<filter> at C<execute>. |
|
251 |
- |
|
252 |
- $dbi->execute($sql, {title => 'Perl', author => '%Ken%'} |
|
253 |
- filter => {title => 'to_something'); |
|
254 |
- |
|
255 |
-=head3 Manipulate same name's columns |
|
256 |
- |
|
257 |
-It is ok if there are same name's columns. |
|
258 |
-Let's think two date comparison. |
|
259 |
- |
|
260 |
- my $sql = "select * from table where date > :date and date < :date;"; |
|
261 |
- |
|
262 |
-In this case, You specify parameter values as array reference. |
|
263 |
- |
|
264 |
- my $dbi->execute($sql, {date => ['2010-10-01', '2012-02-10']}); |
|
265 |
- |
|
266 |
-=head2 Create where clause |
|
267 |
- |
|
268 |
-=head3 Dinamically create where clause : where |
|
269 |
- |
|
270 |
-You want to search multiple conditions in many times. |
|
271 |
-Let's think the following three cases. |
|
272 |
- |
|
273 |
-Case1: Search only C<title> |
|
274 |
- |
|
275 |
- where title = :title |
|
276 |
- |
|
277 |
-Case2: Search only C<author> |
|
278 |
- |
|
279 |
- where author = :author |
|
280 |
- |
|
281 |
-Case3: Search C<title> and C<author> |
|
282 |
- |
|
283 |
- where title = :title and author = :author |
|
284 |
- |
|
285 |
-L<DBIx::Custom> support dinamic where clause creating. |
|
286 |
-At first, create L<DBIx::Custom::Where> object by C<where>. |
|
287 |
- |
|
288 |
- my $where = $dbi->where; |
|
289 |
- |
|
290 |
-Set clause by C<clause> |
|
291 |
- |
|
292 |
- $where->clause( |
|
293 |
- ['and', 'title = :title, 'author = :author'] |
|
294 |
- ); |
|
295 |
- |
|
296 |
-C<clause> is the following format. |
|
297 |
- |
|
298 |
- ['or' or 'and', PART1, PART1, PART1] |
|
299 |
- |
|
300 |
-First argument is 'or' or 'and'. |
|
301 |
-Later than first argument are part which contains named placeholder. |
|
302 |
- |
|
303 |
-You can write more complex format. |
|
304 |
- |
|
305 |
- ['and', |
|
306 |
- 'title = :title', |
|
307 |
- ['or', 'author = :author', 'date like :date'] |
|
308 |
- ] |
|
309 |
- |
|
310 |
-This mean "title = :title and ( author = :author or date like :date )". |
|
311 |
- |
|
312 |
-After setting C<clause>, set C<param>. |
|
313 |
- |
|
314 |
- $where->param({title => 'Perl'}); |
|
315 |
- |
|
316 |
-In this example, parameter contains only title. |
|
317 |
- |
|
318 |
-If you execute C<string_to>, you can get where clause |
|
319 |
-which contain only named placeholder. |
|
320 |
- |
|
321 |
- my $where_clause = $where->to_string; |
|
322 |
- |
|
323 |
-Parameter name is only title, the following where clause is created. |
|
324 |
- |
|
325 |
- where title = :title |
|
326 |
- |
|
327 |
-You can also create where clause by stringification. |
|
328 |
- |
|
329 |
- my $where_clause = "$where"; |
|
330 |
- |
|
331 |
-This is useful to embbed it into SQL. |
|
332 |
- |
|
333 |
-=head3 In case where clause contains same name columns |
|
334 |
- |
|
335 |
-Even if same name parameters exists, you can create where clause. |
|
336 |
-Let's think that there are starting date and ending date. |
|
337 |
- |
|
338 |
- my $param = {start_date => '2010-11-15', end_date => '2011-11-21'}; |
|
339 |
- |
|
340 |
-In this case, you set parameter value as array reference. |
|
341 |
- |
|
342 |
- my $p = {date => ['2010-11-15', '2011-11-21']}; |
|
343 |
- |
|
344 |
-You can embbed these values into same name parameters. |
|
345 |
- |
|
346 |
- $where->clause( |
|
347 |
- ['and', 'date > :date', 'date < :date'] |
|
348 |
- ); |
|
349 |
- $where->param($p); |
|
350 |
- |
|
351 |
-If starting date isn't exists, create the following parameter. |
|
352 |
- |
|
353 |
- my $p = {date => [$dbi->not_exists, '2011-11-21']}; |
|
354 |
- |
|
355 |
-You can get DBIx::Custom::NotExists object by C<not_exists> |
|
356 |
-This mean correnspondinf value isn't exists. |
|
357 |
- |
|
358 |
-If ending date isn't exists, create the following parameter. |
|
359 |
- |
|
360 |
- my $p = {date => ['2010-11-15']}; |
|
361 |
- |
|
362 |
-If both date isn't exists, create the following parameter. |
|
363 |
- |
|
364 |
- my $p = {date => []}; |
|
365 |
- |
|
366 |
-This logic is a little difficut. See the following ones. |
|
367 |
- |
|
368 |
- my @date; |
|
369 |
- push @date, exists $param->{start_date} ? $param->{start_date} |
|
370 |
- : $dbi->not_exists; |
|
371 |
- push @date, $param->{end_date} if exists $param->{end_date}; |
|
372 |
- my $p = {date => \@date}; |
|
373 |
- |
|
374 |
-=head3 With C<select> |
|
375 |
- |
|
376 |
-You can pass L<DBIx::Custom::Where> object to C<where> of C<select>. |
|
377 |
- |
|
378 |
- my $where = $dbi->where; |
|
379 |
- $where->clause(['and', 'title = :title', 'author = :author']); |
|
380 |
- $where->param({title => 'Perl'}); |
|
381 |
- my $result = $dbi->select(table => 'book', where => $where); |
|
382 |
- |
|
383 |
-You can also pass it to C<where> of C<update>AC<delete> |
|
384 |
- |
|
385 |
-=head3 With C<execute> |
|
386 |
- |
|
387 |
-L<DBIx::Custom::Where> object is embedded into SQL. |
|
388 |
- |
|
389 |
- my $where = $dbi->where; |
|
390 |
- $where->clause(['and', 'title = :title', 'author = :author']); |
|
391 |
- $where->param({title => 'Perl'}); |
|
392 |
- |
|
393 |
- my $sql = <<"EOS"; |
|
394 |
- select * from book; |
|
395 |
- $where |
|
396 |
- EOS |
|
397 |
- |
|
398 |
- $dbi->execute($sql, $param, table => 'book'); |
|
399 |
- |
|
400 |
-=head2 Filtering |
|
401 |
- |
|
402 |
-=head3 Register filter : C<register_filter> |
|
403 |
- |
|
404 |
-If you want to register filter, use C<register_filter>. |
|
405 |
- |
|
406 |
- $dbi->register_filter( |
|
407 |
- # Time::Piece object to DATE format |
|
408 |
- tp_to_date => sub { |
|
409 |
- my $date = shift; |
|
410 |
- return $tp->strftime('%Y-%m-%d'); |
|
411 |
- }, |
|
412 |
- |
|
413 |
- # DATE to Time::Piece object |
|
414 |
- date_to_tp => sub { |
|
415 |
- my $date = shift; |
|
416 |
- return Time::Piece->strptime($date, '%Y-%m-%d'); |
|
417 |
- }, |
|
418 |
- ); |
|
419 |
- |
|
420 |
-=head3 Filter before sending data into database : C<filter> option |
|
421 |
- |
|
422 |
-If you filter sending data, use C<filter> option. |
|
423 |
- |
|
424 |
- $dbi->execute( |
|
425 |
- 'insert into book (date) values (:date)', |
|
426 |
- {date => $tp}, |
|
427 |
- filter => {date => 'tp_to_date'} |
|
428 |
- ); |
|
429 |
- |
|
430 |
-You can use C<filter> option in C<insert>, C<update>, C<delete>, C<select> method. |
|
431 |
- |
|
432 |
- $dbi->insert( |
|
433 |
- {date => $tp}, |
|
434 |
- table => 'book', |
|
435 |
- filter => {date => 'tp_to_date'} |
|
436 |
- ); |
|
437 |
- |
|
438 |
-=head3 Filter after fetching data from database. |
|
439 |
- |
|
440 |
-If you filter fetch data, use L<DBIx::Custom::Result>'s C<filter> method. |
|
441 |
- |
|
442 |
- my $result = $dbi->select(column => 'date', table => 'book'); |
|
443 |
- $result->filter(date => 'date_to_tp'); |
|
444 |
- my $row = $result->one; |
|
445 |
- |
|
446 |
-=head2 7. Model |
|
447 |
- |
|
448 |
-=head3 Model |
|
449 |
- |
|
450 |
-you can define model extending L<DBIx::Custom::Model> |
|
451 |
-to improve source code view. |
|
452 |
- |
|
453 |
-At first, you create basic model class extending <DBIx::Custom::Model>. |
|
454 |
-Each L<DBIx::Custom> class inherit L<Object::Simple>. |
|
455 |
-so you can inherit the following way. |
|
456 |
- |
|
457 |
- package MyModel; |
|
458 |
- use DBIx::Custom::Model -base; |
|
459 |
- |
|
460 |
-Next, you create each model classes. |
|
461 |
- |
|
462 |
-MyModel::book |
|
463 |
- |
|
464 |
- package MyModel::book; |
|
465 |
- use MyModel -base; |
|
466 |
- |
|
467 |
- sub insert { ... } |
|
468 |
- sub list { ... } |
|
469 |
- |
|
470 |
-MyModel::company |
|
471 |
- |
|
472 |
- package MyModel::company; |
|
473 |
- use MyModel -base; |
|
474 |
- |
|
475 |
- sub insert { ... } |
|
476 |
- sub list { ... } |
|
477 |
- |
|
478 |
-The follwoing modules location is needed. |
|
479 |
- |
|
480 |
- MyModel.pm |
|
481 |
- MyModel / book.pm |
|
482 |
- / company.pm |
|
483 |
- |
|
484 |
-You can include these models by C<include_model> |
|
485 |
- |
|
486 |
- $dbi->include_model('MyModel'); |
|
487 |
- |
|
488 |
-First argument is name space of model. |
|
489 |
- |
|
490 |
-You can use model like this. |
|
491 |
- |
|
492 |
- my $result = $dbi->model('book')->list; |
|
493 |
- |
|
494 |
-In mode, You can use such as methods, |
|
495 |
-C<insert>, C<update>, C<update_all>, |
|
496 |
-C<delete>, C<delete_all>, C<select> |
|
497 |
-without C<table> option. |
|
498 |
- |
|
499 |
- $dbi->model('book')->insert($param); |
|
500 |
- |
|
501 |
-Model is L<DBIx::Custom::Model>. |
|
502 |
- |
|
503 |
-If you need table nameAyou can get it by C<table>. |
|
504 |
- |
|
505 |
- my $table = $model->table; |
|
506 |
- |
|
507 |
-You can get L<DBIx::Custom>. |
|
508 |
- |
|
509 |
- my $dbi = $model->dbi; |
|
510 |
- |
|
511 |
-You can also call all methods of L<DBIx::Custom> and L<DBI>. |
|
512 |
- |
|
513 |
- # DBIx::Custom method |
|
514 |
- $model->execute($sql); |
|
515 |
- |
|
516 |
- # DBI method |
|
517 |
- $model->begin_work; |
|
518 |
- $model->commit; |
|
519 |
- |
|
520 |
-If you want to get all models, you can get them by keys of C<models>. |
|
521 |
- |
|
522 |
- my @models = keys %{$self->models}; |
|
523 |
- |
|
524 |
-You can set primary key to model. |
|
525 |
- |
|
526 |
- $model->primary_key(['id', 'number_id']); |
|
527 |
- |
|
528 |
-Primary key is used by C<insert>, C<update>, C<delete>, |
|
529 |
-and C<select> methods. |
|
530 |
- |
|
531 |
-You can set column names |
|
532 |
- |
|
533 |
- $model->columns(['id', 'number_id']); |
|
534 |
- |
|
535 |
-Column names is automarically set by C<setup_model>. |
|
536 |
-This method is needed to be call after C<include_model>. |
|
537 |
- |
|
538 |
- $dbi->setup_model; |
|
539 |
- |
|
540 |
-You can set C<join> |
|
541 |
- |
|
542 |
- $model->join(['left outer join company on book.company_id = company.id']); |
|
543 |
- |
|
544 |
-C<join> is used by C<select> method. |
|
545 |
- |
|
546 |
-=head2 Create column clause automatically : mycolumn, column |
|
547 |
- |
|
548 |
-To create column clause automatically, use C<mycolumn>. |
|
549 |
-Valude of C<table> and C<columns> is used. |
|
550 |
- |
|
551 |
- my $mycolumns = $model->mycolumn; |
|
552 |
- |
|
553 |
-If C<table> is 'book'AC<column> is ['id', 'name'], |
|
554 |
-the following clause is created. |
|
555 |
- |
|
556 |
- book.id as id, book.name as name |
|
557 |
- |
|
558 |
-These column name is for removing column name ambiguities. |
|
559 |
- |
|
560 |
-You can create column clause from columns of other table. |
|
561 |
- |
|
562 |
- my $columns = $model->column('company'); |
|
563 |
- |
|
564 |
-If C<table> is "company", C<column> return ['id', 'name'], |
|
565 |
-the following clause is created. |
|
566 |
- |
|
567 |
- company.id as "company.id", company.name as "company.name" |
|
568 |
- |
|
569 |
-=head2 Model Examples |
|
570 |
- |
|
571 |
-Model examples |
|
572 |
- |
|
573 |
- package MyDBI; |
|
574 |
- use DBIx::Custom -base; |
|
575 |
- |
|
576 |
- sub connect { |
|
577 |
- my $self = shift->SUPER::connect(@_); |
|
578 |
- |
|
579 |
- $self->include_model( |
|
580 |
- MyModel => [ |
|
581 |
- 'book', |
|
582 |
- 'company' |
|
583 |
- ] |
|
584 |
- ); |
|
585 |
- } |
|
586 |
- |
|
587 |
- package MyModel::book; |
|
588 |
- use DBIx::Custom::Model -base; |
|
589 |
- |
|
590 |
- has primary_key => sub { ['id'] }; |
|
591 |
- |
|
592 |
- sub insert { ... } |
|
593 |
- sub list { ... } |
|
594 |
- |
|
595 |
- package MyModel::company; |
|
596 |
- use DBIx::Custom::Model -base; |
|
597 |
- |
|
598 |
- has primary_key => sub { ['id'] }; |
|
599 |
- |
|
600 |
- sub insert { ... } |
|
601 |
- sub list { ... } |
|
602 |
- |
|
603 |
-=cut |
... | ... |
@@ -1,13 +0,0 @@ |
1 |
-=encoding utf8 |
|
2 |
- |
|
3 |
-=head1 NAME |
|
4 |
- |
|
5 |
-DBIx::Custom::Guide - DBIx::Customガイド |
|
6 |
- |
|
7 |
-=head1 LINK |
|
8 |
- |
|
9 |
-ドキュメントは以下のリンクに移動しました。 |
|
10 |
- |
|
11 |
-L<http://d.hatena.ne.jp/perlcodesample/20110401/1305597081> |
|
12 |
- |
|
13 |
-=cut |
... | ... |
@@ -1,247 +0,0 @@ |
1 |
-package DBIx::Custom::Model; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util '_subname'; |
|
6 |
- |
|
7 |
-# Carp trust relationship |
|
8 |
-push @DBIx::Custom::CARP_NOT, __PACKAGE__; |
|
9 |
- |
|
10 |
-has [qw/dbi table/], |
|
11 |
- bind_type => sub { [] }, |
|
12 |
- columns => sub { [] }, |
|
13 |
- join => sub { [] }, |
|
14 |
- primary_key => sub { [] }; |
|
15 |
- |
|
16 |
-our $AUTOLOAD; |
|
17 |
- |
|
18 |
-sub AUTOLOAD { |
|
19 |
- my $self = shift; |
|
20 |
- |
|
21 |
- # Method name |
|
22 |
- my ($package, $mname) = $AUTOLOAD =~ /^([\w\:]+)\:\:(\w+)$/; |
|
23 |
- |
|
24 |
- # Method |
|
25 |
- $self->{_methods} ||= {}; |
|
26 |
- if (my $method = $self->{_methods}->{$mname}) { |
|
27 |
- return $self->$method(@_) |
|
28 |
- } |
|
29 |
- elsif (my $dbi_method = $self->dbi->can($mname)) { |
|
30 |
- $self->dbi->$dbi_method(@_); |
|
31 |
- } |
|
32 |
- elsif ($self->{dbh} && (my $dbh_method = $self->dbh->can($mname))) { |
|
33 |
- $self->dbi->dbh->$dbh_method(@_); |
|
34 |
- } |
|
35 |
- else { |
|
36 |
- croak qq{Can't locate object method "$mname" via "$package" } |
|
37 |
- . _subname; |
|
38 |
- } |
|
39 |
-} |
|
40 |
- |
|
41 |
-my @methods = qw/insert insert_at update update_at update_all |
|
42 |
- delete delete_at delete_all select select_at/; |
|
43 |
-foreach my $method (@methods) { |
|
44 |
- |
|
45 |
- my $code = sub { |
|
46 |
- my $self = shift; |
|
47 |
- |
|
48 |
- my @args = ( |
|
49 |
- table => $self->table, |
|
50 |
- bind_type => $self->bind_type, |
|
51 |
- primary_key => $self->primary_key, |
|
52 |
- type => $self->type, # DEPRECATED! |
|
53 |
- ); |
|
54 |
- push @args, (join => $self->join) if $method =~ /^select/; |
|
55 |
- unshift @args, shift if @_ % 2; |
|
56 |
- |
|
57 |
- $self->dbi->$method(@args, @_); |
|
58 |
- }; |
|
59 |
- |
|
60 |
- no strict 'refs'; |
|
61 |
- my $class = __PACKAGE__; |
|
62 |
- *{"${class}::$method"} = $code; |
|
63 |
-} |
|
64 |
- |
|
65 |
-sub DESTROY { } |
|
66 |
- |
|
67 |
-sub method { |
|
68 |
- my $self = shift; |
|
69 |
- |
|
70 |
- # Merge |
|
71 |
- my $methods = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
72 |
- $self->{_methods} = {%{$self->{_methods} || {}}, %$methods}; |
|
73 |
- |
|
74 |
- return $self; |
|
75 |
-} |
|
76 |
- |
|
77 |
-sub mycolumn { |
|
78 |
- my $self = shift; |
|
79 |
- my $table = shift unless ref $_[0]; |
|
80 |
- my $columns = shift; |
|
81 |
- |
|
82 |
- $table ||= $self->table || ''; |
|
83 |
- $columns ||= $self->columns; |
|
84 |
- |
|
85 |
- return $self->dbi->mycolumn($table, $columns); |
|
86 |
-} |
|
87 |
- |
|
88 |
-sub new { |
|
89 |
- my $self = shift->SUPER::new(@_); |
|
90 |
- |
|
91 |
- # Check attribute names |
|
92 |
- my @attrs = keys %$self; |
|
93 |
- foreach my $attr (@attrs) { |
|
94 |
- croak qq{"$attr" is invalid attribute name } . _subname |
|
95 |
- unless $self->can($attr); |
|
96 |
- } |
|
97 |
- |
|
98 |
- return $self; |
|
99 |
-} |
|
100 |
- |
|
101 |
-# DEPRECATED! |
|
102 |
-has 'filter'; |
|
103 |
-has 'name'; |
|
104 |
-has type => sub { [] }; |
|
105 |
- |
|
106 |
-1; |
|
107 |
- |
|
108 |
-=head1 NAME |
|
109 |
- |
|
110 |
-DBIx::Custom::Model - Model |
|
111 |
- |
|
112 |
-=head1 SYNOPSIS |
|
113 |
- |
|
114 |
-use DBIx::Custom::Table; |
|
115 |
- |
|
116 |
-my $table = DBIx::Custom::Model->new(table => 'books'); |
|
117 |
- |
|
118 |
-=head1 ATTRIBUTES |
|
119 |
- |
|
120 |
-=head2 C<dbi> |
|
121 |
- |
|
122 |
- my $dbi = $model->dbi; |
|
123 |
- $model = $model->dbi($dbi); |
|
124 |
- |
|
125 |
-L<DBIx::Custom> object. |
|
126 |
- |
|
127 |
-=head2 C<join> |
|
128 |
- |
|
129 |
- my $join = $model->join; |
|
130 |
- $model = $model->join( |
|
131 |
- ['left outer join company on book.company_id = company.id'] |
|
132 |
- ); |
|
133 |
- |
|
134 |
-Join clause, this value is passed to C<select> method. |
|
135 |
- |
|
136 |
-=head2 C<primary_key> |
|
137 |
- |
|
138 |
- my $primary_key = $model->primary_key; |
|
139 |
- $model = $model->primary_key(['id', 'number']); |
|
140 |
- |
|
141 |
-Primary key,this is passed to C<insert>, C<update>, |
|
142 |
-C<delete>, and C<select> method. |
|
143 |
- |
|
144 |
-=head2 C<table> |
|
145 |
- |
|
146 |
- my $table = $model->table; |
|
147 |
- $model = $model->table('book'); |
|
148 |
- |
|
149 |
-Table name, this is passed to C<select> method. |
|
150 |
- |
|
151 |
-=head2 C<bind_type> |
|
152 |
- |
|
153 |
- my $type = $model->bind_type; |
|
154 |
- $model = $model->bind_type(['image' => DBI::SQL_BLOB]); |
|
155 |
- |
|
156 |
-Database data type, this is used as type optioon of C<insert>, |
|
157 |
-C<update>, C<update_all>, C<delete>, C<delete_all>, |
|
158 |
-C<select>, and C<execute> method |
|
159 |
- |
|
160 |
-=head1 METHODS |
|
161 |
- |
|
162 |
-L<DBIx::Custom::Model> inherits all methods from L<Object::Simple>, |
|
163 |
-and you can use all methods of L<DBIx::Custom> and L<DBI> |
|
164 |
-and implements the following new ones. |
|
165 |
- |
|
166 |
-=head2 C<delete> |
|
167 |
- |
|
168 |
- $table->delete(...); |
|
169 |
- |
|
170 |
-Same as C<delete> of L<DBIx::Custom> except that |
|
171 |
-you don't have to specify C<table> option. |
|
172 |
- |
|
173 |
-=head2 C<delete_all> |
|
174 |
- |
|
175 |
- $table->delete_all(...); |
|
176 |
- |
|
177 |
-Same as C<delete_all> of L<DBIx::Custom> except that |
|
178 |
-you don't have to specify C<table> option. |
|
179 |
- |
|
180 |
-=head2 C<insert> |
|
181 |
- |
|
182 |
- $table->insert(...); |
|
183 |
- |
|
184 |
-Same as C<insert> of L<DBIx::Custom> except that |
|
185 |
-you don't have to specify C<table> option. |
|
186 |
- |
|
187 |
-=head2 C<method> |
|
188 |
- |
|
189 |
- $model->method( |
|
190 |
- update_or_insert => sub { |
|
191 |
- my $self = shift; |
|
192 |
- |
|
193 |
- # ... |
|
194 |
- }, |
|
195 |
- find_or_create => sub { |
|
196 |
- my $self = shift; |
|
197 |
- |
|
198 |
- # ... |
|
199 |
- ); |
|
200 |
- |
|
201 |
-Register method. These method is called directly from L<DBIx::Custom::Model> object. |
|
202 |
- |
|
203 |
- $model->update_or_insert; |
|
204 |
- $model->find_or_create; |
|
205 |
- |
|
206 |
-=head2 C<mycolumn> |
|
207 |
- |
|
208 |
- my $column = $self->mycolumn; |
|
209 |
- my $column = $self->mycolumn(book => ['author', 'title']); |
|
210 |
- my $column = $self->mycolumn(['author', 'title']); |
|
211 |
- |
|
212 |
-Create column clause for myself. The follwoing column clause is created. |
|
213 |
- |
|
214 |
- book.author as author, |
|
215 |
- book.title as title |
|
216 |
- |
|
217 |
-If table name is ommited, C<table> attribute of the model is used. |
|
218 |
-If column names is omitted, C<columns> attribute of the model is used. |
|
219 |
- |
|
220 |
-=head2 C<new> |
|
221 |
- |
|
222 |
- my $table = DBIx::Custom::Table->new; |
|
223 |
- |
|
224 |
-Create a L<DBIx::Custom::Table> object. |
|
225 |
- |
|
226 |
-=head2 C<select> |
|
227 |
- |
|
228 |
- $table->select(...); |
|
229 |
- |
|
230 |
-Same as C<select> of L<DBIx::Custom> except that |
|
231 |
-you don't have to specify C<table> option. |
|
232 |
- |
|
233 |
-=head2 C<update> |
|
234 |
- |
|
235 |
- $table->update(...); |
|
236 |
- |
|
237 |
-Same as C<update> of L<DBIx::Custom> except that |
|
238 |
-you don't have to specify C<table> option. |
|
239 |
- |
|
240 |
-=head2 C<update_all> |
|
241 |
- |
|
242 |
- $table->update_all(param => \%param); |
|
243 |
- |
|
244 |
-Same as C<update_all> of L<DBIx::Custom> except that |
|
245 |
-you don't have to specify table name. |
|
246 |
- |
|
247 |
-=cut |
... | ... |
@@ -1,108 +0,0 @@ |
1 |
-package DBIx::Custom::Order; |
|
2 |
-use Object::Simple -base; |
|
3 |
-use overload |
|
4 |
- 'bool' => sub {1}, |
|
5 |
- '""' => sub { shift->to_string }, |
|
6 |
- fallback => 1; |
|
7 |
- |
|
8 |
-has 'dbi', |
|
9 |
- orders => sub { [] }; |
|
10 |
- |
|
11 |
-sub prepend { |
|
12 |
- my $self = shift; |
|
13 |
- |
|
14 |
- foreach my $order (reverse @_) { |
|
15 |
- if (ref $order eq 'ARRAY') { |
|
16 |
- my $column = shift @$order; |
|
17 |
- $column = $self->dbi->_q($column) if defined $column; |
|
18 |
- my $derection = shift @$order; |
|
19 |
- $order = $column; |
|
20 |
- $order .= " $derection" if $derection; |
|
21 |
- } |
|
22 |
- unshift @{$self->orders}, $order; |
|
23 |
- } |
|
24 |
- |
|
25 |
- return $self; |
|
26 |
-} |
|
27 |
- |
|
28 |
-sub to_string { |
|
29 |
- my $self = shift; |
|
30 |
- |
|
31 |
- my $exists = {}; |
|
32 |
- my @orders; |
|
33 |
- foreach my $order (@{$self->orders}) { |
|
34 |
- next unless defined $order; |
|
35 |
- $order =~ s/^\s+//; |
|
36 |
- $order =~ s/\s+$//; |
|
37 |
- my ($column, $direction) = split /\s+/, $order; |
|
38 |
- push @orders, $order unless $exists->{$column}; |
|
39 |
- $exists->{$column} = 1; |
|
40 |
- } |
|
41 |
- |
|
42 |
- return '' unless @orders; |
|
43 |
- return 'order by ' . join(', ', @orders); |
|
44 |
-} |
|
45 |
- |
|
46 |
-1; |
|
47 |
- |
|
48 |
-=head1 NAME |
|
49 |
- |
|
50 |
-DBIx::Custom::Order - Order by EXPERIMENTAL |
|
51 |
- |
|
52 |
-=head1 SYNOPSIS |
|
53 |
- |
|
54 |
- # Result |
|
55 |
- my $order = DBIx::Custom::Order->new; |
|
56 |
- $order->prepend('title', 'author desc'); |
|
57 |
- my $order_by = "$order"; |
|
58 |
- |
|
59 |
-=head1 ATTRIBUTES |
|
60 |
- |
|
61 |
-=head2 C<dbi> |
|
62 |
- |
|
63 |
- my $dbi = $order->dbi; |
|
64 |
- $order = $order->dbi($dbi); |
|
65 |
- |
|
66 |
-L<DBIx::Custom> object. |
|
67 |
- |
|
68 |
-=head2 C<orders> |
|
69 |
- |
|
70 |
- my $orders = $result->orders; |
|
71 |
- $result = $result->orders(\%orders); |
|
72 |
- |
|
73 |
-Parts of order by clause |
|
74 |
- |
|
75 |
-=head1 METHODS |
|
76 |
- |
|
77 |
-L<DBIx::Custom::Result> inherits all methods from L<Object::Simple> |
|
78 |
-and implements the following new ones. |
|
79 |
- |
|
80 |
-=head2 C<prepend> |
|
81 |
- |
|
82 |
- $order->prepend('title', 'author desc'); |
|
83 |
- |
|
84 |
-Prepend order parts to C<orders>. |
|
85 |
- |
|
86 |
-You can pass array reference, which contain column name and direction. |
|
87 |
-Column name is quoted properly |
|
88 |
- |
|
89 |
- # Column name and direction |
|
90 |
- $order->prepend(['book-title']); |
|
91 |
- $order->prepend([qw/book-title desc/]); |
|
92 |
- |
|
93 |
-This is expanded to the following way. |
|
94 |
- |
|
95 |
- "book-title" |
|
96 |
- "book-title" desc |
|
97 |
- |
|
98 |
-=head2 C<to_string> |
|
99 |
- |
|
100 |
- my $order_by = $order->to_string; |
|
101 |
- |
|
102 |
-Create order by clause. If column name is duplicated, First one is used. |
|
103 |
-C<to_string> override stringification. so you can write the follwoing way. |
|
104 |
- |
|
105 |
- my $order_by = "$order"; |
|
106 |
- |
|
107 |
-=cut |
|
108 |
- |
... | ... |
@@ -1,116 +0,0 @@ |
1 |
-package DBIx::Custom::Query; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util '_subname'; |
|
6 |
- |
|
7 |
-has 'sth', |
|
8 |
- sql => '', |
|
9 |
- columns => sub { [] }; |
|
10 |
- |
|
11 |
-# DEPRECATED! |
|
12 |
-has 'default_filter'; |
|
13 |
-sub filters { |
|
14 |
- warn "DBIx::Custom::Query filters attribute method is DEPRECATED!"; |
|
15 |
- my $self = shift; |
|
16 |
- if (@_) { |
|
17 |
- $self->{filters} = $_[0]; |
|
18 |
- return $self; |
|
19 |
- } |
|
20 |
- return $self->{filters}; |
|
21 |
-} |
|
22 |
- |
|
23 |
-# DEPRECATED! |
|
24 |
-sub tables { |
|
25 |
- warn "DBIx::Custom::Query tables attribute method is DEPRECATED!"; |
|
26 |
- my $self = shift; |
|
27 |
- if (@_) { |
|
28 |
- $self->{tables} = $_[0]; |
|
29 |
- return $self; |
|
30 |
- } |
|
31 |
- return $self->{tables} ||= []; |
|
32 |
-} |
|
33 |
- |
|
34 |
-#DEPRECATED! |
|
35 |
-sub filter { |
|
36 |
- Carp::carp "DBIx::Custom::Query filter method is DEPRECATED!"; |
|
37 |
- my $self = shift; |
|
38 |
- if (@_) { |
|
39 |
- my $filter = {}; |
|
40 |
- if (ref $_[0] eq 'HASH') { |
|
41 |
- $filter = $_[0]; |
|
42 |
- } |
|
43 |
- else { |
|
44 |
- my $ef = @_ > 1 ? [@_] : $_[0]; |
|
45 |
- for (my $i = 0; $i < @$ef; $i += 2) { |
|
46 |
- my $column = $ef->[$i]; |
|
47 |
- my $f = $ef->[$i + 1]; |
|
48 |
- if (ref $column eq 'ARRAY') { |
|
49 |
- foreach my $c (@$column) { |
|
50 |
- $filter->{$c} = $f; |
|
51 |
- } |
|
52 |
- } |
|
53 |
- else { |
|
54 |
- $filter->{$column} = $f; |
|
55 |
- } |
|
56 |
- } |
|
57 |
- } |
|
58 |
- foreach my $column (keys %$filter) { |
|
59 |
- my $fname = $filter->{$column}; |
|
60 |
- if (exists $filter->{$column} |
|
61 |
- && defined $fname |
|
62 |
- && ref $fname ne 'CODE') |
|
63 |
- { |
|
64 |
- my $filters = $self->{filters} || {}; |
|
65 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
66 |
- unless exists $filters->{$fname}; |
|
67 |
- $filter->{$column} = $filters->{$fname}; |
|
68 |
- } |
|
69 |
- } |
|
70 |
- $self->{filter} = {%{$self->{filter} || {}}, %$filter}; |
|
71 |
- return $self; |
|
72 |
- } |
|
73 |
- return $self->{filter} ||= {}; |
|
74 |
-} |
|
75 |
- |
|
76 |
-1; |
|
77 |
- |
|
78 |
-=head1 NAME |
|
79 |
- |
|
80 |
-DBIx::Custom::Query - Query |
|
81 |
- |
|
82 |
-=head1 SYNOPSIS |
|
83 |
- |
|
84 |
- my $query = DBIx::Custom::Query->new; |
|
85 |
- my $sth = $query->sth; |
|
86 |
- my $sql = $query->sql; |
|
87 |
- my $columns = $query->columns; |
|
88 |
- |
|
89 |
-=head1 ATTRIBUTES |
|
90 |
- |
|
91 |
-=head2 C<columns> |
|
92 |
- |
|
93 |
- my $columns = $query->columns; |
|
94 |
- $query = $query->columns(['auhtor', 'title']); |
|
95 |
- |
|
96 |
-Column names. |
|
97 |
- |
|
98 |
-=head2 C<sql> |
|
99 |
- |
|
100 |
- my $sql = $query->sql; |
|
101 |
- $query = $query->sql('select * from books where author = ?;'); |
|
102 |
- |
|
103 |
-SQL statement. |
|
104 |
- |
|
105 |
-=head2 C<sth> |
|
106 |
- |
|
107 |
- my $sth = $query->sth; |
|
108 |
- $query = $query->sth($sth); |
|
109 |
- |
|
110 |
-Statement handle of L<DBI> |
|
111 |
- |
|
112 |
-=head1 METHODS |
|
113 |
- |
|
114 |
-L<DBIx::Custom::Query> inherits all methods from L<Object::Simple>. |
|
115 |
- |
|
116 |
-=cut |
... | ... |
@@ -1,329 +0,0 @@ |
1 |
-package DBIx::Custom::QueryBuilder; |
|
2 |
- |
|
3 |
-use Object::Simple -base; |
|
4 |
- |
|
5 |
-use Carp 'croak'; |
|
6 |
-use DBIx::Custom::Query; |
|
7 |
-use DBIx::Custom::Util '_subname'; |
|
8 |
- |
|
9 |
-# Carp trust relationship |
|
10 |
-push @DBIx::Custom::CARP_NOT, __PACKAGE__; |
|
11 |
-push @DBIx::Custom::Where::CARP_NOT, __PACKAGE__; |
|
12 |
- |
|
13 |
-has 'dbi'; |
|
14 |
- |
|
15 |
-sub build_query { |
|
16 |
- my ($self, $source) = @_; |
|
17 |
- |
|
18 |
- my $query; |
|
19 |
- |
|
20 |
- # Parse tag. tag is DEPRECATED! |
|
21 |
- if ($self->dbi->tag_parse && $source =~ /(\s|^)\{/) { |
|
22 |
- $query = $self->_parse_tag($source); |
|
23 |
- my $tag_count = delete $query->{tag_count}; |
|
24 |
- warn qq/Tag system such as {? name} is DEPRECATED! / . |
|
25 |
- qq/use parameter system such as :name instead/ |
|
26 |
- if $tag_count; |
|
27 |
- my $query2 = $self->_parse_parameter($query->sql); |
|
28 |
- $query->sql($query2->sql); |
|
29 |
- for (my $i =0; $i < @{$query->columns}; $i++) { |
|
30 |
- my $column = $query->columns->[$i]; |
|
31 |
- if ($column eq 'RESERVED_PARAMETER') { |
|
32 |
- my $column2 = shift @{$query2->columns}; |
|
33 |
- croak ":name syntax is wrong" |
|
34 |
- unless defined $column2; |
|
35 |
- $query->columns->[$i] = $column2; |
|
36 |
- } |
|
37 |
- } |
|
38 |
- } |
|
39 |
- |
|
40 |
- # Parse parameter |
|
41 |
- else { $query = $self->_parse_parameter($source) } |
|
42 |
- |
|
43 |
- my $sql = $query->sql; |
|
44 |
- $sql .= ';' unless $source =~ /;$/; |
|
45 |
- $query->sql($sql); |
|
46 |
- |
|
47 |
- # Check placeholder count |
|
48 |
- croak qq{Placeholder count in "$sql" must be same as column count} |
|
49 |
- . _subname |
|
50 |
- unless $self->_placeholder_count($sql) eq @{$query->columns}; |
|
51 |
- |
|
52 |
- return $query; |
|
53 |
-} |
|
54 |
- |
|
55 |
-sub _placeholder_count { |
|
56 |
- my ($self, $sql) = @_; |
|
57 |
- |
|
58 |
- # Count |
|
59 |
- $sql ||= ''; |
|
60 |
- my $count = 0; |
|
61 |
- my $pos = -1; |
|
62 |
- while (($pos = index($sql, '?', $pos + 1)) != -1) { |
|
63 |
- $count++; |
|
64 |
- } |
|
65 |
- return $count; |
|
66 |
-} |
|
67 |
- |
|
68 |
-sub _parse_parameter { |
|
69 |
- my ($self, $source) = @_; |
|
70 |
- |
|
71 |
- # Get and replace parameters |
|
72 |
- my $sql = $source || ''; |
|
73 |
- my $columns = []; |
|
74 |
- my $c = $self->dbi->safety_character; |
|
75 |
- # Parameter regex |
|
76 |
- $sql =~ s/([^:]):(\d+):([^:])/$1\\:$2\\:$3/g; |
|
77 |
- my $re = qr/(^|.*?[^\\]):([$c\.]+)(?:\{(.*?)\})?(.*)/s; |
|
78 |
- while ($sql =~ /$re/g) { |
|
79 |
- push @$columns, $2; |
|
80 |
- $sql = defined $3 ? "$1$2 $3 ?$4" : "$1?$4"; |
|
81 |
- } |
|
82 |
- $sql =~ s/\\:/:/g; |
|
83 |
- |
|
84 |
- # Create query |
|
85 |
- my $query = DBIx::Custom::Query->new( |
|
86 |
- sql => $sql, |
|
87 |
- columns => $columns |
|
88 |
- ); |
|
89 |
- |
|
90 |
- return $query; |
|
91 |
-} |
|
92 |
- |
|
93 |
-# DEPRECATED! |
|
94 |
-has tags => sub { {} }; |
|
95 |
- |
|
96 |
-# DEPRECATED! |
|
97 |
-sub register_tag { |
|
98 |
- my $self = shift; |
|
99 |
- |
|
100 |
- warn "register_tag is DEPRECATED!"; |
|
101 |
- |
|
102 |
- # Merge tag |
|
103 |
- my $tags = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
104 |
- $self->tags({%{$self->tags}, %$tags}); |
|
105 |
- |
|
106 |
- return $self; |
|
107 |
-} |
|
108 |
- |
|
109 |
-# DEPRECATED! |
|
110 |
-sub _parse_tag { |
|
111 |
- my ($self, $source) = @_; |
|
112 |
- # Source |
|
113 |
- $source ||= ''; |
|
114 |
- # Tree |
|
115 |
- my @tree; |
|
116 |
- # Value |
|
117 |
- my $value = ''; |
|
118 |
- # State |
|
119 |
- my $state = 'text'; |
|
120 |
- # Before charactor |
|
121 |
- my $before = ''; |
|
122 |
- # Position |
|
123 |
- my $pos = 0; |
|
124 |
- # Parse |
|
125 |
- my $original = $source; |
|
126 |
- my $tag_count = 0; |
|
127 |
- while (defined(my $c = substr($source, $pos, 1))) { |
|
128 |
- # Last |
|
129 |
- last unless length $c; |
|
130 |
- # Parameter |
|
131 |
- if ($c eq ':' && (substr($source, $pos + 1, 1) || '') =~ /\w/) { |
|
132 |
- push @tree, {type => 'param'};; |
|
133 |
- } |
|
134 |
- # State is text |
|
135 |
- if ($state eq 'text') { |
|
136 |
- # Tag start charactor |
|
137 |
- if ($c eq '{') { |
|
138 |
- # Escaped charactor |
|
139 |
- if ($before eq "\\") { |
|
140 |
- substr($value, -1, 1, ''); |
|
141 |
- $value .= $c; |
|
142 |
- } |
|
143 |
- # Tag start |
|
144 |
- else { |
|
145 |
- # Change state |
|
146 |
- $state = 'tag'; |
|
147 |
- # Add text |
|
148 |
- push @tree, {type => 'text', value => $value} |
|
149 |
- if $value; |
|
150 |
- # Clear |
|
151 |
- $value = ''; |
|
152 |
- } |
|
153 |
- } |
|
154 |
- # Tag end charactor |
|
155 |
- elsif ($c eq '}') { |
|
156 |
- # Escaped charactor |
|
157 |
- if ($before eq "\\") { |
|
158 |
- substr($value, -1, 1, ''); |
|
159 |
- $value .= $c; |
|
160 |
- } |
|
161 |
- # Unexpected |
|
162 |
- else { |
|
163 |
- croak qq{Parsing error. unexpected "\}". } |
|
164 |
- . qq{pos $pos of "$original" } . _subname |
|
165 |
- } |
|
166 |
- } |
|
167 |
- # Normal charactor |
|
168 |
- else { $value .= $c } |
|
169 |
- } |
|
170 |
- # State is tags |
|
171 |
- else { |
|
172 |
- # Tag start charactor |
|
173 |
- if ($c eq '{') { |
|
174 |
- # Escaped charactor |
|
175 |
- if ($before eq "\\") { |
|
176 |
- substr($value, -1, 1, ''); |
|
177 |
- $value .= $c; |
|
178 |
- } |
|
179 |
- # Unexpected |
|
180 |
- else { |
|
181 |
- croak qq{Parsing error. unexpected "\{". } |
|
182 |
- . qq{pos $pos of "$original" } . _subname |
|
183 |
- } |
|
184 |
- } |
|
185 |
- # Tag end charactor |
|
186 |
- elsif ($c eq '}') { |
|
187 |
- # Escaped charactor |
|
188 |
- if ($before eq "\\") { |
|
189 |
- substr($value, -1, 1, ''); |
|
190 |
- $value .= $c; |
|
191 |
- } |
|
192 |
- # Tag end |
|
193 |
- else { |
|
194 |
- # Change state |
|
195 |
- $state = 'text'; |
|
196 |
- # Add tag |
|
197 |
- my ($tag_name, @tag_args) = split /\s+/, $value; |
|
198 |
- push @tree, {type => 'tag', tag_name => $tag_name, |
|
199 |
- tag_args => \@tag_args}; |
|
200 |
- # Clear |
|
201 |
- $value = ''; |
|
202 |
- # Countup |
|
203 |
- $tag_count++; |
|
204 |
- } |
|
205 |
- } |
|
206 |
- # Normal charactor |
|
207 |
- else { $value .= $c } |
|
208 |
- } |
|
209 |
- # Save before charactor |
|
210 |
- $before = $c; |
|
211 |
- # increment position |
|
212 |
- $pos++; |
|
213 |
- } |
|
214 |
- # Tag not finished |
|
215 |
- croak qq{Tag not finished. "$original" } . _subname |
|
216 |
- if $state eq 'tag'; |
|
217 |
- # Not contains tag |
|
218 |
- return DBIx::Custom::Query->new(sql => $source, tag_count => $tag_count) |
|
219 |
- if $tag_count == 0; |
|
220 |
- # Add rest text |
|
221 |
- push @tree, {type => 'text', value => $value} |
|
222 |
- if $value; |
|
223 |
- # SQL |
|
224 |
- my $sql = ''; |
|
225 |
- # All Columns |
|
226 |
- my $all_columns = []; |
|
227 |
- # Tables |
|
228 |
- my $tables = []; |
|
229 |
- # Build SQL |
|
230 |
- foreach my $node (@tree) { |
|
231 |
- # Text |
|
232 |
- if ($node->{type} eq 'text') { $sql .= $node->{value} } |
|
233 |
- # Parameter |
|
234 |
- elsif ($node->{type} eq 'param') { |
|
235 |
- push @$all_columns, 'RESERVED_PARAMETER'; |
|
236 |
- } |
|
237 |
- # Tag |
|
238 |
- else { |
|
239 |
- # Tag name |
|
240 |
- my $tag_name = $node->{tag_name}; |
|
241 |
- # Tag arguments |
|
242 |
- my $tag_args = $node->{tag_args}; |
|
243 |
- # Table |
|
244 |
- if ($tag_name eq 'table') { |
|
245 |
- my $table = $tag_args->[0]; |
|
246 |
- push @$tables, $table; |
|
247 |
- $sql .= $table; |
|
248 |
- next; |
|
249 |
- } |
|
250 |
- # Get tag |
|
251 |
- my $tag = $self->tag_processors->{$tag_name} |
|
252 |
- || $self->tags->{$tag_name}; |
|
253 |
- # Tag is not registered |
|
254 |
- croak qq{Tag "$tag_name" is not registered } . _subname |
|
255 |
- unless $tag; |
|
256 |
- # Tag not sub reference |
|
257 |
- croak qq{Tag "$tag_name" must be sub reference } . _subname |
|
258 |
- unless ref $tag eq 'CODE'; |
|
259 |
- # Execute tag |
|
260 |
- my $r = $tag->(@$tag_args); |
|
261 |
- # Check tag return value |
|
262 |
- croak qq{Tag "$tag_name" must return [STRING, ARRAY_REFERENCE] } |
|
263 |
- . _subname |
|
264 |
- unless ref $r eq 'ARRAY' && defined $r->[0] && ref $r->[1] eq 'ARRAY'; |
|
265 |
- # Part of SQL statement and colum names |
|
266 |
- my ($part, $columns) = @$r; |
|
267 |
- # Add columns |
|
268 |
- push @$all_columns, @$columns; |
|
269 |
- # Join part tag to SQL |
|
270 |
- $sql .= $part; |
|
271 |
- } |
|
272 |
- } |
|
273 |
- # Query |
|
274 |
- my $query = DBIx::Custom::Query->new( |
|
275 |
- sql => $sql, |
|
276 |
- columns => $all_columns, |
|
277 |
- tables => $tables, |
|
278 |
- tag_count => $tag_count |
|
279 |
- ); |
|
280 |
- return $query; |
|
281 |
-} |
|
282 |
- |
|
283 |
-# DEPRECATED! |
|
284 |
-has tag_processors => sub { {} }; |
|
285 |
- |
|
286 |
-# DEPRECATED! |
|
287 |
-sub register_tag_processor { |
|
288 |
- my $self = shift; |
|
289 |
- warn "register_tag_processor is DEPRECATED!"; |
|
290 |
- # Merge tag |
|
291 |
- my $tag_processors = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
292 |
- $self->tag_processors({%{$self->tag_processors}, %{$tag_processors}}); |
|
293 |
- return $self; |
|
294 |
-} |
|
295 |
- |
|
296 |
-1; |
|
297 |
- |
|
298 |
-=head1 NAME |
|
299 |
- |
|
300 |
-DBIx::Custom::QueryBuilder - Query builder |
|
301 |
- |
|
302 |
-=head1 SYNOPSIS |
|
303 |
- |
|
304 |
- my $builder = DBIx::Custom::QueryBuilder->new; |
|
305 |
- my $query = $builder->build_query( |
|
306 |
- "select from table title = :title and author = :author" |
|
307 |
- ); |
|
308 |
- |
|
309 |
-=head1 ATTRIBUTES |
|
310 |
- |
|
311 |
-=head2 C<dbi> |
|
312 |
- |
|
313 |
- my $dbi = $builder->dbi; |
|
314 |
- $builder = $builder->dbi($dbi); |
|
315 |
- |
|
316 |
-L<DBIx::Custom> object. |
|
317 |
- |
|
318 |
-=head1 METHODS |
|
319 |
- |
|
320 |
-L<DBIx::Custom::QueryBuilder> inherits all methods from L<Object::Simple> |
|
321 |
-and implements the following new ones. |
|
322 |
- |
|
323 |
-=head2 C<build_query> |
|
324 |
- |
|
325 |
- my $query = $builder->build_query($source); |
|
326 |
- |
|
327 |
-Create a new L<DBIx::Custom::Query> object from SQL source. |
|
328 |
- |
|
329 |
-=cut |
... | ... |
@@ -1,573 +0,0 @@ |
1 |
-package DBIx::Custom::Result; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util qw/_array_to_hash _subname/; |
|
6 |
- |
|
7 |
-has [qw/dbi sth/], |
|
8 |
- stash => sub { {} }; |
|
9 |
- |
|
10 |
-*all = \&fetch_hash_all; |
|
11 |
- |
|
12 |
-sub filter { |
|
13 |
- my $self = shift; |
|
14 |
- |
|
15 |
- # Set |
|
16 |
- if (@_) { |
|
17 |
- |
|
18 |
- # Convert filter name to subroutine |
|
19 |
- my $filter = @_ == 1 ? $_[0] : [@_]; |
|
20 |
- $filter = _array_to_hash($filter); |
|
21 |
- foreach my $column (keys %$filter) { |
|
22 |
- my $fname = $filter->{$column}; |
|
23 |
- if (exists $filter->{$column} |
|
24 |
- && defined $fname |
|
25 |
- && ref $fname ne 'CODE') |
|
26 |
- { |
|
27 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
28 |
- unless exists $self->dbi->filters->{$fname}; |
|
29 |
- $filter->{$column} = $self->dbi->filters->{$fname}; |
|
30 |
- } |
|
31 |
- } |
|
32 |
- |
|
33 |
- # Merge |
|
34 |
- $self->{filter} = {%{$self->filter}, %$filter}; |
|
35 |
- |
|
36 |
- return $self; |
|
37 |
- } |
|
38 |
- |
|
39 |
- return $self->{filter} ||= {}; |
|
40 |
-} |
|
41 |
- |
|
42 |
-sub filter_off { |
|
43 |
- my $self = shift; |
|
44 |
- $self->{filter_off} = 1; |
|
45 |
- return $self; |
|
46 |
-} |
|
47 |
- |
|
48 |
-sub filter_on { |
|
49 |
- my $self = shift; |
|
50 |
- $self->{filter_off} = 0; |
|
51 |
- return $self; |
|
52 |
-} |
|
53 |
- |
|
54 |
-sub fetch { |
|
55 |
- my $self = shift; |
|
56 |
- |
|
57 |
- # Info |
|
58 |
- my $columns = $self->{sth}->{NAME}; |
|
59 |
- my $types = $self->{sth}->{TYPE}; |
|
60 |
- |
|
61 |
- # Fetch |
|
62 |
- my @row = $self->{sth}->fetchrow_array; |
|
63 |
- return unless @row; |
|
64 |
- |
|
65 |
- # Filtering |
|
66 |
- my $type_rule1 = $self->type_rule->{from1} || {}; |
|
67 |
- my $type_rule2 = $self->type_rule->{from2} || {}; |
|
68 |
- my $filter = $self->filter; |
|
69 |
- my $end_filter = $self->{end_filter} || {}; |
|
70 |
- for (my $i = 0; $i < @$columns; $i++) { |
|
71 |
- |
|
72 |
- # Column |
|
73 |
- my $column = $columns->[$i]; |
|
74 |
- |
|
75 |
- # Type rule |
|
76 |
- my $type_filter1 = $type_rule1->{lc($types->[$i])}; |
|
77 |
- $row[$i] = $type_filter1->($row[$i]) |
|
78 |
- if $type_filter1 && !$self->{type_rule_off} |
|
79 |
- && !$self->{type_rule1_off}; |
|
80 |
- my $type_filter2 = $type_rule2->{lc($types->[$i])}; |
|
81 |
- $row[$i] = $type_filter2->($row[$i]) |
|
82 |
- if $type_filter2 && !$self->{type_rule_off} |
|
83 |
- && !$self->{type_rule2_off}; |
|
84 |
- |
|
85 |
- # Filter |
|
86 |
- my $filter = $filter->{$column} || $self->{default_filter}; |
|
87 |
- $row[$i] = $filter->($row[$i]) |
|
88 |
- if $filter && !$self->{filter_off}; |
|
89 |
- $row[$i] = $end_filter->{$column}->($row[$i]) |
|
90 |
- if $end_filter->{$column} && !$self->{filter_off}; |
|
91 |
- } |
|
92 |
- |
|
93 |
- return \@row; |
|
94 |
-} |
|
95 |
- |
|
96 |
-sub fetch_all { |
|
97 |
- my $self = shift; |
|
98 |
- |
|
99 |
- # Fetch all rows |
|
100 |
- my $rows = []; |
|
101 |
- while(my $row = $self->fetch) { push @$rows, $row} |
|
102 |
- |
|
103 |
- return $rows; |
|
104 |
-} |
|
105 |
- |
|
106 |
-sub fetch_first { |
|
107 |
- my $self = shift; |
|
108 |
- |
|
109 |
- # Fetch |
|
110 |
- my $row = $self->fetch; |
|
111 |
- return unless $row; |
|
112 |
- |
|
113 |
- # Finish statement handle |
|
114 |
- $self->sth->finish; |
|
115 |
- |
|
116 |
- return $row; |
|
117 |
-} |
|
118 |
- |
|
119 |
-sub fetch_hash { |
|
120 |
- my $self = shift; |
|
121 |
- |
|
122 |
- # Info |
|
123 |
- my $columns = $self->{sth}->{NAME}; |
|
124 |
- my $types = $self->{sth}->{TYPE}; |
|
125 |
- |
|
126 |
- # Fetch |
|
127 |
- my $row = $self->{sth}->fetchrow_arrayref; |
|
128 |
- return unless $row; |
|
129 |
- |
|
130 |
- # Filter |
|
131 |
- my $hash_row = {}; |
|
132 |
- my $filter = $self->filter; |
|
133 |
- my $end_filter = $self->{end_filter} || {}; |
|
134 |
- my $type_rule1 = $self->type_rule->{from1} || {}; |
|
135 |
- my $type_rule2 = $self->type_rule->{from2} || {}; |
|
136 |
- for (my $i = 0; $i < @$columns; $i++) { |
|
137 |
- |
|
138 |
- # Column |
|
139 |
- my $column = $columns->[$i]; |
|
140 |
- $hash_row->{$column} = $row->[$i]; |
|
141 |
- |
|
142 |
- # Type rule |
|
143 |
- my $type_filter1 = $type_rule1->{lc($types->[$i])}; |
|
144 |
- $hash_row->{$column} = $type_filter1->($hash_row->{$column}) |
|
145 |
- if !$self->{type_rule_off} && !$self->{type_rule1_off} |
|
146 |
- && $type_filter1; |
|
147 |
- my $type_filter2 = $type_rule2->{lc($types->[$i])}; |
|
148 |
- $hash_row->{$column} = $type_filter2->($hash_row->{$column}) |
|
149 |
- if !$self->{type_rule_off} && !$self->{type_rule2_off} |
|
150 |
- && $type_filter2; |
|
151 |
- |
|
152 |
- # Filter |
|
153 |
- my $f = $filter->{$column} || $self->{default_filter}; |
|
154 |
- $hash_row->{$column} = $f->($hash_row->{$column}) |
|
155 |
- if $f && !$self->{filter_off}; |
|
156 |
- $hash_row->{$column} = $end_filter->{$column}->($hash_row->{$column}) |
|
157 |
- if $end_filter->{$column} && !$self->{filter_off}; |
|
158 |
- } |
|
159 |
- |
|
160 |
- return $hash_row; |
|
161 |
-} |
|
162 |
- |
|
163 |
-sub fetch_hash_all { |
|
164 |
- my $self = shift; |
|
165 |
- |
|
166 |
- # Fetch all rows as hash |
|
167 |
- my $rows = []; |
|
168 |
- while(my $row = $self->fetch_hash) { push @$rows, $row } |
|
169 |
- |
|
170 |
- return $rows; |
|
171 |
-} |
|
172 |
- |
|
173 |
-sub fetch_hash_first { |
|
174 |
- my $self = shift; |
|
175 |
- |
|
176 |
- # Fetch hash |
|
177 |
- my $row = $self->fetch_hash; |
|
178 |
- return unless $row; |
|
179 |
- |
|
180 |
- # Finish statement handle |
|
181 |
- $self->sth->finish; |
|
182 |
- |
|
183 |
- return $row; |
|
184 |
-} |
|
185 |
- |
|
186 |
-sub fetch_hash_multi { |
|
187 |
- my ($self, $count) = @_; |
|
188 |
- |
|
189 |
- # Fetch multiple rows |
|
190 |
- croak 'Row count must be specified ' . _subname |
|
191 |
- unless $count; |
|
192 |
- my $rows = []; |
|
193 |
- for (my $i = 0; $i < $count; $i++) { |
|
194 |
- my $row = $self->fetch_hash; |
|
195 |
- last unless $row; |
|
196 |
- push @$rows, $row; |
|
197 |
- } |
|
198 |
- |
|
199 |
- return unless @$rows; |
|
200 |
- return $rows; |
|
201 |
-} |
|
202 |
- |
|
203 |
-sub fetch_multi { |
|
204 |
- my ($self, $count) = @_; |
|
205 |
- |
|
206 |
- # Row count not specifed |
|
207 |
- croak 'Row count must be specified ' . _subname |
|
208 |
- unless $count; |
|
209 |
- |
|
210 |
- # Fetch multi rows |
|
211 |
- my $rows = []; |
|
212 |
- for (my $i = 0; $i < $count; $i++) { |
|
213 |
- my $row = $self->fetch; |
|
214 |
- last unless $row; |
|
215 |
- push @$rows, $row; |
|
216 |
- } |
|
217 |
- |
|
218 |
- return unless @$rows; |
|
219 |
- return $rows; |
|
220 |
-} |
|
221 |
- |
|
222 |
-sub header { shift->sth->{NAME} } |
|
223 |
- |
|
224 |
-*one = \&fetch_hash_first; |
|
225 |
- |
|
226 |
-sub type_rule { |
|
227 |
- my $self = shift; |
|
228 |
- |
|
229 |
- if (@_) { |
|
230 |
- my $type_rule = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
231 |
- |
|
232 |
- # From |
|
233 |
- foreach my $i (1 .. 2) { |
|
234 |
- $type_rule->{"from$i"} = _array_to_hash($type_rule->{"from$i"}); |
|
235 |
- foreach my $data_type (keys %{$type_rule->{"from$i"} || {}}) { |
|
236 |
- croak qq{data type of from$i section must be lower case or number} |
|
237 |
- if $data_type =~ /[A-Z]/; |
|
238 |
- my $fname = $type_rule->{"from$i"}{$data_type}; |
|
239 |
- if (defined $fname && ref $fname ne 'CODE') { |
|
240 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
241 |
- unless exists $self->dbi->filters->{$fname}; |
|
242 |
- |
|
243 |
- $type_rule->{"from$i"}{$data_type} = $self->dbi->filters->{$fname}; |
|
244 |
- } |
|
245 |
- } |
|
246 |
- } |
|
247 |
- $self->{type_rule} = $type_rule; |
|
248 |
- |
|
249 |
- return $self; |
|
250 |
- } |
|
251 |
- |
|
252 |
- return $self->{type_rule} || {}; |
|
253 |
-} |
|
254 |
- |
|
255 |
-sub type_rule_off { |
|
256 |
- my $self = shift; |
|
257 |
- $self->{type_rule_off} = 1; |
|
258 |
- return $self; |
|
259 |
-} |
|
260 |
- |
|
261 |
-sub type_rule_on { |
|
262 |
- my $self = shift; |
|
263 |
- $self->{type_rule_off} = 0; |
|
264 |
- return $self; |
|
265 |
-} |
|
266 |
- |
|
267 |
-sub type_rule1_off { |
|
268 |
- my $self = shift; |
|
269 |
- $self->{type_rule1_off} = 1; |
|
270 |
- return $self; |
|
271 |
-} |
|
272 |
- |
|
273 |
-sub type_rule1_on { |
|
274 |
- my $self = shift; |
|
275 |
- $self->{type_rule1_off} = 0; |
|
276 |
- return $self; |
|
277 |
-} |
|
278 |
- |
|
279 |
-sub type_rule2_off { |
|
280 |
- my $self = shift; |
|
281 |
- $self->{type_rule2_off} = 1; |
|
282 |
- return $self; |
|
283 |
-} |
|
284 |
- |
|
285 |
-sub type_rule2_on { |
|
286 |
- my $self = shift; |
|
287 |
- $self->{type_rule2_off} = 0; |
|
288 |
- return $self; |
|
289 |
-} |
|
290 |
- |
|
291 |
-# DEPRECATED! |
|
292 |
-sub end_filter { |
|
293 |
- warn "end_filter method is DEPRECATED!"; |
|
294 |
- my $self = shift; |
|
295 |
- if (@_) { |
|
296 |
- my $end_filter = {}; |
|
297 |
- if (ref $_[0] eq 'HASH') { $end_filter = $_[0] } |
|
298 |
- else { |
|
299 |
- $end_filter = _array_to_hash( |
|
300 |
- @_ > 1 ? [@_] : $_[0] |
|
301 |
- ); |
|
302 |
- } |
|
303 |
- foreach my $column (keys %$end_filter) { |
|
304 |
- my $fname = $end_filter->{$column}; |
|
305 |
- if (exists $end_filter->{$column} |
|
306 |
- && defined $fname |
|
307 |
- && ref $fname ne 'CODE') |
|
308 |
- { |
|
309 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
310 |
- unless exists $self->dbi->filters->{$fname}; |
|
311 |
- $end_filter->{$column} = $self->dbi->filters->{$fname}; |
|
312 |
- } |
|
313 |
- } |
|
314 |
- $self->{end_filter} = {%{$self->end_filter}, %$end_filter}; |
|
315 |
- return $self; |
|
316 |
- } |
|
317 |
- return $self->{end_filter} ||= {}; |
|
318 |
-} |
|
319 |
-# DEPRECATED! |
|
320 |
-sub remove_end_filter { |
|
321 |
- warn "remove_end_filter is DEPRECATED!"; |
|
322 |
- my $self = shift; |
|
323 |
- $self->{end_filter} = {}; |
|
324 |
- return $self; |
|
325 |
-} |
|
326 |
-# DEPRECATED! |
|
327 |
-sub remove_filter { |
|
328 |
- warn "remove_filter is DEPRECATED!"; |
|
329 |
- my $self = shift; |
|
330 |
- $self->{filter} = {}; |
|
331 |
- return $self; |
|
332 |
-} |
|
333 |
-# DEPRECATED! |
|
334 |
-sub default_filter { |
|
335 |
- warn "default_filter is DEPRECATED!"; |
|
336 |
- my $self = shift; |
|
337 |
- if (@_) { |
|
338 |
- my $fname = $_[0]; |
|
339 |
- if (@_ && !$fname) { |
|
340 |
- $self->{default_filter} = undef; |
|
341 |
- } |
|
342 |
- else { |
|
343 |
- croak qq{Filter "$fname" is not registered} |
|
344 |
- unless exists $self->dbi->filters->{$fname}; |
|
345 |
- $self->{default_filter} = $self->dbi->filters->{$fname}; |
|
346 |
- } |
|
347 |
- return $self; |
|
348 |
- } |
|
349 |
- return $self->{default_filter}; |
|
350 |
-} |
|
351 |
-# DEPRECATED! |
|
352 |
-has 'filter_check'; |
|
353 |
- |
|
354 |
-1; |
|
355 |
- |
|
356 |
-=head1 NAME |
|
357 |
- |
|
358 |
-DBIx::Custom::Result - Result of select statement |
|
359 |
- |
|
360 |
-=head1 SYNOPSIS |
|
361 |
- |
|
362 |
- # Result |
|
363 |
- my $result = $dbi->select(table => 'book'); |
|
364 |
- |
|
365 |
- # Fetch a row and put it into array reference |
|
366 |
- while (my $row = $result->fetch) { |
|
367 |
- my $author = $row->[0]; |
|
368 |
- my $title = $row->[1]; |
|
369 |
- } |
|
370 |
- |
|
371 |
- # Fetch only a first row and put it into array reference |
|
372 |
- my $row = $result->fetch_first; |
|
373 |
- |
|
374 |
- # Fetch all rows and put them into array of array reference |
|
375 |
- my $rows = $result->fetch_all; |
|
376 |
- |
|
377 |
- # Fetch a row and put it into hash reference |
|
378 |
- while (my $row = $result->fetch_hash) { |
|
379 |
- my $title = $row->{title}; |
|
380 |
- my $author = $row->{author}; |
|
381 |
- } |
|
382 |
- |
|
383 |
- # Fetch only a first row and put it into hash reference |
|
384 |
- my $row = $result->fetch_hash_first; |
|
385 |
- my $row = $result->one; # Same as fetch_hash_first |
|
386 |
- |
|
387 |
- # Fetch all rows and put them into array of hash reference |
|
388 |
- my $rows = $result->fetch_hash_all; |
|
389 |
- my $rows = $result->all; # Same as fetch_hash_all |
|
390 |
- |
|
391 |
-=head1 ATTRIBUTES |
|
392 |
- |
|
393 |
-=head2 C<dbi> |
|
394 |
- |
|
395 |
- my $dbi = $result->dbi; |
|
396 |
- $result = $result->dbi($dbi); |
|
397 |
- |
|
398 |
-L<DBIx::Custom> object. |
|
399 |
- |
|
400 |
-=head2 C<sth> |
|
401 |
- |
|
402 |
- my $sth = $reuslt->sth |
|
403 |
- $result = $result->sth($sth); |
|
404 |
- |
|
405 |
-Statement handle of L<DBI>. |
|
406 |
- |
|
407 |
-=head1 METHODS |
|
408 |
- |
|
409 |
-L<DBIx::Custom::Result> inherits all methods from L<Object::Simple> |
|
410 |
-and implements the following new ones. |
|
411 |
- |
|
412 |
-=head2 C<all> |
|
413 |
- |
|
414 |
- my $rows = $result->all; |
|
415 |
- |
|
416 |
-Same as C<fetch_hash_all>. |
|
417 |
- |
|
418 |
-=head2 C<fetch> |
|
419 |
- |
|
420 |
- my $row = $result->fetch; |
|
421 |
- |
|
422 |
-Fetch a row and put it into array reference. |
|
423 |
- |
|
424 |
-=head2 C<fetch_all> |
|
425 |
- |
|
426 |
- my $rows = $result->fetch_all; |
|
427 |
- |
|
428 |
-Fetch all rows and put them into array of array reference. |
|
429 |
- |
|
430 |
-=head2 C<fetch_first> |
|
431 |
- |
|
432 |
- my $row = $result->fetch_first; |
|
433 |
- |
|
434 |
-Fetch only a first row and put it into array reference, |
|
435 |
-and finish statment handle. |
|
436 |
- |
|
437 |
-=head2 C<fetch_hash> |
|
438 |
- |
|
439 |
- my $row = $result->fetch_hash; |
|
440 |
- |
|
441 |
-Fetch a row and put it into hash reference. |
|
442 |
- |
|
443 |
-=head2 C<fetch_hash_all> |
|
444 |
- |
|
445 |
- my $rows = $result->fetch_hash_all; |
|
446 |
- |
|
447 |
-Fetch all rows and put them into array of hash reference. |
|
448 |
- |
|
449 |
-=head2 C<fetch_hash_first> |
|
450 |
- |
|
451 |
- my $row = $result->fetch_hash_first; |
|
452 |
- |
|
453 |
-Fetch only a first row and put it into hash reference, |
|
454 |
-and finish statment handle. |
|
455 |
- |
|
456 |
-=head2 C<fetch_hash_multi> |
|
457 |
- |
|
458 |
- my $rows = $result->fetch_hash_multi(5); |
|
459 |
- |
|
460 |
-Fetch multiple rows and put them into array of hash reference. |
|
461 |
- |
|
462 |
-=head2 C<fetch_multi> |
|
463 |
- |
|
464 |
- my $rows = $result->fetch_multi(5); |
|
465 |
- |
|
466 |
-Fetch multiple rows and put them into array of array reference. |
|
467 |
- |
|
468 |
-=head2 C<filter> |
|
469 |
- |
|
470 |
- $result->filter(title => sub { uc $_[0] }, author => 'to_upper'); |
|
471 |
- $result->filter([qw/title author/] => 'to_upper'); |
|
472 |
- |
|
473 |
-Set filter for column. |
|
474 |
-You can use subroutine or filter name as filter. |
|
475 |
-This filter is executed after C<type_rule> filter. |
|
476 |
- |
|
477 |
-=head2 C<filter_off> EXPERIMENTAL |
|
478 |
- |
|
479 |
- $result = $result->filter_off; |
|
480 |
- |
|
481 |
-Turn filtering by C<filter> method off. |
|
482 |
-By default, filterin is on. |
|
483 |
- |
|
484 |
-=head2 C<filter_on> EXPERIMENTAL |
|
485 |
- |
|
486 |
- $result = $resutl->filter_on; |
|
487 |
- |
|
488 |
-Turn filtering by C<filter> method on. |
|
489 |
-By default, filterin is on. |
|
490 |
- |
|
491 |
-=head2 C<header> |
|
492 |
- |
|
493 |
- my $header = $result->header; |
|
494 |
- |
|
495 |
-Get header column names. |
|
496 |
- |
|
497 |
-=head2 C<one> |
|
498 |
- |
|
499 |
- my $row = $result->one; |
|
500 |
- |
|
501 |
-Same as C<fetch_hash_first>. |
|
502 |
- |
|
503 |
-=head2 C<stash> |
|
504 |
- |
|
505 |
- my $stash = $result->stash; |
|
506 |
- my $foo = $result->stash->{foo}; |
|
507 |
- $result->stash->{foo} = $foo; |
|
508 |
- |
|
509 |
-Stash is hash reference for data. |
|
510 |
- |
|
511 |
-=head2 C<type_rule> EXPERIMENTAL |
|
512 |
- |
|
513 |
- # Merge type rule |
|
514 |
- $result->type_rule( |
|
515 |
- # DATE |
|
516 |
- 9 => sub { ... }, |
|
517 |
- # DATETIME or TIMESTAMP |
|
518 |
- 11 => sub { ... } |
|
519 |
- ); |
|
520 |
- |
|
521 |
- # Replace type rule(by reference) |
|
522 |
- $result->type_rule([ |
|
523 |
- # DATE |
|
524 |
- 9 => sub { ... }, |
|
525 |
- # DATETIME or TIMESTAMP |
|
526 |
- 11 => sub { ... } |
|
527 |
- ]); |
|
528 |
- |
|
529 |
-This is same as L<DBIx::Custom>'s C<type_rule>'s <from>. |
|
530 |
- |
|
531 |
-=head2 C<type_rule_off> EXPERIMENTAL |
|
532 |
- |
|
533 |
- $result = $result->type_rule_off; |
|
534 |
- |
|
535 |
-Turn C<from1> and C<from2> type rule off. |
|
536 |
-By default, type rule is on. |
|
537 |
- |
|
538 |
-=head2 C<type_rule_on> EXPERIMENTAL |
|
539 |
- |
|
540 |
- $result = $result->type_rule_on; |
|
541 |
- |
|
542 |
-Turn C<from1> and C<from2> type rule on. |
|
543 |
-By default, type rule is on. |
|
544 |
- |
|
545 |
-=head2 C<type_rule1_off> EXPERIMENTAL |
|
546 |
- |
|
547 |
- $result = $result->type_rule1_off; |
|
548 |
- |
|
549 |
-Turn C<from1> type rule off. |
|
550 |
-By default, type rule is on. |
|
551 |
- |
|
552 |
-=head2 C<type_rule1_on> EXPERIMENTAL |
|
553 |
- |
|
554 |
- $result = $result->type_rule1_on; |
|
555 |
- |
|
556 |
-Turn C<from1> type rule on. |
|
557 |
-By default, type rule is on. |
|
558 |
- |
|
559 |
-=head2 C<type_rule2_off> EXPERIMENTAL |
|
560 |
- |
|
561 |
- $result = $result->type_rule2_off; |
|
562 |
- |
|
563 |
-Turn C<from2> type rule off. |
|
564 |
-By default, type rule is on. |
|
565 |
- |
|
566 |
-=head2 C<type_rule2_on> EXPERIMENTAL |
|
567 |
- |
|
568 |
- $result = $result->type_rule2_on; |
|
569 |
- |
|
570 |
-Turn C<from2> type rule on. |
|
571 |
-By default, type rule is on. |
|
572 |
- |
|
573 |
-=cut |
... | ... |
@@ -1,98 +0,0 @@ |
1 |
-package DBIx::Custom::Tag; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use Carp 'croak'; |
|
7 |
-use DBIx::Custom::Util '_subname'; |
|
8 |
- |
|
9 |
-# Carp trust relationship |
|
10 |
-push @DBIx::Custom::QueryBuilder::CARP_NOT, __PACKAGE__; |
|
11 |
- |
|
12 |
-sub equal { _basic('=', @_) } |
|
13 |
-sub greater_than_equal { _basic('>=', @_) } |
|
14 |
-sub greater_than { _basic('>', @_) } |
|
15 |
- |
|
16 |
-sub in { |
|
17 |
- my ($column, $count) = @_; |
|
18 |
- |
|
19 |
- # Check arguments |
|
20 |
- croak qq{Column name and count of values must be specified in tag "{in }" } |
|
21 |
- . _subname |
|
22 |
- unless $column && $count && $count =~ /^\d+$/; |
|
23 |
- |
|
24 |
- # Part of statement |
|
25 |
- my $s = "$column in ("; |
|
26 |
- for (my $i = 0; $i < $count; $i++) { |
|
27 |
- $s .= '?, '; |
|
28 |
- } |
|
29 |
- $s =~ s/, $//; |
|
30 |
- $s .= ')'; |
|
31 |
- |
|
32 |
- # Columns |
|
33 |
- my $columns = []; |
|
34 |
- push @$columns, $column for (0 .. $count - 1); |
|
35 |
- |
|
36 |
- return [$s, $columns]; |
|
37 |
-} |
|
38 |
- |
|
39 |
-sub insert_param { |
|
40 |
- my @columns = @_; |
|
41 |
- |
|
42 |
- # Insert parameters |
|
43 |
- my $s = '('; |
|
44 |
- $s .= "$_, " for @columns; |
|
45 |
- $s =~ s/, $//; |
|
46 |
- $s .= ') '; |
|
47 |
- $s .= 'values ('; |
|
48 |
- $s .= "?, " for @columns; |
|
49 |
- $s =~ s/, $//; |
|
50 |
- $s .= ')'; |
|
51 |
- |
|
52 |
- return [$s, \@columns]; |
|
53 |
-} |
|
54 |
- |
|
55 |
-sub like { _basic('like', @_) } |
|
56 |
-sub lower_than_equal { _basic('<=', @_) } |
|
57 |
-sub lower_than { _basic('<', @_) } |
|
58 |
-sub not_equal { _basic('<>', @_) } |
|
59 |
- |
|
60 |
-sub placeholder { |
|
61 |
- my $column = shift; |
|
62 |
- |
|
63 |
- # Check arguments |
|
64 |
- croak qq{Column name must be specified in tag "{? }" } . _subname |
|
65 |
- unless $column; |
|
66 |
- |
|
67 |
- return ['?', [$column]]; |
|
68 |
-} |
|
69 |
- |
|
70 |
-sub update_param { |
|
71 |
- my @columns = @_; |
|
72 |
- |
|
73 |
- # Update parameters |
|
74 |
- my $s = 'set '; |
|
75 |
- $s .= "$_ = ?, " for @columns; |
|
76 |
- $s =~ s/, $//; |
|
77 |
- |
|
78 |
- return [$s, \@columns]; |
|
79 |
-} |
|
80 |
- |
|
81 |
-sub _basic { |
|
82 |
- my ($name, $column) = @_; |
|
83 |
- |
|
84 |
- # Check arguments |
|
85 |
- croak qq{Column name must be specified in tag "{$name }" } . _subname |
|
86 |
- unless $column; |
|
87 |
- |
|
88 |
- return ["$column $name ?", [$column]]; |
|
89 |
-} |
|
90 |
- |
|
91 |
-1; |
|
92 |
- |
|
93 |
-=head1 NAME |
|
94 |
- |
|
95 |
-DBIx::Custom::Tag - DEPRECATED! |
|
96 |
- |
|
97 |
-=cut |
|
98 |
- |
... | ... |
@@ -1,41 +0,0 @@ |
1 |
-package DBIx::Custom::Util; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'Exporter'; |
|
7 |
- |
|
8 |
-our @EXPORT_OK = qw/_array_to_hash _subname/; |
|
9 |
- |
|
10 |
-sub _array_to_hash { |
|
11 |
- my $array = shift; |
|
12 |
- |
|
13 |
- return $array if ref $array eq 'HASH'; |
|
14 |
- return unless $array; |
|
15 |
- |
|
16 |
- my $hash = {}; |
|
17 |
- |
|
18 |
- for (my $i = 0; $i < @$array; $i += 2) { |
|
19 |
- my $key = $array->[$i]; |
|
20 |
- my $f = $array->[$i + 1]; |
|
21 |
- |
|
22 |
- if (ref $key eq 'ARRAY') { |
|
23 |
- foreach my $k (@$key) { |
|
24 |
- $hash->{$k} = $f; |
|
25 |
- } |
|
26 |
- } |
|
27 |
- else { |
|
28 |
- $hash->{$key} = $f; |
|
29 |
- } |
|
30 |
- } |
|
31 |
- return $hash; |
|
32 |
-} |
|
33 |
- |
|
34 |
-sub _subname { '(' . (caller 1)[3] . ')' } |
|
35 |
- |
|
36 |
-1; |
|
37 |
- |
|
38 |
-=head1 NAME |
|
39 |
- |
|
40 |
-DBIx::Custom::Util - Utility class |
|
41 |
- |
... | ... |
@@ -1,208 +0,0 @@ |
1 |
-package DBIx::Custom::Where; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util '_subname'; |
|
6 |
-use overload 'bool' => sub {1}, fallback => 1; |
|
7 |
-use overload '""' => sub { shift->to_string }, fallback => 1; |
|
8 |
- |
|
9 |
-# Carp trust relationship |
|
10 |
-push @DBIx::Custom::CARP_NOT, __PACKAGE__; |
|
11 |
- |
|
12 |
-has [qw/dbi param/], |
|
13 |
- clause => sub { [] }; |
|
14 |
- |
|
15 |
-sub new { |
|
16 |
- my $self = shift->SUPER::new(@_); |
|
17 |
- |
|
18 |
- # Check attribute names |
|
19 |
- my @attrs = keys %$self; |
|
20 |
- foreach my $attr (@attrs) { |
|
21 |
- croak qq{"$attr" is invalid attribute name (} . _subname . ")" |
|
22 |
- unless $self->can($attr); |
|
23 |
- } |
|
24 |
- |
|
25 |
- return $self; |
|
26 |
-} |
|
27 |
- |
|
28 |
-sub to_string { |
|
29 |
- my $self = shift; |
|
30 |
- |
|
31 |
- # Check if column name is safety character; |
|
32 |
- my $safety = $self->dbi->safety_character; |
|
33 |
- if (ref $self->param eq 'HASH') { |
|
34 |
- foreach my $column (keys %{$self->param}) { |
|
35 |
- croak qq{"$column" is not safety column name (} . _subname . ")" |
|
36 |
- unless $column =~ /^[$safety\.]+$/; |
|
37 |
- } |
|
38 |
- } |
|
39 |
- # Clause |
|
40 |
- my $clause = $self->clause; |
|
41 |
- $clause = ['and', $clause] unless ref $clause eq 'ARRAY'; |
|
42 |
- $clause->[0] = 'and' unless @$clause; |
|
43 |
- |
|
44 |
- # Parse |
|
45 |
- my $where = []; |
|
46 |
- my $count = {}; |
|
47 |
- $self->_parse($clause, $where, $count, 'and'); |
|
48 |
- |
|
49 |
- # Stringify |
|
50 |
- unshift @$where, 'where' if @$where; |
|
51 |
- return join(' ', @$where); |
|
52 |
-} |
|
53 |
- |
|
54 |
-our %VALID_OPERATIONS = map { $_ => 1 } qw/and or/; |
|
55 |
-sub _parse { |
|
56 |
- my ($self, $clause, $where, $count, $op) = @_; |
|
57 |
- |
|
58 |
- # Array |
|
59 |
- if (ref $clause eq 'ARRAY') { |
|
60 |
- |
|
61 |
- # Start |
|
62 |
- push @$where, '('; |
|
63 |
- |
|
64 |
- # Operation |
|
65 |
- my $op = $clause->[0] || ''; |
|
66 |
- croak qq{First argument must be "and" or "or" in where clause } . |
|
67 |
- qq{"$op" is passed} . _subname . ")" |
|
68 |
- unless $VALID_OPERATIONS{$op}; |
|
69 |
- |
|
70 |
- my $pushed_array; |
|
71 |
- # Parse internal clause |
|
72 |
- for (my $i = 1; $i < @$clause; $i++) { |
|
73 |
- my $pushed = $self->_parse($clause->[$i], $where, $count, $op); |
|
74 |
- push @$where, $op if $pushed; |
|
75 |
- $pushed_array = 1 if $pushed; |
|
76 |
- } |
|
77 |
- pop @$where if $where->[-1] eq $op; |
|
78 |
- |
|
79 |
- # Undo |
|
80 |
- if ($where->[-1] eq '(') { |
|
81 |
- pop @$where; |
|
82 |
- pop @$where if ($where->[-1] || '') eq $op; |
|
83 |
- } |
|
84 |
- # End |
|
85 |
- else { push @$where, ')' } |
|
86 |
- |
|
87 |
- return $pushed_array; |
|
88 |
- } |
|
89 |
- |
|
90 |
- # String |
|
91 |
- else { |
|
92 |
- # Pushed |
|
93 |
- my $pushed; |
|
94 |
- |
|
95 |
- # Column |
|
96 |
- my $columns = $self->dbi->query_builder->build_query($clause)->columns; |
|
97 |
- if (@$columns == 0) { |
|
98 |
- push @$where, $clause; |
|
99 |
- $pushed = 1; |
|
100 |
- return $pushed; |
|
101 |
- } |
|
102 |
- elsif (@$columns != 1) { |
|
103 |
- croak qq{Each part contains one column name: "$clause" (} |
|
104 |
- . _subname . ")"; |
|
105 |
- } |
|
106 |
- |
|
107 |
- # Remove quote |
|
108 |
- my $column = $columns->[0]; |
|
109 |
- if (my $q = $self->dbi->_quote) { |
|
110 |
- $q = quotemeta($q); |
|
111 |
- $column =~ s/[$q]//g; |
|
112 |
- } |
|
113 |
- |
|
114 |
- # Check safety |
|
115 |
- my $safety = $self->dbi->safety_character; |
|
116 |
- croak qq{"$column" is not safety column name (} . _subname . ")" |
|
117 |
- unless $column =~ /^[$safety\.]+$/; |
|
118 |
- |
|
119 |
- # Column count up |
|
120 |
- my $count = ++$count->{$column}; |
|
121 |
- |
|
122 |
- # Push |
|
123 |
- my $param = $self->param; |
|
124 |
- if (ref $param eq 'HASH') { |
|
125 |
- if (exists $param->{$column}) { |
|
126 |
- if (ref $param->{$column} eq 'ARRAY') { |
|
127 |
- $pushed = 1 |
|
128 |
- if exists $param->{$column}->[$count - 1] |
|
129 |
- && ref $param->{$column}->[$count - 1] ne 'DBIx::Custom::NotExists'; |
|
130 |
- } |
|
131 |
- elsif ($count == 1) { |
|
132 |
- $pushed = 1; |
|
133 |
- } |
|
134 |
- } |
|
135 |
- push @$where, $clause if $pushed; |
|
136 |
- } |
|
137 |
- elsif (!defined $param) { |
|
138 |
- push @$where, $clause; |
|
139 |
- $pushed = 1; |
|
140 |
- } |
|
141 |
- else { |
|
142 |
- croak "Parameter must be hash reference or undfined value (" |
|
143 |
- . _subname . ")" |
|
144 |
- } |
|
145 |
- return $pushed; |
|
146 |
- } |
|
147 |
- return; |
|
148 |
-} |
|
149 |
- |
|
150 |
-1; |
|
151 |
- |
|
152 |
-=head1 NAME |
|
153 |
- |
|
154 |
-DBIx::Custom::Where - Where clause |
|
155 |
- |
|
156 |
-=head1 SYNOPSYS |
|
157 |
- |
|
158 |
- my $where = DBIx::Custom::Where->new; |
|
159 |
- my $string_where = "$where"; |
|
160 |
- |
|
161 |
-=head1 ATTRIBUTES |
|
162 |
- |
|
163 |
-=head2 C<clause> |
|
164 |
- |
|
165 |
- my $clause = $where->clause; |
|
166 |
- $where = $where->clause( |
|
167 |
- ['and', |
|
168 |
- 'title = :title', |
|
169 |
- ['or', 'date < :date', 'date > :date'] |
|
170 |
- ] |
|
171 |
- ); |
|
172 |
- |
|
173 |
-Where clause. Above one is expanded to the following SQL by to_string |
|
174 |
-If all parameter names is exists. |
|
175 |
- |
|
176 |
- "where ( title = :title and ( date < :date or date > :date ) )" |
|
177 |
- |
|
178 |
-=head2 C<param> |
|
179 |
- |
|
180 |
- my $param = $where->param; |
|
181 |
- $where = $where->param({ |
|
182 |
- title => 'Perl', |
|
183 |
- date => ['2010-11-11', '2011-03-05'], |
|
184 |
- }); |
|
185 |
- |
|
186 |
-=head2 C<dbi> |
|
187 |
- |
|
188 |
- my $dbi = $where->dbi; |
|
189 |
- $where = $where->dbi($dbi); |
|
190 |
- |
|
191 |
-L<DBIx::Custom> object. |
|
192 |
- |
|
193 |
-=head1 METHODS |
|
194 |
- |
|
195 |
-L<DBIx::Custom::Where> inherits all methods from L<Object::Simple> |
|
196 |
-and implements the following new ones. |
|
197 |
- |
|
198 |
-=head2 C<to_string> |
|
199 |
- |
|
200 |
- $where->to_string; |
|
201 |
- |
|
202 |
-Convert where clause to string. |
|
203 |
- |
|
204 |
-double quote is override to execute C<to_string> method. |
|
205 |
- |
|
206 |
- my $string_where = "$where"; |
|
207 |
- |
|
208 |
-=cut |
... | ... |
@@ -1,1894 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom 3" |
|
132 |
-.TH DBIx::Custom 3 "2011-08-06" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom \- Execute insert, update, delete, and select statement easily |
|
135 |
-.SH "SYNOPSYS" |
|
136 |
-.IX Header "SYNOPSYS" |
|
137 |
-.Vb 1 |
|
138 |
-\& use DBIx::Custom; |
|
139 |
-.Ve |
|
140 |
-.PP |
|
141 |
-.Vb 7 |
|
142 |
-\& # Connect |
|
143 |
-\& my $dbi = DBIx::Custom->connect( |
|
144 |
-\& dsn => "dbi:mysql:database=dbname", |
|
145 |
-\& user => 'ken', |
|
146 |
-\& password => '!LFKD%$&', |
|
147 |
-\& dbi_option => {mysql_enable_utf8 => 1} |
|
148 |
-\& ); |
|
149 |
-.Ve |
|
150 |
-.PP |
|
151 |
-.Vb 2 |
|
152 |
-\& # Insert |
|
153 |
-\& $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
154 |
-.Ve |
|
155 |
-.PP |
|
156 |
-.Vb 3 |
|
157 |
-\& # Update |
|
158 |
-\& $dbi->update({title => 'Perl', author => 'Ken'}, table => 'book', |
|
159 |
-\& where => {id => 5}); |
|
160 |
-.Ve |
|
161 |
-.PP |
|
162 |
-.Vb 2 |
|
163 |
-\& # Delete |
|
164 |
-\& $dbi->delete(table => 'book', where => {author => 'Ken'}); |
|
165 |
-.Ve |
|
166 |
-.PP |
|
167 |
-.Vb 3 |
|
168 |
-\& # Select |
|
169 |
-\& my $result = $dbi->select(table => 'book', |
|
170 |
-\& column => ['title', 'author'], where => {author => 'Ken'}); |
|
171 |
-.Ve |
|
172 |
-.PP |
|
173 |
-.Vb 11 |
|
174 |
-\& # Select, more complex |
|
175 |
-\& my $result = $dbi->select( |
|
176 |
-\& table => 'book', |
|
177 |
-\& column => [ |
|
178 |
-\& {book => [qw/title author/]}, |
|
179 |
-\& {company => ['name']} |
|
180 |
-\& ], |
|
181 |
-\& where => {'book.author' => 'Ken'}, |
|
182 |
-\& join => ['left outer join company on book.company_id = company.id'], |
|
183 |
-\& append => 'order by id limit 5' |
|
184 |
-\& ); |
|
185 |
-.Ve |
|
186 |
-.PP |
|
187 |
-.Vb 2 |
|
188 |
-\& # Fetch |
|
189 |
-\& while (my $row = $result->fetch) { |
|
190 |
-.Ve |
|
191 |
-.PP |
|
192 |
-.Vb 1 |
|
193 |
-\& } |
|
194 |
-.Ve |
|
195 |
-.PP |
|
196 |
-.Vb 2 |
|
197 |
-\& # Fetch as hash |
|
198 |
-\& while (my $row = $result->fetch_hash) { |
|
199 |
-.Ve |
|
200 |
-.PP |
|
201 |
-.Vb 1 |
|
202 |
-\& } |
|
203 |
-.Ve |
|
204 |
-.PP |
|
205 |
-.Vb 5 |
|
206 |
-\& # Execute SQL with parameter. |
|
207 |
-\& $dbi->execute( |
|
208 |
-\& "select id from book where author = :author and title like :title", |
|
209 |
-\& {author => 'ken', title => '%Perl%'} |
|
210 |
-\& ); |
|
211 |
-.Ve |
|
212 |
-.SH "DESCRIPTIONS" |
|
213 |
-.IX Header "DESCRIPTIONS" |
|
214 |
-DBIx::Custom is \s-1DBI\s0 wrapper module to execute \s-1SQL\s0 easily. |
|
215 |
-This module have the following features. |
|
216 |
-.IP "\(bu" 4 |
|
217 |
-Execute \f(CW\*(C`insert\*(C'\fR, \f(CW\*(C`update\*(C'\fR, \f(CW\*(C`delete\*(C'\fR, or \f(CW\*(C`select\*(C'\fR statement easily |
|
218 |
-.IP "\(bu" 4 |
|
219 |
-Create \f(CW\*(C`where\*(C'\fR clause flexibly |
|
220 |
-.IP "\(bu" 4 |
|
221 |
-Named place holder support |
|
222 |
-.IP "\(bu" 4 |
|
223 |
-Model support |
|
224 |
-.IP "\(bu" 4 |
|
225 |
-Connection manager support |
|
226 |
-.IP "\(bu" 4 |
|
227 |
-Choice your favorite relational database management system, |
|
228 |
-\&\f(CW\*(C`MySQL\*(C'\fR, \f(CW\*(C`SQLite\*(C'\fR, \f(CW\*(C`PostgreSQL\*(C'\fR, \f(CW\*(C`Oracle\*(C'\fR, |
|
229 |
-\&\f(CW\*(C`Microsoft SQL Server\*(C'\fR, \f(CW\*(C`Microsoft Access\*(C'\fR, \f(CW\*(C`DB2\*(C'\fR or anything, |
|
230 |
-.IP "\(bu" 4 |
|
231 |
-Filtering by data type or column name(\s-1EXPERIMENTAL\s0) |
|
232 |
-.IP "\(bu" 4 |
|
233 |
-Create \f(CW\*(C`order by\*(C'\fR clause flexibly(\s-1EXPERIMENTAL\s0) |
|
234 |
-.SH "DOCUMENTATIONS" |
|
235 |
-.IX Header "DOCUMENTATIONS" |
|
236 |
-DBIx::Custom::Guide \- How to use DBIx::Custom |
|
237 |
-.PP |
|
238 |
-DBIx::Custom Wiki |
|
239 |
-\&\- Theare are various examples. |
|
240 |
-.PP |
|
241 |
-Module documentations \- |
|
242 |
-DBIx::Custom::Result, |
|
243 |
-DBIx::Custom::Query, |
|
244 |
-DBIx::Custom::Where, |
|
245 |
-DBIx::Custom::Model, |
|
246 |
-DBIx::Custom::Order |
|
247 |
-.SH "ATTRIBUTES" |
|
248 |
-.IX Header "ATTRIBUTES" |
|
249 |
-.ie n .Sh """connector""" |
|
250 |
-.el .Sh "\f(CWconnector\fP" |
|
251 |
-.IX Subsection "connector" |
|
252 |
-.Vb 2 |
|
253 |
-\& my $connector = $dbi->connector; |
|
254 |
-\& $dbi = $dbi->connector($connector); |
|
255 |
-.Ve |
|
256 |
-.PP |
|
257 |
-Connection manager object. if \f(CW\*(C`connector\*(C'\fR is set, you can get \f(CW\*(C`dbh\*(C'\fR |
|
258 |
-through connection manager. Conection manager object must have \f(CW\*(C`dbh\*(C'\fR mehtod. |
|
259 |
-.PP |
|
260 |
-This is DBIx::Connector example. Please pass |
|
261 |
-\&\f(CW\*(C`default_dbi_option\*(C'\fR to DBIx::Connector \f(CW\*(C`new\*(C'\fR method. |
|
262 |
-.PP |
|
263 |
-.Vb 6 |
|
264 |
-\& my $connector = DBIx::Connector->new( |
|
265 |
-\& "dbi:mysql:database=$DATABASE", |
|
266 |
-\& $USER, |
|
267 |
-\& $PASSWORD, |
|
268 |
-\& DBIx::Custom->new->default_dbi_option |
|
269 |
-\& ); |
|
270 |
-.Ve |
|
271 |
-.PP |
|
272 |
-.Vb 1 |
|
273 |
-\& my $dbi = DBIx::Custom->connect(connector => $connector); |
|
274 |
-.Ve |
|
275 |
-.ie n .Sh """dsn""" |
|
276 |
-.el .Sh "\f(CWdsn\fP" |
|
277 |
-.IX Subsection "dsn" |
|
278 |
-.Vb 2 |
|
279 |
-\& my $dsn = $dbi->dsn; |
|
280 |
-\& $dbi = $dbi->dsn("DBI:mysql:database=dbname"); |
|
281 |
-.Ve |
|
282 |
-.PP |
|
283 |
-Data source name, used when \f(CW\*(C`connect\*(C'\fR method is executed. |
|
284 |
-.ie n .Sh """dbi_option""" |
|
285 |
-.el .Sh "\f(CWdbi_option\fP" |
|
286 |
-.IX Subsection "dbi_option" |
|
287 |
-.Vb 2 |
|
288 |
-\& my $dbi_option = $dbi->dbi_option; |
|
289 |
-\& $dbi = $dbi->dbi_option($dbi_option); |
|
290 |
-.Ve |
|
291 |
-.PP |
|
292 |
-\&\s-1DBI\s0 option, used when \f(CW\*(C`connect\*(C'\fR method is executed. |
|
293 |
-Each value in option override the value of \f(CW\*(C`default_dbi_option\*(C'\fR. |
|
294 |
-.ie n .Sh """default_dbi_option""" |
|
295 |
-.el .Sh "\f(CWdefault_dbi_option\fP" |
|
296 |
-.IX Subsection "default_dbi_option" |
|
297 |
-.Vb 2 |
|
298 |
-\& my $default_dbi_option = $dbi->default_dbi_option; |
|
299 |
-\& $dbi = $dbi->default_dbi_option($default_dbi_option); |
|
300 |
-.Ve |
|
301 |
-.PP |
|
302 |
-\&\s-1DBI\s0 default option, used when \f(CW\*(C`connect\*(C'\fR method is executed, |
|
303 |
-default to the following values. |
|
304 |
-.PP |
|
305 |
-.Vb 5 |
|
306 |
-\& { |
|
307 |
-\& RaiseError => 1, |
|
308 |
-\& PrintError => 0, |
|
309 |
-\& AutoCommit => 1, |
|
310 |
-\& } |
|
311 |
-.Ve |
|
312 |
-.ie n .Sh """filters""" |
|
313 |
-.el .Sh "\f(CWfilters\fP" |
|
314 |
-.IX Subsection "filters" |
|
315 |
-.Vb 2 |
|
316 |
-\& my $filters = $dbi->filters; |
|
317 |
-\& $dbi = $dbi->filters(\e%filters); |
|
318 |
-.Ve |
|
319 |
-.PP |
|
320 |
-Filters, registered by \f(CW\*(C`register_filter\*(C'\fR method. |
|
321 |
-.ie n .Sh """last_sql""" |
|
322 |
-.el .Sh "\f(CWlast_sql\fP" |
|
323 |
-.IX Subsection "last_sql" |
|
324 |
-.Vb 2 |
|
325 |
-\& my $last_sql = $dbi->last_sql; |
|
326 |
-\& $dbi = $dbi->last_sql($last_sql); |
|
327 |
-.Ve |
|
328 |
-.PP |
|
329 |
-Get last successed \s-1SQL\s0 executed by \f(CW\*(C`execute\*(C'\fR method. |
|
330 |
-.ie n .Sh """models""" |
|
331 |
-.el .Sh "\f(CWmodels\fP" |
|
332 |
-.IX Subsection "models" |
|
333 |
-.Vb 2 |
|
334 |
-\& my $models = $dbi->models; |
|
335 |
-\& $dbi = $dbi->models(\e%models); |
|
336 |
-.Ve |
|
337 |
-.PP |
|
338 |
-Models, included by \f(CW\*(C`include_model\*(C'\fR method. |
|
339 |
-.ie n .Sh """password""" |
|
340 |
-.el .Sh "\f(CWpassword\fP" |
|
341 |
-.IX Subsection "password" |
|
342 |
-.Vb 2 |
|
343 |
-\& my $password = $dbi->password; |
|
344 |
-\& $dbi = $dbi->password('lkj&le`@s'); |
|
345 |
-.Ve |
|
346 |
-.PP |
|
347 |
-Password, used when \f(CW\*(C`connect\*(C'\fR method is executed. |
|
348 |
-.ie n .Sh """query_builder""" |
|
349 |
-.el .Sh "\f(CWquery_builder\fP" |
|
350 |
-.IX Subsection "query_builder" |
|
351 |
-.Vb 2 |
|
352 |
-\& my $sql_class = $dbi->query_builder; |
|
353 |
-\& $dbi = $dbi->query_builder(DBIx::Custom::QueryBuilder->new); |
|
354 |
-.Ve |
|
355 |
-.PP |
|
356 |
-Query builder, default to DBIx::Custom::QueryBuilder object. |
|
357 |
-.ie n .Sh """quote""" |
|
358 |
-.el .Sh "\f(CWquote\fP" |
|
359 |
-.IX Subsection "quote" |
|
360 |
-.Vb 2 |
|
361 |
-\& my quote = $dbi->quote; |
|
362 |
-\& $dbi = $dbi->quote('"'); |
|
363 |
-.Ve |
|
364 |
-.PP |
|
365 |
-Reserved word quote. |
|
366 |
-Default to double quote '"' except for mysql. |
|
367 |
-In mysql, default to back quote '`' |
|
368 |
-.PP |
|
369 |
-You can set quote pair. |
|
370 |
-.PP |
|
371 |
-.Vb 1 |
|
372 |
-\& $dbi->quote('[]'); |
|
373 |
-.Ve |
|
374 |
-.ie n .Sh """result_class""" |
|
375 |
-.el .Sh "\f(CWresult_class\fP" |
|
376 |
-.IX Subsection "result_class" |
|
377 |
-.Vb 2 |
|
378 |
-\& my $result_class = $dbi->result_class; |
|
379 |
-\& $dbi = $dbi->result_class('DBIx::Custom::Result'); |
|
380 |
-.Ve |
|
381 |
-.PP |
|
382 |
-Result class, default to DBIx::Custom::Result. |
|
383 |
-.ie n .Sh """safety_character""" |
|
384 |
-.el .Sh "\f(CWsafety_character\fP" |
|
385 |
-.IX Subsection "safety_character" |
|
386 |
-.Vb 2 |
|
387 |
-\& my $safety_character = $self->safety_character; |
|
388 |
-\& $dbi = $self->safety_character($character); |
|
389 |
-.Ve |
|
390 |
-.PP |
|
391 |
-Regex of safety character for table and column name, default to '\ew'. |
|
392 |
-Note that you don't have to specify like '[\ew]'. |
|
393 |
-.ie n .Sh """tag_parse""" |
|
394 |
-.el .Sh "\f(CWtag_parse\fP" |
|
395 |
-.IX Subsection "tag_parse" |
|
396 |
-.Vb 2 |
|
397 |
-\& my $tag_parse = $dbi->tag_parse(0); |
|
398 |
-\& $dbi = $dbi->tag_parse; |
|
399 |
-.Ve |
|
400 |
-.PP |
|
401 |
-Enable \s-1DEPRECATED\s0 tag parsing functionality, default to 1. |
|
402 |
-If you want to disable tag parsing functionality, set to 0. |
|
403 |
-.ie n .Sh """user""" |
|
404 |
-.el .Sh "\f(CWuser\fP" |
|
405 |
-.IX Subsection "user" |
|
406 |
-.Vb 2 |
|
407 |
-\& my $user = $dbi->user; |
|
408 |
-\& $dbi = $dbi->user('Ken'); |
|
409 |
-.Ve |
|
410 |
-.PP |
|
411 |
-User name, used when \f(CW\*(C`connect\*(C'\fR method is executed. |
|
412 |
-.SH "METHODS" |
|
413 |
-.IX Header "METHODS" |
|
414 |
-DBIx::Custom inherits all methods from Object::Simple |
|
415 |
-and use all methods of \s-1DBI\s0 |
|
416 |
-and implements the following new ones. |
|
417 |
-.ie n .Sh """available_data_type"" \s-1EXPERIMENTAL\s0" |
|
418 |
-.el .Sh "\f(CWavailable_data_type\fP \s-1EXPERIMENTAL\s0" |
|
419 |
-.IX Subsection "available_data_type EXPERIMENTAL" |
|
420 |
-.Vb 1 |
|
421 |
-\& print $dbi->available_data_type; |
|
422 |
-.Ve |
|
423 |
-.PP |
|
424 |
-Get available data types. You can use these data types |
|
425 |
-in \f(CW\*(C`type rule\*(C'\fR's \f(CW\*(C`from1\*(C'\fR and \f(CW\*(C`from2\*(C'\fR section. |
|
426 |
-.ie n .Sh """available_type_name"" \s-1EXPERIMENTAL\s0" |
|
427 |
-.el .Sh "\f(CWavailable_type_name\fP \s-1EXPERIMENTAL\s0" |
|
428 |
-.IX Subsection "available_type_name EXPERIMENTAL" |
|
429 |
-.Vb 1 |
|
430 |
-\& print $dbi->available_type_name; |
|
431 |
-.Ve |
|
432 |
-.PP |
|
433 |
-Get available type names. You can use these type names in |
|
434 |
-\&\f(CW\*(C`type_rule\*(C'\fR's \f(CW\*(C`into1\*(C'\fR and \f(CW\*(C`into2\*(C'\fR section. |
|
435 |
-.ie n .Sh """assign_param"" \s-1EXPERIMENTAL\s0" |
|
436 |
-.el .Sh "\f(CWassign_param\fP \s-1EXPERIMENTAL\s0" |
|
437 |
-.IX Subsection "assign_param EXPERIMENTAL" |
|
438 |
-.Vb 1 |
|
439 |
-\& my $assign_param = $dbi->assign_param({title => 'a', age => 2}); |
|
440 |
-.Ve |
|
441 |
-.PP |
|
442 |
-Create assign parameter. |
|
443 |
-.PP |
|
444 |
-.Vb 1 |
|
445 |
-\& title = :title, author = :author |
|
446 |
-.Ve |
|
447 |
-.PP |
|
448 |
-This is equal to \f(CW\*(C`update_param\*(C'\fR exept that set is not added. |
|
449 |
-.ie n .Sh """column""" |
|
450 |
-.el .Sh "\f(CWcolumn\fP" |
|
451 |
-.IX Subsection "column" |
|
452 |
-.Vb 1 |
|
453 |
-\& my $column = $dbi->column(book => ['author', 'title']); |
|
454 |
-.Ve |
|
455 |
-.PP |
|
456 |
-Create column clause. The follwoing column clause is created. |
|
457 |
-.PP |
|
458 |
-.Vb 2 |
|
459 |
-\& book.author as "book.author", |
|
460 |
-\& book.title as "book.title" |
|
461 |
-.Ve |
|
462 |
-.PP |
|
463 |
-You can change separator by \f(CW\*(C`separator\*(C'\fR method. |
|
464 |
-.PP |
|
465 |
-.Vb 2 |
|
466 |
-\& # Separator is double underbar |
|
467 |
-\& $dbi->separator('__'); |
|
468 |
-.Ve |
|
469 |
-.PP |
|
470 |
-.Vb 2 |
|
471 |
-\& book.author as "book__author", |
|
472 |
-\& book.title as "book__title" |
|
473 |
-.Ve |
|
474 |
-.PP |
|
475 |
-.Vb 2 |
|
476 |
-\& # Separator is hyphen |
|
477 |
-\& $dbi->separator('-'); |
|
478 |
-.Ve |
|
479 |
-.PP |
|
480 |
-.Vb 2 |
|
481 |
-\& book.author as "book-author", |
|
482 |
-\& book.title as "book-title" |
|
483 |
-.Ve |
|
484 |
-.ie n .Sh """connect""" |
|
485 |
-.el .Sh "\f(CWconnect\fP" |
|
486 |
-.IX Subsection "connect" |
|
487 |
-.Vb 6 |
|
488 |
-\& my $dbi = DBIx::Custom->connect( |
|
489 |
-\& dsn => "dbi:mysql:database=dbname", |
|
490 |
-\& user => 'ken', |
|
491 |
-\& password => '!LFKD%$&', |
|
492 |
-\& dbi_option => {mysql_enable_utf8 => 1} |
|
493 |
-\& ); |
|
494 |
-.Ve |
|
495 |
-.PP |
|
496 |
-Connect to the database and create a new DBIx::Custom object. |
|
497 |
-.PP |
|
498 |
-DBIx::Custom is a wrapper of \s-1DBI\s0. |
|
499 |
-\&\f(CW\*(C`AutoCommit\*(C'\fR and \f(CW\*(C`RaiseError\*(C'\fR options are true, |
|
500 |
-and \f(CW\*(C`PrintError\*(C'\fR option is false by default. |
|
501 |
-.Sh "create_model" |
|
502 |
-.IX Subsection "create_model" |
|
503 |
-.Vb 7 |
|
504 |
-\& my $model = $dbi->create_model( |
|
505 |
-\& table => 'book', |
|
506 |
-\& primary_key => 'id', |
|
507 |
-\& join => [ |
|
508 |
-\& 'inner join company on book.comparny_id = company.id' |
|
509 |
-\& ], |
|
510 |
-\& ); |
|
511 |
-.Ve |
|
512 |
-.PP |
|
513 |
-Create DBIx::Custom::Model object and initialize model. |
|
514 |
-the module is also used from \f(CW\*(C`model\*(C'\fR method. |
|
515 |
-.PP |
|
516 |
-.Vb 1 |
|
517 |
-\& $dbi->model('book')->select(...); |
|
518 |
-.Ve |
|
519 |
-.ie n .Sh """dbh""" |
|
520 |
-.el .Sh "\f(CWdbh\fP" |
|
521 |
-.IX Subsection "dbh" |
|
522 |
-.Vb 1 |
|
523 |
-\& my $dbh = $dbi->dbh; |
|
524 |
-.Ve |
|
525 |
-.PP |
|
526 |
-Get \s-1DBI\s0 database handle. if \f(CW\*(C`connector\*(C'\fR is set, you can get |
|
527 |
-database handle through \f(CW\*(C`connector\*(C'\fR object. |
|
528 |
-.ie n .Sh """each_column""" |
|
529 |
-.el .Sh "\f(CWeach_column\fP" |
|
530 |
-.IX Subsection "each_column" |
|
531 |
-.Vb 3 |
|
532 |
-\& $dbi->each_column( |
|
533 |
-\& sub { |
|
534 |
-\& my ($dbi, $table, $column, $column_info) = @_; |
|
535 |
-.Ve |
|
536 |
-.PP |
|
537 |
-.Vb 1 |
|
538 |
-\& my $type = $column_info->{TYPE_NAME}; |
|
539 |
-.Ve |
|
540 |
-.PP |
|
541 |
-.Vb 5 |
|
542 |
-\& if ($type eq 'DATE') { |
|
543 |
-\& # ... |
|
544 |
-\& } |
|
545 |
-\& } |
|
546 |
-\& ); |
|
547 |
-.Ve |
|
548 |
-.PP |
|
549 |
-Iterate all column informations of all table from database. |
|
550 |
-Argument is callback when one column is found. |
|
551 |
-Callback receive four arguments, dbi object, table name, |
|
552 |
-column name and column information. |
|
553 |
-.ie n .Sh """each_table""" |
|
554 |
-.el .Sh "\f(CWeach_table\fP" |
|
555 |
-.IX Subsection "each_table" |
|
556 |
-.Vb 3 |
|
557 |
-\& $dbi->each_table( |
|
558 |
-\& sub { |
|
559 |
-\& my ($dbi, $table, $table_info) = @_; |
|
560 |
-.Ve |
|
561 |
-.PP |
|
562 |
-.Vb 3 |
|
563 |
-\& my $table_name = $table_info->{TABLE_NAME}; |
|
564 |
-\& } |
|
565 |
-\& ); |
|
566 |
-.Ve |
|
567 |
-.PP |
|
568 |
-Iterate all table informationsfrom database. |
|
569 |
-Argument is callback when one table is found. |
|
570 |
-Callback receive three arguments, dbi object, table name, |
|
571 |
-table information. |
|
572 |
-.ie n .Sh """execute""" |
|
573 |
-.el .Sh "\f(CWexecute\fP" |
|
574 |
-.IX Subsection "execute" |
|
575 |
-.Vb 4 |
|
576 |
-\& my $result = $dbi->execute( |
|
577 |
-\& "select * from book where title = :title and author like :author", |
|
578 |
-\& {title => 'Perl', author => '%Ken%'} |
|
579 |
-\& ); |
|
580 |
-.Ve |
|
581 |
-.PP |
|
582 |
-.Vb 4 |
|
583 |
-\& my $result = $dbi->execute( |
|
584 |
-\& "select * from book where title = :book.title and author like :book.author", |
|
585 |
-\& {'book.title' => 'Perl', 'book.author' => '%Ken%'} |
|
586 |
-\& ); |
|
587 |
-.Ve |
|
588 |
-.PP |
|
589 |
-Execute \s-1SQL\s0. \s-1SQL\s0 can contain column parameter such as :author and :title. |
|
590 |
-You can append table name to column name such as :book.title and :book.author. |
|
591 |
-Second argunet is data, embedded into column parameter. |
|
592 |
-Return value is DBIx::Custom::Result object when select statement is executed, |
|
593 |
-or the count of affected rows when insert, update, delete statement is executed. |
|
594 |
-.PP |
|
595 |
-Named placeholder such as \f(CW\*(C`:title\*(C'\fR is replaced by placeholder \f(CW\*(C`?\*(C'\fR. |
|
596 |
-.PP |
|
597 |
-.Vb 2 |
|
598 |
-\& # Original |
|
599 |
-\& select * from book where title = :title and author like :author |
|
600 |
-.Ve |
|
601 |
-.PP |
|
602 |
-.Vb 2 |
|
603 |
-\& # Replaced |
|
604 |
-\& select * from where title = ? and author like ?; |
|
605 |
-.Ve |
|
606 |
-.PP |
|
607 |
-You can specify operator with named placeholder |
|
608 |
- by \f(CW\*(C`name{operator}\*(C'\fR syntax. |
|
609 |
-.PP |
|
610 |
-.Vb 2 |
|
611 |
-\& # Original |
|
612 |
-\& select * from book where :title{=} and :author{like} |
|
613 |
-.Ve |
|
614 |
-.PP |
|
615 |
-.Vb 2 |
|
616 |
-\& # Replaced |
|
617 |
-\& select * from where title = ? and author like ?; |
|
618 |
-.Ve |
|
619 |
-.PP |
|
620 |
-Note that colons in time format such as 12:13:15 is exeption, |
|
621 |
-it is not parsed as named placeholder. |
|
622 |
-If you want to use colon generally, you must escape it by \f(CW\*(C`\e\e\*(C'\fR |
|
623 |
-.PP |
|
624 |
-.Vb 1 |
|
625 |
-\& select * from where title = "aa\e\e:bb"; |
|
626 |
-.Ve |
|
627 |
-.PP |
|
628 |
-The following opitons are available. |
|
629 |
-.ie n .IP """filter""" 4 |
|
630 |
-.el .IP "\f(CWfilter\fR" 4 |
|
631 |
-.IX Item "filter" |
|
632 |
-.Vb 4 |
|
633 |
-\& filter => { |
|
634 |
-\& title => sub { uc $_[0] } |
|
635 |
-\& author => sub { uc $_[0] } |
|
636 |
-\& } |
|
637 |
-.Ve |
|
638 |
-.Sp |
|
639 |
-.Vb 5 |
|
640 |
-\& # Filter name |
|
641 |
-\& filter => { |
|
642 |
-\& title => 'upper_case', |
|
643 |
-\& author => 'upper_case' |
|
644 |
-\& } |
|
645 |
-.Ve |
|
646 |
-.Sp |
|
647 |
-.Vb 4 |
|
648 |
-\& # At once |
|
649 |
-\& filter => [ |
|
650 |
-\& [qw/title author/] => sub { uc $_[0] } |
|
651 |
-\& ] |
|
652 |
-.Ve |
|
653 |
-.Sp |
|
654 |
-Filter. You can set subroutine or filter name |
|
655 |
-registered by by \f(CW\*(C`register_filter\*(C'\fR. |
|
656 |
-This filter is executed before data is saved into database. |
|
657 |
-and before type rule filter is executed. |
|
658 |
-.ie n .IP """query""" 4 |
|
659 |
-.el .IP "\f(CWquery\fR" 4 |
|
660 |
-.IX Item "query" |
|
661 |
-.Vb 1 |
|
662 |
-\& query => 1 |
|
663 |
-.Ve |
|
664 |
-.Sp |
|
665 |
-\&\f(CW\*(C`execute\*(C'\fR method return DBIx::Custom::Query object, not executing \s-1SQL\s0. |
|
666 |
-You can check \s-1SQL\s0 or get statment handle. |
|
667 |
-.Sp |
|
668 |
-.Vb 3 |
|
669 |
-\& my $sql = $query->sql; |
|
670 |
-\& my $sth = $query->sth; |
|
671 |
-\& my $columns = $query->columns; |
|
672 |
-.Ve |
|
673 |
-.Sp |
|
674 |
-If you want to execute \s-1SQL\s0 fast, you can do the following way. |
|
675 |
-.Sp |
|
676 |
-.Vb 5 |
|
677 |
-\& my $query; |
|
678 |
-\& foreach my $row (@$rows) { |
|
679 |
-\& $query ||= $dbi->insert($row, table => 'table1', query => 1); |
|
680 |
-\& $dbi->execute($query, $row, filter => {ab => sub { $_[0] * 2 }}); |
|
681 |
-\& } |
|
682 |
-.Ve |
|
683 |
-.Sp |
|
684 |
-Statement handle is reused and \s-1SQL\s0 parsing is finished, |
|
685 |
-so you can get more performance than normal way. |
|
686 |
-.Sp |
|
687 |
-If you want to execute \s-1SQL\s0 as possible as fast and don't need filtering. |
|
688 |
-You can do the following way. |
|
689 |
-.Sp |
|
690 |
-.Vb 7 |
|
691 |
-\& my $query; |
|
692 |
-\& my $sth; |
|
693 |
-\& foreach my $row (@$rows) { |
|
694 |
-\& $query ||= $dbi->insert($row, table => 'book', query => 1); |
|
695 |
-\& $sth ||= $query->sth; |
|
696 |
-\& $sth->execute(map { $row->{$_} } sort keys %$row); |
|
697 |
-\& } |
|
698 |
-.Ve |
|
699 |
-.Sp |
|
700 |
-Note that \f(CW$row\fR must be simple hash reference, such as |
|
701 |
-{title => 'Perl', author => 'Ken'}. |
|
702 |
-and don't forget to sort \f(CW$row\fR values by \f(CW$row\fR key asc order. |
|
703 |
-.ie n .IP """table""" 4 |
|
704 |
-.el .IP "\f(CWtable\fR" 4 |
|
705 |
-.IX Item "table" |
|
706 |
-.Vb 1 |
|
707 |
-\& table => 'author' |
|
708 |
-.Ve |
|
709 |
-.Sp |
|
710 |
-If you want to omit table name in column name |
|
711 |
-and enable \f(CW\*(C`into1\*(C'\fR and \f(CW\*(C`into2\*(C'\fR type filter, |
|
712 |
-You must set \f(CW\*(C`table\*(C'\fR option. |
|
713 |
-.Sp |
|
714 |
-.Vb 2 |
|
715 |
-\& $dbi->execute("select * from book where title = :title and author = :author", |
|
716 |
-\& {title => 'Perl', author => 'Ken', table => 'book'); |
|
717 |
-.Ve |
|
718 |
-.Sp |
|
719 |
-.Vb 4 |
|
720 |
-\& # Same |
|
721 |
-\& $dbi->execute( |
|
722 |
-\& "select * from book where title = :book.title and author = :book.author", |
|
723 |
-\& {title => 'Perl', author => 'Ken'); |
|
724 |
-.Ve |
|
725 |
-.ie n .IP """bind_type""" 4 |
|
726 |
-.el .IP "\f(CWbind_type\fR" 4 |
|
727 |
-.IX Item "bind_type" |
|
728 |
-Specify database bind data type. |
|
729 |
-.Sp |
|
730 |
-.Vb 2 |
|
731 |
-\& bind_type => [image => DBI::SQL_BLOB] |
|
732 |
-\& bind_type => [[qw/image audio/] => DBI::SQL_BLOB] |
|
733 |
-.Ve |
|
734 |
-.Sp |
|
735 |
-This is used to bind parameter by \f(CW\*(C`bind_param\*(C'\fR of statment handle. |
|
736 |
-.Sp |
|
737 |
-.Vb 1 |
|
738 |
-\& $sth->bind_param($pos, $value, DBI::SQL_BLOB); |
|
739 |
-.Ve |
|
740 |
-.ie n .IP """table_alias"" \s-1EXPERIMENTAL\s0" 4 |
|
741 |
-.el .IP "\f(CWtable_alias\fR \s-1EXPERIMENTAL\s0" 4 |
|
742 |
-.IX Item "table_alias EXPERIMENTAL" |
|
743 |
-.Vb 1 |
|
744 |
-\& table_alias => {user => 'hiker'} |
|
745 |
-.Ve |
|
746 |
-.Sp |
|
747 |
-Table alias. Key is real table name, value is alias table name. |
|
748 |
-If you set \f(CW\*(C`table_alias\*(C'\fR, you can enable \f(CW\*(C`into1\*(C'\fR and \f(CW\*(C`into2\*(C'\fR type rule |
|
749 |
-on alias table name. |
|
750 |
-.ie n .IP """type_rule_off"" \s-1EXPERIMENTAL\s0" 4 |
|
751 |
-.el .IP "\f(CWtype_rule_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
752 |
-.IX Item "type_rule_off EXPERIMENTAL" |
|
753 |
-.Vb 1 |
|
754 |
-\& type_rule_off => 1 |
|
755 |
-.Ve |
|
756 |
-.Sp |
|
757 |
-Turn \f(CW\*(C`into1\*(C'\fR and \f(CW\*(C`into2\*(C'\fR type rule off. |
|
758 |
-.ie n .IP """type_rule1_off"" \s-1EXPERIMENTAL\s0" 4 |
|
759 |
-.el .IP "\f(CWtype_rule1_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
760 |
-.IX Item "type_rule1_off EXPERIMENTAL" |
|
761 |
-.Vb 1 |
|
762 |
-\& type_rule1_off => 1 |
|
763 |
-.Ve |
|
764 |
-.Sp |
|
765 |
-Turn \f(CW\*(C`into1\*(C'\fR type rule off. |
|
766 |
-.ie n .IP """type_rule2_off"" \s-1EXPERIMENTAL\s0" 4 |
|
767 |
-.el .IP "\f(CWtype_rule2_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
768 |
-.IX Item "type_rule2_off EXPERIMENTAL" |
|
769 |
-.Vb 1 |
|
770 |
-\& type_rule2_off => 1 |
|
771 |
-.Ve |
|
772 |
-.Sp |
|
773 |
-Turn \f(CW\*(C`into2\*(C'\fR type rule off. |
|
774 |
-.ie n .Sh """delete""" |
|
775 |
-.el .Sh "\f(CWdelete\fP" |
|
776 |
-.IX Subsection "delete" |
|
777 |
-.Vb 1 |
|
778 |
-\& $dbi->delete(table => 'book', where => {title => 'Perl'}); |
|
779 |
-.Ve |
|
780 |
-.PP |
|
781 |
-Execute delete statement. |
|
782 |
-.PP |
|
783 |
-The following opitons are available. |
|
784 |
-.ie n .IP """append""" 4 |
|
785 |
-.el .IP "\f(CWappend\fR" 4 |
|
786 |
-.IX Item "append" |
|
787 |
-Same as \f(CW\*(C`select\*(C'\fR method's \f(CW\*(C`append\*(C'\fR option. |
|
788 |
-.ie n .IP """filter""" 4 |
|
789 |
-.el .IP "\f(CWfilter\fR" 4 |
|
790 |
-.IX Item "filter" |
|
791 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`filter\*(C'\fR option. |
|
792 |
-.ie n .IP """id""" 4 |
|
793 |
-.el .IP "\f(CWid\fR" 4 |
|
794 |
-.IX Item "id" |
|
795 |
-.Vb 2 |
|
796 |
-\& id => 4 |
|
797 |
-\& id => [4, 5] |
|
798 |
-.Ve |
|
799 |
-.Sp |
|
800 |
-\&\s-1ID\s0 corresponding to \f(CW\*(C`primary_key\*(C'\fR. |
|
801 |
-You can delete rows by \f(CW\*(C`id\*(C'\fR and \f(CW\*(C`primary_key\*(C'\fR. |
|
802 |
-.Sp |
|
803 |
-.Vb 5 |
|
804 |
-\& $dbi->delete( |
|
805 |
-\& parimary_key => ['id1', 'id2'], |
|
806 |
-\& id => [4, 5], |
|
807 |
-\& table => 'book', |
|
808 |
-\& ); |
|
809 |
-.Ve |
|
810 |
-.Sp |
|
811 |
-The above is same as the followin one. |
|
812 |
-.Sp |
|
813 |
-.Vb 1 |
|
814 |
-\& $dbi->delete(where => {id1 => 4, id2 => 5}, table => 'book'); |
|
815 |
-.Ve |
|
816 |
-.ie n .IP """prefix""" 4 |
|
817 |
-.el .IP "\f(CWprefix\fR" 4 |
|
818 |
-.IX Item "prefix" |
|
819 |
-.Vb 1 |
|
820 |
-\& prefix => 'some' |
|
821 |
-.Ve |
|
822 |
-.Sp |
|
823 |
-prefix before table name section. |
|
824 |
-.Sp |
|
825 |
-.Vb 1 |
|
826 |
-\& delete some from book |
|
827 |
-.Ve |
|
828 |
-.ie n .IP """query""" 4 |
|
829 |
-.el .IP "\f(CWquery\fR" 4 |
|
830 |
-.IX Item "query" |
|
831 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`query\*(C'\fR option. |
|
832 |
-.ie n .IP """table""" 4 |
|
833 |
-.el .IP "\f(CWtable\fR" 4 |
|
834 |
-.IX Item "table" |
|
835 |
-.Vb 1 |
|
836 |
-\& table => 'book' |
|
837 |
-.Ve |
|
838 |
-.Sp |
|
839 |
-Table name. |
|
840 |
-.ie n .IP """where""" 4 |
|
841 |
-.el .IP "\f(CWwhere\fR" 4 |
|
842 |
-.IX Item "where" |
|
843 |
-Same as \f(CW\*(C`select\*(C'\fR method's \f(CW\*(C`where\*(C'\fR option. |
|
844 |
-.ie n .IP """primary_key""" 4 |
|
845 |
-.el .IP "\f(CWprimary_key\fR" 4 |
|
846 |
-.IX Item "primary_key" |
|
847 |
-See \f(CW\*(C`id\*(C'\fR option. |
|
848 |
-.ie n .IP """bind_type""" 4 |
|
849 |
-.el .IP "\f(CWbind_type\fR" 4 |
|
850 |
-.IX Item "bind_type" |
|
851 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`bind_type\*(C'\fR option. |
|
852 |
-.ie n .IP """type_rule_off"" \s-1EXPERIMENTAL\s0" 4 |
|
853 |
-.el .IP "\f(CWtype_rule_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
854 |
-.IX Item "type_rule_off EXPERIMENTAL" |
|
855 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule_off\*(C'\fR option. |
|
856 |
-.ie n .IP """type_rule1_off"" \s-1EXPERIMENTAL\s0" 4 |
|
857 |
-.el .IP "\f(CWtype_rule1_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
858 |
-.IX Item "type_rule1_off EXPERIMENTAL" |
|
859 |
-.Vb 1 |
|
860 |
-\& type_rule1_off => 1 |
|
861 |
-.Ve |
|
862 |
-.Sp |
|
863 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule1_off\*(C'\fR option. |
|
864 |
-.ie n .IP """type_rule2_off"" \s-1EXPERIMENTAL\s0" 4 |
|
865 |
-.el .IP "\f(CWtype_rule2_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
866 |
-.IX Item "type_rule2_off EXPERIMENTAL" |
|
867 |
-.Vb 1 |
|
868 |
-\& type_rule2_off => 1 |
|
869 |
-.Ve |
|
870 |
-.Sp |
|
871 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule2_off\*(C'\fR option. |
|
872 |
-.ie n .Sh """delete_all""" |
|
873 |
-.el .Sh "\f(CWdelete_all\fP" |
|
874 |
-.IX Subsection "delete_all" |
|
875 |
-.Vb 1 |
|
876 |
-\& $dbi->delete_all(table => $table); |
|
877 |
-.Ve |
|
878 |
-.PP |
|
879 |
-Execute delete statement for all rows. |
|
880 |
-Options is same as \f(CW\*(C`delete\*(C'\fR. |
|
881 |
-.ie n .Sh """insert""" |
|
882 |
-.el .Sh "\f(CWinsert\fP" |
|
883 |
-.IX Subsection "insert" |
|
884 |
-.Vb 1 |
|
885 |
-\& $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
886 |
-.Ve |
|
887 |
-.PP |
|
888 |
-Execute insert statement. First argument is row data. Return value is |
|
889 |
-affected row count. |
|
890 |
-.PP |
|
891 |
-If you want to set constant value to row data, use scalar reference |
|
892 |
-as parameter value. |
|
893 |
-.PP |
|
894 |
-.Vb 1 |
|
895 |
-\& {date => \e"NOW()"} |
|
896 |
-.Ve |
|
897 |
-.PP |
|
898 |
-The following opitons are available. |
|
899 |
-.ie n .IP """append""" 4 |
|
900 |
-.el .IP "\f(CWappend\fR" 4 |
|
901 |
-.IX Item "append" |
|
902 |
-Same as \f(CW\*(C`select\*(C'\fR method's \f(CW\*(C`append\*(C'\fR option. |
|
903 |
-.ie n .IP """filter""" 4 |
|
904 |
-.el .IP "\f(CWfilter\fR" 4 |
|
905 |
-.IX Item "filter" |
|
906 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`filter\*(C'\fR option. |
|
907 |
-.ie n .IP """id""" 4 |
|
908 |
-.el .IP "\f(CWid\fR" 4 |
|
909 |
-.IX Item "id" |
|
910 |
-.Vb 2 |
|
911 |
-\& id => 4 |
|
912 |
-\& id => [4, 5] |
|
913 |
-.Ve |
|
914 |
-.Sp |
|
915 |
-\&\s-1ID\s0 corresponding to \f(CW\*(C`primary_key\*(C'\fR. |
|
916 |
-You can insert a row by \f(CW\*(C`id\*(C'\fR and \f(CW\*(C`primary_key\*(C'\fR. |
|
917 |
-.Sp |
|
918 |
-.Vb 6 |
|
919 |
-\& $dbi->insert( |
|
920 |
-\& {title => 'Perl', author => 'Ken'} |
|
921 |
-\& parimary_key => ['id1', 'id2'], |
|
922 |
-\& id => [4, 5], |
|
923 |
-\& table => 'book' |
|
924 |
-\& ); |
|
925 |
-.Ve |
|
926 |
-.Sp |
|
927 |
-The above is same as the followin one. |
|
928 |
-.Sp |
|
929 |
-.Vb 4 |
|
930 |
-\& $dbi->insert( |
|
931 |
-\& {id1 => 4, id2 => 5, title => 'Perl', author => 'Ken'}, |
|
932 |
-\& table => 'book' |
|
933 |
-\& ); |
|
934 |
-.Ve |
|
935 |
-.ie n .IP """prefix""" 4 |
|
936 |
-.el .IP "\f(CWprefix\fR" 4 |
|
937 |
-.IX Item "prefix" |
|
938 |
-.Vb 1 |
|
939 |
-\& prefix => 'or replace' |
|
940 |
-.Ve |
|
941 |
-.Sp |
|
942 |
-prefix before table name section |
|
943 |
-.Sp |
|
944 |
-.Vb 1 |
|
945 |
-\& insert or replace into book |
|
946 |
-.Ve |
|
947 |
-.ie n .IP """primary_key""" 4 |
|
948 |
-.el .IP "\f(CWprimary_key\fR" 4 |
|
949 |
-.IX Item "primary_key" |
|
950 |
-.Vb 2 |
|
951 |
-\& primary_key => 'id' |
|
952 |
-\& primary_key => ['id1', 'id2'] |
|
953 |
-.Ve |
|
954 |
-.Sp |
|
955 |
-Primary key. This is used by \f(CW\*(C`id\*(C'\fR option. |
|
956 |
-.ie n .IP """query""" 4 |
|
957 |
-.el .IP "\f(CWquery\fR" 4 |
|
958 |
-.IX Item "query" |
|
959 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`query\*(C'\fR option. |
|
960 |
-.ie n .IP """table""" 4 |
|
961 |
-.el .IP "\f(CWtable\fR" 4 |
|
962 |
-.IX Item "table" |
|
963 |
-.Vb 1 |
|
964 |
-\& table => 'book' |
|
965 |
-.Ve |
|
966 |
-.Sp |
|
967 |
-Table name. |
|
968 |
-.ie n .IP """bind_type""" 4 |
|
969 |
-.el .IP "\f(CWbind_type\fR" 4 |
|
970 |
-.IX Item "bind_type" |
|
971 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`bind_type\*(C'\fR option. |
|
972 |
-.ie n .IP """type_rule_off"" \s-1EXPERIMENTAL\s0" 4 |
|
973 |
-.el .IP "\f(CWtype_rule_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
974 |
-.IX Item "type_rule_off EXPERIMENTAL" |
|
975 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule_off\*(C'\fR option. |
|
976 |
-.ie n .IP """type_rule1_off"" \s-1EXPERIMENTAL\s0" 4 |
|
977 |
-.el .IP "\f(CWtype_rule1_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
978 |
-.IX Item "type_rule1_off EXPERIMENTAL" |
|
979 |
-.Vb 1 |
|
980 |
-\& type_rule1_off => 1 |
|
981 |
-.Ve |
|
982 |
-.Sp |
|
983 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule1_off\*(C'\fR option. |
|
984 |
-.ie n .IP """type_rule2_off"" \s-1EXPERIMENTAL\s0" 4 |
|
985 |
-.el .IP "\f(CWtype_rule2_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
986 |
-.IX Item "type_rule2_off EXPERIMENTAL" |
|
987 |
-.Vb 1 |
|
988 |
-\& type_rule2_off => 1 |
|
989 |
-.Ve |
|
990 |
-.Sp |
|
991 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule2_off\*(C'\fR option. |
|
992 |
-.ie n .Sh """insert_param""" |
|
993 |
-.el .Sh "\f(CWinsert_param\fP" |
|
994 |
-.IX Subsection "insert_param" |
|
995 |
-.Vb 1 |
|
996 |
-\& my $insert_param = $dbi->insert_param({title => 'a', age => 2}); |
|
997 |
-.Ve |
|
998 |
-.Sp |
|
999 |
-.RS 4 |
|
1000 |
-Create insert parameters. |
|
1001 |
-.Sp |
|
1002 |
-.Vb 1 |
|
1003 |
-\& (title, author) values (title = :title, age = :age); |
|
1004 |
-.Ve |
|
1005 |
-.ie n .Sh """include_model""" |
|
1006 |
-.el .Sh "\f(CWinclude_model\fP" |
|
1007 |
-.IX Subsection "include_model" |
|
1008 |
-.Vb 1 |
|
1009 |
-\& $dbi->include_model('MyModel'); |
|
1010 |
-.Ve |
|
1011 |
-.Sp |
|
1012 |
-Include models from specified namespace, |
|
1013 |
-the following layout is needed to include models. |
|
1014 |
-.Sp |
|
1015 |
-.Vb 3 |
|
1016 |
-\& lib / MyModel.pm |
|
1017 |
-\& / MyModel / book.pm |
|
1018 |
-\& / company.pm |
|
1019 |
-.Ve |
|
1020 |
-.Sp |
|
1021 |
-Name space module, extending DBIx::Custom::Model. |
|
1022 |
-.Sp |
|
1023 |
-\&\fBMyModel.pm\fR |
|
1024 |
-.Sp |
|
1025 |
-.Vb 2 |
|
1026 |
-\& package MyModel; |
|
1027 |
-\& use DBIx::Custom::Model -base; |
|
1028 |
-.Ve |
|
1029 |
-.Sp |
|
1030 |
-.Vb 1 |
|
1031 |
-\& 1; |
|
1032 |
-.Ve |
|
1033 |
-.Sp |
|
1034 |
-Model modules, extending name space module. |
|
1035 |
-.Sp |
|
1036 |
-\&\fBMyModel/book.pm\fR |
|
1037 |
-.Sp |
|
1038 |
-.Vb 2 |
|
1039 |
-\& package MyModel::book; |
|
1040 |
-\& use MyModel -base; |
|
1041 |
-.Ve |
|
1042 |
-.Sp |
|
1043 |
-.Vb 1 |
|
1044 |
-\& 1; |
|
1045 |
-.Ve |
|
1046 |
-.Sp |
|
1047 |
-\&\fBMyModel/company.pm\fR |
|
1048 |
-.Sp |
|
1049 |
-.Vb 2 |
|
1050 |
-\& package MyModel::company; |
|
1051 |
-\& use MyModel -base; |
|
1052 |
-.Ve |
|
1053 |
-.Sp |
|
1054 |
-.Vb 1 |
|
1055 |
-\& 1; |
|
1056 |
-.Ve |
|
1057 |
-.Sp |
|
1058 |
-MyModel::book and MyModel::company is included by \f(CW\*(C`include_model\*(C'\fR. |
|
1059 |
-.Sp |
|
1060 |
-You can get model object by \f(CW\*(C`model\*(C'\fR. |
|
1061 |
-.Sp |
|
1062 |
-.Vb 2 |
|
1063 |
-\& my $book_model = $dbi->model('book'); |
|
1064 |
-\& my $company_model = $dbi->model('company'); |
|
1065 |
-.Ve |
|
1066 |
-.Sp |
|
1067 |
-See DBIx::Custom::Model to know model features. |
|
1068 |
-.ie n .Sh """map_param"" \s-1EXPERIMENTAL\s0" |
|
1069 |
-.el .Sh "\f(CWmap_param\fP \s-1EXPERIMENTAL\s0" |
|
1070 |
-.IX Subsection "map_param EXPERIMENTAL" |
|
1071 |
-.Vb 8 |
|
1072 |
-\& my $map_param = $dbi->map_param( |
|
1073 |
-\& {id => 1, authro => 'Ken', price => 1900}, |
|
1074 |
-\& 'id' => 'book.id', |
|
1075 |
-\& 'author' => ['book.author' => sub { '%' . $_[0] . '%' }], |
|
1076 |
-\& 'price' => [ |
|
1077 |
-\& 'book.price', {if => sub { length $_[0] }} |
|
1078 |
-\& ] |
|
1079 |
-\& ); |
|
1080 |
-.Ve |
|
1081 |
-.Sp |
|
1082 |
-Map paramters to other key and value. First argument is original |
|
1083 |
-parameter. this is hash reference. Rest argument is mapping. |
|
1084 |
-By default, Mapping is done if the value length is not zero. |
|
1085 |
-.IP "Key mapping" 4 |
|
1086 |
-.IX Item "Key mapping" |
|
1087 |
-.Vb 1 |
|
1088 |
-\& 'id' => 'book.id' |
|
1089 |
-.Ve |
|
1090 |
-.Sp |
|
1091 |
-This is only key mapping. Value is same as original one. |
|
1092 |
-.Sp |
|
1093 |
-.Vb 1 |
|
1094 |
-\& (id => 1) is mapped to ('book.id' => 1) if value length is not zero. |
|
1095 |
-.Ve |
|
1096 |
-.IP "Key and value mapping" 4 |
|
1097 |
-.IX Item "Key and value mapping" |
|
1098 |
-.Vb 1 |
|
1099 |
-\& 'author' => ['book.author' => sub { '%' . $_[0] . '%' }] |
|
1100 |
-.Ve |
|
1101 |
-.Sp |
|
1102 |
-This is key and value mapping. Frist element of array reference |
|
1103 |
-is mapped key name, second element is code reference to map the value. |
|
1104 |
-.Sp |
|
1105 |
-.Vb 2 |
|
1106 |
-\& (author => 'Ken') is mapped to ('book.author' => '%Ken%') |
|
1107 |
-\& if value length is not zero. |
|
1108 |
-.Ve |
|
1109 |
-.IP "Condition" 4 |
|
1110 |
-.IX Item "Condition" |
|
1111 |
-.Vb 3 |
|
1112 |
-\& 'price' => ['book.price', {if => 'exists'}] |
|
1113 |
-\& 'price' => ['book.price', sub { '%' . $_[0] . '%' }, {if => 'exists'}] |
|
1114 |
-\& 'price' => ['book.price', {if => sub { defined shift }}] |
|
1115 |
-.Ve |
|
1116 |
-.Sp |
|
1117 |
-If you need condition, you can sepecify it. this is code reference |
|
1118 |
-or 'exists'. By default, condition is the following one. |
|
1119 |
-.Sp |
|
1120 |
-.Vb 1 |
|
1121 |
-\& sub { defined $_[0] && length $_[0] } |
|
1122 |
-.Ve |
|
1123 |
-.RE |
|
1124 |
-.RS 4 |
|
1125 |
-.ie n .Sh """merge_param""" |
|
1126 |
-.el .Sh "\f(CWmerge_param\fP" |
|
1127 |
-.IX Subsection "merge_param" |
|
1128 |
-.Vb 1 |
|
1129 |
-\& my $param = $dbi->merge_param({key1 => 1}, {key1 => 1, key2 => 2}); |
|
1130 |
-.Ve |
|
1131 |
-.Sp |
|
1132 |
-Merge parameters. |
|
1133 |
-.Sp |
|
1134 |
-.Vb 1 |
|
1135 |
-\& {key1 => [1, 1], key2 => 2} |
|
1136 |
-.Ve |
|
1137 |
-.ie n .Sh """method""" |
|
1138 |
-.el .Sh "\f(CWmethod\fP" |
|
1139 |
-.IX Subsection "method" |
|
1140 |
-.Vb 3 |
|
1141 |
-\& $dbi->method( |
|
1142 |
-\& update_or_insert => sub { |
|
1143 |
-\& my $self = shift; |
|
1144 |
-.Ve |
|
1145 |
-.Sp |
|
1146 |
-.Vb 4 |
|
1147 |
-\& # Process |
|
1148 |
-\& }, |
|
1149 |
-\& find_or_create => sub { |
|
1150 |
-\& my $self = shift; |
|
1151 |
-.Ve |
|
1152 |
-.Sp |
|
1153 |
-.Vb 3 |
|
1154 |
-\& # Process |
|
1155 |
-\& } |
|
1156 |
-\& ); |
|
1157 |
-.Ve |
|
1158 |
-.Sp |
|
1159 |
-Register method. These method is called directly from DBIx::Custom object. |
|
1160 |
-.Sp |
|
1161 |
-.Vb 2 |
|
1162 |
-\& $dbi->update_or_insert; |
|
1163 |
-\& $dbi->find_or_create; |
|
1164 |
-.Ve |
|
1165 |
-.ie n .Sh """model""" |
|
1166 |
-.el .Sh "\f(CWmodel\fP" |
|
1167 |
-.IX Subsection "model" |
|
1168 |
-.Vb 1 |
|
1169 |
-\& my $model = $dbi->model('book'); |
|
1170 |
-.Ve |
|
1171 |
-.Sp |
|
1172 |
-Get a DBIx::Custom::Model object, |
|
1173 |
-.ie n .Sh """mycolumn""" |
|
1174 |
-.el .Sh "\f(CWmycolumn\fP" |
|
1175 |
-.IX Subsection "mycolumn" |
|
1176 |
-.Vb 1 |
|
1177 |
-\& my $column = $self->mycolumn(book => ['author', 'title']); |
|
1178 |
-.Ve |
|
1179 |
-.Sp |
|
1180 |
-Create column clause for myself. The follwoing column clause is created. |
|
1181 |
-.Sp |
|
1182 |
-.Vb 2 |
|
1183 |
-\& book.author as author, |
|
1184 |
-\& book.title as title |
|
1185 |
-.Ve |
|
1186 |
-.ie n .Sh """new""" |
|
1187 |
-.el .Sh "\f(CWnew\fP" |
|
1188 |
-.IX Subsection "new" |
|
1189 |
-.Vb 6 |
|
1190 |
-\& my $dbi = DBIx::Custom->new( |
|
1191 |
-\& dsn => "dbi:mysql:database=dbname", |
|
1192 |
-\& user => 'ken', |
|
1193 |
-\& password => '!LFKD%$&', |
|
1194 |
-\& dbi_option => {mysql_enable_utf8 => 1} |
|
1195 |
-\& ); |
|
1196 |
-.Ve |
|
1197 |
-.Sp |
|
1198 |
-Create a new DBIx::Custom object. |
|
1199 |
-.ie n .Sh """not_exists""" |
|
1200 |
-.el .Sh "\f(CWnot_exists\fP" |
|
1201 |
-.IX Subsection "not_exists" |
|
1202 |
-.Vb 1 |
|
1203 |
-\& my $not_exists = $dbi->not_exists; |
|
1204 |
-.Ve |
|
1205 |
-.Sp |
|
1206 |
-DBIx::Custom::NotExists object, indicating the column is not exists. |
|
1207 |
-This is used by \f(CW\*(C`clause\*(C'\fR of DBIx::Custom::Where . |
|
1208 |
-.ie n .Sh """order"" \s-1EXPERIMENTAL\s0" |
|
1209 |
-.el .Sh "\f(CWorder\fP \s-1EXPERIMENTAL\s0" |
|
1210 |
-.IX Subsection "order EXPERIMENTAL" |
|
1211 |
-.Vb 1 |
|
1212 |
-\& my $order = $dbi->order; |
|
1213 |
-.Ve |
|
1214 |
-.Sp |
|
1215 |
-Create a new DBIx::Custom::Order object. |
|
1216 |
-.ie n .Sh """register_filter""" |
|
1217 |
-.el .Sh "\f(CWregister_filter\fP" |
|
1218 |
-.IX Subsection "register_filter" |
|
1219 |
-.Vb 12 |
|
1220 |
-\& $dbi->register_filter( |
|
1221 |
-\& # Time::Piece object to database DATE format |
|
1222 |
-\& tp_to_date => sub { |
|
1223 |
-\& my $tp = shift; |
|
1224 |
-\& return $tp->strftime('%Y-%m-%d'); |
|
1225 |
-\& }, |
|
1226 |
-\& # database DATE format to Time::Piece object |
|
1227 |
-\& date_to_tp => sub { |
|
1228 |
-\& my $date = shift; |
|
1229 |
-\& return Time::Piece->strptime($date, '%Y-%m-%d'); |
|
1230 |
-\& } |
|
1231 |
-\& ); |
|
1232 |
-.Ve |
|
1233 |
-.Sp |
|
1234 |
-Register filters, used by \f(CW\*(C`filter\*(C'\fR option of many methods. |
|
1235 |
-.ie n .Sh """type_rule"" \s-1EXPERIMENTAL\s0" |
|
1236 |
-.el .Sh "\f(CWtype_rule\fP \s-1EXPERIMENTAL\s0" |
|
1237 |
-.IX Subsection "type_rule EXPERIMENTAL" |
|
1238 |
-.Vb 22 |
|
1239 |
-\& $dbi->type_rule( |
|
1240 |
-\& into1 => { |
|
1241 |
-\& date => sub { ... }, |
|
1242 |
-\& datetime => sub { ... } |
|
1243 |
-\& }, |
|
1244 |
-\& into2 => { |
|
1245 |
-\& date => sub { ... }, |
|
1246 |
-\& datetime => sub { ... } |
|
1247 |
-\& }, |
|
1248 |
-\& from1 => { |
|
1249 |
-\& # DATE |
|
1250 |
-\& 9 => sub { ... }, |
|
1251 |
-\& # DATETIME or TIMESTAMP |
|
1252 |
-\& 11 => sub { ... }, |
|
1253 |
-\& } |
|
1254 |
-\& from2 => { |
|
1255 |
-\& # DATE |
|
1256 |
-\& 9 => sub { ... }, |
|
1257 |
-\& # DATETIME or TIMESTAMP |
|
1258 |
-\& 11 => sub { ... }, |
|
1259 |
-\& } |
|
1260 |
-\& ); |
|
1261 |
-.Ve |
|
1262 |
-.Sp |
|
1263 |
-Filtering rule when data is send into and get from database. |
|
1264 |
-This has a little complex problem. |
|
1265 |
-.Sp |
|
1266 |
-In \f(CW\*(C`into1\*(C'\fR and \f(CW\*(C`into2\*(C'\fR you can specify |
|
1267 |
-type name as same as type name defined |
|
1268 |
-by create table, such as \f(CW\*(C`DATETIME\*(C'\fR or \f(CW\*(C`DATE\*(C'\fR. |
|
1269 |
-.Sp |
|
1270 |
-Note that type name and data type don't contain upper case. |
|
1271 |
-If these contain upper case charactor, you convert it to lower case. |
|
1272 |
-.Sp |
|
1273 |
-\&\f(CW\*(C`into2\*(C'\fR is executed after \f(CW\*(C`into1\*(C'\fR. |
|
1274 |
-.Sp |
|
1275 |
-Type rule of \f(CW\*(C`into1\*(C'\fR and \f(CW\*(C`into2\*(C'\fR is enabled on the following |
|
1276 |
-column name. |
|
1277 |
-.IP "1. column name" 4 |
|
1278 |
-.IX Item "1. column name" |
|
1279 |
-.Vb 2 |
|
1280 |
-\& issue_date |
|
1281 |
-\& issue_datetime |
|
1282 |
-.Ve |
|
1283 |
-.Sp |
|
1284 |
-This need \f(CW\*(C`table\*(C'\fR option in each method. |
|
1285 |
-.IP "2. table name and column name, separator is dot" 4 |
|
1286 |
-.IX Item "2. table name and column name, separator is dot" |
|
1287 |
-.Vb 2 |
|
1288 |
-\& book.issue_date |
|
1289 |
-\& book.issue_datetime |
|
1290 |
-.Ve |
|
1291 |
-.RE |
|
1292 |
-.RS 4 |
|
1293 |
-.Sp |
|
1294 |
-You get all type name used in database by \f(CW\*(C`available_type_name\*(C'\fR. |
|
1295 |
-.Sp |
|
1296 |
-.Vb 1 |
|
1297 |
-\& print $dbi->available_type_name; |
|
1298 |
-.Ve |
|
1299 |
-.Sp |
|
1300 |
-In \f(CW\*(C`from1\*(C'\fR and \f(CW\*(C`from2\*(C'\fR you specify data type, not type name. |
|
1301 |
-\&\f(CW\*(C`from2\*(C'\fR is executed after \f(CW\*(C`from1\*(C'\fR. |
|
1302 |
-You get all data type by \f(CW\*(C`available_data_type\*(C'\fR. |
|
1303 |
-.Sp |
|
1304 |
-.Vb 1 |
|
1305 |
-\& print $dbi->available_data_type; |
|
1306 |
-.Ve |
|
1307 |
-.Sp |
|
1308 |
-You can also specify multiple types at once. |
|
1309 |
-.Sp |
|
1310 |
-.Vb 5 |
|
1311 |
-\& $dbi->type_rule( |
|
1312 |
-\& into1 => [ |
|
1313 |
-\& [qw/DATE DATETIME/] => sub { ... }, |
|
1314 |
-\& ], |
|
1315 |
-\& ); |
|
1316 |
-.Ve |
|
1317 |
-.ie n .Sh """select""" |
|
1318 |
-.el .Sh "\f(CWselect\fP" |
|
1319 |
-.IX Subsection "select" |
|
1320 |
-.Vb 5 |
|
1321 |
-\& my $result = $dbi->select( |
|
1322 |
-\& table => 'book', |
|
1323 |
-\& column => ['author', 'title'], |
|
1324 |
-\& where => {author => 'Ken'}, |
|
1325 |
-\& ); |
|
1326 |
-.Ve |
|
1327 |
-.Sp |
|
1328 |
-Execute select statement. |
|
1329 |
-.Sp |
|
1330 |
-The following opitons are available. |
|
1331 |
-.ie n .IP """append""" 4 |
|
1332 |
-.el .IP "\f(CWappend\fR" 4 |
|
1333 |
-.IX Item "append" |
|
1334 |
-.Vb 1 |
|
1335 |
-\& append => 'order by title' |
|
1336 |
-.Ve |
|
1337 |
-.Sp |
|
1338 |
-Append statement to last of \s-1SQL\s0. |
|
1339 |
-.ie n .IP """column""" 4 |
|
1340 |
-.el .IP "\f(CWcolumn\fR" 4 |
|
1341 |
-.IX Item "column" |
|
1342 |
-.Vb 2 |
|
1343 |
-\& column => 'author' |
|
1344 |
-\& column => ['author', 'title'] |
|
1345 |
-.Ve |
|
1346 |
-.Sp |
|
1347 |
-Column clause. |
|
1348 |
-.Sp |
|
1349 |
-if \f(CW\*(C`column\*(C'\fR is not specified, '*' is set. |
|
1350 |
-.Sp |
|
1351 |
-.Vb 1 |
|
1352 |
-\& column => '*' |
|
1353 |
-.Ve |
|
1354 |
-.Sp |
|
1355 |
-You can specify hash of array reference. |
|
1356 |
-.Sp |
|
1357 |
-.Vb 4 |
|
1358 |
-\& column => [ |
|
1359 |
-\& {book => [qw/author title/]}, |
|
1360 |
-\& {person => [qw/name age/]} |
|
1361 |
-\& ] |
|
1362 |
-.Ve |
|
1363 |
-.Sp |
|
1364 |
-This is expanded to the following one by using \f(CW\*(C`colomn\*(C'\fR method. |
|
1365 |
-.Sp |
|
1366 |
-.Vb 4 |
|
1367 |
-\& book.author as "book.author", |
|
1368 |
-\& book.title as "book.title", |
|
1369 |
-\& person.name as "person.name", |
|
1370 |
-\& person.age as "person.age" |
|
1371 |
-.Ve |
|
1372 |
-.Sp |
|
1373 |
-You can specify array of array reference, first argument is |
|
1374 |
-column name, second argument is alias. |
|
1375 |
-.Sp |
|
1376 |
-.Vb 3 |
|
1377 |
-\& column => [ |
|
1378 |
-\& ['date(book.register_datetime)' => 'book.register_date'] |
|
1379 |
-\& ]; |
|
1380 |
-.Ve |
|
1381 |
-.Sp |
|
1382 |
-Alias is quoted properly and joined. |
|
1383 |
-.Sp |
|
1384 |
-.Vb 1 |
|
1385 |
-\& date(book.register_datetime) as "book.register_date" |
|
1386 |
-.Ve |
|
1387 |
-.ie n .IP """filter""" 4 |
|
1388 |
-.el .IP "\f(CWfilter\fR" 4 |
|
1389 |
-.IX Item "filter" |
|
1390 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`filter\*(C'\fR option. |
|
1391 |
-.ie n .IP """id""" 4 |
|
1392 |
-.el .IP "\f(CWid\fR" 4 |
|
1393 |
-.IX Item "id" |
|
1394 |
-.Vb 2 |
|
1395 |
-\& id => 4 |
|
1396 |
-\& id => [4, 5] |
|
1397 |
-.Ve |
|
1398 |
-.Sp |
|
1399 |
-\&\s-1ID\s0 corresponding to \f(CW\*(C`primary_key\*(C'\fR. |
|
1400 |
-You can select rows by \f(CW\*(C`id\*(C'\fR and \f(CW\*(C`primary_key\*(C'\fR. |
|
1401 |
-.Sp |
|
1402 |
-.Vb 5 |
|
1403 |
-\& $dbi->select( |
|
1404 |
-\& parimary_key => ['id1', 'id2'], |
|
1405 |
-\& id => [4, 5], |
|
1406 |
-\& table => 'book' |
|
1407 |
-\& ); |
|
1408 |
-.Ve |
|
1409 |
-.Sp |
|
1410 |
-The above is same as the followin one. |
|
1411 |
-.Sp |
|
1412 |
-.Vb 4 |
|
1413 |
-\& $dbi->select( |
|
1414 |
-\& where => {id1 => 4, id2 => 5}, |
|
1415 |
-\& table => 'book' |
|
1416 |
-\& ); |
|
1417 |
-.Ve |
|
1418 |
-.ie n .IP """param"" \s-1EXPERIMETNAL\s0" 4 |
|
1419 |
-.el .IP "\f(CWparam\fR \s-1EXPERIMETNAL\s0" 4 |
|
1420 |
-.IX Item "param EXPERIMETNAL" |
|
1421 |
-.Vb 1 |
|
1422 |
-\& param => {'table2.key3' => 5} |
|
1423 |
-.Ve |
|
1424 |
-.Sp |
|
1425 |
-Parameter shown before where clause. |
|
1426 |
-.Sp |
|
1427 |
-For example, if you want to contain tag in join clause, |
|
1428 |
-you can pass parameter by \f(CW\*(C`param\*(C'\fR option. |
|
1429 |
-.Sp |
|
1430 |
-.Vb 2 |
|
1431 |
-\& join => ['inner join (select * from table2 where table2.key3 = :table2.key3)' . |
|
1432 |
-\& ' as table2 on table1.key1 = table2.key1'] |
|
1433 |
-.Ve |
|
1434 |
-.Sp |
|
1435 |
-.Vb 1 |
|
1436 |
-\& prefix => 'SQL_CALC_FOUND_ROWS' |
|
1437 |
-.Ve |
|
1438 |
-.Sp |
|
1439 |
-Prefix of column cluase |
|
1440 |
-.Sp |
|
1441 |
-.Vb 1 |
|
1442 |
-\& select SQL_CALC_FOUND_ROWS title, author from book; |
|
1443 |
-.Ve |
|
1444 |
-.ie n .IP """join""" 4 |
|
1445 |
-.el .IP "\f(CWjoin\fR" 4 |
|
1446 |
-.IX Item "join" |
|
1447 |
-.Vb 4 |
|
1448 |
-\& join => [ |
|
1449 |
-\& 'left outer join company on book.company_id = company_id', |
|
1450 |
-\& 'left outer join location on company.location_id = location.id' |
|
1451 |
-\& ] |
|
1452 |
-.Ve |
|
1453 |
-.Sp |
|
1454 |
-Join clause. If column cluase or where clause contain table name like \*(L"company.name\*(R", |
|
1455 |
-join clausees needed when \s-1SQL\s0 is created is used automatically. |
|
1456 |
-.Sp |
|
1457 |
-.Vb 9 |
|
1458 |
-\& $dbi->select( |
|
1459 |
-\& table => 'book', |
|
1460 |
-\& column => ['company.location_id as location_id'], |
|
1461 |
-\& where => {'company.name' => 'Orange'}, |
|
1462 |
-\& join => [ |
|
1463 |
-\& 'left outer join company on book.company_id = company.id', |
|
1464 |
-\& 'left outer join location on company.location_id = location.id' |
|
1465 |
-\& ] |
|
1466 |
-\& ); |
|
1467 |
-.Ve |
|
1468 |
-.Sp |
|
1469 |
-In above select, column and where clause contain \*(L"company\*(R" table, |
|
1470 |
-the following \s-1SQL\s0 is created |
|
1471 |
-.Sp |
|
1472 |
-.Vb 4 |
|
1473 |
-\& select company.location_id as location_id |
|
1474 |
-\& from book |
|
1475 |
-\& left outer join company on book.company_id = company.id |
|
1476 |
-\& where company.name = ?; |
|
1477 |
-.Ve |
|
1478 |
-.Sp |
|
1479 |
-You can specify two table by yourself. This is useful when join parser can't parse |
|
1480 |
-the join clause correctly. This is \s-1EXPERIMENTAL\s0. |
|
1481 |
-.Sp |
|
1482 |
-.Vb 11 |
|
1483 |
-\& $dbi->select( |
|
1484 |
-\& table => 'book', |
|
1485 |
-\& column => ['company.location_id as location_id'], |
|
1486 |
-\& where => {'company.name' => 'Orange'}, |
|
1487 |
-\& join => [ |
|
1488 |
-\& { |
|
1489 |
-\& clause => 'left outer join location on company.location_id = location.id', |
|
1490 |
-\& table => ['company', 'location'] |
|
1491 |
-\& } |
|
1492 |
-\& ] |
|
1493 |
-\& ); |
|
1494 |
-.Ve |
|
1495 |
-.ie n .IP """primary_key""" 4 |
|
1496 |
-.el .IP "\f(CWprimary_key\fR" 4 |
|
1497 |
-.IX Item "primary_key" |
|
1498 |
-.Vb 2 |
|
1499 |
-\& primary_key => 'id' |
|
1500 |
-\& primary_key => ['id1', 'id2'] |
|
1501 |
-.Ve |
|
1502 |
-.Sp |
|
1503 |
-Primary key. This is used by \f(CW\*(C`id\*(C'\fR option. |
|
1504 |
-.ie n .IP """query""" 4 |
|
1505 |
-.el .IP "\f(CWquery\fR" 4 |
|
1506 |
-.IX Item "query" |
|
1507 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`query\*(C'\fR option. |
|
1508 |
-.ie n .IP """bind_type""" 4 |
|
1509 |
-.el .IP "\f(CWbind_type\fR" 4 |
|
1510 |
-.IX Item "bind_type" |
|
1511 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`bind_type\*(C'\fR option. |
|
1512 |
-.ie n .IP """table""" 4 |
|
1513 |
-.el .IP "\f(CWtable\fR" 4 |
|
1514 |
-.IX Item "table" |
|
1515 |
-.Vb 1 |
|
1516 |
-\& table => 'book' |
|
1517 |
-.Ve |
|
1518 |
-.Sp |
|
1519 |
-Table name. |
|
1520 |
-.ie n .IP """type_rule_off"" \s-1EXPERIMENTAL\s0" 4 |
|
1521 |
-.el .IP "\f(CWtype_rule_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
1522 |
-.IX Item "type_rule_off EXPERIMENTAL" |
|
1523 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule_off\*(C'\fR option. |
|
1524 |
-.ie n .IP """type_rule1_off"" \s-1EXPERIMENTAL\s0" 4 |
|
1525 |
-.el .IP "\f(CWtype_rule1_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
1526 |
-.IX Item "type_rule1_off EXPERIMENTAL" |
|
1527 |
-.Vb 1 |
|
1528 |
-\& type_rule1_off => 1 |
|
1529 |
-.Ve |
|
1530 |
-.Sp |
|
1531 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule1_off\*(C'\fR option. |
|
1532 |
-.ie n .IP """type_rule2_off"" \s-1EXPERIMENTAL\s0" 4 |
|
1533 |
-.el .IP "\f(CWtype_rule2_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
1534 |
-.IX Item "type_rule2_off EXPERIMENTAL" |
|
1535 |
-.Vb 1 |
|
1536 |
-\& type_rule2_off => 1 |
|
1537 |
-.Ve |
|
1538 |
-.Sp |
|
1539 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule2_off\*(C'\fR option. |
|
1540 |
-.ie n .IP """where""" 4 |
|
1541 |
-.el .IP "\f(CWwhere\fR" 4 |
|
1542 |
-.IX Item "where" |
|
1543 |
-.Vb 2 |
|
1544 |
-\& # Hash refrence |
|
1545 |
-\& where => {author => 'Ken', 'title' => 'Perl'} |
|
1546 |
-.Ve |
|
1547 |
-.Sp |
|
1548 |
-.Vb 5 |
|
1549 |
-\& # DBIx::Custom::Where object |
|
1550 |
-\& where => $dbi->where( |
|
1551 |
-\& clause => ['and', 'author = :author', 'title like :title'], |
|
1552 |
-\& param => {author => 'Ken', title => '%Perl%'} |
|
1553 |
-\& ); |
|
1554 |
-.Ve |
|
1555 |
-.Sp |
|
1556 |
-.Vb 5 |
|
1557 |
-\& # Array reference 1 (array reference, hash referenc). same as above |
|
1558 |
-\& where => [ |
|
1559 |
-\& ['and', 'author = :author', 'title like :title'], |
|
1560 |
-\& {author => 'Ken', title => '%Perl%'} |
|
1561 |
-\& ]; |
|
1562 |
-.Ve |
|
1563 |
-.Sp |
|
1564 |
-.Vb 5 |
|
1565 |
-\& # Array reference 2 (String, hash reference) |
|
1566 |
-\& where => [ |
|
1567 |
-\& 'title like :title', |
|
1568 |
-\& {title => '%Perl%'} |
|
1569 |
-\& ] |
|
1570 |
-.Ve |
|
1571 |
-.Sp |
|
1572 |
-.Vb 2 |
|
1573 |
-\& # String |
|
1574 |
-\& where => 'title is null' |
|
1575 |
-.Ve |
|
1576 |
-.Sp |
|
1577 |
-Where clause. |
|
1578 |
-.ie n .IP """wrap"" \s-1EXPERIMENTAL\s0" 4 |
|
1579 |
-.el .IP "\f(CWwrap\fR \s-1EXPERIMENTAL\s0" 4 |
|
1580 |
-.IX Item "wrap EXPERIMENTAL" |
|
1581 |
-Wrap statement. This is array reference. |
|
1582 |
-.Sp |
|
1583 |
-.Vb 1 |
|
1584 |
-\& $dbi->select(wrap => ['select * from (', ') as t where ROWNUM < 10']); |
|
1585 |
-.Ve |
|
1586 |
-.Sp |
|
1587 |
-This option is for Oracle and \s-1SQL\s0 Server paging process. |
|
1588 |
-.RE |
|
1589 |
-.RS 4 |
|
1590 |
-.ie n .Sh """update""" |
|
1591 |
-.el .Sh "\f(CWupdate\fP" |
|
1592 |
-.IX Subsection "update" |
|
1593 |
-.Vb 1 |
|
1594 |
-\& $dbi->update({title => 'Perl'}, table => 'book', where => {id => 4}); |
|
1595 |
-.Ve |
|
1596 |
-.Sp |
|
1597 |
-Execute update statement. First argument is update row data. |
|
1598 |
-.Sp |
|
1599 |
-If you want to set constant value to row data, use scalar reference |
|
1600 |
-as parameter value. |
|
1601 |
-.Sp |
|
1602 |
-.Vb 1 |
|
1603 |
-\& {date => \e"NOW()"} |
|
1604 |
-.Ve |
|
1605 |
-.Sp |
|
1606 |
-The following opitons are available. |
|
1607 |
-.ie n .IP """append""" 4 |
|
1608 |
-.el .IP "\f(CWappend\fR" 4 |
|
1609 |
-.IX Item "append" |
|
1610 |
-Same as \f(CW\*(C`select\*(C'\fR method's \f(CW\*(C`append\*(C'\fR option. |
|
1611 |
-.ie n .IP """filter""" 4 |
|
1612 |
-.el .IP "\f(CWfilter\fR" 4 |
|
1613 |
-.IX Item "filter" |
|
1614 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`filter\*(C'\fR option. |
|
1615 |
-.ie n .IP """id""" 4 |
|
1616 |
-.el .IP "\f(CWid\fR" 4 |
|
1617 |
-.IX Item "id" |
|
1618 |
-.Vb 2 |
|
1619 |
-\& id => 4 |
|
1620 |
-\& id => [4, 5] |
|
1621 |
-.Ve |
|
1622 |
-.Sp |
|
1623 |
-\&\s-1ID\s0 corresponding to \f(CW\*(C`primary_key\*(C'\fR. |
|
1624 |
-You can update rows by \f(CW\*(C`id\*(C'\fR and \f(CW\*(C`primary_key\*(C'\fR. |
|
1625 |
-.Sp |
|
1626 |
-.Vb 6 |
|
1627 |
-\& $dbi->update( |
|
1628 |
-\& {title => 'Perl', author => 'Ken'} |
|
1629 |
-\& parimary_key => ['id1', 'id2'], |
|
1630 |
-\& id => [4, 5], |
|
1631 |
-\& table => 'book' |
|
1632 |
-\& ); |
|
1633 |
-.Ve |
|
1634 |
-.Sp |
|
1635 |
-The above is same as the followin one. |
|
1636 |
-.Sp |
|
1637 |
-.Vb 5 |
|
1638 |
-\& $dbi->update( |
|
1639 |
-\& {title => 'Perl', author => 'Ken'} |
|
1640 |
-\& where => {id1 => 4, id2 => 5}, |
|
1641 |
-\& table => 'book' |
|
1642 |
-\& ); |
|
1643 |
-.Ve |
|
1644 |
-.ie n .IP """prefix""" 4 |
|
1645 |
-.el .IP "\f(CWprefix\fR" 4 |
|
1646 |
-.IX Item "prefix" |
|
1647 |
-.Vb 1 |
|
1648 |
-\& prefix => 'or replace' |
|
1649 |
-.Ve |
|
1650 |
-.Sp |
|
1651 |
-prefix before table name section |
|
1652 |
-.Sp |
|
1653 |
-.Vb 1 |
|
1654 |
-\& update or replace book |
|
1655 |
-.Ve |
|
1656 |
-.ie n .IP """primary_key""" 4 |
|
1657 |
-.el .IP "\f(CWprimary_key\fR" 4 |
|
1658 |
-.IX Item "primary_key" |
|
1659 |
-.Vb 2 |
|
1660 |
-\& primary_key => 'id' |
|
1661 |
-\& primary_key => ['id1', 'id2'] |
|
1662 |
-.Ve |
|
1663 |
-.Sp |
|
1664 |
-Primary key. This is used by \f(CW\*(C`id\*(C'\fR option. |
|
1665 |
-.ie n .IP """query""" 4 |
|
1666 |
-.el .IP "\f(CWquery\fR" 4 |
|
1667 |
-.IX Item "query" |
|
1668 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`query\*(C'\fR option. |
|
1669 |
-.ie n .IP """table""" 4 |
|
1670 |
-.el .IP "\f(CWtable\fR" 4 |
|
1671 |
-.IX Item "table" |
|
1672 |
-.Vb 1 |
|
1673 |
-\& table => 'book' |
|
1674 |
-.Ve |
|
1675 |
-.Sp |
|
1676 |
-Table name. |
|
1677 |
-.ie n .IP """where""" 4 |
|
1678 |
-.el .IP "\f(CWwhere\fR" 4 |
|
1679 |
-.IX Item "where" |
|
1680 |
-Same as \f(CW\*(C`select\*(C'\fR method's \f(CW\*(C`where\*(C'\fR option. |
|
1681 |
-.ie n .IP """bind_type""" 4 |
|
1682 |
-.el .IP "\f(CWbind_type\fR" 4 |
|
1683 |
-.IX Item "bind_type" |
|
1684 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`bind_type\*(C'\fR option. |
|
1685 |
-.ie n .IP """type_rule_off"" \s-1EXPERIMENTAL\s0" 4 |
|
1686 |
-.el .IP "\f(CWtype_rule_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
1687 |
-.IX Item "type_rule_off EXPERIMENTAL" |
|
1688 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule_off\*(C'\fR option. |
|
1689 |
-.ie n .IP """type_rule1_off"" \s-1EXPERIMENTAL\s0" 4 |
|
1690 |
-.el .IP "\f(CWtype_rule1_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
1691 |
-.IX Item "type_rule1_off EXPERIMENTAL" |
|
1692 |
-.Vb 1 |
|
1693 |
-\& type_rule1_off => 1 |
|
1694 |
-.Ve |
|
1695 |
-.Sp |
|
1696 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule1_off\*(C'\fR option. |
|
1697 |
-.ie n .IP """type_rule2_off"" \s-1EXPERIMENTAL\s0" 4 |
|
1698 |
-.el .IP "\f(CWtype_rule2_off\fR \s-1EXPERIMENTAL\s0" 4 |
|
1699 |
-.IX Item "type_rule2_off EXPERIMENTAL" |
|
1700 |
-.Vb 1 |
|
1701 |
-\& type_rule2_off => 1 |
|
1702 |
-.Ve |
|
1703 |
-.Sp |
|
1704 |
-Same as \f(CW\*(C`execute\*(C'\fR method's \f(CW\*(C`type_rule2_off\*(C'\fR option. |
|
1705 |
-.RE |
|
1706 |
-.RS 4 |
|
1707 |
-.ie n .Sh """update_all""" |
|
1708 |
-.el .Sh "\f(CWupdate_all\fP" |
|
1709 |
-.IX Subsection "update_all" |
|
1710 |
-.Vb 1 |
|
1711 |
-\& $dbi->update_all({title => 'Perl'}, table => 'book', ); |
|
1712 |
-.Ve |
|
1713 |
-.Sp |
|
1714 |
-Execute update statement for all rows. |
|
1715 |
-Options is same as \f(CW\*(C`update\*(C'\fR method. |
|
1716 |
-.ie n .Sh """update_param""" |
|
1717 |
-.el .Sh "\f(CWupdate_param\fP" |
|
1718 |
-.IX Subsection "update_param" |
|
1719 |
-.Vb 1 |
|
1720 |
-\& my $update_param = $dbi->update_param({title => 'a', age => 2}); |
|
1721 |
-.Ve |
|
1722 |
-.Sp |
|
1723 |
-Create update parameter tag. |
|
1724 |
-.Sp |
|
1725 |
-.Vb 1 |
|
1726 |
-\& set title = :title, author = :author |
|
1727 |
-.Ve |
|
1728 |
-.ie n .Sh """where""" |
|
1729 |
-.el .Sh "\f(CWwhere\fP" |
|
1730 |
-.IX Subsection "where" |
|
1731 |
-.Vb 4 |
|
1732 |
-\& my $where = $dbi->where( |
|
1733 |
-\& clause => ['and', 'title = :title', 'author = :author'], |
|
1734 |
-\& param => {title => 'Perl', author => 'Ken'} |
|
1735 |
-\& ); |
|
1736 |
-.Ve |
|
1737 |
-.Sp |
|
1738 |
-Create a new DBIx::Custom::Where object. |
|
1739 |
-.ie n .Sh """setup_model""" |
|
1740 |
-.el .Sh "\f(CWsetup_model\fP" |
|
1741 |
-.IX Subsection "setup_model" |
|
1742 |
-.Vb 1 |
|
1743 |
-\& $dbi->setup_model; |
|
1744 |
-.Ve |
|
1745 |
-.Sp |
|
1746 |
-Setup all model objects. |
|
1747 |
-\&\f(CW\*(C`columns\*(C'\fR of model object is automatically set, parsing database information. |
|
1748 |
-.SH "ENVIRONMENT VARIABLE" |
|
1749 |
-.IX Header "ENVIRONMENT VARIABLE" |
|
1750 |
-.ie n .Sh """DBIX_CUSTOM_DEBUG""" |
|
1751 |
-.el .Sh "\f(CWDBIX_CUSTOM_DEBUG\fP" |
|
1752 |
-.IX Subsection "DBIX_CUSTOM_DEBUG" |
|
1753 |
-If environment variable \f(CW\*(C`DBIX_CUSTOM_DEBUG\*(C'\fR is set to true, |
|
1754 |
-executed \s-1SQL\s0 and bind values are printed to \s-1STDERR\s0. |
|
1755 |
-.ie n .Sh """DBIX_CUSTOM_DEBUG_ENCODING""" |
|
1756 |
-.el .Sh "\f(CWDBIX_CUSTOM_DEBUG_ENCODING\fP" |
|
1757 |
-.IX Subsection "DBIX_CUSTOM_DEBUG_ENCODING" |
|
1758 |
-\&\s-1DEBUG\s0 output encoding. Default to \s-1UTF\-8\s0. |
|
1759 |
-.SH "DEPRECATED FUNCTIONALITIES" |
|
1760 |
-.IX Header "DEPRECATED FUNCTIONALITIES" |
|
1761 |
-DBIx::Custom |
|
1762 |
-.Sp |
|
1763 |
-.Vb 6 |
|
1764 |
-\& # Attribute methods |
|
1765 |
-\& data_source # will be removed at 2017/1/1 |
|
1766 |
-\& dbi_options # will be removed at 2017/1/1 |
|
1767 |
-\& filter_check # will be removed at 2017/1/1 |
|
1768 |
-\& reserved_word_quote # will be removed at 2017/1/1 |
|
1769 |
-\& cache_method # will be removed at 2017/1/1 |
|
1770 |
-.Ve |
|
1771 |
-.Sp |
|
1772 |
-.Vb 13 |
|
1773 |
-\& # Methods |
|
1774 |
-\& create_query # will be removed at 2017/1/1 |
|
1775 |
-\& apply_filter # will be removed at 2017/1/1 |
|
1776 |
-\& select_at # will be removed at 2017/1/1 |
|
1777 |
-\& delete_at # will be removed at 2017/1/1 |
|
1778 |
-\& update_at # will be removed at 2017/1/1 |
|
1779 |
-\& insert_at # will be removed at 2017/1/1 |
|
1780 |
-\& register_tag # will be removed at 2017/1/1 |
|
1781 |
-\& default_bind_filter # will be removed at 2017/1/1 |
|
1782 |
-\& default_fetch_filter # will be removed at 2017/1/1 |
|
1783 |
-\& insert_param_tag # will be removed at 2017/1/1 |
|
1784 |
-\& register_tag_processor # will be removed at 2017/1/1 |
|
1785 |
-\& update_param_tag # will be removed at 2017/1/1 |
|
1786 |
-.Ve |
|
1787 |
-.Sp |
|
1788 |
-.Vb 5 |
|
1789 |
-\& # Options |
|
1790 |
-\& select method relation option # will be removed at 2017/1/1 |
|
1791 |
-\& select method param option # will be removed at 2017/1/1 |
|
1792 |
-\& select method column option [COLUMN, as => ALIAS] format |
|
1793 |
-\& # will be removed at 2017/1/1 |
|
1794 |
-.Ve |
|
1795 |
-.Sp |
|
1796 |
-.Vb 5 |
|
1797 |
-\& # Others |
|
1798 |
-\& execute("select * from {= title}"); # execute method's |
|
1799 |
-\& # tag parsing functionality |
|
1800 |
-\& # will be removed at 2017/1/1 |
|
1801 |
-\& Query caching # will be removed at 2017/1/1 |
|
1802 |
-.Ve |
|
1803 |
-.Sp |
|
1804 |
-DBIx::Custom::Model |
|
1805 |
-.Sp |
|
1806 |
-.Vb 4 |
|
1807 |
-\& # Attribute methods |
|
1808 |
-\& filter # will be removed at 2017/1/1 |
|
1809 |
-\& name # will be removed at 2017/1/1 |
|
1810 |
-\& type # will be removed at 2017/1/1 |
|
1811 |
-.Ve |
|
1812 |
-.Sp |
|
1813 |
-DBIx::Custom::Query |
|
1814 |
-.Sp |
|
1815 |
-.Vb 4 |
|
1816 |
-\& # Attribute methods |
|
1817 |
-\& default_filter # will be removed at 2017/1/1 |
|
1818 |
-\& table # will be removed at 2017/1/1 |
|
1819 |
-\& filters # will be removed at 2017/1/1 |
|
1820 |
-.Ve |
|
1821 |
-.Sp |
|
1822 |
-.Vb 2 |
|
1823 |
-\& # Methods |
|
1824 |
-\& filter # will be removed at 2017/1/1 |
|
1825 |
-.Ve |
|
1826 |
-.Sp |
|
1827 |
-DBIx::Custom::QueryBuilder |
|
1828 |
-.Sp |
|
1829 |
-.Vb 3 |
|
1830 |
-\& # Attribute methods |
|
1831 |
-\& tags # will be removed at 2017/1/1 |
|
1832 |
-\& tag_processors # will be removed at 2017/1/1 |
|
1833 |
-.Ve |
|
1834 |
-.Sp |
|
1835 |
-.Vb 3 |
|
1836 |
-\& # Methods |
|
1837 |
-\& register_tag # will be removed at 2017/1/1 |
|
1838 |
-\& register_tag_processor # will be removed at 2017/1/1 |
|
1839 |
-.Ve |
|
1840 |
-.Sp |
|
1841 |
-.Vb 3 |
|
1842 |
-\& # Others |
|
1843 |
-\& build_query("select * from {= title}"); # tag parsing functionality |
|
1844 |
-\& # will be removed at 2017/1/1 |
|
1845 |
-.Ve |
|
1846 |
-.Sp |
|
1847 |
-DBIx::Custom::Result |
|
1848 |
-.Sp |
|
1849 |
-.Vb 2 |
|
1850 |
-\& # Attribute methods |
|
1851 |
-\& filter_check # will be removed at 2017/1/1 |
|
1852 |
-.Ve |
|
1853 |
-.Sp |
|
1854 |
-.Vb 5 |
|
1855 |
-\& # Methods |
|
1856 |
-\& end_filter # will be removed at 2017/1/1 |
|
1857 |
-\& remove_end_filter # will be removed at 2017/1/1 |
|
1858 |
-\& remove_filter # will be removed at 2017/1/1 |
|
1859 |
-\& default_filter # will be removed at 2017/1/1 |
|
1860 |
-.Ve |
|
1861 |
-.Sp |
|
1862 |
-DBIx::Custom::Tag |
|
1863 |
-.Sp |
|
1864 |
-.Vb 1 |
|
1865 |
-\& This module is DEPRECATED! # will be removed at 2017/1/1 |
|
1866 |
-.Ve |
|
1867 |
-.SH "BACKWORD COMPATIBLE POLICY" |
|
1868 |
-.IX Header "BACKWORD COMPATIBLE POLICY" |
|
1869 |
-If a functionality is \s-1DEPRECATED\s0, you can know it by \s-1DEPRECATED\s0 warnings |
|
1870 |
-except for attribute method. |
|
1871 |
-You can check all \s-1DEPRECATED\s0 functionalities by document. |
|
1872 |
-\&\s-1DEPRECATED\s0 functionality is removed after five years, |
|
1873 |
-but if at least one person use the functionality and tell me that thing |
|
1874 |
-I extend one year each time he tell me it. |
|
1875 |
-.Sp |
|
1876 |
-\&\s-1EXPERIMENTAL\s0 functionality will be changed without warnings. |
|
1877 |
-.Sp |
|
1878 |
-This policy was changed at 2011/6/28 |
|
1879 |
-.SH "BUGS" |
|
1880 |
-.IX Header "BUGS" |
|
1881 |
-Please tell me bugs if found. |
|
1882 |
-.Sp |
|
1883 |
-\&\f(CW\*(C`<kimoto.yuki at gmail.com>\*(C'\fR |
|
1884 |
-.Sp |
|
1885 |
-<http://github.com/yuki\-kimoto/DBIx\-Custom> |
|
1886 |
-.SH "AUTHOR" |
|
1887 |
-.IX Header "AUTHOR" |
|
1888 |
-Yuki Kimoto, \f(CW\*(C`<kimoto.yuki at gmail.com>\*(C'\fR |
|
1889 |
-.SH "COPYRIGHT & LICENSE" |
|
1890 |
-.IX Header "COPYRIGHT & LICENSE" |
|
1891 |
-Copyright 2009\-2011 Yuki Kimoto, all rights reserved. |
|
1892 |
-.Sp |
|
1893 |
-This program is free software; you can redistribute it and/or modify it |
|
1894 |
-under the same terms as Perl itself. |
... | ... |
@@ -1,924 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Guide 3" |
|
132 |
-.TH DBIx::Custom::Guide 3 "2011-07-30" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Guide \- DBIx::Custom Guide |
|
135 |
-.SH "FEATURES" |
|
136 |
-.IX Header "FEATURES" |
|
137 |
-DBIx::Custom is the wrapper class of \s-1DBI\s0 to execute \s-1SQL\s0 easily. |
|
138 |
-This module have the following features. |
|
139 |
-.IP "* Execute \s-1INSERT\s0, \s-1UPDATE\s0, \s-1DELETE\s0, \s-1SELECT\s0 statement easily" 4 |
|
140 |
-.IX Item "Execute INSERT, UPDATE, DELETE, SELECT statement easily" |
|
141 |
-.PD 0 |
|
142 |
-.IP "* You can specify bind values by hash reference" 4 |
|
143 |
-.IX Item "You can specify bind values by hash reference" |
|
144 |
-.IP "* Filtering by data type. and you can set filter to any column" 4 |
|
145 |
-.IX Item "Filtering by data type. and you can set filter to any column" |
|
146 |
-.IP "* Creating where clause and order by clause flexibly" 4 |
|
147 |
-.IX Item "Creating where clause and order by clause flexibly" |
|
148 |
-.IP "* Support model" 4 |
|
149 |
-.IX Item "Support model" |
|
150 |
-.PD |
|
151 |
-.SH "GUIDE" |
|
152 |
-.IX Header "GUIDE" |
|
153 |
-.Sh "Connect to database" |
|
154 |
-.IX Subsection "Connect to database" |
|
155 |
-.Vb 7 |
|
156 |
-\& use DBIx::Custom; |
|
157 |
-\& my $dbi = DBIx::Custom->connect( |
|
158 |
-\& dsn => "dbi:mysql:database=bookshop", |
|
159 |
-\& user => 'ken', |
|
160 |
-\& password => '!LFKD%$&', |
|
161 |
-\& dbi_option => {mysql_enable_utf8 => 1} |
|
162 |
-\& ); |
|
163 |
-.Ve |
|
164 |
-.PP |
|
165 |
-You can connect to database by \f(CW\*(C`connect\*(C'\fR method. |
|
166 |
-\&\f(CW\*(C`dsn\*(C'\fR is data source name, \f(CW\*(C`user\*(C'\fR is user name, \f(CW\*(C`password\*(C'\fR is password. |
|
167 |
-.PP |
|
168 |
-\&\f(CW\*(C`dbi_option\*(C'\fR is \s-1DBI\s0 option. |
|
169 |
-By default, the following option is set. |
|
170 |
-Exeption is thrown when fatal error occur and commit mode is auto commit. |
|
171 |
-.PP |
|
172 |
-.Vb 5 |
|
173 |
-\& { |
|
174 |
-\& RaiseError => 1 |
|
175 |
-\& PrintError => 0 |
|
176 |
-\& AutoCommit => 1 |
|
177 |
-\& } |
|
178 |
-.Ve |
|
179 |
-.Sh "Execute query" |
|
180 |
-.IX Subsection "Execute query" |
|
181 |
-\fIInsert Statement : \f(CI\*(C`insert\*(C'\fI\fR |
|
182 |
-.IX Subsection "Insert Statement : insert" |
|
183 |
-.PP |
|
184 |
-If you want to execute insert statement, use \f(CW\*(C`insert\*(C'\fR method. |
|
185 |
-.PP |
|
186 |
-.Vb 1 |
|
187 |
-\& $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
188 |
-.Ve |
|
189 |
-.PP |
|
190 |
-First argument is insert row data, \f(CW\*(C`table\*(C'\fR is table name. |
|
191 |
-.PP |
|
192 |
-\fIUpdate Statement : \f(CI\*(C`update\*(C'\fI\fR |
|
193 |
-.IX Subsection "Update Statement : update" |
|
194 |
-.PP |
|
195 |
-If you want to execute update stateimuse, use \f(CW\*(C`update\*(C'\fR method. |
|
196 |
-.PP |
|
197 |
-.Vb 5 |
|
198 |
-\& $dbi->update( |
|
199 |
-\& {title => 'Perl', author => 'Ken'}, |
|
200 |
-\& table => 'book', |
|
201 |
-\& where => {id => 5} |
|
202 |
-\& ); |
|
203 |
-.Ve |
|
204 |
-.PP |
|
205 |
-First argument is update row data, \f(CW\*(C`table\*(C'\fR is table name, \f(CW\*(C`where\*(C'\fR is condition. |
|
206 |
-.PP |
|
207 |
-Note that you can't execute \f(CW\*(C`update\*(C'\fR method without \f(CW\*(C`where\*(C'\fR. |
|
208 |
-If you want to update all rows, use update_all. |
|
209 |
-.PP |
|
210 |
-.Vb 1 |
|
211 |
-\& $dbi->update_all({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
212 |
-.Ve |
|
213 |
-.PP |
|
214 |
-\fIDelete Statement : \f(CI\*(C`delete\*(C'\fI\fR |
|
215 |
-.IX Subsection "Delete Statement : delete" |
|
216 |
-.PP |
|
217 |
-If you want to execute delete statement, use \f(CW\*(C`delete\*(C'\fR method. |
|
218 |
-.PP |
|
219 |
-.Vb 1 |
|
220 |
-\& $dbi->delete(table => 'book', where => {author => 'Ken'}); |
|
221 |
-.Ve |
|
222 |
-.PP |
|
223 |
-\&\f(CW\*(C`table\*(C'\fR is table name, \f(CW\*(C`where\*(C'\fR is condition. |
|
224 |
-.PP |
|
225 |
-Note that you can't execute \f(CW\*(C`delete\*(C'\fR method without \f(CW\*(C`where\*(C'\fR. |
|
226 |
-If you want to delete all rows, use \f(CW\*(C`delete_all\*(C'\fR method. |
|
227 |
-.PP |
|
228 |
-.Vb 1 |
|
229 |
-\& $dbi->delete_all(table => 'book'); |
|
230 |
-.Ve |
|
231 |
-.PP |
|
232 |
-\fISelect Statement : \f(CI\*(C`select\*(C'\fI\fR |
|
233 |
-.IX Subsection "Select Statement : select" |
|
234 |
-.PP |
|
235 |
-If you want to execute select statement, use \f(CW\*(C`select\*(C'\fR method. |
|
236 |
-.PP |
|
237 |
-.Vb 1 |
|
238 |
-\& my $result = $dbi->select(table => 'book'); |
|
239 |
-.Ve |
|
240 |
-.PP |
|
241 |
-Return value is DBIx::Custom::Result object. |
|
242 |
-You can fetch rows by \f(CW\*(C`fetch\*(C'\fR method. |
|
243 |
-.PP |
|
244 |
-.Vb 4 |
|
245 |
-\& while (my $row = $result->fetch) { |
|
246 |
-\& my $title = $row->[0]; |
|
247 |
-\& my $author = $row->[1]; |
|
248 |
-\& } |
|
249 |
-.Ve |
|
250 |
-.PP |
|
251 |
-See also \*(L"Fetch row\*(R" in Fetch row about DBIx::Custom::Result. |
|
252 |
-.PP |
|
253 |
-You can specify column names by \f(CW\*(C`column\*(C'\fR option |
|
254 |
-and condition by \f(CW\*(C`where\*(C'\fR option. |
|
255 |
-.PP |
|
256 |
-.Vb 5 |
|
257 |
-\& my $result = $dbi->select( |
|
258 |
-\& table => 'book', |
|
259 |
-\& column => ['author', 'title'], |
|
260 |
-\& where => {author => 'Ken'} |
|
261 |
-\& ); |
|
262 |
-.Ve |
|
263 |
-.PP |
|
264 |
-You can specify join clause by \f(CW\*(C`join\*(C'\fR option. |
|
265 |
-.PP |
|
266 |
-.Vb 6 |
|
267 |
-\& my $result = $dbi->select( |
|
268 |
-\& table => 'book', |
|
269 |
-\& column => ['company.name as company_name'] |
|
270 |
-\& where => {'book.name' => 'Perl'}, |
|
271 |
-\& join => ['left outer join company on book.company_id = company.id] |
|
272 |
-\& ); |
|
273 |
-.Ve |
|
274 |
-.PP |
|
275 |
-Note that join clause is joined only when \f(CW\*(C`where\*(C'\fR or \f(CW\*(C`column\*(C'\fR option contains table name, |
|
276 |
-such as book.name. |
|
277 |
-.PP |
|
278 |
-You can append statement to the end of whole statement by \f(CW\*(C`append\*(C'\fR option. |
|
279 |
-.PP |
|
280 |
-.Vb 5 |
|
281 |
-\& my $result = $dbi->select( |
|
282 |
-\& table => 'book', |
|
283 |
-\& where => {author => 'Ken'}, |
|
284 |
-\& append => 'for update', |
|
285 |
-\& ); |
|
286 |
-.Ve |
|
287 |
-.PP |
|
288 |
-\fI\f(CI\*(C`execute\*(C'\fI\fR |
|
289 |
-.IX Subsection "execute" |
|
290 |
-.PP |
|
291 |
-If you want to execute \s-1SQL\s0, use \f(CW\*(C`execute\*(C'\fR method. |
|
292 |
-.PP |
|
293 |
-.Vb 1 |
|
294 |
-\& $dbi->execute("select * from book;"); |
|
295 |
-.Ve |
|
296 |
-.PP |
|
297 |
-You can specify named placeholder. |
|
298 |
-.PP |
|
299 |
-.Vb 4 |
|
300 |
-\& $dbi->execute( |
|
301 |
-\& "select * from book title = :title and author = :author;" |
|
302 |
-\& {title => 'Perl', author => 'Ken'} |
|
303 |
-\& ); |
|
304 |
-.Ve |
|
305 |
-.PP |
|
306 |
-:title and :author is named placeholder, which is replaced to placeholers. |
|
307 |
-.PP |
|
308 |
-.Vb 1 |
|
309 |
-\& select * from book title = ? and author = ?; |
|
310 |
-.Ve |
|
311 |
-.PP |
|
312 |
-\fI\f(CI\*(C`dbh\*(C'\fI\fR |
|
313 |
-.IX Subsection "dbh" |
|
314 |
-.PP |
|
315 |
-.Vb 1 |
|
316 |
-\& my $dbh = $dbi->dbh; |
|
317 |
-.Ve |
|
318 |
-.PP |
|
319 |
-Get get database handle object of \s-1DBI\s0. |
|
320 |
-.PP |
|
321 |
-\fI\f(CI\*(C`DBI\*(C'\fI methods\fR |
|
322 |
-.IX Subsection "DBI methods" |
|
323 |
-.PP |
|
324 |
-.Vb 2 |
|
325 |
-\& $dbi->do(...); |
|
326 |
-\& $dbi->begin_work; |
|
327 |
-.Ve |
|
328 |
-.PP |
|
329 |
-You can call all methods of \s-1DBI\s0 from DBIx::Custom object. |
|
330 |
-.Sh "Fetch Rows" |
|
331 |
-.IX Subsection "Fetch Rows" |
|
332 |
-\&\f(CW\*(C`select\*(C'\fR method return value is DBIx::Custom::Result object. |
|
333 |
-You can fetch a row or rows by various methods. |
|
334 |
-.PP |
|
335 |
-\fIFetch a row (array) : \f(CI\*(C`fetch\*(C'\fI\fR |
|
336 |
-.IX Subsection "Fetch a row (array) : fetch" |
|
337 |
-.PP |
|
338 |
-.Vb 1 |
|
339 |
-\& my $row = $result->fetch; |
|
340 |
-.Ve |
|
341 |
-.PP |
|
342 |
-\&\f(CW\*(C`fetch\*(C'\fR method fetch a row and put it into array reference. |
|
343 |
-You can continue to fetch |
|
344 |
-.PP |
|
345 |
-.Vb 4 |
|
346 |
-\& while (my $row = $result->fetch) { |
|
347 |
-\& my $title = $row->[0]; |
|
348 |
-\& my $author = $row->[1]; |
|
349 |
-\& } |
|
350 |
-.Ve |
|
351 |
-.PP |
|
352 |
-\fIFetch only first row (array) : \f(CI\*(C`fetch_first\*(C'\fI\fR |
|
353 |
-.IX Subsection "Fetch only first row (array) : fetch_first" |
|
354 |
-.PP |
|
355 |
-.Vb 1 |
|
356 |
-\& my $row = $result->fetch_first; |
|
357 |
-.Ve |
|
358 |
-.PP |
|
359 |
-\&\f(CW\*(C`fetch_first\*(C'\fR fetch a only first row and finish statment handle, |
|
360 |
-and put it into array refrence. |
|
361 |
-.PP |
|
362 |
-\fIFetch all rows (array) : \f(CI\*(C`fetch_all\*(C'\fI\fR |
|
363 |
-.IX Subsection "Fetch all rows (array) : fetch_all" |
|
364 |
-.PP |
|
365 |
-.Vb 1 |
|
366 |
-\& my $rows = $result->fetch_all; |
|
367 |
-.Ve |
|
368 |
-.PP |
|
369 |
-\&\f(CW\*(C`fetch_all\*(C'\fR fetch all rows and put them into array of array reference. |
|
370 |
-.PP |
|
371 |
-\fIFetch a row (hash) : \f(CI\*(C`fetch_hash\*(C'\fI\fR |
|
372 |
-.IX Subsection "Fetch a row (hash) : fetch_hash" |
|
373 |
-.PP |
|
374 |
-.Vb 1 |
|
375 |
-\& my $row = $result->fetch_hash; |
|
376 |
-.Ve |
|
377 |
-.PP |
|
378 |
-\&\f(CW\*(C`fetch_hash\*(C'\fR fetch a row and put it into hash reference. |
|
379 |
-You can fetch a row while row exists. |
|
380 |
-.PP |
|
381 |
-.Vb 4 |
|
382 |
-\& while (my $row = $result->fetch_hash) { |
|
383 |
-\& my $title = $row->{title}; |
|
384 |
-\& my $author = $row->{author}; |
|
385 |
-\& } |
|
386 |
-.Ve |
|
387 |
-.PP |
|
388 |
-\fIFetch only a first row (hash) : \f(CI\*(C`fetch_hash_first\*(C'\fI\fR |
|
389 |
-.IX Subsection "Fetch only a first row (hash) : fetch_hash_first" |
|
390 |
-.PP |
|
391 |
-.Vb 1 |
|
392 |
-\& my $row = $result->fetch_hash_first; |
|
393 |
-.Ve |
|
394 |
-.PP |
|
395 |
-\&\f(CW\*(C`fetch_hash_first\*(C'\fR fetch only a first row and finish statement handle, |
|
396 |
-and put them into hash refrence. |
|
397 |
-.PP |
|
398 |
-\&\f(CW\*(C`one\*(C'\fR is \f(CW\*(C`fetch_hash_first\*(C'\fR synonym to save word typing. |
|
399 |
-.PP |
|
400 |
-.Vb 1 |
|
401 |
-\& my $row = $result->one; |
|
402 |
-.Ve |
|
403 |
-.PP |
|
404 |
-\fIFetch all rows (hash) : \f(CI\*(C`fetch_hash_all\*(C'\fI\fR |
|
405 |
-.IX Subsection "Fetch all rows (hash) : fetch_hash_all" |
|
406 |
-.PP |
|
407 |
-.Vb 1 |
|
408 |
-\& my $rows = $result->fetch_hash_all; |
|
409 |
-.Ve |
|
410 |
-.PP |
|
411 |
-\&\f(CW\*(C`fetch_hash_all\*(C'\fR fetch all rows and put them into array of hash reference. |
|
412 |
-.PP |
|
413 |
-\fIStatement Handle : \f(CI\*(C`sth\*(C'\fI\fR |
|
414 |
-.IX Subsection "Statement Handle : sth" |
|
415 |
-.PP |
|
416 |
-.Vb 1 |
|
417 |
-\& my $sth = $result->sth; |
|
418 |
-.Ve |
|
419 |
-.PP |
|
420 |
-If you want to get statment handle, use <sth> method. |
|
421 |
-.Sh "Named placeholder" |
|
422 |
-.IX Subsection "Named placeholder" |
|
423 |
-\fIBasic of Parameter\fR |
|
424 |
-.IX Subsection "Basic of Parameter" |
|
425 |
-.PP |
|
426 |
-You can embedd named placeholder into \s-1SQL\s0. |
|
427 |
-.PP |
|
428 |
-.Vb 1 |
|
429 |
-\& select * from book where title = :title and author like :author; |
|
430 |
-.Ve |
|
431 |
-.PP |
|
432 |
-:title and :author is named placeholder |
|
433 |
-.PP |
|
434 |
-Named placeholder is replaced by place holder. |
|
435 |
-.PP |
|
436 |
-.Vb 1 |
|
437 |
-\& select * from book where title = ? and author like ?; |
|
438 |
-.Ve |
|
439 |
-.PP |
|
440 |
-use \f(CW\*(C`execute\*(C'\fR to execute \s-1SQL\s0. |
|
441 |
-.PP |
|
442 |
-.Vb 2 |
|
443 |
-\& my $sql = "select * from book where title = :title and author like :author;" |
|
444 |
-\& $dbi->execute($sql, {title => 'Perl', author => '%Ken%'}); |
|
445 |
-.Ve |
|
446 |
-.PP |
|
447 |
-You can specify \f(CW\*(C`filter\*(C'\fR at \f(CW\*(C`execute\*(C'\fR. |
|
448 |
-.PP |
|
449 |
-.Vb 2 |
|
450 |
-\& $dbi->execute($sql, {title => 'Perl', author => '%Ken%'} |
|
451 |
-\& filter => {title => 'to_something'); |
|
452 |
-.Ve |
|
453 |
-.PP |
|
454 |
-\fIManipulate same name's columns\fR |
|
455 |
-.IX Subsection "Manipulate same name's columns" |
|
456 |
-.PP |
|
457 |
-It is ok if there are same name's columns. |
|
458 |
-Let's think two date comparison. |
|
459 |
-.PP |
|
460 |
-.Vb 1 |
|
461 |
-\& my $sql = "select * from table where date > :date and date < :date;"; |
|
462 |
-.Ve |
|
463 |
-.PP |
|
464 |
-In this case, You specify parameter values as array reference. |
|
465 |
-.PP |
|
466 |
-.Vb 1 |
|
467 |
-\& my $dbi->execute($sql, {date => ['2010-10-01', '2012-02-10']}); |
|
468 |
-.Ve |
|
469 |
-.Sh "Create where clause" |
|
470 |
-.IX Subsection "Create where clause" |
|
471 |
-\fIDinamically create where clause : where\fR |
|
472 |
-.IX Subsection "Dinamically create where clause : where" |
|
473 |
-.PP |
|
474 |
-You want to search multiple conditions in many times. |
|
475 |
-Let's think the following three cases. |
|
476 |
-.PP |
|
477 |
-Case1: Search only \f(CW\*(C`title\*(C'\fR |
|
478 |
-.PP |
|
479 |
-.Vb 1 |
|
480 |
-\& where title = :title |
|
481 |
-.Ve |
|
482 |
-.PP |
|
483 |
-Case2: Search only \f(CW\*(C`author\*(C'\fR |
|
484 |
-.PP |
|
485 |
-.Vb 1 |
|
486 |
-\& where author = :author |
|
487 |
-.Ve |
|
488 |
-.PP |
|
489 |
-Case3: Search \f(CW\*(C`title\*(C'\fR and \f(CW\*(C`author\*(C'\fR |
|
490 |
-.PP |
|
491 |
-.Vb 1 |
|
492 |
-\& where title = :title and author = :author |
|
493 |
-.Ve |
|
494 |
-.PP |
|
495 |
-DBIx::Custom support dinamic where clause creating. |
|
496 |
-At first, create DBIx::Custom::Where object by \f(CW\*(C`where\*(C'\fR. |
|
497 |
-.PP |
|
498 |
-.Vb 1 |
|
499 |
-\& my $where = $dbi->where; |
|
500 |
-.Ve |
|
501 |
-.PP |
|
502 |
-Set clause by \f(CW\*(C`clause\*(C'\fR |
|
503 |
-.PP |
|
504 |
-.Vb 3 |
|
505 |
-\& $where->clause( |
|
506 |
-\& ['and', 'title = :title, 'author = :author'] |
|
507 |
-\& ); |
|
508 |
-.Ve |
|
509 |
-.PP |
|
510 |
-\&\f(CW\*(C`clause\*(C'\fR is the following format. |
|
511 |
-.PP |
|
512 |
-.Vb 1 |
|
513 |
-\& ['or' or 'and', PART1, PART1, PART1] |
|
514 |
-.Ve |
|
515 |
-.PP |
|
516 |
-First argument is 'or' or 'and'. |
|
517 |
-Later than first argument are part which contains named placeholder. |
|
518 |
-.PP |
|
519 |
-You can write more complex format. |
|
520 |
-.PP |
|
521 |
-.Vb 4 |
|
522 |
-\& ['and', |
|
523 |
-\& 'title = :title', |
|
524 |
-\& ['or', 'author = :author', 'date like :date'] |
|
525 |
-\& ] |
|
526 |
-.Ve |
|
527 |
-.PP |
|
528 |
-This mean \*(L"title = :title and ( author = :author or date like :date )\*(R". |
|
529 |
-.PP |
|
530 |
-After setting \f(CW\*(C`clause\*(C'\fR, set \f(CW\*(C`param\*(C'\fR. |
|
531 |
-.PP |
|
532 |
-.Vb 1 |
|
533 |
-\& $where->param({title => 'Perl'}); |
|
534 |
-.Ve |
|
535 |
-.PP |
|
536 |
-In this example, parameter contains only title. |
|
537 |
-.PP |
|
538 |
-If you execute \f(CW\*(C`string_to\*(C'\fR, you can get where clause |
|
539 |
-which contain only named placeholder. |
|
540 |
-.PP |
|
541 |
-.Vb 1 |
|
542 |
-\& my $where_clause = $where->to_string; |
|
543 |
-.Ve |
|
544 |
-.PP |
|
545 |
-Parameter name is only title, the following where clause is created. |
|
546 |
-.PP |
|
547 |
-.Vb 1 |
|
548 |
-\& where title = :title |
|
549 |
-.Ve |
|
550 |
-.PP |
|
551 |
-You can also create where clause by stringification. |
|
552 |
-.PP |
|
553 |
-.Vb 1 |
|
554 |
-\& my $where_clause = "$where"; |
|
555 |
-.Ve |
|
556 |
-.PP |
|
557 |
-This is useful to embbed it into \s-1SQL\s0. |
|
558 |
-.PP |
|
559 |
-\fIIn case where clause contains same name columns\fR |
|
560 |
-.IX Subsection "In case where clause contains same name columns" |
|
561 |
-.PP |
|
562 |
-Even if same name parameters exists, you can create where clause. |
|
563 |
-Let's think that there are starting date and ending date. |
|
564 |
-.PP |
|
565 |
-.Vb 1 |
|
566 |
-\& my $param = {start_date => '2010-11-15', end_date => '2011-11-21'}; |
|
567 |
-.Ve |
|
568 |
-.PP |
|
569 |
-In this case, you set parameter value as array reference. |
|
570 |
-.PP |
|
571 |
-.Vb 1 |
|
572 |
-\& my $p = {date => ['2010-11-15', '2011-11-21']}; |
|
573 |
-.Ve |
|
574 |
-.PP |
|
575 |
-You can embbed these values into same name parameters. |
|
576 |
-.PP |
|
577 |
-.Vb 4 |
|
578 |
-\& $where->clause( |
|
579 |
-\& ['and', 'date > :date', 'date < :date'] |
|
580 |
-\& ); |
|
581 |
-\& $where->param($p); |
|
582 |
-.Ve |
|
583 |
-.PP |
|
584 |
-If starting date isn't exists, create the following parameter. |
|
585 |
-.PP |
|
586 |
-.Vb 1 |
|
587 |
-\& my $p = {date => [$dbi->not_exists, '2011-11-21']}; |
|
588 |
-.Ve |
|
589 |
-.PP |
|
590 |
-You can get DBIx::Custom::NotExists object by \f(CW\*(C`not_exists\*(C'\fR |
|
591 |
-This mean correnspondinf value isn't exists. |
|
592 |
-.PP |
|
593 |
-If ending date isn't exists, create the following parameter. |
|
594 |
-.PP |
|
595 |
-.Vb 1 |
|
596 |
-\& my $p = {date => ['2010-11-15']}; |
|
597 |
-.Ve |
|
598 |
-.PP |
|
599 |
-If both date isn't exists, create the following parameter. |
|
600 |
-.PP |
|
601 |
-.Vb 1 |
|
602 |
-\& my $p = {date => []}; |
|
603 |
-.Ve |
|
604 |
-.PP |
|
605 |
-This logic is a little difficut. See the following ones. |
|
606 |
-.PP |
|
607 |
-.Vb 5 |
|
608 |
-\& my @date; |
|
609 |
-\& push @date, exists $param->{start_date} ? $param->{start_date} |
|
610 |
-\& : $dbi->not_exists; |
|
611 |
-\& push @date, $param->{end_date} if exists $param->{end_date}; |
|
612 |
-\& my $p = {date => \e@date}; |
|
613 |
-.Ve |
|
614 |
-.PP |
|
615 |
-\fIWith \f(CI\*(C`select\*(C'\fI\fR |
|
616 |
-.IX Subsection "With select" |
|
617 |
-.PP |
|
618 |
-You can pass DBIx::Custom::Where object to \f(CW\*(C`where\*(C'\fR of \f(CW\*(C`select\*(C'\fR. |
|
619 |
-.PP |
|
620 |
-.Vb 4 |
|
621 |
-\& my $where = $dbi->where; |
|
622 |
-\& $where->clause(['and', 'title = :title', 'author = :author']); |
|
623 |
-\& $where->param({title => 'Perl'}); |
|
624 |
-\& my $result = $dbi->select(table => 'book', where => $where); |
|
625 |
-.Ve |
|
626 |
-.PP |
|
627 |
-You can also pass it to \f(CW\*(C`where\*(C'\fR of \f(CW\*(C`update\*(C'\fRA\f(CW\*(C`delete\*(C'\fR |
|
628 |
-.PP |
|
629 |
-\fIWith \f(CI\*(C`execute\*(C'\fI\fR |
|
630 |
-.IX Subsection "With execute" |
|
631 |
-.PP |
|
632 |
-DBIx::Custom::Where object is embedded into \s-1SQL\s0. |
|
633 |
-.PP |
|
634 |
-.Vb 3 |
|
635 |
-\& my $where = $dbi->where; |
|
636 |
-\& $where->clause(['and', 'title = :title', 'author = :author']); |
|
637 |
-\& $where->param({title => 'Perl'}); |
|
638 |
-.Ve |
|
639 |
-.PP |
|
640 |
-.Vb 4 |
|
641 |
-\& my $sql = <<"EOS"; |
|
642 |
-\& select * from book; |
|
643 |
-\& $where |
|
644 |
-\& EOS |
|
645 |
-.Ve |
|
646 |
-.PP |
|
647 |
-.Vb 1 |
|
648 |
-\& $dbi->execute($sql, $param, table => 'book'); |
|
649 |
-.Ve |
|
650 |
-.Sh "Filtering" |
|
651 |
-.IX Subsection "Filtering" |
|
652 |
-\fIRegister filter : \f(CI\*(C`register_filter\*(C'\fI\fR |
|
653 |
-.IX Subsection "Register filter : register_filter" |
|
654 |
-.PP |
|
655 |
-If you want to register filter, use \f(CW\*(C`register_filter\*(C'\fR. |
|
656 |
-.PP |
|
657 |
-.Vb 6 |
|
658 |
-\& $dbi->register_filter( |
|
659 |
-\& # Time::Piece object to DATE format |
|
660 |
-\& tp_to_date => sub { |
|
661 |
-\& my $date = shift; |
|
662 |
-\& return $tp->strftime('%Y-%m-%d'); |
|
663 |
-\& }, |
|
664 |
-.Ve |
|
665 |
-.PP |
|
666 |
-.Vb 6 |
|
667 |
-\& # DATE to Time::Piece object |
|
668 |
-\& date_to_tp => sub { |
|
669 |
-\& my $date = shift; |
|
670 |
-\& return Time::Piece->strptime($date, '%Y-%m-%d'); |
|
671 |
-\& }, |
|
672 |
-\& ); |
|
673 |
-.Ve |
|
674 |
-.PP |
|
675 |
-\fIFilter before sending data into database : \f(CI\*(C`filter\*(C'\fI option\fR |
|
676 |
-.IX Subsection "Filter before sending data into database : filter option" |
|
677 |
-.PP |
|
678 |
-If you filter sending data, use \f(CW\*(C`filter\*(C'\fR option. |
|
679 |
-.PP |
|
680 |
-.Vb 5 |
|
681 |
-\& $dbi->execute( |
|
682 |
-\& 'insert into book (date) values (:date)', |
|
683 |
-\& {date => $tp}, |
|
684 |
-\& filter => {date => 'tp_to_date'} |
|
685 |
-\& ); |
|
686 |
-.Ve |
|
687 |
-.PP |
|
688 |
-You can use \f(CW\*(C`filter\*(C'\fR option in \f(CW\*(C`insert\*(C'\fR, \f(CW\*(C`update\*(C'\fR, \f(CW\*(C`delete\*(C'\fR, \f(CW\*(C`select\*(C'\fR method. |
|
689 |
-.PP |
|
690 |
-.Vb 5 |
|
691 |
-\& $dbi->insert( |
|
692 |
-\& {date => $tp}, |
|
693 |
-\& table => 'book', |
|
694 |
-\& filter => {date => 'tp_to_date'} |
|
695 |
-\& ); |
|
696 |
-.Ve |
|
697 |
-.PP |
|
698 |
-\fIFilter after fetching data from database.\fR |
|
699 |
-.IX Subsection "Filter after fetching data from database." |
|
700 |
-.PP |
|
701 |
-If you filter fetch data, use DBIx::Custom::Result's \f(CW\*(C`filter\*(C'\fR method. |
|
702 |
-.PP |
|
703 |
-.Vb 3 |
|
704 |
-\& my $result = $dbi->select(column => 'date', table => 'book'); |
|
705 |
-\& $result->filter(date => 'date_to_tp'); |
|
706 |
-\& my $row = $result->one; |
|
707 |
-.Ve |
|
708 |
-.Sh "7. Model" |
|
709 |
-.IX Subsection "7. Model" |
|
710 |
-\fIModel\fR |
|
711 |
-.IX Subsection "Model" |
|
712 |
-.PP |
|
713 |
-you can define model extending DBIx::Custom::Model |
|
714 |
-to improve source code view. |
|
715 |
-.PP |
|
716 |
-At first, you create basic model class extending <DBIx::Custom::Model>. |
|
717 |
-Each DBIx::Custom class inherit Object::Simple. |
|
718 |
-so you can inherit the following way. |
|
719 |
-.PP |
|
720 |
-.Vb 2 |
|
721 |
-\& package MyModel; |
|
722 |
-\& use DBIx::Custom::Model -base; |
|
723 |
-.Ve |
|
724 |
-.PP |
|
725 |
-Next, you create each model classes. |
|
726 |
-.PP |
|
727 |
-MyModel::book |
|
728 |
-.PP |
|
729 |
-.Vb 2 |
|
730 |
-\& package MyModel::book; |
|
731 |
-\& use MyModel -base; |
|
732 |
-.Ve |
|
733 |
-.PP |
|
734 |
-.Vb 2 |
|
735 |
-\& sub insert { ... } |
|
736 |
-\& sub list { ... } |
|
737 |
-.Ve |
|
738 |
-.PP |
|
739 |
-MyModel::company |
|
740 |
-.PP |
|
741 |
-.Vb 2 |
|
742 |
-\& package MyModel::company; |
|
743 |
-\& use MyModel -base; |
|
744 |
-.Ve |
|
745 |
-.PP |
|
746 |
-.Vb 2 |
|
747 |
-\& sub insert { ... } |
|
748 |
-\& sub list { ... } |
|
749 |
-.Ve |
|
750 |
-.PP |
|
751 |
-The follwoing modules location is needed. |
|
752 |
-.PP |
|
753 |
-.Vb 3 |
|
754 |
-\& MyModel.pm |
|
755 |
-\& MyModel / book.pm |
|
756 |
-\& / company.pm |
|
757 |
-.Ve |
|
758 |
-.PP |
|
759 |
-You can include these models by \f(CW\*(C`include_model\*(C'\fR |
|
760 |
-.PP |
|
761 |
-.Vb 1 |
|
762 |
-\& $dbi->include_model('MyModel'); |
|
763 |
-.Ve |
|
764 |
-.PP |
|
765 |
-First argument is name space of model. |
|
766 |
-.PP |
|
767 |
-You can use model like this. |
|
768 |
-.PP |
|
769 |
-.Vb 1 |
|
770 |
-\& my $result = $dbi->model('book')->list; |
|
771 |
-.Ve |
|
772 |
-.PP |
|
773 |
-In mode, You can use such as methods, |
|
774 |
-\&\f(CW\*(C`insert\*(C'\fR, \f(CW\*(C`update\*(C'\fR, \f(CW\*(C`update_all\*(C'\fR, |
|
775 |
-\&\f(CW\*(C`delete\*(C'\fR, \f(CW\*(C`delete_all\*(C'\fR, \f(CW\*(C`select\*(C'\fR |
|
776 |
-without \f(CW\*(C`table\*(C'\fR option. |
|
777 |
-.PP |
|
778 |
-.Vb 1 |
|
779 |
-\& $dbi->model('book')->insert($param); |
|
780 |
-.Ve |
|
781 |
-.PP |
|
782 |
-Model is DBIx::Custom::Model. |
|
783 |
-.PP |
|
784 |
-If you need table nameAyou can get it by \f(CW\*(C`table\*(C'\fR. |
|
785 |
-.PP |
|
786 |
-.Vb 1 |
|
787 |
-\& my $table = $model->table; |
|
788 |
-.Ve |
|
789 |
-.PP |
|
790 |
-You can get DBIx::Custom. |
|
791 |
-.PP |
|
792 |
-.Vb 1 |
|
793 |
-\& my $dbi = $model->dbi; |
|
794 |
-.Ve |
|
795 |
-.PP |
|
796 |
-You can also call all methods of DBIx::Custom and \s-1DBI\s0. |
|
797 |
-.PP |
|
798 |
-.Vb 2 |
|
799 |
-\& # DBIx::Custom method |
|
800 |
-\& $model->execute($sql); |
|
801 |
-.Ve |
|
802 |
-.PP |
|
803 |
-.Vb 3 |
|
804 |
-\& # DBI method |
|
805 |
-\& $model->begin_work; |
|
806 |
-\& $model->commit; |
|
807 |
-.Ve |
|
808 |
-.PP |
|
809 |
-If you want to get all models, you can get them by keys of \f(CW\*(C`models\*(C'\fR. |
|
810 |
-.PP |
|
811 |
-.Vb 1 |
|
812 |
-\& my @models = keys %{$self->models}; |
|
813 |
-.Ve |
|
814 |
-.PP |
|
815 |
-You can set primary key to model. |
|
816 |
-.PP |
|
817 |
-.Vb 1 |
|
818 |
-\& $model->primary_key(['id', 'number_id']); |
|
819 |
-.Ve |
|
820 |
-.PP |
|
821 |
-Primary key is used by \f(CW\*(C`insert\*(C'\fR, \f(CW\*(C`update\*(C'\fR, \f(CW\*(C`delete\*(C'\fR, |
|
822 |
-and \f(CW\*(C`select\*(C'\fR methods. |
|
823 |
-.PP |
|
824 |
-You can set column names |
|
825 |
-.PP |
|
826 |
-.Vb 1 |
|
827 |
-\& $model->columns(['id', 'number_id']); |
|
828 |
-.Ve |
|
829 |
-.PP |
|
830 |
-Column names is automarically set by \f(CW\*(C`setup_model\*(C'\fR. |
|
831 |
-This method is needed to be call after \f(CW\*(C`include_model\*(C'\fR. |
|
832 |
-.PP |
|
833 |
-.Vb 1 |
|
834 |
-\& $dbi->setup_model; |
|
835 |
-.Ve |
|
836 |
-.PP |
|
837 |
-You can set \f(CW\*(C`join\*(C'\fR |
|
838 |
-.PP |
|
839 |
-.Vb 1 |
|
840 |
-\& $model->join(['left outer join company on book.company_id = company.id']); |
|
841 |
-.Ve |
|
842 |
-.PP |
|
843 |
-\&\f(CW\*(C`join\*(C'\fR is used by \f(CW\*(C`select\*(C'\fR method. |
|
844 |
-.Sh "Create column clause automatically : mycolumn, column" |
|
845 |
-.IX Subsection "Create column clause automatically : mycolumn, column" |
|
846 |
-To create column clause automatically, use \f(CW\*(C`mycolumn\*(C'\fR. |
|
847 |
-Valude of \f(CW\*(C`table\*(C'\fR and \f(CW\*(C`columns\*(C'\fR is used. |
|
848 |
-.PP |
|
849 |
-.Vb 1 |
|
850 |
-\& my $mycolumns = $model->mycolumn; |
|
851 |
-.Ve |
|
852 |
-.PP |
|
853 |
-If \f(CW\*(C`table\*(C'\fR is 'book'A\f(CW\*(C`column\*(C'\fR is ['id', 'name'], |
|
854 |
-the following clause is created. |
|
855 |
-.PP |
|
856 |
-.Vb 1 |
|
857 |
-\& book.id as id, book.name as name |
|
858 |
-.Ve |
|
859 |
-.PP |
|
860 |
-These column name is for removing column name ambiguities. |
|
861 |
-.PP |
|
862 |
-You can create column clause from columns of other table. |
|
863 |
-.PP |
|
864 |
-.Vb 1 |
|
865 |
-\& my $columns = $model->column('company'); |
|
866 |
-.Ve |
|
867 |
-.PP |
|
868 |
-If \f(CW\*(C`table\*(C'\fR is \*(L"company\*(R", \f(CW\*(C`column\*(C'\fR return ['id', 'name'], |
|
869 |
-the following clause is created. |
|
870 |
-.PP |
|
871 |
-.Vb 1 |
|
872 |
-\& company.id as "company.id", company.name as "company.name" |
|
873 |
-.Ve |
|
874 |
-.Sh "Model Examples" |
|
875 |
-.IX Subsection "Model Examples" |
|
876 |
-Model examples |
|
877 |
-.PP |
|
878 |
-.Vb 2 |
|
879 |
-\& package MyDBI; |
|
880 |
-\& use DBIx::Custom -base; |
|
881 |
-.Ve |
|
882 |
-.PP |
|
883 |
-.Vb 2 |
|
884 |
-\& sub connect { |
|
885 |
-\& my $self = shift->SUPER::connect(@_); |
|
886 |
-.Ve |
|
887 |
-.PP |
|
888 |
-.Vb 7 |
|
889 |
-\& $self->include_model( |
|
890 |
-\& MyModel => [ |
|
891 |
-\& 'book', |
|
892 |
-\& 'company' |
|
893 |
-\& ] |
|
894 |
-\& ); |
|
895 |
-\& } |
|
896 |
-.Ve |
|
897 |
-.PP |
|
898 |
-.Vb 2 |
|
899 |
-\& package MyModel::book; |
|
900 |
-\& use DBIx::Custom::Model -base; |
|
901 |
-.Ve |
|
902 |
-.PP |
|
903 |
-.Vb 1 |
|
904 |
-\& has primary_key => sub { ['id'] }; |
|
905 |
-.Ve |
|
906 |
-.PP |
|
907 |
-.Vb 2 |
|
908 |
-\& sub insert { ... } |
|
909 |
-\& sub list { ... } |
|
910 |
-.Ve |
|
911 |
-.PP |
|
912 |
-.Vb 2 |
|
913 |
-\& package MyModel::company; |
|
914 |
-\& use DBIx::Custom::Model -base; |
|
915 |
-.Ve |
|
916 |
-.PP |
|
917 |
-.Vb 1 |
|
918 |
-\& has primary_key => sub { ['id'] }; |
|
919 |
-.Ve |
|
920 |
-.PP |
|
921 |
-.Vb 2 |
|
922 |
-\& sub insert { ... } |
|
923 |
-\& sub list { ... } |
|
924 |
-.Ve |
... | ... |
@@ -1,139 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Guide::Ja 3" |
|
132 |
-.TH DBIx::Custom::Guide::Ja 3 "2011-07-11" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Guide \- DBIx::Customガイド |
|
135 |
-.SH "LINK" |
|
136 |
-.IX Header "LINK" |
|
137 |
-ドキュメントは以下のリンクに移動しました。 |
|
138 |
-.PP |
|
139 |
-<http://d.hatena.ne.jp/perlcodesample/20110401/1305597081> |
... | ... |
@@ -1,303 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Model 3" |
|
132 |
-.TH DBIx::Custom::Model 3 "2011-07-30" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Model \- Model |
|
135 |
-.SH "SYNOPSIS" |
|
136 |
-.IX Header "SYNOPSIS" |
|
137 |
-use DBIx::Custom::Table; |
|
138 |
-.PP |
|
139 |
-my \f(CW$table\fR = DBIx::Custom::Model\->new(table => 'books'); |
|
140 |
-.SH "ATTRIBUTES" |
|
141 |
-.IX Header "ATTRIBUTES" |
|
142 |
-.ie n .Sh """dbi""" |
|
143 |
-.el .Sh "\f(CWdbi\fP" |
|
144 |
-.IX Subsection "dbi" |
|
145 |
-.Vb 2 |
|
146 |
-\& my $dbi = $model->dbi; |
|
147 |
-\& $model = $model->dbi($dbi); |
|
148 |
-.Ve |
|
149 |
-.PP |
|
150 |
-DBIx::Custom object. |
|
151 |
-.ie n .Sh """join""" |
|
152 |
-.el .Sh "\f(CWjoin\fP" |
|
153 |
-.IX Subsection "join" |
|
154 |
-.Vb 4 |
|
155 |
-\& my $join = $model->join; |
|
156 |
-\& $model = $model->join( |
|
157 |
-\& ['left outer join company on book.company_id = company.id'] |
|
158 |
-\& ); |
|
159 |
-.Ve |
|
160 |
-.PP |
|
161 |
-Join clause, this value is passed to \f(CW\*(C`select\*(C'\fR method. |
|
162 |
-.ie n .Sh """primary_key""" |
|
163 |
-.el .Sh "\f(CWprimary_key\fP" |
|
164 |
-.IX Subsection "primary_key" |
|
165 |
-.Vb 2 |
|
166 |
-\& my $primary_key = $model->primary_key; |
|
167 |
-\& $model = $model->primary_key(['id', 'number']); |
|
168 |
-.Ve |
|
169 |
-.PP |
|
170 |
-Primary key,this is passed to \f(CW\*(C`insert\*(C'\fR, \f(CW\*(C`update\*(C'\fR, |
|
171 |
-\&\f(CW\*(C`delete\*(C'\fR, and \f(CW\*(C`select\*(C'\fR method. |
|
172 |
-.ie n .Sh """table""" |
|
173 |
-.el .Sh "\f(CWtable\fP" |
|
174 |
-.IX Subsection "table" |
|
175 |
-.Vb 2 |
|
176 |
-\& my $table = $model->table; |
|
177 |
-\& $model = $model->table('book'); |
|
178 |
-.Ve |
|
179 |
-.PP |
|
180 |
-Table name, this is passed to \f(CW\*(C`select\*(C'\fR method. |
|
181 |
-.ie n .Sh """bind_type""" |
|
182 |
-.el .Sh "\f(CWbind_type\fP" |
|
183 |
-.IX Subsection "bind_type" |
|
184 |
-.Vb 2 |
|
185 |
-\& my $type = $model->bind_type; |
|
186 |
-\& $model = $model->bind_type(['image' => DBI::SQL_BLOB]); |
|
187 |
-.Ve |
|
188 |
-.PP |
|
189 |
-Database data type, this is used as type optioon of \f(CW\*(C`insert\*(C'\fR, |
|
190 |
-\&\f(CW\*(C`update\*(C'\fR, \f(CW\*(C`update_all\*(C'\fR, \f(CW\*(C`delete\*(C'\fR, \f(CW\*(C`delete_all\*(C'\fR, |
|
191 |
-\&\f(CW\*(C`select\*(C'\fR, and \f(CW\*(C`execute\*(C'\fR method |
|
192 |
-.SH "METHODS" |
|
193 |
-.IX Header "METHODS" |
|
194 |
-DBIx::Custom::Model inherits all methods from Object::Simple, |
|
195 |
-and you can use all methods of DBIx::Custom and \s-1DBI\s0 |
|
196 |
-and implements the following new ones. |
|
197 |
-.ie n .Sh """delete""" |
|
198 |
-.el .Sh "\f(CWdelete\fP" |
|
199 |
-.IX Subsection "delete" |
|
200 |
-.Vb 1 |
|
201 |
-\& $table->delete(...); |
|
202 |
-.Ve |
|
203 |
-.PP |
|
204 |
-Same as \f(CW\*(C`delete\*(C'\fR of DBIx::Custom except that |
|
205 |
-you don't have to specify \f(CW\*(C`table\*(C'\fR option. |
|
206 |
-.ie n .Sh """delete_all""" |
|
207 |
-.el .Sh "\f(CWdelete_all\fP" |
|
208 |
-.IX Subsection "delete_all" |
|
209 |
-.Vb 1 |
|
210 |
-\& $table->delete_all(...); |
|
211 |
-.Ve |
|
212 |
-.PP |
|
213 |
-Same as \f(CW\*(C`delete_all\*(C'\fR of DBIx::Custom except that |
|
214 |
-you don't have to specify \f(CW\*(C`table\*(C'\fR option. |
|
215 |
-.ie n .Sh """insert""" |
|
216 |
-.el .Sh "\f(CWinsert\fP" |
|
217 |
-.IX Subsection "insert" |
|
218 |
-.Vb 1 |
|
219 |
-\& $table->insert(...); |
|
220 |
-.Ve |
|
221 |
-.PP |
|
222 |
-Same as \f(CW\*(C`insert\*(C'\fR of DBIx::Custom except that |
|
223 |
-you don't have to specify \f(CW\*(C`table\*(C'\fR option. |
|
224 |
-.ie n .Sh """method""" |
|
225 |
-.el .Sh "\f(CWmethod\fP" |
|
226 |
-.IX Subsection "method" |
|
227 |
-.Vb 3 |
|
228 |
-\& $model->method( |
|
229 |
-\& update_or_insert => sub { |
|
230 |
-\& my $self = shift; |
|
231 |
-.Ve |
|
232 |
-.PP |
|
233 |
-.Vb 4 |
|
234 |
-\& # ... |
|
235 |
-\& }, |
|
236 |
-\& find_or_create => sub { |
|
237 |
-\& my $self = shift; |
|
238 |
-.Ve |
|
239 |
-.PP |
|
240 |
-.Vb 2 |
|
241 |
-\& # ... |
|
242 |
-\& ); |
|
243 |
-.Ve |
|
244 |
-.PP |
|
245 |
-Register method. These method is called directly from DBIx::Custom::Model object. |
|
246 |
-.PP |
|
247 |
-.Vb 2 |
|
248 |
-\& $model->update_or_insert; |
|
249 |
-\& $model->find_or_create; |
|
250 |
-.Ve |
|
251 |
-.ie n .Sh """mycolumn""" |
|
252 |
-.el .Sh "\f(CWmycolumn\fP" |
|
253 |
-.IX Subsection "mycolumn" |
|
254 |
-.Vb 3 |
|
255 |
-\& my $column = $self->mycolumn; |
|
256 |
-\& my $column = $self->mycolumn(book => ['author', 'title']); |
|
257 |
-\& my $column = $self->mycolumn(['author', 'title']); |
|
258 |
-.Ve |
|
259 |
-.PP |
|
260 |
-Create column clause for myself. The follwoing column clause is created. |
|
261 |
-.PP |
|
262 |
-.Vb 2 |
|
263 |
-\& book.author as author, |
|
264 |
-\& book.title as title |
|
265 |
-.Ve |
|
266 |
-.PP |
|
267 |
-If table name is ommited, \f(CW\*(C`table\*(C'\fR attribute of the model is used. |
|
268 |
-If column names is omitted, \f(CW\*(C`columns\*(C'\fR attribute of the model is used. |
|
269 |
-.ie n .Sh """new""" |
|
270 |
-.el .Sh "\f(CWnew\fP" |
|
271 |
-.IX Subsection "new" |
|
272 |
-.Vb 1 |
|
273 |
-\& my $table = DBIx::Custom::Table->new; |
|
274 |
-.Ve |
|
275 |
-.PP |
|
276 |
-Create a DBIx::Custom::Table object. |
|
277 |
-.ie n .Sh """select""" |
|
278 |
-.el .Sh "\f(CWselect\fP" |
|
279 |
-.IX Subsection "select" |
|
280 |
-.Vb 1 |
|
281 |
-\& $table->select(...); |
|
282 |
-.Ve |
|
283 |
-.PP |
|
284 |
-Same as \f(CW\*(C`select\*(C'\fR of DBIx::Custom except that |
|
285 |
-you don't have to specify \f(CW\*(C`table\*(C'\fR option. |
|
286 |
-.ie n .Sh """update""" |
|
287 |
-.el .Sh "\f(CWupdate\fP" |
|
288 |
-.IX Subsection "update" |
|
289 |
-.Vb 1 |
|
290 |
-\& $table->update(...); |
|
291 |
-.Ve |
|
292 |
-.PP |
|
293 |
-Same as \f(CW\*(C`update\*(C'\fR of DBIx::Custom except that |
|
294 |
-you don't have to specify \f(CW\*(C`table\*(C'\fR option. |
|
295 |
-.ie n .Sh """update_all""" |
|
296 |
-.el .Sh "\f(CWupdate_all\fP" |
|
297 |
-.IX Subsection "update_all" |
|
298 |
-.Vb 1 |
|
299 |
-\& $table->update_all(param => \e%param); |
|
300 |
-.Ve |
|
301 |
-.PP |
|
302 |
-Same as \f(CW\*(C`update_all\*(C'\fR of DBIx::Custom except that |
|
303 |
-you don't have to specify table name. |
... | ... |
@@ -1,203 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Order 3" |
|
132 |
-.TH DBIx::Custom::Order 3 "2011-08-02" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Order \- Order by EXPERIMENTAL |
|
135 |
-.SH "SYNOPSIS" |
|
136 |
-.IX Header "SYNOPSIS" |
|
137 |
-.Vb 4 |
|
138 |
-\& # Result |
|
139 |
-\& my $order = DBIx::Custom::Order->new; |
|
140 |
-\& $order->prepend('title', 'author desc'); |
|
141 |
-\& my $order_by = "$order"; |
|
142 |
-.Ve |
|
143 |
-.SH "ATTRIBUTES" |
|
144 |
-.IX Header "ATTRIBUTES" |
|
145 |
-.ie n .Sh """dbi""" |
|
146 |
-.el .Sh "\f(CWdbi\fP" |
|
147 |
-.IX Subsection "dbi" |
|
148 |
-.Vb 2 |
|
149 |
-\& my $dbi = $order->dbi; |
|
150 |
-\& $order = $order->dbi($dbi); |
|
151 |
-.Ve |
|
152 |
-.PP |
|
153 |
-DBIx::Custom object. |
|
154 |
-.ie n .Sh """orders""" |
|
155 |
-.el .Sh "\f(CWorders\fP" |
|
156 |
-.IX Subsection "orders" |
|
157 |
-.Vb 2 |
|
158 |
-\& my $orders = $result->orders; |
|
159 |
-\& $result = $result->orders(\e%orders); |
|
160 |
-.Ve |
|
161 |
-.PP |
|
162 |
-Parts of order by clause |
|
163 |
-.SH "METHODS" |
|
164 |
-.IX Header "METHODS" |
|
165 |
-DBIx::Custom::Result inherits all methods from Object::Simple |
|
166 |
-and implements the following new ones. |
|
167 |
-.ie n .Sh """prepend""" |
|
168 |
-.el .Sh "\f(CWprepend\fP" |
|
169 |
-.IX Subsection "prepend" |
|
170 |
-.Vb 1 |
|
171 |
-\& $order->prepend('title', 'author desc'); |
|
172 |
-.Ve |
|
173 |
-.PP |
|
174 |
-Prepend order parts to \f(CW\*(C`orders\*(C'\fR. |
|
175 |
-.PP |
|
176 |
-You can pass array reference, which contain column name and direction. |
|
177 |
-Column name is quoted properly |
|
178 |
-.PP |
|
179 |
-.Vb 3 |
|
180 |
-\& # Column name and direction |
|
181 |
-\& $order->prepend(['book-title']); |
|
182 |
-\& $order->prepend([qw/book-title desc/]); |
|
183 |
-.Ve |
|
184 |
-.PP |
|
185 |
-This is expanded to the following way. |
|
186 |
-.PP |
|
187 |
-.Vb 2 |
|
188 |
-\& "book-title" |
|
189 |
-\& "book-title" desc |
|
190 |
-.Ve |
|
191 |
-.ie n .Sh """to_string""" |
|
192 |
-.el .Sh "\f(CWto_string\fP" |
|
193 |
-.IX Subsection "to_string" |
|
194 |
-.Vb 1 |
|
195 |
-\& my $order_by = $order->to_string; |
|
196 |
-.Ve |
|
197 |
-.PP |
|
198 |
-Create order by clause. If column name is duplicated, First one is used. |
|
199 |
-\&\f(CW\*(C`to_string\*(C'\fR override stringification. so you can write the follwoing way. |
|
200 |
-.PP |
|
201 |
-.Vb 1 |
|
202 |
-\& my $order_by = "$order"; |
|
203 |
-.Ve |
... | ... |
@@ -1,174 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Query 3" |
|
132 |
-.TH DBIx::Custom::Query 3 "2011-07-30" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Query \- Query |
|
135 |
-.SH "SYNOPSIS" |
|
136 |
-.IX Header "SYNOPSIS" |
|
137 |
-.Vb 4 |
|
138 |
-\& my $query = DBIx::Custom::Query->new; |
|
139 |
-\& my $sth = $query->sth; |
|
140 |
-\& my $sql = $query->sql; |
|
141 |
-\& my $columns = $query->columns; |
|
142 |
-.Ve |
|
143 |
-.SH "ATTRIBUTES" |
|
144 |
-.IX Header "ATTRIBUTES" |
|
145 |
-.ie n .Sh """columns""" |
|
146 |
-.el .Sh "\f(CWcolumns\fP" |
|
147 |
-.IX Subsection "columns" |
|
148 |
-.Vb 2 |
|
149 |
-\& my $columns = $query->columns; |
|
150 |
-\& $query = $query->columns(['auhtor', 'title']); |
|
151 |
-.Ve |
|
152 |
-.PP |
|
153 |
-Column names. |
|
154 |
-.ie n .Sh """sql""" |
|
155 |
-.el .Sh "\f(CWsql\fP" |
|
156 |
-.IX Subsection "sql" |
|
157 |
-.Vb 2 |
|
158 |
-\& my $sql = $query->sql; |
|
159 |
-\& $query = $query->sql('select * from books where author = ?;'); |
|
160 |
-.Ve |
|
161 |
-.PP |
|
162 |
-\&\s-1SQL\s0 statement. |
|
163 |
-.ie n .Sh """sth""" |
|
164 |
-.el .Sh "\f(CWsth\fP" |
|
165 |
-.IX Subsection "sth" |
|
166 |
-.Vb 2 |
|
167 |
-\& my $sth = $query->sth; |
|
168 |
-\& $query = $query->sth($sth); |
|
169 |
-.Ve |
|
170 |
-.PP |
|
171 |
-Statement handle of \s-1DBI\s0 |
|
172 |
-.SH "METHODS" |
|
173 |
-.IX Header "METHODS" |
|
174 |
-DBIx::Custom::Query inherits all methods from Object::Simple. |
... | ... |
@@ -1,165 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::QueryBuilder 3" |
|
132 |
-.TH DBIx::Custom::QueryBuilder 3 "2011-08-02" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::QueryBuilder \- Query builder |
|
135 |
-.SH "SYNOPSIS" |
|
136 |
-.IX Header "SYNOPSIS" |
|
137 |
-.Vb 4 |
|
138 |
-\& my $builder = DBIx::Custom::QueryBuilder->new; |
|
139 |
-\& my $query = $builder->build_query( |
|
140 |
-\& "select from table title = :title and author = :author" |
|
141 |
-\& ); |
|
142 |
-.Ve |
|
143 |
-.SH "ATTRIBUTES" |
|
144 |
-.IX Header "ATTRIBUTES" |
|
145 |
-.ie n .Sh """dbi""" |
|
146 |
-.el .Sh "\f(CWdbi\fP" |
|
147 |
-.IX Subsection "dbi" |
|
148 |
-.Vb 2 |
|
149 |
-\& my $dbi = $builder->dbi; |
|
150 |
-\& $builder = $builder->dbi($dbi); |
|
151 |
-.Ve |
|
152 |
-.PP |
|
153 |
-DBIx::Custom object. |
|
154 |
-.SH "METHODS" |
|
155 |
-.IX Header "METHODS" |
|
156 |
-DBIx::Custom::QueryBuilder inherits all methods from Object::Simple |
|
157 |
-and implements the following new ones. |
|
158 |
-.ie n .Sh """build_query""" |
|
159 |
-.el .Sh "\f(CWbuild_query\fP" |
|
160 |
-.IX Subsection "build_query" |
|
161 |
-.Vb 1 |
|
162 |
-\& my $query = $builder->build_query($source); |
|
163 |
-.Ve |
|
164 |
-.PP |
|
165 |
-Create a new DBIx::Custom::Query object from \s-1SQL\s0 source. |
... | ... |
@@ -1,409 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Result 3" |
|
132 |
-.TH DBIx::Custom::Result 3 "2011-08-02" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Result \- Result of select statement |
|
135 |
-.SH "SYNOPSIS" |
|
136 |
-.IX Header "SYNOPSIS" |
|
137 |
-.Vb 2 |
|
138 |
-\& # Result |
|
139 |
-\& my $result = $dbi->select(table => 'book'); |
|
140 |
-.Ve |
|
141 |
-.PP |
|
142 |
-.Vb 5 |
|
143 |
-\& # Fetch a row and put it into array reference |
|
144 |
-\& while (my $row = $result->fetch) { |
|
145 |
-\& my $author = $row->[0]; |
|
146 |
-\& my $title = $row->[1]; |
|
147 |
-\& } |
|
148 |
-.Ve |
|
149 |
-.PP |
|
150 |
-.Vb 2 |
|
151 |
-\& # Fetch only a first row and put it into array reference |
|
152 |
-\& my $row = $result->fetch_first; |
|
153 |
-.Ve |
|
154 |
-.PP |
|
155 |
-.Vb 2 |
|
156 |
-\& # Fetch all rows and put them into array of array reference |
|
157 |
-\& my $rows = $result->fetch_all; |
|
158 |
-.Ve |
|
159 |
-.PP |
|
160 |
-.Vb 5 |
|
161 |
-\& # Fetch a row and put it into hash reference |
|
162 |
-\& while (my $row = $result->fetch_hash) { |
|
163 |
-\& my $title = $row->{title}; |
|
164 |
-\& my $author = $row->{author}; |
|
165 |
-\& } |
|
166 |
-.Ve |
|
167 |
-.PP |
|
168 |
-.Vb 3 |
|
169 |
-\& # Fetch only a first row and put it into hash reference |
|
170 |
-\& my $row = $result->fetch_hash_first; |
|
171 |
-\& my $row = $result->one; # Same as fetch_hash_first |
|
172 |
-.Ve |
|
173 |
-.PP |
|
174 |
-.Vb 3 |
|
175 |
-\& # Fetch all rows and put them into array of hash reference |
|
176 |
-\& my $rows = $result->fetch_hash_all; |
|
177 |
-\& my $rows = $result->all; # Same as fetch_hash_all |
|
178 |
-.Ve |
|
179 |
-.SH "ATTRIBUTES" |
|
180 |
-.IX Header "ATTRIBUTES" |
|
181 |
-.ie n .Sh """dbi""" |
|
182 |
-.el .Sh "\f(CWdbi\fP" |
|
183 |
-.IX Subsection "dbi" |
|
184 |
-.Vb 2 |
|
185 |
-\& my $dbi = $result->dbi; |
|
186 |
-\& $result = $result->dbi($dbi); |
|
187 |
-.Ve |
|
188 |
-.PP |
|
189 |
-DBIx::Custom object. |
|
190 |
-.ie n .Sh """sth""" |
|
191 |
-.el .Sh "\f(CWsth\fP" |
|
192 |
-.IX Subsection "sth" |
|
193 |
-.Vb 2 |
|
194 |
-\& my $sth = $reuslt->sth |
|
195 |
-\& $result = $result->sth($sth); |
|
196 |
-.Ve |
|
197 |
-.PP |
|
198 |
-Statement handle of \s-1DBI\s0. |
|
199 |
-.SH "METHODS" |
|
200 |
-.IX Header "METHODS" |
|
201 |
-DBIx::Custom::Result inherits all methods from Object::Simple |
|
202 |
-and implements the following new ones. |
|
203 |
-.ie n .Sh """all""" |
|
204 |
-.el .Sh "\f(CWall\fP" |
|
205 |
-.IX Subsection "all" |
|
206 |
-.Vb 1 |
|
207 |
-\& my $rows = $result->all; |
|
208 |
-.Ve |
|
209 |
-.PP |
|
210 |
-Same as \f(CW\*(C`fetch_hash_all\*(C'\fR. |
|
211 |
-.ie n .Sh """fetch""" |
|
212 |
-.el .Sh "\f(CWfetch\fP" |
|
213 |
-.IX Subsection "fetch" |
|
214 |
-.Vb 1 |
|
215 |
-\& my $row = $result->fetch; |
|
216 |
-.Ve |
|
217 |
-.PP |
|
218 |
-Fetch a row and put it into array reference. |
|
219 |
-.ie n .Sh """fetch_all""" |
|
220 |
-.el .Sh "\f(CWfetch_all\fP" |
|
221 |
-.IX Subsection "fetch_all" |
|
222 |
-.Vb 1 |
|
223 |
-\& my $rows = $result->fetch_all; |
|
224 |
-.Ve |
|
225 |
-.PP |
|
226 |
-Fetch all rows and put them into array of array reference. |
|
227 |
-.ie n .Sh """fetch_first""" |
|
228 |
-.el .Sh "\f(CWfetch_first\fP" |
|
229 |
-.IX Subsection "fetch_first" |
|
230 |
-.Vb 1 |
|
231 |
-\& my $row = $result->fetch_first; |
|
232 |
-.Ve |
|
233 |
-.PP |
|
234 |
-Fetch only a first row and put it into array reference, |
|
235 |
-and finish statment handle. |
|
236 |
-.ie n .Sh """fetch_hash""" |
|
237 |
-.el .Sh "\f(CWfetch_hash\fP" |
|
238 |
-.IX Subsection "fetch_hash" |
|
239 |
-.Vb 1 |
|
240 |
-\& my $row = $result->fetch_hash; |
|
241 |
-.Ve |
|
242 |
-.PP |
|
243 |
-Fetch a row and put it into hash reference. |
|
244 |
-.ie n .Sh """fetch_hash_all""" |
|
245 |
-.el .Sh "\f(CWfetch_hash_all\fP" |
|
246 |
-.IX Subsection "fetch_hash_all" |
|
247 |
-.Vb 1 |
|
248 |
-\& my $rows = $result->fetch_hash_all; |
|
249 |
-.Ve |
|
250 |
-.PP |
|
251 |
-Fetch all rows and put them into array of hash reference. |
|
252 |
-.ie n .Sh """fetch_hash_first""" |
|
253 |
-.el .Sh "\f(CWfetch_hash_first\fP" |
|
254 |
-.IX Subsection "fetch_hash_first" |
|
255 |
-.Vb 1 |
|
256 |
-\& my $row = $result->fetch_hash_first; |
|
257 |
-.Ve |
|
258 |
-.PP |
|
259 |
-Fetch only a first row and put it into hash reference, |
|
260 |
-and finish statment handle. |
|
261 |
-.ie n .Sh """fetch_hash_multi""" |
|
262 |
-.el .Sh "\f(CWfetch_hash_multi\fP" |
|
263 |
-.IX Subsection "fetch_hash_multi" |
|
264 |
-.Vb 1 |
|
265 |
-\& my $rows = $result->fetch_hash_multi(5); |
|
266 |
-.Ve |
|
267 |
-.PP |
|
268 |
-Fetch multiple rows and put them into array of hash reference. |
|
269 |
-.ie n .Sh """fetch_multi""" |
|
270 |
-.el .Sh "\f(CWfetch_multi\fP" |
|
271 |
-.IX Subsection "fetch_multi" |
|
272 |
-.Vb 1 |
|
273 |
-\& my $rows = $result->fetch_multi(5); |
|
274 |
-.Ve |
|
275 |
-.PP |
|
276 |
-Fetch multiple rows and put them into array of array reference. |
|
277 |
-.ie n .Sh """filter""" |
|
278 |
-.el .Sh "\f(CWfilter\fP" |
|
279 |
-.IX Subsection "filter" |
|
280 |
-.Vb 2 |
|
281 |
-\& $result->filter(title => sub { uc $_[0] }, author => 'to_upper'); |
|
282 |
-\& $result->filter([qw/title author/] => 'to_upper'); |
|
283 |
-.Ve |
|
284 |
-.PP |
|
285 |
-Set filter for column. |
|
286 |
-You can use subroutine or filter name as filter. |
|
287 |
-This filter is executed after \f(CW\*(C`type_rule\*(C'\fR filter. |
|
288 |
-.ie n .Sh """filter_off"" \s-1EXPERIMENTAL\s0" |
|
289 |
-.el .Sh "\f(CWfilter_off\fP \s-1EXPERIMENTAL\s0" |
|
290 |
-.IX Subsection "filter_off EXPERIMENTAL" |
|
291 |
-.Vb 1 |
|
292 |
-\& $result = $result->filter_off; |
|
293 |
-.Ve |
|
294 |
-.PP |
|
295 |
-Turn filtering by \f(CW\*(C`filter\*(C'\fR method off. |
|
296 |
-By default, filterin is on. |
|
297 |
-.ie n .Sh """filter_on"" \s-1EXPERIMENTAL\s0" |
|
298 |
-.el .Sh "\f(CWfilter_on\fP \s-1EXPERIMENTAL\s0" |
|
299 |
-.IX Subsection "filter_on EXPERIMENTAL" |
|
300 |
-.Vb 1 |
|
301 |
-\& $result = $resutl->filter_on; |
|
302 |
-.Ve |
|
303 |
-.PP |
|
304 |
-Turn filtering by \f(CW\*(C`filter\*(C'\fR method on. |
|
305 |
-By default, filterin is on. |
|
306 |
-.ie n .Sh """header""" |
|
307 |
-.el .Sh "\f(CWheader\fP" |
|
308 |
-.IX Subsection "header" |
|
309 |
-.Vb 1 |
|
310 |
-\& my $header = $result->header; |
|
311 |
-.Ve |
|
312 |
-.PP |
|
313 |
-Get header column names. |
|
314 |
-.ie n .Sh """one""" |
|
315 |
-.el .Sh "\f(CWone\fP" |
|
316 |
-.IX Subsection "one" |
|
317 |
-.Vb 1 |
|
318 |
-\& my $row = $result->one; |
|
319 |
-.Ve |
|
320 |
-.PP |
|
321 |
-Same as \f(CW\*(C`fetch_hash_first\*(C'\fR. |
|
322 |
-.ie n .Sh """stash""" |
|
323 |
-.el .Sh "\f(CWstash\fP" |
|
324 |
-.IX Subsection "stash" |
|
325 |
-.Vb 3 |
|
326 |
-\& my $stash = $result->stash; |
|
327 |
-\& my $foo = $result->stash->{foo}; |
|
328 |
-\& $result->stash->{foo} = $foo; |
|
329 |
-.Ve |
|
330 |
-.PP |
|
331 |
-Stash is hash reference for data. |
|
332 |
-.ie n .Sh """type_rule"" \s-1EXPERIMENTAL\s0" |
|
333 |
-.el .Sh "\f(CWtype_rule\fP \s-1EXPERIMENTAL\s0" |
|
334 |
-.IX Subsection "type_rule EXPERIMENTAL" |
|
335 |
-.Vb 7 |
|
336 |
-\& # Merge type rule |
|
337 |
-\& $result->type_rule( |
|
338 |
-\& # DATE |
|
339 |
-\& 9 => sub { ... }, |
|
340 |
-\& # DATETIME or TIMESTAMP |
|
341 |
-\& 11 => sub { ... } |
|
342 |
-\& ); |
|
343 |
-.Ve |
|
344 |
-.PP |
|
345 |
-.Vb 7 |
|
346 |
-\& # Replace type rule(by reference) |
|
347 |
-\& $result->type_rule([ |
|
348 |
-\& # DATE |
|
349 |
-\& 9 => sub { ... }, |
|
350 |
-\& # DATETIME or TIMESTAMP |
|
351 |
-\& 11 => sub { ... } |
|
352 |
-\& ]); |
|
353 |
-.Ve |
|
354 |
-.PP |
|
355 |
-This is same as DBIx::Custom's \f(CW\*(C`type_rule\*(C'\fR's <from>. |
|
356 |
-.ie n .Sh """type_rule_off"" \s-1EXPERIMENTAL\s0" |
|
357 |
-.el .Sh "\f(CWtype_rule_off\fP \s-1EXPERIMENTAL\s0" |
|
358 |
-.IX Subsection "type_rule_off EXPERIMENTAL" |
|
359 |
-.Vb 1 |
|
360 |
-\& $result = $result->type_rule_off; |
|
361 |
-.Ve |
|
362 |
-.PP |
|
363 |
-Turn \f(CW\*(C`from1\*(C'\fR and \f(CW\*(C`from2\*(C'\fR type rule off. |
|
364 |
-By default, type rule is on. |
|
365 |
-.ie n .Sh """type_rule_on"" \s-1EXPERIMENTAL\s0" |
|
366 |
-.el .Sh "\f(CWtype_rule_on\fP \s-1EXPERIMENTAL\s0" |
|
367 |
-.IX Subsection "type_rule_on EXPERIMENTAL" |
|
368 |
-.Vb 1 |
|
369 |
-\& $result = $result->type_rule_on; |
|
370 |
-.Ve |
|
371 |
-.PP |
|
372 |
-Turn \f(CW\*(C`from1\*(C'\fR and \f(CW\*(C`from2\*(C'\fR type rule on. |
|
373 |
-By default, type rule is on. |
|
374 |
-.ie n .Sh """type_rule1_off"" \s-1EXPERIMENTAL\s0" |
|
375 |
-.el .Sh "\f(CWtype_rule1_off\fP \s-1EXPERIMENTAL\s0" |
|
376 |
-.IX Subsection "type_rule1_off EXPERIMENTAL" |
|
377 |
-.Vb 1 |
|
378 |
-\& $result = $result->type_rule1_off; |
|
379 |
-.Ve |
|
380 |
-.PP |
|
381 |
-Turn \f(CW\*(C`from1\*(C'\fR type rule off. |
|
382 |
-By default, type rule is on. |
|
383 |
-.ie n .Sh """type_rule1_on"" \s-1EXPERIMENTAL\s0" |
|
384 |
-.el .Sh "\f(CWtype_rule1_on\fP \s-1EXPERIMENTAL\s0" |
|
385 |
-.IX Subsection "type_rule1_on EXPERIMENTAL" |
|
386 |
-.Vb 1 |
|
387 |
-\& $result = $result->type_rule1_on; |
|
388 |
-.Ve |
|
389 |
-.PP |
|
390 |
-Turn \f(CW\*(C`from1\*(C'\fR type rule on. |
|
391 |
-By default, type rule is on. |
|
392 |
-.ie n .Sh """type_rule2_off"" \s-1EXPERIMENTAL\s0" |
|
393 |
-.el .Sh "\f(CWtype_rule2_off\fP \s-1EXPERIMENTAL\s0" |
|
394 |
-.IX Subsection "type_rule2_off EXPERIMENTAL" |
|
395 |
-.Vb 1 |
|
396 |
-\& $result = $result->type_rule2_off; |
|
397 |
-.Ve |
|
398 |
-.PP |
|
399 |
-Turn \f(CW\*(C`from2\*(C'\fR type rule off. |
|
400 |
-By default, type rule is on. |
|
401 |
-.ie n .Sh """type_rule2_on"" \s-1EXPERIMENTAL\s0" |
|
402 |
-.el .Sh "\f(CWtype_rule2_on\fP \s-1EXPERIMENTAL\s0" |
|
403 |
-.IX Subsection "type_rule2_on EXPERIMENTAL" |
|
404 |
-.Vb 1 |
|
405 |
-\& $result = $result->type_rule2_on; |
|
406 |
-.Ve |
|
407 |
-.PP |
|
408 |
-Turn \f(CW\*(C`from2\*(C'\fR type rule on. |
|
409 |
-By default, type rule is on. |
... | ... |
@@ -1,134 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Tag 3" |
|
132 |
-.TH DBIx::Custom::Tag 3 "2011-06-15" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Tag \- DEPRECATED! |
... | ... |
@@ -1,134 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Util 3" |
|
132 |
-.TH DBIx::Custom::Util 3 "2011-04-25" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Util \- Utility class |
... | ... |
@@ -1,198 +0,0 @@ |
1 |
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32 |
|
2 |
-.\" |
|
3 |
-.\" Standard preamble: |
|
4 |
-.\" ======================================================================== |
|
5 |
-.de Sh \" Subsection heading |
|
6 |
-.br |
|
7 |
-.if t .Sp |
|
8 |
-.ne 5 |
|
9 |
-.PP |
|
10 |
-\fB\\$1\fR |
|
11 |
-.PP |
|
12 |
-.. |
|
13 |
-.de Sp \" Vertical space (when we can't use .PP) |
|
14 |
-.if t .sp .5v |
|
15 |
-.if n .sp |
|
16 |
-.. |
|
17 |
-.de Vb \" Begin verbatim text |
|
18 |
-.ft CW |
|
19 |
-.nf |
|
20 |
-.ne \\$1 |
|
21 |
-.. |
|
22 |
-.de Ve \" End verbatim text |
|
23 |
-.ft R |
|
24 |
-.fi |
|
25 |
-.. |
|
26 |
-.\" Set up some character translations and predefined strings. \*(-- will |
|
27 |
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left |
|
28 |
-.\" double quote, and \*(R" will give a right double quote. | will give a |
|
29 |
-.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to |
|
30 |
-.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' |
|
31 |
-.\" expand to `' in nroff, nothing in troff, for use with C<>. |
|
32 |
-.tr \(*W-|\(bv\*(Tr |
|
33 |
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
|
34 |
-.ie n \{\ |
|
35 |
-. ds -- \(*W- |
|
36 |
-. ds PI pi |
|
37 |
-. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch |
|
38 |
-. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch |
|
39 |
-. ds L" "" |
|
40 |
-. ds R" "" |
|
41 |
-. ds C` "" |
|
42 |
-. ds C' "" |
|
43 |
-'br\} |
|
44 |
-.el\{\ |
|
45 |
-. ds -- \|\(em\| |
|
46 |
-. ds PI \(*p |
|
47 |
-. ds L" `` |
|
48 |
-. ds R" '' |
|
49 |
-'br\} |
|
50 |
-.\" |
|
51 |
-.\" If the F register is turned on, we'll generate index entries on stderr for |
|
52 |
-.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
|
53 |
-.\" entries marked with X<> in POD. Of course, you'll have to process the |
|
54 |
-.\" output yourself in some meaningful fashion. |
|
55 |
-.if \nF \{\ |
|
56 |
-. de IX |
|
57 |
-. tm Index:\\$1\t\\n%\t"\\$2" |
|
58 |
-.. |
|
59 |
-. nr % 0 |
|
60 |
-. rr F |
|
61 |
-.\} |
|
62 |
-.\" |
|
63 |
-.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
|
64 |
-.\" way too many mistakes in technical documents. |
|
65 |
-.hy 0 |
|
66 |
-.if n .na |
|
67 |
-.\" |
|
68 |
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
|
69 |
-.\" Fear. Run. Save yourself. No user-serviceable parts. |
|
70 |
-. \" fudge factors for nroff and troff |
|
71 |
-.if n \{\ |
|
72 |
-. ds #H 0 |
|
73 |
-. ds #V .8m |
|
74 |
-. ds #F .3m |
|
75 |
-. ds #[ \f1 |
|
76 |
-. ds #] \fP |
|
77 |
-.\} |
|
78 |
-.if t \{\ |
|
79 |
-. ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
|
80 |
-. ds #V .6m |
|
81 |
-. ds #F 0 |
|
82 |
-. ds #[ \& |
|
83 |
-. ds #] \& |
|
84 |
-.\} |
|
85 |
-. \" simple accents for nroff and troff |
|
86 |
-.if n \{\ |
|
87 |
-. ds ' \& |
|
88 |
-. ds ` \& |
|
89 |
-. ds ^ \& |
|
90 |
-. ds , \& |
|
91 |
-. ds ~ ~ |
|
92 |
-. ds / |
|
93 |
-.\} |
|
94 |
-.if t \{\ |
|
95 |
-. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
|
96 |
-. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' |
|
97 |
-. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' |
|
98 |
-. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' |
|
99 |
-. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' |
|
100 |
-. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' |
|
101 |
-.\} |
|
102 |
-. \" troff and (daisy-wheel) nroff accents |
|
103 |
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
|
104 |
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H' |
|
105 |
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
|
106 |
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' |
|
107 |
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' |
|
108 |
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] |
|
109 |
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] |
|
110 |
-.ds ae a\h'-(\w'a'u*4/10)'e |
|
111 |
-.ds Ae A\h'-(\w'A'u*4/10)'E |
|
112 |
-. \" corrections for vroff |
|
113 |
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
|
114 |
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' |
|
115 |
-. \" for low resolution devices (crt and lpr) |
|
116 |
-.if \n(.H>23 .if \n(.V>19 \ |
|
117 |
-\{\ |
|
118 |
-. ds : e |
|
119 |
-. ds 8 ss |
|
120 |
-. ds o a |
|
121 |
-. ds d- d\h'-1'\(ga |
|
122 |
-. ds D- D\h'-1'\(hy |
|
123 |
-. ds th \o'bp' |
|
124 |
-. ds Th \o'LP' |
|
125 |
-. ds ae ae |
|
126 |
-. ds Ae AE |
|
127 |
-.\} |
|
128 |
-.rm #[ #] #H #V #F C |
|
129 |
-.\" ======================================================================== |
|
130 |
-.\" |
|
131 |
-.IX Title "DBIx::Custom::Where 3" |
|
132 |
-.TH DBIx::Custom::Where 3 "2011-08-02" "perl v5.8.8" "User Contributed Perl Documentation" |
|
133 |
-.SH "NAME" |
|
134 |
-DBIx::Custom::Where \- Where clause |
|
135 |
-.SH "SYNOPSYS" |
|
136 |
-.IX Header "SYNOPSYS" |
|
137 |
-.Vb 2 |
|
138 |
-\& my $where = DBIx::Custom::Where->new; |
|
139 |
-\& my $string_where = "$where"; |
|
140 |
-.Ve |
|
141 |
-.SH "ATTRIBUTES" |
|
142 |
-.IX Header "ATTRIBUTES" |
|
143 |
-.ie n .Sh """clause""" |
|
144 |
-.el .Sh "\f(CWclause\fP" |
|
145 |
-.IX Subsection "clause" |
|
146 |
-.Vb 7 |
|
147 |
-\& my $clause = $where->clause; |
|
148 |
-\& $where = $where->clause( |
|
149 |
-\& ['and', |
|
150 |
-\& 'title = :title', |
|
151 |
-\& ['or', 'date < :date', 'date > :date'] |
|
152 |
-\& ] |
|
153 |
-\& ); |
|
154 |
-.Ve |
|
155 |
-.PP |
|
156 |
-Where clause. Above one is expanded to the following \s-1SQL\s0 by to_string |
|
157 |
-If all parameter names is exists. |
|
158 |
-.PP |
|
159 |
-.Vb 1 |
|
160 |
-\& "where ( title = :title and ( date < :date or date > :date ) )" |
|
161 |
-.Ve |
|
162 |
-.ie n .Sh """param""" |
|
163 |
-.el .Sh "\f(CWparam\fP" |
|
164 |
-.IX Subsection "param" |
|
165 |
-.Vb 5 |
|
166 |
-\& my $param = $where->param; |
|
167 |
-\& $where = $where->param({ |
|
168 |
-\& title => 'Perl', |
|
169 |
-\& date => ['2010-11-11', '2011-03-05'], |
|
170 |
-\& }); |
|
171 |
-.Ve |
|
172 |
-.ie n .Sh """dbi""" |
|
173 |
-.el .Sh "\f(CWdbi\fP" |
|
174 |
-.IX Subsection "dbi" |
|
175 |
-.Vb 2 |
|
176 |
-\& my $dbi = $where->dbi; |
|
177 |
-\& $where = $where->dbi($dbi); |
|
178 |
-.Ve |
|
179 |
-.PP |
|
180 |
-DBIx::Custom object. |
|
181 |
-.SH "METHODS" |
|
182 |
-.IX Header "METHODS" |
|
183 |
-DBIx::Custom::Where inherits all methods from Object::Simple |
|
184 |
-and implements the following new ones. |
|
185 |
-.ie n .Sh """to_string""" |
|
186 |
-.el .Sh "\f(CWto_string\fP" |
|
187 |
-.IX Subsection "to_string" |
|
188 |
-.Vb 1 |
|
189 |
-\& $where->to_string; |
|
190 |
-.Ve |
|
191 |
-.PP |
|
192 |
-Convert where clause to string. |
|
193 |
-.PP |
|
194 |
-double quote is override to execute \f(CW\*(C`to_string\*(C'\fR method. |
|
195 |
-.PP |
|
196 |
-.Vb 1 |
|
197 |
-\& my $string_where = "$where"; |
|
198 |
-.Ve |
... | ... |
@@ -1,3203 +0,0 @@ |
1 |
-package DBIx::Custom; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-our $VERSION = '0.1711'; |
|
5 |
-use 5.008001; |
|
6 |
- |
|
7 |
-use Carp 'croak'; |
|
8 |
-use DBI; |
|
9 |
-use DBIx::Custom::Result; |
|
10 |
-use DBIx::Custom::Query; |
|
11 |
-use DBIx::Custom::QueryBuilder; |
|
12 |
-use DBIx::Custom::Where; |
|
13 |
-use DBIx::Custom::Model; |
|
14 |
-use DBIx::Custom::Tag; |
|
15 |
-use DBIx::Custom::Order; |
|
16 |
-use DBIx::Custom::Util qw/_array_to_hash _subname/; |
|
17 |
-use Encode qw/encode encode_utf8 decode_utf8/; |
|
18 |
- |
|
19 |
-use constant DEBUG => $ENV{DBIX_CUSTOM_DEBUG} || 0; |
|
20 |
-use constant DEBUG_ENCODING => $ENV{DBIX_CUSTOM_DEBUG_ENCODING} || 'UTF-8'; |
|
21 |
- |
|
22 |
-has [qw/connector dsn password quote user/], |
|
23 |
- cache => 0, |
|
24 |
- cache_method => sub { |
|
25 |
- sub { |
|
26 |
- my $self = shift; |
|
27 |
- |
|
28 |
- $self->{_cached} ||= {}; |
|
29 |
- |
|
30 |
- if (@_ > 1) { |
|
31 |
- $self->{_cached}{$_[0]} = $_[1]; |
|
32 |
- } |
|
33 |
- else { |
|
34 |
- return $self->{_cached}{$_[0]}; |
|
35 |
- } |
|
36 |
- } |
|
37 |
- }, |
|
38 |
- dbi_option => sub { {} }, |
|
39 |
- default_dbi_option => sub { |
|
40 |
- { |
|
41 |
- RaiseError => 1, |
|
42 |
- PrintError => 0, |
|
43 |
- AutoCommit => 1 |
|
44 |
- } |
|
45 |
- }, |
|
46 |
- filters => sub { |
|
47 |
- { |
|
48 |
- encode_utf8 => sub { encode_utf8($_[0]) }, |
|
49 |
- decode_utf8 => sub { decode_utf8($_[0]) } |
|
50 |
- } |
|
51 |
- }, |
|
52 |
- last_sql => '', |
|
53 |
- models => sub { {} }, |
|
54 |
- query_builder => sub { DBIx::Custom::QueryBuilder->new(dbi => shift) }, |
|
55 |
- result_class => 'DBIx::Custom::Result', |
|
56 |
- safety_character => '\w', |
|
57 |
- stash => sub { {} }, |
|
58 |
- tag_parse => 1; |
|
59 |
- |
|
60 |
-our $AUTOLOAD; |
|
61 |
-sub AUTOLOAD { |
|
62 |
- my $self = shift; |
|
63 |
- |
|
64 |
- # Method name |
|
65 |
- my ($package, $mname) = $AUTOLOAD =~ /^([\w\:]+)\:\:(\w+)$/; |
|
66 |
- |
|
67 |
- # Call method |
|
68 |
- $self->{_methods} ||= {}; |
|
69 |
- if (my $method = $self->{_methods}->{$mname}) { |
|
70 |
- return $self->$method(@_) |
|
71 |
- } |
|
72 |
- elsif ($self->{dbh} && (my $dbh_method = $self->dbh->can($mname))) { |
|
73 |
- $self->dbh->$dbh_method(@_); |
|
74 |
- } |
|
75 |
- else { |
|
76 |
- croak qq{Can't locate object method "$mname" via "$package" } |
|
77 |
- . _subname; |
|
78 |
- } |
|
79 |
-} |
|
80 |
- |
|
81 |
-sub assign_param { |
|
82 |
- my ($self, $param) = @_; |
|
83 |
- |
|
84 |
- # Create set tag |
|
85 |
- my @params; |
|
86 |
- my $safety = $self->safety_character; |
|
87 |
- foreach my $column (sort keys %$param) { |
|
88 |
- croak qq{"$column" is not safety column name } . _subname |
|
89 |
- unless $column =~ /^[$safety\.]+$/; |
|
90 |
- my $column_quote = $self->_q($column); |
|
91 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
92 |
- push @params, ref $param->{$column} eq 'SCALAR' |
|
93 |
- ? "$column_quote = " . ${$param->{$column}} |
|
94 |
- : "$column_quote = :$column"; |
|
95 |
- |
|
96 |
- } |
|
97 |
- my $tag = join(', ', @params); |
|
98 |
- |
|
99 |
- return $tag; |
|
100 |
-} |
|
101 |
- |
|
102 |
-sub column { |
|
103 |
- my $self = shift; |
|
104 |
- my $option = pop if ref $_[-1] eq 'HASH'; |
|
105 |
- my $real_table = shift; |
|
106 |
- my $columns = shift; |
|
107 |
- my $table = $option->{alias} || $real_table; |
|
108 |
- |
|
109 |
- # Columns |
|
110 |
- unless ($columns) { |
|
111 |
- $columns ||= $self->model($real_table)->columns; |
|
112 |
- } |
|
113 |
- |
|
114 |
- # Separator |
|
115 |
- my $separator = $self->separator; |
|
116 |
- |
|
117 |
- # Column clause |
|
118 |
- my @column; |
|
119 |
- $columns ||= []; |
|
120 |
- push @column, $self->_q($table) . "." . $self->_q($_) . |
|
121 |
- " as " . $self->_q("${table}${separator}$_") |
|
122 |
- for @$columns; |
|
123 |
- |
|
124 |
- return join (', ', @column); |
|
125 |
-} |
|
126 |
- |
|
127 |
-sub connect { |
|
128 |
- my $self = ref $_[0] ? shift : shift->new(@_);; |
|
129 |
- |
|
130 |
- # Connect |
|
131 |
- $self->dbh; |
|
132 |
- |
|
133 |
- return $self; |
|
134 |
-} |
|
135 |
- |
|
136 |
-sub dbh { |
|
137 |
- my $self = shift; |
|
138 |
- |
|
139 |
- # Set |
|
140 |
- if (@_) { |
|
141 |
- $self->{dbh} = $_[0]; |
|
142 |
- |
|
143 |
- return $self; |
|
144 |
- } |
|
145 |
- |
|
146 |
- # Get |
|
147 |
- else { |
|
148 |
- # From Connction manager |
|
149 |
- if (my $connector = $self->connector) { |
|
150 |
- croak "connector must have dbh() method " . _subname |
|
151 |
- unless ref $connector && $connector->can('dbh'); |
|
152 |
- |
|
153 |
- $self->{dbh} = $connector->dbh; |
|
154 |
- } |
|
155 |
- |
|
156 |
- # Connect |
|
157 |
- $self->{dbh} ||= $self->_connect; |
|
158 |
- |
|
159 |
- # Quote |
|
160 |
- if (!defined $self->reserved_word_quote && !defined $self->quote) { |
|
161 |
- my $driver = $self->{dbh}->{Driver}->{Name}; |
|
162 |
- my $quote = $driver eq 'mysql' ? '`' : '"'; |
|
163 |
- $self->quote($quote); |
|
164 |
- } |
|
165 |
- |
|
166 |
- return $self->{dbh}; |
|
167 |
- } |
|
168 |
-} |
|
169 |
- |
|
170 |
-sub delete { |
|
171 |
- my ($self, %args) = @_; |
|
172 |
- |
|
173 |
- # Arguments |
|
174 |
- my $table = $args{table} || ''; |
|
175 |
- croak qq{"table" option must be specified. } . _subname |
|
176 |
- unless $table; |
|
177 |
- my $where = delete $args{where} || {}; |
|
178 |
- my $append = delete $args{append}; |
|
179 |
- my $allow_delete_all = delete $args{allow_delete_all}; |
|
180 |
- my $where_param = delete $args{where_param} || {}; |
|
181 |
- my $id = delete $args{id}; |
|
182 |
- my $primary_key = delete $args{primary_key}; |
|
183 |
- croak "update method primary_key option " . |
|
184 |
- "must be specified when id is specified " . _subname |
|
185 |
- if defined $id && !defined $primary_key; |
|
186 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
187 |
- my $prefix = delete $args{prefix}; |
|
188 |
- |
|
189 |
- # Where |
|
190 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
191 |
- my $where_clause = ''; |
|
192 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
193 |
- $where_clause = "where " . $where->[0]; |
|
194 |
- $where_param = $where->[1]; |
|
195 |
- } |
|
196 |
- elsif (ref $where) { |
|
197 |
- $where = $self->_where_to_obj($where); |
|
198 |
- $where_param = keys %$where_param |
|
199 |
- ? $self->merge_param($where_param, $where->param) |
|
200 |
- : $where->param; |
|
201 |
- |
|
202 |
- # String where |
|
203 |
- $where_clause = $where->to_string; |
|
204 |
- } |
|
205 |
- elsif ($where) { $where_clause = "where $where" } |
|
206 |
- croak qq{"where" must be specified } . _subname |
|
207 |
- if $where_clause eq '' && !$allow_delete_all; |
|
208 |
- |
|
209 |
- # Delete statement |
|
210 |
- my @sql; |
|
211 |
- push @sql, "delete"; |
|
212 |
- push @sql, $prefix if defined $prefix; |
|
213 |
- push @sql, "from " . $self->_q($table) . " $where_clause"; |
|
214 |
- push @sql, $append if defined $append; |
|
215 |
- my $sql = join(' ', @sql); |
|
216 |
- |
|
217 |
- # Execute query |
|
218 |
- return $self->execute($sql, $where_param, table => $table, %args); |
|
219 |
-} |
|
220 |
- |
|
221 |
-sub delete_all { shift->delete(allow_delete_all => 1, @_) } |
|
222 |
- |
|
223 |
-sub DESTROY { } |
|
224 |
- |
|
225 |
-sub create_model { |
|
226 |
- my $self = shift; |
|
227 |
- |
|
228 |
- # Arguments |
|
229 |
- my $args = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
230 |
- $args->{dbi} = $self; |
|
231 |
- my $model_class = delete $args->{model_class} || 'DBIx::Custom::Model'; |
|
232 |
- my $model_name = delete $args->{name}; |
|
233 |
- my $model_table = delete $args->{table}; |
|
234 |
- $model_name ||= $model_table; |
|
235 |
- |
|
236 |
- # Create model |
|
237 |
- my $model = $model_class->new($args); |
|
238 |
- $model->name($model_name) unless $model->name; |
|
239 |
- $model->table($model_table) unless $model->table; |
|
240 |
- |
|
241 |
- # Apply filter(DEPRECATED logic) |
|
242 |
- if ($model->{filter}) { |
|
243 |
- my $filter = ref $model->filter eq 'HASH' |
|
244 |
- ? [%{$model->filter}] |
|
245 |
- : $model->filter; |
|
246 |
- $filter ||= []; |
|
247 |
- warn "DBIx::Custom::Model filter method is DEPRECATED!" |
|
248 |
- if @$filter; |
|
249 |
- $self->_apply_filter($model->table, @$filter); |
|
250 |
- } |
|
251 |
- |
|
252 |
- # Set model |
|
253 |
- $self->model($model->name, $model); |
|
254 |
- |
|
255 |
- return $self->model($model->name); |
|
256 |
-} |
|
257 |
- |
|
258 |
-sub each_column { |
|
259 |
- my ($self, $cb) = @_; |
|
260 |
- |
|
261 |
- # Iterate all tables |
|
262 |
- my $sth_tables = $self->dbh->table_info; |
|
263 |
- while (my $table_info = $sth_tables->fetchrow_hashref) { |
|
264 |
- |
|
265 |
- # Table |
|
266 |
- my $table = $table_info->{TABLE_NAME}; |
|
267 |
- |
|
268 |
- # Iterate all columns |
|
269 |
- my $sth_columns = $self->dbh->column_info(undef, undef, $table, '%'); |
|
270 |
- while (my $column_info = $sth_columns->fetchrow_hashref) { |
|
271 |
- my $column = $column_info->{COLUMN_NAME}; |
|
272 |
- $self->$cb($table, $column, $column_info); |
|
273 |
- } |
|
274 |
- } |
|
275 |
-} |
|
276 |
- |
|
277 |
-sub each_table { |
|
278 |
- my ($self, $cb) = @_; |
|
279 |
- |
|
280 |
- # Iterate all tables |
|
281 |
- my $sth_tables = $self->dbh->table_info; |
|
282 |
- while (my $table_info = $sth_tables->fetchrow_hashref) { |
|
283 |
- |
|
284 |
- # Table |
|
285 |
- my $table = $table_info->{TABLE_NAME}; |
|
286 |
- $self->$cb($table, $table_info); |
|
287 |
- } |
|
288 |
-} |
|
289 |
- |
|
290 |
-our %VALID_ARGS = map { $_ => 1 } qw/append allow_delete_all |
|
291 |
- allow_update_all bind_type column filter id join param prefix primary_key |
|
292 |
- query relation table table_alias type type_rule_off type_rule1_off |
|
293 |
- type_rule2_off wrap/; |
|
294 |
- |
|
295 |
-sub execute { |
|
296 |
- my $self = shift; |
|
297 |
- my $query = shift; |
|
298 |
- my $param; |
|
299 |
- $param = shift if @_ % 2; |
|
300 |
- my %args = @_; |
|
301 |
- |
|
302 |
- # Arguments |
|
303 |
- my $p = delete $args{param} || {}; |
|
304 |
- $param ||= $p; |
|
305 |
- my $tables = delete $args{table} || []; |
|
306 |
- $tables = [$tables] unless ref $tables eq 'ARRAY'; |
|
307 |
- my $filter = delete $args{filter}; |
|
308 |
- $filter = _array_to_hash($filter); |
|
309 |
- my $bind_type = delete $args{bind_type} || delete $args{type}; |
|
310 |
- $bind_type = _array_to_hash($bind_type); |
|
311 |
- my $type_rule_off = delete $args{type_rule_off}; |
|
312 |
- my $type_rule_off_parts = { |
|
313 |
- 1 => delete $args{type_rule1_off}, |
|
314 |
- 2 => delete $args{type_rule2_off} |
|
315 |
- }; |
|
316 |
- my $query_return = delete $args{query}; |
|
317 |
- my $table_alias = delete $args{table_alias} || {}; |
|
318 |
- |
|
319 |
- # Check argument names |
|
320 |
- foreach my $name (keys %args) { |
|
321 |
- croak qq{"$name" is wrong option } . _subname |
|
322 |
- unless $VALID_ARGS{$name}; |
|
323 |
- } |
|
324 |
- |
|
325 |
- # Create query |
|
326 |
- $query = $self->_create_query($query) unless ref $query; |
|
327 |
- |
|
328 |
- # Save query |
|
329 |
- $self->last_sql($query->sql); |
|
330 |
- |
|
331 |
- return $query if $query_return; |
|
332 |
- |
|
333 |
- # DEPRECATED! Merge query filter |
|
334 |
- $filter ||= $query->{filter} || {}; |
|
335 |
- |
|
336 |
- # Tables |
|
337 |
- unshift @$tables, @{$query->{tables} || []}; |
|
338 |
- my $main_table = @{$tables}[-1]; |
|
339 |
- |
|
340 |
- # DEPRECATED! Cleanup tables |
|
341 |
- $tables = $self->_remove_duplicate_table($tables, $main_table) |
|
342 |
- if @$tables > 1; |
|
343 |
- |
|
344 |
- # Type rule |
|
345 |
- my $type_filters = {}; |
|
346 |
- unless ($type_rule_off) { |
|
347 |
- foreach my $i (1, 2) { |
|
348 |
- unless ($type_rule_off_parts->{$i}) { |
|
349 |
- $type_filters->{$i} = {}; |
|
350 |
- foreach my $alias (keys %$table_alias) { |
|
351 |
- my $table = $table_alias->{$alias}; |
|
352 |
- |
|
353 |
- foreach my $column (keys %{$self->{"_into$i"}{key}{$table} || {}}) { |
|
354 |
- $type_filters->{$i}->{"$alias.$column"} = $self->{"_into$i"}{key}{$table}{$column}; |
|
355 |
- } |
|
356 |
- } |
|
357 |
- $type_filters->{$i} = {%{$type_filters->{$i}}, %{$self->{"_into$i"}{key}{$main_table} || {}}} |
|
358 |
- if $main_table; |
|
359 |
- } |
|
360 |
- } |
|
361 |
- } |
|
362 |
- |
|
363 |
- # DEPRECATED! Applied filter |
|
364 |
- if ($self->{filter}{on}) { |
|
365 |
- my $applied_filter = {}; |
|
366 |
- foreach my $table (@$tables) { |
|
367 |
- $applied_filter = { |
|
368 |
- %$applied_filter, |
|
369 |
- %{$self->{filter}{out}->{$table} || {}} |
|
370 |
- } |
|
371 |
- } |
|
372 |
- $filter = {%$applied_filter, %$filter}; |
|
373 |
- } |
|
374 |
- |
|
375 |
- # Replace filter name to code |
|
376 |
- foreach my $column (keys %$filter) { |
|
377 |
- my $name = $filter->{$column}; |
|
378 |
- if (!defined $name) { |
|
379 |
- $filter->{$column} = undef; |
|
380 |
- } |
|
381 |
- elsif (ref $name ne 'CODE') { |
|
382 |
- croak qq{Filter "$name" is not registered" } . _subname |
|
383 |
- unless exists $self->filters->{$name}; |
|
384 |
- $filter->{$column} = $self->filters->{$name}; |
|
385 |
- } |
|
386 |
- } |
|
387 |
- |
|
388 |
- # Create bind values |
|
389 |
- my $bind = $self->_create_bind_values( |
|
390 |
- $param, |
|
391 |
- $query->columns, |
|
392 |
- $filter, |
|
393 |
- $type_filters, |
|
394 |
- $bind_type |
|
395 |
- ); |
|
396 |
- |
|
397 |
- # Execute |
|
398 |
- my $sth = $query->sth; |
|
399 |
- my $affected; |
|
400 |
- eval { |
|
401 |
- for (my $i = 0; $i < @$bind; $i++) { |
|
402 |
- my $bind_type = $bind->[$i]->{bind_type}; |
|
403 |
- $sth->bind_param( |
|
404 |
- $i + 1, |
|
405 |
- $bind->[$i]->{value}, |
|
406 |
- $bind_type ? $bind_type : () |
|
407 |
- ); |
|
408 |
- } |
|
409 |
- $affected = $sth->execute; |
|
410 |
- }; |
|
411 |
- |
|
412 |
- $self->_croak($@, qq{. Following SQL is executed.\n} |
|
413 |
- . qq{$query->{sql}\n} . _subname) if $@; |
|
414 |
- |
|
415 |
- # DEBUG message |
|
416 |
- if (DEBUG) { |
|
417 |
- print STDERR "SQL:\n" . $query->sql . "\n"; |
|
418 |
- my @output; |
|
419 |
- foreach my $b (@$bind) { |
|
420 |
- my $value = $b->{value}; |
|
421 |
- $value = 'undef' unless defined $value; |
|
422 |
- $value = encode(DEBUG_ENCODING(), $value) |
|
423 |
- if utf8::is_utf8($value); |
|
424 |
- push @output, $value; |
|
425 |
- } |
|
426 |
- print STDERR "Bind values: " . join(', ', @output) . "\n\n"; |
|
427 |
- } |
|
428 |
- |
|
429 |
- # Select statement |
|
430 |
- if ($sth->{NUM_OF_FIELDS}) { |
|
431 |
- |
|
432 |
- # DEPRECATED! Filter |
|
433 |
- my $filter = {}; |
|
434 |
- if ($self->{filter}{on}) { |
|
435 |
- $filter->{in} = {}; |
|
436 |
- $filter->{end} = {}; |
|
437 |
- push @$tables, $main_table if $main_table; |
|
438 |
- foreach my $table (@$tables) { |
|
439 |
- foreach my $way (qw/in end/) { |
|
440 |
- $filter->{$way} = { |
|
441 |
- %{$filter->{$way}}, |
|
442 |
- %{$self->{filter}{$way}{$table} || {}} |
|
443 |
- }; |
|
444 |
- } |
|
445 |
- } |
|
446 |
- } |
|
447 |
- |
|
448 |
- # Result |
|
449 |
- my $result = $self->result_class->new( |
|
450 |
- sth => $sth, |
|
451 |
- dbi => $self, |
|
452 |
- default_filter => $self->{default_in_filter}, |
|
453 |
- filter => $filter->{in} || {}, |
|
454 |
- end_filter => $filter->{end} || {}, |
|
455 |
- type_rule => { |
|
456 |
- from1 => $self->type_rule->{from1}, |
|
457 |
- from2 => $self->type_rule->{from2} |
|
458 |
- }, |
|
459 |
- ); |
|
460 |
- |
|
461 |
- return $result; |
|
462 |
- } |
|
463 |
- |
|
464 |
- # Not select statement |
|
465 |
- else { return $affected } |
|
466 |
-} |
|
467 |
- |
|
468 |
-sub insert { |
|
469 |
- my $self = shift; |
|
470 |
- |
|
471 |
- # Arguments |
|
472 |
- my $param; |
|
473 |
- $param = shift if @_ % 2; |
|
474 |
- my %args = @_; |
|
475 |
- my $table = delete $args{table}; |
|
476 |
- croak qq{"table" option must be specified } . _subname |
|
477 |
- unless defined $table; |
|
478 |
- my $p = delete $args{param} || {}; |
|
479 |
- $param ||= $p; |
|
480 |
- my $append = delete $args{append} || ''; |
|
481 |
- my $id = delete $args{id}; |
|
482 |
- my $primary_key = delete $args{primary_key}; |
|
483 |
- croak "insert method primary_key option " . |
|
484 |
- "must be specified when id is specified " . _subname |
|
485 |
- if defined $id && !defined $primary_key; |
|
486 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
487 |
- my $prefix = delete $args{prefix}; |
|
488 |
- |
|
489 |
- # Merge parameter |
|
490 |
- if (defined $id) { |
|
491 |
- my $id_param = $self->_create_param_from_id($id, $primary_key); |
|
492 |
- $param = $self->merge_param($id_param, $param); |
|
493 |
- } |
|
494 |
- |
|
495 |
- # Insert statement |
|
496 |
- my @sql; |
|
497 |
- push @sql, "insert"; |
|
498 |
- push @sql, $prefix if defined $prefix; |
|
499 |
- push @sql, "into " . $self->_q($table) . " " . $self->insert_param($param); |
|
500 |
- push @sql, $append if defined $append; |
|
501 |
- my $sql = join (' ', @sql); |
|
502 |
- |
|
503 |
- # Execute query |
|
504 |
- return $self->execute($sql, $param, table => $table, %args); |
|
505 |
-} |
|
506 |
- |
|
507 |
-sub insert_param { |
|
508 |
- my ($self, $param) = @_; |
|
509 |
- |
|
510 |
- # Create insert parameter tag |
|
511 |
- my $safety = $self->safety_character; |
|
512 |
- my @columns; |
|
513 |
- my @placeholders; |
|
514 |
- foreach my $column (sort keys %$param) { |
|
515 |
- croak qq{"$column" is not safety column name } . _subname |
|
516 |
- unless $column =~ /^[$safety\.]+$/; |
|
517 |
- my $column_quote = $self->_q($column); |
|
518 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
519 |
- push @columns, $column_quote; |
|
520 |
- push @placeholders, ref $param->{$column} eq 'SCALAR' |
|
521 |
- ? ${$param->{$column}} : ":$column"; |
|
522 |
- } |
|
523 |
- |
|
524 |
- return '(' . join(', ', @columns) . ') ' . 'values ' . |
|
525 |
- '(' . join(', ', @placeholders) . ')' |
|
526 |
-} |
|
527 |
- |
|
528 |
-sub include_model { |
|
529 |
- my ($self, $name_space, $model_infos) = @_; |
|
530 |
- |
|
531 |
- # Name space |
|
532 |
- $name_space ||= ''; |
|
533 |
- |
|
534 |
- # Get Model infomations |
|
535 |
- unless ($model_infos) { |
|
536 |
- |
|
537 |
- # Load name space module |
|
538 |
- croak qq{"$name_space" is invalid class name } . _subname |
|
539 |
- if $name_space =~ /[^\w:]/; |
|
540 |
- eval "use $name_space"; |
|
541 |
- croak qq{Name space module "$name_space.pm" is needed. $@ } |
|
542 |
- . _subname |
|
543 |
- if $@; |
|
544 |
- |
|
545 |
- # Search model modules |
|
546 |
- my $path = $INC{"$name_space.pm"}; |
|
547 |
- $path =~ s/\.pm$//; |
|
548 |
- opendir my $dh, $path |
|
549 |
- or croak qq{Can't open directory "$path": $! } . _subname |
|
550 |
- $model_infos = []; |
|
551 |
- while (my $module = readdir $dh) { |
|
552 |
- push @$model_infos, $module |
|
553 |
- if $module =~ s/\.pm$//; |
|
554 |
- } |
|
555 |
- close $dh; |
|
556 |
- } |
|
557 |
- |
|
558 |
- # Include models |
|
559 |
- foreach my $model_info (@$model_infos) { |
|
560 |
- |
|
561 |
- # Load model |
|
562 |
- my $model_class; |
|
563 |
- my $model_name; |
|
564 |
- my $model_table; |
|
565 |
- if (ref $model_info eq 'HASH') { |
|
566 |
- $model_class = $model_info->{class}; |
|
567 |
- $model_name = $model_info->{name}; |
|
568 |
- $model_table = $model_info->{table}; |
|
569 |
- |
|
570 |
- $model_name ||= $model_class; |
|
571 |
- $model_table ||= $model_name; |
|
572 |
- } |
|
573 |
- else { $model_class = $model_name = $model_table = $model_info } |
|
574 |
- my $mclass = "${name_space}::$model_class"; |
|
575 |
- croak qq{"$mclass" is invalid class name } . _subname |
|
576 |
- if $mclass =~ /[^\w:]/; |
|
577 |
- unless ($mclass->can('isa')) { |
|
578 |
- eval "use $mclass"; |
|
579 |
- croak "$@ " . _subname if $@; |
|
580 |
- } |
|
581 |
- |
|
582 |
- # Create model |
|
583 |
- my $args = {}; |
|
584 |
- $args->{model_class} = $mclass if $mclass; |
|
585 |
- $args->{name} = $model_name if $model_name; |
|
586 |
- $args->{table} = $model_table if $model_table; |
|
587 |
- $self->create_model($args); |
|
588 |
- } |
|
589 |
- |
|
590 |
- return $self; |
|
591 |
-} |
|
592 |
- |
|
593 |
-sub map_param { |
|
594 |
- my $self = shift; |
|
595 |
- my $param = shift; |
|
596 |
- my %map = @_; |
|
597 |
- |
|
598 |
- # Mapping |
|
599 |
- my $map_param = {}; |
|
600 |
- foreach my $key (keys %map) { |
|
601 |
- my $value_cb; |
|
602 |
- my $condition; |
|
603 |
- my $map_key; |
|
604 |
- |
|
605 |
- # Get mapping information |
|
606 |
- if (ref $map{$key} eq 'ARRAY') { |
|
607 |
- foreach my $some (@{$map{$key}}) { |
|
608 |
- $map_key = $some unless ref $some; |
|
609 |
- $condition = $some->{if} if ref $some eq 'HASH'; |
|
610 |
- $value_cb = $some if ref $some eq 'CODE'; |
|
611 |
- } |
|
612 |
- } |
|
613 |
- else { |
|
614 |
- $map_key = $map{$key}; |
|
615 |
- } |
|
616 |
- $value_cb ||= sub { $_[0] }; |
|
617 |
- $condition ||= sub { defined $_[0] && length $_[0] }; |
|
618 |
- |
|
619 |
- # Map parameter |
|
620 |
- my $value; |
|
621 |
- if (ref $condition eq 'CODE') { |
|
622 |
- $map_param->{$map_key} = $value_cb->($param->{$key}) |
|
623 |
- if $condition->($param->{$key}); |
|
624 |
- } |
|
625 |
- elsif ($condition eq 'exists') { |
|
626 |
- $map_param->{$map_key} = $value_cb->($param->{$key}) |
|
627 |
- if exists $param->{$key}; |
|
628 |
- } |
|
629 |
- else { croak qq/Condition must be code reference or "exists" / . _subname } |
|
630 |
- } |
|
631 |
- |
|
632 |
- return $map_param; |
|
633 |
-} |
|
634 |
- |
|
635 |
-sub merge_param { |
|
636 |
- my ($self, @params) = @_; |
|
637 |
- |
|
638 |
- # Merge parameters |
|
639 |
- my $merge = {}; |
|
640 |
- foreach my $param (@params) { |
|
641 |
- foreach my $column (keys %$param) { |
|
642 |
- my $param_is_array = ref $param->{$column} eq 'ARRAY' ? 1 : 0; |
|
643 |
- |
|
644 |
- if (exists $merge->{$column}) { |
|
645 |
- $merge->{$column} = [$merge->{$column}] |
|
646 |
- unless ref $merge->{$column} eq 'ARRAY'; |
|
647 |
- push @{$merge->{$column}}, |
|
648 |
- ref $param->{$column} ? @{$param->{$column}} : $param->{$column}; |
|
649 |
- } |
|
650 |
- else { |
|
651 |
- $merge->{$column} = $param->{$column}; |
|
652 |
- } |
|
653 |
- } |
|
654 |
- } |
|
655 |
- |
|
656 |
- return $merge; |
|
657 |
-} |
|
658 |
- |
|
659 |
-sub method { |
|
660 |
- my $self = shift; |
|
661 |
- |
|
662 |
- # Register method |
|
663 |
- my $methods = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
664 |
- $self->{_methods} = {%{$self->{_methods} || {}}, %$methods}; |
|
665 |
- |
|
666 |
- return $self; |
|
667 |
-} |
|
668 |
- |
|
669 |
-sub model { |
|
670 |
- my ($self, $name, $model) = @_; |
|
671 |
- |
|
672 |
- # Set model |
|
673 |
- if ($model) { |
|
674 |
- $self->models->{$name} = $model; |
|
675 |
- return $self; |
|
676 |
- } |
|
677 |
- |
|
678 |
- # Check model existance |
|
679 |
- croak qq{Model "$name" is not included } . _subname |
|
680 |
- unless $self->models->{$name}; |
|
681 |
- |
|
682 |
- # Get model |
|
683 |
- return $self->models->{$name}; |
|
684 |
-} |
|
685 |
- |
|
686 |
-sub mycolumn { |
|
687 |
- my ($self, $table, $columns) = @_; |
|
688 |
- |
|
689 |
- # Create column clause |
|
690 |
- my @column; |
|
691 |
- $columns ||= []; |
|
692 |
- push @column, $self->_q($table) . "." . $self->_q($_) . |
|
693 |
- " as " . $self->_q($_) |
|
694 |
- for @$columns; |
|
695 |
- |
|
696 |
- return join (', ', @column); |
|
697 |
-} |
|
698 |
- |
|
699 |
-sub new { |
|
700 |
- my $self = shift->SUPER::new(@_); |
|
701 |
- |
|
702 |
- # Check attributes |
|
703 |
- my @attrs = keys %$self; |
|
704 |
- foreach my $attr (@attrs) { |
|
705 |
- croak qq{"$attr" is wrong name } . _subname |
|
706 |
- unless $self->can($attr); |
|
707 |
- } |
|
708 |
- |
|
709 |
- # DEPRECATED! |
|
710 |
- $self->query_builder->{tags} = { |
|
711 |
- '?' => \&DBIx::Custom::Tag::placeholder, |
|
712 |
- '=' => \&DBIx::Custom::Tag::equal, |
|
713 |
- '<>' => \&DBIx::Custom::Tag::not_equal, |
|
714 |
- '>' => \&DBIx::Custom::Tag::greater_than, |
|
715 |
- '<' => \&DBIx::Custom::Tag::lower_than, |
|
716 |
- '>=' => \&DBIx::Custom::Tag::greater_than_equal, |
|
717 |
- '<=' => \&DBIx::Custom::Tag::lower_than_equal, |
|
718 |
- 'like' => \&DBIx::Custom::Tag::like, |
|
719 |
- 'in' => \&DBIx::Custom::Tag::in, |
|
720 |
- 'insert_param' => \&DBIx::Custom::Tag::insert_param, |
|
721 |
- 'update_param' => \&DBIx::Custom::Tag::update_param |
|
722 |
- }; |
|
723 |
- |
|
724 |
- return $self; |
|
725 |
-} |
|
726 |
- |
|
727 |
-sub not_exists { bless {}, 'DBIx::Custom::NotExists' } |
|
728 |
- |
|
729 |
-sub order { |
|
730 |
- my $self = shift; |
|
731 |
- return DBIx::Custom::Order->new(dbi => $self, @_); |
|
732 |
-} |
|
733 |
- |
|
734 |
-sub register_filter { |
|
735 |
- my $self = shift; |
|
736 |
- |
|
737 |
- # Register filter |
|
738 |
- my $filters = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
739 |
- $self->filters({%{$self->filters}, %$filters}); |
|
740 |
- |
|
741 |
- return $self; |
|
742 |
-} |
|
743 |
- |
|
744 |
-sub select { |
|
745 |
- my ($self, %args) = @_; |
|
746 |
- |
|
747 |
- # Arguments |
|
748 |
- my $table = delete $args{table}; |
|
749 |
- my $tables = ref $table eq 'ARRAY' ? $table |
|
750 |
- : defined $table ? [$table] |
|
751 |
- : []; |
|
752 |
- my $columns = delete $args{column}; |
|
753 |
- my $where = delete $args{where} || {}; |
|
754 |
- my $append = delete $args{append}; |
|
755 |
- my $join = delete $args{join} || []; |
|
756 |
- croak qq{"join" must be array reference } . _subname |
|
757 |
- unless ref $join eq 'ARRAY'; |
|
758 |
- my $relation = delete $args{relation}; |
|
759 |
- warn "select() relation option is DEPRECATED!" |
|
760 |
- if $relation; |
|
761 |
- my $param = delete $args{param} || {}; # DEPRECATED! |
|
762 |
- warn "select() param option is DEPRECATED!" |
|
763 |
- if keys %$param; |
|
764 |
- my $where_param = delete $args{where_param} || $param || {}; |
|
765 |
- my $wrap = delete $args{wrap}; |
|
766 |
- my $id = delete $args{id}; |
|
767 |
- my $primary_key = delete $args{primary_key}; |
|
768 |
- croak "update method primary_key option " . |
|
769 |
- "must be specified when id is specified " . _subname |
|
770 |
- if defined $id && !defined $primary_key; |
|
771 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
772 |
- my $prefix = delete $args{prefix}; |
|
773 |
- |
|
774 |
- # Add relation tables(DEPRECATED!); |
|
775 |
- $self->_add_relation_table($tables, $relation); |
|
776 |
- |
|
777 |
- # Select statement |
|
778 |
- my @sql; |
|
779 |
- push @sql, 'select'; |
|
780 |
- |
|
781 |
- # Prefix |
|
782 |
- push @sql, $prefix if defined $prefix; |
|
783 |
- |
|
784 |
- # Column clause |
|
785 |
- if ($columns) { |
|
786 |
- $columns = [$columns] unless ref $columns eq 'ARRAY'; |
|
787 |
- foreach my $column (@$columns) { |
|
788 |
- if (ref $column eq 'HASH') { |
|
789 |
- $column = $self->column(%$column) if ref $column eq 'HASH'; |
|
790 |
- } |
|
791 |
- elsif (ref $column eq 'ARRAY') { |
|
792 |
- if (@$column == 3 && $column->[1] eq 'as') { |
|
793 |
- warn "[COLUMN, as => ALIAS] is DEPRECATED! use [COLUMN => ALIAS]"; |
|
794 |
- splice @$column, 1, 1; |
|
795 |
- } |
|
796 |
- |
|
797 |
- $column = join(' ', $column->[0], 'as', $self->_q($column->[1])); |
|
798 |
- } |
|
799 |
- unshift @$tables, @{$self->_search_tables($column)}; |
|
800 |
- push @sql, ($column, ','); |
|
801 |
- } |
|
802 |
- pop @sql if $sql[-1] eq ','; |
|
803 |
- } |
|
804 |
- else { push @sql, '*' } |
|
805 |
- |
|
806 |
- # Table |
|
807 |
- push @sql, 'from'; |
|
808 |
- if ($relation) { |
|
809 |
- my $found = {}; |
|
810 |
- foreach my $table (@$tables) { |
|
811 |
- push @sql, ($self->_q($table), ',') unless $found->{$table}; |
|
812 |
- $found->{$table} = 1; |
|
813 |
- } |
|
814 |
- } |
|
815 |
- else { |
|
816 |
- my $main_table = $tables->[-1] || ''; |
|
817 |
- push @sql, $self->_q($main_table); |
|
818 |
- } |
|
819 |
- pop @sql if ($sql[-1] || '') eq ','; |
|
820 |
- croak "Not found table name " . _subname |
|
821 |
- unless $tables->[-1]; |
|
822 |
- |
|
823 |
- # Add tables in parameter |
|
824 |
- unshift @$tables, |
|
825 |
- @{$self->_search_tables(join(' ', keys %$where_param) || '')}; |
|
826 |
- |
|
827 |
- # Where |
|
828 |
- my $where_clause = ''; |
|
829 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
830 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
831 |
- $where_clause = "where " . $where->[0]; |
|
832 |
- $where_param = $where->[1]; |
|
833 |
- } |
|
834 |
- elsif (ref $where) { |
|
835 |
- $where = $self->_where_to_obj($where); |
|
836 |
- $where_param = keys %$where_param |
|
837 |
- ? $self->merge_param($where_param, $where->param) |
|
838 |
- : $where->param; |
|
839 |
- |
|
840 |
- # String where |
|
841 |
- $where_clause = $where->to_string; |
|
842 |
- } |
|
843 |
- elsif ($where) { $where_clause = "where $where" } |
|
844 |
- |
|
845 |
- # Add table names in where clause |
|
846 |
- unshift @$tables, @{$self->_search_tables($where_clause)}; |
|
847 |
- |
|
848 |
- # Push join |
|
849 |
- $self->_push_join(\@sql, $join, $tables); |
|
850 |
- |
|
851 |
- # Add where clause |
|
852 |
- push @sql, $where_clause; |
|
853 |
- |
|
854 |
- # Relation(DEPRECATED!); |
|
855 |
- $self->_push_relation(\@sql, $tables, $relation, $where_clause eq '' ? 1 : 0); |
|
856 |
- |
|
857 |
- # Append |
|
858 |
- push @sql, $append if defined $append; |
|
859 |
- |
|
860 |
- # Wrap |
|
861 |
- if ($wrap) { |
|
862 |
- croak "wrap option must be array refrence " . _subname |
|
863 |
- unless ref $wrap eq 'ARRAY'; |
|
864 |
- unshift @sql, $wrap->[0]; |
|
865 |
- push @sql, $wrap->[1]; |
|
866 |
- } |
|
867 |
- |
|
868 |
- # SQL |
|
869 |
- my $sql = join (' ', @sql); |
|
870 |
- |
|
871 |
- # Execute query |
|
872 |
- my $result = $self->execute($sql, $where_param, table => $tables, %args); |
|
873 |
- |
|
874 |
- return $result; |
|
875 |
-} |
|
876 |
- |
|
877 |
-sub separator { |
|
878 |
- my $self = shift; |
|
879 |
- |
|
880 |
- if (@_) { |
|
881 |
- my $separator = $_[0] || ''; |
|
882 |
- croak qq{Separator must be "." or "__" or "-" } . _subname |
|
883 |
- unless $separator eq '.' || $separator eq '__' |
|
884 |
- || $separator eq '-'; |
|
885 |
- |
|
886 |
- $self->{separator} = $separator; |
|
887 |
- |
|
888 |
- return $self; |
|
889 |
- } |
|
890 |
- return $self->{separator} ||= '.'; |
|
891 |
-} |
|
892 |
- |
|
893 |
-sub setup_model { |
|
894 |
- my $self = shift; |
|
895 |
- |
|
896 |
- # Setup model |
|
897 |
- $self->each_column( |
|
898 |
- sub { |
|
899 |
- my ($self, $table, $column, $column_info) = @_; |
|
900 |
- if (my $model = $self->models->{$table}) { |
|
901 |
- push @{$model->columns}, $column; |
|
902 |
- } |
|
903 |
- } |
|
904 |
- ); |
|
905 |
- return $self; |
|
906 |
-} |
|
907 |
- |
|
908 |
-sub available_data_type { |
|
909 |
- my $self = shift; |
|
910 |
- |
|
911 |
- my $data_types = ''; |
|
912 |
- foreach my $i (-1000 .. 1000) { |
|
913 |
- my $type_info = $self->dbh->type_info($i); |
|
914 |
- my $data_type = $type_info->{DATA_TYPE}; |
|
915 |
- my $type_name = $type_info->{TYPE_NAME}; |
|
916 |
- $data_types .= "$data_type ($type_name)\n" |
|
917 |
- if defined $data_type; |
|
918 |
- } |
|
919 |
- return "Data Type maybe equal to Type Name" unless $data_types; |
|
920 |
- $data_types = "Data Type (Type name)\n" . $data_types; |
|
921 |
- return $data_types; |
|
922 |
-} |
|
923 |
- |
|
924 |
-sub available_type_name { |
|
925 |
- my $self = shift; |
|
926 |
- |
|
927 |
- # Type Names |
|
928 |
- my $type_names = {}; |
|
929 |
- $self->each_column(sub { |
|
930 |
- my ($self, $table, $column, $column_info) = @_; |
|
931 |
- $type_names->{$column_info->{TYPE_NAME}} = 1 |
|
932 |
- if $column_info->{TYPE_NAME}; |
|
933 |
- }); |
|
934 |
- my @output = sort keys %$type_names; |
|
935 |
- unshift @output, "Type Name"; |
|
936 |
- return join "\n", @output; |
|
937 |
-} |
|
938 |
- |
|
939 |
-sub type_rule { |
|
940 |
- my $self = shift; |
|
941 |
- |
|
942 |
- if (@_) { |
|
943 |
- my $type_rule = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
944 |
- |
|
945 |
- # Into |
|
946 |
- foreach my $i (1 .. 2) { |
|
947 |
- my $into = "into$i"; |
|
948 |
- $type_rule->{$into} = _array_to_hash($type_rule->{$into}); |
|
949 |
- $self->{type_rule} = $type_rule; |
|
950 |
- $self->{"_$into"} = {}; |
|
951 |
- foreach my $type_name (keys %{$type_rule->{$into} || {}}) { |
|
952 |
- croak qq{type name of $into section must be lower case} |
|
953 |
- if $type_name =~ /[A-Z]/; |
|
954 |
- } |
|
955 |
- $self->each_column(sub { |
|
956 |
- my ($dbi, $table, $column, $column_info) = @_; |
|
957 |
- |
|
958 |
- my $type_name = lc $column_info->{TYPE_NAME}; |
|
959 |
- if ($type_rule->{$into} && |
|
960 |
- (my $filter = $type_rule->{$into}->{$type_name})) |
|
961 |
- { |
|
962 |
- return unless exists $type_rule->{$into}->{$type_name}; |
|
963 |
- if (defined $filter && ref $filter ne 'CODE') |
|
964 |
- { |
|
965 |
- my $fname = $filter; |
|
966 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
967 |
- unless exists $self->filters->{$fname}; |
|
968 |
- |
|
969 |
- $filter = $self->filters->{$fname}; |
|
970 |
- } |
|
971 |
- |
|
972 |
- $self->{"_$into"}{key}{$table}{$column} = $filter; |
|
973 |
- $self->{"_$into"}{dot}{"$table.$column"} = $filter; |
|
974 |
- } |
|
975 |
- }); |
|
976 |
- } |
|
977 |
- |
|
978 |
- # From |
|
979 |
- foreach my $i (1 .. 2) { |
|
980 |
- $type_rule->{"from$i"} = _array_to_hash($type_rule->{"from$i"}); |
|
981 |
- foreach my $data_type (keys %{$type_rule->{"from$i"} || {}}) { |
|
982 |
- croak qq{data type of from$i section must be lower case or number} |
|
983 |
- if $data_type =~ /[A-Z]/; |
|
984 |
- my $fname = $type_rule->{"from$i"}{$data_type}; |
|
985 |
- if (defined $fname && ref $fname ne 'CODE') { |
|
986 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
987 |
- unless exists $self->filters->{$fname}; |
|
988 |
- |
|
989 |
- $type_rule->{"from$i"}{$data_type} = $self->filters->{$fname}; |
|
990 |
- } |
|
991 |
- } |
|
992 |
- } |
|
993 |
- |
|
994 |
- return $self; |
|
995 |
- } |
|
996 |
- |
|
997 |
- return $self->{type_rule} || {}; |
|
998 |
-} |
|
999 |
- |
|
1000 |
-sub update { |
|
1001 |
- my $self = shift; |
|
1002 |
- |
|
1003 |
- # Arguments |
|
1004 |
- my $param; |
|
1005 |
- $param = shift if @_ % 2; |
|
1006 |
- my %args = @_; |
|
1007 |
- my $table = delete $args{table} || ''; |
|
1008 |
- croak qq{"table" option must be specified } . _subname |
|
1009 |
- unless $table; |
|
1010 |
- my $p = delete $args{param} || {}; |
|
1011 |
- $param ||= $p; |
|
1012 |
- my $where = delete $args{where} || {}; |
|
1013 |
- my $where_param = delete $args{where_param} || {}; |
|
1014 |
- my $append = delete $args{append} || ''; |
|
1015 |
- my $allow_update_all = delete $args{allow_update_all}; |
|
1016 |
- my $id = delete $args{id}; |
|
1017 |
- my $primary_key = delete $args{primary_key}; |
|
1018 |
- croak "update method primary_key option " . |
|
1019 |
- "must be specified when id is specified " . _subname |
|
1020 |
- if defined $id && !defined $primary_key; |
|
1021 |
- $primary_key = [$primary_key] unless ref $primary_key eq 'ARRAY'; |
|
1022 |
- my $prefix = delete $args{prefix}; |
|
1023 |
- |
|
1024 |
- # Update clause |
|
1025 |
- my $update_clause = $self->update_param($param); |
|
1026 |
- |
|
1027 |
- # Where |
|
1028 |
- $where = $self->_create_param_from_id($id, $primary_key) if defined $id; |
|
1029 |
- my $where_clause = ''; |
|
1030 |
- if (ref $where eq 'ARRAY' && !ref $where->[0]) { |
|
1031 |
- $where_clause = "where " . $where->[0]; |
|
1032 |
- $where_param = $where->[1]; |
|
1033 |
- } |
|
1034 |
- elsif (ref $where) { |
|
1035 |
- $where = $self->_where_to_obj($where); |
|
1036 |
- $where_param = keys %$where_param |
|
1037 |
- ? $self->merge_param($where_param, $where->param) |
|
1038 |
- : $where->param; |
|
1039 |
- |
|
1040 |
- # String where |
|
1041 |
- $where_clause = $where->to_string; |
|
1042 |
- } |
|
1043 |
- elsif ($where) { $where_clause = "where $where" } |
|
1044 |
- croak qq{"where" must be specified } . _subname |
|
1045 |
- if "$where_clause" eq '' && !$allow_update_all; |
|
1046 |
- |
|
1047 |
- # Merge param |
|
1048 |
- $param = $self->merge_param($param, $where_param) if keys %$where_param; |
|
1049 |
- |
|
1050 |
- # Update statement |
|
1051 |
- my @sql; |
|
1052 |
- push @sql, "update"; |
|
1053 |
- push @sql, $prefix if defined $prefix; |
|
1054 |
- push @sql, $self->_q($table) . " $update_clause $where_clause"; |
|
1055 |
- push @sql, $append if defined $append; |
|
1056 |
- |
|
1057 |
- # SQL |
|
1058 |
- my $sql = join(' ', @sql); |
|
1059 |
- |
|
1060 |
- # Execute query |
|
1061 |
- return $self->execute($sql, $param, table => $table, %args); |
|
1062 |
-} |
|
1063 |
- |
|
1064 |
-sub update_all { shift->update(allow_update_all => 1, @_) }; |
|
1065 |
- |
|
1066 |
-sub update_param { |
|
1067 |
- my ($self, $param, $opt) = @_; |
|
1068 |
- |
|
1069 |
- # Create update parameter tag |
|
1070 |
- my $tag = $self->assign_param($param); |
|
1071 |
- $tag = "set $tag" unless $opt->{no_set}; |
|
1072 |
- |
|
1073 |
- return $tag; |
|
1074 |
-} |
|
1075 |
- |
|
1076 |
-sub where { DBIx::Custom::Where->new(dbi => shift, @_) } |
|
1077 |
- |
|
1078 |
-sub _create_query { |
|
1079 |
- |
|
1080 |
- my ($self, $source) = @_; |
|
1081 |
- |
|
1082 |
- # Cache |
|
1083 |
- my $cache = $self->cache; |
|
1084 |
- |
|
1085 |
- # Query |
|
1086 |
- my $query; |
|
1087 |
- |
|
1088 |
- # Get cached query |
|
1089 |
- if ($cache) { |
|
1090 |
- |
|
1091 |
- # Get query |
|
1092 |
- my $q = $self->cache_method->($self, $source); |
|
1093 |
- |
|
1094 |
- # Create query |
|
1095 |
- if ($q) { |
|
1096 |
- $query = DBIx::Custom::Query->new($q); |
|
1097 |
- $query->{filters} = $self->filters; |
|
1098 |
- } |
|
1099 |
- } |
|
1100 |
- |
|
1101 |
- # Create query |
|
1102 |
- unless ($query) { |
|
1103 |
- |
|
1104 |
- # Create query |
|
1105 |
- my $builder = $self->query_builder; |
|
1106 |
- $query = $builder->build_query($source); |
|
1107 |
- |
|
1108 |
- # Remove reserved word quote |
|
1109 |
- if (my $q = $self->_quote) { |
|
1110 |
- $q = quotemeta($q); |
|
1111 |
- $_ =~ s/[$q]//g for @{$query->columns} |
|
1112 |
- } |
|
1113 |
- |
|
1114 |
- # Save query to cache |
|
1115 |
- $self->cache_method->( |
|
1116 |
- $self, $source, |
|
1117 |
- { |
|
1118 |
- sql => $query->sql, |
|
1119 |
- columns => $query->columns, |
|
1120 |
- tables => $query->{tables} || [] |
|
1121 |
- } |
|
1122 |
- ) if $cache; |
|
1123 |
- } |
|
1124 |
- |
|
1125 |
- # Save sql |
|
1126 |
- $self->last_sql($query->sql); |
|
1127 |
- |
|
1128 |
- # Prepare statement handle |
|
1129 |
- my $sth; |
|
1130 |
- eval { $sth = $self->dbh->prepare($query->{sql})}; |
|
1131 |
- |
|
1132 |
- if ($@) { |
|
1133 |
- $self->_croak($@, qq{. Following SQL is executed.\n} |
|
1134 |
- . qq{$query->{sql}\n} . _subname); |
|
1135 |
- } |
|
1136 |
- |
|
1137 |
- # Set statement handle |
|
1138 |
- $query->sth($sth); |
|
1139 |
- |
|
1140 |
- # Set filters |
|
1141 |
- $query->{filters} = $self->filters; |
|
1142 |
- |
|
1143 |
- return $query; |
|
1144 |
-} |
|
1145 |
- |
|
1146 |
-sub _create_bind_values { |
|
1147 |
- my ($self, $params, $columns, $filter, $type_filters, $bind_type) = @_; |
|
1148 |
- |
|
1149 |
- # Create bind values |
|
1150 |
- my $bind = []; |
|
1151 |
- my $count = {}; |
|
1152 |
- my $not_exists = {}; |
|
1153 |
- foreach my $column (@$columns) { |
|
1154 |
- |
|
1155 |
- # Value |
|
1156 |
- my $value; |
|
1157 |
- if(ref $params->{$column} eq 'ARRAY') { |
|
1158 |
- my $i = $count->{$column} || 0; |
|
1159 |
- $i += $not_exists->{$column} || 0; |
|
1160 |
- my $found; |
|
1161 |
- for (my $k = $i; $i < @{$params->{$column}}; $k++) { |
|
1162 |
- if (ref $params->{$column}->[$k] eq 'DBIx::Custom::NotExists') { |
|
1163 |
- $not_exists->{$column}++; |
|
1164 |
- } |
|
1165 |
- else { |
|
1166 |
- $value = $params->{$column}->[$k]; |
|
1167 |
- $found = 1; |
|
1168 |
- last |
|
1169 |
- } |
|
1170 |
- } |
|
1171 |
- next unless $found; |
|
1172 |
- } |
|
1173 |
- else { $value = $params->{$column} } |
|
1174 |
- |
|
1175 |
- # Filter |
|
1176 |
- my $f = $filter->{$column} || $self->{default_out_filter} || ''; |
|
1177 |
- $value = $f->($value) if $f; |
|
1178 |
- |
|
1179 |
- # Type rule |
|
1180 |
- foreach my $i (1 .. 2) { |
|
1181 |
- my $type_filter = $type_filters->{$i}; |
|
1182 |
- my $tf = $self->{"_into$i"}->{dot}->{$column} || $type_filter->{$column}; |
|
1183 |
- $value = $tf->($value) if $tf; |
|
1184 |
- } |
|
1185 |
- |
|
1186 |
- # Bind values |
|
1187 |
- push @$bind, {value => $value, bind_type => $bind_type->{$column}}; |
|
1188 |
- |
|
1189 |
- # Count up |
|
1190 |
- $count->{$column}++; |
|
1191 |
- } |
|
1192 |
- |
|
1193 |
- return $bind; |
|
1194 |
-} |
|
1195 |
- |
|
1196 |
-sub _create_param_from_id { |
|
1197 |
- my ($self, $id, $primary_keys) = @_; |
|
1198 |
- |
|
1199 |
- # Create parameter |
|
1200 |
- my $param = {}; |
|
1201 |
- if (defined $id) { |
|
1202 |
- $id = [$id] unless ref $id; |
|
1203 |
- croak qq{"id" must be constant value or array reference} |
|
1204 |
- . " (" . (caller 1)[3] . ")" |
|
1205 |
- unless !ref $id || ref $id eq 'ARRAY'; |
|
1206 |
- croak qq{"id" must contain values same count as primary key} |
|
1207 |
- . " (" . (caller 1)[3] . ")" |
|
1208 |
- unless @$primary_keys eq @$id; |
|
1209 |
- for(my $i = 0; $i < @$primary_keys; $i ++) { |
|
1210 |
- $param->{$primary_keys->[$i]} = $id->[$i]; |
|
1211 |
- } |
|
1212 |
- } |
|
1213 |
- |
|
1214 |
- return $param; |
|
1215 |
-} |
|
1216 |
- |
|
1217 |
-sub _connect { |
|
1218 |
- my $self = shift; |
|
1219 |
- |
|
1220 |
- # Attributes |
|
1221 |
- my $dsn = $self->data_source; |
|
1222 |
- warn "data_source is DEPRECATED!\n" |
|
1223 |
- if $dsn; |
|
1224 |
- $dsn ||= $self->dsn; |
|
1225 |
- croak qq{"dsn" must be specified } . _subname |
|
1226 |
- unless $dsn; |
|
1227 |
- my $user = $self->user; |
|
1228 |
- my $password = $self->password; |
|
1229 |
- my $dbi_option = {%{$self->dbi_options}, %{$self->dbi_option}}; |
|
1230 |
- warn "dbi_options is DEPRECATED! use dbi_option instead\n" |
|
1231 |
- if keys %{$self->dbi_options}; |
|
1232 |
- |
|
1233 |
- # Connect |
|
1234 |
- my $dbh = eval {DBI->connect( |
|
1235 |
- $dsn, |
|
1236 |
- $user, |
|
1237 |
- $password, |
|
1238 |
- { |
|
1239 |
- %{$self->default_dbi_option}, |
|
1240 |
- %$dbi_option |
|
1241 |
- } |
|
1242 |
- )}; |
|
1243 |
- |
|
1244 |
- # Connect error |
|
1245 |
- croak "$@ " . _subname if $@; |
|
1246 |
- |
|
1247 |
- return $dbh; |
|
1248 |
-} |
|
1249 |
- |
|
1250 |
-sub _croak { |
|
1251 |
- my ($self, $error, $append) = @_; |
|
1252 |
- |
|
1253 |
- # Append |
|
1254 |
- $append ||= ""; |
|
1255 |
- |
|
1256 |
- # Verbose |
|
1257 |
- if ($Carp::Verbose) { croak $error } |
|
1258 |
- |
|
1259 |
- # Not verbose |
|
1260 |
- else { |
|
1261 |
- |
|
1262 |
- # Remove line and module infromation |
|
1263 |
- my $at_pos = rindex($error, ' at '); |
|
1264 |
- $error = substr($error, 0, $at_pos); |
|
1265 |
- $error =~ s/\s+$//; |
|
1266 |
- croak "$error$append"; |
|
1267 |
- } |
|
1268 |
-} |
|
1269 |
- |
|
1270 |
-sub _need_tables { |
|
1271 |
- my ($self, $tree, $need_tables, $tables) = @_; |
|
1272 |
- |
|
1273 |
- # Get needed tables |
|
1274 |
- foreach my $table (@$tables) { |
|
1275 |
- if ($tree->{$table}) { |
|
1276 |
- $need_tables->{$table} = 1; |
|
1277 |
- $self->_need_tables($tree, $need_tables, [$tree->{$table}{parent}]) |
|
1278 |
- } |
|
1279 |
- } |
|
1280 |
-} |
|
1281 |
- |
|
1282 |
-sub _push_join { |
|
1283 |
- my ($self, $sql, $join, $join_tables) = @_; |
|
1284 |
- |
|
1285 |
- # No join |
|
1286 |
- return unless @$join; |
|
1287 |
- |
|
1288 |
- # Push join clause |
|
1289 |
- my $tree = {}; |
|
1290 |
- for (my $i = 0; $i < @$join; $i++) { |
|
1291 |
- |
|
1292 |
- # Arrange |
|
1293 |
- my $join_clause;; |
|
1294 |
- my $option; |
|
1295 |
- if (ref $join->[$i] eq 'HASH') { |
|
1296 |
- $join_clause = $join->[$i]->{clause}; |
|
1297 |
- $option = {table => $join->[$i]->{table}}; |
|
1298 |
- } |
|
1299 |
- else { |
|
1300 |
- $join_clause = $join->[$i]; |
|
1301 |
- $option = {}; |
|
1302 |
- }; |
|
1303 |
- |
|
1304 |
- # Find tables in join clause |
|
1305 |
- my $table1; |
|
1306 |
- my $table2; |
|
1307 |
- if (my $table = $option->{table}) { |
|
1308 |
- $table1 = $table->[0]; |
|
1309 |
- $table2 = $table->[1]; |
|
1310 |
- } |
|
1311 |
- else { |
|
1312 |
- my $q = $self->_quote; |
|
1313 |
- my $j_clause = (split /\s+on\s+/, $join_clause)[-1]; |
|
1314 |
- $j_clause =~ s/'.+?'//g; |
|
1315 |
- my $q_re = quotemeta($q); |
|
1316 |
- $j_clause =~ s/[$q_re]//g; |
|
1317 |
- my $c = $self->safety_character; |
|
1318 |
- my $join_re = qr/(?:^|\s)($c+)\.$c+\s+=\s+($c+)\.$c+/; |
|
1319 |
- if ($j_clause =~ $join_re) { |
|
1320 |
- $table1 = $1; |
|
1321 |
- $table2 = $2; |
|
1322 |
- } |
|
1323 |
- } |
|
1324 |
- croak qq{join clause must have two table name after "on" keyword. } . |
|
1325 |
- qq{"$join_clause" is passed } . _subname |
|
1326 |
- unless defined $table1 && defined $table2; |
|
1327 |
- croak qq{right side table of "$join_clause" must be unique } |
|
1328 |
- . _subname |
|
1329 |
- if exists $tree->{$table2}; |
|
1330 |
- croak qq{Same table "$table1" is specified} . _subname |
|
1331 |
- if $table1 eq $table2; |
|
1332 |
- $tree->{$table2} |
|
1333 |
- = {position => $i, parent => $table1, join => $join_clause}; |
|
1334 |
- } |
|
1335 |
- |
|
1336 |
- # Search need tables |
|
1337 |
- my $need_tables = {}; |
|
1338 |
- $self->_need_tables($tree, $need_tables, $join_tables); |
|
1339 |
- my @need_tables = sort { $tree->{$a}{position} <=> $tree->{$b}{position} } keys %$need_tables; |
|
1340 |
- |
|
1341 |
- # Add join clause |
|
1342 |
- foreach my $need_table (@need_tables) { |
|
1343 |
- push @$sql, $tree->{$need_table}{join}; |
|
1344 |
- } |
|
1345 |
-} |
|
1346 |
- |
|
1347 |
-sub _quote { |
|
1348 |
- my $self = shift; |
|
1349 |
- |
|
1350 |
- return defined $self->reserved_word_quote ? $self->reserved_word_quote |
|
1351 |
- : defined $self->quote ? $self->quote |
|
1352 |
- : ''; |
|
1353 |
-} |
|
1354 |
- |
|
1355 |
-sub _q { |
|
1356 |
- my ($self, $value) = @_; |
|
1357 |
- |
|
1358 |
- my $quote = $self->_quote; |
|
1359 |
- my $q = substr($quote, 0, 1) || ''; |
|
1360 |
- my $p; |
|
1361 |
- if (defined $quote && length $quote > 1) { |
|
1362 |
- $p = substr($quote, 1, 1); |
|
1363 |
- } |
|
1364 |
- else { $p = $q } |
|
1365 |
- |
|
1366 |
- return "$q$value$p"; |
|
1367 |
-} |
|
1368 |
- |
|
1369 |
-sub _remove_duplicate_table { |
|
1370 |
- my ($self, $tables, $main_table) = @_; |
|
1371 |
- |
|
1372 |
- # Remove duplicate table |
|
1373 |
- my %tables = map {defined $_ ? ($_ => 1) : ()} @$tables; |
|
1374 |
- delete $tables{$main_table} if $main_table; |
|
1375 |
- |
|
1376 |
- my $new_tables = [keys %tables, $main_table ? $main_table : ()]; |
|
1377 |
- if (my $q = $self->_quote) { |
|
1378 |
- $q = quotemeta($q); |
|
1379 |
- $_ =~ s/[$q]//g for @$new_tables; |
|
1380 |
- } |
|
1381 |
- |
|
1382 |
- return $new_tables; |
|
1383 |
-} |
|
1384 |
- |
|
1385 |
-sub _search_tables { |
|
1386 |
- my ($self, $source) = @_; |
|
1387 |
- |
|
1388 |
- # Search tables |
|
1389 |
- my $tables = []; |
|
1390 |
- my $safety_character = $self->safety_character; |
|
1391 |
- my $q = $self->_quote; |
|
1392 |
- my $q_re = quotemeta($q); |
|
1393 |
- my $quoted_safety_character_re = $self->_q("?([$safety_character]+)"); |
|
1394 |
- my $table_re = $q ? qr/(?:^|[^$safety_character])$quoted_safety_character_re?\./ |
|
1395 |
- : qr/(?:^|[^$safety_character])([$safety_character]+)\./; |
|
1396 |
- while ($source =~ /$table_re/g) { |
|
1397 |
- push @$tables, $1; |
|
1398 |
- } |
|
1399 |
- |
|
1400 |
- return $tables; |
|
1401 |
-} |
|
1402 |
- |
|
1403 |
-sub _where_to_obj { |
|
1404 |
- my ($self, $where) = @_; |
|
1405 |
- |
|
1406 |
- my $obj; |
|
1407 |
- |
|
1408 |
- # Hash |
|
1409 |
- if (ref $where eq 'HASH') { |
|
1410 |
- my $clause = ['and']; |
|
1411 |
- my $q = $self->_quote; |
|
1412 |
- foreach my $column (keys %$where) { |
|
1413 |
- my $column_quote = $self->_q($column); |
|
1414 |
- $column_quote =~ s/\./$self->_q(".")/e; |
|
1415 |
- push @$clause, "$column_quote = :$column" for keys %$where; |
|
1416 |
- } |
|
1417 |
- $obj = $self->where(clause => $clause, param => $where); |
|
1418 |
- } |
|
1419 |
- |
|
1420 |
- # DBIx::Custom::Where object |
|
1421 |
- elsif (ref $where eq 'DBIx::Custom::Where') { |
|
1422 |
- $obj = $where; |
|
1423 |
- } |
|
1424 |
- |
|
1425 |
- # Array |
|
1426 |
- elsif (ref $where eq 'ARRAY') { |
|
1427 |
- $obj = $self->where( |
|
1428 |
- clause => $where->[0], |
|
1429 |
- param => $where->[1] |
|
1430 |
- ); |
|
1431 |
- } |
|
1432 |
- |
|
1433 |
- # Check where argument |
|
1434 |
- croak qq{"where" must be hash reference or DBIx::Custom::Where object} |
|
1435 |
- . qq{or array reference, which contains where clause and parameter} |
|
1436 |
- . _subname |
|
1437 |
- unless ref $obj eq 'DBIx::Custom::Where'; |
|
1438 |
- |
|
1439 |
- return $obj; |
|
1440 |
-} |
|
1441 |
- |
|
1442 |
-sub _apply_filter { |
|
1443 |
- my ($self, $table, @cinfos) = @_; |
|
1444 |
- |
|
1445 |
- # Initialize filters |
|
1446 |
- $self->{filter} ||= {}; |
|
1447 |
- $self->{filter}{on} = 1; |
|
1448 |
- $self->{filter}{out} ||= {}; |
|
1449 |
- $self->{filter}{in} ||= {}; |
|
1450 |
- $self->{filter}{end} ||= {}; |
|
1451 |
- |
|
1452 |
- # Usage |
|
1453 |
- my $usage = "Usage: \$dbi->apply_filter(" . |
|
1454 |
- "TABLE, COLUMN1, {in => INFILTER1, out => OUTFILTER1, end => ENDFILTER1}, " . |
|
1455 |
- "COLUMN2, {in => INFILTER2, out => OUTFILTER2, end => ENDFILTER2}, ...)"; |
|
1456 |
- |
|
1457 |
- # Apply filter |
|
1458 |
- for (my $i = 0; $i < @cinfos; $i += 2) { |
|
1459 |
- |
|
1460 |
- # Column |
|
1461 |
- my $column = $cinfos[$i]; |
|
1462 |
- if (ref $column eq 'ARRAY') { |
|
1463 |
- foreach my $c (@$column) { |
|
1464 |
- push @cinfos, $c, $cinfos[$i + 1]; |
|
1465 |
- } |
|
1466 |
- next; |
|
1467 |
- } |
|
1468 |
- |
|
1469 |
- # Filter infomation |
|
1470 |
- my $finfo = $cinfos[$i + 1] || {}; |
|
1471 |
- croak "$usage (table: $table) " . _subname |
|
1472 |
- unless ref $finfo eq 'HASH'; |
|
1473 |
- foreach my $ftype (keys %$finfo) { |
|
1474 |
- croak "$usage (table: $table) " . _subname |
|
1475 |
- unless $ftype eq 'in' || $ftype eq 'out' || $ftype eq 'end'; |
|
1476 |
- } |
|
1477 |
- |
|
1478 |
- # Set filters |
|
1479 |
- foreach my $way (qw/in out end/) { |
|
1480 |
- |
|
1481 |
- # Filter |
|
1482 |
- my $filter = $finfo->{$way}; |
|
1483 |
- |
|
1484 |
- # Filter state |
|
1485 |
- my $state = !exists $finfo->{$way} ? 'not_exists' |
|
1486 |
- : !defined $filter ? 'not_defined' |
|
1487 |
- : ref $filter eq 'CODE' ? 'code' |
|
1488 |
- : 'name'; |
|
1489 |
- |
|
1490 |
- # Filter is not exists |
|
1491 |
- next if $state eq 'not_exists'; |
|
1492 |
- |
|
1493 |
- # Check filter name |
|
1494 |
- croak qq{Filter "$filter" is not registered } . _subname |
|
1495 |
- if $state eq 'name' |
|
1496 |
- && ! exists $self->filters->{$filter}; |
|
1497 |
- |
|
1498 |
- # Set filter |
|
1499 |
- my $f = $state eq 'not_defined' ? undef |
|
1500 |
- : $state eq 'code' ? $filter |
|
1501 |
- : $self->filters->{$filter}; |
|
1502 |
- $self->{filter}{$way}{$table}{$column} = $f; |
|
1503 |
- $self->{filter}{$way}{$table}{"$table.$column"} = $f; |
|
1504 |
- $self->{filter}{$way}{$table}{"${table}__$column"} = $f; |
|
1505 |
- $self->{filter}{$way}{$table}{"${table}-$column"} = $f; |
|
1506 |
- } |
|
1507 |
- } |
|
1508 |
- |
|
1509 |
- return $self; |
|
1510 |
-} |
|
1511 |
- |
|
1512 |
-# DEPRECATED! |
|
1513 |
-sub create_query { |
|
1514 |
- warn "create_query is DEPRECATED! use query option of each method"; |
|
1515 |
- shift->_create_query(@_); |
|
1516 |
-} |
|
1517 |
- |
|
1518 |
-# DEPRECATED! |
|
1519 |
-sub apply_filter { |
|
1520 |
- my $self = shift; |
|
1521 |
- |
|
1522 |
- warn "apply_filter is DEPRECATED!"; |
|
1523 |
- return $self->_apply_filter(@_); |
|
1524 |
-} |
|
1525 |
- |
|
1526 |
-# DEPRECATED! |
|
1527 |
-our %SELECT_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1528 |
-sub select_at { |
|
1529 |
- my ($self, %args) = @_; |
|
1530 |
- |
|
1531 |
- warn "select_at is DEPRECATED! use update and id option instead"; |
|
1532 |
- |
|
1533 |
- # Arguments |
|
1534 |
- my $primary_keys = delete $args{primary_key}; |
|
1535 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1536 |
- my $where = delete $args{where}; |
|
1537 |
- my $param = delete $args{param}; |
|
1538 |
- |
|
1539 |
- # Check arguments |
|
1540 |
- foreach my $name (keys %args) { |
|
1541 |
- croak qq{"$name" is wrong option } . _subname |
|
1542 |
- unless $SELECT_AT_ARGS{$name}; |
|
1543 |
- } |
|
1544 |
- |
|
1545 |
- # Table |
|
1546 |
- croak qq{"table" option must be specified } . _subname |
|
1547 |
- unless $args{table}; |
|
1548 |
- my $table = ref $args{table} ? $args{table}->[-1] : $args{table}; |
|
1549 |
- |
|
1550 |
- # Create where parameter |
|
1551 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1552 |
- |
|
1553 |
- return $self->select(where => $where_param, %args); |
|
1554 |
-} |
|
1555 |
- |
|
1556 |
-# DEPRECATED! |
|
1557 |
-our %DELETE_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1558 |
-sub delete_at { |
|
1559 |
- my ($self, %args) = @_; |
|
1560 |
- |
|
1561 |
- warn "delete_at is DEPRECATED! use update and id option instead"; |
|
1562 |
- |
|
1563 |
- # Arguments |
|
1564 |
- my $primary_keys = delete $args{primary_key}; |
|
1565 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1566 |
- my $where = delete $args{where}; |
|
1567 |
- |
|
1568 |
- # Check arguments |
|
1569 |
- foreach my $name (keys %args) { |
|
1570 |
- croak qq{"$name" is wrong option } . _subname |
|
1571 |
- unless $DELETE_AT_ARGS{$name}; |
|
1572 |
- } |
|
1573 |
- |
|
1574 |
- # Create where parameter |
|
1575 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1576 |
- |
|
1577 |
- return $self->delete(where => $where_param, %args); |
|
1578 |
-} |
|
1579 |
- |
|
1580 |
-# DEPRECATED! |
|
1581 |
-our %UPDATE_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1582 |
-sub update_at { |
|
1583 |
- my $self = shift; |
|
1584 |
- |
|
1585 |
- warn "update_at is DEPRECATED! use update and id option instead"; |
|
1586 |
- |
|
1587 |
- # Arguments |
|
1588 |
- my $param; |
|
1589 |
- $param = shift if @_ % 2; |
|
1590 |
- my %args = @_; |
|
1591 |
- my $primary_keys = delete $args{primary_key}; |
|
1592 |
- $primary_keys = [$primary_keys] unless ref $primary_keys; |
|
1593 |
- my $where = delete $args{where}; |
|
1594 |
- my $p = delete $args{param} || {}; |
|
1595 |
- $param ||= $p; |
|
1596 |
- |
|
1597 |
- # Check arguments |
|
1598 |
- foreach my $name (keys %args) { |
|
1599 |
- croak qq{"$name" is wrong option } . _subname |
|
1600 |
- unless $UPDATE_AT_ARGS{$name}; |
|
1601 |
- } |
|
1602 |
- |
|
1603 |
- # Create where parameter |
|
1604 |
- my $where_param = $self->_create_param_from_id($where, $primary_keys); |
|
1605 |
- |
|
1606 |
- return $self->update(where => $where_param, param => $param, %args); |
|
1607 |
-} |
|
1608 |
- |
|
1609 |
-# DEPRECATED! |
|
1610 |
-our %INSERT_AT_ARGS = (%VALID_ARGS, where => 1, primary_key => 1); |
|
1611 |
-sub insert_at { |
|
1612 |
- my $self = shift; |
|
1613 |
- |
|
1614 |
- warn "insert_at is DEPRECATED! use insert and id option instead"; |
|
1615 |
- |
|
1616 |
- # Arguments |
|
1617 |
- my $param; |
|
1618 |
- $param = shift if @_ % 2; |
|
1619 |
- my %args = @_; |
|
1620 |
- my $primary_key = delete $args{primary_key}; |
|
1621 |
- $primary_key = [$primary_key] unless ref $primary_key; |
|
1622 |
- my $where = delete $args{where}; |
|
1623 |
- my $p = delete $args{param} || {}; |
|
1624 |
- $param ||= $p; |
|
1625 |
- |
|
1626 |
- # Check arguments |
|
1627 |
- foreach my $name (keys %args) { |
|
1628 |
- croak qq{"$name" is wrong option } . _subname |
|
1629 |
- unless $INSERT_AT_ARGS{$name}; |
|
1630 |
- } |
|
1631 |
- |
|
1632 |
- # Create where parameter |
|
1633 |
- my $where_param = $self->_create_param_from_id($where, $primary_key); |
|
1634 |
- $param = $self->merge_param($where_param, $param); |
|
1635 |
- |
|
1636 |
- return $self->insert(param => $param, %args); |
|
1637 |
-} |
|
1638 |
- |
|
1639 |
-# DEPRECATED! |
|
1640 |
-sub register_tag { |
|
1641 |
- warn "register_tag is DEPRECATED!"; |
|
1642 |
- shift->query_builder->register_tag(@_) |
|
1643 |
-} |
|
1644 |
- |
|
1645 |
-# DEPRECATED! |
|
1646 |
-has 'data_source'; |
|
1647 |
-has dbi_options => sub { {} }; |
|
1648 |
-has filter_check => 1; |
|
1649 |
-has 'reserved_word_quote'; |
|
1650 |
- |
|
1651 |
-# DEPRECATED! |
|
1652 |
-sub default_bind_filter { |
|
1653 |
- my $self = shift; |
|
1654 |
- |
|
1655 |
- warn "default_bind_filter is DEPRECATED!"; |
|
1656 |
- |
|
1657 |
- if (@_) { |
|
1658 |
- my $fname = $_[0]; |
|
1659 |
- |
|
1660 |
- if (@_ && !$fname) { |
|
1661 |
- $self->{default_out_filter} = undef; |
|
1662 |
- } |
|
1663 |
- else { |
|
1664 |
- croak qq{Filter "$fname" is not registered} |
|
1665 |
- unless exists $self->filters->{$fname}; |
|
1666 |
- |
|
1667 |
- $self->{default_out_filter} = $self->filters->{$fname}; |
|
1668 |
- } |
|
1669 |
- return $self; |
|
1670 |
- } |
|
1671 |
- |
|
1672 |
- return $self->{default_out_filter}; |
|
1673 |
-} |
|
1674 |
- |
|
1675 |
-# DEPRECATED! |
|
1676 |
-sub default_fetch_filter { |
|
1677 |
- my $self = shift; |
|
1678 |
- |
|
1679 |
- warn "default_fetch_filter is DEPRECATED!"; |
|
1680 |
- |
|
1681 |
- if (@_) { |
|
1682 |
- my $fname = $_[0]; |
|
1683 |
- |
|
1684 |
- if (@_ && !$fname) { |
|
1685 |
- $self->{default_in_filter} = undef; |
|
1686 |
- } |
|
1687 |
- else { |
|
1688 |
- croak qq{Filter "$fname" is not registered} |
|
1689 |
- unless exists $self->filters->{$fname}; |
|
1690 |
- |
|
1691 |
- $self->{default_in_filter} = $self->filters->{$fname}; |
|
1692 |
- } |
|
1693 |
- |
|
1694 |
- return $self; |
|
1695 |
- } |
|
1696 |
- |
|
1697 |
- return $self->{default_in_filter}; |
|
1698 |
-} |
|
1699 |
- |
|
1700 |
-# DEPRECATED! |
|
1701 |
-sub insert_param_tag { |
|
1702 |
- warn "insert_param_tag is DEPRECATED! " . |
|
1703 |
- "use insert_param instead!"; |
|
1704 |
- return shift->insert_param(@_); |
|
1705 |
-} |
|
1706 |
- |
|
1707 |
-# DEPRECATED! |
|
1708 |
-sub register_tag_processor { |
|
1709 |
- warn "register_tag_processor is DEPRECATED!"; |
|
1710 |
- return shift->query_builder->register_tag_processor(@_); |
|
1711 |
-} |
|
1712 |
- |
|
1713 |
-# DEPRECATED! |
|
1714 |
-sub update_param_tag { |
|
1715 |
- warn "update_param_tag is DEPRECATED! " . |
|
1716 |
- "use update_param instead"; |
|
1717 |
- return shift->update_param(@_); |
|
1718 |
-} |
|
1719 |
-# DEPRECATED! |
|
1720 |
-sub _push_relation { |
|
1721 |
- my ($self, $sql, $tables, $relation, $need_where) = @_; |
|
1722 |
- |
|
1723 |
- if (keys %{$relation || {}}) { |
|
1724 |
- push @$sql, $need_where ? 'where' : 'and'; |
|
1725 |
- foreach my $rcolumn (keys %$relation) { |
|
1726 |
- my $table1 = (split (/\./, $rcolumn))[0]; |
|
1727 |
- my $table2 = (split (/\./, $relation->{$rcolumn}))[0]; |
|
1728 |
- push @$tables, ($table1, $table2); |
|
1729 |
- push @$sql, ("$rcolumn = " . $relation->{$rcolumn}, 'and'); |
|
1730 |
- } |
|
1731 |
- } |
|
1732 |
- pop @$sql if $sql->[-1] eq 'and'; |
|
1733 |
-} |
|
1734 |
- |
|
1735 |
-# DEPRECATED! |
|
1736 |
-sub _add_relation_table { |
|
1737 |
- my ($self, $tables, $relation) = @_; |
|
1738 |
- |
|
1739 |
- if (keys %{$relation || {}}) { |
|
1740 |
- foreach my $rcolumn (keys %$relation) { |
|
1741 |
- my $table1 = (split (/\./, $rcolumn))[0]; |
|
1742 |
- my $table2 = (split (/\./, $relation->{$rcolumn}))[0]; |
|
1743 |
- my $table1_exists; |
|
1744 |
- my $table2_exists; |
|
1745 |
- foreach my $table (@$tables) { |
|
1746 |
- $table1_exists = 1 if $table eq $table1; |
|
1747 |
- $table2_exists = 1 if $table eq $table2; |
|
1748 |
- } |
|
1749 |
- unshift @$tables, $table1 unless $table1_exists; |
|
1750 |
- unshift @$tables, $table2 unless $table2_exists; |
|
1751 |
- } |
|
1752 |
- } |
|
1753 |
-} |
|
1754 |
- |
|
1755 |
-1; |
|
1756 |
- |
|
1757 |
-=head1 NAME |
|
1758 |
- |
|
1759 |
-DBIx::Custom - Execute insert, update, delete, and select statement easily |
|
1760 |
- |
|
1761 |
-=head1 SYNOPSYS |
|
1762 |
- |
|
1763 |
- use DBIx::Custom; |
|
1764 |
- |
|
1765 |
- # Connect |
|
1766 |
- my $dbi = DBIx::Custom->connect( |
|
1767 |
- dsn => "dbi:mysql:database=dbname", |
|
1768 |
- user => 'ken', |
|
1769 |
- password => '!LFKD%$&', |
|
1770 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
1771 |
- ); |
|
1772 |
- |
|
1773 |
- # Insert |
|
1774 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
1775 |
- |
|
1776 |
- # Update |
|
1777 |
- $dbi->update({title => 'Perl', author => 'Ken'}, table => 'book', |
|
1778 |
- where => {id => 5}); |
|
1779 |
- |
|
1780 |
- # Delete |
|
1781 |
- $dbi->delete(table => 'book', where => {author => 'Ken'}); |
|
1782 |
- |
|
1783 |
- # Select |
|
1784 |
- my $result = $dbi->select(table => 'book', |
|
1785 |
- column => ['title', 'author'], where => {author => 'Ken'}); |
|
1786 |
- |
|
1787 |
- # Select, more complex |
|
1788 |
- my $result = $dbi->select( |
|
1789 |
- table => 'book', |
|
1790 |
- column => [ |
|
1791 |
- {book => [qw/title author/]}, |
|
1792 |
- {company => ['name']} |
|
1793 |
- ], |
|
1794 |
- where => {'book.author' => 'Ken'}, |
|
1795 |
- join => ['left outer join company on book.company_id = company.id'], |
|
1796 |
- append => 'order by id limit 5' |
|
1797 |
- ); |
|
1798 |
- |
|
1799 |
- # Fetch |
|
1800 |
- while (my $row = $result->fetch) { |
|
1801 |
- |
|
1802 |
- } |
|
1803 |
- |
|
1804 |
- # Fetch as hash |
|
1805 |
- while (my $row = $result->fetch_hash) { |
|
1806 |
- |
|
1807 |
- } |
|
1808 |
- |
|
1809 |
- # Execute SQL with parameter. |
|
1810 |
- $dbi->execute( |
|
1811 |
- "select id from book where author = :author and title like :title", |
|
1812 |
- {author => 'ken', title => '%Perl%'} |
|
1813 |
- ); |
|
1814 |
- |
|
1815 |
-=head1 DESCRIPTIONS |
|
1816 |
- |
|
1817 |
-L<DBIx::Custom> is L<DBI> wrapper module to execute SQL easily. |
|
1818 |
-This module have the following features. |
|
1819 |
- |
|
1820 |
-=over 4 |
|
1821 |
- |
|
1822 |
-=item * |
|
1823 |
- |
|
1824 |
-Execute C<insert>, C<update>, C<delete>, or C<select> statement easily |
|
1825 |
- |
|
1826 |
-=item * |
|
1827 |
- |
|
1828 |
-Create C<where> clause flexibly |
|
1829 |
- |
|
1830 |
-=item * |
|
1831 |
- |
|
1832 |
-Named place holder support |
|
1833 |
- |
|
1834 |
-=item * |
|
1835 |
- |
|
1836 |
-Model support |
|
1837 |
- |
|
1838 |
-=item * |
|
1839 |
- |
|
1840 |
-Connection manager support |
|
1841 |
- |
|
1842 |
-=item * |
|
1843 |
- |
|
1844 |
-Choice your favorite relational database management system, |
|
1845 |
-C<MySQL>, C<SQLite>, C<PostgreSQL>, C<Oracle>, |
|
1846 |
-C<Microsoft SQL Server>, C<Microsoft Access>, C<DB2> or anything, |
|
1847 |
- |
|
1848 |
-=item * |
|
1849 |
- |
|
1850 |
-Filtering by data type or column name(EXPERIMENTAL) |
|
1851 |
- |
|
1852 |
-=item * |
|
1853 |
- |
|
1854 |
-Create C<order by> clause flexibly(EXPERIMENTAL) |
|
1855 |
- |
|
1856 |
-=back |
|
1857 |
- |
|
1858 |
-=head1 DOCUMENTATIONS |
|
1859 |
- |
|
1860 |
-L<DBIx::Custom::Guide> - How to use L<DBIx::Custom> |
|
1861 |
- |
|
1862 |
-L<DBIx::Custom Wiki|https://github.com/yuki-kimoto/DBIx-Custom/wiki> |
|
1863 |
-- Theare are various examples. |
|
1864 |
- |
|
1865 |
-Module documentations - |
|
1866 |
-L<DBIx::Custom::Result>, |
|
1867 |
-L<DBIx::Custom::Query>, |
|
1868 |
-L<DBIx::Custom::Where>, |
|
1869 |
-L<DBIx::Custom::Model>, |
|
1870 |
-L<DBIx::Custom::Order> |
|
1871 |
- |
|
1872 |
-=head1 ATTRIBUTES |
|
1873 |
- |
|
1874 |
-=head2 C<connector> |
|
1875 |
- |
|
1876 |
- my $connector = $dbi->connector; |
|
1877 |
- $dbi = $dbi->connector($connector); |
|
1878 |
- |
|
1879 |
-Connection manager object. if C<connector> is set, you can get C<dbh> |
|
1880 |
-through connection manager. Conection manager object must have C<dbh> mehtod. |
|
1881 |
- |
|
1882 |
-This is L<DBIx::Connector> example. Please pass |
|
1883 |
-C<default_dbi_option> to L<DBIx::Connector> C<new> method. |
|
1884 |
- |
|
1885 |
- my $connector = DBIx::Connector->new( |
|
1886 |
- "dbi:mysql:database=$DATABASE", |
|
1887 |
- $USER, |
|
1888 |
- $PASSWORD, |
|
1889 |
- DBIx::Custom->new->default_dbi_option |
|
1890 |
- ); |
|
1891 |
- |
|
1892 |
- my $dbi = DBIx::Custom->connect(connector => $connector); |
|
1893 |
- |
|
1894 |
-=head2 C<dsn> |
|
1895 |
- |
|
1896 |
- my $dsn = $dbi->dsn; |
|
1897 |
- $dbi = $dbi->dsn("DBI:mysql:database=dbname"); |
|
1898 |
- |
|
1899 |
-Data source name, used when C<connect> method is executed. |
|
1900 |
- |
|
1901 |
-=head2 C<dbi_option> |
|
1902 |
- |
|
1903 |
- my $dbi_option = $dbi->dbi_option; |
|
1904 |
- $dbi = $dbi->dbi_option($dbi_option); |
|
1905 |
- |
|
1906 |
-L<DBI> option, used when C<connect> method is executed. |
|
1907 |
-Each value in option override the value of C<default_dbi_option>. |
|
1908 |
- |
|
1909 |
-=head2 C<default_dbi_option> |
|
1910 |
- |
|
1911 |
- my $default_dbi_option = $dbi->default_dbi_option; |
|
1912 |
- $dbi = $dbi->default_dbi_option($default_dbi_option); |
|
1913 |
- |
|
1914 |
-L<DBI> default option, used when C<connect> method is executed, |
|
1915 |
-default to the following values. |
|
1916 |
- |
|
1917 |
- { |
|
1918 |
- RaiseError => 1, |
|
1919 |
- PrintError => 0, |
|
1920 |
- AutoCommit => 1, |
|
1921 |
- } |
|
1922 |
- |
|
1923 |
-=head2 C<filters> |
|
1924 |
- |
|
1925 |
- my $filters = $dbi->filters; |
|
1926 |
- $dbi = $dbi->filters(\%filters); |
|
1927 |
- |
|
1928 |
-Filters, registered by C<register_filter> method. |
|
1929 |
- |
|
1930 |
-=head2 C<last_sql> |
|
1931 |
- |
|
1932 |
- my $last_sql = $dbi->last_sql; |
|
1933 |
- $dbi = $dbi->last_sql($last_sql); |
|
1934 |
- |
|
1935 |
-Get last successed SQL executed by C<execute> method. |
|
1936 |
- |
|
1937 |
-=head2 C<models> |
|
1938 |
- |
|
1939 |
- my $models = $dbi->models; |
|
1940 |
- $dbi = $dbi->models(\%models); |
|
1941 |
- |
|
1942 |
-Models, included by C<include_model> method. |
|
1943 |
- |
|
1944 |
-=head2 C<password> |
|
1945 |
- |
|
1946 |
- my $password = $dbi->password; |
|
1947 |
- $dbi = $dbi->password('lkj&le`@s'); |
|
1948 |
- |
|
1949 |
-Password, used when C<connect> method is executed. |
|
1950 |
- |
|
1951 |
-=head2 C<query_builder> |
|
1952 |
- |
|
1953 |
- my $sql_class = $dbi->query_builder; |
|
1954 |
- $dbi = $dbi->query_builder(DBIx::Custom::QueryBuilder->new); |
|
1955 |
- |
|
1956 |
-Query builder, default to L<DBIx::Custom::QueryBuilder> object. |
|
1957 |
- |
|
1958 |
-=head2 C<quote> |
|
1959 |
- |
|
1960 |
- my quote = $dbi->quote; |
|
1961 |
- $dbi = $dbi->quote('"'); |
|
1962 |
- |
|
1963 |
-Reserved word quote. |
|
1964 |
-Default to double quote '"' except for mysql. |
|
1965 |
-In mysql, default to back quote '`' |
|
1966 |
- |
|
1967 |
-You can set quote pair. |
|
1968 |
- |
|
1969 |
- $dbi->quote('[]'); |
|
1970 |
- |
|
1971 |
-=head2 C<result_class> |
|
1972 |
- |
|
1973 |
- my $result_class = $dbi->result_class; |
|
1974 |
- $dbi = $dbi->result_class('DBIx::Custom::Result'); |
|
1975 |
- |
|
1976 |
-Result class, default to L<DBIx::Custom::Result>. |
|
1977 |
- |
|
1978 |
-=head2 C<safety_character> |
|
1979 |
- |
|
1980 |
- my $safety_character = $self->safety_character; |
|
1981 |
- $dbi = $self->safety_character($character); |
|
1982 |
- |
|
1983 |
-Regex of safety character for table and column name, default to '\w'. |
|
1984 |
-Note that you don't have to specify like '[\w]'. |
|
1985 |
- |
|
1986 |
-=head2 C<tag_parse> |
|
1987 |
- |
|
1988 |
- my $tag_parse = $dbi->tag_parse(0); |
|
1989 |
- $dbi = $dbi->tag_parse; |
|
1990 |
- |
|
1991 |
-Enable DEPRECATED tag parsing functionality, default to 1. |
|
1992 |
-If you want to disable tag parsing functionality, set to 0. |
|
1993 |
- |
|
1994 |
-=head2 C<user> |
|
1995 |
- |
|
1996 |
- my $user = $dbi->user; |
|
1997 |
- $dbi = $dbi->user('Ken'); |
|
1998 |
- |
|
1999 |
-User name, used when C<connect> method is executed. |
|
2000 |
- |
|
2001 |
-=head1 METHODS |
|
2002 |
- |
|
2003 |
-L<DBIx::Custom> inherits all methods from L<Object::Simple> |
|
2004 |
-and use all methods of L<DBI> |
|
2005 |
-and implements the following new ones. |
|
2006 |
- |
|
2007 |
-=head2 C<available_data_type> EXPERIMENTAL |
|
2008 |
- |
|
2009 |
- print $dbi->available_data_type; |
|
2010 |
- |
|
2011 |
-Get available data types. You can use these data types |
|
2012 |
-in C<type rule>'s C<from1> and C<from2> section. |
|
2013 |
- |
|
2014 |
-=head2 C<available_type_name> EXPERIMENTAL |
|
2015 |
- |
|
2016 |
- print $dbi->available_type_name; |
|
2017 |
- |
|
2018 |
-Get available type names. You can use these type names in |
|
2019 |
-C<type_rule>'s C<into1> and C<into2> section. |
|
2020 |
- |
|
2021 |
-=head2 C<assign_param> EXPERIMENTAL |
|
2022 |
- |
|
2023 |
- my $assign_param = $dbi->assign_param({title => 'a', age => 2}); |
|
2024 |
- |
|
2025 |
-Create assign parameter. |
|
2026 |
- |
|
2027 |
- title = :title, author = :author |
|
2028 |
- |
|
2029 |
-This is equal to C<update_param> exept that set is not added. |
|
2030 |
- |
|
2031 |
-=head2 C<column> |
|
2032 |
- |
|
2033 |
- my $column = $dbi->column(book => ['author', 'title']); |
|
2034 |
- |
|
2035 |
-Create column clause. The follwoing column clause is created. |
|
2036 |
- |
|
2037 |
- book.author as "book.author", |
|
2038 |
- book.title as "book.title" |
|
2039 |
- |
|
2040 |
-You can change separator by C<separator> method. |
|
2041 |
- |
|
2042 |
- # Separator is double underbar |
|
2043 |
- $dbi->separator('__'); |
|
2044 |
- |
|
2045 |
- book.author as "book__author", |
|
2046 |
- book.title as "book__title" |
|
2047 |
- |
|
2048 |
- # Separator is hyphen |
|
2049 |
- $dbi->separator('-'); |
|
2050 |
- |
|
2051 |
- book.author as "book-author", |
|
2052 |
- book.title as "book-title" |
|
2053 |
- |
|
2054 |
-=head2 C<connect> |
|
2055 |
- |
|
2056 |
- my $dbi = DBIx::Custom->connect( |
|
2057 |
- dsn => "dbi:mysql:database=dbname", |
|
2058 |
- user => 'ken', |
|
2059 |
- password => '!LFKD%$&', |
|
2060 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
2061 |
- ); |
|
2062 |
- |
|
2063 |
-Connect to the database and create a new L<DBIx::Custom> object. |
|
2064 |
- |
|
2065 |
-L<DBIx::Custom> is a wrapper of L<DBI>. |
|
2066 |
-C<AutoCommit> and C<RaiseError> options are true, |
|
2067 |
-and C<PrintError> option is false by default. |
|
2068 |
- |
|
2069 |
-=head2 create_model |
|
2070 |
- |
|
2071 |
- my $model = $dbi->create_model( |
|
2072 |
- table => 'book', |
|
2073 |
- primary_key => 'id', |
|
2074 |
- join => [ |
|
2075 |
- 'inner join company on book.comparny_id = company.id' |
|
2076 |
- ], |
|
2077 |
- ); |
|
2078 |
- |
|
2079 |
-Create L<DBIx::Custom::Model> object and initialize model. |
|
2080 |
-the module is also used from C<model> method. |
|
2081 |
- |
|
2082 |
- $dbi->model('book')->select(...); |
|
2083 |
- |
|
2084 |
-=head2 C<dbh> |
|
2085 |
- |
|
2086 |
- my $dbh = $dbi->dbh; |
|
2087 |
- |
|
2088 |
-Get L<DBI> database handle. if C<connector> is set, you can get |
|
2089 |
-database handle through C<connector> object. |
|
2090 |
- |
|
2091 |
-=head2 C<each_column> |
|
2092 |
- |
|
2093 |
- $dbi->each_column( |
|
2094 |
- sub { |
|
2095 |
- my ($dbi, $table, $column, $column_info) = @_; |
|
2096 |
- |
|
2097 |
- my $type = $column_info->{TYPE_NAME}; |
|
2098 |
- |
|
2099 |
- if ($type eq 'DATE') { |
|
2100 |
- # ... |
|
2101 |
- } |
|
2102 |
- } |
|
2103 |
- ); |
|
2104 |
- |
|
2105 |
-Iterate all column informations of all table from database. |
|
2106 |
-Argument is callback when one column is found. |
|
2107 |
-Callback receive four arguments, dbi object, table name, |
|
2108 |
-column name and column information. |
|
2109 |
- |
|
2110 |
-=head2 C<each_table> |
|
2111 |
- |
|
2112 |
- $dbi->each_table( |
|
2113 |
- sub { |
|
2114 |
- my ($dbi, $table, $table_info) = @_; |
|
2115 |
- |
|
2116 |
- my $table_name = $table_info->{TABLE_NAME}; |
|
2117 |
- } |
|
2118 |
- ); |
|
2119 |
- |
|
2120 |
-Iterate all table informationsfrom database. |
|
2121 |
-Argument is callback when one table is found. |
|
2122 |
-Callback receive three arguments, dbi object, table name, |
|
2123 |
-table information. |
|
2124 |
- |
|
2125 |
-=head2 C<execute> |
|
2126 |
- |
|
2127 |
- my $result = $dbi->execute( |
|
2128 |
- "select * from book where title = :title and author like :author", |
|
2129 |
- {title => 'Perl', author => '%Ken%'} |
|
2130 |
- ); |
|
2131 |
- |
|
2132 |
- my $result = $dbi->execute( |
|
2133 |
- "select * from book where title = :book.title and author like :book.author", |
|
2134 |
- {'book.title' => 'Perl', 'book.author' => '%Ken%'} |
|
2135 |
- ); |
|
2136 |
- |
|
2137 |
-Execute SQL. SQL can contain column parameter such as :author and :title. |
|
2138 |
-You can append table name to column name such as :book.title and :book.author. |
|
2139 |
-Second argunet is data, embedded into column parameter. |
|
2140 |
-Return value is L<DBIx::Custom::Result> object when select statement is executed, |
|
2141 |
-or the count of affected rows when insert, update, delete statement is executed. |
|
2142 |
- |
|
2143 |
-Named placeholder such as C<:title> is replaced by placeholder C<?>. |
|
2144 |
- |
|
2145 |
- # Original |
|
2146 |
- select * from book where title = :title and author like :author |
|
2147 |
- |
|
2148 |
- # Replaced |
|
2149 |
- select * from where title = ? and author like ?; |
|
2150 |
- |
|
2151 |
-You can specify operator with named placeholder |
|
2152 |
- by C<name{operator}> syntax. |
|
2153 |
- |
|
2154 |
- # Original |
|
2155 |
- select * from book where :title{=} and :author{like} |
|
2156 |
- |
|
2157 |
- # Replaced |
|
2158 |
- select * from where title = ? and author like ?; |
|
2159 |
- |
|
2160 |
-Note that colons in time format such as 12:13:15 is exeption, |
|
2161 |
-it is not parsed as named placeholder. |
|
2162 |
-If you want to use colon generally, you must escape it by C<\\> |
|
2163 |
- |
|
2164 |
- select * from where title = "aa\\:bb"; |
|
2165 |
- |
|
2166 |
-The following opitons are available. |
|
2167 |
- |
|
2168 |
-=over 4 |
|
2169 |
- |
|
2170 |
-=item C<filter> |
|
2171 |
- |
|
2172 |
- filter => { |
|
2173 |
- title => sub { uc $_[0] } |
|
2174 |
- author => sub { uc $_[0] } |
|
2175 |
- } |
|
2176 |
- |
|
2177 |
- # Filter name |
|
2178 |
- filter => { |
|
2179 |
- title => 'upper_case', |
|
2180 |
- author => 'upper_case' |
|
2181 |
- } |
|
2182 |
- |
|
2183 |
- # At once |
|
2184 |
- filter => [ |
|
2185 |
- [qw/title author/] => sub { uc $_[0] } |
|
2186 |
- ] |
|
2187 |
- |
|
2188 |
-Filter. You can set subroutine or filter name |
|
2189 |
-registered by by C<register_filter>. |
|
2190 |
-This filter is executed before data is saved into database. |
|
2191 |
-and before type rule filter is executed. |
|
2192 |
- |
|
2193 |
-=item C<query> |
|
2194 |
- |
|
2195 |
- query => 1 |
|
2196 |
- |
|
2197 |
-C<execute> method return L<DBIx::Custom::Query> object, not executing SQL. |
|
2198 |
-You can check SQL or get statment handle. |
|
2199 |
- |
|
2200 |
- my $sql = $query->sql; |
|
2201 |
- my $sth = $query->sth; |
|
2202 |
- my $columns = $query->columns; |
|
2203 |
- |
|
2204 |
-If you want to execute SQL fast, you can do the following way. |
|
2205 |
- |
|
2206 |
- my $query; |
|
2207 |
- foreach my $row (@$rows) { |
|
2208 |
- $query ||= $dbi->insert($row, table => 'table1', query => 1); |
|
2209 |
- $dbi->execute($query, $row, filter => {ab => sub { $_[0] * 2 }}); |
|
2210 |
- } |
|
2211 |
- |
|
2212 |
-Statement handle is reused and SQL parsing is finished, |
|
2213 |
-so you can get more performance than normal way. |
|
2214 |
- |
|
2215 |
-If you want to execute SQL as possible as fast and don't need filtering. |
|
2216 |
-You can do the following way. |
|
2217 |
- |
|
2218 |
- my $query; |
|
2219 |
- my $sth; |
|
2220 |
- foreach my $row (@$rows) { |
|
2221 |
- $query ||= $dbi->insert($row, table => 'book', query => 1); |
|
2222 |
- $sth ||= $query->sth; |
|
2223 |
- $sth->execute(map { $row->{$_} } sort keys %$row); |
|
2224 |
- } |
|
2225 |
- |
|
2226 |
-Note that $row must be simple hash reference, such as |
|
2227 |
-{title => 'Perl', author => 'Ken'}. |
|
2228 |
-and don't forget to sort $row values by $row key asc order. |
|
2229 |
- |
|
2230 |
-=item C<table> |
|
2231 |
- |
|
2232 |
- table => 'author' |
|
2233 |
- |
|
2234 |
-If you want to omit table name in column name |
|
2235 |
-and enable C<into1> and C<into2> type filter, |
|
2236 |
-You must set C<table> option. |
|
2237 |
- |
|
2238 |
- $dbi->execute("select * from book where title = :title and author = :author", |
|
2239 |
- {title => 'Perl', author => 'Ken', table => 'book'); |
|
2240 |
- |
|
2241 |
- # Same |
|
2242 |
- $dbi->execute( |
|
2243 |
- "select * from book where title = :book.title and author = :book.author", |
|
2244 |
- {title => 'Perl', author => 'Ken'); |
|
2245 |
- |
|
2246 |
-=item C<bind_type> |
|
2247 |
- |
|
2248 |
-Specify database bind data type. |
|
2249 |
- |
|
2250 |
- bind_type => [image => DBI::SQL_BLOB] |
|
2251 |
- bind_type => [[qw/image audio/] => DBI::SQL_BLOB] |
|
2252 |
- |
|
2253 |
-This is used to bind parameter by C<bind_param> of statment handle. |
|
2254 |
- |
|
2255 |
- $sth->bind_param($pos, $value, DBI::SQL_BLOB); |
|
2256 |
- |
|
2257 |
-=item C<table_alias> EXPERIMENTAL |
|
2258 |
- |
|
2259 |
- table_alias => {user => 'hiker'} |
|
2260 |
- |
|
2261 |
-Table alias. Key is real table name, value is alias table name. |
|
2262 |
-If you set C<table_alias>, you can enable C<into1> and C<into2> type rule |
|
2263 |
-on alias table name. |
|
2264 |
- |
|
2265 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2266 |
- |
|
2267 |
- type_rule_off => 1 |
|
2268 |
- |
|
2269 |
-Turn C<into1> and C<into2> type rule off. |
|
2270 |
- |
|
2271 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2272 |
- |
|
2273 |
- type_rule1_off => 1 |
|
2274 |
- |
|
2275 |
-Turn C<into1> type rule off. |
|
2276 |
- |
|
2277 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2278 |
- |
|
2279 |
- type_rule2_off => 1 |
|
2280 |
- |
|
2281 |
-Turn C<into2> type rule off. |
|
2282 |
- |
|
2283 |
-=back |
|
2284 |
- |
|
2285 |
-=head2 C<delete> |
|
2286 |
- |
|
2287 |
- $dbi->delete(table => 'book', where => {title => 'Perl'}); |
|
2288 |
- |
|
2289 |
-Execute delete statement. |
|
2290 |
- |
|
2291 |
-The following opitons are available. |
|
2292 |
- |
|
2293 |
-=over 4 |
|
2294 |
- |
|
2295 |
-=item C<append> |
|
2296 |
- |
|
2297 |
-Same as C<select> method's C<append> option. |
|
2298 |
- |
|
2299 |
-=item C<filter> |
|
2300 |
- |
|
2301 |
-Same as C<execute> method's C<filter> option. |
|
2302 |
- |
|
2303 |
-=item C<id> |
|
2304 |
- |
|
2305 |
- id => 4 |
|
2306 |
- id => [4, 5] |
|
2307 |
- |
|
2308 |
-ID corresponding to C<primary_key>. |
|
2309 |
-You can delete rows by C<id> and C<primary_key>. |
|
2310 |
- |
|
2311 |
- $dbi->delete( |
|
2312 |
- parimary_key => ['id1', 'id2'], |
|
2313 |
- id => [4, 5], |
|
2314 |
- table => 'book', |
|
2315 |
- ); |
|
2316 |
- |
|
2317 |
-The above is same as the followin one. |
|
2318 |
- |
|
2319 |
- $dbi->delete(where => {id1 => 4, id2 => 5}, table => 'book'); |
|
2320 |
- |
|
2321 |
-=item C<prefix> |
|
2322 |
- |
|
2323 |
- prefix => 'some' |
|
2324 |
- |
|
2325 |
-prefix before table name section. |
|
2326 |
- |
|
2327 |
- delete some from book |
|
2328 |
- |
|
2329 |
-=item C<query> |
|
2330 |
- |
|
2331 |
-Same as C<execute> method's C<query> option. |
|
2332 |
- |
|
2333 |
-=item C<table> |
|
2334 |
- |
|
2335 |
- table => 'book' |
|
2336 |
- |
|
2337 |
-Table name. |
|
2338 |
- |
|
2339 |
-=item C<where> |
|
2340 |
- |
|
2341 |
-Same as C<select> method's C<where> option. |
|
2342 |
- |
|
2343 |
-=item C<primary_key> |
|
2344 |
- |
|
2345 |
-See C<id> option. |
|
2346 |
- |
|
2347 |
-=item C<bind_type> |
|
2348 |
- |
|
2349 |
-Same as C<execute> method's C<bind_type> option. |
|
2350 |
- |
|
2351 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2352 |
- |
|
2353 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2354 |
- |
|
2355 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2356 |
- |
|
2357 |
- type_rule1_off => 1 |
|
2358 |
- |
|
2359 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2360 |
- |
|
2361 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2362 |
- |
|
2363 |
- type_rule2_off => 1 |
|
2364 |
- |
|
2365 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2366 |
- |
|
2367 |
-=back |
|
2368 |
- |
|
2369 |
-=head2 C<delete_all> |
|
2370 |
- |
|
2371 |
- $dbi->delete_all(table => $table); |
|
2372 |
- |
|
2373 |
-Execute delete statement for all rows. |
|
2374 |
-Options is same as C<delete>. |
|
2375 |
- |
|
2376 |
-=head2 C<insert> |
|
2377 |
- |
|
2378 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
2379 |
- |
|
2380 |
-Execute insert statement. First argument is row data. Return value is |
|
2381 |
-affected row count. |
|
2382 |
- |
|
2383 |
-If you want to set constant value to row data, use scalar reference |
|
2384 |
-as parameter value. |
|
2385 |
- |
|
2386 |
- {date => \"NOW()"} |
|
2387 |
- |
|
2388 |
-The following opitons are available. |
|
2389 |
- |
|
2390 |
-=over 4 |
|
2391 |
- |
|
2392 |
-=item C<append> |
|
2393 |
- |
|
2394 |
-Same as C<select> method's C<append> option. |
|
2395 |
- |
|
2396 |
-=item C<filter> |
|
2397 |
- |
|
2398 |
-Same as C<execute> method's C<filter> option. |
|
2399 |
- |
|
2400 |
-=item C<id> |
|
2401 |
- |
|
2402 |
- id => 4 |
|
2403 |
- id => [4, 5] |
|
2404 |
- |
|
2405 |
-ID corresponding to C<primary_key>. |
|
2406 |
-You can insert a row by C<id> and C<primary_key>. |
|
2407 |
- |
|
2408 |
- $dbi->insert( |
|
2409 |
- {title => 'Perl', author => 'Ken'} |
|
2410 |
- parimary_key => ['id1', 'id2'], |
|
2411 |
- id => [4, 5], |
|
2412 |
- table => 'book' |
|
2413 |
- ); |
|
2414 |
- |
|
2415 |
-The above is same as the followin one. |
|
2416 |
- |
|
2417 |
- $dbi->insert( |
|
2418 |
- {id1 => 4, id2 => 5, title => 'Perl', author => 'Ken'}, |
|
2419 |
- table => 'book' |
|
2420 |
- ); |
|
2421 |
- |
|
2422 |
-=item C<prefix> |
|
2423 |
- |
|
2424 |
- prefix => 'or replace' |
|
2425 |
- |
|
2426 |
-prefix before table name section |
|
2427 |
- |
|
2428 |
- insert or replace into book |
|
2429 |
- |
|
2430 |
-=item C<primary_key> |
|
2431 |
- |
|
2432 |
- primary_key => 'id' |
|
2433 |
- primary_key => ['id1', 'id2'] |
|
2434 |
- |
|
2435 |
-Primary key. This is used by C<id> option. |
|
2436 |
- |
|
2437 |
-=item C<query> |
|
2438 |
- |
|
2439 |
-Same as C<execute> method's C<query> option. |
|
2440 |
- |
|
2441 |
-=item C<table> |
|
2442 |
- |
|
2443 |
- table => 'book' |
|
2444 |
- |
|
2445 |
-Table name. |
|
2446 |
- |
|
2447 |
-=item C<bind_type> |
|
2448 |
- |
|
2449 |
-Same as C<execute> method's C<bind_type> option. |
|
2450 |
- |
|
2451 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2452 |
- |
|
2453 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2454 |
- |
|
2455 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2456 |
- |
|
2457 |
- type_rule1_off => 1 |
|
2458 |
- |
|
2459 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2460 |
- |
|
2461 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2462 |
- |
|
2463 |
- type_rule2_off => 1 |
|
2464 |
- |
|
2465 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2466 |
- |
|
2467 |
-=back |
|
2468 |
- |
|
2469 |
-=over 4 |
|
2470 |
- |
|
2471 |
-=head2 C<insert_param> |
|
2472 |
- |
|
2473 |
- my $insert_param = $dbi->insert_param({title => 'a', age => 2}); |
|
2474 |
- |
|
2475 |
-Create insert parameters. |
|
2476 |
- |
|
2477 |
- (title, author) values (title = :title, age = :age); |
|
2478 |
- |
|
2479 |
-=head2 C<include_model> |
|
2480 |
- |
|
2481 |
- $dbi->include_model('MyModel'); |
|
2482 |
- |
|
2483 |
-Include models from specified namespace, |
|
2484 |
-the following layout is needed to include models. |
|
2485 |
- |
|
2486 |
- lib / MyModel.pm |
|
2487 |
- / MyModel / book.pm |
|
2488 |
- / company.pm |
|
2489 |
- |
|
2490 |
-Name space module, extending L<DBIx::Custom::Model>. |
|
2491 |
- |
|
2492 |
-B<MyModel.pm> |
|
2493 |
- |
|
2494 |
- package MyModel; |
|
2495 |
- use DBIx::Custom::Model -base; |
|
2496 |
- |
|
2497 |
- 1; |
|
2498 |
- |
|
2499 |
-Model modules, extending name space module. |
|
2500 |
- |
|
2501 |
-B<MyModel/book.pm> |
|
2502 |
- |
|
2503 |
- package MyModel::book; |
|
2504 |
- use MyModel -base; |
|
2505 |
- |
|
2506 |
- 1; |
|
2507 |
- |
|
2508 |
-B<MyModel/company.pm> |
|
2509 |
- |
|
2510 |
- package MyModel::company; |
|
2511 |
- use MyModel -base; |
|
2512 |
- |
|
2513 |
- 1; |
|
2514 |
- |
|
2515 |
-MyModel::book and MyModel::company is included by C<include_model>. |
|
2516 |
- |
|
2517 |
-You can get model object by C<model>. |
|
2518 |
- |
|
2519 |
- my $book_model = $dbi->model('book'); |
|
2520 |
- my $company_model = $dbi->model('company'); |
|
2521 |
- |
|
2522 |
-See L<DBIx::Custom::Model> to know model features. |
|
2523 |
- |
|
2524 |
-=head2 C<map_param> EXPERIMENTAL |
|
2525 |
- |
|
2526 |
- my $map_param = $dbi->map_param( |
|
2527 |
- {id => 1, authro => 'Ken', price => 1900}, |
|
2528 |
- 'id' => 'book.id', |
|
2529 |
- 'author' => ['book.author' => sub { '%' . $_[0] . '%' }], |
|
2530 |
- 'price' => [ |
|
2531 |
- 'book.price', {if => sub { length $_[0] }} |
|
2532 |
- ] |
|
2533 |
- ); |
|
2534 |
- |
|
2535 |
-Map paramters to other key and value. First argument is original |
|
2536 |
-parameter. this is hash reference. Rest argument is mapping. |
|
2537 |
-By default, Mapping is done if the value length is not zero. |
|
2538 |
- |
|
2539 |
-=over 4 |
|
2540 |
- |
|
2541 |
-=item Key mapping |
|
2542 |
- |
|
2543 |
- 'id' => 'book.id' |
|
2544 |
- |
|
2545 |
-This is only key mapping. Value is same as original one. |
|
2546 |
- |
|
2547 |
- (id => 1) is mapped to ('book.id' => 1) if value length is not zero. |
|
2548 |
- |
|
2549 |
-=item Key and value mapping |
|
2550 |
- |
|
2551 |
- 'author' => ['book.author' => sub { '%' . $_[0] . '%' }] |
|
2552 |
- |
|
2553 |
-This is key and value mapping. Frist element of array reference |
|
2554 |
-is mapped key name, second element is code reference to map the value. |
|
2555 |
- |
|
2556 |
- (author => 'Ken') is mapped to ('book.author' => '%Ken%') |
|
2557 |
- if value length is not zero. |
|
2558 |
- |
|
2559 |
-=item Condition |
|
2560 |
- |
|
2561 |
- 'price' => ['book.price', {if => 'exists'}] |
|
2562 |
- 'price' => ['book.price', sub { '%' . $_[0] . '%' }, {if => 'exists'}] |
|
2563 |
- 'price' => ['book.price', {if => sub { defined shift }}] |
|
2564 |
- |
|
2565 |
-If you need condition, you can sepecify it. this is code reference |
|
2566 |
-or 'exists'. By default, condition is the following one. |
|
2567 |
- |
|
2568 |
- sub { defined $_[0] && length $_[0] } |
|
2569 |
- |
|
2570 |
-=back |
|
2571 |
- |
|
2572 |
-=head2 C<merge_param> |
|
2573 |
- |
|
2574 |
- my $param = $dbi->merge_param({key1 => 1}, {key1 => 1, key2 => 2}); |
|
2575 |
- |
|
2576 |
-Merge parameters. |
|
2577 |
- |
|
2578 |
- {key1 => [1, 1], key2 => 2} |
|
2579 |
- |
|
2580 |
-=head2 C<method> |
|
2581 |
- |
|
2582 |
- $dbi->method( |
|
2583 |
- update_or_insert => sub { |
|
2584 |
- my $self = shift; |
|
2585 |
- |
|
2586 |
- # Process |
|
2587 |
- }, |
|
2588 |
- find_or_create => sub { |
|
2589 |
- my $self = shift; |
|
2590 |
- |
|
2591 |
- # Process |
|
2592 |
- } |
|
2593 |
- ); |
|
2594 |
- |
|
2595 |
-Register method. These method is called directly from L<DBIx::Custom> object. |
|
2596 |
- |
|
2597 |
- $dbi->update_or_insert; |
|
2598 |
- $dbi->find_or_create; |
|
2599 |
- |
|
2600 |
-=head2 C<model> |
|
2601 |
- |
|
2602 |
- my $model = $dbi->model('book'); |
|
2603 |
- |
|
2604 |
-Get a L<DBIx::Custom::Model> object, |
|
2605 |
- |
|
2606 |
-=head2 C<mycolumn> |
|
2607 |
- |
|
2608 |
- my $column = $self->mycolumn(book => ['author', 'title']); |
|
2609 |
- |
|
2610 |
-Create column clause for myself. The follwoing column clause is created. |
|
2611 |
- |
|
2612 |
- book.author as author, |
|
2613 |
- book.title as title |
|
2614 |
- |
|
2615 |
-=head2 C<new> |
|
2616 |
- |
|
2617 |
- my $dbi = DBIx::Custom->new( |
|
2618 |
- dsn => "dbi:mysql:database=dbname", |
|
2619 |
- user => 'ken', |
|
2620 |
- password => '!LFKD%$&', |
|
2621 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
2622 |
- ); |
|
2623 |
- |
|
2624 |
-Create a new L<DBIx::Custom> object. |
|
2625 |
- |
|
2626 |
-=head2 C<not_exists> |
|
2627 |
- |
|
2628 |
- my $not_exists = $dbi->not_exists; |
|
2629 |
- |
|
2630 |
-DBIx::Custom::NotExists object, indicating the column is not exists. |
|
2631 |
-This is used by C<clause> of L<DBIx::Custom::Where> . |
|
2632 |
- |
|
2633 |
-=head2 C<order> EXPERIMENTAL |
|
2634 |
- |
|
2635 |
- my $order = $dbi->order; |
|
2636 |
- |
|
2637 |
-Create a new L<DBIx::Custom::Order> object. |
|
2638 |
- |
|
2639 |
-=head2 C<register_filter> |
|
2640 |
- |
|
2641 |
- $dbi->register_filter( |
|
2642 |
- # Time::Piece object to database DATE format |
|
2643 |
- tp_to_date => sub { |
|
2644 |
- my $tp = shift; |
|
2645 |
- return $tp->strftime('%Y-%m-%d'); |
|
2646 |
- }, |
|
2647 |
- # database DATE format to Time::Piece object |
|
2648 |
- date_to_tp => sub { |
|
2649 |
- my $date = shift; |
|
2650 |
- return Time::Piece->strptime($date, '%Y-%m-%d'); |
|
2651 |
- } |
|
2652 |
- ); |
|
2653 |
- |
|
2654 |
-Register filters, used by C<filter> option of many methods. |
|
2655 |
- |
|
2656 |
-=head2 C<type_rule> EXPERIMENTAL |
|
2657 |
- |
|
2658 |
- $dbi->type_rule( |
|
2659 |
- into1 => { |
|
2660 |
- date => sub { ... }, |
|
2661 |
- datetime => sub { ... } |
|
2662 |
- }, |
|
2663 |
- into2 => { |
|
2664 |
- date => sub { ... }, |
|
2665 |
- datetime => sub { ... } |
|
2666 |
- }, |
|
2667 |
- from1 => { |
|
2668 |
- # DATE |
|
2669 |
- 9 => sub { ... }, |
|
2670 |
- # DATETIME or TIMESTAMP |
|
2671 |
- 11 => sub { ... }, |
|
2672 |
- } |
|
2673 |
- from2 => { |
|
2674 |
- # DATE |
|
2675 |
- 9 => sub { ... }, |
|
2676 |
- # DATETIME or TIMESTAMP |
|
2677 |
- 11 => sub { ... }, |
|
2678 |
- } |
|
2679 |
- ); |
|
2680 |
- |
|
2681 |
-Filtering rule when data is send into and get from database. |
|
2682 |
-This has a little complex problem. |
|
2683 |
- |
|
2684 |
-In C<into1> and C<into2> you can specify |
|
2685 |
-type name as same as type name defined |
|
2686 |
-by create table, such as C<DATETIME> or C<DATE>. |
|
2687 |
- |
|
2688 |
-Note that type name and data type don't contain upper case. |
|
2689 |
-If these contain upper case charactor, you convert it to lower case. |
|
2690 |
- |
|
2691 |
-C<into2> is executed after C<into1>. |
|
2692 |
- |
|
2693 |
-Type rule of C<into1> and C<into2> is enabled on the following |
|
2694 |
-column name. |
|
2695 |
- |
|
2696 |
-=over 4 |
|
2697 |
- |
|
2698 |
-=item 1. column name |
|
2699 |
- |
|
2700 |
- issue_date |
|
2701 |
- issue_datetime |
|
2702 |
- |
|
2703 |
-This need C<table> option in each method. |
|
2704 |
- |
|
2705 |
-=item 2. table name and column name, separator is dot |
|
2706 |
- |
|
2707 |
- book.issue_date |
|
2708 |
- book.issue_datetime |
|
2709 |
- |
|
2710 |
-=back |
|
2711 |
- |
|
2712 |
-You get all type name used in database by C<available_type_name>. |
|
2713 |
- |
|
2714 |
- print $dbi->available_type_name; |
|
2715 |
- |
|
2716 |
-In C<from1> and C<from2> you specify data type, not type name. |
|
2717 |
-C<from2> is executed after C<from1>. |
|
2718 |
-You get all data type by C<available_data_type>. |
|
2719 |
- |
|
2720 |
- print $dbi->available_data_type; |
|
2721 |
- |
|
2722 |
-You can also specify multiple types at once. |
|
2723 |
- |
|
2724 |
- $dbi->type_rule( |
|
2725 |
- into1 => [ |
|
2726 |
- [qw/DATE DATETIME/] => sub { ... }, |
|
2727 |
- ], |
|
2728 |
- ); |
|
2729 |
- |
|
2730 |
-=head2 C<select> |
|
2731 |
- |
|
2732 |
- my $result = $dbi->select( |
|
2733 |
- table => 'book', |
|
2734 |
- column => ['author', 'title'], |
|
2735 |
- where => {author => 'Ken'}, |
|
2736 |
- ); |
|
2737 |
- |
|
2738 |
-Execute select statement. |
|
2739 |
- |
|
2740 |
-The following opitons are available. |
|
2741 |
- |
|
2742 |
-=over 4 |
|
2743 |
- |
|
2744 |
-=item C<append> |
|
2745 |
- |
|
2746 |
- append => 'order by title' |
|
2747 |
- |
|
2748 |
-Append statement to last of SQL. |
|
2749 |
- |
|
2750 |
-=item C<column> |
|
2751 |
- |
|
2752 |
- column => 'author' |
|
2753 |
- column => ['author', 'title'] |
|
2754 |
- |
|
2755 |
-Column clause. |
|
2756 |
- |
|
2757 |
-if C<column> is not specified, '*' is set. |
|
2758 |
- |
|
2759 |
- column => '*' |
|
2760 |
- |
|
2761 |
-You can specify hash of array reference. |
|
2762 |
- |
|
2763 |
- column => [ |
|
2764 |
- {book => [qw/author title/]}, |
|
2765 |
- {person => [qw/name age/]} |
|
2766 |
- ] |
|
2767 |
- |
|
2768 |
-This is expanded to the following one by using C<colomn> method. |
|
2769 |
- |
|
2770 |
- book.author as "book.author", |
|
2771 |
- book.title as "book.title", |
|
2772 |
- person.name as "person.name", |
|
2773 |
- person.age as "person.age" |
|
2774 |
- |
|
2775 |
-You can specify array of array reference, first argument is |
|
2776 |
-column name, second argument is alias. |
|
2777 |
- |
|
2778 |
- column => [ |
|
2779 |
- ['date(book.register_datetime)' => 'book.register_date'] |
|
2780 |
- ]; |
|
2781 |
- |
|
2782 |
-Alias is quoted properly and joined. |
|
2783 |
- |
|
2784 |
- date(book.register_datetime) as "book.register_date" |
|
2785 |
- |
|
2786 |
-=item C<filter> |
|
2787 |
- |
|
2788 |
-Same as C<execute> method's C<filter> option. |
|
2789 |
- |
|
2790 |
-=item C<id> |
|
2791 |
- |
|
2792 |
- id => 4 |
|
2793 |
- id => [4, 5] |
|
2794 |
- |
|
2795 |
-ID corresponding to C<primary_key>. |
|
2796 |
-You can select rows by C<id> and C<primary_key>. |
|
2797 |
- |
|
2798 |
- $dbi->select( |
|
2799 |
- parimary_key => ['id1', 'id2'], |
|
2800 |
- id => [4, 5], |
|
2801 |
- table => 'book' |
|
2802 |
- ); |
|
2803 |
- |
|
2804 |
-The above is same as the followin one. |
|
2805 |
- |
|
2806 |
- $dbi->select( |
|
2807 |
- where => {id1 => 4, id2 => 5}, |
|
2808 |
- table => 'book' |
|
2809 |
- ); |
|
2810 |
- |
|
2811 |
-=item C<param> EXPERIMETNAL |
|
2812 |
- |
|
2813 |
- param => {'table2.key3' => 5} |
|
2814 |
- |
|
2815 |
-Parameter shown before where clause. |
|
2816 |
- |
|
2817 |
-For example, if you want to contain tag in join clause, |
|
2818 |
-you can pass parameter by C<param> option. |
|
2819 |
- |
|
2820 |
- join => ['inner join (select * from table2 where table2.key3 = :table2.key3)' . |
|
2821 |
- ' as table2 on table1.key1 = table2.key1'] |
|
2822 |
- |
|
2823 |
-=itme C<prefix> |
|
2824 |
- |
|
2825 |
- prefix => 'SQL_CALC_FOUND_ROWS' |
|
2826 |
- |
|
2827 |
-Prefix of column cluase |
|
2828 |
- |
|
2829 |
- select SQL_CALC_FOUND_ROWS title, author from book; |
|
2830 |
- |
|
2831 |
-=item C<join> |
|
2832 |
- |
|
2833 |
- join => [ |
|
2834 |
- 'left outer join company on book.company_id = company_id', |
|
2835 |
- 'left outer join location on company.location_id = location.id' |
|
2836 |
- ] |
|
2837 |
- |
|
2838 |
-Join clause. If column cluase or where clause contain table name like "company.name", |
|
2839 |
-join clausees needed when SQL is created is used automatically. |
|
2840 |
- |
|
2841 |
- $dbi->select( |
|
2842 |
- table => 'book', |
|
2843 |
- column => ['company.location_id as location_id'], |
|
2844 |
- where => {'company.name' => 'Orange'}, |
|
2845 |
- join => [ |
|
2846 |
- 'left outer join company on book.company_id = company.id', |
|
2847 |
- 'left outer join location on company.location_id = location.id' |
|
2848 |
- ] |
|
2849 |
- ); |
|
2850 |
- |
|
2851 |
-In above select, column and where clause contain "company" table, |
|
2852 |
-the following SQL is created |
|
2853 |
- |
|
2854 |
- select company.location_id as location_id |
|
2855 |
- from book |
|
2856 |
- left outer join company on book.company_id = company.id |
|
2857 |
- where company.name = ?; |
|
2858 |
- |
|
2859 |
-You can specify two table by yourself. This is useful when join parser can't parse |
|
2860 |
-the join clause correctly. This is EXPERIMENTAL. |
|
2861 |
- |
|
2862 |
- $dbi->select( |
|
2863 |
- table => 'book', |
|
2864 |
- column => ['company.location_id as location_id'], |
|
2865 |
- where => {'company.name' => 'Orange'}, |
|
2866 |
- join => [ |
|
2867 |
- { |
|
2868 |
- clause => 'left outer join location on company.location_id = location.id', |
|
2869 |
- table => ['company', 'location'] |
|
2870 |
- } |
|
2871 |
- ] |
|
2872 |
- ); |
|
2873 |
- |
|
2874 |
-=item C<primary_key> |
|
2875 |
- |
|
2876 |
- primary_key => 'id' |
|
2877 |
- primary_key => ['id1', 'id2'] |
|
2878 |
- |
|
2879 |
-Primary key. This is used by C<id> option. |
|
2880 |
- |
|
2881 |
-=item C<query> |
|
2882 |
- |
|
2883 |
-Same as C<execute> method's C<query> option. |
|
2884 |
- |
|
2885 |
-=item C<bind_type> |
|
2886 |
- |
|
2887 |
-Same as C<execute> method's C<bind_type> option. |
|
2888 |
- |
|
2889 |
-=item C<table> |
|
2890 |
- |
|
2891 |
- table => 'book' |
|
2892 |
- |
|
2893 |
-Table name. |
|
2894 |
- |
|
2895 |
-=item C<type_rule_off> EXPERIMENTAL |
|
2896 |
- |
|
2897 |
-Same as C<execute> method's C<type_rule_off> option. |
|
2898 |
- |
|
2899 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
2900 |
- |
|
2901 |
- type_rule1_off => 1 |
|
2902 |
- |
|
2903 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
2904 |
- |
|
2905 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
2906 |
- |
|
2907 |
- type_rule2_off => 1 |
|
2908 |
- |
|
2909 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
2910 |
- |
|
2911 |
-=item C<where> |
|
2912 |
- |
|
2913 |
- # Hash refrence |
|
2914 |
- where => {author => 'Ken', 'title' => 'Perl'} |
|
2915 |
- |
|
2916 |
- # DBIx::Custom::Where object |
|
2917 |
- where => $dbi->where( |
|
2918 |
- clause => ['and', 'author = :author', 'title like :title'], |
|
2919 |
- param => {author => 'Ken', title => '%Perl%'} |
|
2920 |
- ); |
|
2921 |
- |
|
2922 |
- # Array reference 1 (array reference, hash referenc). same as above |
|
2923 |
- where => [ |
|
2924 |
- ['and', 'author = :author', 'title like :title'], |
|
2925 |
- {author => 'Ken', title => '%Perl%'} |
|
2926 |
- ]; |
|
2927 |
- |
|
2928 |
- # Array reference 2 (String, hash reference) |
|
2929 |
- where => [ |
|
2930 |
- 'title like :title', |
|
2931 |
- {title => '%Perl%'} |
|
2932 |
- ] |
|
2933 |
- |
|
2934 |
- # String |
|
2935 |
- where => 'title is null' |
|
2936 |
- |
|
2937 |
-Where clause. |
|
2938 |
- |
|
2939 |
-=item C<wrap> EXPERIMENTAL |
|
2940 |
- |
|
2941 |
-Wrap statement. This is array reference. |
|
2942 |
- |
|
2943 |
- $dbi->select(wrap => ['select * from (', ') as t where ROWNUM < 10']); |
|
2944 |
- |
|
2945 |
-This option is for Oracle and SQL Server paging process. |
|
2946 |
- |
|
2947 |
-=back |
|
2948 |
- |
|
2949 |
-=head2 C<update> |
|
2950 |
- |
|
2951 |
- $dbi->update({title => 'Perl'}, table => 'book', where => {id => 4}); |
|
2952 |
- |
|
2953 |
-Execute update statement. First argument is update row data. |
|
2954 |
- |
|
2955 |
-If you want to set constant value to row data, use scalar reference |
|
2956 |
-as parameter value. |
|
2957 |
- |
|
2958 |
- {date => \"NOW()"} |
|
2959 |
- |
|
2960 |
-The following opitons are available. |
|
2961 |
- |
|
2962 |
-=over 4 |
|
2963 |
- |
|
2964 |
-=item C<append> |
|
2965 |
- |
|
2966 |
-Same as C<select> method's C<append> option. |
|
2967 |
- |
|
2968 |
-=item C<filter> |
|
2969 |
- |
|
2970 |
-Same as C<execute> method's C<filter> option. |
|
2971 |
- |
|
2972 |
-=item C<id> |
|
2973 |
- |
|
2974 |
- id => 4 |
|
2975 |
- id => [4, 5] |
|
2976 |
- |
|
2977 |
-ID corresponding to C<primary_key>. |
|
2978 |
-You can update rows by C<id> and C<primary_key>. |
|
2979 |
- |
|
2980 |
- $dbi->update( |
|
2981 |
- {title => 'Perl', author => 'Ken'} |
|
2982 |
- parimary_key => ['id1', 'id2'], |
|
2983 |
- id => [4, 5], |
|
2984 |
- table => 'book' |
|
2985 |
- ); |
|
2986 |
- |
|
2987 |
-The above is same as the followin one. |
|
2988 |
- |
|
2989 |
- $dbi->update( |
|
2990 |
- {title => 'Perl', author => 'Ken'} |
|
2991 |
- where => {id1 => 4, id2 => 5}, |
|
2992 |
- table => 'book' |
|
2993 |
- ); |
|
2994 |
- |
|
2995 |
-=item C<prefix> |
|
2996 |
- |
|
2997 |
- prefix => 'or replace' |
|
2998 |
- |
|
2999 |
-prefix before table name section |
|
3000 |
- |
|
3001 |
- update or replace book |
|
3002 |
- |
|
3003 |
-=item C<primary_key> |
|
3004 |
- |
|
3005 |
- primary_key => 'id' |
|
3006 |
- primary_key => ['id1', 'id2'] |
|
3007 |
- |
|
3008 |
-Primary key. This is used by C<id> option. |
|
3009 |
- |
|
3010 |
-=item C<query> |
|
3011 |
- |
|
3012 |
-Same as C<execute> method's C<query> option. |
|
3013 |
- |
|
3014 |
-=item C<table> |
|
3015 |
- |
|
3016 |
- table => 'book' |
|
3017 |
- |
|
3018 |
-Table name. |
|
3019 |
- |
|
3020 |
-=item C<where> |
|
3021 |
- |
|
3022 |
-Same as C<select> method's C<where> option. |
|
3023 |
- |
|
3024 |
-=item C<bind_type> |
|
3025 |
- |
|
3026 |
-Same as C<execute> method's C<bind_type> option. |
|
3027 |
- |
|
3028 |
-=item C<type_rule_off> EXPERIMENTAL |
|
3029 |
- |
|
3030 |
-Same as C<execute> method's C<type_rule_off> option. |
|
3031 |
- |
|
3032 |
-=item C<type_rule1_off> EXPERIMENTAL |
|
3033 |
- |
|
3034 |
- type_rule1_off => 1 |
|
3035 |
- |
|
3036 |
-Same as C<execute> method's C<type_rule1_off> option. |
|
3037 |
- |
|
3038 |
-=item C<type_rule2_off> EXPERIMENTAL |
|
3039 |
- |
|
3040 |
- type_rule2_off => 1 |
|
3041 |
- |
|
3042 |
-Same as C<execute> method's C<type_rule2_off> option. |
|
3043 |
- |
|
3044 |
-=back |
|
3045 |
- |
|
3046 |
-=head2 C<update_all> |
|
3047 |
- |
|
3048 |
- $dbi->update_all({title => 'Perl'}, table => 'book', ); |
|
3049 |
- |
|
3050 |
-Execute update statement for all rows. |
|
3051 |
-Options is same as C<update> method. |
|
3052 |
- |
|
3053 |
-=head2 C<update_param> |
|
3054 |
- |
|
3055 |
- my $update_param = $dbi->update_param({title => 'a', age => 2}); |
|
3056 |
- |
|
3057 |
-Create update parameter tag. |
|
3058 |
- |
|
3059 |
- set title = :title, author = :author |
|
3060 |
- |
|
3061 |
-=head2 C<where> |
|
3062 |
- |
|
3063 |
- my $where = $dbi->where( |
|
3064 |
- clause => ['and', 'title = :title', 'author = :author'], |
|
3065 |
- param => {title => 'Perl', author => 'Ken'} |
|
3066 |
- ); |
|
3067 |
- |
|
3068 |
-Create a new L<DBIx::Custom::Where> object. |
|
3069 |
- |
|
3070 |
-=head2 C<setup_model> |
|
3071 |
- |
|
3072 |
- $dbi->setup_model; |
|
3073 |
- |
|
3074 |
-Setup all model objects. |
|
3075 |
-C<columns> of model object is automatically set, parsing database information. |
|
3076 |
- |
|
3077 |
-=head1 ENVIRONMENT VARIABLE |
|
3078 |
- |
|
3079 |
-=head2 C<DBIX_CUSTOM_DEBUG> |
|
3080 |
- |
|
3081 |
-If environment variable C<DBIX_CUSTOM_DEBUG> is set to true, |
|
3082 |
-executed SQL and bind values are printed to STDERR. |
|
3083 |
- |
|
3084 |
-=head2 C<DBIX_CUSTOM_DEBUG_ENCODING> |
|
3085 |
- |
|
3086 |
-DEBUG output encoding. Default to UTF-8. |
|
3087 |
- |
|
3088 |
-=head1 DEPRECATED FUNCTIONALITIES |
|
3089 |
- |
|
3090 |
-L<DBIx::Custom> |
|
3091 |
- |
|
3092 |
- # Attribute methods |
|
3093 |
- data_source # will be removed at 2017/1/1 |
|
3094 |
- dbi_options # will be removed at 2017/1/1 |
|
3095 |
- filter_check # will be removed at 2017/1/1 |
|
3096 |
- reserved_word_quote # will be removed at 2017/1/1 |
|
3097 |
- cache_method # will be removed at 2017/1/1 |
|
3098 |
- |
|
3099 |
- # Methods |
|
3100 |
- create_query # will be removed at 2017/1/1 |
|
3101 |
- apply_filter # will be removed at 2017/1/1 |
|
3102 |
- select_at # will be removed at 2017/1/1 |
|
3103 |
- delete_at # will be removed at 2017/1/1 |
|
3104 |
- update_at # will be removed at 2017/1/1 |
|
3105 |
- insert_at # will be removed at 2017/1/1 |
|
3106 |
- register_tag # will be removed at 2017/1/1 |
|
3107 |
- default_bind_filter # will be removed at 2017/1/1 |
|
3108 |
- default_fetch_filter # will be removed at 2017/1/1 |
|
3109 |
- insert_param_tag # will be removed at 2017/1/1 |
|
3110 |
- register_tag_processor # will be removed at 2017/1/1 |
|
3111 |
- update_param_tag # will be removed at 2017/1/1 |
|
3112 |
- |
|
3113 |
- # Options |
|
3114 |
- select method relation option # will be removed at 2017/1/1 |
|
3115 |
- select method param option # will be removed at 2017/1/1 |
|
3116 |
- select method column option [COLUMN, as => ALIAS] format |
|
3117 |
- # will be removed at 2017/1/1 |
|
3118 |
- |
|
3119 |
- # Others |
|
3120 |
- execute("select * from {= title}"); # execute method's |
|
3121 |
- # tag parsing functionality |
|
3122 |
- # will be removed at 2017/1/1 |
|
3123 |
- Query caching # will be removed at 2017/1/1 |
|
3124 |
- |
|
3125 |
-L<DBIx::Custom::Model> |
|
3126 |
- |
|
3127 |
- # Attribute methods |
|
3128 |
- filter # will be removed at 2017/1/1 |
|
3129 |
- name # will be removed at 2017/1/1 |
|
3130 |
- type # will be removed at 2017/1/1 |
|
3131 |
- |
|
3132 |
-L<DBIx::Custom::Query> |
|
3133 |
- |
|
3134 |
- # Attribute methods |
|
3135 |
- default_filter # will be removed at 2017/1/1 |
|
3136 |
- table # will be removed at 2017/1/1 |
|
3137 |
- filters # will be removed at 2017/1/1 |
|
3138 |
- |
|
3139 |
- # Methods |
|
3140 |
- filter # will be removed at 2017/1/1 |
|
3141 |
- |
|
3142 |
-L<DBIx::Custom::QueryBuilder> |
|
3143 |
- |
|
3144 |
- # Attribute methods |
|
3145 |
- tags # will be removed at 2017/1/1 |
|
3146 |
- tag_processors # will be removed at 2017/1/1 |
|
3147 |
- |
|
3148 |
- # Methods |
|
3149 |
- register_tag # will be removed at 2017/1/1 |
|
3150 |
- register_tag_processor # will be removed at 2017/1/1 |
|
3151 |
- |
|
3152 |
- # Others |
|
3153 |
- build_query("select * from {= title}"); # tag parsing functionality |
|
3154 |
- # will be removed at 2017/1/1 |
|
3155 |
- |
|
3156 |
-L<DBIx::Custom::Result> |
|
3157 |
- |
|
3158 |
- # Attribute methods |
|
3159 |
- filter_check # will be removed at 2017/1/1 |
|
3160 |
- |
|
3161 |
- # Methods |
|
3162 |
- end_filter # will be removed at 2017/1/1 |
|
3163 |
- remove_end_filter # will be removed at 2017/1/1 |
|
3164 |
- remove_filter # will be removed at 2017/1/1 |
|
3165 |
- default_filter # will be removed at 2017/1/1 |
|
3166 |
- |
|
3167 |
-L<DBIx::Custom::Tag> |
|
3168 |
- |
|
3169 |
- This module is DEPRECATED! # will be removed at 2017/1/1 |
|
3170 |
- |
|
3171 |
-=head1 BACKWORD COMPATIBLE POLICY |
|
3172 |
- |
|
3173 |
-If a functionality is DEPRECATED, you can know it by DEPRECATED warnings |
|
3174 |
-except for attribute method. |
|
3175 |
-You can check all DEPRECATED functionalities by document. |
|
3176 |
-DEPRECATED functionality is removed after five years, |
|
3177 |
-but if at least one person use the functionality and tell me that thing |
|
3178 |
-I extend one year each time he tell me it. |
|
3179 |
- |
|
3180 |
-EXPERIMENTAL functionality will be changed without warnings. |
|
3181 |
- |
|
3182 |
-This policy was changed at 2011/6/28 |
|
3183 |
- |
|
3184 |
-=head1 BUGS |
|
3185 |
- |
|
3186 |
-Please tell me bugs if found. |
|
3187 |
- |
|
3188 |
-C<< <kimoto.yuki at gmail.com> >> |
|
3189 |
- |
|
3190 |
-L<http://github.com/yuki-kimoto/DBIx-Custom> |
|
3191 |
- |
|
3192 |
-=head1 AUTHOR |
|
3193 |
- |
|
3194 |
-Yuki Kimoto, C<< <kimoto.yuki at gmail.com> >> |
|
3195 |
- |
|
3196 |
-=head1 COPYRIGHT & LICENSE |
|
3197 |
- |
|
3198 |
-Copyright 2009-2011 Yuki Kimoto, all rights reserved. |
|
3199 |
- |
|
3200 |
-This program is free software; you can redistribute it and/or modify it |
|
3201 |
-under the same terms as Perl itself. |
|
3202 |
- |
|
3203 |
-=cut |
... | ... |
@@ -1,603 +0,0 @@ |
1 |
-=encoding utf8 |
|
2 |
- |
|
3 |
-=head1 NAME |
|
4 |
- |
|
5 |
-DBIx::Custom::Guide - DBIx::Custom Guide |
|
6 |
- |
|
7 |
-=head1 FEATURES |
|
8 |
- |
|
9 |
-L<DBIx::Custom> is the wrapper class of L<DBI> to execute SQL easily. |
|
10 |
-This module have the following features. |
|
11 |
- |
|
12 |
-=over 4 |
|
13 |
- |
|
14 |
-=item * Execute INSERT, UPDATE, DELETE, SELECT statement easily |
|
15 |
- |
|
16 |
-=item * You can specify bind values by hash reference |
|
17 |
- |
|
18 |
-=item * Filtering by data type. and you can set filter to any column |
|
19 |
- |
|
20 |
-=item * Creating where clause and order by clause flexibly |
|
21 |
- |
|
22 |
-=item * Support model |
|
23 |
- |
|
24 |
-=back |
|
25 |
- |
|
26 |
-=head1 GUIDE |
|
27 |
- |
|
28 |
-=head2 Connect to database |
|
29 |
- |
|
30 |
- use DBIx::Custom; |
|
31 |
- my $dbi = DBIx::Custom->connect( |
|
32 |
- dsn => "dbi:mysql:database=bookshop", |
|
33 |
- user => 'ken', |
|
34 |
- password => '!LFKD%$&', |
|
35 |
- dbi_option => {mysql_enable_utf8 => 1} |
|
36 |
- ); |
|
37 |
- |
|
38 |
-You can connect to database by C<connect> method. |
|
39 |
-C<dsn> is data source name, C<user> is user name, C<password> is password. |
|
40 |
- |
|
41 |
-C<dbi_option> is L<DBI> option. |
|
42 |
-By default, the following option is set. |
|
43 |
-Exeption is thrown when fatal error occur and commit mode is auto commit. |
|
44 |
- |
|
45 |
- { |
|
46 |
- RaiseError => 1 |
|
47 |
- PrintError => 0 |
|
48 |
- AutoCommit => 1 |
|
49 |
- } |
|
50 |
- |
|
51 |
-=head2 Execute query |
|
52 |
- |
|
53 |
-=head3 Insert Statement : C<insert> |
|
54 |
- |
|
55 |
-If you want to execute insert statement, use C<insert> method. |
|
56 |
- |
|
57 |
- $dbi->insert({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
58 |
- |
|
59 |
-First argument is insert row data, C<table> is table name. |
|
60 |
- |
|
61 |
-=head3 Update Statement : C<update> |
|
62 |
- |
|
63 |
-If you want to execute update stateimuse, use C<update> method. |
|
64 |
- |
|
65 |
- $dbi->update( |
|
66 |
- {title => 'Perl', author => 'Ken'}, |
|
67 |
- table => 'book', |
|
68 |
- where => {id => 5} |
|
69 |
- ); |
|
70 |
- |
|
71 |
-First argument is update row data, C<table> is table name, C<where> is condition. |
|
72 |
- |
|
73 |
-Note that you can't execute C<update> method without C<where>. |
|
74 |
-If you want to update all rows, use update_all. |
|
75 |
- |
|
76 |
- $dbi->update_all({title => 'Perl', author => 'Ken'}, table => 'book'); |
|
77 |
- |
|
78 |
-=head3 Delete Statement : C<delete> |
|
79 |
- |
|
80 |
-If you want to execute delete statement, use C<delete> method. |
|
81 |
- |
|
82 |
- $dbi->delete(table => 'book', where => {author => 'Ken'}); |
|
83 |
- |
|
84 |
-C<table> is table name, C<where> is condition. |
|
85 |
- |
|
86 |
-Note that you can't execute C<delete> method without C<where>. |
|
87 |
-If you want to delete all rows, use C<delete_all> method. |
|
88 |
- |
|
89 |
- $dbi->delete_all(table => 'book'); |
|
90 |
- |
|
91 |
-=head3 Select Statement : C<select> |
|
92 |
- |
|
93 |
-If you want to execute select statement, use C<select> method. |
|
94 |
- |
|
95 |
- my $result = $dbi->select(table => 'book'); |
|
96 |
- |
|
97 |
-Return value is L<DBIx::Custom::Result> object. |
|
98 |
-You can fetch rows by C<fetch> method. |
|
99 |
- |
|
100 |
- while (my $row = $result->fetch) { |
|
101 |
- my $title = $row->[0]; |
|
102 |
- my $author = $row->[1]; |
|
103 |
- } |
|
104 |
- |
|
105 |
-See also L<Fetch row/"Fetch row"> about L<DBIx::Custom::Result>. |
|
106 |
- |
|
107 |
-You can specify column names by C<column> option |
|
108 |
-and condition by C<where> option. |
|
109 |
- |
|
110 |
- my $result = $dbi->select( |
|
111 |
- table => 'book', |
|
112 |
- column => ['author', 'title'], |
|
113 |
- where => {author => 'Ken'} |
|
114 |
- ); |
|
115 |
- |
|
116 |
-You can specify join clause by C<join> option. |
|
117 |
- |
|
118 |
- my $result = $dbi->select( |
|
119 |
- table => 'book', |
|
120 |
- column => ['company.name as company_name'] |
|
121 |
- where => {'book.name' => 'Perl'}, |
|
122 |
- join => ['left outer join company on book.company_id = company.id] |
|
123 |
- ); |
|
124 |
- |
|
125 |
-Note that join clause is joined only when C<where> or C<column> option contains table name, |
|
126 |
-such as book.name. |
|
127 |
- |
|
128 |
-You can append statement to the end of whole statement by C<append> option. |
|
129 |
- |
|
130 |
- my $result = $dbi->select( |
|
131 |
- table => 'book', |
|
132 |
- where => {author => 'Ken'}, |
|
133 |
- append => 'for update', |
|
134 |
- ); |
|
135 |
- |
|
136 |
-=head3 C<execute> |
|
137 |
- |
|
138 |
-If you want to execute SQL, use C<execute> method. |
|
139 |
- |
|
140 |
- $dbi->execute("select * from book;"); |
|
141 |
- |
|
142 |
-You can specify named placeholder. |
|
143 |
- |
|
144 |
- $dbi->execute( |
|
145 |
- "select * from book title = :title and author = :author;" |
|
146 |
- {title => 'Perl', author => 'Ken'} |
|
147 |
- ); |
|
148 |
- |
|
149 |
-:title and :author is named placeholder, which is replaced to placeholers. |
|
150 |
- |
|
151 |
- select * from book title = ? and author = ?; |
|
152 |
- |
|
153 |
-=head3 C<dbh> |
|
154 |
- |
|
155 |
- my $dbh = $dbi->dbh; |
|
156 |
- |
|
157 |
-Get get database handle object of L<DBI>. |
|
158 |
- |
|
159 |
-=head3 C<DBI> methods |
|
160 |
- |
|
161 |
- $dbi->do(...); |
|
162 |
- $dbi->begin_work; |
|
163 |
- |
|
164 |
-You can call all methods of L<DBI> from L<DBIx::Custom> object. |
|
165 |
- |
|
166 |
-=head2 Fetch Rows |
|
167 |
- |
|
168 |
-C<select> method return value is L<DBIx::Custom::Result> object. |
|
169 |
-You can fetch a row or rows by various methods. |
|
170 |
- |
|
171 |
-=head3 Fetch a row (array) : C<fetch> |
|
172 |
- |
|
173 |
- my $row = $result->fetch; |
|
174 |
- |
|
175 |
-C<fetch> method fetch a row and put it into array reference. |
|
176 |
-You can continue to fetch |
|
177 |
- |
|
178 |
- while (my $row = $result->fetch) { |
|
179 |
- my $title = $row->[0]; |
|
180 |
- my $author = $row->[1]; |
|
181 |
- } |
|
182 |
- |
|
183 |
-=head3 Fetch only first row (array) : C<fetch_first> |
|
184 |
- |
|
185 |
- my $row = $result->fetch_first; |
|
186 |
- |
|
187 |
-C<fetch_first> fetch a only first row and finish statment handle, |
|
188 |
-and put it into array refrence. |
|
189 |
- |
|
190 |
-=head3 Fetch all rows (array) : C<fetch_all> |
|
191 |
- |
|
192 |
- my $rows = $result->fetch_all; |
|
193 |
- |
|
194 |
-C<fetch_all> fetch all rows and put them into array of array reference. |
|
195 |
- |
|
196 |
-=head3 Fetch a row (hash) : C<fetch_hash> |
|
197 |
- |
|
198 |
- my $row = $result->fetch_hash; |
|
199 |
- |
|
200 |
-C<fetch_hash> fetch a row and put it into hash reference. |
|
201 |
-You can fetch a row while row exists. |
|
202 |
- |
|
203 |
- while (my $row = $result->fetch_hash) { |
|
204 |
- my $title = $row->{title}; |
|
205 |
- my $author = $row->{author}; |
|
206 |
- } |
|
207 |
- |
|
208 |
-=head3 Fetch only a first row (hash) : C<fetch_hash_first> |
|
209 |
- |
|
210 |
- my $row = $result->fetch_hash_first; |
|
211 |
- |
|
212 |
-C<fetch_hash_first> fetch only a first row and finish statement handle, |
|
213 |
-and put them into hash refrence. |
|
214 |
- |
|
215 |
-C<one> is C<fetch_hash_first> synonym to save word typing. |
|
216 |
- |
|
217 |
- my $row = $result->one; |
|
218 |
- |
|
219 |
-=head3 Fetch all rows (hash) : C<fetch_hash_all> |
|
220 |
- |
|
221 |
- my $rows = $result->fetch_hash_all; |
|
222 |
- |
|
223 |
-C<fetch_hash_all> fetch all rows and put them into array of hash reference. |
|
224 |
- |
|
225 |
-=head3 Statement Handle : C<sth> |
|
226 |
- |
|
227 |
- my $sth = $result->sth; |
|
228 |
- |
|
229 |
-If you want to get statment handle, use <sth> method. |
|
230 |
- |
|
231 |
-=head2 Named placeholder |
|
232 |
- |
|
233 |
-=head3 Basic of Parameter |
|
234 |
- |
|
235 |
-You can embedd named placeholder into SQL. |
|
236 |
- |
|
237 |
- select * from book where title = :title and author like :author; |
|
238 |
- |
|
239 |
-:title and :author is named placeholder |
|
240 |
- |
|
241 |
-Named placeholder is replaced by place holder. |
|
242 |
- |
|
243 |
- select * from book where title = ? and author like ?; |
|
244 |
- |
|
245 |
-use C<execute> to execute SQL. |
|
246 |
- |
|
247 |
- my $sql = "select * from book where title = :title and author like :author;" |
|
248 |
- $dbi->execute($sql, {title => 'Perl', author => '%Ken%'}); |
|
249 |
- |
|
250 |
-You can specify C<filter> at C<execute>. |
|
251 |
- |
|
252 |
- $dbi->execute($sql, {title => 'Perl', author => '%Ken%'} |
|
253 |
- filter => {title => 'to_something'); |
|
254 |
- |
|
255 |
-=head3 Manipulate same name's columns |
|
256 |
- |
|
257 |
-It is ok if there are same name's columns. |
|
258 |
-Let's think two date comparison. |
|
259 |
- |
|
260 |
- my $sql = "select * from table where date > :date and date < :date;"; |
|
261 |
- |
|
262 |
-In this case, You specify parameter values as array reference. |
|
263 |
- |
|
264 |
- my $dbi->execute($sql, {date => ['2010-10-01', '2012-02-10']}); |
|
265 |
- |
|
266 |
-=head2 Create where clause |
|
267 |
- |
|
268 |
-=head3 Dinamically create where clause : where |
|
269 |
- |
|
270 |
-You want to search multiple conditions in many times. |
|
271 |
-Let's think the following three cases. |
|
272 |
- |
|
273 |
-Case1: Search only C<title> |
|
274 |
- |
|
275 |
- where title = :title |
|
276 |
- |
|
277 |
-Case2: Search only C<author> |
|
278 |
- |
|
279 |
- where author = :author |
|
280 |
- |
|
281 |
-Case3: Search C<title> and C<author> |
|
282 |
- |
|
283 |
- where title = :title and author = :author |
|
284 |
- |
|
285 |
-L<DBIx::Custom> support dinamic where clause creating. |
|
286 |
-At first, create L<DBIx::Custom::Where> object by C<where>. |
|
287 |
- |
|
288 |
- my $where = $dbi->where; |
|
289 |
- |
|
290 |
-Set clause by C<clause> |
|
291 |
- |
|
292 |
- $where->clause( |
|
293 |
- ['and', 'title = :title, 'author = :author'] |
|
294 |
- ); |
|
295 |
- |
|
296 |
-C<clause> is the following format. |
|
297 |
- |
|
298 |
- ['or' or 'and', PART1, PART1, PART1] |
|
299 |
- |
|
300 |
-First argument is 'or' or 'and'. |
|
301 |
-Later than first argument are part which contains named placeholder. |
|
302 |
- |
|
303 |
-You can write more complex format. |
|
304 |
- |
|
305 |
- ['and', |
|
306 |
- 'title = :title', |
|
307 |
- ['or', 'author = :author', 'date like :date'] |
|
308 |
- ] |
|
309 |
- |
|
310 |
-This mean "title = :title and ( author = :author or date like :date )". |
|
311 |
- |
|
312 |
-After setting C<clause>, set C<param>. |
|
313 |
- |
|
314 |
- $where->param({title => 'Perl'}); |
|
315 |
- |
|
316 |
-In this example, parameter contains only title. |
|
317 |
- |
|
318 |
-If you execute C<string_to>, you can get where clause |
|
319 |
-which contain only named placeholder. |
|
320 |
- |
|
321 |
- my $where_clause = $where->to_string; |
|
322 |
- |
|
323 |
-Parameter name is only title, the following where clause is created. |
|
324 |
- |
|
325 |
- where title = :title |
|
326 |
- |
|
327 |
-You can also create where clause by stringification. |
|
328 |
- |
|
329 |
- my $where_clause = "$where"; |
|
330 |
- |
|
331 |
-This is useful to embbed it into SQL. |
|
332 |
- |
|
333 |
-=head3 In case where clause contains same name columns |
|
334 |
- |
|
335 |
-Even if same name parameters exists, you can create where clause. |
|
336 |
-Let's think that there are starting date and ending date. |
|
337 |
- |
|
338 |
- my $param = {start_date => '2010-11-15', end_date => '2011-11-21'}; |
|
339 |
- |
|
340 |
-In this case, you set parameter value as array reference. |
|
341 |
- |
|
342 |
- my $p = {date => ['2010-11-15', '2011-11-21']}; |
|
343 |
- |
|
344 |
-You can embbed these values into same name parameters. |
|
345 |
- |
|
346 |
- $where->clause( |
|
347 |
- ['and', 'date > :date', 'date < :date'] |
|
348 |
- ); |
|
349 |
- $where->param($p); |
|
350 |
- |
|
351 |
-If starting date isn't exists, create the following parameter. |
|
352 |
- |
|
353 |
- my $p = {date => [$dbi->not_exists, '2011-11-21']}; |
|
354 |
- |
|
355 |
-You can get DBIx::Custom::NotExists object by C<not_exists> |
|
356 |
-This mean correnspondinf value isn't exists. |
|
357 |
- |
|
358 |
-If ending date isn't exists, create the following parameter. |
|
359 |
- |
|
360 |
- my $p = {date => ['2010-11-15']}; |
|
361 |
- |
|
362 |
-If both date isn't exists, create the following parameter. |
|
363 |
- |
|
364 |
- my $p = {date => []}; |
|
365 |
- |
|
366 |
-This logic is a little difficut. See the following ones. |
|
367 |
- |
|
368 |
- my @date; |
|
369 |
- push @date, exists $param->{start_date} ? $param->{start_date} |
|
370 |
- : $dbi->not_exists; |
|
371 |
- push @date, $param->{end_date} if exists $param->{end_date}; |
|
372 |
- my $p = {date => \@date}; |
|
373 |
- |
|
374 |
-=head3 With C<select> |
|
375 |
- |
|
376 |
-You can pass L<DBIx::Custom::Where> object to C<where> of C<select>. |
|
377 |
- |
|
378 |
- my $where = $dbi->where; |
|
379 |
- $where->clause(['and', 'title = :title', 'author = :author']); |
|
380 |
- $where->param({title => 'Perl'}); |
|
381 |
- my $result = $dbi->select(table => 'book', where => $where); |
|
382 |
- |
|
383 |
-You can also pass it to C<where> of C<update>AC<delete> |
|
384 |
- |
|
385 |
-=head3 With C<execute> |
|
386 |
- |
|
387 |
-L<DBIx::Custom::Where> object is embedded into SQL. |
|
388 |
- |
|
389 |
- my $where = $dbi->where; |
|
390 |
- $where->clause(['and', 'title = :title', 'author = :author']); |
|
391 |
- $where->param({title => 'Perl'}); |
|
392 |
- |
|
393 |
- my $sql = <<"EOS"; |
|
394 |
- select * from book; |
|
395 |
- $where |
|
396 |
- EOS |
|
397 |
- |
|
398 |
- $dbi->execute($sql, $param, table => 'book'); |
|
399 |
- |
|
400 |
-=head2 Filtering |
|
401 |
- |
|
402 |
-=head3 Register filter : C<register_filter> |
|
403 |
- |
|
404 |
-If you want to register filter, use C<register_filter>. |
|
405 |
- |
|
406 |
- $dbi->register_filter( |
|
407 |
- # Time::Piece object to DATE format |
|
408 |
- tp_to_date => sub { |
|
409 |
- my $date = shift; |
|
410 |
- return $tp->strftime('%Y-%m-%d'); |
|
411 |
- }, |
|
412 |
- |
|
413 |
- # DATE to Time::Piece object |
|
414 |
- date_to_tp => sub { |
|
415 |
- my $date = shift; |
|
416 |
- return Time::Piece->strptime($date, '%Y-%m-%d'); |
|
417 |
- }, |
|
418 |
- ); |
|
419 |
- |
|
420 |
-=head3 Filter before sending data into database : C<filter> option |
|
421 |
- |
|
422 |
-If you filter sending data, use C<filter> option. |
|
423 |
- |
|
424 |
- $dbi->execute( |
|
425 |
- 'insert into book (date) values (:date)', |
|
426 |
- {date => $tp}, |
|
427 |
- filter => {date => 'tp_to_date'} |
|
428 |
- ); |
|
429 |
- |
|
430 |
-You can use C<filter> option in C<insert>, C<update>, C<delete>, C<select> method. |
|
431 |
- |
|
432 |
- $dbi->insert( |
|
433 |
- {date => $tp}, |
|
434 |
- table => 'book', |
|
435 |
- filter => {date => 'tp_to_date'} |
|
436 |
- ); |
|
437 |
- |
|
438 |
-=head3 Filter after fetching data from database. |
|
439 |
- |
|
440 |
-If you filter fetch data, use L<DBIx::Custom::Result>'s C<filter> method. |
|
441 |
- |
|
442 |
- my $result = $dbi->select(column => 'date', table => 'book'); |
|
443 |
- $result->filter(date => 'date_to_tp'); |
|
444 |
- my $row = $result->one; |
|
445 |
- |
|
446 |
-=head2 7. Model |
|
447 |
- |
|
448 |
-=head3 Model |
|
449 |
- |
|
450 |
-you can define model extending L<DBIx::Custom::Model> |
|
451 |
-to improve source code view. |
|
452 |
- |
|
453 |
-At first, you create basic model class extending <DBIx::Custom::Model>. |
|
454 |
-Each L<DBIx::Custom> class inherit L<Object::Simple>. |
|
455 |
-so you can inherit the following way. |
|
456 |
- |
|
457 |
- package MyModel; |
|
458 |
- use DBIx::Custom::Model -base; |
|
459 |
- |
|
460 |
-Next, you create each model classes. |
|
461 |
- |
|
462 |
-MyModel::book |
|
463 |
- |
|
464 |
- package MyModel::book; |
|
465 |
- use MyModel -base; |
|
466 |
- |
|
467 |
- sub insert { ... } |
|
468 |
- sub list { ... } |
|
469 |
- |
|
470 |
-MyModel::company |
|
471 |
- |
|
472 |
- package MyModel::company; |
|
473 |
- use MyModel -base; |
|
474 |
- |
|
475 |
- sub insert { ... } |
|
476 |
- sub list { ... } |
|
477 |
- |
|
478 |
-The follwoing modules location is needed. |
|
479 |
- |
|
480 |
- MyModel.pm |
|
481 |
- MyModel / book.pm |
|
482 |
- / company.pm |
|
483 |
- |
|
484 |
-You can include these models by C<include_model> |
|
485 |
- |
|
486 |
- $dbi->include_model('MyModel'); |
|
487 |
- |
|
488 |
-First argument is name space of model. |
|
489 |
- |
|
490 |
-You can use model like this. |
|
491 |
- |
|
492 |
- my $result = $dbi->model('book')->list; |
|
493 |
- |
|
494 |
-In mode, You can use such as methods, |
|
495 |
-C<insert>, C<update>, C<update_all>, |
|
496 |
-C<delete>, C<delete_all>, C<select> |
|
497 |
-without C<table> option. |
|
498 |
- |
|
499 |
- $dbi->model('book')->insert($param); |
|
500 |
- |
|
501 |
-Model is L<DBIx::Custom::Model>. |
|
502 |
- |
|
503 |
-If you need table nameAyou can get it by C<table>. |
|
504 |
- |
|
505 |
- my $table = $model->table; |
|
506 |
- |
|
507 |
-You can get L<DBIx::Custom>. |
|
508 |
- |
|
509 |
- my $dbi = $model->dbi; |
|
510 |
- |
|
511 |
-You can also call all methods of L<DBIx::Custom> and L<DBI>. |
|
512 |
- |
|
513 |
- # DBIx::Custom method |
|
514 |
- $model->execute($sql); |
|
515 |
- |
|
516 |
- # DBI method |
|
517 |
- $model->begin_work; |
|
518 |
- $model->commit; |
|
519 |
- |
|
520 |
-If you want to get all models, you can get them by keys of C<models>. |
|
521 |
- |
|
522 |
- my @models = keys %{$self->models}; |
|
523 |
- |
|
524 |
-You can set primary key to model. |
|
525 |
- |
|
526 |
- $model->primary_key(['id', 'number_id']); |
|
527 |
- |
|
528 |
-Primary key is used by C<insert>, C<update>, C<delete>, |
|
529 |
-and C<select> methods. |
|
530 |
- |
|
531 |
-You can set column names |
|
532 |
- |
|
533 |
- $model->columns(['id', 'number_id']); |
|
534 |
- |
|
535 |
-Column names is automarically set by C<setup_model>. |
|
536 |
-This method is needed to be call after C<include_model>. |
|
537 |
- |
|
538 |
- $dbi->setup_model; |
|
539 |
- |
|
540 |
-You can set C<join> |
|
541 |
- |
|
542 |
- $model->join(['left outer join company on book.company_id = company.id']); |
|
543 |
- |
|
544 |
-C<join> is used by C<select> method. |
|
545 |
- |
|
546 |
-=head2 Create column clause automatically : mycolumn, column |
|
547 |
- |
|
548 |
-To create column clause automatically, use C<mycolumn>. |
|
549 |
-Valude of C<table> and C<columns> is used. |
|
550 |
- |
|
551 |
- my $mycolumns = $model->mycolumn; |
|
552 |
- |
|
553 |
-If C<table> is 'book'AC<column> is ['id', 'name'], |
|
554 |
-the following clause is created. |
|
555 |
- |
|
556 |
- book.id as id, book.name as name |
|
557 |
- |
|
558 |
-These column name is for removing column name ambiguities. |
|
559 |
- |
|
560 |
-You can create column clause from columns of other table. |
|
561 |
- |
|
562 |
- my $columns = $model->column('company'); |
|
563 |
- |
|
564 |
-If C<table> is "company", C<column> return ['id', 'name'], |
|
565 |
-the following clause is created. |
|
566 |
- |
|
567 |
- company.id as "company.id", company.name as "company.name" |
|
568 |
- |
|
569 |
-=head2 Model Examples |
|
570 |
- |
|
571 |
-Model examples |
|
572 |
- |
|
573 |
- package MyDBI; |
|
574 |
- use DBIx::Custom -base; |
|
575 |
- |
|
576 |
- sub connect { |
|
577 |
- my $self = shift->SUPER::connect(@_); |
|
578 |
- |
|
579 |
- $self->include_model( |
|
580 |
- MyModel => [ |
|
581 |
- 'book', |
|
582 |
- 'company' |
|
583 |
- ] |
|
584 |
- ); |
|
585 |
- } |
|
586 |
- |
|
587 |
- package MyModel::book; |
|
588 |
- use DBIx::Custom::Model -base; |
|
589 |
- |
|
590 |
- has primary_key => sub { ['id'] }; |
|
591 |
- |
|
592 |
- sub insert { ... } |
|
593 |
- sub list { ... } |
|
594 |
- |
|
595 |
- package MyModel::company; |
|
596 |
- use DBIx::Custom::Model -base; |
|
597 |
- |
|
598 |
- has primary_key => sub { ['id'] }; |
|
599 |
- |
|
600 |
- sub insert { ... } |
|
601 |
- sub list { ... } |
|
602 |
- |
|
603 |
-=cut |
... | ... |
@@ -1,13 +0,0 @@ |
1 |
-=encoding utf8 |
|
2 |
- |
|
3 |
-=head1 NAME |
|
4 |
- |
|
5 |
-DBIx::Custom::Guide - DBIx::Customガイド |
|
6 |
- |
|
7 |
-=head1 LINK |
|
8 |
- |
|
9 |
-ドキュメントは以下のリンクに移動しました。 |
|
10 |
- |
|
11 |
-L<http://d.hatena.ne.jp/perlcodesample/20110401/1305597081> |
|
12 |
- |
|
13 |
-=cut |
... | ... |
@@ -1,247 +0,0 @@ |
1 |
-package DBIx::Custom::Model; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util '_subname'; |
|
6 |
- |
|
7 |
-# Carp trust relationship |
|
8 |
-push @DBIx::Custom::CARP_NOT, __PACKAGE__; |
|
9 |
- |
|
10 |
-has [qw/dbi table/], |
|
11 |
- bind_type => sub { [] }, |
|
12 |
- columns => sub { [] }, |
|
13 |
- join => sub { [] }, |
|
14 |
- primary_key => sub { [] }; |
|
15 |
- |
|
16 |
-our $AUTOLOAD; |
|
17 |
- |
|
18 |
-sub AUTOLOAD { |
|
19 |
- my $self = shift; |
|
20 |
- |
|
21 |
- # Method name |
|
22 |
- my ($package, $mname) = $AUTOLOAD =~ /^([\w\:]+)\:\:(\w+)$/; |
|
23 |
- |
|
24 |
- # Method |
|
25 |
- $self->{_methods} ||= {}; |
|
26 |
- if (my $method = $self->{_methods}->{$mname}) { |
|
27 |
- return $self->$method(@_) |
|
28 |
- } |
|
29 |
- elsif (my $dbi_method = $self->dbi->can($mname)) { |
|
30 |
- $self->dbi->$dbi_method(@_); |
|
31 |
- } |
|
32 |
- elsif ($self->{dbh} && (my $dbh_method = $self->dbh->can($mname))) { |
|
33 |
- $self->dbi->dbh->$dbh_method(@_); |
|
34 |
- } |
|
35 |
- else { |
|
36 |
- croak qq{Can't locate object method "$mname" via "$package" } |
|
37 |
- . _subname; |
|
38 |
- } |
|
39 |
-} |
|
40 |
- |
|
41 |
-my @methods = qw/insert insert_at update update_at update_all |
|
42 |
- delete delete_at delete_all select select_at/; |
|
43 |
-foreach my $method (@methods) { |
|
44 |
- |
|
45 |
- my $code = sub { |
|
46 |
- my $self = shift; |
|
47 |
- |
|
48 |
- my @args = ( |
|
49 |
- table => $self->table, |
|
50 |
- bind_type => $self->bind_type, |
|
51 |
- primary_key => $self->primary_key, |
|
52 |
- type => $self->type, # DEPRECATED! |
|
53 |
- ); |
|
54 |
- push @args, (join => $self->join) if $method =~ /^select/; |
|
55 |
- unshift @args, shift if @_ % 2; |
|
56 |
- |
|
57 |
- $self->dbi->$method(@args, @_); |
|
58 |
- }; |
|
59 |
- |
|
60 |
- no strict 'refs'; |
|
61 |
- my $class = __PACKAGE__; |
|
62 |
- *{"${class}::$method"} = $code; |
|
63 |
-} |
|
64 |
- |
|
65 |
-sub DESTROY { } |
|
66 |
- |
|
67 |
-sub method { |
|
68 |
- my $self = shift; |
|
69 |
- |
|
70 |
- # Merge |
|
71 |
- my $methods = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
72 |
- $self->{_methods} = {%{$self->{_methods} || {}}, %$methods}; |
|
73 |
- |
|
74 |
- return $self; |
|
75 |
-} |
|
76 |
- |
|
77 |
-sub mycolumn { |
|
78 |
- my $self = shift; |
|
79 |
- my $table = shift unless ref $_[0]; |
|
80 |
- my $columns = shift; |
|
81 |
- |
|
82 |
- $table ||= $self->table || ''; |
|
83 |
- $columns ||= $self->columns; |
|
84 |
- |
|
85 |
- return $self->dbi->mycolumn($table, $columns); |
|
86 |
-} |
|
87 |
- |
|
88 |
-sub new { |
|
89 |
- my $self = shift->SUPER::new(@_); |
|
90 |
- |
|
91 |
- # Check attribute names |
|
92 |
- my @attrs = keys %$self; |
|
93 |
- foreach my $attr (@attrs) { |
|
94 |
- croak qq{"$attr" is invalid attribute name } . _subname |
|
95 |
- unless $self->can($attr); |
|
96 |
- } |
|
97 |
- |
|
98 |
- return $self; |
|
99 |
-} |
|
100 |
- |
|
101 |
-# DEPRECATED! |
|
102 |
-has 'filter'; |
|
103 |
-has 'name'; |
|
104 |
-has type => sub { [] }; |
|
105 |
- |
|
106 |
-1; |
|
107 |
- |
|
108 |
-=head1 NAME |
|
109 |
- |
|
110 |
-DBIx::Custom::Model - Model |
|
111 |
- |
|
112 |
-=head1 SYNOPSIS |
|
113 |
- |
|
114 |
-use DBIx::Custom::Table; |
|
115 |
- |
|
116 |
-my $table = DBIx::Custom::Model->new(table => 'books'); |
|
117 |
- |
|
118 |
-=head1 ATTRIBUTES |
|
119 |
- |
|
120 |
-=head2 C<dbi> |
|
121 |
- |
|
122 |
- my $dbi = $model->dbi; |
|
123 |
- $model = $model->dbi($dbi); |
|
124 |
- |
|
125 |
-L<DBIx::Custom> object. |
|
126 |
- |
|
127 |
-=head2 C<join> |
|
128 |
- |
|
129 |
- my $join = $model->join; |
|
130 |
- $model = $model->join( |
|
131 |
- ['left outer join company on book.company_id = company.id'] |
|
132 |
- ); |
|
133 |
- |
|
134 |
-Join clause, this value is passed to C<select> method. |
|
135 |
- |
|
136 |
-=head2 C<primary_key> |
|
137 |
- |
|
138 |
- my $primary_key = $model->primary_key; |
|
139 |
- $model = $model->primary_key(['id', 'number']); |
|
140 |
- |
|
141 |
-Primary key,this is passed to C<insert>, C<update>, |
|
142 |
-C<delete>, and C<select> method. |
|
143 |
- |
|
144 |
-=head2 C<table> |
|
145 |
- |
|
146 |
- my $table = $model->table; |
|
147 |
- $model = $model->table('book'); |
|
148 |
- |
|
149 |
-Table name, this is passed to C<select> method. |
|
150 |
- |
|
151 |
-=head2 C<bind_type> |
|
152 |
- |
|
153 |
- my $type = $model->bind_type; |
|
154 |
- $model = $model->bind_type(['image' => DBI::SQL_BLOB]); |
|
155 |
- |
|
156 |
-Database data type, this is used as type optioon of C<insert>, |
|
157 |
-C<update>, C<update_all>, C<delete>, C<delete_all>, |
|
158 |
-C<select>, and C<execute> method |
|
159 |
- |
|
160 |
-=head1 METHODS |
|
161 |
- |
|
162 |
-L<DBIx::Custom::Model> inherits all methods from L<Object::Simple>, |
|
163 |
-and you can use all methods of L<DBIx::Custom> and L<DBI> |
|
164 |
-and implements the following new ones. |
|
165 |
- |
|
166 |
-=head2 C<delete> |
|
167 |
- |
|
168 |
- $table->delete(...); |
|
169 |
- |
|
170 |
-Same as C<delete> of L<DBIx::Custom> except that |
|
171 |
-you don't have to specify C<table> option. |
|
172 |
- |
|
173 |
-=head2 C<delete_all> |
|
174 |
- |
|
175 |
- $table->delete_all(...); |
|
176 |
- |
|
177 |
-Same as C<delete_all> of L<DBIx::Custom> except that |
|
178 |
-you don't have to specify C<table> option. |
|
179 |
- |
|
180 |
-=head2 C<insert> |
|
181 |
- |
|
182 |
- $table->insert(...); |
|
183 |
- |
|
184 |
-Same as C<insert> of L<DBIx::Custom> except that |
|
185 |
-you don't have to specify C<table> option. |
|
186 |
- |
|
187 |
-=head2 C<method> |
|
188 |
- |
|
189 |
- $model->method( |
|
190 |
- update_or_insert => sub { |
|
191 |
- my $self = shift; |
|
192 |
- |
|
193 |
- # ... |
|
194 |
- }, |
|
195 |
- find_or_create => sub { |
|
196 |
- my $self = shift; |
|
197 |
- |
|
198 |
- # ... |
|
199 |
- ); |
|
200 |
- |
|
201 |
-Register method. These method is called directly from L<DBIx::Custom::Model> object. |
|
202 |
- |
|
203 |
- $model->update_or_insert; |
|
204 |
- $model->find_or_create; |
|
205 |
- |
|
206 |
-=head2 C<mycolumn> |
|
207 |
- |
|
208 |
- my $column = $self->mycolumn; |
|
209 |
- my $column = $self->mycolumn(book => ['author', 'title']); |
|
210 |
- my $column = $self->mycolumn(['author', 'title']); |
|
211 |
- |
|
212 |
-Create column clause for myself. The follwoing column clause is created. |
|
213 |
- |
|
214 |
- book.author as author, |
|
215 |
- book.title as title |
|
216 |
- |
|
217 |
-If table name is ommited, C<table> attribute of the model is used. |
|
218 |
-If column names is omitted, C<columns> attribute of the model is used. |
|
219 |
- |
|
220 |
-=head2 C<new> |
|
221 |
- |
|
222 |
- my $table = DBIx::Custom::Table->new; |
|
223 |
- |
|
224 |
-Create a L<DBIx::Custom::Table> object. |
|
225 |
- |
|
226 |
-=head2 C<select> |
|
227 |
- |
|
228 |
- $table->select(...); |
|
229 |
- |
|
230 |
-Same as C<select> of L<DBIx::Custom> except that |
|
231 |
-you don't have to specify C<table> option. |
|
232 |
- |
|
233 |
-=head2 C<update> |
|
234 |
- |
|
235 |
- $table->update(...); |
|
236 |
- |
|
237 |
-Same as C<update> of L<DBIx::Custom> except that |
|
238 |
-you don't have to specify C<table> option. |
|
239 |
- |
|
240 |
-=head2 C<update_all> |
|
241 |
- |
|
242 |
- $table->update_all(param => \%param); |
|
243 |
- |
|
244 |
-Same as C<update_all> of L<DBIx::Custom> except that |
|
245 |
-you don't have to specify table name. |
|
246 |
- |
|
247 |
-=cut |
... | ... |
@@ -1,108 +0,0 @@ |
1 |
-package DBIx::Custom::Order; |
|
2 |
-use Object::Simple -base; |
|
3 |
-use overload |
|
4 |
- 'bool' => sub {1}, |
|
5 |
- '""' => sub { shift->to_string }, |
|
6 |
- fallback => 1; |
|
7 |
- |
|
8 |
-has 'dbi', |
|
9 |
- orders => sub { [] }; |
|
10 |
- |
|
11 |
-sub prepend { |
|
12 |
- my $self = shift; |
|
13 |
- |
|
14 |
- foreach my $order (reverse @_) { |
|
15 |
- if (ref $order eq 'ARRAY') { |
|
16 |
- my $column = shift @$order; |
|
17 |
- $column = $self->dbi->_q($column) if defined $column; |
|
18 |
- my $derection = shift @$order; |
|
19 |
- $order = $column; |
|
20 |
- $order .= " $derection" if $derection; |
|
21 |
- } |
|
22 |
- unshift @{$self->orders}, $order; |
|
23 |
- } |
|
24 |
- |
|
25 |
- return $self; |
|
26 |
-} |
|
27 |
- |
|
28 |
-sub to_string { |
|
29 |
- my $self = shift; |
|
30 |
- |
|
31 |
- my $exists = {}; |
|
32 |
- my @orders; |
|
33 |
- foreach my $order (@{$self->orders}) { |
|
34 |
- next unless defined $order; |
|
35 |
- $order =~ s/^\s+//; |
|
36 |
- $order =~ s/\s+$//; |
|
37 |
- my ($column, $direction) = split /\s+/, $order; |
|
38 |
- push @orders, $order unless $exists->{$column}; |
|
39 |
- $exists->{$column} = 1; |
|
40 |
- } |
|
41 |
- |
|
42 |
- return '' unless @orders; |
|
43 |
- return 'order by ' . join(', ', @orders); |
|
44 |
-} |
|
45 |
- |
|
46 |
-1; |
|
47 |
- |
|
48 |
-=head1 NAME |
|
49 |
- |
|
50 |
-DBIx::Custom::Order - Order by EXPERIMENTAL |
|
51 |
- |
|
52 |
-=head1 SYNOPSIS |
|
53 |
- |
|
54 |
- # Result |
|
55 |
- my $order = DBIx::Custom::Order->new; |
|
56 |
- $order->prepend('title', 'author desc'); |
|
57 |
- my $order_by = "$order"; |
|
58 |
- |
|
59 |
-=head1 ATTRIBUTES |
|
60 |
- |
|
61 |
-=head2 C<dbi> |
|
62 |
- |
|
63 |
- my $dbi = $order->dbi; |
|
64 |
- $order = $order->dbi($dbi); |
|
65 |
- |
|
66 |
-L<DBIx::Custom> object. |
|
67 |
- |
|
68 |
-=head2 C<orders> |
|
69 |
- |
|
70 |
- my $orders = $result->orders; |
|
71 |
- $result = $result->orders(\%orders); |
|
72 |
- |
|
73 |
-Parts of order by clause |
|
74 |
- |
|
75 |
-=head1 METHODS |
|
76 |
- |
|
77 |
-L<DBIx::Custom::Result> inherits all methods from L<Object::Simple> |
|
78 |
-and implements the following new ones. |
|
79 |
- |
|
80 |
-=head2 C<prepend> |
|
81 |
- |
|
82 |
- $order->prepend('title', 'author desc'); |
|
83 |
- |
|
84 |
-Prepend order parts to C<orders>. |
|
85 |
- |
|
86 |
-You can pass array reference, which contain column name and direction. |
|
87 |
-Column name is quoted properly |
|
88 |
- |
|
89 |
- # Column name and direction |
|
90 |
- $order->prepend(['book-title']); |
|
91 |
- $order->prepend([qw/book-title desc/]); |
|
92 |
- |
|
93 |
-This is expanded to the following way. |
|
94 |
- |
|
95 |
- "book-title" |
|
96 |
- "book-title" desc |
|
97 |
- |
|
98 |
-=head2 C<to_string> |
|
99 |
- |
|
100 |
- my $order_by = $order->to_string; |
|
101 |
- |
|
102 |
-Create order by clause. If column name is duplicated, First one is used. |
|
103 |
-C<to_string> override stringification. so you can write the follwoing way. |
|
104 |
- |
|
105 |
- my $order_by = "$order"; |
|
106 |
- |
|
107 |
-=cut |
|
108 |
- |
... | ... |
@@ -1,116 +0,0 @@ |
1 |
-package DBIx::Custom::Query; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util '_subname'; |
|
6 |
- |
|
7 |
-has 'sth', |
|
8 |
- sql => '', |
|
9 |
- columns => sub { [] }; |
|
10 |
- |
|
11 |
-# DEPRECATED! |
|
12 |
-has 'default_filter'; |
|
13 |
-sub filters { |
|
14 |
- warn "DBIx::Custom::Query filters attribute method is DEPRECATED!"; |
|
15 |
- my $self = shift; |
|
16 |
- if (@_) { |
|
17 |
- $self->{filters} = $_[0]; |
|
18 |
- return $self; |
|
19 |
- } |
|
20 |
- return $self->{filters}; |
|
21 |
-} |
|
22 |
- |
|
23 |
-# DEPRECATED! |
|
24 |
-sub tables { |
|
25 |
- warn "DBIx::Custom::Query tables attribute method is DEPRECATED!"; |
|
26 |
- my $self = shift; |
|
27 |
- if (@_) { |
|
28 |
- $self->{tables} = $_[0]; |
|
29 |
- return $self; |
|
30 |
- } |
|
31 |
- return $self->{tables} ||= []; |
|
32 |
-} |
|
33 |
- |
|
34 |
-#DEPRECATED! |
|
35 |
-sub filter { |
|
36 |
- Carp::carp "DBIx::Custom::Query filter method is DEPRECATED!"; |
|
37 |
- my $self = shift; |
|
38 |
- if (@_) { |
|
39 |
- my $filter = {}; |
|
40 |
- if (ref $_[0] eq 'HASH') { |
|
41 |
- $filter = $_[0]; |
|
42 |
- } |
|
43 |
- else { |
|
44 |
- my $ef = @_ > 1 ? [@_] : $_[0]; |
|
45 |
- for (my $i = 0; $i < @$ef; $i += 2) { |
|
46 |
- my $column = $ef->[$i]; |
|
47 |
- my $f = $ef->[$i + 1]; |
|
48 |
- if (ref $column eq 'ARRAY') { |
|
49 |
- foreach my $c (@$column) { |
|
50 |
- $filter->{$c} = $f; |
|
51 |
- } |
|
52 |
- } |
|
53 |
- else { |
|
54 |
- $filter->{$column} = $f; |
|
55 |
- } |
|
56 |
- } |
|
57 |
- } |
|
58 |
- foreach my $column (keys %$filter) { |
|
59 |
- my $fname = $filter->{$column}; |
|
60 |
- if (exists $filter->{$column} |
|
61 |
- && defined $fname |
|
62 |
- && ref $fname ne 'CODE') |
|
63 |
- { |
|
64 |
- my $filters = $self->{filters} || {}; |
|
65 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
66 |
- unless exists $filters->{$fname}; |
|
67 |
- $filter->{$column} = $filters->{$fname}; |
|
68 |
- } |
|
69 |
- } |
|
70 |
- $self->{filter} = {%{$self->{filter} || {}}, %$filter}; |
|
71 |
- return $self; |
|
72 |
- } |
|
73 |
- return $self->{filter} ||= {}; |
|
74 |
-} |
|
75 |
- |
|
76 |
-1; |
|
77 |
- |
|
78 |
-=head1 NAME |
|
79 |
- |
|
80 |
-DBIx::Custom::Query - Query |
|
81 |
- |
|
82 |
-=head1 SYNOPSIS |
|
83 |
- |
|
84 |
- my $query = DBIx::Custom::Query->new; |
|
85 |
- my $sth = $query->sth; |
|
86 |
- my $sql = $query->sql; |
|
87 |
- my $columns = $query->columns; |
|
88 |
- |
|
89 |
-=head1 ATTRIBUTES |
|
90 |
- |
|
91 |
-=head2 C<columns> |
|
92 |
- |
|
93 |
- my $columns = $query->columns; |
|
94 |
- $query = $query->columns(['auhtor', 'title']); |
|
95 |
- |
|
96 |
-Column names. |
|
97 |
- |
|
98 |
-=head2 C<sql> |
|
99 |
- |
|
100 |
- my $sql = $query->sql; |
|
101 |
- $query = $query->sql('select * from books where author = ?;'); |
|
102 |
- |
|
103 |
-SQL statement. |
|
104 |
- |
|
105 |
-=head2 C<sth> |
|
106 |
- |
|
107 |
- my $sth = $query->sth; |
|
108 |
- $query = $query->sth($sth); |
|
109 |
- |
|
110 |
-Statement handle of L<DBI> |
|
111 |
- |
|
112 |
-=head1 METHODS |
|
113 |
- |
|
114 |
-L<DBIx::Custom::Query> inherits all methods from L<Object::Simple>. |
|
115 |
- |
|
116 |
-=cut |
... | ... |
@@ -1,329 +0,0 @@ |
1 |
-package DBIx::Custom::QueryBuilder; |
|
2 |
- |
|
3 |
-use Object::Simple -base; |
|
4 |
- |
|
5 |
-use Carp 'croak'; |
|
6 |
-use DBIx::Custom::Query; |
|
7 |
-use DBIx::Custom::Util '_subname'; |
|
8 |
- |
|
9 |
-# Carp trust relationship |
|
10 |
-push @DBIx::Custom::CARP_NOT, __PACKAGE__; |
|
11 |
-push @DBIx::Custom::Where::CARP_NOT, __PACKAGE__; |
|
12 |
- |
|
13 |
-has 'dbi'; |
|
14 |
- |
|
15 |
-sub build_query { |
|
16 |
- my ($self, $source) = @_; |
|
17 |
- |
|
18 |
- my $query; |
|
19 |
- |
|
20 |
- # Parse tag. tag is DEPRECATED! |
|
21 |
- if ($self->dbi->tag_parse && $source =~ /(\s|^)\{/) { |
|
22 |
- $query = $self->_parse_tag($source); |
|
23 |
- my $tag_count = delete $query->{tag_count}; |
|
24 |
- warn qq/Tag system such as {? name} is DEPRECATED! / . |
|
25 |
- qq/use parameter system such as :name instead/ |
|
26 |
- if $tag_count; |
|
27 |
- my $query2 = $self->_parse_parameter($query->sql); |
|
28 |
- $query->sql($query2->sql); |
|
29 |
- for (my $i =0; $i < @{$query->columns}; $i++) { |
|
30 |
- my $column = $query->columns->[$i]; |
|
31 |
- if ($column eq 'RESERVED_PARAMETER') { |
|
32 |
- my $column2 = shift @{$query2->columns}; |
|
33 |
- croak ":name syntax is wrong" |
|
34 |
- unless defined $column2; |
|
35 |
- $query->columns->[$i] = $column2; |
|
36 |
- } |
|
37 |
- } |
|
38 |
- } |
|
39 |
- |
|
40 |
- # Parse parameter |
|
41 |
- else { $query = $self->_parse_parameter($source) } |
|
42 |
- |
|
43 |
- my $sql = $query->sql; |
|
44 |
- $sql .= ';' unless $source =~ /;$/; |
|
45 |
- $query->sql($sql); |
|
46 |
- |
|
47 |
- # Check placeholder count |
|
48 |
- croak qq{Placeholder count in "$sql" must be same as column count} |
|
49 |
- . _subname |
|
50 |
- unless $self->_placeholder_count($sql) eq @{$query->columns}; |
|
51 |
- |
|
52 |
- return $query; |
|
53 |
-} |
|
54 |
- |
|
55 |
-sub _placeholder_count { |
|
56 |
- my ($self, $sql) = @_; |
|
57 |
- |
|
58 |
- # Count |
|
59 |
- $sql ||= ''; |
|
60 |
- my $count = 0; |
|
61 |
- my $pos = -1; |
|
62 |
- while (($pos = index($sql, '?', $pos + 1)) != -1) { |
|
63 |
- $count++; |
|
64 |
- } |
|
65 |
- return $count; |
|
66 |
-} |
|
67 |
- |
|
68 |
-sub _parse_parameter { |
|
69 |
- my ($self, $source) = @_; |
|
70 |
- |
|
71 |
- # Get and replace parameters |
|
72 |
- my $sql = $source || ''; |
|
73 |
- my $columns = []; |
|
74 |
- my $c = $self->dbi->safety_character; |
|
75 |
- # Parameter regex |
|
76 |
- $sql =~ s/([^:]):(\d+):([^:])/$1\\:$2\\:$3/g; |
|
77 |
- my $re = qr/(^|.*?[^\\]):([$c\.]+)(?:\{(.*?)\})?(.*)/s; |
|
78 |
- while ($sql =~ /$re/g) { |
|
79 |
- push @$columns, $2; |
|
80 |
- $sql = defined $3 ? "$1$2 $3 ?$4" : "$1?$4"; |
|
81 |
- } |
|
82 |
- $sql =~ s/\\:/:/g; |
|
83 |
- |
|
84 |
- # Create query |
|
85 |
- my $query = DBIx::Custom::Query->new( |
|
86 |
- sql => $sql, |
|
87 |
- columns => $columns |
|
88 |
- ); |
|
89 |
- |
|
90 |
- return $query; |
|
91 |
-} |
|
92 |
- |
|
93 |
-# DEPRECATED! |
|
94 |
-has tags => sub { {} }; |
|
95 |
- |
|
96 |
-# DEPRECATED! |
|
97 |
-sub register_tag { |
|
98 |
- my $self = shift; |
|
99 |
- |
|
100 |
- warn "register_tag is DEPRECATED!"; |
|
101 |
- |
|
102 |
- # Merge tag |
|
103 |
- my $tags = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
104 |
- $self->tags({%{$self->tags}, %$tags}); |
|
105 |
- |
|
106 |
- return $self; |
|
107 |
-} |
|
108 |
- |
|
109 |
-# DEPRECATED! |
|
110 |
-sub _parse_tag { |
|
111 |
- my ($self, $source) = @_; |
|
112 |
- # Source |
|
113 |
- $source ||= ''; |
|
114 |
- # Tree |
|
115 |
- my @tree; |
|
116 |
- # Value |
|
117 |
- my $value = ''; |
|
118 |
- # State |
|
119 |
- my $state = 'text'; |
|
120 |
- # Before charactor |
|
121 |
- my $before = ''; |
|
122 |
- # Position |
|
123 |
- my $pos = 0; |
|
124 |
- # Parse |
|
125 |
- my $original = $source; |
|
126 |
- my $tag_count = 0; |
|
127 |
- while (defined(my $c = substr($source, $pos, 1))) { |
|
128 |
- # Last |
|
129 |
- last unless length $c; |
|
130 |
- # Parameter |
|
131 |
- if ($c eq ':' && (substr($source, $pos + 1, 1) || '') =~ /\w/) { |
|
132 |
- push @tree, {type => 'param'};; |
|
133 |
- } |
|
134 |
- # State is text |
|
135 |
- if ($state eq 'text') { |
|
136 |
- # Tag start charactor |
|
137 |
- if ($c eq '{') { |
|
138 |
- # Escaped charactor |
|
139 |
- if ($before eq "\\") { |
|
140 |
- substr($value, -1, 1, ''); |
|
141 |
- $value .= $c; |
|
142 |
- } |
|
143 |
- # Tag start |
|
144 |
- else { |
|
145 |
- # Change state |
|
146 |
- $state = 'tag'; |
|
147 |
- # Add text |
|
148 |
- push @tree, {type => 'text', value => $value} |
|
149 |
- if $value; |
|
150 |
- # Clear |
|
151 |
- $value = ''; |
|
152 |
- } |
|
153 |
- } |
|
154 |
- # Tag end charactor |
|
155 |
- elsif ($c eq '}') { |
|
156 |
- # Escaped charactor |
|
157 |
- if ($before eq "\\") { |
|
158 |
- substr($value, -1, 1, ''); |
|
159 |
- $value .= $c; |
|
160 |
- } |
|
161 |
- # Unexpected |
|
162 |
- else { |
|
163 |
- croak qq{Parsing error. unexpected "\}". } |
|
164 |
- . qq{pos $pos of "$original" } . _subname |
|
165 |
- } |
|
166 |
- } |
|
167 |
- # Normal charactor |
|
168 |
- else { $value .= $c } |
|
169 |
- } |
|
170 |
- # State is tags |
|
171 |
- else { |
|
172 |
- # Tag start charactor |
|
173 |
- if ($c eq '{') { |
|
174 |
- # Escaped charactor |
|
175 |
- if ($before eq "\\") { |
|
176 |
- substr($value, -1, 1, ''); |
|
177 |
- $value .= $c; |
|
178 |
- } |
|
179 |
- # Unexpected |
|
180 |
- else { |
|
181 |
- croak qq{Parsing error. unexpected "\{". } |
|
182 |
- . qq{pos $pos of "$original" } . _subname |
|
183 |
- } |
|
184 |
- } |
|
185 |
- # Tag end charactor |
|
186 |
- elsif ($c eq '}') { |
|
187 |
- # Escaped charactor |
|
188 |
- if ($before eq "\\") { |
|
189 |
- substr($value, -1, 1, ''); |
|
190 |
- $value .= $c; |
|
191 |
- } |
|
192 |
- # Tag end |
|
193 |
- else { |
|
194 |
- # Change state |
|
195 |
- $state = 'text'; |
|
196 |
- # Add tag |
|
197 |
- my ($tag_name, @tag_args) = split /\s+/, $value; |
|
198 |
- push @tree, {type => 'tag', tag_name => $tag_name, |
|
199 |
- tag_args => \@tag_args}; |
|
200 |
- # Clear |
|
201 |
- $value = ''; |
|
202 |
- # Countup |
|
203 |
- $tag_count++; |
|
204 |
- } |
|
205 |
- } |
|
206 |
- # Normal charactor |
|
207 |
- else { $value .= $c } |
|
208 |
- } |
|
209 |
- # Save before charactor |
|
210 |
- $before = $c; |
|
211 |
- # increment position |
|
212 |
- $pos++; |
|
213 |
- } |
|
214 |
- # Tag not finished |
|
215 |
- croak qq{Tag not finished. "$original" } . _subname |
|
216 |
- if $state eq 'tag'; |
|
217 |
- # Not contains tag |
|
218 |
- return DBIx::Custom::Query->new(sql => $source, tag_count => $tag_count) |
|
219 |
- if $tag_count == 0; |
|
220 |
- # Add rest text |
|
221 |
- push @tree, {type => 'text', value => $value} |
|
222 |
- if $value; |
|
223 |
- # SQL |
|
224 |
- my $sql = ''; |
|
225 |
- # All Columns |
|
226 |
- my $all_columns = []; |
|
227 |
- # Tables |
|
228 |
- my $tables = []; |
|
229 |
- # Build SQL |
|
230 |
- foreach my $node (@tree) { |
|
231 |
- # Text |
|
232 |
- if ($node->{type} eq 'text') { $sql .= $node->{value} } |
|
233 |
- # Parameter |
|
234 |
- elsif ($node->{type} eq 'param') { |
|
235 |
- push @$all_columns, 'RESERVED_PARAMETER'; |
|
236 |
- } |
|
237 |
- # Tag |
|
238 |
- else { |
|
239 |
- # Tag name |
|
240 |
- my $tag_name = $node->{tag_name}; |
|
241 |
- # Tag arguments |
|
242 |
- my $tag_args = $node->{tag_args}; |
|
243 |
- # Table |
|
244 |
- if ($tag_name eq 'table') { |
|
245 |
- my $table = $tag_args->[0]; |
|
246 |
- push @$tables, $table; |
|
247 |
- $sql .= $table; |
|
248 |
- next; |
|
249 |
- } |
|
250 |
- # Get tag |
|
251 |
- my $tag = $self->tag_processors->{$tag_name} |
|
252 |
- || $self->tags->{$tag_name}; |
|
253 |
- # Tag is not registered |
|
254 |
- croak qq{Tag "$tag_name" is not registered } . _subname |
|
255 |
- unless $tag; |
|
256 |
- # Tag not sub reference |
|
257 |
- croak qq{Tag "$tag_name" must be sub reference } . _subname |
|
258 |
- unless ref $tag eq 'CODE'; |
|
259 |
- # Execute tag |
|
260 |
- my $r = $tag->(@$tag_args); |
|
261 |
- # Check tag return value |
|
262 |
- croak qq{Tag "$tag_name" must return [STRING, ARRAY_REFERENCE] } |
|
263 |
- . _subname |
|
264 |
- unless ref $r eq 'ARRAY' && defined $r->[0] && ref $r->[1] eq 'ARRAY'; |
|
265 |
- # Part of SQL statement and colum names |
|
266 |
- my ($part, $columns) = @$r; |
|
267 |
- # Add columns |
|
268 |
- push @$all_columns, @$columns; |
|
269 |
- # Join part tag to SQL |
|
270 |
- $sql .= $part; |
|
271 |
- } |
|
272 |
- } |
|
273 |
- # Query |
|
274 |
- my $query = DBIx::Custom::Query->new( |
|
275 |
- sql => $sql, |
|
276 |
- columns => $all_columns, |
|
277 |
- tables => $tables, |
|
278 |
- tag_count => $tag_count |
|
279 |
- ); |
|
280 |
- return $query; |
|
281 |
-} |
|
282 |
- |
|
283 |
-# DEPRECATED! |
|
284 |
-has tag_processors => sub { {} }; |
|
285 |
- |
|
286 |
-# DEPRECATED! |
|
287 |
-sub register_tag_processor { |
|
288 |
- my $self = shift; |
|
289 |
- warn "register_tag_processor is DEPRECATED!"; |
|
290 |
- # Merge tag |
|
291 |
- my $tag_processors = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
292 |
- $self->tag_processors({%{$self->tag_processors}, %{$tag_processors}}); |
|
293 |
- return $self; |
|
294 |
-} |
|
295 |
- |
|
296 |
-1; |
|
297 |
- |
|
298 |
-=head1 NAME |
|
299 |
- |
|
300 |
-DBIx::Custom::QueryBuilder - Query builder |
|
301 |
- |
|
302 |
-=head1 SYNOPSIS |
|
303 |
- |
|
304 |
- my $builder = DBIx::Custom::QueryBuilder->new; |
|
305 |
- my $query = $builder->build_query( |
|
306 |
- "select from table title = :title and author = :author" |
|
307 |
- ); |
|
308 |
- |
|
309 |
-=head1 ATTRIBUTES |
|
310 |
- |
|
311 |
-=head2 C<dbi> |
|
312 |
- |
|
313 |
- my $dbi = $builder->dbi; |
|
314 |
- $builder = $builder->dbi($dbi); |
|
315 |
- |
|
316 |
-L<DBIx::Custom> object. |
|
317 |
- |
|
318 |
-=head1 METHODS |
|
319 |
- |
|
320 |
-L<DBIx::Custom::QueryBuilder> inherits all methods from L<Object::Simple> |
|
321 |
-and implements the following new ones. |
|
322 |
- |
|
323 |
-=head2 C<build_query> |
|
324 |
- |
|
325 |
- my $query = $builder->build_query($source); |
|
326 |
- |
|
327 |
-Create a new L<DBIx::Custom::Query> object from SQL source. |
|
328 |
- |
|
329 |
-=cut |
... | ... |
@@ -1,573 +0,0 @@ |
1 |
-package DBIx::Custom::Result; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util qw/_array_to_hash _subname/; |
|
6 |
- |
|
7 |
-has [qw/dbi sth/], |
|
8 |
- stash => sub { {} }; |
|
9 |
- |
|
10 |
-*all = \&fetch_hash_all; |
|
11 |
- |
|
12 |
-sub filter { |
|
13 |
- my $self = shift; |
|
14 |
- |
|
15 |
- # Set |
|
16 |
- if (@_) { |
|
17 |
- |
|
18 |
- # Convert filter name to subroutine |
|
19 |
- my $filter = @_ == 1 ? $_[0] : [@_]; |
|
20 |
- $filter = _array_to_hash($filter); |
|
21 |
- foreach my $column (keys %$filter) { |
|
22 |
- my $fname = $filter->{$column}; |
|
23 |
- if (exists $filter->{$column} |
|
24 |
- && defined $fname |
|
25 |
- && ref $fname ne 'CODE') |
|
26 |
- { |
|
27 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
28 |
- unless exists $self->dbi->filters->{$fname}; |
|
29 |
- $filter->{$column} = $self->dbi->filters->{$fname}; |
|
30 |
- } |
|
31 |
- } |
|
32 |
- |
|
33 |
- # Merge |
|
34 |
- $self->{filter} = {%{$self->filter}, %$filter}; |
|
35 |
- |
|
36 |
- return $self; |
|
37 |
- } |
|
38 |
- |
|
39 |
- return $self->{filter} ||= {}; |
|
40 |
-} |
|
41 |
- |
|
42 |
-sub filter_off { |
|
43 |
- my $self = shift; |
|
44 |
- $self->{filter_off} = 1; |
|
45 |
- return $self; |
|
46 |
-} |
|
47 |
- |
|
48 |
-sub filter_on { |
|
49 |
- my $self = shift; |
|
50 |
- $self->{filter_off} = 0; |
|
51 |
- return $self; |
|
52 |
-} |
|
53 |
- |
|
54 |
-sub fetch { |
|
55 |
- my $self = shift; |
|
56 |
- |
|
57 |
- # Info |
|
58 |
- my $columns = $self->{sth}->{NAME}; |
|
59 |
- my $types = $self->{sth}->{TYPE}; |
|
60 |
- |
|
61 |
- # Fetch |
|
62 |
- my @row = $self->{sth}->fetchrow_array; |
|
63 |
- return unless @row; |
|
64 |
- |
|
65 |
- # Filtering |
|
66 |
- my $type_rule1 = $self->type_rule->{from1} || {}; |
|
67 |
- my $type_rule2 = $self->type_rule->{from2} || {}; |
|
68 |
- my $filter = $self->filter; |
|
69 |
- my $end_filter = $self->{end_filter} || {}; |
|
70 |
- for (my $i = 0; $i < @$columns; $i++) { |
|
71 |
- |
|
72 |
- # Column |
|
73 |
- my $column = $columns->[$i]; |
|
74 |
- |
|
75 |
- # Type rule |
|
76 |
- my $type_filter1 = $type_rule1->{lc($types->[$i])}; |
|
77 |
- $row[$i] = $type_filter1->($row[$i]) |
|
78 |
- if $type_filter1 && !$self->{type_rule_off} |
|
79 |
- && !$self->{type_rule1_off}; |
|
80 |
- my $type_filter2 = $type_rule2->{lc($types->[$i])}; |
|
81 |
- $row[$i] = $type_filter2->($row[$i]) |
|
82 |
- if $type_filter2 && !$self->{type_rule_off} |
|
83 |
- && !$self->{type_rule2_off}; |
|
84 |
- |
|
85 |
- # Filter |
|
86 |
- my $filter = $filter->{$column} || $self->{default_filter}; |
|
87 |
- $row[$i] = $filter->($row[$i]) |
|
88 |
- if $filter && !$self->{filter_off}; |
|
89 |
- $row[$i] = $end_filter->{$column}->($row[$i]) |
|
90 |
- if $end_filter->{$column} && !$self->{filter_off}; |
|
91 |
- } |
|
92 |
- |
|
93 |
- return \@row; |
|
94 |
-} |
|
95 |
- |
|
96 |
-sub fetch_all { |
|
97 |
- my $self = shift; |
|
98 |
- |
|
99 |
- # Fetch all rows |
|
100 |
- my $rows = []; |
|
101 |
- while(my $row = $self->fetch) { push @$rows, $row} |
|
102 |
- |
|
103 |
- return $rows; |
|
104 |
-} |
|
105 |
- |
|
106 |
-sub fetch_first { |
|
107 |
- my $self = shift; |
|
108 |
- |
|
109 |
- # Fetch |
|
110 |
- my $row = $self->fetch; |
|
111 |
- return unless $row; |
|
112 |
- |
|
113 |
- # Finish statement handle |
|
114 |
- $self->sth->finish; |
|
115 |
- |
|
116 |
- return $row; |
|
117 |
-} |
|
118 |
- |
|
119 |
-sub fetch_hash { |
|
120 |
- my $self = shift; |
|
121 |
- |
|
122 |
- # Info |
|
123 |
- my $columns = $self->{sth}->{NAME}; |
|
124 |
- my $types = $self->{sth}->{TYPE}; |
|
125 |
- |
|
126 |
- # Fetch |
|
127 |
- my $row = $self->{sth}->fetchrow_arrayref; |
|
128 |
- return unless $row; |
|
129 |
- |
|
130 |
- # Filter |
|
131 |
- my $hash_row = {}; |
|
132 |
- my $filter = $self->filter; |
|
133 |
- my $end_filter = $self->{end_filter} || {}; |
|
134 |
- my $type_rule1 = $self->type_rule->{from1} || {}; |
|
135 |
- my $type_rule2 = $self->type_rule->{from2} || {}; |
|
136 |
- for (my $i = 0; $i < @$columns; $i++) { |
|
137 |
- |
|
138 |
- # Column |
|
139 |
- my $column = $columns->[$i]; |
|
140 |
- $hash_row->{$column} = $row->[$i]; |
|
141 |
- |
|
142 |
- # Type rule |
|
143 |
- my $type_filter1 = $type_rule1->{lc($types->[$i])}; |
|
144 |
- $hash_row->{$column} = $type_filter1->($hash_row->{$column}) |
|
145 |
- if !$self->{type_rule_off} && !$self->{type_rule1_off} |
|
146 |
- && $type_filter1; |
|
147 |
- my $type_filter2 = $type_rule2->{lc($types->[$i])}; |
|
148 |
- $hash_row->{$column} = $type_filter2->($hash_row->{$column}) |
|
149 |
- if !$self->{type_rule_off} && !$self->{type_rule2_off} |
|
150 |
- && $type_filter2; |
|
151 |
- |
|
152 |
- # Filter |
|
153 |
- my $f = $filter->{$column} || $self->{default_filter}; |
|
154 |
- $hash_row->{$column} = $f->($hash_row->{$column}) |
|
155 |
- if $f && !$self->{filter_off}; |
|
156 |
- $hash_row->{$column} = $end_filter->{$column}->($hash_row->{$column}) |
|
157 |
- if $end_filter->{$column} && !$self->{filter_off}; |
|
158 |
- } |
|
159 |
- |
|
160 |
- return $hash_row; |
|
161 |
-} |
|
162 |
- |
|
163 |
-sub fetch_hash_all { |
|
164 |
- my $self = shift; |
|
165 |
- |
|
166 |
- # Fetch all rows as hash |
|
167 |
- my $rows = []; |
|
168 |
- while(my $row = $self->fetch_hash) { push @$rows, $row } |
|
169 |
- |
|
170 |
- return $rows; |
|
171 |
-} |
|
172 |
- |
|
173 |
-sub fetch_hash_first { |
|
174 |
- my $self = shift; |
|
175 |
- |
|
176 |
- # Fetch hash |
|
177 |
- my $row = $self->fetch_hash; |
|
178 |
- return unless $row; |
|
179 |
- |
|
180 |
- # Finish statement handle |
|
181 |
- $self->sth->finish; |
|
182 |
- |
|
183 |
- return $row; |
|
184 |
-} |
|
185 |
- |
|
186 |
-sub fetch_hash_multi { |
|
187 |
- my ($self, $count) = @_; |
|
188 |
- |
|
189 |
- # Fetch multiple rows |
|
190 |
- croak 'Row count must be specified ' . _subname |
|
191 |
- unless $count; |
|
192 |
- my $rows = []; |
|
193 |
- for (my $i = 0; $i < $count; $i++) { |
|
194 |
- my $row = $self->fetch_hash; |
|
195 |
- last unless $row; |
|
196 |
- push @$rows, $row; |
|
197 |
- } |
|
198 |
- |
|
199 |
- return unless @$rows; |
|
200 |
- return $rows; |
|
201 |
-} |
|
202 |
- |
|
203 |
-sub fetch_multi { |
|
204 |
- my ($self, $count) = @_; |
|
205 |
- |
|
206 |
- # Row count not specifed |
|
207 |
- croak 'Row count must be specified ' . _subname |
|
208 |
- unless $count; |
|
209 |
- |
|
210 |
- # Fetch multi rows |
|
211 |
- my $rows = []; |
|
212 |
- for (my $i = 0; $i < $count; $i++) { |
|
213 |
- my $row = $self->fetch; |
|
214 |
- last unless $row; |
|
215 |
- push @$rows, $row; |
|
216 |
- } |
|
217 |
- |
|
218 |
- return unless @$rows; |
|
219 |
- return $rows; |
|
220 |
-} |
|
221 |
- |
|
222 |
-sub header { shift->sth->{NAME} } |
|
223 |
- |
|
224 |
-*one = \&fetch_hash_first; |
|
225 |
- |
|
226 |
-sub type_rule { |
|
227 |
- my $self = shift; |
|
228 |
- |
|
229 |
- if (@_) { |
|
230 |
- my $type_rule = ref $_[0] eq 'HASH' ? $_[0] : {@_}; |
|
231 |
- |
|
232 |
- # From |
|
233 |
- foreach my $i (1 .. 2) { |
|
234 |
- $type_rule->{"from$i"} = _array_to_hash($type_rule->{"from$i"}); |
|
235 |
- foreach my $data_type (keys %{$type_rule->{"from$i"} || {}}) { |
|
236 |
- croak qq{data type of from$i section must be lower case or number} |
|
237 |
- if $data_type =~ /[A-Z]/; |
|
238 |
- my $fname = $type_rule->{"from$i"}{$data_type}; |
|
239 |
- if (defined $fname && ref $fname ne 'CODE') { |
|
240 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
241 |
- unless exists $self->dbi->filters->{$fname}; |
|
242 |
- |
|
243 |
- $type_rule->{"from$i"}{$data_type} = $self->dbi->filters->{$fname}; |
|
244 |
- } |
|
245 |
- } |
|
246 |
- } |
|
247 |
- $self->{type_rule} = $type_rule; |
|
248 |
- |
|
249 |
- return $self; |
|
250 |
- } |
|
251 |
- |
|
252 |
- return $self->{type_rule} || {}; |
|
253 |
-} |
|
254 |
- |
|
255 |
-sub type_rule_off { |
|
256 |
- my $self = shift; |
|
257 |
- $self->{type_rule_off} = 1; |
|
258 |
- return $self; |
|
259 |
-} |
|
260 |
- |
|
261 |
-sub type_rule_on { |
|
262 |
- my $self = shift; |
|
263 |
- $self->{type_rule_off} = 0; |
|
264 |
- return $self; |
|
265 |
-} |
|
266 |
- |
|
267 |
-sub type_rule1_off { |
|
268 |
- my $self = shift; |
|
269 |
- $self->{type_rule1_off} = 1; |
|
270 |
- return $self; |
|
271 |
-} |
|
272 |
- |
|
273 |
-sub type_rule1_on { |
|
274 |
- my $self = shift; |
|
275 |
- $self->{type_rule1_off} = 0; |
|
276 |
- return $self; |
|
277 |
-} |
|
278 |
- |
|
279 |
-sub type_rule2_off { |
|
280 |
- my $self = shift; |
|
281 |
- $self->{type_rule2_off} = 1; |
|
282 |
- return $self; |
|
283 |
-} |
|
284 |
- |
|
285 |
-sub type_rule2_on { |
|
286 |
- my $self = shift; |
|
287 |
- $self->{type_rule2_off} = 0; |
|
288 |
- return $self; |
|
289 |
-} |
|
290 |
- |
|
291 |
-# DEPRECATED! |
|
292 |
-sub end_filter { |
|
293 |
- warn "end_filter method is DEPRECATED!"; |
|
294 |
- my $self = shift; |
|
295 |
- if (@_) { |
|
296 |
- my $end_filter = {}; |
|
297 |
- if (ref $_[0] eq 'HASH') { $end_filter = $_[0] } |
|
298 |
- else { |
|
299 |
- $end_filter = _array_to_hash( |
|
300 |
- @_ > 1 ? [@_] : $_[0] |
|
301 |
- ); |
|
302 |
- } |
|
303 |
- foreach my $column (keys %$end_filter) { |
|
304 |
- my $fname = $end_filter->{$column}; |
|
305 |
- if (exists $end_filter->{$column} |
|
306 |
- && defined $fname |
|
307 |
- && ref $fname ne 'CODE') |
|
308 |
- { |
|
309 |
- croak qq{Filter "$fname" is not registered" } . _subname |
|
310 |
- unless exists $self->dbi->filters->{$fname}; |
|
311 |
- $end_filter->{$column} = $self->dbi->filters->{$fname}; |
|
312 |
- } |
|
313 |
- } |
|
314 |
- $self->{end_filter} = {%{$self->end_filter}, %$end_filter}; |
|
315 |
- return $self; |
|
316 |
- } |
|
317 |
- return $self->{end_filter} ||= {}; |
|
318 |
-} |
|
319 |
-# DEPRECATED! |
|
320 |
-sub remove_end_filter { |
|
321 |
- warn "remove_end_filter is DEPRECATED!"; |
|
322 |
- my $self = shift; |
|
323 |
- $self->{end_filter} = {}; |
|
324 |
- return $self; |
|
325 |
-} |
|
326 |
-# DEPRECATED! |
|
327 |
-sub remove_filter { |
|
328 |
- warn "remove_filter is DEPRECATED!"; |
|
329 |
- my $self = shift; |
|
330 |
- $self->{filter} = {}; |
|
331 |
- return $self; |
|
332 |
-} |
|
333 |
-# DEPRECATED! |
|
334 |
-sub default_filter { |
|
335 |
- warn "default_filter is DEPRECATED!"; |
|
336 |
- my $self = shift; |
|
337 |
- if (@_) { |
|
338 |
- my $fname = $_[0]; |
|
339 |
- if (@_ && !$fname) { |
|
340 |
- $self->{default_filter} = undef; |
|
341 |
- } |
|
342 |
- else { |
|
343 |
- croak qq{Filter "$fname" is not registered} |
|
344 |
- unless exists $self->dbi->filters->{$fname}; |
|
345 |
- $self->{default_filter} = $self->dbi->filters->{$fname}; |
|
346 |
- } |
|
347 |
- return $self; |
|
348 |
- } |
|
349 |
- return $self->{default_filter}; |
|
350 |
-} |
|
351 |
-# DEPRECATED! |
|
352 |
-has 'filter_check'; |
|
353 |
- |
|
354 |
-1; |
|
355 |
- |
|
356 |
-=head1 NAME |
|
357 |
- |
|
358 |
-DBIx::Custom::Result - Result of select statement |
|
359 |
- |
|
360 |
-=head1 SYNOPSIS |
|
361 |
- |
|
362 |
- # Result |
|
363 |
- my $result = $dbi->select(table => 'book'); |
|
364 |
- |
|
365 |
- # Fetch a row and put it into array reference |
|
366 |
- while (my $row = $result->fetch) { |
|
367 |
- my $author = $row->[0]; |
|
368 |
- my $title = $row->[1]; |
|
369 |
- } |
|
370 |
- |
|
371 |
- # Fetch only a first row and put it into array reference |
|
372 |
- my $row = $result->fetch_first; |
|
373 |
- |
|
374 |
- # Fetch all rows and put them into array of array reference |
|
375 |
- my $rows = $result->fetch_all; |
|
376 |
- |
|
377 |
- # Fetch a row and put it into hash reference |
|
378 |
- while (my $row = $result->fetch_hash) { |
|
379 |
- my $title = $row->{title}; |
|
380 |
- my $author = $row->{author}; |
|
381 |
- } |
|
382 |
- |
|
383 |
- # Fetch only a first row and put it into hash reference |
|
384 |
- my $row = $result->fetch_hash_first; |
|
385 |
- my $row = $result->one; # Same as fetch_hash_first |
|
386 |
- |
|
387 |
- # Fetch all rows and put them into array of hash reference |
|
388 |
- my $rows = $result->fetch_hash_all; |
|
389 |
- my $rows = $result->all; # Same as fetch_hash_all |
|
390 |
- |
|
391 |
-=head1 ATTRIBUTES |
|
392 |
- |
|
393 |
-=head2 C<dbi> |
|
394 |
- |
|
395 |
- my $dbi = $result->dbi; |
|
396 |
- $result = $result->dbi($dbi); |
|
397 |
- |
|
398 |
-L<DBIx::Custom> object. |
|
399 |
- |
|
400 |
-=head2 C<sth> |
|
401 |
- |
|
402 |
- my $sth = $reuslt->sth |
|
403 |
- $result = $result->sth($sth); |
|
404 |
- |
|
405 |
-Statement handle of L<DBI>. |
|
406 |
- |
|
407 |
-=head1 METHODS |
|
408 |
- |
|
409 |
-L<DBIx::Custom::Result> inherits all methods from L<Object::Simple> |
|
410 |
-and implements the following new ones. |
|
411 |
- |
|
412 |
-=head2 C<all> |
|
413 |
- |
|
414 |
- my $rows = $result->all; |
|
415 |
- |
|
416 |
-Same as C<fetch_hash_all>. |
|
417 |
- |
|
418 |
-=head2 C<fetch> |
|
419 |
- |
|
420 |
- my $row = $result->fetch; |
|
421 |
- |
|
422 |
-Fetch a row and put it into array reference. |
|
423 |
- |
|
424 |
-=head2 C<fetch_all> |
|
425 |
- |
|
426 |
- my $rows = $result->fetch_all; |
|
427 |
- |
|
428 |
-Fetch all rows and put them into array of array reference. |
|
429 |
- |
|
430 |
-=head2 C<fetch_first> |
|
431 |
- |
|
432 |
- my $row = $result->fetch_first; |
|
433 |
- |
|
434 |
-Fetch only a first row and put it into array reference, |
|
435 |
-and finish statment handle. |
|
436 |
- |
|
437 |
-=head2 C<fetch_hash> |
|
438 |
- |
|
439 |
- my $row = $result->fetch_hash; |
|
440 |
- |
|
441 |
-Fetch a row and put it into hash reference. |
|
442 |
- |
|
443 |
-=head2 C<fetch_hash_all> |
|
444 |
- |
|
445 |
- my $rows = $result->fetch_hash_all; |
|
446 |
- |
|
447 |
-Fetch all rows and put them into array of hash reference. |
|
448 |
- |
|
449 |
-=head2 C<fetch_hash_first> |
|
450 |
- |
|
451 |
- my $row = $result->fetch_hash_first; |
|
452 |
- |
|
453 |
-Fetch only a first row and put it into hash reference, |
|
454 |
-and finish statment handle. |
|
455 |
- |
|
456 |
-=head2 C<fetch_hash_multi> |
|
457 |
- |
|
458 |
- my $rows = $result->fetch_hash_multi(5); |
|
459 |
- |
|
460 |
-Fetch multiple rows and put them into array of hash reference. |
|
461 |
- |
|
462 |
-=head2 C<fetch_multi> |
|
463 |
- |
|
464 |
- my $rows = $result->fetch_multi(5); |
|
465 |
- |
|
466 |
-Fetch multiple rows and put them into array of array reference. |
|
467 |
- |
|
468 |
-=head2 C<filter> |
|
469 |
- |
|
470 |
- $result->filter(title => sub { uc $_[0] }, author => 'to_upper'); |
|
471 |
- $result->filter([qw/title author/] => 'to_upper'); |
|
472 |
- |
|
473 |
-Set filter for column. |
|
474 |
-You can use subroutine or filter name as filter. |
|
475 |
-This filter is executed after C<type_rule> filter. |
|
476 |
- |
|
477 |
-=head2 C<filter_off> EXPERIMENTAL |
|
478 |
- |
|
479 |
- $result = $result->filter_off; |
|
480 |
- |
|
481 |
-Turn filtering by C<filter> method off. |
|
482 |
-By default, filterin is on. |
|
483 |
- |
|
484 |
-=head2 C<filter_on> EXPERIMENTAL |
|
485 |
- |
|
486 |
- $result = $resutl->filter_on; |
|
487 |
- |
|
488 |
-Turn filtering by C<filter> method on. |
|
489 |
-By default, filterin is on. |
|
490 |
- |
|
491 |
-=head2 C<header> |
|
492 |
- |
|
493 |
- my $header = $result->header; |
|
494 |
- |
|
495 |
-Get header column names. |
|
496 |
- |
|
497 |
-=head2 C<one> |
|
498 |
- |
|
499 |
- my $row = $result->one; |
|
500 |
- |
|
501 |
-Same as C<fetch_hash_first>. |
|
502 |
- |
|
503 |
-=head2 C<stash> |
|
504 |
- |
|
505 |
- my $stash = $result->stash; |
|
506 |
- my $foo = $result->stash->{foo}; |
|
507 |
- $result->stash->{foo} = $foo; |
|
508 |
- |
|
509 |
-Stash is hash reference for data. |
|
510 |
- |
|
511 |
-=head2 C<type_rule> EXPERIMENTAL |
|
512 |
- |
|
513 |
- # Merge type rule |
|
514 |
- $result->type_rule( |
|
515 |
- # DATE |
|
516 |
- 9 => sub { ... }, |
|
517 |
- # DATETIME or TIMESTAMP |
|
518 |
- 11 => sub { ... } |
|
519 |
- ); |
|
520 |
- |
|
521 |
- # Replace type rule(by reference) |
|
522 |
- $result->type_rule([ |
|
523 |
- # DATE |
|
524 |
- 9 => sub { ... }, |
|
525 |
- # DATETIME or TIMESTAMP |
|
526 |
- 11 => sub { ... } |
|
527 |
- ]); |
|
528 |
- |
|
529 |
-This is same as L<DBIx::Custom>'s C<type_rule>'s <from>. |
|
530 |
- |
|
531 |
-=head2 C<type_rule_off> EXPERIMENTAL |
|
532 |
- |
|
533 |
- $result = $result->type_rule_off; |
|
534 |
- |
|
535 |
-Turn C<from1> and C<from2> type rule off. |
|
536 |
-By default, type rule is on. |
|
537 |
- |
|
538 |
-=head2 C<type_rule_on> EXPERIMENTAL |
|
539 |
- |
|
540 |
- $result = $result->type_rule_on; |
|
541 |
- |
|
542 |
-Turn C<from1> and C<from2> type rule on. |
|
543 |
-By default, type rule is on. |
|
544 |
- |
|
545 |
-=head2 C<type_rule1_off> EXPERIMENTAL |
|
546 |
- |
|
547 |
- $result = $result->type_rule1_off; |
|
548 |
- |
|
549 |
-Turn C<from1> type rule off. |
|
550 |
-By default, type rule is on. |
|
551 |
- |
|
552 |
-=head2 C<type_rule1_on> EXPERIMENTAL |
|
553 |
- |
|
554 |
- $result = $result->type_rule1_on; |
|
555 |
- |
|
556 |
-Turn C<from1> type rule on. |
|
557 |
-By default, type rule is on. |
|
558 |
- |
|
559 |
-=head2 C<type_rule2_off> EXPERIMENTAL |
|
560 |
- |
|
561 |
- $result = $result->type_rule2_off; |
|
562 |
- |
|
563 |
-Turn C<from2> type rule off. |
|
564 |
-By default, type rule is on. |
|
565 |
- |
|
566 |
-=head2 C<type_rule2_on> EXPERIMENTAL |
|
567 |
- |
|
568 |
- $result = $result->type_rule2_on; |
|
569 |
- |
|
570 |
-Turn C<from2> type rule on. |
|
571 |
-By default, type rule is on. |
|
572 |
- |
|
573 |
-=cut |
... | ... |
@@ -1,98 +0,0 @@ |
1 |
-package DBIx::Custom::Tag; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use Carp 'croak'; |
|
7 |
-use DBIx::Custom::Util '_subname'; |
|
8 |
- |
|
9 |
-# Carp trust relationship |
|
10 |
-push @DBIx::Custom::QueryBuilder::CARP_NOT, __PACKAGE__; |
|
11 |
- |
|
12 |
-sub equal { _basic('=', @_) } |
|
13 |
-sub greater_than_equal { _basic('>=', @_) } |
|
14 |
-sub greater_than { _basic('>', @_) } |
|
15 |
- |
|
16 |
-sub in { |
|
17 |
- my ($column, $count) = @_; |
|
18 |
- |
|
19 |
- # Check arguments |
|
20 |
- croak qq{Column name and count of values must be specified in tag "{in }" } |
|
21 |
- . _subname |
|
22 |
- unless $column && $count && $count =~ /^\d+$/; |
|
23 |
- |
|
24 |
- # Part of statement |
|
25 |
- my $s = "$column in ("; |
|
26 |
- for (my $i = 0; $i < $count; $i++) { |
|
27 |
- $s .= '?, '; |
|
28 |
- } |
|
29 |
- $s =~ s/, $//; |
|
30 |
- $s .= ')'; |
|
31 |
- |
|
32 |
- # Columns |
|
33 |
- my $columns = []; |
|
34 |
- push @$columns, $column for (0 .. $count - 1); |
|
35 |
- |
|
36 |
- return [$s, $columns]; |
|
37 |
-} |
|
38 |
- |
|
39 |
-sub insert_param { |
|
40 |
- my @columns = @_; |
|
41 |
- |
|
42 |
- # Insert parameters |
|
43 |
- my $s = '('; |
|
44 |
- $s .= "$_, " for @columns; |
|
45 |
- $s =~ s/, $//; |
|
46 |
- $s .= ') '; |
|
47 |
- $s .= 'values ('; |
|
48 |
- $s .= "?, " for @columns; |
|
49 |
- $s =~ s/, $//; |
|
50 |
- $s .= ')'; |
|
51 |
- |
|
52 |
- return [$s, \@columns]; |
|
53 |
-} |
|
54 |
- |
|
55 |
-sub like { _basic('like', @_) } |
|
56 |
-sub lower_than_equal { _basic('<=', @_) } |
|
57 |
-sub lower_than { _basic('<', @_) } |
|
58 |
-sub not_equal { _basic('<>', @_) } |
|
59 |
- |
|
60 |
-sub placeholder { |
|
61 |
- my $column = shift; |
|
62 |
- |
|
63 |
- # Check arguments |
|
64 |
- croak qq{Column name must be specified in tag "{? }" } . _subname |
|
65 |
- unless $column; |
|
66 |
- |
|
67 |
- return ['?', [$column]]; |
|
68 |
-} |
|
69 |
- |
|
70 |
-sub update_param { |
|
71 |
- my @columns = @_; |
|
72 |
- |
|
73 |
- # Update parameters |
|
74 |
- my $s = 'set '; |
|
75 |
- $s .= "$_ = ?, " for @columns; |
|
76 |
- $s =~ s/, $//; |
|
77 |
- |
|
78 |
- return [$s, \@columns]; |
|
79 |
-} |
|
80 |
- |
|
81 |
-sub _basic { |
|
82 |
- my ($name, $column) = @_; |
|
83 |
- |
|
84 |
- # Check arguments |
|
85 |
- croak qq{Column name must be specified in tag "{$name }" } . _subname |
|
86 |
- unless $column; |
|
87 |
- |
|
88 |
- return ["$column $name ?", [$column]]; |
|
89 |
-} |
|
90 |
- |
|
91 |
-1; |
|
92 |
- |
|
93 |
-=head1 NAME |
|
94 |
- |
|
95 |
-DBIx::Custom::Tag - DEPRECATED! |
|
96 |
- |
|
97 |
-=cut |
|
98 |
- |
... | ... |
@@ -1,41 +0,0 @@ |
1 |
-package DBIx::Custom::Util; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'Exporter'; |
|
7 |
- |
|
8 |
-our @EXPORT_OK = qw/_array_to_hash _subname/; |
|
9 |
- |
|
10 |
-sub _array_to_hash { |
|
11 |
- my $array = shift; |
|
12 |
- |
|
13 |
- return $array if ref $array eq 'HASH'; |
|
14 |
- return unless $array; |
|
15 |
- |
|
16 |
- my $hash = {}; |
|
17 |
- |
|
18 |
- for (my $i = 0; $i < @$array; $i += 2) { |
|
19 |
- my $key = $array->[$i]; |
|
20 |
- my $f = $array->[$i + 1]; |
|
21 |
- |
|
22 |
- if (ref $key eq 'ARRAY') { |
|
23 |
- foreach my $k (@$key) { |
|
24 |
- $hash->{$k} = $f; |
|
25 |
- } |
|
26 |
- } |
|
27 |
- else { |
|
28 |
- $hash->{$key} = $f; |
|
29 |
- } |
|
30 |
- } |
|
31 |
- return $hash; |
|
32 |
-} |
|
33 |
- |
|
34 |
-sub _subname { '(' . (caller 1)[3] . ')' } |
|
35 |
- |
|
36 |
-1; |
|
37 |
- |
|
38 |
-=head1 NAME |
|
39 |
- |
|
40 |
-DBIx::Custom::Util - Utility class |
|
41 |
- |
... | ... |
@@ -1,208 +0,0 @@ |
1 |
-package DBIx::Custom::Where; |
|
2 |
-use Object::Simple -base; |
|
3 |
- |
|
4 |
-use Carp 'croak'; |
|
5 |
-use DBIx::Custom::Util '_subname'; |
|
6 |
-use overload 'bool' => sub {1}, fallback => 1; |
|
7 |
-use overload '""' => sub { shift->to_string }, fallback => 1; |
|
8 |
- |
|
9 |
-# Carp trust relationship |
|
10 |
-push @DBIx::Custom::CARP_NOT, __PACKAGE__; |
|
11 |
- |
|
12 |
-has [qw/dbi param/], |
|
13 |
- clause => sub { [] }; |
|
14 |
- |
|
15 |
-sub new { |
|
16 |
- my $self = shift->SUPER::new(@_); |
|
17 |
- |
|
18 |
- # Check attribute names |
|
19 |
- my @attrs = keys %$self; |
|
20 |
- foreach my $attr (@attrs) { |
|
21 |
- croak qq{"$attr" is invalid attribute name (} . _subname . ")" |
|
22 |
- unless $self->can($attr); |
|
23 |
- } |
|
24 |
- |
|
25 |
- return $self; |
|
26 |
-} |
|
27 |
- |
|
28 |
-sub to_string { |
|
29 |
- my $self = shift; |
|
30 |
- |
|
31 |
- # Check if column name is safety character; |
|
32 |
- my $safety = $self->dbi->safety_character; |
|
33 |
- if (ref $self->param eq 'HASH') { |
|
34 |
- foreach my $column (keys %{$self->param}) { |
|
35 |
- croak qq{"$column" is not safety column name (} . _subname . ")" |
|
36 |
- unless $column =~ /^[$safety\.]+$/; |
|
37 |
- } |
|
38 |
- } |
|
39 |
- # Clause |
|
40 |
- my $clause = $self->clause; |
|
41 |
- $clause = ['and', $clause] unless ref $clause eq 'ARRAY'; |
|
42 |
- $clause->[0] = 'and' unless @$clause; |
|
43 |
- |
|
44 |
- # Parse |
|
45 |
- my $where = []; |
|
46 |
- my $count = {}; |
|
47 |
- $self->_parse($clause, $where, $count, 'and'); |
|
48 |
- |
|
49 |
- # Stringify |
|
50 |
- unshift @$where, 'where' if @$where; |
|
51 |
- return join(' ', @$where); |
|
52 |
-} |
|
53 |
- |
|
54 |
-our %VALID_OPERATIONS = map { $_ => 1 } qw/and or/; |
|
55 |
-sub _parse { |
|
56 |
- my ($self, $clause, $where, $count, $op) = @_; |
|
57 |
- |
|
58 |
- # Array |
|
59 |
- if (ref $clause eq 'ARRAY') { |
|
60 |
- |
|
61 |
- # Start |
|
62 |
- push @$where, '('; |
|
63 |
- |
|
64 |
- # Operation |
|
65 |
- my $op = $clause->[0] || ''; |
|
66 |
- croak qq{First argument must be "and" or "or" in where clause } . |
|
67 |
- qq{"$op" is passed} . _subname . ")" |
|
68 |
- unless $VALID_OPERATIONS{$op}; |
|
69 |
- |
|
70 |
- my $pushed_array; |
|
71 |
- # Parse internal clause |
|
72 |
- for (my $i = 1; $i < @$clause; $i++) { |
|
73 |
- my $pushed = $self->_parse($clause->[$i], $where, $count, $op); |
|
74 |
- push @$where, $op if $pushed; |
|
75 |
- $pushed_array = 1 if $pushed; |
|
76 |
- } |
|
77 |
- pop @$where if $where->[-1] eq $op; |
|
78 |
- |
|
79 |
- # Undo |
|
80 |
- if ($where->[-1] eq '(') { |
|
81 |
- pop @$where; |
|
82 |
- pop @$where if ($where->[-1] || '') eq $op; |
|
83 |
- } |
|
84 |
- # End |
|
85 |
- else { push @$where, ')' } |
|
86 |
- |
|
87 |
- return $pushed_array; |
|
88 |
- } |
|
89 |
- |
|
90 |
- # String |
|
91 |
- else { |
|
92 |
- # Pushed |
|
93 |
- my $pushed; |
|
94 |
- |
|
95 |
- # Column |
|
96 |
- my $columns = $self->dbi->query_builder->build_query($clause)->columns; |
|
97 |
- if (@$columns == 0) { |
|
98 |
- push @$where, $clause; |
|
99 |
- $pushed = 1; |
|
100 |
- return $pushed; |
|
101 |
- } |
|
102 |
- elsif (@$columns != 1) { |
|
103 |
- croak qq{Each part contains one column name: "$clause" (} |
|
104 |
- . _subname . ")"; |
|
105 |
- } |
|
106 |
- |
|
107 |
- # Remove quote |
|
108 |
- my $column = $columns->[0]; |
|
109 |
- if (my $q = $self->dbi->_quote) { |
|
110 |
- $q = quotemeta($q); |
|
111 |
- $column =~ s/[$q]//g; |
|
112 |
- } |
|
113 |
- |
|
114 |
- # Check safety |
|
115 |
- my $safety = $self->dbi->safety_character; |
|
116 |
- croak qq{"$column" is not safety column name (} . _subname . ")" |
|
117 |
- unless $column =~ /^[$safety\.]+$/; |
|
118 |
- |
|
119 |
- # Column count up |
|
120 |
- my $count = ++$count->{$column}; |
|
121 |
- |
|
122 |
- # Push |
|
123 |
- my $param = $self->param; |
|
124 |
- if (ref $param eq 'HASH') { |
|
125 |
- if (exists $param->{$column}) { |
|
126 |
- if (ref $param->{$column} eq 'ARRAY') { |
|
127 |
- $pushed = 1 |
|
128 |
- if exists $param->{$column}->[$count - 1] |
|
129 |
- && ref $param->{$column}->[$count - 1] ne 'DBIx::Custom::NotExists'; |
|
130 |
- } |
|
131 |
- elsif ($count == 1) { |
|
132 |
- $pushed = 1; |
|
133 |
- } |
|
134 |
- } |
|
135 |
- push @$where, $clause if $pushed; |
|
136 |
- } |
|
137 |
- elsif (!defined $param) { |
|
138 |
- push @$where, $clause; |
|
139 |
- $pushed = 1; |
|
140 |
- } |
|
141 |
- else { |
|
142 |
- croak "Parameter must be hash reference or undfined value (" |
|
143 |
- . _subname . ")" |
|
144 |
- } |
|
145 |
- return $pushed; |
|
146 |
- } |
|
147 |
- return; |
|
148 |
-} |
|
149 |
- |
|
150 |
-1; |
|
151 |
- |
|
152 |
-=head1 NAME |
|
153 |
- |
|
154 |
-DBIx::Custom::Where - Where clause |
|
155 |
- |
|
156 |
-=head1 SYNOPSYS |
|
157 |
- |
|
158 |
- my $where = DBIx::Custom::Where->new; |
|
159 |
- my $string_where = "$where"; |
|
160 |
- |
|
161 |
-=head1 ATTRIBUTES |
|
162 |
- |
|
163 |
-=head2 C<clause> |
|
164 |
- |
|
165 |
- my $clause = $where->clause; |
|
166 |
- $where = $where->clause( |
|
167 |
- ['and', |
|
168 |
- 'title = :title', |
|
169 |
- ['or', 'date < :date', 'date > :date'] |
|
170 |
- ] |
|
171 |
- ); |
|
172 |
- |
|
173 |
-Where clause. Above one is expanded to the following SQL by to_string |
|
174 |
-If all parameter names is exists. |
|
175 |
- |
|
176 |
- "where ( title = :title and ( date < :date or date > :date ) )" |
|
177 |
- |
|
178 |
-=head2 C<param> |
|
179 |
- |
|
180 |
- my $param = $where->param; |
|
181 |
- $where = $where->param({ |
|
182 |
- title => 'Perl', |
|
183 |
- date => ['2010-11-11', '2011-03-05'], |
|
184 |
- }); |
|
185 |
- |
|
186 |
-=head2 C<dbi> |
|
187 |
- |
|
188 |
- my $dbi = $where->dbi; |
|
189 |
- $where = $where->dbi($dbi); |
|
190 |
- |
|
191 |
-L<DBIx::Custom> object. |
|
192 |
- |
|
193 |
-=head1 METHODS |
|
194 |
- |
|
195 |
-L<DBIx::Custom::Where> inherits all methods from L<Object::Simple> |
|
196 |
-and implements the following new ones. |
|
197 |
- |
|
198 |
-=head2 C<to_string> |
|
199 |
- |
|
200 |
- $where->to_string; |
|
201 |
- |
|
202 |
-Convert where clause to string. |
|
203 |
- |
|
204 |
-double quote is override to execute C<to_string> method. |
|
205 |
- |
|
206 |
- my $string_where = "$where"; |
|
207 |
- |
|
208 |
-=cut |
... | ... |
@@ -1,11 +0,0 @@ |
1 |
-# Change quote for tests |
|
2 |
-use DBIx::Custom; |
|
3 |
-{ |
|
4 |
- package DBIx::Custom; |
|
5 |
- no warnings 'redefine'; |
|
6 |
- sub quote { '""' } |
|
7 |
-} |
|
8 |
- |
|
9 |
-use FindBin; |
|
10 |
- |
|
11 |
-require "$FindBin::Bin/basic.t"; |
... | ... |
@@ -1,3750 +0,0 @@ |
1 |
-use Test::More; |
|
2 |
-use strict; |
|
3 |
-use warnings; |
|
4 |
-use utf8; |
|
5 |
-use Encode qw/encode_utf8 decode_utf8/; |
|
6 |
-use FindBin; |
|
7 |
-use lib "$FindBin::Bin/basic"; |
|
8 |
- |
|
9 |
-BEGIN { |
|
10 |
- eval { require DBD::SQLite; 1 } |
|
11 |
- or plan skip_all => 'DBD::SQLite required'; |
|
12 |
- eval { DBD::SQLite->VERSION >= 1.25 } |
|
13 |
- or plan skip_all => 'DBD::SQLite >= 1.25 required'; |
|
14 |
- |
|
15 |
- plan 'no_plan'; |
|
16 |
- use_ok('DBIx::Custom'); |
|
17 |
-} |
|
18 |
- |
|
19 |
-$SIG{__WARN__} = sub { warn $_[0] unless $_[0] =~ /DEPRECATED/}; |
|
20 |
-sub test { print "# $_[0]\n" } |
|
21 |
- |
|
22 |
-# Constant |
|
23 |
-my %memory = (dsn => 'dbi:SQLite:dbname=:memory:'); |
|
24 |
-my $create_table_default = 'create table table1 (key1 char(255), key2 char(255));'; |
|
25 |
- |
|
26 |
-# Variables |
|
27 |
-my $builder; |
|
28 |
-my $datas; |
|
29 |
-my $dbi; |
|
30 |
-my $sth; |
|
31 |
-my $source; |
|
32 |
-my @sources; |
|
33 |
-my $select_source; |
|
34 |
-my $insert_source; |
|
35 |
-my $update_source; |
|
36 |
-my $param; |
|
37 |
-my $params; |
|
38 |
-my $sql; |
|
39 |
-my $result; |
|
40 |
-my $row; |
|
41 |
-my @rows; |
|
42 |
-my $rows; |
|
43 |
-my $query; |
|
44 |
-my @queries; |
|
45 |
-my $select_query; |
|
46 |
-my $insert_query; |
|
47 |
-my $update_query; |
|
48 |
-my $ret_val; |
|
49 |
-my $infos; |
|
50 |
-my $model; |
|
51 |
-my $model2; |
|
52 |
-my $where; |
|
53 |
-my $update_param; |
|
54 |
-my $insert_param; |
|
55 |
-my $join; |
|
56 |
- |
|
57 |
-# Prepare table |
|
58 |
-$dbi = DBIx::Custom->connect(%memory); |
|
59 |
-$dbi->execute($create_table_default); |
|
60 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
61 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
62 |
- |
|
63 |
-test 'DBIx::Custom::Result test'; |
|
64 |
-$source = "select key1, key2 from table1"; |
|
65 |
-$query = $dbi->create_query($source); |
|
66 |
-$result = $dbi->execute($query); |
|
67 |
- |
|
68 |
-@rows = (); |
|
69 |
-while (my $row = $result->fetch) { |
|
70 |
- push @rows, [@$row]; |
|
71 |
-} |
|
72 |
-is_deeply(\@rows, [[1, 2], [3, 4]], "fetch"); |
|
73 |
- |
|
74 |
-$result = $dbi->execute($query); |
|
75 |
-@rows = (); |
|
76 |
-while (my $row = $result->fetch_hash) { |
|
77 |
- push @rows, {%$row}; |
|
78 |
-} |
|
79 |
-is_deeply(\@rows, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], "fetch_hash"); |
|
80 |
- |
|
81 |
-$result = $dbi->execute($query); |
|
82 |
-$rows = $result->fetch_all; |
|
83 |
-is_deeply($rows, [[1, 2], [3, 4]], "fetch_all"); |
|
84 |
- |
|
85 |
-$result = $dbi->execute($query); |
|
86 |
-$rows = $result->fetch_hash_all; |
|
87 |
-is_deeply($rows, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], "all"); |
|
88 |
- |
|
89 |
-test 'Insert query return value'; |
|
90 |
-$dbi->execute('drop table table1'); |
|
91 |
-$dbi->execute($create_table_default); |
|
92 |
-$source = "insert into table1 {insert_param key1 key2}"; |
|
93 |
-$query = $dbi->execute($source, {}, query => 1); |
|
94 |
-$ret_val = $dbi->execute($query, param => {key1 => 1, key2 => 2}); |
|
95 |
-ok($ret_val); |
|
96 |
- |
|
97 |
- |
|
98 |
-test 'Direct query'; |
|
99 |
-$dbi->execute('drop table table1'); |
|
100 |
-$dbi->execute($create_table_default); |
|
101 |
-$insert_source = "insert into table1 {insert_param key1 key2}"; |
|
102 |
-$dbi->execute($insert_source, param => {key1 => 1, key2 => 2}); |
|
103 |
-$result = $dbi->execute('select * from table1;'); |
|
104 |
-$rows = $result->all; |
|
105 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
106 |
- |
|
107 |
-test 'Filter basic'; |
|
108 |
-$dbi->execute('drop table table1'); |
|
109 |
-$dbi->execute($create_table_default); |
|
110 |
-$dbi->register_filter(twice => sub { $_[0] * 2}, |
|
111 |
- three_times => sub { $_[0] * 3}); |
|
112 |
- |
|
113 |
-$insert_source = "insert into table1 {insert_param key1 key2};"; |
|
114 |
-$insert_query = $dbi->execute($insert_source, {}, query => 1); |
|
115 |
-$insert_query->filter({key1 => 'twice'}); |
|
116 |
-$dbi->execute($insert_query, param => {key1 => 1, key2 => 2}); |
|
117 |
-$result = $dbi->execute('select * from table1;'); |
|
118 |
-$rows = $result->filter({key2 => 'three_times'})->all; |
|
119 |
-is_deeply($rows, [{key1 => 2, key2 => 6}], "filter fetch_filter"); |
|
120 |
-$dbi->execute('drop table table1'); |
|
121 |
- |
|
122 |
-test 'Filter in'; |
|
123 |
-$dbi->execute($create_table_default); |
|
124 |
-$insert_source = "insert into table1 {insert_param key1 key2};"; |
|
125 |
-$insert_query = $dbi->execute($insert_source, {}, query => 1); |
|
126 |
-$dbi->execute($insert_query, param => {key1 => 2, key2 => 4}); |
|
127 |
-$select_source = "select * from table1 where {in table1.key1 2} and {in table1.key2 2}"; |
|
128 |
-$select_query = $dbi->execute($select_source,{}, query => 1); |
|
129 |
-$select_query->filter({'table1.key1' => 'twice'}); |
|
130 |
-$result = $dbi->execute($select_query, param => {'table1.key1' => [1,5], 'table1.key2' => [2,4]}); |
|
131 |
-$rows = $result->all; |
|
132 |
-is_deeply($rows, [{key1 => 2, key2 => 4}], "filter"); |
|
133 |
- |
|
134 |
-test 'DBIx::Custom::SQLTemplate basic tag'; |
|
135 |
-$dbi->execute('drop table table1'); |
|
136 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
137 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
138 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
139 |
- |
|
140 |
-$source = "select * from table1 where key1 = :key1 and {<> key2} and {< key3} and {> key4} and {>= key5};"; |
|
141 |
-$query = $dbi->execute($source, {}, query => 1); |
|
142 |
-$result = $dbi->execute($query, param => {key1 => 1, key2 => 3, key3 => 4, key4 => 3, key5 => 5}); |
|
143 |
-$rows = $result->all; |
|
144 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}], "basic tag1"); |
|
145 |
- |
|
146 |
-$source = "select * from table1 where key1 = :key1 and {<> key2} and {< key3} and {> key4} and {>= key5};"; |
|
147 |
-$query = $dbi->execute($source, {}, query => 1); |
|
148 |
-$result = $dbi->execute($query, {key1 => 1, key2 => 3, key3 => 4, key4 => 3, key5 => 5}); |
|
149 |
-$rows = $result->all; |
|
150 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}], "basic tag1"); |
|
151 |
- |
|
152 |
-$source = "select * from table1 where {<= key1} and {like key2};"; |
|
153 |
-$query = $dbi->execute($source, {}, query => 1); |
|
154 |
-$result = $dbi->execute($query, param => {key1 => 1, key2 => '%2%'}); |
|
155 |
-$rows = $result->all; |
|
156 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}], "basic tag2"); |
|
157 |
- |
|
158 |
-test 'DIB::Custom::SQLTemplate in tag'; |
|
159 |
-$dbi->execute('drop table table1'); |
|
160 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
161 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
162 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
163 |
- |
|
164 |
-$source = "select * from table1 where {in key1 2};"; |
|
165 |
-$query = $dbi->execute($source, {}, query => 1); |
|
166 |
-$result = $dbi->execute($query, param => {key1 => [9, 1]}); |
|
167 |
-$rows = $result->all; |
|
168 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}], "basic"); |
|
169 |
- |
|
170 |
-test 'DBIx::Custom::SQLTemplate insert tag'; |
|
171 |
-$dbi->execute("delete from table1"); |
|
172 |
-$insert_source = 'insert into table1 {insert_param key1 key2 key3 key4 key5}'; |
|
173 |
-$dbi->execute($insert_source, param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
174 |
- |
|
175 |
-$result = $dbi->execute('select * from table1;'); |
|
176 |
-$rows = $result->all; |
|
177 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}], "basic"); |
|
178 |
- |
|
179 |
-test 'DBIx::Custom::SQLTemplate update tag'; |
|
180 |
-$dbi->execute("delete from table1"); |
|
181 |
-$insert_source = "insert into table1 {insert_param key1 key2 key3 key4 key5}"; |
|
182 |
-$dbi->execute($insert_source, param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
183 |
-$dbi->execute($insert_source, param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
184 |
- |
|
185 |
-$update_source = 'update table1 {update_param key1 key2 key3 key4} where {= key5}'; |
|
186 |
-$dbi->execute($update_source, param => {key1 => 1, key2 => 1, key3 => 1, key4 => 1, key5 => 5}); |
|
187 |
- |
|
188 |
-$result = $dbi->execute('select * from table1;'); |
|
189 |
-$rows = $result->all; |
|
190 |
-is_deeply($rows, [{key1 => 1, key2 => 1, key3 => 1, key4 => 1, key5 => 5}, |
|
191 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], "basic"); |
|
192 |
- |
|
193 |
- |
|
194 |
-test 'Named placeholder'; |
|
195 |
-$dbi->execute('drop table table1'); |
|
196 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
197 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
198 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
199 |
- |
|
200 |
-$source = "select * from table1 where key1 = :key1 and key2 = :key2"; |
|
201 |
-$result = $dbi->execute($source, param => {key1 => 1, key2 => 2}); |
|
202 |
-$rows = $result->all; |
|
203 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}]); |
|
204 |
- |
|
205 |
-$source = "select * from table1 where key1 = \n:key1\n and key2 = :key2"; |
|
206 |
-$result = $dbi->execute($source, param => {key1 => 1, key2 => 2}); |
|
207 |
-$rows = $result->all; |
|
208 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}]); |
|
209 |
- |
|
210 |
-$source = "select * from table1 where key1 = :key1 or key1 = :key1"; |
|
211 |
-$result = $dbi->execute($source, param => {key1 => [1, 2]}); |
|
212 |
-$rows = $result->all; |
|
213 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}]); |
|
214 |
- |
|
215 |
-$source = "select * from table1 where key1 = :table1.key1 and key2 = :table1.key2"; |
|
216 |
-$result = $dbi->execute( |
|
217 |
- $source, |
|
218 |
- param => {'table1.key1' => 1, 'table1.key2' => 1}, |
|
219 |
- filter => {'table1.key2' => sub { $_[0] * 2 }} |
|
220 |
-); |
|
221 |
-$rows = $result->all; |
|
222 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}]); |
|
223 |
- |
|
224 |
-$dbi->execute('drop table table1'); |
|
225 |
-$dbi->execute($create_table_default); |
|
226 |
-$dbi->insert(table => 'table1', param => {key1 => '2011-10-14 12:19:18', key2 => 2}); |
|
227 |
-$source = "select * from table1 where key1 = '2011-10-14 12:19:18' and key2 = :key2"; |
|
228 |
-$result = $dbi->execute( |
|
229 |
- $source, |
|
230 |
- param => {'key2' => 2}, |
|
231 |
-); |
|
232 |
- |
|
233 |
-$rows = $result->all; |
|
234 |
-is_deeply($rows, [{key1 => '2011-10-14 12:19:18', key2 => 2}]); |
|
235 |
- |
|
236 |
-$dbi = DBIx::Custom->connect(%memory); |
|
237 |
-$dbi->execute($create_table_default); |
|
238 |
-$dbi->insert(table => 'table1', param => {key1 => 'a:b c:d', key2 => 2}); |
|
239 |
-$source = "select * from table1 where key1 = 'a\\:b c\\:d' and key2 = :key2"; |
|
240 |
-$result = $dbi->execute( |
|
241 |
- $source, |
|
242 |
- param => {'key2' => 2}, |
|
243 |
-); |
|
244 |
-$rows = $result->all; |
|
245 |
-is_deeply($rows, [{key1 => 'a:b c:d', key2 => 2}]); |
|
246 |
- |
|
247 |
- |
|
248 |
-test 'Error case'; |
|
249 |
-eval {DBIx::Custom->connect(dsn => 'dbi:SQLit')}; |
|
250 |
-ok($@, "connect error"); |
|
251 |
- |
|
252 |
-$dbi = DBIx::Custom->connect(%memory); |
|
253 |
-eval{$dbi->execute("{p }", {}, query => 1)}; |
|
254 |
-ok($@, "create_query invalid SQL template"); |
|
255 |
- |
|
256 |
-test 'insert'; |
|
257 |
-$dbi = DBIx::Custom->connect(%memory); |
|
258 |
-$dbi->execute($create_table_default); |
|
259 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
260 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
261 |
-$result = $dbi->execute('select * from table1;'); |
|
262 |
-$rows = $result->all; |
|
263 |
-is_deeply($rows, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], "basic"); |
|
264 |
- |
|
265 |
-$dbi->execute('delete from table1'); |
|
266 |
-$dbi->register_filter( |
|
267 |
- twice => sub { $_[0] * 2 }, |
|
268 |
- three_times => sub { $_[0] * 3 } |
|
269 |
-); |
|
270 |
-$dbi->default_bind_filter('twice'); |
|
271 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}, filter => {key1 => 'three_times'}); |
|
272 |
-$result = $dbi->execute('select * from table1;'); |
|
273 |
-$rows = $result->all; |
|
274 |
-is_deeply($rows, [{key1 => 3, key2 => 4}], "filter"); |
|
275 |
-$dbi->default_bind_filter(undef); |
|
276 |
- |
|
277 |
-$dbi->execute('drop table table1'); |
|
278 |
-$dbi->execute($create_table_default); |
|
279 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}, append => ' '); |
|
280 |
-$rows = $dbi->select(table => 'table1')->all; |
|
281 |
-is_deeply($rows, [{key1 => 1, key2 => 2}], 'insert append'); |
|
282 |
- |
|
283 |
-eval{$dbi->insert(table => 'table1', noexist => 1)}; |
|
284 |
-like($@, qr/noexist/, "invalid"); |
|
285 |
- |
|
286 |
-eval{$dbi->insert(table => 'table', param => {';' => 1})}; |
|
287 |
-like($@, qr/safety/); |
|
288 |
- |
|
289 |
-$dbi = DBIx::Custom->connect(%memory); |
|
290 |
-$dbi->quote('"'); |
|
291 |
-$dbi->execute('create table "table" ("select")'); |
|
292 |
-$dbi->apply_filter('table', select => {out => sub { $_[0] * 2}}); |
|
293 |
-$dbi->insert(table => 'table', param => {select => 1}); |
|
294 |
-$result = $dbi->execute('select * from "table"'); |
|
295 |
-$rows = $result->all; |
|
296 |
-is_deeply($rows, [{select => 2}], "reserved word"); |
|
297 |
- |
|
298 |
-$dbi = DBIx::Custom->connect(%memory); |
|
299 |
-$dbi->execute($create_table_default); |
|
300 |
-$dbi->insert({key1 => 1, key2 => 2}, table => 'table1'); |
|
301 |
-$dbi->insert({key1 => 3, key2 => 4}, table => 'table1'); |
|
302 |
-$result = $dbi->execute('select * from table1;'); |
|
303 |
-$rows = $result->all; |
|
304 |
-is_deeply($rows, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], "basic"); |
|
305 |
- |
|
306 |
-$dbi = DBIx::Custom->connect(%memory); |
|
307 |
-$dbi->execute("create table table1 (key1 char(255), key2 char(255), primary key(key1))"); |
|
308 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
309 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 4}, prefix => 'or replace'); |
|
310 |
-$result = $dbi->execute('select * from table1;'); |
|
311 |
-$rows = $result->all; |
|
312 |
-is_deeply($rows, [{key1 => 1, key2 => 4}], "basic"); |
|
313 |
- |
|
314 |
-$dbi = DBIx::Custom->connect(%memory); |
|
315 |
-$dbi->execute($create_table_default); |
|
316 |
-$dbi->insert(table => 'table1', param => {key1 => \"'1'", key2 => 2}); |
|
317 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
318 |
-$result = $dbi->execute('select * from table1;'); |
|
319 |
-$rows = $result->all; |
|
320 |
-is_deeply($rows, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], "basic"); |
|
321 |
- |
|
322 |
-test 'update'; |
|
323 |
-$dbi = DBIx::Custom->connect(%memory); |
|
324 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
325 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
326 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
327 |
-$dbi->update(table => 'table1', param => {key2 => 11}, where => {key1 => 1}); |
|
328 |
-$result = $dbi->execute('select * from table1;'); |
|
329 |
-$rows = $result->all; |
|
330 |
-is_deeply($rows, [{key1 => 1, key2 => 11, key3 => 3, key4 => 4, key5 => 5}, |
|
331 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
332 |
- "basic"); |
|
333 |
- |
|
334 |
-$dbi->execute("delete from table1"); |
|
335 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
336 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
337 |
-$dbi->update(table => 'table1', param => {key2 => 12}, where => {key2 => 2, key3 => 3}); |
|
338 |
-$result = $dbi->execute('select * from table1;'); |
|
339 |
-$rows = $result->all; |
|
340 |
-is_deeply($rows, [{key1 => 1, key2 => 12, key3 => 3, key4 => 4, key5 => 5}, |
|
341 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
342 |
- "update key same as search key"); |
|
343 |
- |
|
344 |
-$dbi->update(table => 'table1', param => {key2 => [12]}, where => {key2 => 2, key3 => 3}); |
|
345 |
-$result = $dbi->execute('select * from table1;'); |
|
346 |
-$rows = $result->all; |
|
347 |
-is_deeply($rows, [{key1 => 1, key2 => 12, key3 => 3, key4 => 4, key5 => 5}, |
|
348 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
349 |
- "update key same as search key : param is array ref"); |
|
350 |
- |
|
351 |
-$dbi->execute("delete from table1"); |
|
352 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
353 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
354 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
355 |
-$dbi->update(table => 'table1', param => {key2 => 11}, where => {key1 => 1}, |
|
356 |
- filter => {key2 => sub { $_[0] * 2 }}); |
|
357 |
-$result = $dbi->execute('select * from table1;'); |
|
358 |
-$rows = $result->all; |
|
359 |
-is_deeply($rows, [{key1 => 1, key2 => 22, key3 => 3, key4 => 4, key5 => 5}, |
|
360 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
361 |
- "filter"); |
|
362 |
- |
|
363 |
-$result = $dbi->update(table => 'table1', param => {key2 => 11}, where => {key1 => 1}, append => ' '); |
|
364 |
- |
|
365 |
-eval{$dbi->update(table => 'table1', where => {key1 => 1}, noexist => 1)}; |
|
366 |
-like($@, qr/noexist/, "invalid"); |
|
367 |
- |
|
368 |
-eval{$dbi->update(table => 'table1')}; |
|
369 |
-like($@, qr/where/, "not contain where"); |
|
370 |
- |
|
371 |
-$dbi = DBIx::Custom->connect(%memory); |
|
372 |
-$dbi->execute($create_table_default); |
|
373 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
374 |
-$where = $dbi->where; |
|
375 |
-$where->clause(['and', 'key1 = :key1', 'key2 = :key2']); |
|
376 |
-$where->param({key1 => 1, key2 => 2}); |
|
377 |
-$dbi->update(table => 'table1', param => {key1 => 3}, where => $where); |
|
378 |
-$result = $dbi->select(table => 'table1'); |
|
379 |
-is_deeply($result->all, [{key1 => 3, key2 => 2}], 'update() where'); |
|
380 |
- |
|
381 |
-$dbi = DBIx::Custom->connect(%memory); |
|
382 |
-$dbi->execute($create_table_default); |
|
383 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
384 |
-$dbi->update( |
|
385 |
- table => 'table1', |
|
386 |
- param => {key1 => 3}, |
|
387 |
- where => [ |
|
388 |
- ['and', 'key1 = :key1', 'key2 = :key2'], |
|
389 |
- {key1 => 1, key2 => 2} |
|
390 |
- ] |
|
391 |
-); |
|
392 |
-$result = $dbi->select(table => 'table1'); |
|
393 |
-is_deeply($result->all, [{key1 => 3, key2 => 2}], 'update() where'); |
|
394 |
- |
|
395 |
-$dbi = DBIx::Custom->connect(%memory); |
|
396 |
-$dbi->execute($create_table_default); |
|
397 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
398 |
-$where = $dbi->where; |
|
399 |
-$where->clause(['and', 'key2 = :key2']); |
|
400 |
-$where->param({key2 => 2}); |
|
401 |
-$dbi->update(table => 'table1', param => {key1 => 3}, where => $where); |
|
402 |
-$result = $dbi->select(table => 'table1'); |
|
403 |
-is_deeply($result->all, [{key1 => 3, key2 => 2}], 'update() where'); |
|
404 |
- |
|
405 |
-eval{$dbi->update(table => 'table1', param => {';' => 1})}; |
|
406 |
-like($@, qr/safety/); |
|
407 |
- |
|
408 |
-eval{$dbi->update(table => 'table1', param => {'key1' => 1}, where => {';' => 1})}; |
|
409 |
-like($@, qr/safety/); |
|
410 |
- |
|
411 |
-$dbi = DBIx::Custom->connect(%memory); |
|
412 |
-$dbi->quote('"'); |
|
413 |
-$dbi->execute('create table "table" ("select", "update")'); |
|
414 |
-$dbi->apply_filter('table', select => {out => sub { $_[0] * 2}}); |
|
415 |
-$dbi->apply_filter('table', update => {out => sub { $_[0] * 3}}); |
|
416 |
-$dbi->insert(table => 'table', param => {select => 1}); |
|
417 |
-$dbi->update(table => 'table', where => {select => 1}, param => {update => 2}); |
|
418 |
-$result = $dbi->execute('select * from "table"'); |
|
419 |
-$rows = $result->all; |
|
420 |
-is_deeply($rows, [{select => 2, update => 6}], "reserved word"); |
|
421 |
- |
|
422 |
-eval {$dbi->update_all(table => 'table', param => {';' => 2}) }; |
|
423 |
-like($@, qr/safety/); |
|
424 |
- |
|
425 |
-$dbi = DBIx::Custom->connect(%memory); |
|
426 |
-$dbi->reserved_word_quote('"'); |
|
427 |
-$dbi->execute('create table "table" ("select", "update")'); |
|
428 |
-$dbi->apply_filter('table', select => {out => sub { $_[0] * 2}}); |
|
429 |
-$dbi->apply_filter('table', update => {out => sub { $_[0] * 3}}); |
|
430 |
-$dbi->insert(table => 'table', param => {select => 1}); |
|
431 |
-$dbi->update(table => 'table', where => {'table.select' => 1}, param => {update => 2}); |
|
432 |
-$result = $dbi->execute('select * from "table"'); |
|
433 |
-$rows = $result->all; |
|
434 |
-is_deeply($rows, [{select => 2, update => 6}], "reserved word"); |
|
435 |
- |
|
436 |
-$dbi = DBIx::Custom->connect(%memory); |
|
437 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
438 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
439 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
440 |
-$dbi->update({key2 => 11}, table => 'table1', where => {key1 => 1}); |
|
441 |
-$result = $dbi->execute('select * from table1;'); |
|
442 |
-$rows = $result->all; |
|
443 |
-is_deeply($rows, [{key1 => 1, key2 => 11, key3 => 3, key4 => 4, key5 => 5}, |
|
444 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
445 |
- "basic"); |
|
446 |
- |
|
447 |
-$dbi = DBIx::Custom->connect(%memory); |
|
448 |
-$dbi->execute("create table table1 (key1 char(255), key2 char(255), primary key(key1))"); |
|
449 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
450 |
-$dbi->update(table => 'table1', param => {key2 => 4}, |
|
451 |
- where => {key1 => 1}, prefix => 'or replace'); |
|
452 |
-$result = $dbi->execute('select * from table1;'); |
|
453 |
-$rows = $result->all; |
|
454 |
-is_deeply($rows, [{key1 => 1, key2 => 4}], "basic"); |
|
455 |
- |
|
456 |
-$dbi = DBIx::Custom->connect(%memory); |
|
457 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
458 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
459 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
460 |
-$dbi->update(table => 'table1', param => {key2 => \"'11'"}, where => {key1 => 1}); |
|
461 |
-$result = $dbi->execute('select * from table1;'); |
|
462 |
-$rows = $result->all; |
|
463 |
-is_deeply($rows, [{key1 => 1, key2 => 11, key3 => 3, key4 => 4, key5 => 5}, |
|
464 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
465 |
- "basic"); |
|
466 |
- |
|
467 |
-test 'update_all'; |
|
468 |
-$dbi = DBIx::Custom->connect(%memory); |
|
469 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
470 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
471 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
472 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
473 |
-$dbi->update_all(table => 'table1', param => {key2 => 10}, filter => {key2 => 'twice'}); |
|
474 |
-$result = $dbi->execute('select * from table1;'); |
|
475 |
-$rows = $result->all; |
|
476 |
-is_deeply($rows, [{key1 => 1, key2 => 20, key3 => 3, key4 => 4, key5 => 5}, |
|
477 |
- {key1 => 6, key2 => 20, key3 => 8, key4 => 9, key5 => 10}], |
|
478 |
- "filter"); |
|
479 |
- |
|
480 |
- |
|
481 |
-test 'delete'; |
|
482 |
-$dbi = DBIx::Custom->connect(%memory); |
|
483 |
-$dbi->execute($create_table_default); |
|
484 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
485 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
486 |
-$dbi->delete(table => 'table1', where => {key1 => 1}); |
|
487 |
-$result = $dbi->execute('select * from table1;'); |
|
488 |
-$rows = $result->all; |
|
489 |
-is_deeply($rows, [{key1 => 3, key2 => 4}], "basic"); |
|
490 |
- |
|
491 |
-$dbi->execute("delete from table1;"); |
|
492 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
493 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
494 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
495 |
-$dbi->delete(table => 'table1', where => {key2 => 1}, filter => {key2 => 'twice'}); |
|
496 |
-$result = $dbi->execute('select * from table1;'); |
|
497 |
-$rows = $result->all; |
|
498 |
-is_deeply($rows, [{key1 => 3, key2 => 4}], "filter"); |
|
499 |
- |
|
500 |
-$dbi->delete(table => 'table1', where => {key1 => 1}, append => ' '); |
|
501 |
- |
|
502 |
-$dbi->delete_all(table => 'table1'); |
|
503 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
504 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
505 |
-$dbi->delete(table => 'table1', where => {key1 => 1, key2 => 2}); |
|
506 |
-$rows = $dbi->select(table => 'table1')->all; |
|
507 |
-is_deeply($rows, [{key1 => 3, key2 => 4}], "delete multi key"); |
|
508 |
- |
|
509 |
-eval{$dbi->delete(table => 'table1', where => {key1 => 1}, noexist => 1)}; |
|
510 |
-like($@, qr/noexist/, "invalid"); |
|
511 |
- |
|
512 |
-$dbi = DBIx::Custom->connect(%memory); |
|
513 |
-$dbi->execute($create_table_default); |
|
514 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
515 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
516 |
-$where = $dbi->where; |
|
517 |
-$where->clause(['and', 'key1 = :key1', 'key2 = :key2']); |
|
518 |
-$where->param({ke1 => 1, key2 => 2}); |
|
519 |
-$dbi->delete(table => 'table1', where => $where); |
|
520 |
-$result = $dbi->select(table => 'table1'); |
|
521 |
-is_deeply($result->all, [{key1 => 3, key2 => 4}], 'delete() where'); |
|
522 |
- |
|
523 |
-$dbi = DBIx::Custom->connect(%memory); |
|
524 |
-$dbi->execute($create_table_default); |
|
525 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
526 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
527 |
-$dbi->delete( |
|
528 |
- table => 'table1', |
|
529 |
- where => [ |
|
530 |
- ['and', 'key1 = :key1', 'key2 = :key2'], |
|
531 |
- {ke1 => 1, key2 => 2} |
|
532 |
- ] |
|
533 |
-); |
|
534 |
-$result = $dbi->select(table => 'table1'); |
|
535 |
-is_deeply($result->all, [{key1 => 3, key2 => 4}], 'delete() where'); |
|
536 |
- |
|
537 |
-$dbi = DBIx::Custom->connect(%memory); |
|
538 |
-$dbi->execute("create table table1 (key1 char(255), key2 char(255), primary key(key1))"); |
|
539 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
540 |
-$dbi->delete(table => 'table1', where => {key1 => 1}, prefix => ' '); |
|
541 |
-$result = $dbi->execute('select * from table1;'); |
|
542 |
-$rows = $result->all; |
|
543 |
-is_deeply($rows, [], "basic"); |
|
544 |
- |
|
545 |
-test 'delete error'; |
|
546 |
-$dbi = DBIx::Custom->connect(%memory); |
|
547 |
-$dbi->execute($create_table_default); |
|
548 |
-eval{$dbi->delete(table => 'table1')}; |
|
549 |
-like($@, qr/"where" must be specified/, |
|
550 |
- "where key-value pairs not specified"); |
|
551 |
- |
|
552 |
-eval{$dbi->delete(table => 'table1', where => {';' => 1})}; |
|
553 |
-like($@, qr/safety/); |
|
554 |
- |
|
555 |
-$dbi = DBIx::Custom->connect(%memory); |
|
556 |
-$dbi->quote('"'); |
|
557 |
-$dbi->execute('create table "table" ("select", "update")'); |
|
558 |
-$dbi->apply_filter('table', select => {out => sub { $_[0] * 2}}); |
|
559 |
-$dbi->insert(table => 'table', param => {select => 1}); |
|
560 |
-$dbi->delete(table => 'table', where => {select => 1}); |
|
561 |
-$result = $dbi->execute('select * from "table"'); |
|
562 |
-$rows = $result->all; |
|
563 |
-is_deeply($rows, [], "reserved word"); |
|
564 |
- |
|
565 |
-test 'delete_all'; |
|
566 |
-$dbi = DBIx::Custom->connect(%memory); |
|
567 |
-$dbi->execute($create_table_default); |
|
568 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
569 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
570 |
-$dbi->delete_all(table => 'table1'); |
|
571 |
-$result = $dbi->execute('select * from table1;'); |
|
572 |
-$rows = $result->all; |
|
573 |
-is_deeply($rows, [], "basic"); |
|
574 |
- |
|
575 |
- |
|
576 |
-test 'select'; |
|
577 |
-$dbi = DBIx::Custom->connect(%memory); |
|
578 |
-$dbi->execute($create_table_default); |
|
579 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
580 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
581 |
-$rows = $dbi->select(table => 'table1')->all; |
|
582 |
-is_deeply($rows, [{key1 => 1, key2 => 2}, |
|
583 |
- {key1 => 3, key2 => 4}], "table"); |
|
584 |
- |
|
585 |
-$rows = $dbi->select(table => 'table1', column => ['key1'])->all; |
|
586 |
-is_deeply($rows, [{key1 => 1}, {key1 => 3}], "table and columns and where key"); |
|
587 |
- |
|
588 |
-$rows = $dbi->select(table => 'table1', where => {key1 => 1})->all; |
|
589 |
-is_deeply($rows, [{key1 => 1, key2 => 2}], "table and columns and where key"); |
|
590 |
- |
|
591 |
-$rows = $dbi->select(table => 'table1', column => ['key1'], where => {key1 => 3})->all; |
|
592 |
-is_deeply($rows, [{key1 => 3}], "table and columns and where key"); |
|
593 |
- |
|
594 |
-$rows = $dbi->select(table => 'table1', append => "order by key1 desc limit 1")->all; |
|
595 |
-is_deeply($rows, [{key1 => 3, key2 => 4}], "append statement"); |
|
596 |
- |
|
597 |
-$dbi->register_filter(decrement => sub { $_[0] - 1 }); |
|
598 |
-$rows = $dbi->select(table => 'table1', where => {key1 => 2}, filter => {key1 => 'decrement'}) |
|
599 |
- ->all; |
|
600 |
-is_deeply($rows, [{key1 => 1, key2 => 2}], "filter"); |
|
601 |
- |
|
602 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
603 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 5}); |
|
604 |
-$rows = $dbi->select( |
|
605 |
- table => [qw/table1 table2/], |
|
606 |
- column => 'table1.key1 as table1_key1, table2.key1 as table2_key1, key2, key3', |
|
607 |
- where => {'table1.key2' => 2}, |
|
608 |
- relation => {'table1.key1' => 'table2.key1'} |
|
609 |
-)->all; |
|
610 |
-is_deeply($rows, [{table1_key1 => 1, table2_key1 => 1, key2 => 2, key3 => 5}], "relation : exists where"); |
|
611 |
- |
|
612 |
-$rows = $dbi->select( |
|
613 |
- table => [qw/table1 table2/], |
|
614 |
- column => ['table1.key1 as table1_key1', 'table2.key1 as table2_key1', 'key2', 'key3'], |
|
615 |
- relation => {'table1.key1' => 'table2.key1'} |
|
616 |
-)->all; |
|
617 |
-is_deeply($rows, [{table1_key1 => 1, table2_key1 => 1, key2 => 2, key3 => 5}], "relation : no exists where"); |
|
618 |
- |
|
619 |
-eval{$dbi->select(table => 'table1', noexist => 1)}; |
|
620 |
-like($@, qr/noexist/, "invalid"); |
|
621 |
- |
|
622 |
-$dbi = DBIx::Custom->connect(%memory); |
|
623 |
-$dbi->quote('"'); |
|
624 |
-$dbi->execute('create table "table" ("select", "update")'); |
|
625 |
-$dbi->apply_filter('table', select => {out => sub { $_[0] * 2}}); |
|
626 |
-$dbi->insert(table => 'table', param => {select => 1, update => 2}); |
|
627 |
-$result = $dbi->select(table => 'table', where => {select => 1}); |
|
628 |
-$rows = $result->all; |
|
629 |
-is_deeply($rows, [{select => 2, update => 2}], "reserved word"); |
|
630 |
- |
|
631 |
-test 'fetch filter'; |
|
632 |
-$dbi = DBIx::Custom->connect(%memory); |
|
633 |
-$dbi->register_filter( |
|
634 |
- twice => sub { $_[0] * 2 }, |
|
635 |
- three_times => sub { $_[0] * 3 } |
|
636 |
-); |
|
637 |
-$dbi->default_fetch_filter('twice'); |
|
638 |
-$dbi->execute($create_table_default); |
|
639 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
640 |
-$result = $dbi->select(table => 'table1'); |
|
641 |
-$result->filter({key1 => 'three_times'}); |
|
642 |
-$row = $result->one; |
|
643 |
-is_deeply($row, {key1 => 3, key2 => 4}, "default_fetch_filter and filter"); |
|
644 |
- |
|
645 |
-test 'filters'; |
|
646 |
-$dbi = DBIx::Custom->new; |
|
647 |
- |
|
648 |
-is($dbi->filters->{decode_utf8}->(encode_utf8('あ')), |
|
649 |
- 'あ', "decode_utf8"); |
|
650 |
- |
|
651 |
-is($dbi->filters->{encode_utf8}->('あ'), |
|
652 |
- encode_utf8('あ'), "encode_utf8"); |
|
653 |
- |
|
654 |
-test 'transaction'; |
|
655 |
-$dbi = DBIx::Custom->connect(%memory); |
|
656 |
-$dbi->execute($create_table_default); |
|
657 |
-$dbi->dbh->begin_work; |
|
658 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
659 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 3}); |
|
660 |
-$dbi->dbh->commit; |
|
661 |
-$result = $dbi->select(table => 'table1'); |
|
662 |
-is_deeply(scalar $result->all, [{key1 => 1, key2 => 2}, {key1 => 2, key2 => 3}], |
|
663 |
- "commit"); |
|
664 |
- |
|
665 |
-$dbi = DBIx::Custom->connect(%memory); |
|
666 |
-$dbi->execute($create_table_default); |
|
667 |
-$dbi->dbh->begin_work(0); |
|
668 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
669 |
-$dbi->dbh->rollback; |
|
670 |
- |
|
671 |
-$result = $dbi->select(table => 'table1'); |
|
672 |
-ok(! $result->fetch_first, "rollback"); |
|
673 |
- |
|
674 |
-test 'cache'; |
|
675 |
-$dbi = DBIx::Custom->connect(%memory); |
|
676 |
-$dbi->cache(1); |
|
677 |
-$dbi->execute($create_table_default); |
|
678 |
-$source = 'select * from table1 where key1 = :key1 and key2 = :key2;'; |
|
679 |
-$dbi->execute($source, {}, query => 1); |
|
680 |
-is_deeply($dbi->{_cached}->{$source}, |
|
681 |
- {sql => "select * from table1 where key1 = ? and key2 = ?;", columns => ['key1', 'key2'], tables => []}, "cache"); |
|
682 |
- |
|
683 |
-$dbi = DBIx::Custom->connect(%memory); |
|
684 |
-$dbi->execute($create_table_default); |
|
685 |
-$dbi->{_cached} = {}; |
|
686 |
-$dbi->cache(0); |
|
687 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
688 |
-is(scalar keys %{$dbi->{_cached}}, 0, 'not cache'); |
|
689 |
- |
|
690 |
-test 'execute'; |
|
691 |
-$dbi = DBIx::Custom->connect(%memory); |
|
692 |
-$dbi->execute($create_table_default); |
|
693 |
-{ |
|
694 |
- local $Carp::Verbose = 0; |
|
695 |
- eval{$dbi->execute('select * frm table1')}; |
|
696 |
- like($@, qr/\Qselect * frm table1;/, "fail prepare"); |
|
697 |
- like($@, qr/\.t /, "fail : not verbose"); |
|
698 |
-} |
|
699 |
-{ |
|
700 |
- local $Carp::Verbose = 1; |
|
701 |
- eval{$dbi->execute('select * frm table1')}; |
|
702 |
- like($@, qr/Custom.*\.t /s, "fail : verbose"); |
|
703 |
-} |
|
704 |
- |
|
705 |
-eval{$dbi->execute('select * from table1', no_exists => 1)}; |
|
706 |
-like($@, qr/wrong/, "invald SQL"); |
|
707 |
- |
|
708 |
-$query = $dbi->execute('select * from table1 where key1 = :key1', {}, query => 1); |
|
709 |
-$dbi->dbh->disconnect; |
|
710 |
-eval{$dbi->execute($query, param => {key1 => {a => 1}})}; |
|
711 |
-ok($@, "execute fail"); |
|
712 |
- |
|
713 |
-{ |
|
714 |
- local $Carp::Verbose = 0; |
|
715 |
- eval{$dbi->execute('select * from table1 where {0 key1}', {}, query => 1)}; |
|
716 |
- like($@, qr/\Q.t /, "caller spec : not vebose"); |
|
717 |
-} |
|
718 |
-{ |
|
719 |
- local $Carp::Verbose = 1; |
|
720 |
- eval{$dbi->execute('select * from table1 where {0 key1}', {}, query => 1)}; |
|
721 |
- like($@, qr/QueryBuilder.*\.t /s, "caller spec : not vebose"); |
|
722 |
-} |
|
723 |
- |
|
724 |
- |
|
725 |
-test 'transaction'; |
|
726 |
-$dbi = DBIx::Custom->connect(%memory); |
|
727 |
-$dbi->execute($create_table_default); |
|
728 |
- |
|
729 |
-$dbi->begin_work; |
|
730 |
- |
|
731 |
-eval { |
|
732 |
- $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
733 |
- die "Error"; |
|
734 |
- $dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
735 |
-}; |
|
736 |
- |
|
737 |
-$dbi->rollback if $@; |
|
738 |
- |
|
739 |
-$result = $dbi->select(table => 'table1'); |
|
740 |
-$rows = $result->all; |
|
741 |
-is_deeply($rows, [], "rollback"); |
|
742 |
- |
|
743 |
-$dbi->begin_work; |
|
744 |
- |
|
745 |
-eval { |
|
746 |
- $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
747 |
- $dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
748 |
-}; |
|
749 |
- |
|
750 |
-$dbi->commit unless $@; |
|
751 |
- |
|
752 |
-$result = $dbi->select(table => 'table1'); |
|
753 |
-$rows = $result->all; |
|
754 |
-is_deeply($rows, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], "commit"); |
|
755 |
- |
|
756 |
-$dbi->dbh->{AutoCommit} = 0; |
|
757 |
-eval{ $dbi->begin_work }; |
|
758 |
-ok($@, "exception"); |
|
759 |
-$dbi->dbh->{AutoCommit} = 1; |
|
760 |
- |
|
761 |
- |
|
762 |
-test 'method'; |
|
763 |
-$dbi = DBIx::Custom->connect(%memory); |
|
764 |
-$dbi->method( |
|
765 |
- one => sub { 1 } |
|
766 |
-); |
|
767 |
-$dbi->method( |
|
768 |
- two => sub { 2 } |
|
769 |
-); |
|
770 |
-$dbi->method({ |
|
771 |
- twice => sub { |
|
772 |
- my $self = shift; |
|
773 |
- return $_[0] * 2; |
|
774 |
- } |
|
775 |
-}); |
|
776 |
- |
|
777 |
-is($dbi->one, 1, "first"); |
|
778 |
-is($dbi->two, 2, "second"); |
|
779 |
-is($dbi->twice(5), 10 , "second"); |
|
780 |
- |
|
781 |
-eval {$dbi->XXXXXX}; |
|
782 |
-ok($@, "not exists"); |
|
783 |
- |
|
784 |
-test 'out filter'; |
|
785 |
-$dbi = DBIx::Custom->connect(%memory); |
|
786 |
-$dbi->execute($create_table_default); |
|
787 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
788 |
-$dbi->register_filter(three_times => sub { $_[0] * 3}); |
|
789 |
-$dbi->apply_filter( |
|
790 |
- 'table1', 'key1' => {out => 'twice', in => 'three_times'}, |
|
791 |
- 'key2' => {out => 'three_times', in => 'twice'}); |
|
792 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
793 |
-$result = $dbi->execute('select * from table1;'); |
|
794 |
-$row = $result->fetch_hash_first; |
|
795 |
-is_deeply($row, {key1 => 2, key2 => 6}, "insert"); |
|
796 |
-$result = $dbi->select(table => 'table1'); |
|
797 |
-$row = $result->one; |
|
798 |
-is_deeply($row, {key1 => 6, key2 => 12}, "insert"); |
|
799 |
- |
|
800 |
-$dbi = DBIx::Custom->connect(%memory); |
|
801 |
-$dbi->execute($create_table_default); |
|
802 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
803 |
-$dbi->register_filter(three_times => sub { $_[0] * 3}); |
|
804 |
-$dbi->apply_filter( |
|
805 |
- 'table1', 'key1' => {out => 'twice', in => 'three_times'}, |
|
806 |
- 'key2' => {out => 'three_times', in => 'twice'}); |
|
807 |
-$dbi->apply_filter( |
|
808 |
- 'table1', 'key1' => {out => undef} |
|
809 |
-); |
|
810 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
811 |
-$result = $dbi->execute('select * from table1;'); |
|
812 |
-$row = $result->one; |
|
813 |
-is_deeply($row, {key1 => 1, key2 => 6}, "insert"); |
|
814 |
- |
|
815 |
-$dbi = DBIx::Custom->connect(%memory); |
|
816 |
-$dbi->execute($create_table_default); |
|
817 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
818 |
-$dbi->apply_filter( |
|
819 |
- 'table1', 'key1' => {out => 'twice', in => 'twice'} |
|
820 |
-); |
|
821 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}, filter => {key1 => undef}); |
|
822 |
-$dbi->update(table => 'table1', param => {key1 => 2}, where => {key2 => 2}); |
|
823 |
-$result = $dbi->execute('select * from table1;'); |
|
824 |
-$row = $result->one; |
|
825 |
-is_deeply($row, {key1 => 4, key2 => 2}, "update"); |
|
826 |
- |
|
827 |
-$dbi = DBIx::Custom->connect(%memory); |
|
828 |
-$dbi->execute($create_table_default); |
|
829 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
830 |
-$dbi->apply_filter( |
|
831 |
- 'table1', 'key1' => {out => 'twice', in => 'twice'} |
|
832 |
-); |
|
833 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 2}, filter => {key1=> undef}); |
|
834 |
-$dbi->delete(table => 'table1', where => {key1 => 1}); |
|
835 |
-$result = $dbi->execute('select * from table1;'); |
|
836 |
-$rows = $result->all; |
|
837 |
-is_deeply($rows, [], "delete"); |
|
838 |
- |
|
839 |
-$dbi = DBIx::Custom->connect(%memory); |
|
840 |
-$dbi->execute($create_table_default); |
|
841 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
842 |
-$dbi->apply_filter( |
|
843 |
- 'table1', 'key1' => {out => 'twice', in => 'twice'} |
|
844 |
-); |
|
845 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 2}, filter => {key1 => undef}); |
|
846 |
-$result = $dbi->select(table => 'table1', where => {key1 => 1}); |
|
847 |
-$result->filter({'key2' => 'twice'}); |
|
848 |
-$rows = $result->all; |
|
849 |
-is_deeply($rows, [{key1 => 4, key2 => 4}], "select"); |
|
850 |
- |
|
851 |
-$dbi = DBIx::Custom->connect(%memory); |
|
852 |
-$dbi->execute($create_table_default); |
|
853 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
854 |
-$dbi->apply_filter( |
|
855 |
- 'table1', 'key1' => {out => 'twice', in => 'twice'} |
|
856 |
-); |
|
857 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 2}, filter => {key1 => undef}); |
|
858 |
-$result = $dbi->execute("select * from table1 where key1 = :key1 and key2 = :key2;", |
|
859 |
- param => {key1 => 1, key2 => 2}, |
|
860 |
- table => ['table1']); |
|
861 |
-$rows = $result->all; |
|
862 |
-is_deeply($rows, [{key1 => 4, key2 => 2}], "execute"); |
|
863 |
- |
|
864 |
-$dbi = DBIx::Custom->connect(%memory); |
|
865 |
-$dbi->execute($create_table_default); |
|
866 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
867 |
-$dbi->apply_filter( |
|
868 |
- 'table1', 'key1' => {out => 'twice', in => 'twice'} |
|
869 |
-); |
|
870 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 2}, filter => {key1 => undef}); |
|
871 |
-$result = $dbi->execute("select * from {table table1} where key1 = :key1 and key2 = :key2;", |
|
872 |
- param => {key1 => 1, key2 => 2}); |
|
873 |
-$rows = $result->all; |
|
874 |
-is_deeply($rows, [{key1 => 4, key2 => 2}], "execute table tag"); |
|
875 |
- |
|
876 |
-$dbi = DBIx::Custom->connect(%memory); |
|
877 |
-$dbi->execute($create_table_default); |
|
878 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
879 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
880 |
-$dbi->register_filter(three_times => sub { $_[0] * 3 }); |
|
881 |
-$dbi->apply_filter( |
|
882 |
- 'table1', 'key2' => {out => 'twice', in => 'twice'} |
|
883 |
-); |
|
884 |
-$dbi->apply_filter( |
|
885 |
- 'table2', 'key3' => {out => 'three_times', in => 'three_times'} |
|
886 |
-); |
|
887 |
-$dbi->insert(table => 'table1', param => {key1 => 5, key2 => 2}, filter => {key2 => undef}); |
|
888 |
-$dbi->insert(table => 'table2', param => {key1 => 5, key3 => 6}, filter => {key3 => undef}); |
|
889 |
-$result = $dbi->select( |
|
890 |
- table => ['table1', 'table2'], |
|
891 |
- column => ['key2', 'key3'], |
|
892 |
- where => {'table1.key2' => 1, 'table2.key3' => 2}, relation => {'table1.key1' => 'table2.key1'}); |
|
893 |
- |
|
894 |
-$result->filter({'key2' => 'twice'}); |
|
895 |
-$rows = $result->all; |
|
896 |
-is_deeply($rows, [{key2 => 4, key3 => 18}], "select : join"); |
|
897 |
- |
|
898 |
-$result = $dbi->select( |
|
899 |
- table => ['table1', 'table2'], |
|
900 |
- column => ['key2', 'key3'], |
|
901 |
- where => {'key2' => 1, 'key3' => 2}, relation => {'table1.key1' => 'table2.key1'}); |
|
902 |
- |
|
903 |
-$result->filter({'key2' => 'twice'}); |
|
904 |
-$rows = $result->all; |
|
905 |
-is_deeply($rows, [{key2 => 4, key3 => 18}], "select : join : omit"); |
|
906 |
- |
|
907 |
-test 'each_column'; |
|
908 |
-$dbi = DBIx::Custom->connect(%memory); |
|
909 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
910 |
-$dbi->execute('create table table1 (key1 Date, key2 datetime);'); |
|
911 |
- |
|
912 |
-$infos = []; |
|
913 |
-$dbi->each_column(sub { |
|
914 |
- my ($self, $table, $column, $cinfo) = @_; |
|
915 |
- |
|
916 |
- if ($table =~ /^table/) { |
|
917 |
- my $info = [$table, $column, $cinfo->{COLUMN_NAME}]; |
|
918 |
- push @$infos, $info; |
|
919 |
- } |
|
920 |
-}); |
|
921 |
-$infos = [sort { $a->[0] cmp $b->[0] || $a->[1] cmp $b->[1] } @$infos]; |
|
922 |
-is_deeply($infos, |
|
923 |
- [ |
|
924 |
- ['table1', 'key1', 'key1'], |
|
925 |
- ['table1', 'key2', 'key2'], |
|
926 |
- ['table2', 'key1', 'key1'], |
|
927 |
- ['table2', 'key3', 'key3'] |
|
928 |
- ] |
|
929 |
- |
|
930 |
-); |
|
931 |
-test 'each_table'; |
|
932 |
-$dbi = DBIx::Custom->connect(%memory); |
|
933 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
934 |
-$dbi->execute('create table table1 (key1 Date, key2 datetime);'); |
|
935 |
- |
|
936 |
-$infos = []; |
|
937 |
-$dbi->each_table(sub { |
|
938 |
- my ($self, $table, $table_info) = @_; |
|
939 |
- |
|
940 |
- if ($table =~ /^table/) { |
|
941 |
- my $info = [$table, $table_info->{TABLE_NAME}]; |
|
942 |
- push @$infos, $info; |
|
943 |
- } |
|
944 |
-}); |
|
945 |
-$infos = [sort { $a->[0] cmp $b->[0] || $a->[1] cmp $b->[1] } @$infos]; |
|
946 |
-is_deeply($infos, |
|
947 |
- [ |
|
948 |
- ['table1', 'table1'], |
|
949 |
- ['table2', 'table2'], |
|
950 |
- ] |
|
951 |
-); |
|
952 |
- |
|
953 |
-test 'limit'; |
|
954 |
-$dbi = DBIx::Custom->connect(%memory); |
|
955 |
-$dbi->execute($create_table_default); |
|
956 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
957 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 4}); |
|
958 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 6}); |
|
959 |
-$dbi->register_tag( |
|
960 |
- limit => sub { |
|
961 |
- my ($count, $offset) = @_; |
|
962 |
- |
|
963 |
- my $s = ''; |
|
964 |
- $s .= "limit $count"; |
|
965 |
- $s .= " offset $offset" if defined $offset; |
|
966 |
- |
|
967 |
- return [$s, []]; |
|
968 |
- } |
|
969 |
-); |
|
970 |
-$rows = $dbi->select( |
|
971 |
- table => 'table1', |
|
972 |
- where => {key1 => 1}, |
|
973 |
- append => "order by key2 {limit 1 0}" |
|
974 |
-)->all; |
|
975 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
976 |
-$rows = $dbi->select( |
|
977 |
- table => 'table1', |
|
978 |
- where => {key1 => 1}, |
|
979 |
- append => "order by key2 {limit 2 1}" |
|
980 |
-)->all; |
|
981 |
-is_deeply($rows, [{key1 => 1, key2 => 4},{key1 => 1, key2 => 6}]); |
|
982 |
-$rows = $dbi->select( |
|
983 |
- table => 'table1', |
|
984 |
- where => {key1 => 1}, |
|
985 |
- append => "order by key2 {limit 1}" |
|
986 |
-)->all; |
|
987 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
988 |
- |
|
989 |
-test 'connect super'; |
|
990 |
-{ |
|
991 |
- package MyDBI; |
|
992 |
- |
|
993 |
- use base 'DBIx::Custom'; |
|
994 |
- sub connect { |
|
995 |
- my $self = shift->SUPER::connect(@_); |
|
996 |
- |
|
997 |
- return $self; |
|
998 |
- } |
|
999 |
- |
|
1000 |
- sub new { |
|
1001 |
- my $self = shift->SUPER::new(@_); |
|
1002 |
- |
|
1003 |
- return $self; |
|
1004 |
- } |
|
1005 |
-} |
|
1006 |
- |
|
1007 |
-$dbi = MyDBI->connect(%memory); |
|
1008 |
-$dbi->execute($create_table_default); |
|
1009 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1010 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1011 |
- |
|
1012 |
-$dbi = MyDBI->new(%memory); |
|
1013 |
-$dbi->connect; |
|
1014 |
-$dbi->execute($create_table_default); |
|
1015 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1016 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1017 |
- |
|
1018 |
-{ |
|
1019 |
- package MyDBI2; |
|
1020 |
- |
|
1021 |
- use base 'DBIx::Custom'; |
|
1022 |
- sub connect { |
|
1023 |
- my $self = shift->SUPER::new(@_); |
|
1024 |
- $self->connect; |
|
1025 |
- |
|
1026 |
- return $self; |
|
1027 |
- } |
|
1028 |
-} |
|
1029 |
- |
|
1030 |
-$dbi = MyDBI->connect(%memory); |
|
1031 |
-$dbi->execute($create_table_default); |
|
1032 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1033 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1034 |
- |
|
1035 |
-test 'end_filter'; |
|
1036 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1037 |
-$dbi->execute($create_table_default); |
|
1038 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1039 |
-$result = $dbi->select(table => 'table1'); |
|
1040 |
-$result->filter(key1 => sub { $_[0] * 2 }, key2 => sub { $_[0] * 4 }); |
|
1041 |
-$result->end_filter(key1 => sub { $_[0] * 3 }, key2 => sub { $_[0] * 5 }); |
|
1042 |
-$row = $result->fetch_first; |
|
1043 |
-is_deeply($row, [6, 40]); |
|
1044 |
- |
|
1045 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1046 |
-$dbi->execute($create_table_default); |
|
1047 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1048 |
-$result = $dbi->select(table => 'table1'); |
|
1049 |
-$result->filter([qw/key1 key2/] => sub { $_[0] * 2 }); |
|
1050 |
-$result->end_filter([[qw/key1 key2/] => sub { $_[0] * 3 }]); |
|
1051 |
-$row = $result->fetch_first; |
|
1052 |
-is_deeply($row, [6, 12]); |
|
1053 |
- |
|
1054 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1055 |
-$dbi->execute($create_table_default); |
|
1056 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1057 |
-$result = $dbi->select(table => 'table1'); |
|
1058 |
-$result->filter([[qw/key1 key2/] => sub { $_[0] * 2 }]); |
|
1059 |
-$result->end_filter([qw/key1 key2/] => sub { $_[0] * 3 }); |
|
1060 |
-$row = $result->fetch_first; |
|
1061 |
-is_deeply($row, [6, 12]); |
|
1062 |
- |
|
1063 |
-$dbi->register_filter(five_times => sub { $_[0] * 5 }); |
|
1064 |
-$result = $dbi->select(table => 'table1'); |
|
1065 |
-$result->filter(key1 => sub { $_[0] * 2 }, key2 => sub { $_[0] * 4 }); |
|
1066 |
-$result->end_filter({key1 => sub { $_[0] * 3 }, key2 => 'five_times' }); |
|
1067 |
-$row = $result->one; |
|
1068 |
-is_deeply($row, {key1 => 6, key2 => 40}); |
|
1069 |
- |
|
1070 |
-$dbi->register_filter(five_times => sub { $_[0] * 5 }); |
|
1071 |
-$dbi->apply_filter('table1', |
|
1072 |
- key1 => {end => sub { $_[0] * 3 } }, |
|
1073 |
- key2 => {end => 'five_times'} |
|
1074 |
-); |
|
1075 |
-$result = $dbi->select(table => 'table1'); |
|
1076 |
-$result->filter(key1 => sub { $_[0] * 2 }, key2 => sub { $_[0] * 4 }); |
|
1077 |
-$row = $result->one; |
|
1078 |
-is_deeply($row, {key1 => 6, key2 => 40}, 'apply_filter'); |
|
1079 |
- |
|
1080 |
-$dbi->register_filter(five_times => sub { $_[0] * 5 }); |
|
1081 |
-$dbi->apply_filter('table1', |
|
1082 |
- key1 => {end => sub { $_[0] * 3 } }, |
|
1083 |
- key2 => {end => 'five_times'} |
|
1084 |
-); |
|
1085 |
-$result = $dbi->select(table => 'table1'); |
|
1086 |
-$result->filter(key1 => sub { $_[0] * 2 }, key2 => sub { $_[0] * 4 }); |
|
1087 |
-$result->filter(key1 => undef); |
|
1088 |
-$result->end_filter(key1 => undef); |
|
1089 |
-$row = $result->one; |
|
1090 |
-is_deeply($row, {key1 => 1, key2 => 40}, 'apply_filter overwrite'); |
|
1091 |
- |
|
1092 |
-test 'remove_end_filter and remove_filter'; |
|
1093 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1094 |
-$dbi->execute($create_table_default); |
|
1095 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1096 |
-$result = $dbi->select(table => 'table1'); |
|
1097 |
-$row = $result |
|
1098 |
- ->filter(key1 => sub { $_[0] * 2 }, key2 => sub { $_[0] * 4 }) |
|
1099 |
- ->remove_filter |
|
1100 |
- ->end_filter(key1 => sub { $_[0] * 3 }, key2 => sub { $_[0] * 5 }) |
|
1101 |
- ->remove_end_filter |
|
1102 |
- ->fetch_first; |
|
1103 |
-is_deeply($row, [1, 2]); |
|
1104 |
- |
|
1105 |
-test 'empty where select'; |
|
1106 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1107 |
-$dbi->execute($create_table_default); |
|
1108 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1109 |
-$result = $dbi->select(table => 'table1', where => {}); |
|
1110 |
-$row = $result->one; |
|
1111 |
-is_deeply($row, {key1 => 1, key2 => 2}); |
|
1112 |
- |
|
1113 |
-test 'select query option'; |
|
1114 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1115 |
-$dbi->execute($create_table_default); |
|
1116 |
-$query = $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}, query => 1); |
|
1117 |
-is(ref $query, 'DBIx::Custom::Query'); |
|
1118 |
-$query = $dbi->update(table => 'table1', where => {key1 => 1}, param => {key2 => 2}, query => 1); |
|
1119 |
-is(ref $query, 'DBIx::Custom::Query'); |
|
1120 |
-$query = $dbi->delete(table => 'table1', where => {key1 => 1}, query => 1); |
|
1121 |
-is(ref $query, 'DBIx::Custom::Query'); |
|
1122 |
-$query = $dbi->select(table => 'table1', where => {key1 => 1, key2 => 2}, query => 1); |
|
1123 |
-is(ref $query, 'DBIx::Custom::Query'); |
|
1124 |
- |
|
1125 |
-test 'DBIx::Custom::Where'; |
|
1126 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1127 |
-$dbi->execute($create_table_default); |
|
1128 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1129 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
1130 |
-$where = $dbi->where->clause(['and', 'key1 = :key1', 'key2 = :key2']); |
|
1131 |
-is("$where", "where ( key1 = :key1 and key2 = :key2 )", 'no param'); |
|
1132 |
- |
|
1133 |
-$where = $dbi->where |
|
1134 |
- ->clause(['and', 'key1 = :key1', 'key2 = :key2']) |
|
1135 |
- ->param({key1 => 1}); |
|
1136 |
- |
|
1137 |
-$result = $dbi->select( |
|
1138 |
- table => 'table1', |
|
1139 |
- where => $where |
|
1140 |
-); |
|
1141 |
-$row = $result->all; |
|
1142 |
-is_deeply($row, [{key1 => 1, key2 => 2}]); |
|
1143 |
- |
|
1144 |
-$result = $dbi->select( |
|
1145 |
- table => 'table1', |
|
1146 |
- where => [ |
|
1147 |
- ['and', 'key1 = :key1', 'key2 = :key2'], |
|
1148 |
- {key1 => 1} |
|
1149 |
- ] |
|
1150 |
-); |
|
1151 |
-$row = $result->all; |
|
1152 |
-is_deeply($row, [{key1 => 1, key2 => 2}]); |
|
1153 |
- |
|
1154 |
-$where = $dbi->where |
|
1155 |
- ->clause(['and', 'key1 = :key1', 'key2 = :key2']) |
|
1156 |
- ->param({key1 => 1, key2 => 2}); |
|
1157 |
-$result = $dbi->select( |
|
1158 |
- table => 'table1', |
|
1159 |
- where => $where |
|
1160 |
-); |
|
1161 |
-$row = $result->all; |
|
1162 |
-is_deeply($row, [{key1 => 1, key2 => 2}]); |
|
1163 |
- |
|
1164 |
-$where = $dbi->where |
|
1165 |
- ->clause(['and', 'key1 = :key1', 'key2 = :key2']) |
|
1166 |
- ->param({}); |
|
1167 |
-$result = $dbi->select( |
|
1168 |
- table => 'table1', |
|
1169 |
- where => $where, |
|
1170 |
-); |
|
1171 |
-$row = $result->all; |
|
1172 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]); |
|
1173 |
- |
|
1174 |
-$where = $dbi->where |
|
1175 |
- ->clause(['and', ['or', 'key1 > :key1', 'key1 < :key1'], 'key2 = :key2']) |
|
1176 |
- ->param({key1 => [0, 3], key2 => 2}); |
|
1177 |
-$result = $dbi->select( |
|
1178 |
- table => 'table1', |
|
1179 |
- where => $where, |
|
1180 |
-); |
|
1181 |
-$row = $result->all; |
|
1182 |
-is_deeply($row, [{key1 => 1, key2 => 2}]); |
|
1183 |
- |
|
1184 |
-$where = $dbi->where; |
|
1185 |
-$result = $dbi->select( |
|
1186 |
- table => 'table1', |
|
1187 |
- where => $where |
|
1188 |
-); |
|
1189 |
-$row = $result->all; |
|
1190 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]); |
|
1191 |
- |
|
1192 |
-eval { |
|
1193 |
-$where = $dbi->where |
|
1194 |
- ->clause(['uuu']); |
|
1195 |
-$result = $dbi->select( |
|
1196 |
- table => 'table1', |
|
1197 |
- where => $where |
|
1198 |
-); |
|
1199 |
-}; |
|
1200 |
-ok($@); |
|
1201 |
- |
|
1202 |
-$where = $dbi->where; |
|
1203 |
-is("$where", ''); |
|
1204 |
- |
|
1205 |
-$where = $dbi->where |
|
1206 |
- ->clause(['or', ('key1 = :key1') x 2]) |
|
1207 |
- ->param({key1 => [1, 3]}); |
|
1208 |
-$result = $dbi->select( |
|
1209 |
- table => 'table1', |
|
1210 |
- where => $where, |
|
1211 |
-); |
|
1212 |
-$row = $result->all; |
|
1213 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]); |
|
1214 |
- |
|
1215 |
-$where = $dbi->where |
|
1216 |
- ->clause(['or', ('key1 = :key1') x 2]) |
|
1217 |
- ->param({key1 => [1]}); |
|
1218 |
-$result = $dbi->select( |
|
1219 |
- table => 'table1', |
|
1220 |
- where => $where, |
|
1221 |
-); |
|
1222 |
-$row = $result->all; |
|
1223 |
-is_deeply($row, [{key1 => 1, key2 => 2}]); |
|
1224 |
- |
|
1225 |
-$where = $dbi->where |
|
1226 |
- ->clause(['or', ('key1 = :key1') x 2]) |
|
1227 |
- ->param({key1 => 1}); |
|
1228 |
-$result = $dbi->select( |
|
1229 |
- table => 'table1', |
|
1230 |
- where => $where, |
|
1231 |
-); |
|
1232 |
-$row = $result->all; |
|
1233 |
-is_deeply($row, [{key1 => 1, key2 => 2}]); |
|
1234 |
- |
|
1235 |
-$where = $dbi->where |
|
1236 |
- ->clause('key1 = :key1') |
|
1237 |
- ->param({key1 => 1}); |
|
1238 |
-$result = $dbi->select( |
|
1239 |
- table => 'table1', |
|
1240 |
- where => $where, |
|
1241 |
-); |
|
1242 |
-$row = $result->all; |
|
1243 |
-is_deeply($row, [{key1 => 1, key2 => 2}]); |
|
1244 |
- |
|
1245 |
-$where = $dbi->where |
|
1246 |
- ->clause('key1 = :key1 key2 = :key2') |
|
1247 |
- ->param({key1 => 1}); |
|
1248 |
-eval{$where->to_string}; |
|
1249 |
-like($@, qr/one column/); |
|
1250 |
- |
|
1251 |
-$where = $dbi->where |
|
1252 |
- ->clause('key1 = :key1') |
|
1253 |
- ->param([]); |
|
1254 |
-eval{$where->to_string}; |
|
1255 |
-like($@, qr/Parameter/); |
|
1256 |
- |
|
1257 |
-$where = $dbi->where |
|
1258 |
- ->clause(['or', ('key1 = :key1') x 3]) |
|
1259 |
- ->param({key1 => [$dbi->not_exists, 1, 3]}); |
|
1260 |
-$result = $dbi->select( |
|
1261 |
- table => 'table1', |
|
1262 |
- where => $where, |
|
1263 |
-); |
|
1264 |
-$row = $result->all; |
|
1265 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], 'not_exists'); |
|
1266 |
- |
|
1267 |
-$where = $dbi->where |
|
1268 |
- ->clause(['or', ('key1 = :key1') x 3]) |
|
1269 |
- ->param({key1 => [1, $dbi->not_exists, 3]}); |
|
1270 |
-$result = $dbi->select( |
|
1271 |
- table => 'table1', |
|
1272 |
- where => $where, |
|
1273 |
-); |
|
1274 |
-$row = $result->all; |
|
1275 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], 'not_exists'); |
|
1276 |
- |
|
1277 |
-$where = $dbi->where |
|
1278 |
- ->clause(['or', ('key1 = :key1') x 3]) |
|
1279 |
- ->param({key1 => [1, 3, $dbi->not_exists]}); |
|
1280 |
-$result = $dbi->select( |
|
1281 |
- table => 'table1', |
|
1282 |
- where => $where, |
|
1283 |
-); |
|
1284 |
-$row = $result->all; |
|
1285 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], 'not_exists'); |
|
1286 |
- |
|
1287 |
-$where = $dbi->where |
|
1288 |
- ->clause(['or', ('key1 = :key1') x 3]) |
|
1289 |
- ->param({key1 => [1, $dbi->not_exists, $dbi->not_exists]}); |
|
1290 |
-$result = $dbi->select( |
|
1291 |
- table => 'table1', |
|
1292 |
- where => $where, |
|
1293 |
-); |
|
1294 |
-$row = $result->all; |
|
1295 |
-is_deeply($row, [{key1 => 1, key2 => 2}], 'not_exists'); |
|
1296 |
- |
|
1297 |
-$where = $dbi->where |
|
1298 |
- ->clause(['or', ('key1 = :key1') x 3]) |
|
1299 |
- ->param({key1 => [$dbi->not_exists, 1, $dbi->not_exists]}); |
|
1300 |
-$result = $dbi->select( |
|
1301 |
- table => 'table1', |
|
1302 |
- where => $where, |
|
1303 |
-); |
|
1304 |
-$row = $result->all; |
|
1305 |
-is_deeply($row, [{key1 => 1, key2 => 2}], 'not_exists'); |
|
1306 |
- |
|
1307 |
-$where = $dbi->where |
|
1308 |
- ->clause(['or', ('key1 = :key1') x 3]) |
|
1309 |
- ->param({key1 => [$dbi->not_exists, $dbi->not_exists, 1]}); |
|
1310 |
-$result = $dbi->select( |
|
1311 |
- table => 'table1', |
|
1312 |
- where => $where, |
|
1313 |
-); |
|
1314 |
-$row = $result->all; |
|
1315 |
-is_deeply($row, [{key1 => 1, key2 => 2}], 'not_exists'); |
|
1316 |
- |
|
1317 |
-$where = $dbi->where |
|
1318 |
- ->clause(['or', ('key1 = :key1') x 3]) |
|
1319 |
- ->param({key1 => [$dbi->not_exists, $dbi->not_exists, $dbi->not_exists]}); |
|
1320 |
-$result = $dbi->select( |
|
1321 |
- table => 'table1', |
|
1322 |
- where => $where, |
|
1323 |
-); |
|
1324 |
-$row = $result->all; |
|
1325 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], 'not_exists'); |
|
1326 |
- |
|
1327 |
-$where = $dbi->where |
|
1328 |
- ->clause(['or', ('key1 = :key1') x 3]) |
|
1329 |
- ->param({key1 => []}); |
|
1330 |
-$result = $dbi->select( |
|
1331 |
- table => 'table1', |
|
1332 |
- where => $where, |
|
1333 |
-); |
|
1334 |
-$row = $result->all; |
|
1335 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], 'not_exists'); |
|
1336 |
- |
|
1337 |
-$where = $dbi->where |
|
1338 |
- ->clause(['and', '{> key1}', '{< key1}' ]) |
|
1339 |
- ->param({key1 => [2, $dbi->not_exists]}); |
|
1340 |
-$result = $dbi->select( |
|
1341 |
- table => 'table1', |
|
1342 |
- where => $where, |
|
1343 |
-); |
|
1344 |
-$row = $result->all; |
|
1345 |
-is_deeply($row, [{key1 => 3, key2 => 4}], 'not_exists'); |
|
1346 |
- |
|
1347 |
-$where = $dbi->where |
|
1348 |
- ->clause(['and', '{> key1}', '{< key1}' ]) |
|
1349 |
- ->param({key1 => [$dbi->not_exists, 2]}); |
|
1350 |
-$result = $dbi->select( |
|
1351 |
- table => 'table1', |
|
1352 |
- where => $where, |
|
1353 |
-); |
|
1354 |
-$row = $result->all; |
|
1355 |
-is_deeply($row, [{key1 => 1, key2 => 2}], 'not_exists'); |
|
1356 |
- |
|
1357 |
-$where = $dbi->where |
|
1358 |
- ->clause(['and', '{> key1}', '{< key1}' ]) |
|
1359 |
- ->param({key1 => [$dbi->not_exists, $dbi->not_exists]}); |
|
1360 |
-$result = $dbi->select( |
|
1361 |
- table => 'table1', |
|
1362 |
- where => $where, |
|
1363 |
-); |
|
1364 |
-$row = $result->all; |
|
1365 |
-is_deeply($row, [{key1 => 1, key2 => 2},{key1 => 3, key2 => 4}], 'not_exists'); |
|
1366 |
- |
|
1367 |
-$where = $dbi->where |
|
1368 |
- ->clause(['and', '{> key1}', '{< key1}' ]) |
|
1369 |
- ->param({key1 => [0, 2]}); |
|
1370 |
-$result = $dbi->select( |
|
1371 |
- table => 'table1', |
|
1372 |
- where => $where, |
|
1373 |
-); |
|
1374 |
-$row = $result->all; |
|
1375 |
-is_deeply($row, [{key1 => 1, key2 => 2}], 'not_exists'); |
|
1376 |
- |
|
1377 |
-$where = $dbi->where |
|
1378 |
- ->clause(['and', 'key1 is not null', 'key2 is not null' ]); |
|
1379 |
-$result = $dbi->select( |
|
1380 |
- table => 'table1', |
|
1381 |
- where => $where, |
|
1382 |
-); |
|
1383 |
-$row = $result->all; |
|
1384 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}], 'not_exists'); |
|
1385 |
- |
|
1386 |
-eval {$dbi->where(ppp => 1) }; |
|
1387 |
-like($@, qr/invalid/); |
|
1388 |
- |
|
1389 |
-$where = $dbi->where( |
|
1390 |
- clause => ['and', ['or'], ['and', 'key1 = :key1', 'key2 = :key2']], |
|
1391 |
- param => {key1 => 1, key2 => 2} |
|
1392 |
-); |
|
1393 |
-$result = $dbi->select( |
|
1394 |
- table => 'table1', |
|
1395 |
- where => $where, |
|
1396 |
-); |
|
1397 |
-$row = $result->all; |
|
1398 |
-is_deeply($row, [{key1 => 1, key2 => 2}]); |
|
1399 |
- |
|
1400 |
- |
|
1401 |
-$where = $dbi->where( |
|
1402 |
- clause => ['and', ['or'], ['or', ':key1', ':key2']], |
|
1403 |
- param => {} |
|
1404 |
-); |
|
1405 |
-$result = $dbi->select( |
|
1406 |
- table => 'table1', |
|
1407 |
- where => $where, |
|
1408 |
-); |
|
1409 |
-$row = $result->all; |
|
1410 |
-is_deeply($row, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]); |
|
1411 |
- |
|
1412 |
- |
|
1413 |
-test 'dbi_option default'; |
|
1414 |
-$dbi = DBIx::Custom->new; |
|
1415 |
-is_deeply($dbi->dbi_option, {}); |
|
1416 |
- |
|
1417 |
-test 'register_tag_processor'; |
|
1418 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1419 |
-$dbi->register_tag_processor( |
|
1420 |
- a => sub { 1 } |
|
1421 |
-); |
|
1422 |
-is($dbi->query_builder->tag_processors->{a}->(), 1); |
|
1423 |
- |
|
1424 |
-test 'register_tag'; |
|
1425 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1426 |
-$dbi->register_tag( |
|
1427 |
- b => sub { 2 } |
|
1428 |
-); |
|
1429 |
-is($dbi->query_builder->tags->{b}->(), 2); |
|
1430 |
- |
|
1431 |
-test 'table not specify exception'; |
|
1432 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1433 |
-eval {$dbi->insert}; |
|
1434 |
-like($@, qr/table/); |
|
1435 |
-eval {$dbi->update}; |
|
1436 |
-like($@, qr/table/); |
|
1437 |
-eval {$dbi->delete}; |
|
1438 |
-like($@, qr/table/); |
|
1439 |
-eval {$dbi->select}; |
|
1440 |
-like($@, qr/table/); |
|
1441 |
- |
|
1442 |
- |
|
1443 |
-test 'more tests'; |
|
1444 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1445 |
-eval{$dbi->apply_filter('table', 'column', [])}; |
|
1446 |
-like($@, qr/apply_filter/); |
|
1447 |
- |
|
1448 |
-eval{$dbi->apply_filter('table', 'column', {outer => 2})}; |
|
1449 |
-like($@, qr/apply_filter/); |
|
1450 |
- |
|
1451 |
-$dbi->apply_filter( |
|
1452 |
- |
|
1453 |
-); |
|
1454 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1455 |
-$dbi->execute($create_table_default); |
|
1456 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1457 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
1458 |
-$dbi->apply_filter('table1', 'key2', |
|
1459 |
- {in => sub { $_[0] * 3 }, out => sub { $_[0] * 2 }}); |
|
1460 |
-$rows = $dbi->select(table => 'table1', where => {key2 => 1})->all; |
|
1461 |
-is_deeply($rows, [{key1 => 1, key2 => 6}]); |
|
1462 |
- |
|
1463 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1464 |
-$dbi->execute($create_table_default); |
|
1465 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1466 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
1467 |
-$dbi->apply_filter('table1', 'key2', {}); |
|
1468 |
-$rows = $dbi->select(table => 'table1', where => {key2 => 2})->all; |
|
1469 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
1470 |
- |
|
1471 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1472 |
-eval {$dbi->apply_filter('table1', 'key2', {out => 'no'})}; |
|
1473 |
-like($@, qr/not registered/); |
|
1474 |
-eval {$dbi->apply_filter('table1', 'key2', {in => 'no'})}; |
|
1475 |
-like($@, qr/not registered/); |
|
1476 |
-$dbi->method({one => sub { 1 }}); |
|
1477 |
-is($dbi->one, 1); |
|
1478 |
- |
|
1479 |
-eval{DBIx::Custom->connect()}; |
|
1480 |
-like($@, qr/_connect/); |
|
1481 |
- |
|
1482 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1483 |
-$dbi->execute($create_table_default); |
|
1484 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
1485 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}, |
|
1486 |
- filter => {key1 => 'twice'}); |
|
1487 |
-$row = $dbi->select(table => 'table1')->one; |
|
1488 |
-is_deeply($row, {key1 => 2, key2 => 2}); |
|
1489 |
-eval {$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}, |
|
1490 |
- filter => {key1 => 'no'}) }; |
|
1491 |
-like($@, qr//); |
|
1492 |
- |
|
1493 |
-$dbi->register_filter(one => sub { }); |
|
1494 |
-$dbi->default_fetch_filter('one'); |
|
1495 |
-ok($dbi->default_fetch_filter); |
|
1496 |
-$dbi->default_bind_filter('one'); |
|
1497 |
-ok($dbi->default_bind_filter); |
|
1498 |
-eval{$dbi->default_fetch_filter('no')}; |
|
1499 |
-like($@, qr/not registered/); |
|
1500 |
-eval{$dbi->default_bind_filter('no')}; |
|
1501 |
-like($@, qr/not registered/); |
|
1502 |
-$dbi->default_bind_filter(undef); |
|
1503 |
-ok(!defined $dbi->default_bind_filter); |
|
1504 |
-$dbi->default_fetch_filter(undef); |
|
1505 |
-ok(!defined $dbi->default_fetch_filter); |
|
1506 |
-eval {$dbi->execute('select * from table1 {} {= author') }; |
|
1507 |
-like($@, qr/Tag not finished/); |
|
1508 |
- |
|
1509 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1510 |
-$dbi->execute($create_table_default); |
|
1511 |
-$dbi->register_filter(one => sub { 1 }); |
|
1512 |
-$result = $dbi->select(table => 'table1'); |
|
1513 |
-eval {$result->filter(key1 => 'no')}; |
|
1514 |
-like($@, qr/not registered/); |
|
1515 |
-eval {$result->end_filter(key1 => 'no')}; |
|
1516 |
-like($@, qr/not registered/); |
|
1517 |
-$result->default_filter(undef); |
|
1518 |
-ok(!defined $result->default_filter); |
|
1519 |
-$result->default_filter('one'); |
|
1520 |
-is($result->default_filter->(), 1); |
|
1521 |
- |
|
1522 |
-test 'dbi_option'; |
|
1523 |
-$dbi = DBIx::Custom->connect(%memory, |
|
1524 |
- dbi_option => {PrintError => 1}); |
|
1525 |
-ok($dbi->dbh->{PrintError}); |
|
1526 |
-$dbi = DBIx::Custom->connect(%memory, |
|
1527 |
- dbi_options => {PrintError => 1}); |
|
1528 |
-ok($dbi->dbh->{PrintError}); |
|
1529 |
- |
|
1530 |
-test 'DBIx::Custom::Result stash()'; |
|
1531 |
-$result = DBIx::Custom::Result->new; |
|
1532 |
-is_deeply($result->stash, {}, 'default'); |
|
1533 |
-$result->stash->{foo} = 1; |
|
1534 |
-is($result->stash->{foo}, 1, 'get and set'); |
|
1535 |
- |
|
1536 |
-test 'filter __ expression'; |
|
1537 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1538 |
-$dbi->execute('create table company (id, name, location_id)'); |
|
1539 |
-$dbi->execute('create table location (id, name)'); |
|
1540 |
-$dbi->apply_filter('location', |
|
1541 |
- name => {in => sub { uc $_[0] } } |
|
1542 |
-); |
|
1543 |
- |
|
1544 |
-$dbi->insert(table => 'company', param => {id => 1, name => 'a', location_id => 2}); |
|
1545 |
-$dbi->insert(table => 'location', param => {id => 2, name => 'b'}); |
|
1546 |
- |
|
1547 |
-$result = $dbi->select( |
|
1548 |
- table => ['company', 'location'], relation => {'company.location_id' => 'location.id'}, |
|
1549 |
- column => ['location.name as location__name'] |
|
1550 |
-); |
|
1551 |
-is($result->fetch_first->[0], 'B'); |
|
1552 |
- |
|
1553 |
-$result = $dbi->select( |
|
1554 |
- table => 'company', relation => {'company.location_id' => 'location.id'}, |
|
1555 |
- column => ['location.name as location__name'] |
|
1556 |
-); |
|
1557 |
-is($result->fetch_first->[0], 'B'); |
|
1558 |
- |
|
1559 |
-$result = $dbi->select( |
|
1560 |
- table => 'company', relation => {'company.location_id' => 'location.id'}, |
|
1561 |
- column => ['location.name as "location.name"'] |
|
1562 |
-); |
|
1563 |
-is($result->fetch_first->[0], 'B'); |
|
1564 |
- |
|
1565 |
-test 'Model class'; |
|
1566 |
-use MyDBI1; |
|
1567 |
-$dbi = MyDBI1->connect(%memory); |
|
1568 |
-$dbi->execute("create table book (title, author)"); |
|
1569 |
-$model = $dbi->model('book'); |
|
1570 |
-$model->insert({title => 'a', author => 'b'}); |
|
1571 |
-is_deeply($model->list->all, [{title => 'a', author => 'b'}], 'basic'); |
|
1572 |
-$dbi->execute("create table company (name)"); |
|
1573 |
-$model = $dbi->model('company'); |
|
1574 |
-$model->insert({name => 'a'}); |
|
1575 |
-is_deeply($model->list->all, [{name => 'a'}], 'basic'); |
|
1576 |
-is($dbi->models->{'book'}, $dbi->model('book')); |
|
1577 |
-is($dbi->models->{'company'}, $dbi->model('company')); |
|
1578 |
- |
|
1579 |
-{ |
|
1580 |
- package MyDBI4; |
|
1581 |
- |
|
1582 |
- use strict; |
|
1583 |
- use warnings; |
|
1584 |
- |
|
1585 |
- use base 'DBIx::Custom'; |
|
1586 |
- |
|
1587 |
- sub connect { |
|
1588 |
- my $self = shift->SUPER::connect(@_); |
|
1589 |
- |
|
1590 |
- $self->include_model( |
|
1591 |
- MyModel2 => [ |
|
1592 |
- 'book', |
|
1593 |
- {class => 'Company', name => 'company'} |
|
1594 |
- ] |
|
1595 |
- ); |
|
1596 |
- } |
|
1597 |
- |
|
1598 |
- package MyModel2::Base1; |
|
1599 |
- |
|
1600 |
- use strict; |
|
1601 |
- use warnings; |
|
1602 |
- |
|
1603 |
- use base 'DBIx::Custom::Model'; |
|
1604 |
- |
|
1605 |
- package MyModel2::book; |
|
1606 |
- |
|
1607 |
- use strict; |
|
1608 |
- use warnings; |
|
1609 |
- |
|
1610 |
- use base 'MyModel2::Base1'; |
|
1611 |
- |
|
1612 |
- sub insert { |
|
1613 |
- my ($self, $param) = @_; |
|
1614 |
- |
|
1615 |
- return $self->SUPER::insert(param => $param); |
|
1616 |
- } |
|
1617 |
- |
|
1618 |
- sub list { shift->select; } |
|
1619 |
- |
|
1620 |
- package MyModel2::Company; |
|
1621 |
- |
|
1622 |
- use strict; |
|
1623 |
- use warnings; |
|
1624 |
- |
|
1625 |
- use base 'MyModel2::Base1'; |
|
1626 |
- |
|
1627 |
- sub insert { |
|
1628 |
- my ($self, $param) = @_; |
|
1629 |
- |
|
1630 |
- return $self->SUPER::insert(param => $param); |
|
1631 |
- } |
|
1632 |
- |
|
1633 |
- sub list { shift->select; } |
|
1634 |
-} |
|
1635 |
-$dbi = MyDBI4->connect(%memory); |
|
1636 |
-$dbi->execute("create table book (title, author)"); |
|
1637 |
-$model = $dbi->model('book'); |
|
1638 |
-$model->insert({title => 'a', author => 'b'}); |
|
1639 |
-is_deeply($model->list->all, [{title => 'a', author => 'b'}], 'basic'); |
|
1640 |
-$dbi->execute("create table company (name)"); |
|
1641 |
-$model = $dbi->model('company'); |
|
1642 |
-$model->insert({name => 'a'}); |
|
1643 |
-is_deeply($model->list->all, [{name => 'a'}], 'basic'); |
|
1644 |
- |
|
1645 |
-{ |
|
1646 |
- package MyDBI5; |
|
1647 |
- |
|
1648 |
- use strict; |
|
1649 |
- use warnings; |
|
1650 |
- |
|
1651 |
- use base 'DBIx::Custom'; |
|
1652 |
- |
|
1653 |
- sub connect { |
|
1654 |
- my $self = shift->SUPER::connect(@_); |
|
1655 |
- |
|
1656 |
- $self->include_model('MyModel4'); |
|
1657 |
- } |
|
1658 |
-} |
|
1659 |
-$dbi = MyDBI5->connect(%memory); |
|
1660 |
-$dbi->execute("create table company (name)"); |
|
1661 |
-$dbi->execute("create table table1 (key1)"); |
|
1662 |
-$model = $dbi->model('company'); |
|
1663 |
-$model->insert({name => 'a'}); |
|
1664 |
-is_deeply($model->list->all, [{name => 'a'}], 'include all model'); |
|
1665 |
-$dbi->insert(table => 'table1', param => {key1 => 1}); |
|
1666 |
-$model = $dbi->model('book'); |
|
1667 |
-is_deeply($model->list->all, [{key1 => 1}], 'include all model'); |
|
1668 |
- |
|
1669 |
-test 'primary_key'; |
|
1670 |
-use MyDBI1; |
|
1671 |
-$dbi = MyDBI1->connect(%memory); |
|
1672 |
-$model = $dbi->model('book'); |
|
1673 |
-$model->primary_key(['id', 'number']); |
|
1674 |
-is_deeply($model->primary_key, ['id', 'number']); |
|
1675 |
- |
|
1676 |
-test 'columns'; |
|
1677 |
-use MyDBI1; |
|
1678 |
-$dbi = MyDBI1->connect(%memory); |
|
1679 |
-$model = $dbi->model('book'); |
|
1680 |
-$model->columns(['id', 'number']); |
|
1681 |
-is_deeply($model->columns, ['id', 'number']); |
|
1682 |
- |
|
1683 |
-test 'setup_model'; |
|
1684 |
-use MyDBI1; |
|
1685 |
-$dbi = MyDBI1->connect(%memory); |
|
1686 |
-$dbi->execute('create table book (id)'); |
|
1687 |
-$dbi->execute('create table company (id, name);'); |
|
1688 |
-$dbi->execute('create table test (id, name, primary key (id, name));'); |
|
1689 |
-$dbi->setup_model; |
|
1690 |
-is_deeply($dbi->model('book')->columns, ['id']); |
|
1691 |
-is_deeply($dbi->model('company')->columns, ['id', 'name']); |
|
1692 |
- |
|
1693 |
-test 'delete_at'; |
|
1694 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1695 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1696 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1697 |
-$dbi->delete_at( |
|
1698 |
- table => 'table1', |
|
1699 |
- primary_key => ['key1', 'key2'], |
|
1700 |
- where => [1, 2], |
|
1701 |
-); |
|
1702 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
1703 |
- |
|
1704 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1705 |
-$dbi->delete_at( |
|
1706 |
- table => 'table1', |
|
1707 |
- primary_key => 'key1', |
|
1708 |
- where => 1, |
|
1709 |
-); |
|
1710 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
1711 |
- |
|
1712 |
-test 'insert_at'; |
|
1713 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1714 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1715 |
-$dbi->insert_at( |
|
1716 |
- primary_key => ['key1', 'key2'], |
|
1717 |
- table => 'table1', |
|
1718 |
- where => [1, 2], |
|
1719 |
- param => {key3 => 3} |
|
1720 |
-); |
|
1721 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1722 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
1723 |
-is($dbi->select(table => 'table1')->one->{key3}, 3); |
|
1724 |
- |
|
1725 |
-$dbi->delete_all(table => 'table1'); |
|
1726 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1727 |
-$dbi->insert_at( |
|
1728 |
- primary_key => 'key1', |
|
1729 |
- table => 'table1', |
|
1730 |
- where => 1, |
|
1731 |
- param => {key2 => 2, key3 => 3} |
|
1732 |
-); |
|
1733 |
- |
|
1734 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1735 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
1736 |
-is($dbi->select(table => 'table1')->one->{key3}, 3); |
|
1737 |
- |
|
1738 |
-eval { |
|
1739 |
- $dbi->insert_at( |
|
1740 |
- table => 'table1', |
|
1741 |
- primary_key => ['key1', 'key2'], |
|
1742 |
- where => {}, |
|
1743 |
- param => {key1 => 1, key2 => 2, key3 => 3}, |
|
1744 |
- ); |
|
1745 |
-}; |
|
1746 |
-like($@, qr/must be/); |
|
1747 |
- |
|
1748 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1749 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1750 |
-$dbi->insert_at( |
|
1751 |
- {key3 => 3}, |
|
1752 |
- primary_key => ['key1', 'key2'], |
|
1753 |
- table => 'table1', |
|
1754 |
- where => [1, 2], |
|
1755 |
-); |
|
1756 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1757 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
1758 |
-is($dbi->select(table => 'table1')->one->{key3}, 3); |
|
1759 |
- |
|
1760 |
-test 'update_at'; |
|
1761 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1762 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1763 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1764 |
-$dbi->update_at( |
|
1765 |
- table => 'table1', |
|
1766 |
- primary_key => ['key1', 'key2'], |
|
1767 |
- where => [1, 2], |
|
1768 |
- param => {key3 => 4} |
|
1769 |
-); |
|
1770 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1771 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
1772 |
-is($dbi->select(table => 'table1')->one->{key3}, 4); |
|
1773 |
- |
|
1774 |
-$dbi->delete_all(table => 'table1'); |
|
1775 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1776 |
-$dbi->update_at( |
|
1777 |
- table => 'table1', |
|
1778 |
- primary_key => 'key1', |
|
1779 |
- where => 1, |
|
1780 |
- param => {key3 => 4} |
|
1781 |
-); |
|
1782 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1783 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
1784 |
-is($dbi->select(table => 'table1')->one->{key3}, 4); |
|
1785 |
- |
|
1786 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1787 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1788 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1789 |
-$dbi->update_at( |
|
1790 |
- {key3 => 4}, |
|
1791 |
- table => 'table1', |
|
1792 |
- primary_key => ['key1', 'key2'], |
|
1793 |
- where => [1, 2] |
|
1794 |
-); |
|
1795 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
1796 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
1797 |
-is($dbi->select(table => 'table1')->one->{key3}, 4); |
|
1798 |
- |
|
1799 |
-test 'select_at'; |
|
1800 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1801 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1802 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1803 |
-$result = $dbi->select_at( |
|
1804 |
- table => 'table1', |
|
1805 |
- primary_key => ['key1', 'key2'], |
|
1806 |
- where => [1, 2] |
|
1807 |
-); |
|
1808 |
-$row = $result->one; |
|
1809 |
-is($row->{key1}, 1); |
|
1810 |
-is($row->{key2}, 2); |
|
1811 |
-is($row->{key3}, 3); |
|
1812 |
- |
|
1813 |
-$dbi->delete_all(table => 'table1'); |
|
1814 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1815 |
-$result = $dbi->select_at( |
|
1816 |
- table => 'table1', |
|
1817 |
- primary_key => 'key1', |
|
1818 |
- where => 1, |
|
1819 |
-); |
|
1820 |
-$row = $result->one; |
|
1821 |
-is($row->{key1}, 1); |
|
1822 |
-is($row->{key2}, 2); |
|
1823 |
-is($row->{key3}, 3); |
|
1824 |
- |
|
1825 |
-$dbi->delete_all(table => 'table1'); |
|
1826 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1827 |
-$result = $dbi->select_at( |
|
1828 |
- table => 'table1', |
|
1829 |
- primary_key => ['key1', 'key2'], |
|
1830 |
- where => [1, 2] |
|
1831 |
-); |
|
1832 |
-$row = $result->one; |
|
1833 |
-is($row->{key1}, 1); |
|
1834 |
-is($row->{key2}, 2); |
|
1835 |
-is($row->{key3}, 3); |
|
1836 |
- |
|
1837 |
-eval { |
|
1838 |
- $result = $dbi->select_at( |
|
1839 |
- table => 'table1', |
|
1840 |
- primary_key => ['key1', 'key2'], |
|
1841 |
- where => {}, |
|
1842 |
- ); |
|
1843 |
-}; |
|
1844 |
-like($@, qr/must be/); |
|
1845 |
- |
|
1846 |
-eval { |
|
1847 |
- $result = $dbi->select_at( |
|
1848 |
- table => 'table1', |
|
1849 |
- primary_key => ['key1', 'key2'], |
|
1850 |
- where => [1], |
|
1851 |
- ); |
|
1852 |
-}; |
|
1853 |
-like($@, qr/same/); |
|
1854 |
- |
|
1855 |
-eval { |
|
1856 |
- $result = $dbi->update_at( |
|
1857 |
- table => 'table1', |
|
1858 |
- primary_key => ['key1', 'key2'], |
|
1859 |
- where => {}, |
|
1860 |
- param => {key1 => 1, key2 => 2}, |
|
1861 |
- ); |
|
1862 |
-}; |
|
1863 |
-like($@, qr/must be/); |
|
1864 |
- |
|
1865 |
-eval { |
|
1866 |
- $result = $dbi->delete_at( |
|
1867 |
- table => 'table1', |
|
1868 |
- primary_key => ['key1', 'key2'], |
|
1869 |
- where => {}, |
|
1870 |
- ); |
|
1871 |
-}; |
|
1872 |
-like($@, qr/must be/); |
|
1873 |
- |
|
1874 |
-test 'columns'; |
|
1875 |
-use MyDBI1; |
|
1876 |
-$dbi = MyDBI1->connect(%memory); |
|
1877 |
-$model = $dbi->model('book'); |
|
1878 |
- |
|
1879 |
- |
|
1880 |
-test 'model delete_at'; |
|
1881 |
-{ |
|
1882 |
- package MyDBI6; |
|
1883 |
- |
|
1884 |
- use base 'DBIx::Custom'; |
|
1885 |
- |
|
1886 |
- sub connect { |
|
1887 |
- my $self = shift->SUPER::connect(@_); |
|
1888 |
- |
|
1889 |
- $self->include_model('MyModel5'); |
|
1890 |
- |
|
1891 |
- return $self; |
|
1892 |
- } |
|
1893 |
-} |
|
1894 |
-$dbi = MyDBI6->connect(%memory); |
|
1895 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1896 |
-$dbi->execute("create table table2 (key1, key2, key3)"); |
|
1897 |
-$dbi->execute("create table table3 (key1, key2, key3)"); |
|
1898 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1899 |
-$dbi->model('table1')->delete_at(where => [1, 2]); |
|
1900 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
1901 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1902 |
-$dbi->model('table1_1')->delete_at(where => [1, 2]); |
|
1903 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
1904 |
-$dbi->insert(table => 'table3', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1905 |
-$dbi->model('table1_3')->delete_at(where => [1, 2]); |
|
1906 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
1907 |
- |
|
1908 |
-test 'model insert_at'; |
|
1909 |
-$dbi = MyDBI6->connect(%memory); |
|
1910 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1911 |
-$dbi->model('table1')->insert_at( |
|
1912 |
- where => [1, 2], |
|
1913 |
- param => {key3 => 3} |
|
1914 |
-); |
|
1915 |
-$result = $dbi->model('table1')->select; |
|
1916 |
-$row = $result->one; |
|
1917 |
-is($row->{key1}, 1); |
|
1918 |
-is($row->{key2}, 2); |
|
1919 |
-is($row->{key3}, 3); |
|
1920 |
- |
|
1921 |
-test 'model update_at'; |
|
1922 |
-$dbi = MyDBI6->connect(%memory); |
|
1923 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1924 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1925 |
-$dbi->model('table1')->update_at( |
|
1926 |
- where => [1, 2], |
|
1927 |
- param => {key3 => 4} |
|
1928 |
-); |
|
1929 |
-$result = $dbi->model('table1')->select; |
|
1930 |
-$row = $result->one; |
|
1931 |
-is($row->{key1}, 1); |
|
1932 |
-is($row->{key2}, 2); |
|
1933 |
-is($row->{key3}, 4); |
|
1934 |
- |
|
1935 |
-test 'model select_at'; |
|
1936 |
-$dbi = MyDBI6->connect(%memory); |
|
1937 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1938 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
1939 |
-$result = $dbi->model('table1')->select_at(where => [1, 2]); |
|
1940 |
-$row = $result->one; |
|
1941 |
-is($row->{key1}, 1); |
|
1942 |
-is($row->{key2}, 2); |
|
1943 |
-is($row->{key3}, 3); |
|
1944 |
- |
|
1945 |
- |
|
1946 |
-test 'mycolumn and column'; |
|
1947 |
-{ |
|
1948 |
- package MyDBI7; |
|
1949 |
- |
|
1950 |
- use base 'DBIx::Custom'; |
|
1951 |
- |
|
1952 |
- sub connect { |
|
1953 |
- my $self = shift->SUPER::connect(@_); |
|
1954 |
- |
|
1955 |
- $self->include_model('MyModel6'); |
|
1956 |
- |
|
1957 |
- |
|
1958 |
- return $self; |
|
1959 |
- } |
|
1960 |
-} |
|
1961 |
-$dbi = MyDBI7->connect(%memory); |
|
1962 |
-$dbi->execute($create_table_default); |
|
1963 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
1964 |
-$dbi->separator('__'); |
|
1965 |
-$dbi->setup_model; |
|
1966 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
1967 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 3}); |
|
1968 |
-$model = $dbi->model('table1'); |
|
1969 |
-$result = $model->select( |
|
1970 |
- column => [$model->mycolumn, $model->column('table2')], |
|
1971 |
- where => {'table1.key1' => 1} |
|
1972 |
-); |
|
1973 |
-is_deeply($result->one, |
|
1974 |
- {key1 => 1, key2 => 2, 'table2__key1' => 1, 'table2__key3' => 3}); |
|
1975 |
- |
|
1976 |
-test 'update_param'; |
|
1977 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1978 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1979 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
1980 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
1981 |
- |
|
1982 |
-$param = {key2 => 11}; |
|
1983 |
-$update_param = $dbi->update_param($param); |
|
1984 |
-$sql = <<"EOS"; |
|
1985 |
-update table1 $update_param |
|
1986 |
-where key1 = 1 |
|
1987 |
-EOS |
|
1988 |
-$dbi->execute($sql, param => $param); |
|
1989 |
-$result = $dbi->execute('select * from table1;', table => 'table1'); |
|
1990 |
-$rows = $result->all; |
|
1991 |
-is_deeply($rows, [{key1 => 1, key2 => 11, key3 => 3, key4 => 4, key5 => 5}, |
|
1992 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
1993 |
- "basic"); |
|
1994 |
- |
|
1995 |
- |
|
1996 |
-$dbi = DBIx::Custom->connect(%memory); |
|
1997 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
1998 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
1999 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
2000 |
- |
|
2001 |
-$param = {key2 => 11, key3 => 33}; |
|
2002 |
-$update_param = $dbi->update_param($param); |
|
2003 |
-$sql = <<"EOS"; |
|
2004 |
-update table1 $update_param |
|
2005 |
-where key1 = 1 |
|
2006 |
-EOS |
|
2007 |
-$dbi->execute($sql, param => $param); |
|
2008 |
-$result = $dbi->execute('select * from table1;', table => 'table1'); |
|
2009 |
-$rows = $result->all; |
|
2010 |
-is_deeply($rows, [{key1 => 1, key2 => 11, key3 => 33, key4 => 4, key5 => 5}, |
|
2011 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
2012 |
- "basic"); |
|
2013 |
- |
|
2014 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2015 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2016 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
2017 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
2018 |
- |
|
2019 |
-$param = {key2 => 11, key3 => 33}; |
|
2020 |
-$update_param = $dbi->update_param($param, {no_set => 1}); |
|
2021 |
-$sql = <<"EOS"; |
|
2022 |
-update table1 set $update_param |
|
2023 |
-where key1 = 1 |
|
2024 |
-EOS |
|
2025 |
-$dbi->execute($sql, param => $param); |
|
2026 |
-$result = $dbi->execute('select * from table1;', table => 'table1'); |
|
2027 |
-$rows = $result->all; |
|
2028 |
-is_deeply($rows, [{key1 => 1, key2 => 11, key3 => 33, key4 => 4, key5 => 5}, |
|
2029 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
2030 |
- "update param no_set"); |
|
2031 |
- |
|
2032 |
- |
|
2033 |
-eval { $dbi->update_param({";" => 1}) }; |
|
2034 |
-like($@, qr/not safety/); |
|
2035 |
- |
|
2036 |
- |
|
2037 |
-test 'update_param'; |
|
2038 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2039 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2040 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
2041 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
2042 |
- |
|
2043 |
-$param = {key2 => 11}; |
|
2044 |
-$update_param = $dbi->assign_param($param); |
|
2045 |
-$sql = <<"EOS"; |
|
2046 |
-update table1 set $update_param |
|
2047 |
-where key1 = 1 |
|
2048 |
-EOS |
|
2049 |
-$dbi->execute($sql, param => $param, table => 'table1'); |
|
2050 |
-$result = $dbi->execute('select * from table1;'); |
|
2051 |
-$rows = $result->all; |
|
2052 |
-is_deeply($rows, [{key1 => 1, key2 => 11, key3 => 3, key4 => 4, key5 => 5}, |
|
2053 |
- {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}], |
|
2054 |
- "basic"); |
|
2055 |
- |
|
2056 |
- |
|
2057 |
-test 'insert_param'; |
|
2058 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2059 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2060 |
-$param = {key1 => 1, key2 => 2}; |
|
2061 |
-$insert_param = $dbi->insert_param($param); |
|
2062 |
-$sql = <<"EOS"; |
|
2063 |
-insert into table1 $insert_param |
|
2064 |
-EOS |
|
2065 |
-$dbi->execute($sql, param => $param, table => 'table1'); |
|
2066 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
2067 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
2068 |
- |
|
2069 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2070 |
-$dbi->quote('"'); |
|
2071 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2072 |
-$param = {key1 => 1, key2 => 2}; |
|
2073 |
-$insert_param = $dbi->insert_param($param); |
|
2074 |
-$sql = <<"EOS"; |
|
2075 |
-insert into table1 $insert_param |
|
2076 |
-EOS |
|
2077 |
-$dbi->execute($sql, param => $param, table => 'table1'); |
|
2078 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
2079 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
2080 |
- |
|
2081 |
-eval { $dbi->insert_param({";" => 1}) }; |
|
2082 |
-like($@, qr/not safety/); |
|
2083 |
- |
|
2084 |
- |
|
2085 |
-test 'join'; |
|
2086 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2087 |
-$dbi->execute($create_table_default); |
|
2088 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2089 |
-$dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
2090 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2091 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 5}); |
|
2092 |
-$dbi->execute('create table table3 (key3 int, key4 int);'); |
|
2093 |
-$dbi->insert(table => 'table3', param => {key3 => 5, key4 => 4}); |
|
2094 |
-$rows = $dbi->select( |
|
2095 |
- table => 'table1', |
|
2096 |
- column => 'table1.key1 as table1_key1, table2.key1 as table2_key1, key2, key3', |
|
2097 |
- where => {'table1.key2' => 2}, |
|
2098 |
- join => ['left outer join table2 on table1.key1 = table2.key1'] |
|
2099 |
-)->all; |
|
2100 |
-is_deeply($rows, [{table1_key1 => 1, table2_key1 => 1, key2 => 2, key3 => 5}]); |
|
2101 |
- |
|
2102 |
-$rows = $dbi->select( |
|
2103 |
- table => 'table1', |
|
2104 |
- where => {'key1' => 1}, |
|
2105 |
- join => ['left outer join table2 on table1.key1 = table2.key1'] |
|
2106 |
-)->all; |
|
2107 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
2108 |
- |
|
2109 |
-eval { |
|
2110 |
- $rows = $dbi->select( |
|
2111 |
- table => 'table1', |
|
2112 |
- column => 'table1.key1 as table1_key1, table2.key1 as table2_key1, key2, key3', |
|
2113 |
- where => {'table1.key2' => 2}, |
|
2114 |
- join => {'table1.key1' => 'table2.key1'} |
|
2115 |
- ); |
|
2116 |
-}; |
|
2117 |
-like ($@, qr/array/); |
|
2118 |
- |
|
2119 |
-$rows = $dbi->select( |
|
2120 |
- table => 'table1', |
|
2121 |
- where => {'key1' => 1}, |
|
2122 |
- join => ['left outer join table2 on table1.key1 = table2.key1', |
|
2123 |
- 'left outer join table3 on table2.key3 = table3.key3'] |
|
2124 |
-)->all; |
|
2125 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
2126 |
- |
|
2127 |
-$rows = $dbi->select( |
|
2128 |
- column => 'table3.key4 as table3__key4', |
|
2129 |
- table => 'table1', |
|
2130 |
- where => {'table1.key1' => 1}, |
|
2131 |
- join => ['left outer join table2 on table1.key1 = table2.key1', |
|
2132 |
- 'left outer join table3 on table2.key3 = table3.key3'] |
|
2133 |
-)->all; |
|
2134 |
-is_deeply($rows, [{table3__key4 => 4}]); |
|
2135 |
- |
|
2136 |
-$rows = $dbi->select( |
|
2137 |
- column => 'table1.key1 as table1__key1', |
|
2138 |
- table => 'table1', |
|
2139 |
- where => {'table3.key4' => 4}, |
|
2140 |
- join => ['left outer join table2 on table1.key1 = table2.key1', |
|
2141 |
- 'left outer join table3 on table2.key3 = table3.key3'] |
|
2142 |
-)->all; |
|
2143 |
-is_deeply($rows, [{table1__key1 => 1}]); |
|
2144 |
- |
|
2145 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2146 |
-$dbi->quote('"'); |
|
2147 |
-$dbi->execute($create_table_default); |
|
2148 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2149 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2150 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 5}); |
|
2151 |
-$rows = $dbi->select( |
|
2152 |
- table => 'table1', |
|
2153 |
- column => '"table1"."key1" as "table1_key1", "table2"."key1" as "table2_key1", "key2", "key3"', |
|
2154 |
- where => {'table1.key2' => 2}, |
|
2155 |
- join => ['left outer join "table2" on "table1"."key1" = "table2"."key1"'], |
|
2156 |
-)->all; |
|
2157 |
-is_deeply($rows, [{table1_key1 => 1, table2_key1 => 1, key2 => 2, key3 => 5}], |
|
2158 |
- 'quote'); |
|
2159 |
- |
|
2160 |
-{ |
|
2161 |
- package MyDBI8; |
|
2162 |
- |
|
2163 |
- use base 'DBIx::Custom'; |
|
2164 |
- |
|
2165 |
- sub connect { |
|
2166 |
- my $self = shift->SUPER::connect(@_); |
|
2167 |
- |
|
2168 |
- $self->include_model('MyModel7'); |
|
2169 |
- |
|
2170 |
- return $self; |
|
2171 |
- } |
|
2172 |
-} |
|
2173 |
- |
|
2174 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2175 |
-$dbi->execute($create_table_default); |
|
2176 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2177 |
-$sql = <<"EOS"; |
|
2178 |
-left outer join ( |
|
2179 |
- select * from table1 as t1 |
|
2180 |
- where t1.key2 = ( |
|
2181 |
- select max(t2.key2) from table1 as t2 |
|
2182 |
- where t1.key1 = t2.key1 |
|
2183 |
- ) |
|
2184 |
-) as latest_table1 on table1.key1 = latest_table1.key1 |
|
2185 |
-EOS |
|
2186 |
-$join = [$sql]; |
|
2187 |
-$rows = $dbi->select( |
|
2188 |
- table => 'table1', |
|
2189 |
- column => 'latest_table1.key1 as latest_table1__key1', |
|
2190 |
- join => $join |
|
2191 |
-)->all; |
|
2192 |
-is_deeply($rows, [{latest_table1__key1 => 1}]); |
|
2193 |
- |
|
2194 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2195 |
-$dbi->execute($create_table_default); |
|
2196 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2197 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2198 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 4}); |
|
2199 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 5}); |
|
2200 |
-$result = $dbi->select( |
|
2201 |
- table => 'table1', |
|
2202 |
- join => [ |
|
2203 |
- "left outer join table2 on table2.key2 = '4' and table1.key1 = table2.key1" |
|
2204 |
- ] |
|
2205 |
-); |
|
2206 |
-is_deeply($result->all, [{key1 => 1, key2 => 2}]); |
|
2207 |
-$result = $dbi->select( |
|
2208 |
- table => 'table1', |
|
2209 |
- column => [{table2 => ['key3']}], |
|
2210 |
- join => [ |
|
2211 |
- "left outer join table2 on table2.key3 = '4' and table1.key1 = table2.key1" |
|
2212 |
- ] |
|
2213 |
-); |
|
2214 |
-is_deeply($result->all, [{'table2.key3' => 4}]); |
|
2215 |
-$result = $dbi->select( |
|
2216 |
- table => 'table1', |
|
2217 |
- column => [{table2 => ['key3']}], |
|
2218 |
- join => [ |
|
2219 |
- "left outer join table2 on table1.key1 = table2.key1 and table2.key3 = '4'" |
|
2220 |
- ] |
|
2221 |
-); |
|
2222 |
-is_deeply($result->all, [{'table2.key3' => 4}]); |
|
2223 |
- |
|
2224 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2225 |
-$dbi->execute($create_table_default); |
|
2226 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2227 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2228 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 4}); |
|
2229 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 5}); |
|
2230 |
-$result = $dbi->select( |
|
2231 |
- table => 'table1', |
|
2232 |
- column => [{table2 => ['key3']}], |
|
2233 |
- join => [ |
|
2234 |
- { |
|
2235 |
- clause => "left outer join table2 on table2.key3 = '4' and table1.key1 = table2.key1", |
|
2236 |
- table => ['table1', 'table2'] |
|
2237 |
- } |
|
2238 |
- ] |
|
2239 |
-); |
|
2240 |
-is_deeply($result->all, [{'table2.key3' => 4}]); |
|
2241 |
- |
|
2242 |
-test 'mycolumn'; |
|
2243 |
-$dbi = MyDBI8->connect(%memory); |
|
2244 |
-$dbi->execute($create_table_default); |
|
2245 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2246 |
-$dbi->setup_model; |
|
2247 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2248 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 3}); |
|
2249 |
-$model = $dbi->model('table1'); |
|
2250 |
-$result = $model->select_at( |
|
2251 |
- column => [ |
|
2252 |
- $model->mycolumn, |
|
2253 |
- $model->column('table2') |
|
2254 |
- ] |
|
2255 |
-); |
|
2256 |
-is_deeply($result->one, |
|
2257 |
- {key1 => 1, key2 => 2, 'table2.key1' => 1, 'table2.key3' => 3}); |
|
2258 |
- |
|
2259 |
-$result = $model->select_at( |
|
2260 |
- column => [ |
|
2261 |
- $model->mycolumn(['key1']), |
|
2262 |
- $model->column(table2 => ['key1']) |
|
2263 |
- ] |
|
2264 |
-); |
|
2265 |
-is_deeply($result->one, |
|
2266 |
- {key1 => 1, 'table2.key1' => 1}); |
|
2267 |
-$result = $model->select_at( |
|
2268 |
- column => [ |
|
2269 |
- $model->mycolumn(['key1']), |
|
2270 |
- {table2 => ['key1']} |
|
2271 |
- ] |
|
2272 |
-); |
|
2273 |
-is_deeply($result->one, |
|
2274 |
- {key1 => 1, 'table2.key1' => 1}); |
|
2275 |
- |
|
2276 |
-$result = $model->select_at( |
|
2277 |
- column => [ |
|
2278 |
- $model->mycolumn(['key1']), |
|
2279 |
- ['table2.key1', as => 'table2.key1'] |
|
2280 |
- ] |
|
2281 |
-); |
|
2282 |
-is_deeply($result->one, |
|
2283 |
- {key1 => 1, 'table2.key1' => 1}); |
|
2284 |
- |
|
2285 |
-$result = $model->select_at( |
|
2286 |
- column => [ |
|
2287 |
- $model->mycolumn(['key1']), |
|
2288 |
- ['table2.key1' => 'table2.key1'] |
|
2289 |
- ] |
|
2290 |
-); |
|
2291 |
-is_deeply($result->one, |
|
2292 |
- {key1 => 1, 'table2.key1' => 1}); |
|
2293 |
- |
|
2294 |
-test 'dbi method from model'; |
|
2295 |
-{ |
|
2296 |
- package MyDBI9; |
|
2297 |
- |
|
2298 |
- use base 'DBIx::Custom'; |
|
2299 |
- |
|
2300 |
- sub connect { |
|
2301 |
- my $self = shift->SUPER::connect(@_); |
|
2302 |
- |
|
2303 |
- $self->include_model('MyModel8')->setup_model; |
|
2304 |
- |
|
2305 |
- return $self; |
|
2306 |
- } |
|
2307 |
-} |
|
2308 |
-$dbi = MyDBI9->connect(%memory); |
|
2309 |
-$dbi->execute($create_table_default); |
|
2310 |
-$model = $dbi->model('table1'); |
|
2311 |
-eval{$model->execute('select * from table1')}; |
|
2312 |
-ok(!$@); |
|
2313 |
- |
|
2314 |
-test 'column table option'; |
|
2315 |
-$dbi = MyDBI9->connect(%memory); |
|
2316 |
-$dbi->execute($create_table_default); |
|
2317 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2318 |
-$dbi->setup_model; |
|
2319 |
-$dbi->execute('insert into table1 (key1, key2) values (1, 2);'); |
|
2320 |
-$dbi->execute('insert into table2 (key1, key3) values (1, 4);'); |
|
2321 |
-$model = $dbi->model('table1'); |
|
2322 |
-$result = $model->select( |
|
2323 |
- column => [ |
|
2324 |
- $model->column('table2', {alias => 'table2_alias'}) |
|
2325 |
- ], |
|
2326 |
- where => {'table2_alias.key3' => 4} |
|
2327 |
-); |
|
2328 |
-is_deeply($result->one, |
|
2329 |
- {'table2_alias.key1' => 1, 'table2_alias.key3' => 4}); |
|
2330 |
- |
|
2331 |
-$dbi->separator('__'); |
|
2332 |
-$result = $model->select( |
|
2333 |
- column => [ |
|
2334 |
- $model->column('table2', {alias => 'table2_alias'}) |
|
2335 |
- ], |
|
2336 |
- where => {'table2_alias.key3' => 4} |
|
2337 |
-); |
|
2338 |
-is_deeply($result->one, |
|
2339 |
- {'table2_alias__key1' => 1, 'table2_alias__key3' => 4}); |
|
2340 |
- |
|
2341 |
-$dbi->separator('-'); |
|
2342 |
-$result = $model->select( |
|
2343 |
- column => [ |
|
2344 |
- $model->column('table2', {alias => 'table2_alias'}) |
|
2345 |
- ], |
|
2346 |
- where => {'table2_alias.key3' => 4} |
|
2347 |
-); |
|
2348 |
-is_deeply($result->one, |
|
2349 |
- {'table2_alias-key1' => 1, 'table2_alias-key3' => 4}); |
|
2350 |
- |
|
2351 |
-test 'type option'; # DEPRECATED! |
|
2352 |
-$dbi = DBIx::Custom->connect( |
|
2353 |
- data_source => 'dbi:SQLite:dbname=:memory:', |
|
2354 |
- dbi_option => { |
|
2355 |
- $DBD::SQLite::VERSION > 1.26 ? (sqlite_unicode => 1) : (unicode => 1) |
|
2356 |
- } |
|
2357 |
-); |
|
2358 |
-my $binary = pack("I3", 1, 2, 3); |
|
2359 |
-$dbi->execute('create table table1(key1, key2)'); |
|
2360 |
-$dbi->insert(table => 'table1', param => {key1 => $binary, key2 => 'あ'}, type => [key1 => DBI::SQL_BLOB]); |
|
2361 |
-$result = $dbi->select(table => 'table1'); |
|
2362 |
-$row = $result->one; |
|
2363 |
-is_deeply($row, {key1 => $binary, key2 => 'あ'}, "basic"); |
|
2364 |
-$result = $dbi->execute('select length(key1) as key1_length from table1'); |
|
2365 |
-$row = $result->one; |
|
2366 |
-is($row->{key1_length}, length $binary); |
|
2367 |
- |
|
2368 |
-$dbi->insert(table => 'table1', param => {key1 => $binary, key2 => 'あ'}, type => [['key1'] => DBI::SQL_BLOB]); |
|
2369 |
-$result = $dbi->select(table => 'table1'); |
|
2370 |
-$row = $result->one; |
|
2371 |
-is_deeply($row, {key1 => $binary, key2 => 'あ'}, "basic"); |
|
2372 |
-$result = $dbi->execute('select length(key1) as key1_length from table1'); |
|
2373 |
-$row = $result->one; |
|
2374 |
-is($row->{key1_length}, length $binary); |
|
2375 |
- |
|
2376 |
- |
|
2377 |
-test 'bind_type option'; |
|
2378 |
-$dbi = DBIx::Custom->connect( |
|
2379 |
- data_source => 'dbi:SQLite:dbname=:memory:', |
|
2380 |
- dbi_option => { |
|
2381 |
- $DBD::SQLite::VERSION > 1.26 ? (sqlite_unicode => 1) : (unicode => 1) |
|
2382 |
- } |
|
2383 |
-); |
|
2384 |
-$binary = pack("I3", 1, 2, 3); |
|
2385 |
-$dbi->execute('create table table1(key1, key2)'); |
|
2386 |
-$dbi->insert(table => 'table1', param => {key1 => $binary, key2 => 'あ'}, bind_type => [key1 => DBI::SQL_BLOB]); |
|
2387 |
-$result = $dbi->select(table => 'table1'); |
|
2388 |
-$row = $result->one; |
|
2389 |
-is_deeply($row, {key1 => $binary, key2 => 'あ'}, "basic"); |
|
2390 |
-$result = $dbi->execute('select length(key1) as key1_length from table1'); |
|
2391 |
-$row = $result->one; |
|
2392 |
-is($row->{key1_length}, length $binary); |
|
2393 |
- |
|
2394 |
-$dbi->insert(table => 'table1', param => {key1 => $binary, key2 => 'あ'}, bind_type => [['key1'] => DBI::SQL_BLOB]); |
|
2395 |
-$result = $dbi->select(table => 'table1'); |
|
2396 |
-$row = $result->one; |
|
2397 |
-is_deeply($row, {key1 => $binary, key2 => 'あ'}, "basic"); |
|
2398 |
-$result = $dbi->execute('select length(key1) as key1_length from table1'); |
|
2399 |
-$row = $result->one; |
|
2400 |
-is($row->{key1_length}, length $binary); |
|
2401 |
- |
|
2402 |
-test 'model type attribute'; |
|
2403 |
-$dbi = DBIx::Custom->connect( |
|
2404 |
- data_source => 'dbi:SQLite:dbname=:memory:', |
|
2405 |
- dbi_option => { |
|
2406 |
- $DBD::SQLite::VERSION > 1.26 ? (sqlite_unicode => 1) : (unicode => 1) |
|
2407 |
- } |
|
2408 |
-); |
|
2409 |
-$binary = pack("I3", 1, 2, 3); |
|
2410 |
-$dbi->execute('create table table1(key1, key2)'); |
|
2411 |
-$model = $dbi->create_model(table => 'table1', bind_type => [key1 => DBI::SQL_BLOB]); |
|
2412 |
-$model->insert(param => {key1 => $binary, key2 => 'あ'}); |
|
2413 |
-$result = $dbi->select(table => 'table1'); |
|
2414 |
-$row = $result->one; |
|
2415 |
-is_deeply($row, {key1 => $binary, key2 => 'あ'}, "basic"); |
|
2416 |
-$result = $dbi->execute('select length(key1) as key1_length from table1'); |
|
2417 |
-$row = $result->one; |
|
2418 |
-is($row->{key1_length}, length $binary); |
|
2419 |
- |
|
2420 |
-test 'create_model'; |
|
2421 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2422 |
-$dbi->execute($create_table_default); |
|
2423 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2424 |
- |
|
2425 |
-$dbi->create_model( |
|
2426 |
- table => 'table1', |
|
2427 |
- join => [ |
|
2428 |
- 'left outer join table2 on table1.key1 = table2.key1' |
|
2429 |
- ], |
|
2430 |
- primary_key => ['key1'] |
|
2431 |
-); |
|
2432 |
-$model2 = $dbi->create_model( |
|
2433 |
- table => 'table2' |
|
2434 |
-); |
|
2435 |
-$dbi->create_model( |
|
2436 |
- table => 'table3', |
|
2437 |
- filter => [ |
|
2438 |
- key1 => {in => sub { uc $_[0] }} |
|
2439 |
- ] |
|
2440 |
-); |
|
2441 |
-$dbi->setup_model; |
|
2442 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2443 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 3}); |
|
2444 |
-$model = $dbi->model('table1'); |
|
2445 |
-$result = $model->select( |
|
2446 |
- column => [$model->mycolumn, $model->column('table2')], |
|
2447 |
- where => {'table1.key1' => 1} |
|
2448 |
-); |
|
2449 |
-is_deeply($result->one, |
|
2450 |
- {key1 => 1, key2 => 2, 'table2.key1' => 1, 'table2.key3' => 3}); |
|
2451 |
-is_deeply($model2->select->one, {key1 => 1, key3 => 3}); |
|
2452 |
- |
|
2453 |
-test 'model method'; |
|
2454 |
-test 'create_model'; |
|
2455 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2456 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2457 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 3}); |
|
2458 |
-$model = $dbi->create_model( |
|
2459 |
- table => 'table2' |
|
2460 |
-); |
|
2461 |
-$model->method(foo => sub { shift->select(@_) }); |
|
2462 |
-is_deeply($model->foo->one, {key1 => 1, key3 => 3}); |
|
2463 |
- |
|
2464 |
-test 'merge_param'; |
|
2465 |
-$dbi = DBIx::Custom->new; |
|
2466 |
-$params = [ |
|
2467 |
- {key1 => 1, key2 => 2, key3 => 3}, |
|
2468 |
- {key1 => 1, key2 => 2}, |
|
2469 |
- {key1 => 1} |
|
2470 |
-]; |
|
2471 |
-$param = $dbi->merge_param($params->[0], $params->[1], $params->[2]); |
|
2472 |
-is_deeply($param, {key1 => [1, 1, 1], key2 => [2, 2], key3 => 3}); |
|
2473 |
- |
|
2474 |
-$params = [ |
|
2475 |
- {key1 => [1, 2], key2 => 1, key3 => [1, 2]}, |
|
2476 |
- {key1 => [3, 4], key2 => [2, 3], key3 => 3} |
|
2477 |
-]; |
|
2478 |
-$param = $dbi->merge_param($params->[0], $params->[1]); |
|
2479 |
-is_deeply($param, {key1 => [1, 2, 3, 4], key2 => [1, 2, 3], key3 => [1, 2, 3]}); |
|
2480 |
- |
|
2481 |
-test 'select() param option'; |
|
2482 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2483 |
-$dbi->execute($create_table_default); |
|
2484 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2485 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 3}); |
|
2486 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2487 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 4}); |
|
2488 |
-$dbi->insert(table => 'table2', param => {key1 => 2, key3 => 5}); |
|
2489 |
-$rows = $dbi->select( |
|
2490 |
- table => 'table1', |
|
2491 |
- column => 'table1.key1 as table1_key1, key2, key3', |
|
2492 |
- where => {'table1.key2' => 3}, |
|
2493 |
- join => ['inner join (select * from table2 where {= table2.key3})' . |
|
2494 |
- ' as table2 on table1.key1 = table2.key1'], |
|
2495 |
- param => {'table2.key3' => 5} |
|
2496 |
-)->all; |
|
2497 |
-is_deeply($rows, [{table1_key1 => 2, key2 => 3, key3 => 5}]); |
|
2498 |
- |
|
2499 |
- |
|
2500 |
-test 'select() wrap option'; |
|
2501 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2502 |
-$dbi->execute($create_table_default); |
|
2503 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2504 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 3}); |
|
2505 |
-$rows = $dbi->select( |
|
2506 |
- table => 'table1', |
|
2507 |
- column => 'key1', |
|
2508 |
- wrap => ['select * from (', ') as t where key1 = 1'] |
|
2509 |
-)->all; |
|
2510 |
-is_deeply($rows, [{key1 => 1}]); |
|
2511 |
- |
|
2512 |
-eval { |
|
2513 |
-$dbi->select( |
|
2514 |
- table => 'table1', |
|
2515 |
- column => 'key1', |
|
2516 |
- wrap => 'select * from (' |
|
2517 |
-) |
|
2518 |
-}; |
|
2519 |
-like($@, qr/array/); |
|
2520 |
- |
|
2521 |
-test 'select() string where'; |
|
2522 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2523 |
-$dbi->execute($create_table_default); |
|
2524 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2525 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 3}); |
|
2526 |
-$rows = $dbi->select( |
|
2527 |
- table => 'table1', |
|
2528 |
- where => 'key1 = :key1 and key2 = :key2', |
|
2529 |
- where_param => {key1 => 1, key2 => 2} |
|
2530 |
-)->all; |
|
2531 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
2532 |
- |
|
2533 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2534 |
-$dbi->execute($create_table_default); |
|
2535 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2536 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 3}); |
|
2537 |
-$rows = $dbi->select( |
|
2538 |
- table => 'table1', |
|
2539 |
- where => [ |
|
2540 |
- 'key1 = :key1 and key2 = :key2', |
|
2541 |
- {key1 => 1, key2 => 2} |
|
2542 |
- ] |
|
2543 |
-)->all; |
|
2544 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
2545 |
- |
|
2546 |
-test 'delete() string where'; |
|
2547 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2548 |
-$dbi->execute($create_table_default); |
|
2549 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2550 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 3}); |
|
2551 |
-$dbi->delete( |
|
2552 |
- table => 'table1', |
|
2553 |
- where => 'key1 = :key1 and key2 = :key2', |
|
2554 |
- where_param => {key1 => 1, key2 => 2} |
|
2555 |
-); |
|
2556 |
-$rows = $dbi->select(table => 'table1')->all; |
|
2557 |
-is_deeply($rows, [{key1 => 2, key2 => 3}]); |
|
2558 |
- |
|
2559 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2560 |
-$dbi->execute($create_table_default); |
|
2561 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2562 |
-$dbi->insert(table => 'table1', param => {key1 => 2, key2 => 3}); |
|
2563 |
-$dbi->delete( |
|
2564 |
- table => 'table1', |
|
2565 |
- where => [ |
|
2566 |
- 'key1 = :key1 and key2 = :key2', |
|
2567 |
- {key1 => 1, key2 => 2} |
|
2568 |
- ] |
|
2569 |
-); |
|
2570 |
-$rows = $dbi->select(table => 'table1')->all; |
|
2571 |
-is_deeply($rows, [{key1 => 2, key2 => 3}]); |
|
2572 |
- |
|
2573 |
- |
|
2574 |
-test 'update() string where'; |
|
2575 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2576 |
-$dbi->execute($create_table_default); |
|
2577 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2578 |
-$dbi->update( |
|
2579 |
- table => 'table1', |
|
2580 |
- param => {key1 => 5}, |
|
2581 |
- where => 'key1 = :key1 and key2 = :key2', |
|
2582 |
- where_param => {key1 => 1, key2 => 2} |
|
2583 |
-); |
|
2584 |
-$rows = $dbi->select(table => 'table1')->all; |
|
2585 |
-is_deeply($rows, [{key1 => 5, key2 => 2}]); |
|
2586 |
- |
|
2587 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2588 |
-$dbi->execute($create_table_default); |
|
2589 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2590 |
-$dbi->update( |
|
2591 |
- table => 'table1', |
|
2592 |
- param => {key1 => 5}, |
|
2593 |
- where => [ |
|
2594 |
- 'key1 = :key1 and key2 = :key2', |
|
2595 |
- {key1 => 1, key2 => 2} |
|
2596 |
- ] |
|
2597 |
-); |
|
2598 |
-$rows = $dbi->select(table => 'table1')->all; |
|
2599 |
-is_deeply($rows, [{key1 => 5, key2 => 2}]); |
|
2600 |
- |
|
2601 |
-test 'insert id and primary_key option'; |
|
2602 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2603 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2604 |
-$dbi->insert( |
|
2605 |
- primary_key => ['key1', 'key2'], |
|
2606 |
- table => 'table1', |
|
2607 |
- id => [1, 2], |
|
2608 |
- param => {key3 => 3} |
|
2609 |
-); |
|
2610 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
2611 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
2612 |
-is($dbi->select(table => 'table1')->one->{key3}, 3); |
|
2613 |
- |
|
2614 |
-$dbi->delete_all(table => 'table1'); |
|
2615 |
-$dbi->insert( |
|
2616 |
- primary_key => 'key1', |
|
2617 |
- table => 'table1', |
|
2618 |
- id => 0, |
|
2619 |
- param => {key2 => 2, key3 => 3} |
|
2620 |
-); |
|
2621 |
- |
|
2622 |
-is($dbi->select(table => 'table1')->one->{key1}, 0); |
|
2623 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
2624 |
-is($dbi->select(table => 'table1')->one->{key3}, 3); |
|
2625 |
- |
|
2626 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2627 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2628 |
-$dbi->insert( |
|
2629 |
- {key3 => 3}, |
|
2630 |
- primary_key => ['key1', 'key2'], |
|
2631 |
- table => 'table1', |
|
2632 |
- id => [1, 2], |
|
2633 |
-); |
|
2634 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
2635 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
2636 |
-is($dbi->select(table => 'table1')->one->{key3}, 3); |
|
2637 |
- |
|
2638 |
- |
|
2639 |
-test 'model insert id and primary_key option'; |
|
2640 |
-$dbi = MyDBI6->connect(%memory); |
|
2641 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2642 |
-$dbi->model('table1')->insert( |
|
2643 |
- id => [1, 2], |
|
2644 |
- param => {key3 => 3} |
|
2645 |
-); |
|
2646 |
-$result = $dbi->model('table1')->select; |
|
2647 |
-$row = $result->one; |
|
2648 |
-is($row->{key1}, 1); |
|
2649 |
-is($row->{key2}, 2); |
|
2650 |
-is($row->{key3}, 3); |
|
2651 |
- |
|
2652 |
-$dbi = MyDBI6->connect(%memory); |
|
2653 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2654 |
-$dbi->model('table1')->insert( |
|
2655 |
- {key3 => 3}, |
|
2656 |
- id => [1, 2] |
|
2657 |
-); |
|
2658 |
-$result = $dbi->model('table1')->select; |
|
2659 |
-$row = $result->one; |
|
2660 |
-is($row->{key1}, 1); |
|
2661 |
-is($row->{key2}, 2); |
|
2662 |
-is($row->{key3}, 3); |
|
2663 |
- |
|
2664 |
-test 'update and id option'; |
|
2665 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2666 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2667 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2668 |
-$dbi->update( |
|
2669 |
- table => 'table1', |
|
2670 |
- primary_key => ['key1', 'key2'], |
|
2671 |
- id => [1, 2], |
|
2672 |
- param => {key3 => 4} |
|
2673 |
-); |
|
2674 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
2675 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
2676 |
-is($dbi->select(table => 'table1')->one->{key3}, 4); |
|
2677 |
- |
|
2678 |
-$dbi->delete_all(table => 'table1'); |
|
2679 |
-$dbi->insert(table => 'table1', param => {key1 => 0, key2 => 2, key3 => 3}); |
|
2680 |
-$dbi->update( |
|
2681 |
- table => 'table1', |
|
2682 |
- primary_key => 'key1', |
|
2683 |
- id => 0, |
|
2684 |
- param => {key3 => 4} |
|
2685 |
-); |
|
2686 |
-is($dbi->select(table => 'table1')->one->{key1}, 0); |
|
2687 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
2688 |
-is($dbi->select(table => 'table1')->one->{key3}, 4); |
|
2689 |
- |
|
2690 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2691 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2692 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2693 |
-$dbi->update( |
|
2694 |
- {key3 => 4}, |
|
2695 |
- table => 'table1', |
|
2696 |
- primary_key => ['key1', 'key2'], |
|
2697 |
- id => [1, 2] |
|
2698 |
-); |
|
2699 |
-is($dbi->select(table => 'table1')->one->{key1}, 1); |
|
2700 |
-is($dbi->select(table => 'table1')->one->{key2}, 2); |
|
2701 |
-is($dbi->select(table => 'table1')->one->{key3}, 4); |
|
2702 |
- |
|
2703 |
- |
|
2704 |
-test 'model update and id option'; |
|
2705 |
-$dbi = MyDBI6->connect(%memory); |
|
2706 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2707 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2708 |
-$dbi->model('table1')->update( |
|
2709 |
- id => [1, 2], |
|
2710 |
- param => {key3 => 4} |
|
2711 |
-); |
|
2712 |
-$result = $dbi->model('table1')->select; |
|
2713 |
-$row = $result->one; |
|
2714 |
-is($row->{key1}, 1); |
|
2715 |
-is($row->{key2}, 2); |
|
2716 |
-is($row->{key3}, 4); |
|
2717 |
- |
|
2718 |
- |
|
2719 |
-test 'delete and id option'; |
|
2720 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2721 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2722 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2723 |
-$dbi->delete( |
|
2724 |
- table => 'table1', |
|
2725 |
- primary_key => ['key1', 'key2'], |
|
2726 |
- id => [1, 2], |
|
2727 |
-); |
|
2728 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
2729 |
- |
|
2730 |
-$dbi->insert(table => 'table1', param => {key1 => 0, key2 => 2, key3 => 3}); |
|
2731 |
-$dbi->delete( |
|
2732 |
- table => 'table1', |
|
2733 |
- primary_key => 'key1', |
|
2734 |
- id => 0, |
|
2735 |
-); |
|
2736 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
2737 |
- |
|
2738 |
- |
|
2739 |
-test 'model delete and id option'; |
|
2740 |
-$dbi = MyDBI6->connect(%memory); |
|
2741 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2742 |
-$dbi->execute("create table table2 (key1, key2, key3)"); |
|
2743 |
-$dbi->execute("create table table3 (key1, key2, key3)"); |
|
2744 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2745 |
-$dbi->model('table1')->delete(id => [1, 2]); |
|
2746 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
2747 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2748 |
-$dbi->model('table1_1')->delete(id => [1, 2]); |
|
2749 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
2750 |
-$dbi->insert(table => 'table3', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2751 |
-$dbi->model('table1_3')->delete(id => [1, 2]); |
|
2752 |
-is_deeply($dbi->select(table => 'table1')->all, []); |
|
2753 |
- |
|
2754 |
- |
|
2755 |
-test 'select and id option'; |
|
2756 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2757 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2758 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2759 |
-$result = $dbi->select( |
|
2760 |
- table => 'table1', |
|
2761 |
- primary_key => ['key1', 'key2'], |
|
2762 |
- id => [1, 2] |
|
2763 |
-); |
|
2764 |
-$row = $result->one; |
|
2765 |
-is($row->{key1}, 1); |
|
2766 |
-is($row->{key2}, 2); |
|
2767 |
-is($row->{key3}, 3); |
|
2768 |
- |
|
2769 |
-$dbi->delete_all(table => 'table1'); |
|
2770 |
-$dbi->insert(table => 'table1', param => {key1 => 0, key2 => 2, key3 => 3}); |
|
2771 |
-$result = $dbi->select( |
|
2772 |
- table => 'table1', |
|
2773 |
- primary_key => 'key1', |
|
2774 |
- id => 0, |
|
2775 |
-); |
|
2776 |
-$row = $result->one; |
|
2777 |
-is($row->{key1}, 0); |
|
2778 |
-is($row->{key2}, 2); |
|
2779 |
-is($row->{key3}, 3); |
|
2780 |
- |
|
2781 |
-$dbi->delete_all(table => 'table1'); |
|
2782 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2783 |
-$result = $dbi->select( |
|
2784 |
- table => 'table1', |
|
2785 |
- primary_key => ['key1', 'key2'], |
|
2786 |
- id => [1, 2] |
|
2787 |
-); |
|
2788 |
-$row = $result->one; |
|
2789 |
-is($row->{key1}, 1); |
|
2790 |
-is($row->{key2}, 2); |
|
2791 |
-is($row->{key3}, 3); |
|
2792 |
- |
|
2793 |
- |
|
2794 |
-test 'model select_at'; |
|
2795 |
-$dbi = MyDBI6->connect(%memory); |
|
2796 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
2797 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3}); |
|
2798 |
-$result = $dbi->model('table1')->select(id => [1, 2]); |
|
2799 |
-$row = $result->one; |
|
2800 |
-is($row->{key1}, 1); |
|
2801 |
-is($row->{key2}, 2); |
|
2802 |
-is($row->{key3}, 3); |
|
2803 |
- |
|
2804 |
-test 'column separator is default .'; |
|
2805 |
-$dbi = MyDBI7->connect(%memory); |
|
2806 |
-$dbi->execute($create_table_default); |
|
2807 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
2808 |
-$dbi->setup_model; |
|
2809 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
2810 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 3}); |
|
2811 |
-$model = $dbi->model('table1'); |
|
2812 |
-$result = $model->select( |
|
2813 |
- column => [$model->column('table2')], |
|
2814 |
- where => {'table1.key1' => 1} |
|
2815 |
-); |
|
2816 |
-is_deeply($result->one, |
|
2817 |
- {'table2.key1' => 1, 'table2.key3' => 3}); |
|
2818 |
- |
|
2819 |
-$result = $model->select( |
|
2820 |
- column => [$model->column('table2' => [qw/key1 key3/])], |
|
2821 |
- where => {'table1.key1' => 1} |
|
2822 |
-); |
|
2823 |
-is_deeply($result->one, |
|
2824 |
- {'table2.key1' => 1, 'table2.key3' => 3}); |
|
2825 |
- |
|
2826 |
- |
|
2827 |
-test 'type_rule from'; |
|
2828 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2829 |
-$dbi->type_rule( |
|
2830 |
- from1 => { |
|
2831 |
- date => sub { uc $_[0] } |
|
2832 |
- } |
|
2833 |
-); |
|
2834 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2835 |
-$dbi->insert({key1 => 'a'}, table => 'table1'); |
|
2836 |
-$result = $dbi->select(table => 'table1'); |
|
2837 |
-is($result->fetch_first->[0], 'A'); |
|
2838 |
- |
|
2839 |
-$result = $dbi->select(table => 'table1'); |
|
2840 |
-is($result->one->{key1}, 'A'); |
|
2841 |
- |
|
2842 |
- |
|
2843 |
-test 'type_rule into'; |
|
2844 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2845 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2846 |
-$dbi->type_rule( |
|
2847 |
- into1 => { |
|
2848 |
- date => sub { uc $_[0] } |
|
2849 |
- } |
|
2850 |
-); |
|
2851 |
-$dbi->insert({key1 => 'a'}, table => 'table1'); |
|
2852 |
-$result = $dbi->select(table => 'table1'); |
|
2853 |
-is($result->one->{key1}, 'A'); |
|
2854 |
- |
|
2855 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2856 |
-$dbi->execute("create table table1 (key1 date, key2 datetime)"); |
|
2857 |
-$dbi->type_rule( |
|
2858 |
- into1 => [ |
|
2859 |
- [qw/date datetime/] => sub { uc $_[0] } |
|
2860 |
- ] |
|
2861 |
-); |
|
2862 |
-$dbi->insert({key1 => 'a', key2 => 'b'}, table => 'table1'); |
|
2863 |
-$result = $dbi->select(table => 'table1'); |
|
2864 |
-$row = $result->one; |
|
2865 |
-is($row->{key1}, 'A'); |
|
2866 |
-is($row->{key2}, 'B'); |
|
2867 |
- |
|
2868 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2869 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2870 |
-$dbi->insert({key1 => 'a', key2 => 'B'}, table => 'table1'); |
|
2871 |
-$dbi->type_rule( |
|
2872 |
- into1 => [ |
|
2873 |
- [qw/date datetime/] => sub { uc $_[0] } |
|
2874 |
- ] |
|
2875 |
-); |
|
2876 |
-$result = $dbi->execute( |
|
2877 |
- "select * from table1 where key1 = :key1 and key2 = :table1.key2;", |
|
2878 |
- param => {key1 => 'a', 'table1.key2' => 'b'} |
|
2879 |
-); |
|
2880 |
-$row = $result->one; |
|
2881 |
-is($row->{key1}, 'a'); |
|
2882 |
-is($row->{key2}, 'B'); |
|
2883 |
- |
|
2884 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2885 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2886 |
-$dbi->insert({key1 => 'A', key2 => 'B'}, table => 'table1'); |
|
2887 |
-$dbi->type_rule( |
|
2888 |
- into1 => [ |
|
2889 |
- [qw/date datetime/] => sub { uc $_[0] } |
|
2890 |
- ] |
|
2891 |
-); |
|
2892 |
-$result = $dbi->execute( |
|
2893 |
- "select * from table1 where key1 = :key1 and key2 = :table1.key2;", |
|
2894 |
- param => {key1 => 'a', 'table1.key2' => 'b'}, |
|
2895 |
- table => 'table1' |
|
2896 |
-); |
|
2897 |
-$row = $result->one; |
|
2898 |
-is($row->{key1}, 'A'); |
|
2899 |
-is($row->{key2}, 'B'); |
|
2900 |
- |
|
2901 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2902 |
-$dbi->execute("create table table1 (key1 date, key2 datetime)"); |
|
2903 |
-$dbi->register_filter(twice => sub { $_[0] * 2 }); |
|
2904 |
-$dbi->type_rule( |
|
2905 |
- from1 => { |
|
2906 |
- date => 'twice', |
|
2907 |
- }, |
|
2908 |
- into1 => { |
|
2909 |
- date => 'twice', |
|
2910 |
- } |
|
2911 |
-); |
|
2912 |
-$dbi->insert({key1 => 2}, table => 'table1'); |
|
2913 |
-$result = $dbi->select(table => 'table1'); |
|
2914 |
-is($result->fetch->[0], 8); |
|
2915 |
- |
|
2916 |
-test 'type_rule and filter order'; |
|
2917 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2918 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2919 |
-$dbi->type_rule( |
|
2920 |
- into1 => { |
|
2921 |
- date => sub { $_[0] . 'b' } |
|
2922 |
- }, |
|
2923 |
- into2 => { |
|
2924 |
- date => sub { $_[0] . 'c' } |
|
2925 |
- }, |
|
2926 |
- from1 => { |
|
2927 |
- date => sub { $_[0] . 'd' } |
|
2928 |
- }, |
|
2929 |
- from2 => { |
|
2930 |
- date => sub { $_[0] . 'e' } |
|
2931 |
- } |
|
2932 |
-); |
|
2933 |
-$dbi->insert({key1 => '1'}, table => 'table1', filter => {key1 => sub { $_[0] . 'a' }}); |
|
2934 |
-$result = $dbi->select(table => 'table1'); |
|
2935 |
-$result->filter(key1 => sub { $_[0] . 'f' }); |
|
2936 |
-is($result->fetch_first->[0], '1abcdef'); |
|
2937 |
- |
|
2938 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2939 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2940 |
-$dbi->type_rule( |
|
2941 |
- from1 => { |
|
2942 |
- date => sub { $_[0] . 'p' } |
|
2943 |
- }, |
|
2944 |
- from2 => { |
|
2945 |
- date => sub { $_[0] . 'q' } |
|
2946 |
- }, |
|
2947 |
-); |
|
2948 |
-$dbi->insert({key1 => '1'}, table => 'table1'); |
|
2949 |
-$result = $dbi->select(table => 'table1'); |
|
2950 |
-$result->type_rule( |
|
2951 |
- from1 => { |
|
2952 |
- date => sub { $_[0] . 'd' } |
|
2953 |
- }, |
|
2954 |
- from2 => { |
|
2955 |
- date => sub { $_[0] . 'e' } |
|
2956 |
- } |
|
2957 |
-); |
|
2958 |
-$result->filter(key1 => sub { $_[0] . 'f' }); |
|
2959 |
-is($result->fetch_first->[0], '1def'); |
|
2960 |
- |
|
2961 |
-test 'type_rule_off'; |
|
2962 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2963 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2964 |
-$dbi->type_rule( |
|
2965 |
- from1 => { |
|
2966 |
- date => sub { $_[0] * 2 }, |
|
2967 |
- }, |
|
2968 |
- into1 => { |
|
2969 |
- date => sub { $_[0] * 2 }, |
|
2970 |
- } |
|
2971 |
-); |
|
2972 |
-$dbi->insert({key1 => 2}, table => 'table1', type_rule_off => 1); |
|
2973 |
-$result = $dbi->select(table => 'table1', type_rule_off => 1); |
|
2974 |
-is($result->type_rule_off->fetch->[0], 2); |
|
2975 |
- |
|
2976 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2977 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2978 |
-$dbi->type_rule( |
|
2979 |
- from1 => { |
|
2980 |
- date => sub { $_[0] * 2 }, |
|
2981 |
- }, |
|
2982 |
- into1 => { |
|
2983 |
- date => sub { $_[0] * 3 }, |
|
2984 |
- } |
|
2985 |
-); |
|
2986 |
-$dbi->insert({key1 => 2}, table => 'table1', type_rule_off => 1); |
|
2987 |
-$result = $dbi->select(table => 'table1', type_rule_off => 1); |
|
2988 |
-is($result->one->{key1}, 4); |
|
2989 |
- |
|
2990 |
-$dbi = DBIx::Custom->connect(%memory); |
|
2991 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
2992 |
-$dbi->type_rule( |
|
2993 |
- from1 => { |
|
2994 |
- date => sub { $_[0] * 2 }, |
|
2995 |
- }, |
|
2996 |
- into1 => { |
|
2997 |
- date => sub { $_[0] * 3 }, |
|
2998 |
- } |
|
2999 |
-); |
|
3000 |
-$dbi->insert({key1 => 2}, table => 'table1'); |
|
3001 |
-$result = $dbi->select(table => 'table1'); |
|
3002 |
-is($result->one->{key1}, 12); |
|
3003 |
- |
|
3004 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3005 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3006 |
-$dbi->type_rule( |
|
3007 |
- from1 => { |
|
3008 |
- date => sub { $_[0] * 2 }, |
|
3009 |
- }, |
|
3010 |
- into1 => { |
|
3011 |
- date => sub { $_[0] * 3 }, |
|
3012 |
- } |
|
3013 |
-); |
|
3014 |
-$dbi->insert({key1 => 2}, table => 'table1'); |
|
3015 |
-$result = $dbi->select(table => 'table1'); |
|
3016 |
-is($result->fetch->[0], 12); |
|
3017 |
- |
|
3018 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3019 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3020 |
-$dbi->register_filter(ppp => sub { uc $_[0] }); |
|
3021 |
-$dbi->type_rule( |
|
3022 |
- into1 => { |
|
3023 |
- date => 'ppp' |
|
3024 |
- } |
|
3025 |
-); |
|
3026 |
-$dbi->insert({key1 => 'a'}, table => 'table1'); |
|
3027 |
-$result = $dbi->select(table => 'table1'); |
|
3028 |
-is($result->one->{key1}, 'A'); |
|
3029 |
- |
|
3030 |
-eval{$dbi->type_rule( |
|
3031 |
- into1 => { |
|
3032 |
- date => 'pp' |
|
3033 |
- } |
|
3034 |
-)}; |
|
3035 |
-like($@, qr/not registered/); |
|
3036 |
- |
|
3037 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3038 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3039 |
-eval { |
|
3040 |
- $dbi->type_rule( |
|
3041 |
- from1 => { |
|
3042 |
- Date => sub { $_[0] * 2 }, |
|
3043 |
- } |
|
3044 |
- ); |
|
3045 |
-}; |
|
3046 |
-like($@, qr/lower/); |
|
3047 |
- |
|
3048 |
-eval { |
|
3049 |
- $dbi->type_rule( |
|
3050 |
- into1 => { |
|
3051 |
- Date => sub { $_[0] * 2 }, |
|
3052 |
- } |
|
3053 |
- ); |
|
3054 |
-}; |
|
3055 |
-like($@, qr/lower/); |
|
3056 |
- |
|
3057 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3058 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3059 |
-$dbi->type_rule( |
|
3060 |
- from1 => { |
|
3061 |
- date => sub { $_[0] * 2 }, |
|
3062 |
- }, |
|
3063 |
- into1 => { |
|
3064 |
- date => sub { $_[0] * 3 }, |
|
3065 |
- } |
|
3066 |
-); |
|
3067 |
-$dbi->insert({key1 => 2}, table => 'table1'); |
|
3068 |
-$result = $dbi->select(table => 'table1'); |
|
3069 |
-$result->type_rule_off; |
|
3070 |
-is($result->one->{key1}, 6); |
|
3071 |
- |
|
3072 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3073 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3074 |
-$dbi->type_rule( |
|
3075 |
- from1 => { |
|
3076 |
- date => sub { $_[0] * 2 }, |
|
3077 |
- datetime => sub { $_[0] * 4 }, |
|
3078 |
- }, |
|
3079 |
-); |
|
3080 |
-$dbi->insert({key1 => 2, key2 => 2}, table => 'table1'); |
|
3081 |
-$result = $dbi->select(table => 'table1'); |
|
3082 |
-$result->type_rule( |
|
3083 |
- from1 => { |
|
3084 |
- date => sub { $_[0] * 3 } |
|
3085 |
- } |
|
3086 |
-); |
|
3087 |
-$row = $result->one; |
|
3088 |
-is($row->{key1}, 6); |
|
3089 |
-is($row->{key2}, 2); |
|
3090 |
- |
|
3091 |
-$result = $dbi->select(table => 'table1'); |
|
3092 |
-$result->type_rule( |
|
3093 |
- from1 => { |
|
3094 |
- date => sub { $_[0] * 3 } |
|
3095 |
- } |
|
3096 |
-); |
|
3097 |
-$row = $result->one; |
|
3098 |
-is($row->{key1}, 6); |
|
3099 |
-is($row->{key2}, 2); |
|
3100 |
- |
|
3101 |
-$result = $dbi->select(table => 'table1'); |
|
3102 |
-$result->type_rule( |
|
3103 |
- from1 => { |
|
3104 |
- date => sub { $_[0] * 3 } |
|
3105 |
- } |
|
3106 |
-); |
|
3107 |
-$row = $result->one; |
|
3108 |
-is($row->{key1}, 6); |
|
3109 |
-is($row->{key2}, 2); |
|
3110 |
-$result = $dbi->select(table => 'table1'); |
|
3111 |
-$result->type_rule( |
|
3112 |
- from1 => [date => sub { $_[0] * 3 }] |
|
3113 |
-); |
|
3114 |
-$row = $result->one; |
|
3115 |
-is($row->{key1}, 6); |
|
3116 |
-is($row->{key2}, 2); |
|
3117 |
-$dbi->register_filter(fivetimes => sub { $_[0] * 5}); |
|
3118 |
-$result = $dbi->select(table => 'table1'); |
|
3119 |
-$result->type_rule( |
|
3120 |
- from1 => [date => 'fivetimes'] |
|
3121 |
-); |
|
3122 |
-$row = $result->one; |
|
3123 |
-is($row->{key1}, 10); |
|
3124 |
-is($row->{key2}, 2); |
|
3125 |
-$result = $dbi->select(table => 'table1'); |
|
3126 |
-$result->type_rule( |
|
3127 |
- from1 => [date => undef] |
|
3128 |
-); |
|
3129 |
-$row = $result->one; |
|
3130 |
-is($row->{key1}, 2); |
|
3131 |
-is($row->{key2}, 2); |
|
3132 |
- |
|
3133 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3134 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3135 |
-$dbi->type_rule( |
|
3136 |
- from1 => { |
|
3137 |
- date => sub { $_[0] * 2 }, |
|
3138 |
- }, |
|
3139 |
-); |
|
3140 |
-$dbi->insert({key1 => 2}, table => 'table1'); |
|
3141 |
-$result = $dbi->select(table => 'table1'); |
|
3142 |
-$result->filter(key1 => sub { $_[0] * 3 }); |
|
3143 |
-is($result->one->{key1}, 12); |
|
3144 |
- |
|
3145 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3146 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3147 |
-$dbi->type_rule( |
|
3148 |
- from1 => { |
|
3149 |
- date => sub { $_[0] * 2 }, |
|
3150 |
- }, |
|
3151 |
-); |
|
3152 |
-$dbi->insert({key1 => 2}, table => 'table1'); |
|
3153 |
-$result = $dbi->select(table => 'table1'); |
|
3154 |
-$result->filter(key1 => sub { $_[0] * 3 }); |
|
3155 |
-is($result->fetch->[0], 12); |
|
3156 |
- |
|
3157 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3158 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3159 |
-$dbi->type_rule( |
|
3160 |
- into1 => { |
|
3161 |
- date => sub { $_[0] . 'b' } |
|
3162 |
- }, |
|
3163 |
- into2 => { |
|
3164 |
- date => sub { $_[0] . 'c' } |
|
3165 |
- }, |
|
3166 |
- from1 => { |
|
3167 |
- date => sub { $_[0] . 'd' } |
|
3168 |
- }, |
|
3169 |
- from2 => { |
|
3170 |
- date => sub { $_[0] . 'e' } |
|
3171 |
- } |
|
3172 |
-); |
|
3173 |
-$dbi->insert({key1 => '1'}, table => 'table1', type_rule_off => 1); |
|
3174 |
-$result = $dbi->select(table => 'table1'); |
|
3175 |
-is($result->type_rule_off->fetch_first->[0], '1'); |
|
3176 |
-$result = $dbi->select(table => 'table1'); |
|
3177 |
-is($result->type_rule_on->fetch_first->[0], '1de'); |
|
3178 |
- |
|
3179 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3180 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3181 |
-$dbi->type_rule( |
|
3182 |
- into1 => { |
|
3183 |
- date => sub { $_[0] . 'b' } |
|
3184 |
- }, |
|
3185 |
- into2 => { |
|
3186 |
- date => sub { $_[0] . 'c' } |
|
3187 |
- }, |
|
3188 |
- from1 => { |
|
3189 |
- date => sub { $_[0] . 'd' } |
|
3190 |
- }, |
|
3191 |
- from2 => { |
|
3192 |
- date => sub { $_[0] . 'e' } |
|
3193 |
- } |
|
3194 |
-); |
|
3195 |
-$dbi->insert({key1 => '1'}, table => 'table1', type_rule1_off => 1); |
|
3196 |
-$result = $dbi->select(table => 'table1'); |
|
3197 |
-is($result->type_rule1_off->fetch_first->[0], '1ce'); |
|
3198 |
-$result = $dbi->select(table => 'table1'); |
|
3199 |
-is($result->type_rule1_on->fetch_first->[0], '1cde'); |
|
3200 |
- |
|
3201 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3202 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3203 |
-$dbi->type_rule( |
|
3204 |
- into1 => { |
|
3205 |
- date => sub { $_[0] . 'b' } |
|
3206 |
- }, |
|
3207 |
- into2 => { |
|
3208 |
- date => sub { $_[0] . 'c' } |
|
3209 |
- }, |
|
3210 |
- from1 => { |
|
3211 |
- date => sub { $_[0] . 'd' } |
|
3212 |
- }, |
|
3213 |
- from2 => { |
|
3214 |
- date => sub { $_[0] . 'e' } |
|
3215 |
- } |
|
3216 |
-); |
|
3217 |
-$dbi->insert({key1 => '1'}, table => 'table1', type_rule2_off => 1); |
|
3218 |
-$result = $dbi->select(table => 'table1'); |
|
3219 |
-is($result->type_rule2_off->fetch_first->[0], '1bd'); |
|
3220 |
-$result = $dbi->select(table => 'table1'); |
|
3221 |
-is($result->type_rule2_on->fetch_first->[0], '1bde'); |
|
3222 |
- |
|
3223 |
-test 'separator'; |
|
3224 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3225 |
-$dbi->execute($create_table_default); |
|
3226 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
3227 |
- |
|
3228 |
-$dbi->create_model( |
|
3229 |
- table => 'table1', |
|
3230 |
- join => [ |
|
3231 |
- 'left outer join table2 on table1.key1 = table2.key1' |
|
3232 |
- ], |
|
3233 |
- primary_key => ['key1'], |
|
3234 |
-); |
|
3235 |
-$model2 = $dbi->create_model( |
|
3236 |
- table => 'table2', |
|
3237 |
-); |
|
3238 |
-$dbi->setup_model; |
|
3239 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
3240 |
-$dbi->insert(table => 'table2', param => {key1 => 1, key3 => 3}); |
|
3241 |
-$model = $dbi->model('table1'); |
|
3242 |
-$result = $model->select( |
|
3243 |
- column => [ |
|
3244 |
- $model->mycolumn, |
|
3245 |
- {table2 => [qw/key1 key3/]} |
|
3246 |
- ], |
|
3247 |
- where => {'table1.key1' => 1} |
|
3248 |
-); |
|
3249 |
-is_deeply($result->one, |
|
3250 |
- {key1 => 1, key2 => 2, 'table2.key1' => 1, 'table2.key3' => 3}); |
|
3251 |
-is_deeply($model2->select->one, {key1 => 1, key3 => 3}); |
|
3252 |
- |
|
3253 |
-$dbi->separator('__'); |
|
3254 |
-$model = $dbi->model('table1'); |
|
3255 |
-$result = $model->select( |
|
3256 |
- column => [ |
|
3257 |
- $model->mycolumn, |
|
3258 |
- {table2 => [qw/key1 key3/]} |
|
3259 |
- ], |
|
3260 |
- where => {'table1.key1' => 1} |
|
3261 |
-); |
|
3262 |
-is_deeply($result->one, |
|
3263 |
- {key1 => 1, key2 => 2, 'table2__key1' => 1, 'table2__key3' => 3}); |
|
3264 |
-is_deeply($model2->select->one, {key1 => 1, key3 => 3}); |
|
3265 |
- |
|
3266 |
-$dbi->separator('-'); |
|
3267 |
-$model = $dbi->model('table1'); |
|
3268 |
-$result = $model->select( |
|
3269 |
- column => [ |
|
3270 |
- $model->mycolumn, |
|
3271 |
- {table2 => [qw/key1 key3/]} |
|
3272 |
- ], |
|
3273 |
- where => {'table1.key1' => 1} |
|
3274 |
-); |
|
3275 |
-is_deeply($result->one, |
|
3276 |
- {key1 => 1, key2 => 2, 'table2-key1' => 1, 'table2-key3' => 3}); |
|
3277 |
-is_deeply($model2->select->one, {key1 => 1, key3 => 3}); |
|
3278 |
- |
|
3279 |
- |
|
3280 |
-test 'filter_off'; |
|
3281 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3282 |
-$dbi->execute($create_table_default); |
|
3283 |
-$dbi->execute('create table table2 (key1 char(255), key3 char(255));'); |
|
3284 |
- |
|
3285 |
-$dbi->create_model( |
|
3286 |
- table => 'table1', |
|
3287 |
- join => [ |
|
3288 |
- 'left outer join table2 on table1.key1 = table2.key1' |
|
3289 |
- ], |
|
3290 |
- primary_key => ['key1'], |
|
3291 |
-); |
|
3292 |
-$dbi->setup_model; |
|
3293 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
3294 |
-$model = $dbi->model('table1'); |
|
3295 |
-$result = $model->select(column => 'key1'); |
|
3296 |
-$result->filter(key1 => sub { $_[0] * 2 }); |
|
3297 |
-is_deeply($result->one, {key1 => 2}); |
|
3298 |
- |
|
3299 |
-test 'available_date_type'; |
|
3300 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3301 |
-ok($dbi->can('available_data_type')); |
|
3302 |
- |
|
3303 |
- |
|
3304 |
-test 'select prefix option'; |
|
3305 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3306 |
-$dbi->execute($create_table_default); |
|
3307 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
3308 |
-$rows = $dbi->select(prefix => 'key1,', column => 'key2', table => 'table1')->all; |
|
3309 |
-is_deeply($rows, [{key1 => 1, key2 => 2}], "table"); |
|
3310 |
- |
|
3311 |
- |
|
3312 |
-test 'separator'; |
|
3313 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3314 |
-is($dbi->separator, '.'); |
|
3315 |
-$dbi->separator('-'); |
|
3316 |
-is($dbi->separator, '-'); |
|
3317 |
-$dbi->separator('__'); |
|
3318 |
-is($dbi->separator, '__'); |
|
3319 |
-eval { $dbi->separator('?') }; |
|
3320 |
-like($@, qr/Separator/); |
|
3321 |
- |
|
3322 |
- |
|
3323 |
-test 'map_param'; |
|
3324 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3325 |
-$param = $dbi->map_param( |
|
3326 |
- {id => 1, author => 'Ken', price => 1900}, |
|
3327 |
- id => 'book.id', |
|
3328 |
- author => ['book.author', sub { '%' . $_[0] . '%' }], |
|
3329 |
- price => ['book.price', {if => sub { $_[0] eq 1900 }}] |
|
3330 |
-); |
|
3331 |
-is_deeply($param, {'book.id' => 1, 'book.author' => '%Ken%', |
|
3332 |
- 'book.price' => 1900}); |
|
3333 |
- |
|
3334 |
-$param = $dbi->map_param( |
|
3335 |
- {id => 0, author => 0, price => 0}, |
|
3336 |
- id => 'book.id', |
|
3337 |
- author => ['book.author', sub { '%' . $_[0] . '%' }], |
|
3338 |
- price => ['book.price', sub { '%' . $_[0] . '%' }, |
|
3339 |
- {if => sub { $_[0] eq 0 }}] |
|
3340 |
-); |
|
3341 |
-is_deeply($param, {'book.id' => 0, 'book.author' => '%0%', 'book.price' => '%0%'}); |
|
3342 |
- |
|
3343 |
-$param = $dbi->map_param( |
|
3344 |
- {id => '', author => '', price => ''}, |
|
3345 |
- id => 'book.id', |
|
3346 |
- author => ['book.author', sub { '%' . $_[0] . '%' }], |
|
3347 |
- price => ['book.price', sub { '%' . $_[0] . '%' }, |
|
3348 |
- {if => sub { $_[0] eq 1 }}] |
|
3349 |
-); |
|
3350 |
-is_deeply($param, {}); |
|
3351 |
- |
|
3352 |
-$param = $dbi->map_param( |
|
3353 |
- {id => undef, author => undef, price => undef}, |
|
3354 |
- id => 'book.id', |
|
3355 |
- price => ['book.price', {if => 'exists'}] |
|
3356 |
-); |
|
3357 |
-is_deeply($param, {'book.price' => undef}); |
|
3358 |
- |
|
3359 |
-$param = $dbi->map_param( |
|
3360 |
- {price => 'a'}, |
|
3361 |
- id => ['book.id', {if => 'exists'}], |
|
3362 |
- price => ['book.price', sub { '%' . $_[0] }, {if => 'exists'}] |
|
3363 |
-); |
|
3364 |
-is_deeply($param, {'book.price' => '%a'}); |
|
3365 |
- |
|
3366 |
- |
|
3367 |
-test 'table_alias'; |
|
3368 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3369 |
-$dbi->execute("create table table1 (key1 Date, key2 datetime)"); |
|
3370 |
-$dbi->type_rule( |
|
3371 |
- into1 => { |
|
3372 |
- date => sub { uc $_[0] } |
|
3373 |
- } |
|
3374 |
-); |
|
3375 |
-$dbi->execute("insert into table1 (key1) values (:table2.key1)", {'table2.key1' => 'a'}, |
|
3376 |
- table_alias => {table2 => 'table1'}); |
|
3377 |
-$result = $dbi->select(table => 'table1'); |
|
3378 |
-is($result->one->{key1}, 'A'); |
|
3379 |
- |
|
3380 |
- |
|
3381 |
-test 'order'; |
|
3382 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3383 |
-$dbi->execute("create table table1 (key1, key2)"); |
|
3384 |
-$dbi->insert({key1 => 1, key2 => 1}, table => 'table1'); |
|
3385 |
-$dbi->insert({key1 => 1, key2 => 3}, table => 'table1'); |
|
3386 |
-$dbi->insert({key1 => 2, key2 => 2}, table => 'table1'); |
|
3387 |
-$dbi->insert({key1 => 2, key2 => 4}, table => 'table1'); |
|
3388 |
-my $order = $dbi->order; |
|
3389 |
-$order->prepend('key1', 'key2 desc'); |
|
3390 |
-$result = $dbi->select(table => 'table1', append => "$order"); |
|
3391 |
-is_deeply($result->all, [{key1 => 1, key2 => 3}, {key1 => 1, key2 => 1}, |
|
3392 |
- {key1 => 2, key2 => 4}, {key1 => 2, key2 => 2}]); |
|
3393 |
-$order->prepend('key1 desc'); |
|
3394 |
-$result = $dbi->select(table => 'table1', append => "$order"); |
|
3395 |
-is_deeply($result->all, [{key1 => 2, key2 => 4}, {key1 => 2, key2 => 2}, |
|
3396 |
- {key1 => 1, key2 => 3}, {key1 => 1, key2 => 1}]); |
|
3397 |
- |
|
3398 |
-$order = $dbi->order; |
|
3399 |
-$order->prepend(['table1-key1'], [qw/table1-key2 desc/]); |
|
3400 |
-$result = $dbi->select(table => 'table1', |
|
3401 |
- column => [[key1 => 'table1-key1'], [key2 => 'table1-key2']], |
|
3402 |
- append => "$order"); |
|
3403 |
-is_deeply($result->all, [{'table1-key1' => 1, 'table1-key2' => 3}, |
|
3404 |
- {'table1-key1' => 1, 'table1-key2' => 1}, |
|
3405 |
- {'table1-key1' => 2, 'table1-key2' => 4}, |
|
3406 |
- {'table1-key1' => 2, 'table1-key2' => 2}]); |
|
3407 |
- |
|
3408 |
-test 'tag_parse'; |
|
3409 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3410 |
-$dbi->tag_parse(0); |
|
3411 |
-$dbi->execute("create table table1 (key1, key2)"); |
|
3412 |
-$dbi->insert({key1 => 1, key2 => 1}, table => 'table1'); |
|
3413 |
-eval {$dbi->execute("select * from table1 where {= key1}", {key1 => 1})}; |
|
3414 |
-ok($@); |
|
3415 |
- |
|
3416 |
-test 'last_sql'; |
|
3417 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3418 |
-$dbi->execute("create table table1 (key1, key2)"); |
|
3419 |
-$dbi->execute('select * from table1'); |
|
3420 |
-is($dbi->last_sql, 'select * from table1;'); |
|
3421 |
- |
|
3422 |
-eval{$dbi->execute("aaa")}; |
|
3423 |
-is($dbi->last_sql, 'aaa;'); |
|
3424 |
- |
|
3425 |
-test 'DBIx::Custom header'; |
|
3426 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3427 |
-$dbi->execute("create table table1 (key1, key2)"); |
|
3428 |
-$result = $dbi->execute('select key1 as h1, key2 as h2 from table1'); |
|
3429 |
-is_deeply($result->header, [qw/h1 h2/]); |
|
3430 |
- |
|
3431 |
-test 'Named placeholder :name(operater) syntax'; |
|
3432 |
-$dbi->execute('drop table table1'); |
|
3433 |
-$dbi->execute('create table table1 (key1 char(255), key2 char(255), key3 char(255), key4 char(255), key5 char(255));'); |
|
3434 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}); |
|
3435 |
-$dbi->insert(table => 'table1', param => {key1 => 6, key2 => 7, key3 => 8, key4 => 9, key5 => 10}); |
|
3436 |
- |
|
3437 |
-$source = "select * from table1 where :key1{=} and :key2{=}"; |
|
3438 |
-$result = $dbi->execute($source, param => {key1 => 1, key2 => 2}); |
|
3439 |
-$rows = $result->all; |
|
3440 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}]); |
|
3441 |
- |
|
3442 |
-$source = "select * from table1 where :key1{ = } and :key2{=}"; |
|
3443 |
-$result = $dbi->execute($source, param => {key1 => 1, key2 => 2}); |
|
3444 |
-$rows = $result->all; |
|
3445 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}]); |
|
3446 |
- |
|
3447 |
-$source = "select * from table1 where :key1{<} and :key2{=}"; |
|
3448 |
-$result = $dbi->execute($source, param => {key1 => 5, key2 => 2}); |
|
3449 |
-$rows = $result->all; |
|
3450 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}]); |
|
3451 |
- |
|
3452 |
-$source = "select * from table1 where :table1.key1{=} and :table1.key2{=}"; |
|
3453 |
-$result = $dbi->execute( |
|
3454 |
- $source, |
|
3455 |
- param => {'table1.key1' => 1, 'table1.key2' => 1}, |
|
3456 |
- filter => {'table1.key2' => sub { $_[0] * 2 }} |
|
3457 |
-); |
|
3458 |
-$rows = $result->all; |
|
3459 |
-is_deeply($rows, [{key1 => 1, key2 => 2, key3 => 3, key4 => 4, key5 => 5}]); |
|
3460 |
- |
|
3461 |
-test 'high perfomance way'; |
|
3462 |
-$dbi->execute('drop table table1'); |
|
3463 |
-$dbi->execute("create table table1 (ab, bc, ik, hi, ui, pq, dc);"); |
|
3464 |
-$rows = [ |
|
3465 |
- {ab => 1, bc => 2, ik => 3, hi => 4, ui => 5, pq => 6, dc => 7}, |
|
3466 |
- {ab => 1, bc => 2, ik => 3, hi => 4, ui => 5, pq => 6, dc => 8}, |
|
3467 |
-]; |
|
3468 |
-{ |
|
3469 |
- my $query; |
|
3470 |
- foreach my $row (@$rows) { |
|
3471 |
- $query ||= $dbi->insert($row, table => 'table1', query => 1); |
|
3472 |
- $dbi->execute($query, $row, filter => {ab => sub { $_[0] * 2 }}); |
|
3473 |
- } |
|
3474 |
- is_deeply($dbi->select(table => 'table1')->all, |
|
3475 |
- [ |
|
3476 |
- {ab => 2, bc => 2, ik => 3, hi => 4, ui => 5, pq => 6, dc => 7}, |
|
3477 |
- {ab => 2, bc => 2, ik => 3, hi => 4, ui => 5, pq => 6, dc => 8}, |
|
3478 |
- ] |
|
3479 |
- ); |
|
3480 |
-} |
|
3481 |
- |
|
3482 |
-$dbi->execute('drop table table1'); |
|
3483 |
-$dbi->execute("create table table1 (ab, bc, ik, hi, ui, pq, dc);"); |
|
3484 |
-$rows = [ |
|
3485 |
- {ab => 1, bc => 2, ik => 3, hi => 4, ui => 5, pq => 6, dc => 7}, |
|
3486 |
- {ab => 1, bc => 2, ik => 3, hi => 4, ui => 5, pq => 6, dc => 8}, |
|
3487 |
-]; |
|
3488 |
-{ |
|
3489 |
- my $query; |
|
3490 |
- my $sth; |
|
3491 |
- foreach my $row (@$rows) { |
|
3492 |
- $query ||= $dbi->insert($row, table => 'table1', query => 1); |
|
3493 |
- $sth ||= $query->sth; |
|
3494 |
- $sth->execute(map { $row->{$_} } sort keys %$row); |
|
3495 |
- } |
|
3496 |
- is_deeply($dbi->select(table => 'table1')->all, |
|
3497 |
- [ |
|
3498 |
- {ab => 1, bc => 2, ik => 3, hi => 4, ui => 5, pq => 6, dc => 7}, |
|
3499 |
- {ab => 1, bc => 2, ik => 3, hi => 4, ui => 5, pq => 6, dc => 8}, |
|
3500 |
- ] |
|
3501 |
- ); |
|
3502 |
-} |
|
3503 |
- |
|
3504 |
-test 'result'; |
|
3505 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3506 |
-$dbi->execute($create_table_default); |
|
3507 |
-$dbi->insert({key1 => 1, key2 => 2}, table => 'table1'); |
|
3508 |
-$dbi->insert({key1 => 3, key2 => 4}, table => 'table1'); |
|
3509 |
- |
|
3510 |
-$result = $dbi->select(table => 'table1'); |
|
3511 |
-@rows = (); |
|
3512 |
-while (my $row = $result->fetch) { |
|
3513 |
- push @rows, [@$row]; |
|
3514 |
-} |
|
3515 |
-is_deeply(\@rows, [[1, 2], [3, 4]]); |
|
3516 |
- |
|
3517 |
-$result = $dbi->select(table => 'table1'); |
|
3518 |
-@rows = (); |
|
3519 |
-while (my $row = $result->fetch_hash) { |
|
3520 |
- push @rows, {%$row}; |
|
3521 |
-} |
|
3522 |
-is_deeply(\@rows, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]); |
|
3523 |
- |
|
3524 |
-$result = $dbi->select(table => 'table1'); |
|
3525 |
-$row = $result->fetch_first; |
|
3526 |
-is_deeply($row, [1, 2], "row"); |
|
3527 |
-$row = $result->fetch; |
|
3528 |
-ok(!$row, "finished"); |
|
3529 |
- |
|
3530 |
-$result = $dbi->select(table => 'table1'); |
|
3531 |
-$row = $result->fetch_hash_first; |
|
3532 |
-is_deeply($row, {key1 => 1, key2 => 2}, "row"); |
|
3533 |
-$row = $result->fetch_hash; |
|
3534 |
-ok(!$row, "finished"); |
|
3535 |
- |
|
3536 |
-$dbi->execute('create table table2 (key1, key2);'); |
|
3537 |
-$result = $dbi->select(table => 'table2'); |
|
3538 |
-$row = $result->fetch_hash_first; |
|
3539 |
-ok(!$row, "no row fetch"); |
|
3540 |
- |
|
3541 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3542 |
-$dbi->execute($create_table_default); |
|
3543 |
-$dbi->insert({key1 => 1, key2 => 2}, table => 'table1'); |
|
3544 |
-$dbi->insert({key1 => 3, key2 => 4}, table => 'table1'); |
|
3545 |
-$dbi->insert({key1 => 5, key2 => 6}, table => 'table1'); |
|
3546 |
-$dbi->insert({key1 => 7, key2 => 8}, table => 'table1'); |
|
3547 |
-$dbi->insert({key1 => 9, key2 => 10}, table => 'table1'); |
|
3548 |
-$result = $dbi->select(table => 'table1'); |
|
3549 |
-$rows = $result->fetch_multi(2); |
|
3550 |
-is_deeply($rows, [[1, 2], |
|
3551 |
- [3, 4]], "fetch_multi first"); |
|
3552 |
-$rows = $result->fetch_multi(2); |
|
3553 |
-is_deeply($rows, [[5, 6], |
|
3554 |
- [7, 8]], "fetch_multi secound"); |
|
3555 |
-$rows = $result->fetch_multi(2); |
|
3556 |
-is_deeply($rows, [[9, 10]], "fetch_multi third"); |
|
3557 |
-$rows = $result->fetch_multi(2); |
|
3558 |
-ok(!$rows); |
|
3559 |
- |
|
3560 |
-$result = $dbi->select(table => 'table1'); |
|
3561 |
-eval {$result->fetch_multi}; |
|
3562 |
-like($@, qr/Row count must be specified/, "Not specified row count"); |
|
3563 |
- |
|
3564 |
-$result = $dbi->select(table => 'table1'); |
|
3565 |
-$rows = $result->fetch_hash_multi(2); |
|
3566 |
-is_deeply($rows, [{key1 => 1, key2 => 2}, |
|
3567 |
- {key1 => 3, key2 => 4}], "fetch_multi first"); |
|
3568 |
-$rows = $result->fetch_hash_multi(2); |
|
3569 |
-is_deeply($rows, [{key1 => 5, key2 => 6}, |
|
3570 |
- {key1 => 7, key2 => 8}], "fetch_multi secound"); |
|
3571 |
-$rows = $result->fetch_hash_multi(2); |
|
3572 |
-is_deeply($rows, [{key1 => 9, key2 => 10}], "fetch_multi third"); |
|
3573 |
-$rows = $result->fetch_hash_multi(2); |
|
3574 |
-ok(!$rows); |
|
3575 |
- |
|
3576 |
-$result = $dbi->select(table => 'table1'); |
|
3577 |
-eval {$result->fetch_hash_multi}; |
|
3578 |
-like($@, qr/Row count must be specified/, "Not specified row count"); |
|
3579 |
- |
|
3580 |
-$dbi = DBIx::Custom->connect(%memory); |
|
3581 |
-$dbi->execute($create_table_default); |
|
3582 |
-$dbi->insert({key1 => 1, key2 => 2}, table => 'table1'); |
|
3583 |
-$dbi->insert({key1 => 3, key2 => 4}, table => 'table1'); |
|
3584 |
- |
|
3585 |
-test 'fetch_all'; |
|
3586 |
-$result = $dbi->select(table => 'table1'); |
|
3587 |
-$rows = $result->fetch_all; |
|
3588 |
-is_deeply($rows, [[1, 2], [3, 4]]); |
|
3589 |
- |
|
3590 |
-$result = $dbi->select(table => 'table1'); |
|
3591 |
-$rows = $result->fetch_hash_all; |
|
3592 |
-is_deeply($rows, [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]); |
|
3593 |
- |
|
3594 |
-$result = $dbi->select(table => 'table1'); |
|
3595 |
-$result->dbi->filters({three_times => sub { $_[0] * 3}}); |
|
3596 |
-$result->filter({key1 => 'three_times'}); |
|
3597 |
- |
|
3598 |
-$rows = $result->fetch_all; |
|
3599 |
-is_deeply($rows, [[3, 2], [9, 4]], "array"); |
|
3600 |
- |
|
3601 |
-$result = $dbi->select(table => 'table1'); |
|
3602 |
-$result->dbi->filters({three_times => sub { $_[0] * 3}}); |
|
3603 |
-$result->filter({key1 => 'three_times'}); |
|
3604 |
-$rows = $result->fetch_hash_all; |
|
3605 |
-is_deeply($rows, [{key1 => 3, key2 => 2}, {key1 => 9, key2 => 4}], "hash"); |
|
3606 |
- |
|
3607 |
-test "query_builder"; |
|
3608 |
-$datas = [ |
|
3609 |
- # Basic tests |
|
3610 |
- { name => 'placeholder basic', |
|
3611 |
- source => "a {? k1} b {= k2} {<> k3} {> k4} {< k5} {>= k6} {<= k7} {like k8}", , |
|
3612 |
- sql_expected => "a ? b k2 = ? k3 <> ? k4 > ? k5 < ? k6 >= ? k7 <= ? k8 like ?;", |
|
3613 |
- columns_expected => [qw/k1 k2 k3 k4 k5 k6 k7 k8/] |
|
3614 |
- }, |
|
3615 |
- { |
|
3616 |
- name => 'placeholder in', |
|
3617 |
- source => "{in k1 3};", |
|
3618 |
- sql_expected => "k1 in (?, ?, ?);", |
|
3619 |
- columns_expected => [qw/k1 k1 k1/] |
|
3620 |
- }, |
|
3621 |
- |
|
3622 |
- # Table name |
|
3623 |
- { |
|
3624 |
- name => 'placeholder with table name', |
|
3625 |
- source => "{= a.k1} {= a.k2}", |
|
3626 |
- sql_expected => "a.k1 = ? a.k2 = ?;", |
|
3627 |
- columns_expected => [qw/a.k1 a.k2/] |
|
3628 |
- }, |
|
3629 |
- { |
|
3630 |
- name => 'placeholder in with table name', |
|
3631 |
- source => "{in a.k1 2} {in b.k2 2}", |
|
3632 |
- sql_expected => "a.k1 in (?, ?) b.k2 in (?, ?);", |
|
3633 |
- columns_expected => [qw/a.k1 a.k1 b.k2 b.k2/] |
|
3634 |
- }, |
|
3635 |
- { |
|
3636 |
- name => 'not contain tag', |
|
3637 |
- source => "aaa", |
|
3638 |
- sql_expected => "aaa;", |
|
3639 |
- columns_expected => [], |
|
3640 |
- } |
|
3641 |
-]; |
|
3642 |
- |
|
3643 |
-for (my $i = 0; $i < @$datas; $i++) { |
|
3644 |
- my $data = $datas->[$i]; |
|
3645 |
- my $builder = DBIx::Custom->new->query_builder; |
|
3646 |
- my $query = $builder->build_query($data->{source}); |
|
3647 |
- is($query->{sql}, $data->{sql_expected}, "$data->{name} : sql"); |
|
3648 |
- is_deeply($query->columns, $data->{columns_expected}, "$data->{name} : columns"); |
|
3649 |
-} |
|
3650 |
- |
|
3651 |
-$builder = DBIx::Custom->new->query_builder; |
|
3652 |
-$ret_val = $builder->register_tag( |
|
3653 |
- p => sub { |
|
3654 |
- my @args = @_; |
|
3655 |
- |
|
3656 |
- my $expand = "? $args[0] $args[1]"; |
|
3657 |
- my $columns = [2]; |
|
3658 |
- return [$expand, $columns]; |
|
3659 |
- } |
|
3660 |
-); |
|
3661 |
- |
|
3662 |
-$query = $builder->build_query("{p a b}"); |
|
3663 |
-is($query->{sql}, "? a b;", "register_tag sql"); |
|
3664 |
-is_deeply($query->{columns}, [2], "register_tag columns"); |
|
3665 |
-isa_ok($ret_val, 'DBIx::Custom::QueryBuilder'); |
|
3666 |
- |
|
3667 |
-$builder = DBIx::Custom->new->query_builder; |
|
3668 |
- |
|
3669 |
-eval{$builder->build_query('{? }')}; |
|
3670 |
-like($@, qr/\QColumn name must be specified in tag "{? }"/, "? not arguments"); |
|
3671 |
- |
|
3672 |
-eval{$builder->build_query("{a }")}; |
|
3673 |
-like($@, qr/\QTag "a" is not registered/, "tag not exist"); |
|
3674 |
- |
|
3675 |
-$builder->register_tag({ |
|
3676 |
- q => 'string' |
|
3677 |
-}); |
|
3678 |
- |
|
3679 |
-eval{$builder->build_query("{q}", {})}; |
|
3680 |
-like($@, qr/Tag "q" must be sub reference/, "tag not code ref"); |
|
3681 |
- |
|
3682 |
-$builder->register_tag({ |
|
3683 |
- r => sub {} |
|
3684 |
-}); |
|
3685 |
- |
|
3686 |
-eval{$builder->build_query("{r}")}; |
|
3687 |
-like($@, qr/\QTag "r" must return [STRING, ARRAY_REFERENCE]/, "tag return noting"); |
|
3688 |
- |
|
3689 |
-$builder->register_tag({ |
|
3690 |
- s => sub { return ["a", ""]} |
|
3691 |
-}); |
|
3692 |
- |
|
3693 |
-eval{$builder->build_query("{s}")}; |
|
3694 |
-like($@, qr/\QTag "s" must return [STRING, ARRAY_REFERENCE]/, "tag return not array columns"); |
|
3695 |
- |
|
3696 |
-$builder->register_tag( |
|
3697 |
- t => sub {return ["a", []]} |
|
3698 |
-); |
|
3699 |
- |
|
3700 |
- |
|
3701 |
-test 'General error case'; |
|
3702 |
-$builder = DBIx::Custom->new->query_builder; |
|
3703 |
-$builder->register_tag( |
|
3704 |
- a => sub { |
|
3705 |
- return ["? ? ?", ['']]; |
|
3706 |
- } |
|
3707 |
-); |
|
3708 |
-eval{$builder->build_query("{a}")}; |
|
3709 |
-like($@, qr/\QPlaceholder count/, "placeholder count is invalid"); |
|
3710 |
- |
|
3711 |
- |
|
3712 |
-test 'Default tag Error case'; |
|
3713 |
-eval{$builder->build_query("{= }")}; |
|
3714 |
-like($@, qr/Column name must be specified in tag "{= }"/, "basic '=' : key not exist"); |
|
3715 |
- |
|
3716 |
-eval{$builder->build_query("{in }")}; |
|
3717 |
-like($@, qr/Column name and count of values must be specified in tag "{in }"/, "in : key not exist"); |
|
3718 |
- |
|
3719 |
-eval{$builder->build_query("{in a}")}; |
|
3720 |
-like($@, qr/\QColumn name and count of values must be specified in tag "{in }"/, |
|
3721 |
- "in : key not exist"); |
|
3722 |
- |
|
3723 |
-eval{$builder->build_query("{in a r}")}; |
|
3724 |
-like($@, qr/\QColumn name and count of values must be specified in tag "{in }"/, |
|
3725 |
- "in : key not exist"); |
|
3726 |
- |
|
3727 |
-test 'variouse source'; |
|
3728 |
-$source = "a {= b} c \\{ \\} {= \\{} {= \\}} d;"; |
|
3729 |
-$query = $builder->build_query($source); |
|
3730 |
-is($query->sql, 'a b = ? c { } { = ? } = ? d;', "basic : 1"); |
|
3731 |
- |
|
3732 |
-$source = "abc;"; |
|
3733 |
-$query = $builder->build_query($source); |
|
3734 |
-is($query->sql, 'abc;', "basic : 2"); |
|
3735 |
- |
|
3736 |
-$source = "{= a}"; |
|
3737 |
-$query = $builder->build_query($source); |
|
3738 |
-is($query->sql, 'a = ?;', "only tag"); |
|
3739 |
- |
|
3740 |
-$source = "000;"; |
|
3741 |
-$query = $builder->build_query($source); |
|
3742 |
-is($query->sql, '000;', "contain 0 value"); |
|
3743 |
- |
|
3744 |
-$source = "a {= b} }"; |
|
3745 |
-eval{$builder->build_query($source)}; |
|
3746 |
-like($@, qr/unexpected "}"/, "error : 1"); |
|
3747 |
- |
|
3748 |
-$source = "a {= {}"; |
|
3749 |
-eval{$builder->build_query($source)}; |
|
3750 |
-like($@, qr/unexpected "{"/, "error : 2"); |
... | ... |
@@ -1,19 +0,0 @@ |
1 |
-package MyDBI1; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'DBIx::Custom'; |
|
7 |
- |
|
8 |
-sub connect { |
|
9 |
- my $self = shift->SUPER::connect(@_); |
|
10 |
- |
|
11 |
- $self->include_model( |
|
12 |
- MyModel1 => [ |
|
13 |
- 'book', |
|
14 |
- {class => 'Company', name => 'company'} |
|
15 |
- ] |
|
16 |
- ); |
|
17 |
-} |
|
18 |
- |
|
19 |
-1; |
... | ... |
@@ -1,17 +0,0 @@ |
1 |
-package MyModel1::Company; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'DBIx::Custom::Model'; |
|
7 |
- |
|
8 |
- |
|
9 |
-sub insert { |
|
10 |
- my ($self, $param) = @_; |
|
11 |
- |
|
12 |
- return $self->SUPER::insert(param => $param); |
|
13 |
-} |
|
14 |
- |
|
15 |
-sub list { shift->select; } |
|
16 |
- |
|
17 |
-1; |
... | ... |
@@ -1,13 +0,0 @@ |
1 |
-package MyModel1::book; |
|
2 |
- |
|
3 |
-use DBIx::Custom::Model -base; |
|
4 |
- |
|
5 |
-sub insert { |
|
6 |
- my ($self, $param) = @_; |
|
7 |
- |
|
8 |
- return $self->SUPER::insert(param => $param); |
|
9 |
-} |
|
10 |
- |
|
11 |
-sub list { shift->select; } |
|
12 |
- |
|
13 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel4; |
|
2 |
- |
|
3 |
-use base 'DBIx::Custom::Model'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,9 +0,0 @@ |
1 |
-package MyModel4::book; |
|
2 |
- |
|
3 |
-use base 'MyModel4'; |
|
4 |
- |
|
5 |
-sub table { 'table1' } |
|
6 |
- |
|
7 |
-sub list { shift->select } |
|
8 |
- |
|
9 |
-1; |
... | ... |
@@ -1,8 +0,0 @@ |
1 |
-package MyModel4::company; |
|
2 |
- |
|
3 |
-use base 'MyModel4'; |
|
4 |
- |
|
5 |
-sub insert { shift->SUPER::insert(param => $_[0]) } |
|
6 |
-sub list { shift->select } |
|
7 |
- |
|
8 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel5; |
|
2 |
- |
|
3 |
-use base 'DBIx::Custom::Model'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,7 +0,0 @@ |
1 |
-package MyModel5::table1; |
|
2 |
- |
|
3 |
-use MyModel5 -base; |
|
4 |
- |
|
5 |
-has primary_key => sub { ['key1', 'key2'] }; |
|
6 |
- |
|
7 |
-1; |
... | ... |
@@ -1,12 +0,0 @@ |
1 |
-package MyModel5::table1_1; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'MyModel5'; |
|
7 |
- |
|
8 |
-__PACKAGE__->attr(table => 'table2'); |
|
9 |
- |
|
10 |
-__PACKAGE__->attr('primary_key' => sub { ['key1', 'key2'] }); |
|
11 |
- |
|
12 |
-1; |
... | ... |
@@ -1,13 +0,0 @@ |
1 |
-package MyModel5::table1_2; |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
- |
|
6 |
-use base 'MyModel5'; |
|
7 |
- |
|
8 |
-__PACKAGE__->attr(name => 'table1_3'); |
|
9 |
-__PACKAGE__->attr(table => 'table3'); |
|
10 |
- |
|
11 |
-__PACKAGE__->attr('primary_key' => sub { ['key1', 'key2'] }); |
|
12 |
- |
|
13 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel6; |
|
2 |
- |
|
3 |
-use base 'DBIx::Custom::Model'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,14 +0,0 @@ |
1 |
-package MyModel6::table1; |
|
2 |
- |
|
3 |
-use base 'MyModel6'; |
|
4 |
- |
|
5 |
-__PACKAGE__->attr( |
|
6 |
- join => sub { |
|
7 |
- [ |
|
8 |
- 'left outer join table2 on table1.key1 = table2.key1' |
|
9 |
- ] |
|
10 |
- }, |
|
11 |
- primary_key => sub { ['key1'] } |
|
12 |
-); |
|
13 |
- |
|
14 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel6::table2; |
|
2 |
- |
|
3 |
-use base 'MyModel6'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,11 +0,0 @@ |
1 |
-package MyModel6::table3; |
|
2 |
- |
|
3 |
-use base 'MyModel6'; |
|
4 |
- |
|
5 |
-__PACKAGE__->attr(filter => sub { |
|
6 |
- [ |
|
7 |
- key1 => {in => sub { uc $_[0] }} |
|
8 |
- ] |
|
9 |
-}); |
|
10 |
- |
|
11 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel7; |
|
2 |
- |
|
3 |
-use base 'DBIx::Custom::Model'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,14 +0,0 @@ |
1 |
-package MyModel7::table1; |
|
2 |
- |
|
3 |
-use base 'MyModel7'; |
|
4 |
- |
|
5 |
-__PACKAGE__->attr( |
|
6 |
- primary_key => sub { ['key1'] }, |
|
7 |
- join => sub { |
|
8 |
- [ |
|
9 |
- 'left outer join table2 on table1.key1 = table2.key1' |
|
10 |
- ] |
|
11 |
- }, |
|
12 |
-); |
|
13 |
- |
|
14 |
-1; |
... | ... |
@@ -1,5 +0,0 @@ |
1 |
-package MyModel7::table2; |
|
2 |
- |
|
3 |
-use base 'MyModel7'; |
|
4 |
- |
|
5 |
-1; |
... | ... |
@@ -1,4 +0,0 @@ |
1 |
-package MyModel8; |
|
2 |
-use DBIx::Custom::Model -base; |
|
3 |
- |
|
4 |
-1; |
... | ... |
@@ -1,7 +0,0 @@ |
1 |
-package MyModel8::table1; |
|
2 |
-use MyModel8 -base; |
|
3 |
- |
|
4 |
-has join => sub { ['left join table2 as table2_alias on table1.key1 = table2_alias.key1'] }; |
|
5 |
- |
|
6 |
- |
|
7 |
-1; |
... | ... |
@@ -1,10 +0,0 @@ |
1 |
-package MyModel8::table2; |
|
2 |
-use MyModel8 -base; |
|
3 |
- |
|
4 |
-has filter => sub { |
|
5 |
- { |
|
6 |
- key3 => {out => sub { $_[0] * 2}, in => sub { $_[0] * 3}, end => sub { $_[0] * 4 }} |
|
7 |
- } |
|
8 |
-}; |
|
9 |
- |
|
10 |
-1; |
... | ... |
@@ -1,20 +0,0 @@ |
1 |
-use strict; |
|
2 |
-use warnings; |
|
3 |
- |
|
4 |
-use FindBin; |
|
5 |
-$ENV{DBIX_CUSTOM_TEST_RUN} = 1 |
|
6 |
- if -f "$FindBin::Bin/run/common-postgresql-private.tmp"; |
|
7 |
-$ENV{DBIX_CUSTOM_SKIP_MESSAGE} = 'postgresql private test'; |
|
8 |
- |
|
9 |
-use DBIx::Custom; |
|
10 |
-{ |
|
11 |
- package DBIx::Custom; |
|
12 |
- no warnings 'redefine'; |
|
13 |
- sub dsn { "dbi:Pg:dbname=dbix_custom" } |
|
14 |
- sub user { 'dbix_custom' } |
|
15 |
- sub password { 'dbix_custom' } |
|
16 |
- |
|
17 |
- sub create_table1 { 'create table table1 (key1 varchar(255), key2 varchar(255));' } |
|
18 |
-} |
|
19 |
- |
|
20 |
-require "$FindBin::Bin/common.t"; |
... | ... |
@@ -1,15 +0,0 @@ |
1 |
-use strict; |
|
2 |
-use warnings; |
|
3 |
- |
|
4 |
-use FindBin; |
|
5 |
-$ENV{DBIX_CUSTOM_TEST_RUN} = 1; |
|
6 |
- |
|
7 |
-use DBIx::Custom; |
|
8 |
-{ |
|
9 |
- package DBIx::Custom; |
|
10 |
- no warnings 'redefine'; |
|
11 |
- sub dsn { 'dbi:SQLite:dbname=:memory:' } |
|
12 |
- sub create_table1 { 'create table table1 (key1, key2);' } |
|
13 |
-} |
|
14 |
- |
|
15 |
-require "$FindBin::Bin/common.t"; |
... | ... |
@@ -1,30 +0,0 @@ |
1 |
-use Test::More; |
|
2 |
-use strict; |
|
3 |
-use warnings; |
|
4 |
-use DBIx::Custom; |
|
5 |
- |
|
6 |
-$SIG{__WARN__} = sub { warn $_[0] unless $_[0] =~ /DEPRECATED/}; |
|
7 |
- |
|
8 |
-my $dbi; |
|
9 |
- |
|
10 |
-plan skip_all => $ENV{DBIX_CUSTOM_SKIP_MESSAGE} || 'common.t is always skipped' |
|
11 |
- unless $ENV{DBIX_CUSTOM_TEST_RUN} |
|
12 |
- && eval { $dbi = DBIx::Custom->connect; 1 }; |
|
13 |
- |
|
14 |
-plan 'no_plan'; |
|
15 |
- |
|
16 |
-# Constant |
|
17 |
-my $create_table1 = $dbi->create_table1; |
|
18 |
- |
|
19 |
-# Variable |
|
20 |
-my $model; |
|
21 |
- |
|
22 |
-# Drop table |
|
23 |
-eval { $dbi->execute('drop table table1') }; |
|
24 |
- |
|
25 |
-# Create table |
|
26 |
-$dbi->execute($create_table1); |
|
27 |
-$model = $dbi->create_model(table => 'table1'); |
|
28 |
-$model->insert({key1 => 1, key2 => 2}); |
|
29 |
-is_deeply($model->select->all, [{key1 => 1, key2 => 2}]); |
|
30 |
- |
... | ... |
@@ -1,252 +0,0 @@ |
1 |
-use Test::More; |
|
2 |
-use strict; |
|
3 |
-use warnings; |
|
4 |
- |
|
5 |
-use FindBin; |
|
6 |
- |
|
7 |
-plan skip_all => 'mysql private test' unless -f "$FindBin::Bin/run/mysql-private.tmp"; |
|
8 |
-plan 'no_plan'; |
|
9 |
- |
|
10 |
-$SIG{__WARN__} = sub { warn $_[0] unless $_[0] =~ /DEPRECATED/}; |
|
11 |
- |
|
12 |
-# user password database |
|
13 |
-our ($user, $password, $database) = qw/appuser 123456 usertest/; |
|
14 |
- |
|
15 |
-require DBIx::Connector; |
|
16 |
- |
|
17 |
-# Function for test name |
|
18 |
-sub test { print "# $_[0]\n" } |
|
19 |
- |
|
20 |
-# Varialbes for tests |
|
21 |
-my $dbi; |
|
22 |
-my $dbname; |
|
23 |
-my $rows; |
|
24 |
-my $result; |
|
25 |
- |
|
26 |
-test 'connect'; |
|
27 |
-eval { |
|
28 |
- $dbi = DBIx::Custom->new( |
|
29 |
- dsn => "dbi:mysql:database=$database;host=localhost;port=10000", |
|
30 |
- user => $user, |
|
31 |
- password => $password |
|
32 |
- ); |
|
33 |
-}; |
|
34 |
-ok(!$@); |
|
35 |
- |
|
36 |
-test 'limit'; |
|
37 |
-$dbi = DBIx::Custom->connect( |
|
38 |
- dsn => "dbi:mysql:database=$database", |
|
39 |
- user => $user, |
|
40 |
- password => $password |
|
41 |
-); |
|
42 |
-$dbi->delete_all(table => 'table1'); |
|
43 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
44 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 4}); |
|
45 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 6}); |
|
46 |
-$dbi->query_builder->register_tag_processor( |
|
47 |
- limit => sub { |
|
48 |
- my ($count, $offset) = @_; |
|
49 |
- |
|
50 |
- my $s = ''; |
|
51 |
- $offset = 0 unless defined $offset; |
|
52 |
- $s .= "limit $offset"; |
|
53 |
- $s .= ", $count"; |
|
54 |
- |
|
55 |
- return [$s, []]; |
|
56 |
- } |
|
57 |
-); |
|
58 |
-$rows = $dbi->select( |
|
59 |
- table => 'table1', |
|
60 |
- where => {key1 => 1}, |
|
61 |
- append => "order by key2 {limit 1 0}" |
|
62 |
-)->fetch_hash_all; |
|
63 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
64 |
-$rows = $dbi->select( |
|
65 |
- table => 'table1', |
|
66 |
- where => {key1 => 1}, |
|
67 |
- append => "order by key2 {limit 2 1}" |
|
68 |
-)->fetch_hash_all; |
|
69 |
-is_deeply($rows, [{key1 => 1, key2 => 4},{key1 => 1, key2 => 6}]); |
|
70 |
-$rows = $dbi->select( |
|
71 |
- table => 'table1', |
|
72 |
- where => {key1 => 1}, |
|
73 |
- append => "order by key2 {limit 1}" |
|
74 |
-)->fetch_hash_all; |
|
75 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
76 |
- |
|
77 |
-$dbi->dbh->disconnect; |
|
78 |
-$dbi = undef; |
|
79 |
-$dbi = DBIx::Custom->connect( |
|
80 |
- dsn => "dbi:mysql:database=$database", |
|
81 |
- user => $user, |
|
82 |
- password => $password |
|
83 |
-); |
|
84 |
-$rows = $dbi->select( |
|
85 |
- table => 'table1', |
|
86 |
- where => {key1 => 1, key2 => 4}, |
|
87 |
- append => "order by key2 limit 0, 1" |
|
88 |
-)->fetch_hash_all; |
|
89 |
-is_deeply($rows, [{key1 => 1, key2 => 4}]); |
|
90 |
-$dbi->delete_all(table => 'table1'); |
|
91 |
- |
|
92 |
-test 'type_rule'; |
|
93 |
-$dbi = DBIx::Custom->connect( |
|
94 |
- dsn => "dbi:mysql:database=$database", |
|
95 |
- user => $user, |
|
96 |
- password => $password |
|
97 |
-); |
|
98 |
-eval{$dbi->execute("create table date_test (date DATE, datetime DATETIME)")}; |
|
99 |
-$dbi->each_column( |
|
100 |
- sub { |
|
101 |
- my ($self, $table, $column, $column_info) = @_; |
|
102 |
- } |
|
103 |
-); |
|
104 |
- |
|
105 |
-$dbi->type_rule( |
|
106 |
- into1 => { |
|
107 |
- date=> sub { |
|
108 |
- my $date = shift; |
|
109 |
- $date =~ s/aaaaa//g; |
|
110 |
- return $date; |
|
111 |
- }, |
|
112 |
- datetime => sub { |
|
113 |
- my $date = shift; |
|
114 |
- $date =~ s/ccccc//g; |
|
115 |
- return $date; |
|
116 |
- }, |
|
117 |
- }, |
|
118 |
- from1 => { |
|
119 |
- # DATE |
|
120 |
- 9 => sub { |
|
121 |
- my $date = shift; |
|
122 |
- $date .= 'bbbbb'; |
|
123 |
- return $date; |
|
124 |
- }, |
|
125 |
- # DATETIME or TIMPESTANM |
|
126 |
- 11 => sub { |
|
127 |
- my $date = shift; |
|
128 |
- $date .= 'ddddd'; |
|
129 |
- return $date; |
|
130 |
- } |
|
131 |
- } |
|
132 |
-); |
|
133 |
- |
|
134 |
-$dbi->insert( |
|
135 |
- { |
|
136 |
- date => 'aaaaa2010-aaaaa11-12aaaaa', |
|
137 |
- datetime => '2010-11ccccc-12 10:ccccc55:56' |
|
138 |
- }, |
|
139 |
- table => 'date_test' |
|
140 |
-); |
|
141 |
-is_deeply( |
|
142 |
- $dbi->select(table => 'date_test')->fetch, |
|
143 |
- ['2010-11-12bbbbb', '2010-11-12 10:55:56ddddd'] |
|
144 |
-); |
|
145 |
- |
|
146 |
-$dbi->execute("drop table date_test"); |
|
147 |
- |
|
148 |
-test 'dbh'; |
|
149 |
-{ |
|
150 |
- my $connector = DBIx::Connector->new( |
|
151 |
- "dbi:mysql:database=$database", |
|
152 |
- $user, |
|
153 |
- $password, |
|
154 |
- DBIx::Custom->new->default_dbi_option |
|
155 |
- ); |
|
156 |
- |
|
157 |
- my $dbi = DBIx::Custom->connect(connector => $connector); |
|
158 |
- $dbi->delete_all(table => 'table1'); |
|
159 |
- $dbi->do('insert into table1 (key1, key2) values (1, 2)'); |
|
160 |
- is($dbi->select(table => 'table1')->fetch_hash_first->{key1}, 1); |
|
161 |
- |
|
162 |
- $dbi = DBIx::Custom->new; |
|
163 |
- $dbi->dbh('a'); |
|
164 |
- is($dbi->{dbh}, 'a'); |
|
165 |
-} |
|
166 |
- |
|
167 |
-test 'transaction'; |
|
168 |
-test 'dbh'; |
|
169 |
-{ |
|
170 |
- my $connector = DBIx::Connector->new( |
|
171 |
- "dbi:mysql:database=$database", |
|
172 |
- $user, |
|
173 |
- $password, |
|
174 |
- DBIx::Custom->new->default_dbi_option |
|
175 |
- ); |
|
176 |
- |
|
177 |
- my $dbi = DBIx::Custom->connect(connector => $connector); |
|
178 |
- $dbi->delete_all(table => 'table1'); |
|
179 |
- |
|
180 |
- $dbi->connector->txn(sub { |
|
181 |
- $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
182 |
- $dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
183 |
- }); |
|
184 |
- is_deeply($dbi->select(table => 'table1')->fetch_hash_all, |
|
185 |
- [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]); |
|
186 |
- |
|
187 |
- $dbi->delete_all(table => 'table1'); |
|
188 |
- eval { |
|
189 |
- $dbi->connector->txn(sub { |
|
190 |
- $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
191 |
- die "Error"; |
|
192 |
- $dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
193 |
- }); |
|
194 |
- }; |
|
195 |
- is_deeply($dbi->select(table => 'table1')->fetch_hash_all, |
|
196 |
- []); |
|
197 |
-} |
|
198 |
- |
|
199 |
-use DBIx::Custom; |
|
200 |
-use Scalar::Util 'blessed'; |
|
201 |
-{ |
|
202 |
- my $dbi = DBIx::Custom->connect( |
|
203 |
- user => $user, |
|
204 |
- password => $password, |
|
205 |
- dsn => "dbi:mysql:dbname=$database" |
|
206 |
- ); |
|
207 |
- $dbi->connect; |
|
208 |
- |
|
209 |
- ok(blessed $dbi->dbh); |
|
210 |
- can_ok($dbi->dbh, qw/prepare/); |
|
211 |
- ok($dbi->dbh->{AutoCommit}); |
|
212 |
- ok(!$dbi->dbh->{mysql_enable_utf8}); |
|
213 |
-} |
|
214 |
- |
|
215 |
-{ |
|
216 |
- my $dbi = DBIx::Custom->connect( |
|
217 |
- user => $user, |
|
218 |
- password => $password, |
|
219 |
- dsn => "dbi:mysql:dbname=$database", |
|
220 |
- dbi_options => {AutoCommit => 0, mysql_enable_utf8 => 1} |
|
221 |
- ); |
|
222 |
- $dbi->connect; |
|
223 |
- ok(!$dbi->dbh->{AutoCommit}); |
|
224 |
- #ok($dbi->dbh->{mysql_enable_utf8}); |
|
225 |
-} |
|
226 |
- |
|
227 |
-test 'fork'; |
|
228 |
-{ |
|
229 |
- my $connector = DBIx::Connector->new( |
|
230 |
- "dbi:mysql:database=$database", |
|
231 |
- $user, |
|
232 |
- $password, |
|
233 |
- DBIx::Custom->new->default_dbi_option |
|
234 |
- ); |
|
235 |
- |
|
236 |
- my $dbi = DBIx::Custom->new(connector => $connector); |
|
237 |
- $dbi->delete_all(table => 'table1'); |
|
238 |
- $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
239 |
- die "Can't fork" unless defined (my $pid = fork); |
|
240 |
- |
|
241 |
- if ($pid) { |
|
242 |
- # Parent |
|
243 |
- my $result = $dbi->select(table => 'table1'); |
|
244 |
- is_deeply($result->fetch_hash_first, {key1 => 1, key2 => 2}); |
|
245 |
- } |
|
246 |
- else { |
|
247 |
- # Child |
|
248 |
- my $result = $dbi->select(table => 'table1'); |
|
249 |
- die "Not OK" unless $result->fetch_hash_first->{key1} == 1; |
|
250 |
- } |
|
251 |
-} |
|
252 |
- |
... | ... |
@@ -1,51 +0,0 @@ |
1 |
-#!perl -T |
|
2 |
- |
|
3 |
-use strict; |
|
4 |
-use warnings; |
|
5 |
-use Test::More tests => 3; |
|
6 |
- |
|
7 |
-sub not_in_file_ok { |
|
8 |
- my ($filename, %regex) = @_; |
|
9 |
- open( my $fh, '<', $filename ) |
|
10 |
- or die "couldn't open $filename for reading: $!"; |
|
11 |
- |
|
12 |
- my %violated; |
|
13 |
- |
|
14 |
- while (my $line = <$fh>) { |
|
15 |
- while (my ($desc, $regex) = each %regex) { |
|
16 |
- if ($line =~ $regex) { |
|
17 |
- push @{$violated{$desc}||=[]}, $.; |
|
18 |
- } |
|
19 |
- } |
|
20 |
- } |
|
21 |
- |
|
22 |
- if (%violated) { |
|
23 |
- fail("$filename contains boilerplate text"); |
|
24 |
- diag "$_ appears on lines @{$violated{$_}}" for keys %violated; |
|
25 |
- } else { |
|
26 |
- pass("$filename contains no boilerplate text"); |
|
27 |
- } |
|
28 |
-} |
|
29 |
- |
|
30 |
-sub module_boilerplate_ok { |
|
31 |
- my ($module) = @_; |
|
32 |
- not_in_file_ok($module => |
|
33 |
- 'the great new $MODULENAME' => qr/ - The great new /, |
|
34 |
- 'boilerplate description' => qr/Quick summary of what the module/, |
|
35 |
- 'stub function definition' => qr/function[12]/, |
|
36 |
- ); |
|
37 |
-} |
|
38 |
- |
|
39 |
- |
|
40 |
- not_in_file_ok(README => |
|
41 |
- "The README is used..." => qr/The README is used/, |
|
42 |
- "'version information here'" => qr/to provide version information/, |
|
43 |
- ); |
|
44 |
- |
|
45 |
- not_in_file_ok(Changes => |
|
46 |
- "placeholder date/time" => qr(Date/time) |
|
47 |
- ); |
|
48 |
- |
|
49 |
- module_boilerplate_ok('lib/DBIx/Custom.pm'); |
|
50 |
- |
|
51 |
- |
... | ... |
@@ -1,11 +0,0 @@ |
1 |
- |
|
2 |
-use strict; |
|
3 |
-use warnings; |
|
4 |
-use Test::More; |
|
5 |
- |
|
6 |
-# Ensure a recent version of Test::Pod |
|
7 |
-my $min_tp = 1.22; |
|
8 |
-eval "use Test::Pod $min_tp"; |
|
9 |
-plan skip_all => "Test::Pod $min_tp required for testing POD" if $@; |
|
10 |
- |
|
11 |
-all_pod_files_ok(); |
... | ... |
@@ -1,252 +0,0 @@ |
1 |
-use Test::More; |
|
2 |
-use strict; |
|
3 |
-use warnings; |
|
4 |
- |
|
5 |
-use FindBin; |
|
6 |
- |
|
7 |
-plan skip_all => 'private test' unless -f "$FindBin::Bin/private-mysql-run.tmp"; |
|
8 |
-plan 'no_plan'; |
|
9 |
- |
|
10 |
-$SIG{__WARN__} = sub { warn $_[0] unless $_[0] =~ /DEPRECATED/}; |
|
11 |
- |
|
12 |
-# user password database |
|
13 |
-our ($user, $password, $database) = qw/appuser 123456 usertest/; |
|
14 |
- |
|
15 |
-require DBIx::Connector; |
|
16 |
- |
|
17 |
-# Function for test name |
|
18 |
-sub test { print "# $_[0]\n" } |
|
19 |
- |
|
20 |
-# Varialbes for tests |
|
21 |
-my $dbi; |
|
22 |
-my $dbname; |
|
23 |
-my $rows; |
|
24 |
-my $result; |
|
25 |
- |
|
26 |
-test 'connect'; |
|
27 |
-eval { |
|
28 |
- $dbi = DBIx::Custom->new( |
|
29 |
- dsn => "dbi:mysql:database=$database;host=localhost;port=10000", |
|
30 |
- user => $user, |
|
31 |
- password => $password |
|
32 |
- ); |
|
33 |
-}; |
|
34 |
-ok(!$@); |
|
35 |
- |
|
36 |
-test 'limit'; |
|
37 |
-$dbi = DBIx::Custom->connect( |
|
38 |
- dsn => "dbi:mysql:database=$database", |
|
39 |
- user => $user, |
|
40 |
- password => $password |
|
41 |
-); |
|
42 |
-$dbi->delete_all(table => 'table1'); |
|
43 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
44 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 4}); |
|
45 |
-$dbi->insert(table => 'table1', param => {key1 => 1, key2 => 6}); |
|
46 |
-$dbi->query_builder->register_tag_processor( |
|
47 |
- limit => sub { |
|
48 |
- my ($count, $offset) = @_; |
|
49 |
- |
|
50 |
- my $s = ''; |
|
51 |
- $offset = 0 unless defined $offset; |
|
52 |
- $s .= "limit $offset"; |
|
53 |
- $s .= ", $count"; |
|
54 |
- |
|
55 |
- return [$s, []]; |
|
56 |
- } |
|
57 |
-); |
|
58 |
-$rows = $dbi->select( |
|
59 |
- table => 'table1', |
|
60 |
- where => {key1 => 1}, |
|
61 |
- append => "order by key2 {limit 1 0}" |
|
62 |
-)->fetch_hash_all; |
|
63 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
64 |
-$rows = $dbi->select( |
|
65 |
- table => 'table1', |
|
66 |
- where => {key1 => 1}, |
|
67 |
- append => "order by key2 {limit 2 1}" |
|
68 |
-)->fetch_hash_all; |
|
69 |
-is_deeply($rows, [{key1 => 1, key2 => 4},{key1 => 1, key2 => 6}]); |
|
70 |
-$rows = $dbi->select( |
|
71 |
- table => 'table1', |
|
72 |
- where => {key1 => 1}, |
|
73 |
- append => "order by key2 {limit 1}" |
|
74 |
-)->fetch_hash_all; |
|
75 |
-is_deeply($rows, [{key1 => 1, key2 => 2}]); |
|
76 |
- |
|
77 |
-$dbi->dbh->disconnect; |
|
78 |
-$dbi = undef; |
|
79 |
-$dbi = DBIx::Custom->connect( |
|
80 |
- dsn => "dbi:mysql:database=$database", |
|
81 |
- user => $user, |
|
82 |
- password => $password |
|
83 |
-); |
|
84 |
-$rows = $dbi->select( |
|
85 |
- table => 'table1', |
|
86 |
- where => {key1 => 1, key2 => 4}, |
|
87 |
- append => "order by key2 limit 0, 1" |
|
88 |
-)->fetch_hash_all; |
|
89 |
-is_deeply($rows, [{key1 => 1, key2 => 4}]); |
|
90 |
-$dbi->delete_all(table => 'table1'); |
|
91 |
- |
|
92 |
-test 'type_rule'; |
|
93 |
-$dbi = DBIx::Custom->connect( |
|
94 |
- dsn => "dbi:mysql:database=$database", |
|
95 |
- user => $user, |
|
96 |
- password => $password |
|
97 |
-); |
|
98 |
-eval{$dbi->execute("create table date_test (date DATE, datetime DATETIME)")}; |
|
99 |
-$dbi->each_column( |
|
100 |
- sub { |
|
101 |
- my ($self, $table, $column, $column_info) = @_; |
|
102 |
- } |
|
103 |
-); |
|
104 |
- |
|
105 |
-$dbi->type_rule( |
|
106 |
- into1 => { |
|
107 |
- date=> sub { |
|
108 |
- my $date = shift; |
|
109 |
- $date =~ s/aaaaa//g; |
|
110 |
- return $date; |
|
111 |
- }, |
|
112 |
- datetime => sub { |
|
113 |
- my $date = shift; |
|
114 |
- $date =~ s/ccccc//g; |
|
115 |
- return $date; |
|
116 |
- }, |
|
117 |
- }, |
|
118 |
- from1 => { |
|
119 |
- # DATE |
|
120 |
- 9 => sub { |
|
121 |
- my $date = shift; |
|
122 |
- $date .= 'bbbbb'; |
|
123 |
- return $date; |
|
124 |
- }, |
|
125 |
- # DATETIME or TIMPESTANM |
|
126 |
- 11 => sub { |
|
127 |
- my $date = shift; |
|
128 |
- $date .= 'ddddd'; |
|
129 |
- return $date; |
|
130 |
- } |
|
131 |
- } |
|
132 |
-); |
|
133 |
- |
|
134 |
-$dbi->insert( |
|
135 |
- { |
|
136 |
- date => 'aaaaa2010-aaaaa11-12aaaaa', |
|
137 |
- datetime => '2010-11ccccc-12 10:ccccc55:56' |
|
138 |
- }, |
|
139 |
- table => 'date_test' |
|
140 |
-); |
|
141 |
-is_deeply( |
|
142 |
- $dbi->select(table => 'date_test')->fetch, |
|
143 |
- ['2010-11-12bbbbb', '2010-11-12 10:55:56ddddd'] |
|
144 |
-); |
|
145 |
- |
|
146 |
-$dbi->execute("drop table date_test"); |
|
147 |
- |
|
148 |
-test 'dbh'; |
|
149 |
-{ |
|
150 |
- my $connector = DBIx::Connector->new( |
|
151 |
- "dbi:mysql:database=$database", |
|
152 |
- $user, |
|
153 |
- $password, |
|
154 |
- DBIx::Custom->new->default_dbi_option |
|
155 |
- ); |
|
156 |
- |
|
157 |
- my $dbi = DBIx::Custom->connect(connector => $connector); |
|
158 |
- $dbi->delete_all(table => 'table1'); |
|
159 |
- $dbi->do('insert into table1 (key1, key2) values (1, 2)'); |
|
160 |
- is($dbi->select(table => 'table1')->fetch_hash_first->{key1}, 1); |
|
161 |
- |
|
162 |
- $dbi = DBIx::Custom->new; |
|
163 |
- $dbi->dbh('a'); |
|
164 |
- is($dbi->{dbh}, 'a'); |
|
165 |
-} |
|
166 |
- |
|
167 |
-test 'transaction'; |
|
168 |
-test 'dbh'; |
|
169 |
-{ |
|
170 |
- my $connector = DBIx::Connector->new( |
|
171 |
- "dbi:mysql:database=$database", |
|
172 |
- $user, |
|
173 |
- $password, |
|
174 |
- DBIx::Custom->new->default_dbi_option |
|
175 |
- ); |
|
176 |
- |
|
177 |
- my $dbi = DBIx::Custom->connect(connector => $connector); |
|
178 |
- $dbi->delete_all(table => 'table1'); |
|
179 |
- |
|
180 |
- $dbi->connector->txn(sub { |
|
181 |
- $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
182 |
- $dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
183 |
- }); |
|
184 |
- is_deeply($dbi->select(table => 'table1')->fetch_hash_all, |
|
185 |
- [{key1 => 1, key2 => 2}, {key1 => 3, key2 => 4}]); |
|
186 |
- |
|
187 |
- $dbi->delete_all(table => 'table1'); |
|
188 |
- eval { |
|
189 |
- $dbi->connector->txn(sub { |
|
190 |
- $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
191 |
- die "Error"; |
|
192 |
- $dbi->insert(table => 'table1', param => {key1 => 3, key2 => 4}); |
|
193 |
- }); |
|
194 |
- }; |
|
195 |
- is_deeply($dbi->select(table => 'table1')->fetch_hash_all, |
|
196 |
- []); |
|
197 |
-} |
|
198 |
- |
|
199 |
-use DBIx::Custom; |
|
200 |
-use Scalar::Util 'blessed'; |
|
201 |
-{ |
|
202 |
- my $dbi = DBIx::Custom->connect( |
|
203 |
- user => $user, |
|
204 |
- password => $password, |
|
205 |
- dsn => "dbi:mysql:dbname=$database" |
|
206 |
- ); |
|
207 |
- $dbi->connect; |
|
208 |
- |
|
209 |
- ok(blessed $dbi->dbh); |
|
210 |
- can_ok($dbi->dbh, qw/prepare/); |
|
211 |
- ok($dbi->dbh->{AutoCommit}); |
|
212 |
- ok(!$dbi->dbh->{mysql_enable_utf8}); |
|
213 |
-} |
|
214 |
- |
|
215 |
-{ |
|
216 |
- my $dbi = DBIx::Custom->connect( |
|
217 |
- user => $user, |
|
218 |
- password => $password, |
|
219 |
- dsn => "dbi:mysql:dbname=$database", |
|
220 |
- dbi_options => {AutoCommit => 0, mysql_enable_utf8 => 1} |
|
221 |
- ); |
|
222 |
- $dbi->connect; |
|
223 |
- ok(!$dbi->dbh->{AutoCommit}); |
|
224 |
- #ok($dbi->dbh->{mysql_enable_utf8}); |
|
225 |
-} |
|
226 |
- |
|
227 |
-test 'fork'; |
|
228 |
-{ |
|
229 |
- my $connector = DBIx::Connector->new( |
|
230 |
- "dbi:mysql:database=$database", |
|
231 |
- $user, |
|
232 |
- $password, |
|
233 |
- DBIx::Custom->new->default_dbi_option |
|
234 |
- ); |
|
235 |
- |
|
236 |
- my $dbi = DBIx::Custom->new(connector => $connector); |
|
237 |
- $dbi->delete_all(table => 'table1'); |
|
238 |
- $dbi->insert(table => 'table1', param => {key1 => 1, key2 => 2}); |
|
239 |
- die "Can't fork" unless defined (my $pid = fork); |
|
240 |
- |
|
241 |
- if ($pid) { |
|
242 |
- # Parent |
|
243 |
- my $result = $dbi->select(table => 'table1'); |
|
244 |
- is_deeply($result->fetch_hash_first, {key1 => 1, key2 => 2}); |
|
245 |
- } |
|
246 |
- else { |
|
247 |
- # Child |
|
248 |
- my $result = $dbi->select(table => 'table1'); |
|
249 |
- die "Not OK" unless $result->fetch_hash_first->{key1} == 1; |
|
250 |
- } |
|
251 |
-} |
|
252 |
- |
... | ... |
@@ -1,46 +0,0 @@ |
1 |
-use Test::More; |
|
2 |
-use strict; |
|
3 |
-use warnings; |
|
4 |
-use FindBin; |
|
5 |
-use DBIx::Custom; |
|
6 |
- |
|
7 |
- |
|
8 |
-$SIG{__WARN__} = sub { warn $_[0] unless $_[0] =~ /DEPRECATED/}; |
|
9 |
- |
|
10 |
-# Constant |
|
11 |
-my $user = 'dbix_custom'; |
|
12 |
-my $password = 'dbix_custom'; |
|
13 |
-my $database = 'dbix_custom'; |
|
14 |
-my %connect_args_default = ( |
|
15 |
- dsn => "dbi:Pg:dbname=$database", |
|
16 |
- user => $user, |
|
17 |
- password => $password |
|
18 |
-); |
|
19 |
-my $create_table_default = 'create table table1 (key1 varchar(255), key2 varchar(255));'; |
|
20 |
- |
|
21 |
-plan skip_all => 'private test' |
|
22 |
- unless -f "$FindBin::Bin/private-postgresql-run.tmp" |
|
23 |
- && eval { DBIx::Custom->connect(%connect_args_default); 1 }; |
|
24 |
- |
|
25 |
-plan 'no_plan'; |
|
26 |
- |
|
27 |
- |
|
28 |
-# Variable |
|
29 |
-my $dbi; |
|
30 |
-my $model; |
|
31 |
- |
|
32 |
-# Connect |
|
33 |
-eval { $dbi = DBIx::Custom->connect(%connect_args_default); 1 }; |
|
34 |
-ok(!$@); |
|
35 |
- |
|
36 |
-# Drop table |
|
37 |
-eval { $dbi->execute('drop table table1') }; |
|
38 |
- |
|
39 |
-# Create table |
|
40 |
-$dbi->execute($create_table_default); |
|
41 |
-$model = $dbi->create_model(table => 'table1'); |
|
42 |
-$model->insert({key1 => 1, key2 => 2}); |
|
43 |
-is_deeply($model->select->all, [{key1 => 1, key2 => 2}]); |
|
44 |
- |
|
45 |
- |
|
46 |
- |