Extra sanity check of a fresh DBI handle
[dbsrgits/DBIx-Class.git] / t / storage / txn.t
1 use strict;
2 use warnings;
3
4 use Test::More;
5 use Test::Warn;
6 use Test::Exception;
7 use lib qw(t/lib);
8 use DBICTest;
9
10 my $code = sub {
11   my ($artist, @cd_titles) = @_;
12
13   $artist->create_related('cds', {
14     title => $_,
15     year => 2006,
16   }) foreach (@cd_titles);
17
18   return $artist->cds->all;
19 };
20
21 # Test checking of parameters
22 {
23   my $schema = DBICTest->init_schema;
24
25   throws_ok (sub {
26     (ref $schema)->txn_do(sub{});
27   }, qr/storage/, "can't call txn_do without storage");
28
29   throws_ok ( sub {
30     $schema->txn_do('');
31   }, qr/must be a CODE reference/, '$coderef parameter check ok');
32 }
33
34 # Test successful txn_do() - scalar/list context
35 for my $want (0,1) {
36   my $schema = DBICTest->init_schema;
37
38   is( $schema->storage->{transaction_depth}, 0, 'txn depth starts at 0');
39
40   my @titles = map {'txn_do test CD ' . $_} (1..5);
41   my $artist = $schema->resultset('Artist')->find(1);
42   my $count_before = $artist->cds->count;
43
44   my @res;
45   if ($want) {
46     @res = $schema->txn_do($code, $artist, @titles);
47     is(scalar @res, $count_before+5, 'successful txn added 5 cds');
48   }
49   else {
50     $res[0] = $schema->txn_do($code, $artist, @titles);
51     is($res[0], $count_before+5, 'successful txn added 5 cds');
52   }
53
54   is($artist->cds({
55     title => "txn_do test CD $_",
56   })->first->year, 2006, "new CD $_ year correct") for (1..5);
57
58   is( $schema->storage->{transaction_depth}, 0, 'txn depth has been reset');
59 }
60
61 # Test txn_do() @_ aliasing support
62 {
63   my $schema = DBICTest->init_schema;
64
65   my $res = 'original';
66   $schema->storage->txn_do (sub { $_[0] = 'changed' }, $res);
67   is ($res, 'changed', "Arguments properly aliased for txn_do");
68 }
69
70 # Test nested successful txn_do()
71 {
72   my $schema = DBICTest->init_schema;
73
74   is( $schema->storage->{transaction_depth}, 0, 'txn depth starts at 0');
75
76   my $nested_code = sub {
77     my ($schema, $artist, $code) = @_;
78
79     my @titles1 = map {'nested txn_do test CD ' . $_} (1..5);
80     my @titles2 = map {'nested txn_do test CD ' . $_} (6..10);
81
82     $schema->txn_do($code, $artist, @titles1);
83     $schema->txn_do($code, $artist, @titles2);
84   };
85
86   my $artist = $schema->resultset('Artist')->find(2);
87   my $count_before = $artist->cds->count;
88
89   lives_ok (sub {
90     $schema->txn_do($nested_code, $schema, $artist, $code);
91   }, 'nested txn_do succeeded');
92
93   is($artist->cds({
94     title => 'nested txn_do test CD '.$_,
95   })->first->year, 2006, qq{nested txn_do CD$_ year ok}) for (1..10);
96   is($artist->cds->count, $count_before+10, 'nested txn_do added all CDs');
97
98   is( $schema->storage->{transaction_depth}, 0, 'txn depth has been reset');
99 }
100
101 # test nested txn_begin on fresh connection
102 {
103   my $schema = DBICTest->init_schema(sqlite_use_file => 1, no_deploy => 1);
104   $schema->storage->ensure_connected;
105
106   is ($schema->storage->transaction_depth, 0, 'Start outside txn');
107
108   my @pids;
109   for my $action (
110     sub {
111       my $s = shift;
112       die "$$ starts in txn!" if $s->storage->transaction_depth != 0;
113       $s->txn_do ( sub {
114         die "$$ not in txn!" if $s->storage->transaction_depth == 0;
115         $s->storage->dbh->do('SELECT 1') }
116       );
117       die "$$ did not finish txn!" if $s->storage->transaction_depth != 0;
118     },
119     sub {
120       $_[0]->txn_begin;
121       $_[0]->storage->dbh->do('SELECT 1');
122       $_[0]->txn_commit
123     },
124     sub {
125       my $guard = $_[0]->txn_scope_guard;
126       $_[0]->storage->dbh->do('SELECT 1');
127       $guard->commit
128     },
129   ) {
130     my $pid = fork();
131     die "Unable to fork: $!\n"
132       if ! defined $pid;
133
134     if ($pid) {
135       push @pids, $pid;
136       next;
137     }
138
139     $action->($schema);
140     exit 0;
141   }
142
143   is ($schema->storage->transaction_depth, 0, 'Parent still outside txn');
144
145   for my $pid (@pids) {
146     waitpid ($pid, 0);
147     ok (! $?, "Child $pid exit ok");
148   }
149 }
150
151 # Test txn_do/scope_guard with forking: outer txn_do
152 {
153   my $schema = DBICTest->init_schema( sqlite_use_file => 1 );
154
155   for my $pass (1..2) {
156
157     # do something trying to destabilize the depth count
158     for (1..2) {
159       eval {
160         my $guard = $schema->txn_scope_guard;
161         $schema->txn_do( sub { die } );
162       };
163       is( $schema->storage->transaction_depth, 0, 'Transaction successfully aborted' );
164       $schema->txn_do( sub {
165         ok ($schema->storage->_dbh->do ('SELECT 1'), "Query after exceptions ok ($_)");
166       });
167     }
168
169     $schema->txn_do ( sub { _test_forking_action ($schema, $pass) } );
170   }
171 }
172
173 # same test with outer guard
174 {
175   my $schema = DBICTest->init_schema( sqlite_use_file => 1 );
176
177   for my $pass (1..2) {
178
179     # do something trying to destabilize the depth count
180     for (1..2) {
181       eval {
182         my $guard = $schema->txn_scope_guard;
183         $schema->txn_do( sub { die } );
184       };
185       is( $schema->storage->transaction_depth, 0, 'Transaction successfully aborted' );
186       $schema->txn_do( sub {
187         ok ($schema->storage->_dbh->do ('SELECT 1'), "Query after exceptions ok ($_)");
188       });
189     }
190
191     my $guard = $schema->txn_scope_guard;
192     my @pids = _test_forking_action ($schema, $pass);
193     $guard->commit;
194   }
195 }
196
197 sub _test_forking_action {
198   my ($schema, $pass) = @_;
199
200   my @pids;
201
202   SKIP: for my $count (1 .. 5) {
203
204     skip 'Weird DBI General Protection Faults, skip forking tests (RT#63104)', 5
205       if $^O eq 'MSWin32';
206
207     my $pid = fork();
208     die "Unable to fork: $!\n"
209       if ! defined $pid;
210
211     if ($pid) {
212       push @pids, $pid;
213       next;
214     }
215
216     if ($count % 2) {
217       $schema->txn_do (sub {
218         my $depth = $schema->storage->transaction_depth;
219         die "$$(txn_do)unexpected txn depth $depth!" if $depth != 1;
220         $schema->resultset ('Artist')->create ({ name => "forking action $$"});
221       });
222     }
223     else {
224       my $guard = $schema->txn_scope_guard;
225       my $depth = $schema->storage->transaction_depth;
226       die "$$(scope_guard) unexpected txn depth $depth!" if $depth != 1;
227       $schema->resultset ('Artist')->create ({ name => "forking action $$"});
228       $guard->commit;
229     }
230
231     exit 0;
232   }
233
234   for my $pid (@pids) {
235     waitpid ($pid, 0);
236     ok (! $?, "Child $pid exit ok (pass $pass)");
237   }
238
239   # it is important to reap all children before checking the final db-state
240   # otherwise a deadlock may occur between the transactions running in the
241   # children and the query of the parent
242   for my $pid (@pids) {
243     isa_ok ($schema->resultset ('Artist')->find ({ name => "forking action $pid" }), 'DBIx::Class::Row');
244   }
245 }
246
247 my $fail_code = sub {
248   my ($artist) = @_;
249   $artist->create_related('cds', {
250     title => 'this should not exist',
251     year => 2005,
252   });
253   die "the sky is falling";
254 };
255
256 {
257   my $schema = DBICTest->init_schema;
258
259   # Test failed txn_do()
260   for my $pass (1,2) {
261
262     is( $schema->storage->{transaction_depth}, 0, "txn depth starts at 0 (pass $pass)");
263
264     my $artist = $schema->resultset('Artist')->find(3);
265
266     throws_ok (sub {
267       $schema->txn_do($fail_code, $artist);
268     }, qr/the sky is falling/, "failed txn_do threw an exception (pass $pass)");
269
270     my $cd = $artist->cds({
271       title => 'this should not exist',
272       year => 2005,
273     })->first;
274     ok(!defined($cd), qq{failed txn_do didn't change the cds table (pass $pass)});
275
276     is( $schema->storage->{transaction_depth}, 0, "txn depth has been reset (pass $pass)");
277   }
278
279
280   # Test failed txn_do() with failed rollback
281   {
282     is( $schema->storage->{transaction_depth}, 0, 'txn depth starts at 0');
283
284     my $artist = $schema->resultset('Artist')->find(3);
285
286     # Force txn_rollback() to throw an exception
287     no warnings qw/once redefine/;
288
289     # this should logically work just fine - but it does not,
290     # only direct override of the existing method dtrt
291     #local *DBIx::Class::Storage::DBI::SQLite::txn_rollback = sub { die 'FAILED' };
292
293     local *DBIx::Class::Storage::DBI::txn_rollback = sub { die 'FAILED' };
294     Class::C3->reinitialize() if DBIx::Class::_ENV_::OLD_MRO;
295
296     throws_ok (
297       sub {
298         $schema->txn_do($fail_code, $artist);
299       },
300       qr/the sky is falling.+Rollback failed/s,
301       'txn_rollback threw a rollback exception (and included the original exception'
302     );
303
304     my $cd = $artist->cds({
305       title => 'this should not exist',
306       year => 2005,
307     })->first;
308     isa_ok($cd, 'DBICTest::CD', q{failed txn_do with a failed txn_rollback }.
309            q{changed the cds table});
310     $cd->delete; # Rollback failed
311     $cd = $artist->cds({
312       title => 'this should not exist',
313       year => 2005,
314     })->first;
315     ok(!defined($cd), q{deleted the failed txn's cd});
316     $schema->storage->_dbh->rollback;
317   }
318 }
319
320 # Test nested failed txn_do()
321 {
322   my $schema = DBICTest->init_schema();
323
324   is( $schema->storage->{transaction_depth}, 0, 'txn depth starts at 0');
325
326   my $nested_fail_code = sub {
327     my ($schema, $artist, $code1, $code2) = @_;
328
329     my @titles = map {'nested txn_do test CD ' . $_} (1..5);
330
331     $schema->txn_do($code1, $artist, @titles); # successful txn
332     $schema->txn_do($code2, $artist);          # failed txn
333   };
334
335   my $artist = $schema->resultset('Artist')->find(3);
336
337   throws_ok ( sub {
338     $schema->txn_do($nested_fail_code, $schema, $artist, $code, $fail_code);
339   }, qr/the sky is falling/, 'nested failed txn_do threw exception');
340
341   ok(!defined($artist->cds({
342     title => 'nested txn_do test CD '.$_,
343     year => 2006,
344   })->first), qq{failed txn_do didn't add first txn's cd $_}) for (1..5);
345   my $cd = $artist->cds({
346     title => 'this should not exist',
347     year => 2005,
348   })->first;
349   ok(!defined($cd), q{failed txn_do didn't add failed txn's cd});
350 }
351
352
353 # Grab a new schema to test txn before connect
354 # also test nested txn exception
355 {
356   my $schema = DBICTest->init_schema(no_deploy => 1);
357   lives_ok (sub {
358     $schema->txn_begin();
359     $schema->txn_begin();
360   }, 'Pre-connection nested transactions.');
361
362   throws_ok( sub { $schema->txn_rollback }, 'DBIx::Class::Storage::NESTED_ROLLBACK_EXCEPTION', 'got proper nested rollback exception' );
363 }
364
365 # make sure AutoCommit => 0 on external handles behaves correctly with scope_guard
366 warnings_are {
367   my $factory = DBICTest->init_schema;
368   cmp_ok ($factory->resultset('CD')->count, '>', 0, 'Something to delete');
369   my $dbh = $factory->storage->dbh;
370   $dbh->{AutoCommit} = 0;
371
372   ok (!$dbh->{AutoCommit}, 'AutoCommit is off on $dbh');
373   my $schema = DBICTest::Schema->connect (sub { $dbh });
374
375   lives_ok ( sub {
376     my $guard = $schema->txn_scope_guard;
377     $schema->resultset('CD')->delete;
378     $guard->commit;
379   }, 'No attempt to start a transaction with scope guard');
380
381   is ($schema->resultset('CD')->count, 0, 'Deletion successful in txn');
382
383   # this will commit the implicitly started txn
384   $dbh->commit;
385
386 } [], 'No warnings on AutoCommit => 0 with txn_guard';
387
388 # make sure AutoCommit => 0 on external handles behaves correctly with txn_do
389 warnings_are {
390   my $factory = DBICTest->init_schema;
391   cmp_ok ($factory->resultset('CD')->count, '>', 0, 'Something to delete');
392   my $dbh = $factory->storage->dbh;
393   $dbh->{AutoCommit} = 0;
394
395   ok (!$dbh->{AutoCommit}, 'AutoCommit is off on $dbh');
396   my $schema = DBICTest::Schema->connect (sub { $dbh });
397
398   lives_ok ( sub {
399     $schema->txn_do (sub { $schema->resultset ('CD')->delete });
400   }, 'No attempt to start a atransaction with txn_do');
401
402   is ($schema->resultset('CD')->count, 0, 'Deletion successful');
403
404   # this will commit the implicitly started txn
405   $dbh->commit;
406
407 } [], 'No warnings on AutoCommit => 0 with txn_do';
408
409 done_testing;