class BackendChainImplementationUnitTest
Same name in other branches
- 9 core/tests/Drupal/Tests/Core/Cache/BackendChainImplementationUnitTest.php \Drupal\Tests\Core\Cache\BackendChainImplementationUnitTest
- 10 core/tests/Drupal/Tests/Core/Cache/BackendChainImplementationUnitTest.php \Drupal\Tests\Core\Cache\BackendChainImplementationUnitTest
- 11.x core/tests/Drupal/Tests/Core/Cache/BackendChainImplementationUnitTest.php \Drupal\Tests\Core\Cache\BackendChainImplementationUnitTest
Unit test of backend chain implementation specifics.
@group Cache @coversDefaultClass \Drupal\Core\Cache\BackendChain
Hierarchy
- class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\PhpunitCompatibilityTrait
- class \Drupal\Tests\Core\Cache\BackendChainImplementationUnitTest extends \Drupal\Tests\UnitTestCase
Expanded class hierarchy of BackendChainImplementationUnitTest
File
-
core/
tests/ Drupal/ Tests/ Core/ Cache/ BackendChainImplementationUnitTest.php, line 16
Namespace
Drupal\Tests\Core\CacheView source
class BackendChainImplementationUnitTest extends UnitTestCase {
/**
* Chain that will be heavily tested.
*
* @var \Drupal\Core\Cache\BackendChain
*/
protected $chain;
/**
* First backend in the chain.
*
* @var \Drupal\Core\Cache\CacheBackendInterface
*/
protected $firstBackend;
/**
* Second backend in the chain.
*
* @var \Drupal\Core\Cache\CacheBackendInterface
*/
protected $secondBackend;
/**
* Third backend in the chain.
*
* @var \Drupal\Core\Cache\CacheBackendInterface
*/
protected $thirdBackend;
protected function setUp() {
parent::setUp();
// Set up three memory backends to be used in the chain.
$this->firstBackend = new MemoryBackend();
$this->secondBackend = new MemoryBackend();
$this->thirdBackend = new MemoryBackend();
// Set an initial fixed dataset for all testing. The next three data
// collections will test two edge cases (last backend has the data, and
// first backend has the data) and will test a normal use case (middle
// backend has the data). We should have a complete unit test with those.
// Note that in all cases, when the same key is set on more than one
// backend, the values are voluntarily different, this ensures in which
// backend we actually fetched the key when doing get calls.
// Set a key present on all backends (for delete).
$this->firstBackend
->set('t123', 1231);
$this->secondBackend
->set('t123', 1232);
$this->thirdBackend
->set('t123', 1233);
// Set a key present on the second and the third (for get), those two will
// be different, this will ensure from where we get the key.
$this->secondBackend
->set('t23', 232);
$this->thirdBackend
->set('t23', 233);
// Set a key on only the third, we will ensure propagation using this one.
$this->thirdBackend
->set('t3', 33);
// Create the chain.
$this->chain = new BackendChain();
$this->chain
->appendBackend($this->firstBackend)
->appendBackend($this->secondBackend)
->appendBackend($this->thirdBackend);
}
/**
* Test the get feature.
*/
public function testGet() {
$cached = $this->chain
->get('t123');
$this->assertNotSame(FALSE, $cached, 'Got key that is on all backends');
$this->assertSame(1231, $cached->data, 'Got the key from the backend 1');
$cached = $this->chain
->get('t23');
$this->assertNotSame(FALSE, $cached, 'Got key that is on backends 2 and 3');
$this->assertSame(232, $cached->data, 'Got the key from the backend 2');
$cached = $this->chain
->get('t3');
$this->assertNotSame(FALSE, $cached, 'Got key that is on the backend 3');
$this->assertSame(33, $cached->data, 'Got the key from the backend 3');
}
/**
* Test the get multiple feature.
*/
public function testGetMultiple() {
$cids = [
't123',
't23',
't3',
't4',
];
$ret = $this->chain
->getMultiple($cids);
$this->assertSame($ret['t123']->data, 1231, 'Got key 123 and value is from the first backend');
$this->assertSame($ret['t23']->data, 232, 'Got key 23 and value is from the second backend');
$this->assertSame($ret['t3']->data, 33, 'Got key 3 and value is from the third backend');
$this->assertArrayNotHasKey('t4', $ret);
$this->assertNotContains('t123', $cids, "Existing key 123 has been removed from &\$cids");
$this->assertNotContains('t23', $cids, "Existing key 23 has been removed from &\$cids");
$this->assertNotContains('t3', $cids, "Existing key 3 has been removed from &\$cids");
$this->assertContains('t4', $cids, "Non existing key 4 is still in &\$cids");
}
/**
* Test that set will propagate.
*/
public function testSet() {
$this->chain
->set('test', 123);
$cached = $this->firstBackend
->get('test');
$this->assertNotSame(FALSE, $cached, 'Test key is in the first backend');
$this->assertSame(123, $cached->data, 'Test key has the right value');
$cached = $this->secondBackend
->get('test');
$this->assertNotSame(FALSE, $cached, 'Test key is in the second backend');
$this->assertSame(123, $cached->data, 'Test key has the right value');
$cached = $this->thirdBackend
->get('test');
$this->assertNotSame(FALSE, $cached, 'Test key is in the third backend');
$this->assertSame(123, $cached->data, 'Test key has the right value');
}
/**
* Test that delete will propagate.
*/
public function testDelete() {
$this->chain
->set('test', 5);
$cached = $this->firstBackend
->get('test');
$this->assertNotSame(FALSE, $cached, 'Test key has been added to the first backend');
$cached = $this->secondBackend
->get('test');
$this->assertNotSame(FALSE, $cached, 'Test key has been added to the first backend');
$cached = $this->thirdBackend
->get('test');
$this->assertNotSame(FALSE, $cached, 'Test key has been added to the first backend');
$this->chain
->delete('test');
$cached = $this->firstBackend
->get('test');
$this->assertSame(FALSE, $cached, 'Test key is removed from the first backend');
$cached = $this->secondBackend
->get('test');
$this->assertSame(FALSE, $cached, 'Test key is removed from the second backend');
$cached = $this->thirdBackend
->get('test');
$this->assertSame(FALSE, $cached, 'Test key is removed from the third backend');
}
/**
* Ensure get values propagation to previous backends.
*/
public function testGetHasPropagated() {
$this->chain
->get('t23');
$cached = $this->firstBackend
->get('t23');
$this->assertNotSame(FALSE, $cached, 'Test 2 has been propagated to the first backend');
$this->chain
->get('t3');
$cached = $this->firstBackend
->get('t3');
$this->assertNotSame(FALSE, $cached, 'Test 3 has been propagated to the first backend');
$cached = $this->secondBackend
->get('t3');
$this->assertNotSame(FALSE, $cached, 'Test 3 has been propagated to the second backend');
}
/**
* Ensure get multiple values propagation to previous backends.
*/
public function testGetMultipleHasPropagated() {
$cids = [
't3',
't23',
];
$this->chain
->getMultiple($cids);
$cached = $this->firstBackend
->get('t3');
$this->assertNotSame(FALSE, $cached, 'Test 3 has been propagated to the first backend');
$this->assertSame(33, $cached->data, 'And value has been kept');
$cached = $this->secondBackend
->get('t3');
$this->assertNotSame(FALSE, $cached, 'Test 3 has been propagated to the second backend');
$this->assertSame(33, $cached->data, 'And value has been kept');
$cached = $this->firstBackend
->get('t23');
$this->assertNotSame(FALSE, $cached, 'Test 2 has been propagated to the first backend');
$this->assertSame(232, $cached->data, 'And value has been kept');
}
/**
* Test that the delete all operation is propagated to all backends in the chain.
*/
public function testDeleteAllPropagation() {
// Set both expiring and permanent keys.
$this->chain
->set('test1', 1, Cache::PERMANENT);
$this->chain
->set('test2', 3, time() + 1000);
$this->chain
->deleteAll();
$this->assertFalse($this->firstBackend
->get('test1'), 'First key has been deleted in first backend.');
$this->assertFalse($this->firstBackend
->get('test2'), 'Second key has been deleted in first backend.');
$this->assertFalse($this->secondBackend
->get('test1'), 'First key has been deleted in second backend.');
$this->assertFalse($this->secondBackend
->get('test2'), 'Second key has been deleted in second backend.');
$this->assertFalse($this->thirdBackend
->get('test1'), 'First key has been deleted in third backend.');
$this->assertFalse($this->thirdBackend
->get('test2'), 'Second key has been deleted in third backend.');
}
/**
* Test that the delete tags operation is propagated to all backends
* in the chain.
*/
public function testDeleteTagsPropagation() {
// Create two cache entries with the same tag and tag value.
$this->chain
->set('test_cid_clear1', 'foo', Cache::PERMANENT, [
'test_tag:2',
]);
$this->chain
->set('test_cid_clear2', 'foo', Cache::PERMANENT, [
'test_tag:2',
]);
$this->assertNotSame(FALSE, $this->firstBackend
->get('test_cid_clear1') && $this->firstBackend
->get('test_cid_clear2') && $this->secondBackend
->get('test_cid_clear1') && $this->secondBackend
->get('test_cid_clear2') && $this->thirdBackend
->get('test_cid_clear1') && $this->thirdBackend
->get('test_cid_clear2'), 'Two cache items were created in all backends.');
// Invalidate test_tag of value 1. This should invalidate both entries.
$this->chain
->invalidateTags([
'test_tag:2',
]);
$this->assertSame(FALSE, $this->firstBackend
->get('test_cid_clear1') && $this->firstBackend
->get('test_cid_clear2') && $this->secondBackend
->get('test_cid_clear1') && $this->secondBackend
->get('test_cid_clear2') && $this->thirdBackend
->get('test_cid_clear1') && $this->thirdBackend
->get('test_cid_clear2'), 'Two caches removed from all backends after clearing a cache tag.');
// Create two cache entries with the same tag and an array tag value.
$this->chain
->set('test_cid_clear1', 'foo', Cache::PERMANENT, [
'test_tag:1',
]);
$this->chain
->set('test_cid_clear2', 'foo', Cache::PERMANENT, [
'test_tag:1',
]);
$this->assertNotSame(FALSE, $this->firstBackend
->get('test_cid_clear1') && $this->firstBackend
->get('test_cid_clear2') && $this->secondBackend
->get('test_cid_clear1') && $this->secondBackend
->get('test_cid_clear2') && $this->thirdBackend
->get('test_cid_clear1') && $this->thirdBackend
->get('test_cid_clear2'), 'Two cache items were created in all backends.');
// Invalidate test_tag of value 1. This should invalidate both entries.
$this->chain
->invalidateTags([
'test_tag:1',
]);
$this->assertSame(FALSE, $this->firstBackend
->get('test_cid_clear1') && $this->firstBackend
->get('test_cid_clear2') && $this->secondBackend
->get('test_cid_clear1') && $this->secondBackend
->get('test_cid_clear2') && $this->thirdBackend
->get('test_cid_clear1') && $this->thirdBackend
->get('test_cid_clear2'), 'Two caches removed from all backends after clearing a cache tag.');
// Create three cache entries with a mix of tags and tag values.
$this->chain
->set('test_cid_clear1', 'foo', Cache::PERMANENT, [
'test_tag:1',
]);
$this->chain
->set('test_cid_clear2', 'foo', Cache::PERMANENT, [
'test_tag:2',
]);
$this->chain
->set('test_cid_clear3', 'foo', Cache::PERMANENT, [
'test_tag_foo:3',
]);
$this->assertNotSame(FALSE, $this->firstBackend
->get('test_cid_clear1') && $this->firstBackend
->get('test_cid_clear2') && $this->firstBackend
->get('test_cid_clear3') && $this->secondBackend
->get('test_cid_clear1') && $this->secondBackend
->get('test_cid_clear2') && $this->secondBackend
->get('test_cid_clear3') && $this->thirdBackend
->get('test_cid_clear1') && $this->thirdBackend
->get('test_cid_clear2') && $this->thirdBackend
->get('test_cid_clear3'), 'Three cached items were created in all backends.');
$this->chain
->invalidateTags([
'test_tag_foo:3',
]);
$this->assertNotSame(FALSE, $this->firstBackend
->get('test_cid_clear1') && $this->firstBackend
->get('test_cid_clear2') && $this->secondBackend
->get('test_cid_clear1') && $this->secondBackend
->get('test_cid_clear2') && $this->thirdBackend
->get('test_cid_clear1') && $this->thirdBackend
->get('test_cid_clear2'), 'Cached items not matching the tag were not cleared from any of the backends.');
$this->assertSame(FALSE, $this->firstBackend
->get('test_cid_clear3') && $this->secondBackend
->get('test_cid_clear3') && $this->thirdBackend
->get('test_cid_clear3'), 'Cached item matching the tag was removed from all backends.');
}
/**
* Test that removing bin propagates to all backends.
*/
public function testRemoveBin() {
$chain = new BackendChain();
for ($i = 0; $i < 3; $i++) {
$backend = $this->createMock('Drupal\\Core\\Cache\\CacheBackendInterface');
$backend->expects($this->once())
->method('removeBin');
$chain->appendBackend($backend);
}
$chain->removeBin();
}
/**
* Tests deprecation of the constructor parameter.
*
* @group legacy
* @covers ::__construct
* @expectedDeprecation The $bin parameter is deprecated in drupal:8.0.0 and is removed from drupal:9.0.0. Omit the first parameter. See https://www.drupal.org/node/3061125
*/
public function testConstructorParameterDeprecation() {
new BackendChain('arbitrary');
}
}
Members
Title Sort descending | Deprecated | Modifiers | Object type | Summary | Overriden Title | Overrides |
---|---|---|---|---|---|---|
BackendChainImplementationUnitTest::$chain | protected | property | Chain that will be heavily tested. | |||
BackendChainImplementationUnitTest::$firstBackend | protected | property | First backend in the chain. | |||
BackendChainImplementationUnitTest::$secondBackend | protected | property | Second backend in the chain. | |||
BackendChainImplementationUnitTest::$thirdBackend | protected | property | Third backend in the chain. | |||
BackendChainImplementationUnitTest::setUp | protected | function | Overrides UnitTestCase::setUp | |||
BackendChainImplementationUnitTest::testConstructorParameterDeprecation | public | function | Tests deprecation of the constructor parameter. | |||
BackendChainImplementationUnitTest::testDelete | public | function | Test that delete will propagate. | |||
BackendChainImplementationUnitTest::testDeleteAllPropagation | public | function | Test that the delete all operation is propagated to all backends in the chain. | |||
BackendChainImplementationUnitTest::testDeleteTagsPropagation | public | function | Test that the delete tags operation is propagated to all backends in the chain. |
|||
BackendChainImplementationUnitTest::testGet | public | function | Test the get feature. | |||
BackendChainImplementationUnitTest::testGetHasPropagated | public | function | Ensure get values propagation to previous backends. | |||
BackendChainImplementationUnitTest::testGetMultiple | public | function | Test the get multiple feature. | |||
BackendChainImplementationUnitTest::testGetMultipleHasPropagated | public | function | Ensure get multiple values propagation to previous backends. | |||
BackendChainImplementationUnitTest::testRemoveBin | public | function | Test that removing bin propagates to all backends. | |||
BackendChainImplementationUnitTest::testSet | public | function | Test that set will propagate. | |||
PhpunitCompatibilityTrait::getMock | Deprecated | public | function | Returns a mock object for the specified class using the available method. | ||
PhpunitCompatibilityTrait::setExpectedException | Deprecated | public | function | Compatibility layer for PHPUnit 6 to support PHPUnit 4 code. | ||
UnitTestCase::$randomGenerator | protected | property | The random generator. | |||
UnitTestCase::$root | protected | property | The app root. | 1 | ||
UnitTestCase::assertArrayEquals | protected | function | Asserts if two arrays are equal by sorting them first. | |||
UnitTestCase::getBlockMockWithMachineName | Deprecated | protected | function | Mocks a block with a block plugin. | 1 | |
UnitTestCase::getClassResolverStub | protected | function | Returns a stub class resolver. | |||
UnitTestCase::getConfigFactoryStub | public | function | Returns a stub config factory that behaves according to the passed array. | |||
UnitTestCase::getConfigStorageStub | public | function | Returns a stub config storage that returns the supplied configuration. | |||
UnitTestCase::getContainerWithCacheTagsInvalidator | protected | function | Sets up a container with a cache tags invalidator. | |||
UnitTestCase::getRandomGenerator | protected | function | Gets the random generator for the utility methods. | |||
UnitTestCase::getStringTranslationStub | public | function | Returns a stub translation manager that just returns the passed string. | |||
UnitTestCase::randomMachineName | public | function | Generates a unique random string containing letters and numbers. |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.