9 eval "use Moose; use Test::Moose";
11 ? ( skip_all => 'needs Moose for testing' )
15 use_ok 'DBIx::Class::Storage::DBI::Replicated::Pool';
16 use_ok 'DBIx::Class::Storage::DBI::Replicated::Balancer';
17 use_ok 'DBIx::Class::Storage::DBI::Replicated::Replicant';
18 use_ok 'DBIx::Class::Storage::DBI::Replicated';
22 This is a test of the replicated storage system. This will work in one of
23 two ways, either it was try to fake replication with a couple of SQLite DBs
24 and creative use of copy, or if you define a couple of %ENV vars correctly
25 will try to test those. If you do that, it will assume the setup is properly
26 replicating. Your results may vary, but I have demonstrated this to work with
27 mysql native replication.
32 ## ----------------------------------------------------------------------------
33 ## Build a class to hold all our required testing data and methods.
34 ## ----------------------------------------------------------------------------
38 ## --------------------------------------------------------------------- ##
39 ## Create an object to contain your replicated stuff.
40 ## --------------------------------------------------------------------- ##
42 package DBIx::Class::DBI::Replicated::TestReplication;
45 use base qw/Class::Accessor::Fast/;
47 __PACKAGE__->mk_accessors( qw/schema/ );
49 ## Initialize the object
53 my $self = $class->SUPER::new(@_);
55 $self->schema( $self->init_schema );
59 ## Get the Schema and set the replication storage type
64 my $schema = DBICTest->init_schema(
66 '::DBI::Replicated' => {
67 balancer_type=>'::Random',
69 auto_validate_every=>100,
81 sub generate_replicant_connect_info {}
86 ## --------------------------------------------------------------------- ##
87 ## Subclass for when you are using SQLite for testing, this provides a fake
88 ## replication support.
89 ## --------------------------------------------------------------------- ##
91 package DBIx::Class::DBI::Replicated::TestReplication::SQLite;
95 use base 'DBIx::Class::DBI::Replicated::TestReplication';
97 __PACKAGE__->mk_accessors( qw/master_path slave_paths/ );
99 ## Set the mastep path from DBICTest
102 my $class = shift @_;
103 my $self = $class->SUPER::new(@_);
105 $self->master_path( DBICTest->_sqlite_dbfilename );
107 "t/var/DBIxClass_slave1.db",
108 "t/var/DBIxClass_slave2.db",
114 ## Return an Array of ArrayRefs where each ArrayRef is suitable to use for
115 ## $storage->connect_info to be used for connecting replicants.
117 sub generate_replicant_connect_info {
121 } @{$self->slave_paths};
123 return map { [$_,'','',{AutoCommit=>1}] } @dsn;
126 ## Do a 'good enough' replication by copying the master dbfile over each of
127 ## the slave dbfiles. If the master is SQLite we do this, otherwise we
128 ## just do a one second pause to let the slaves catch up.
132 foreach my $slave (@{$self->slave_paths}) {
133 copy($self->master_path, $slave);
137 ## Cleanup after ourselves. Unlink all gthe slave paths.
141 foreach my $slave (@{$self->slave_paths}) {
146 ## --------------------------------------------------------------------- ##
147 ## Subclass for when you are setting the databases via custom export vars
148 ## This is for when you have a replicating database setup that you are
149 ## going to test against. You'll need to define the correct $ENV and have
150 ## two slave databases to test against, as well as a replication system
151 ## that will replicate in less than 1 second.
152 ## --------------------------------------------------------------------- ##
154 package DBIx::Class::DBI::Replicated::TestReplication::Custom;
155 use base 'DBIx::Class::DBI::Replicated::TestReplication';
157 ## Return an Array of ArrayRefs where each ArrayRef is suitable to use for
158 ## $storage->connect_info to be used for connecting replicants.
160 sub generate_replicant_connect_info {
162 [$ENV{"DBICTEST_SLAVE0_DSN"}, $ENV{"DBICTEST_SLAVE0_DBUSER"}, $ENV{"DBICTEST_SLAVE0_DBPASS"}, {AutoCommit => 1}],
163 [$ENV{"DBICTEST_SLAVE1_DSN"}, $ENV{"DBICTEST_SLAVE1_DBUSER"}, $ENV{"DBICTEST_SLAVE1_DBPASS"}, {AutoCommit => 1}],
167 ## pause a bit to let the replication catch up
174 ## ----------------------------------------------------------------------------
175 ## Create an object and run some tests
176 ## ----------------------------------------------------------------------------
178 ## Thi first bunch of tests are basic, just make sure all the bits are behaving
180 my $replicated_class = DBICTest->has_custom_dsn ?
181 'DBIx::Class::DBI::Replicated::TestReplication::Custom' :
182 'DBIx::Class::DBI::Replicated::TestReplication::SQLite';
184 ok my $replicated = $replicated_class->new
185 => 'Created a replication object';
187 isa_ok $replicated->schema
188 => 'DBIx::Class::Schema';
190 isa_ok $replicated->schema->storage
191 => 'DBIx::Class::Storage::DBI::Replicated';
193 ok $replicated->schema->storage->meta
194 => 'has a meta object';
196 isa_ok $replicated->schema->storage->master
197 => 'DBIx::Class::Storage::DBI';
199 isa_ok $replicated->schema->storage->pool
200 => 'DBIx::Class::Storage::DBI::Replicated::Pool';
202 does_ok $replicated->schema->storage->balancer
203 => 'DBIx::Class::Storage::DBI::Replicated::Balancer';
205 ok my @replicant_connects = $replicated->generate_replicant_connect_info
206 => 'got replication connect information';
208 ok my @replicated_storages = $replicated->schema->storage->connect_replicants(@replicant_connects)
209 => 'Created some storages suitable for replicants';
211 isa_ok $replicated->schema->storage->balancer->current_replicant
212 => 'DBIx::Class::Storage::DBI';
214 ok $replicated->schema->storage->pool->has_replicants
215 => 'does have replicants';
217 is $replicated->schema->storage->pool->num_replicants => 2
218 => 'has two replicants';
220 does_ok $replicated_storages[0]
221 => 'DBIx::Class::Storage::DBI::Replicated::Replicant';
223 does_ok $replicated_storages[1]
224 => 'DBIx::Class::Storage::DBI::Replicated::Replicant';
226 my @replicant_names = keys %{$replicated->schema->storage->replicants};
228 does_ok $replicated->schema->storage->replicants->{$replicant_names[0]}
229 => 'DBIx::Class::Storage::DBI::Replicated::Replicant';
231 does_ok $replicated->schema->storage->replicants->{$replicant_names[1]}
232 => 'DBIx::Class::Storage::DBI::Replicated::Replicant';
234 ## Add some info to the database
238 ->populate('Artist', [
239 [ qw/artistid name/ ],
240 [ 4, "Ozric Tentacles"],
243 ## Make sure all the slaves have the table definitions
245 $replicated->replicate;
246 $replicated->schema->storage->replicants->{$replicant_names[0]}->active(1);
247 $replicated->schema->storage->replicants->{$replicant_names[1]}->active(1);
249 ## Make sure we can read the data.
251 ok my $artist1 = $replicated->schema->resultset('Artist')->find(4)
255 => 'DBICTest::Artist';
257 is $artist1->name, 'Ozric Tentacles'
258 => 'Found expected name for first result';
260 ## Add some new rows that only the master will have This is because
261 ## we overload any type of write operation so that is must hit the master
266 ->populate('Artist', [
267 [ qw/artistid name/ ],
268 [ 5, "Doom's Children"],
269 [ 6, "Dead On Arrival"],
273 ## Make sure all the slaves have the table definitions
274 $replicated->replicate;
276 ## Should find some data now
278 ok my $artist2 = $replicated->schema->resultset('Artist')->find(5)
282 => 'DBICTest::Artist';
284 is $artist2->name, "Doom's Children"
285 => 'Found expected name for first result';
287 ## What happens when we disconnect all the replicants?
289 is $replicated->schema->storage->pool->connected_replicants => 2
290 => "both replicants are connected";
292 $replicated->schema->storage->replicants->{$replicant_names[0]}->disconnect;
293 $replicated->schema->storage->replicants->{$replicant_names[1]}->disconnect;
295 is $replicated->schema->storage->pool->connected_replicants => 0
296 => "both replicants are now disconnected";
298 ## All these should pass, since the database should automatically reconnect
300 ok my $artist3 = $replicated->schema->resultset('Artist')->find(6)
301 => 'Still finding stuff.';
304 => 'DBICTest::Artist';
306 is $artist3->name, "Dead On Arrival"
307 => 'Found expected name for first result';
309 is $replicated->schema->storage->pool->connected_replicants => 1
310 => "One replicant reconnected to handle the job";
312 ## What happens when we try to select something that doesn't exist?
314 ok ! $replicated->schema->resultset('Artist')->find(666)
315 => 'Correctly failed to find something.';
317 ## test the reliable option
321 $replicated->schema->storage->set_reliable_storage;
323 ok $replicated->schema->resultset('Artist')->find(2)
324 => 'Read from master 1';
326 ok $replicated->schema->resultset('Artist')->find(5)
327 => 'Read from master 2';
329 $replicated->schema->storage->set_balanced_storage;
331 ok $replicated->schema->resultset('Artist')->find(3)
332 => 'Read from replicant';
335 ## Make sure when reliable goes out of scope, we are using replicants again
337 ok $replicated->schema->resultset('Artist')->find(1)
338 => 'back to replicant 1.';
340 ok $replicated->schema->resultset('Artist')->find(2)
341 => 'back to replicant 2.';
343 ## set all the replicants to inactive, and make sure the balancer falls back to
346 $replicated->schema->storage->replicants->{$replicant_names[0]}->active(0);
347 $replicated->schema->storage->replicants->{$replicant_names[1]}->active(0);
349 ok $replicated->schema->resultset('Artist')->find(2)
350 => 'Fallback to master';
352 $replicated->schema->storage->replicants->{$replicant_names[0]}->active(1);
353 $replicated->schema->storage->replicants->{$replicant_names[1]}->active(1);
355 ok $replicated->schema->resultset('Artist')->find(2)
356 => 'Returned to replicates';
358 ## Getting slave status tests
361 ## We skip this tests unless you have a custom replicants, since the default
362 ## sqlite based replication tests don't support these functions.
364 skip 'Cannot Test Replicant Status on Non Replicating Database', 9
365 unless DBICTest->has_custom_dsn && $ENV{"DBICTEST_SLAVE0_DSN"};
367 $replicated->replicate; ## Give the slaves a chance to catchup.
369 ok $replicated->schema->storage->replicants->{$replicant_names[0]}->is_replicating
370 => 'Replicants are replicating';
372 is $replicated->schema->storage->replicants->{$replicant_names[0]}->lag_behind_master, 0
373 => 'Replicant is zero seconds behind master';
375 ## Test the validate replicants
377 $replicated->schema->storage->pool->validate_replicants;
379 is $replicated->schema->storage->pool->active_replicants, 2
380 => 'Still have 2 replicants after validation';
382 ## Force the replicants to fail the validate test by required their lag to
383 ## be negative (ie ahead of the master!)
385 $replicated->schema->storage->pool->maximum_lag(-10);
386 $replicated->schema->storage->pool->validate_replicants;
388 is $replicated->schema->storage->pool->active_replicants, 0
389 => 'No way a replicant be be ahead of the master';
391 ## Let's be fair to the replicants again. Let them lag up to 5
393 $replicated->schema->storage->pool->maximum_lag(5);
394 $replicated->schema->storage->pool->validate_replicants;
396 is $replicated->schema->storage->pool->active_replicants, 2
397 => 'Both replicants in good standing again';
399 ## Check auto validate
401 is $replicated->schema->storage->balancer->auto_validate_every, 100
402 => "Got the expected value for auto validate";
404 ## This will make sure we auto validatge everytime
405 $replicated->schema->storage->balancer->auto_validate_every(0);
407 ## set all the replicants to inactive, and make sure the balancer falls back to
410 $replicated->schema->storage->replicants->{$replicant_names[0]}->active(0);
411 $replicated->schema->storage->replicants->{$replicant_names[1]}->active(0);
413 ## Ok, now when we go to run a query, autovalidate SHOULD reconnect
415 is $replicated->schema->storage->pool->active_replicants => 0
416 => "both replicants turned off";
418 ok $replicated->schema->resultset('Artist')->find(5)
419 => 'replicant reactivated';
421 is $replicated->schema->storage->pool->active_replicants => 2
422 => "both replicants reactivated";
425 ## Test the reliably callback
427 ok my $reliably = sub {
429 ok $replicated->schema->resultset('Artist')->find(5)
430 => 'replicant reactivated';
432 } => 'created coderef properly';
434 $replicated->schema->storage->execute_reliably($reliably);
436 ## Try something with an error
438 ok my $unreliably = sub {
440 ok $replicated->schema->resultset('ArtistXX')->find(5)
441 => 'replicant reactivated';
443 } => 'created coderef properly';
445 throws_ok {$replicated->schema->storage->execute_reliably($unreliably)}
446 qr/Can't find source for ArtistXX/
447 => 'Bad coderef throws proper error';
449 ## Make sure replication came back
451 ok $replicated->schema->resultset('Artist')->find(3)
452 => 'replicant reactivated';
454 ## make sure transactions are set to execute_reliably
456 ok my $transaction = sub {
462 ->populate('Artist', [
463 [ qw/artistid name/ ],
464 [ $id, "Children of the Grave"],
467 ok my $result = $replicated->schema->resultset('Artist')->find($id)
468 => 'Found expected artist';
470 ok my $more = $replicated->schema->resultset('Artist')->find(1)
471 => 'Found expected artist again';
473 return ($result, $more);
475 } => 'Created a coderef properly';
477 ## Test the transaction with multi return
479 ok my @return = $replicated->schema->txn_do($transaction, 666)
480 => 'did transaction';
482 is $return[0]->id, 666
483 => 'first returned value is correct';
486 => 'second returned value is correct';
489 ## Test that asking for single return works
491 ok my $return = $replicated->schema->txn_do($transaction, 777)
492 => 'did transaction';
495 => 'first returned value is correct';
498 ## Test transaction returning a single value
501 ok my $result = $replicated->schema->txn_do(sub {
502 ok my $more = $replicated->schema->resultset('Artist')->find(1)
503 => 'found inside a transaction';
505 }) => 'successfully processed transaction';
508 => 'Got expected single result from transaction';
511 ## Make sure replication came back
513 ok $replicated->schema->resultset('Artist')->find(1)
514 => 'replicant reactivated';
516 ## Test Discard changes
519 ok my $artist = $replicated->schema->resultset('Artist')->find(2)
520 => 'got an artist to test discard changes';
522 ok $artist->discard_changes
523 => 'properly discard changes';
526 ## Test some edge cases, like trying to do a transaction inside a transaction, etc
529 ok my $result = $replicated->schema->txn_do(sub {
530 return $replicated->schema->txn_do(sub {
531 ok my $more = $replicated->schema->resultset('Artist')->find(1)
532 => 'found inside a transaction inside a transaction';
535 }) => 'successfully processed transaction';
538 => 'Got expected single result from transaction';
542 ok my $result = $replicated->schema->txn_do(sub {
543 return $replicated->schema->storage->execute_reliably(sub {
544 return $replicated->schema->txn_do(sub {
545 return $replicated->schema->storage->execute_reliably(sub {
546 ok my $more = $replicated->schema->resultset('Artist')->find(1)
547 => 'found inside crazy deep transactions and execute_reliably';
552 }) => 'successfully processed transaction';
555 => 'Got expected single result from transaction';
558 ## Test the force_pool resultset attribute.
561 ok my $artist_rs = $replicated->schema->resultset('Artist')
562 => 'got artist resultset';
564 ## Turn on Forced Pool Storage
565 ok my $reliable_artist_rs = $artist_rs->search(undef, {force_pool=>'master'})
566 => 'Created a resultset using force_pool storage';
568 ok my $artist = $reliable_artist_rs->find(2)
569 => 'got an artist result via force_pool storage';
572 ## Delete the old database files
573 $replicated->cleanup;