/** * Copyright (C) 2018-present MongoDB, Inc. * * This program is free software: you can redistribute it and/or modify * it under the terms of the Server Side Public License, version 1, * as published by MongoDB, Inc. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * Server Side Public License for more details. * * You should have received a copy of the Server Side Public License * along with this program. If not, see * . * * As a special exception, the copyright holders give permission to link the * code of portions of this program with the OpenSSL library under certain * conditions as described in each individual source file and distribute * linked combinations including the program with the OpenSSL library. You * must comply with the Server Side Public License in all respects for * all of the code used other than as permitted herein. If you modify file(s) * with this exception, you may extend this exception to your version of the * file(s), but you are not obligated to do so. If you do not wish to do so, * delete this exception statement from your version. If you delete this * exception statement from all source files in the program, then also delete * it in the license file. */ #include "mongo/db/storage/recovery_unit_test_harness.h" #include "mongo/db/concurrency/d_concurrency.h" #include "mongo/db/repl/read_concern_level.h" #include "mongo/db/repl/replication_coordinator.h" #include "mongo/db/storage/record_store.h" #include "mongo/db/storage/recovery_unit.h" #include "mongo/unittest/death_test.h" #include "mongo/unittest/unittest.h" namespace mongo { namespace { std::function()> recoveryUnitHarnessFactory; } } // namespace mongo void mongo::registerRecoveryUnitHarnessHelperFactory( std::function()> factory) { recoveryUnitHarnessFactory = std::move(factory); } namespace mongo { auto newRecoveryUnitHarnessHelper() -> std::unique_ptr { return recoveryUnitHarnessFactory(); } namespace { class RecoveryUnitTestHarness : public unittest::Test { public: void setUp() override { harnessHelper = newRecoveryUnitHarnessHelper(); opCtx = harnessHelper->newOperationContext(); ru = opCtx->recoveryUnit(); } std::unique_ptr harnessHelper; ServiceContext::UniqueOperationContext opCtx; RecoveryUnit* ru; }; class TestChange final : public RecoveryUnit::Change { public: TestChange(int* count) : _count(count) {} void commit(boost::optional) override { *_count = *_count + 1; } void rollback() override { *_count = *_count - 1; } private: int* _count; }; TEST_F(RecoveryUnitTestHarness, CommitUnitOfWork) { Lock::GlobalLock globalLk(opCtx.get(), MODE_IX); const auto rs = harnessHelper->createRecordStore(opCtx.get(), "table1"); opCtx->lockState()->beginWriteUnitOfWork(); ru->beginUnitOfWork(opCtx->readOnly()); StatusWith s = rs->insertRecord(opCtx.get(), "data", 4, Timestamp()); ASSERT_TRUE(s.isOK()); ASSERT_EQUALS(1, rs->numRecords(opCtx.get())); ru->commitUnitOfWork(); opCtx->lockState()->endWriteUnitOfWork(); RecordData rd; ASSERT_TRUE(rs->findRecord(opCtx.get(), s.getValue(), &rd)); } TEST_F(RecoveryUnitTestHarness, AbortUnitOfWork) { Lock::GlobalLock globalLk(opCtx.get(), MODE_IX); const auto rs = harnessHelper->createRecordStore(opCtx.get(), "table1"); opCtx->lockState()->beginWriteUnitOfWork(); ru->beginUnitOfWork(opCtx->readOnly()); StatusWith s = rs->insertRecord(opCtx.get(), "data", 4, Timestamp()); ASSERT_TRUE(s.isOK()); ASSERT_EQUALS(1, rs->numRecords(opCtx.get())); ru->abortUnitOfWork(); opCtx->lockState()->endWriteUnitOfWork(); ASSERT_FALSE(rs->findRecord(opCtx.get(), s.getValue(), nullptr)); } TEST_F(RecoveryUnitTestHarness, CommitAndRollbackChanges) { int count = 0; const auto rs = harnessHelper->createRecordStore(opCtx.get(), "table1"); ru->beginUnitOfWork(opCtx->readOnly()); ru->registerChange(std::make_unique(&count)); ASSERT_EQUALS(count, 0); ru->commitUnitOfWork(); ASSERT_EQUALS(count, 1); ru->beginUnitOfWork(opCtx->readOnly()); ru->registerChange(std::make_unique(&count)); ASSERT_EQUALS(count, 1); ru->abortUnitOfWork(); ASSERT_EQUALS(count, 0); } TEST_F(RecoveryUnitTestHarness, CheckIsActiveWithCommit) { Lock::GlobalLock globalLk(opCtx.get(), MODE_IX); const auto rs = harnessHelper->createRecordStore(opCtx.get(), "table1"); opCtx->lockState()->beginWriteUnitOfWork(); ru->beginUnitOfWork(opCtx->readOnly()); ASSERT_TRUE(ru->isActive()); StatusWith s = rs->insertRecord(opCtx.get(), "data", 4, Timestamp()); ru->commitUnitOfWork(); opCtx->lockState()->endWriteUnitOfWork(); ASSERT_FALSE(ru->isActive()); } TEST_F(RecoveryUnitTestHarness, CheckIsActiveWithAbort) { Lock::GlobalLock globalLk(opCtx.get(), MODE_IX); const auto rs = harnessHelper->createRecordStore(opCtx.get(), "table1"); opCtx->lockState()->beginWriteUnitOfWork(); ru->beginUnitOfWork(opCtx->readOnly()); ASSERT_TRUE(ru->isActive()); StatusWith s = rs->insertRecord(opCtx.get(), "data", 4, Timestamp()); ru->abortUnitOfWork(); opCtx->lockState()->endWriteUnitOfWork(); ASSERT_FALSE(ru->isActive()); } TEST_F(RecoveryUnitTestHarness, BeginningUnitOfWorkDoesNotIncrementSnapshotId) { auto snapshotIdBefore = ru->getSnapshotId(); ru->beginUnitOfWork(opCtx->readOnly()); ASSERT_EQ(snapshotIdBefore, ru->getSnapshotId()); ru->abortUnitOfWork(); } TEST_F(RecoveryUnitTestHarness, NewlyAllocatedRecoveryUnitHasNewSnapshotId) { auto newRu = harnessHelper->newRecoveryUnit(); ASSERT_NE(newRu->getSnapshotId(), ru->getSnapshotId()); } TEST_F(RecoveryUnitTestHarness, AbandonSnapshotIncrementsSnapshotId) { auto snapshotIdBefore = ru->getSnapshotId(); ru->abandonSnapshot(); ASSERT_NE(snapshotIdBefore, ru->getSnapshotId()); } TEST_F(RecoveryUnitTestHarness, CommitUnitOfWorkIncrementsSnapshotId) { auto snapshotIdBefore = ru->getSnapshotId(); ru->beginUnitOfWork(opCtx->readOnly()); ru->commitUnitOfWork(); ASSERT_NE(snapshotIdBefore, ru->getSnapshotId()); } TEST_F(RecoveryUnitTestHarness, AbortUnitOfWorkIncrementsSnapshotId) { auto snapshotIdBefore = ru->getSnapshotId(); ru->beginUnitOfWork(opCtx->readOnly()); ru->abortUnitOfWork(); ASSERT_NE(snapshotIdBefore, ru->getSnapshotId()); } // Note that corresponding tests for calling abandonSnapshot() in AbandonSnapshotMode::kAbort are // storage-engine specific. TEST_F(RecoveryUnitTestHarness, AbandonSnapshotCommitMode) { Lock::GlobalLock globalLk(opCtx.get(), MODE_IX); ru->setAbandonSnapshotMode(RecoveryUnit::AbandonSnapshotMode::kCommit); const auto rs = harnessHelper->createRecordStore(opCtx.get(), "table1"); opCtx->lockState()->beginWriteUnitOfWork(); ru->beginUnitOfWork(opCtx->readOnly()); StatusWith rid1 = rs->insertRecord(opCtx.get(), "ABC", 3, Timestamp()); StatusWith rid2 = rs->insertRecord(opCtx.get(), "123", 3, Timestamp()); ASSERT_TRUE(rid1.isOK()); ASSERT_TRUE(rid2.isOK()); ASSERT_EQUALS(2, rs->numRecords(opCtx.get())); ru->commitUnitOfWork(); opCtx->lockState()->endWriteUnitOfWork(); auto snapshotIdBefore = ru->getSnapshotId(); // Now create a cursor. We will check that the cursor is still positioned after a call to // abandonSnapshot(). auto cursor = rs->getCursor(opCtx.get()); auto record = cursor->next(); ASSERT(record); ASSERT_EQ(record->id, rid1.getValue()); ASSERT_EQ(strncmp(record->data.data(), "ABC", 3), 0); // Abandon the snapshot. ru->abandonSnapshot(); // Snapshot ID should have changed. ASSERT_NE(snapshotIdBefore, ru->getSnapshotId()); // The data held by the cursor should still be valid. ASSERT_EQ(strncmp(record->data.data(), "ABC", 3), 0); // Advancing the cursor should return the next record. auto recordAfterAbandon = cursor->next(); ASSERT(recordAfterAbandon); ASSERT_EQ(recordAfterAbandon->id, rid2.getValue()); ASSERT_EQ(strncmp(recordAfterAbandon->data.data(), "123", 3), 0); } TEST_F(RecoveryUnitTestHarness, FlipReadOnly) { ru->beginUnitOfWork(/*readOnly=*/true); ru->endReadOnlyUnitOfWork(); ru->beginUnitOfWork(/*readOnly=*/false); ru->commitUnitOfWork(); ru->beginUnitOfWork(/*readOnly=*/false); ru->abortUnitOfWork(); } DEATH_TEST_F(RecoveryUnitTestHarness, RegisterChangeMustBeInUnitOfWork, "invariant") { int count = 0; opCtx->recoveryUnit()->registerChange(std::make_unique(&count)); } DEATH_TEST_F(RecoveryUnitTestHarness, CommitMustBeInUnitOfWork, "invariant") { opCtx->recoveryUnit()->commitUnitOfWork(); } DEATH_TEST_F(RecoveryUnitTestHarness, AbortMustBeInUnitOfWork, "invariant") { opCtx->recoveryUnit()->abortUnitOfWork(); } DEATH_TEST_F(RecoveryUnitTestHarness, CannotHaveUnfinishedUnitOfWorkOnExit, "invariant") { opCtx->recoveryUnit()->beginUnitOfWork(opCtx->readOnly()); } DEATH_TEST_F(RecoveryUnitTestHarness, PrepareMustBeInUnitOfWork, "invariant") { try { opCtx->recoveryUnit()->prepareUnitOfWork(); } catch (const ExceptionFor&) { bool prepareCommandSupported = false; invariant(prepareCommandSupported); } } DEATH_TEST_F(RecoveryUnitTestHarness, WaitUntilDurableMustBeOutOfUnitOfWork, "invariant") { opCtx->recoveryUnit()->beginUnitOfWork(opCtx->readOnly()); opCtx->recoveryUnit()->waitUntilDurable(opCtx.get()); } DEATH_TEST_F(RecoveryUnitTestHarness, AbandonSnapshotMustBeOutOfUnitOfWork, "invariant") { opCtx->recoveryUnit()->beginUnitOfWork(opCtx->readOnly()); opCtx->recoveryUnit()->abandonSnapshot(); } DEATH_TEST_F(RecoveryUnitTestHarness, CommitInReadOnly, "invariant") { opCtx->recoveryUnit()->beginUnitOfWork(/*readOnly=*/true); opCtx->recoveryUnit()->commitUnitOfWork(); } DEATH_TEST_F(RecoveryUnitTestHarness, AbortInReadOnly, "invariant") { opCtx->recoveryUnit()->beginUnitOfWork(/*readOnly=*/true); opCtx->recoveryUnit()->abortUnitOfWork(); } } // namespace } // namespace mongo