// Copyright IBM Corp. 2015,2019. All Rights Reserved. // Node module: loopback-connector-mysql // This file is licensed under the MIT License. // License text available at https://opensource.org/licenses/MIT 'use strict'; const Transaction = require('loopback-datasource-juggler').Transaction; require('./init.js'); require('should'); let db, Post, Review; describe('transactions', function() { before(function(done) { db = global.getDataSource({collation: 'utf8_general_ci', createDatabase: true}); db.once('connected', function() { Post = db.define('PostTX', { title: {type: String, length: 255, index: true}, content: {type: String}, }, {mysql: {engine: 'INNODB'}}); Review = db.define('ReviewTX', { author: String, content: {type: String}, }, {mysql: {engine: 'INNODB'}}); Post.hasMany(Review, {as: 'reviews', foreignKey: 'postId'}); db.automigrate(['PostTX', 'ReviewTX'], done); }); }); let currentTx; let hooks = []; // Return an async function to start a transaction and create a post function createPostInTx(post, timeout) { return function(done) { // Transaction.begin(db.connector, Transaction.READ_COMMITTED, Post.beginTransaction({ isolationLevel: Transaction.READ_COMMITTED, timeout: timeout, }, function(err, tx) { if (err) return done(err); (typeof tx.id).should.be.eql('string'); hooks = []; tx.observe('before commit', function(context, next) { hooks.push('before commit'); next(); }); tx.observe('after commit', function(context, next) { hooks.push('after commit'); next(); }); tx.observe('before rollback', function(context, next) { hooks.push('before rollback'); next(); }); tx.observe('after rollback', function(context, next) { hooks.push('after rollback'); next(); }); currentTx = tx; Post.create(post, {transaction: tx}, function(err, p) { if (err) { done(err); } else { p.reviews.create({ author: 'John', content: 'Review for ' + p.title, }, {transaction: tx}, function(err, c) { done(err); }); } }); }); }; } // Return an async function to find matching posts and assert number of // records to equal to the count function expectToFindPosts(where, count, inTx) { return function(done) { const options = {}; if (inTx) { options.transaction = currentTx; } Post.find({where: where}, options, function(err, posts) { if (err) return done(err); posts.length.should.be.eql(count); if (count) { // Find related reviews // Please note the empty {} is required, otherwise, the options // will be treated as a filter posts[0].reviews({}, options, function(err, reviews) { if (err) return done(err); reviews.length.should.be.eql(count); done(); }); } else { done(); } }); }; } describe('commit', function() { const post = {title: 't1', content: 'c1'}; before(createPostInTx(post)); it('should not see the uncommitted insert', expectToFindPosts(post, 0)); it('should see the uncommitted insert from the same transaction', expectToFindPosts(post, 1, true)); it('should commit a transaction', function(done) { currentTx.commit(function(err) { hooks.should.be.eql(['before commit', 'after commit']); done(err); }); }); it('should see the committed insert', expectToFindPosts(post, 1)); it('should report error if the transaction is not active', function(done) { currentTx.commit(function(err) { (err).should.be.instanceof(Error); done(); }); }); }); describe('rollback', function() { const post = {title: 't2', content: 'c2'}; before(createPostInTx(post)); it('should not see the uncommitted insert', expectToFindPosts(post, 0)); it('should see the uncommitted insert from the same transaction', expectToFindPosts(post, 1, true)); it('should rollback a transaction', function(done) { currentTx.rollback(function(err) { hooks.should.be.eql(['before rollback', 'after rollback']); done(err); }); }); it('should not see the rolledback insert', expectToFindPosts(post, 0)); it('should report error if the transaction is not active', function(done) { currentTx.rollback(function(err) { (err).should.be.instanceof(Error); done(); }); }); }); describe('timeout', function() { const post = {title: 't3', content: 'c3'}; before(createPostInTx(post, 500)); it('should invoke the timeout hook', function(done) { currentTx.observe('timeout', function(context, next) { next(); // It will only proceed upon timeout done(); }); }); it('should rollback the transaction if timeout', function(done) { Post.find({where: {title: 't3'}}, {transaction: currentTx}, function(err, posts) { if (err) return done(err); posts.length.should.be.eql(0); done(); }); }); }); });