class CacheCollectorTest in Drupal 8

@coversDefaultClass \Drupal\Core\Cache\CacheCollector @group Cache

Hierarchy

• class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses PhpunitCompatibilityTrait
  • class \Drupal\Tests\Core\Cache\CacheCollectorTest

File

core/tests/Drupal/Tests/Core/Cache/CacheCollectorTest.php, line 12

Namespace

Drupal\Tests\Core\Cache

class CacheCollectorTest extends UnitTestCase {

  /**
   * The cache backend that should be used.
   *
   * @var \Drupal\Core\Cache\CacheBackendInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $cacheBackend;

  /**
   * The cache tags invalidator.
   *
   * @var \Drupal\Core\Cache\CacheTagsInvalidatorInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $cacheTagsInvalidator;

  /**
   * The lock backend that should be used.
   *
   * @var \PHPUnit\Framework\MockObject\MockObject
   */
  protected $lock;

  /**
   * The cache id used for the test.
   *
   * @var string
   */
  protected $cid;

  /**
   * Cache collector implementation to test.
   *
   * @var \Drupal\Tests\Core\Cache\CacheCollectorHelper
   */
  protected $collector;

  /**
   * {@inheritdoc}
   */
  protected function setUp() {
    $this->cacheBackend = $this
      ->createMock('Drupal\\Core\\Cache\\CacheBackendInterface');
    $this->cacheTagsInvalidator = $this
      ->createMock('Drupal\\Core\\Cache\\CacheTagsInvalidatorInterface');
    $this->lock = $this
      ->createMock('Drupal\\Core\\Lock\\LockBackendInterface');
    $this->cid = $this
      ->randomMachineName();
    $this->collector = new CacheCollectorHelper($this->cid, $this->cacheBackend, $this->lock);
    $this
      ->getContainerWithCacheTagsInvalidator($this->cacheTagsInvalidator);
  }

  /**
   * Tests the resolve cache miss function.
   */
  public function testResolveCacheMiss() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $this->collector
      ->setCacheMissData($key, $value);
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
  }

  /**
   * Tests setting and getting values when the cache is empty.
   */
  public function testSetAndGet() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $this
      ->assertNull($this->collector
      ->get($key));
    $this->collector
      ->set($key, $value);
    $this
      ->assertTrue($this->collector
      ->has($key));
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
  }

  /**
   * Makes sure that NULL is a valid value and is collected.
   */
  public function testSetAndGetNull() {
    $key = $this
      ->randomMachineName();
    $value = NULL;
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('invalidate')
      ->with($this->cid);
    $this->collector
      ->set($key, $value);
    $this
      ->assertTrue($this->collector
      ->has($key));
    $this
      ->assertEquals($value, $this->collector
      ->get($key));

    // Ensure that getting a value that isn't set does not mark it as
    // existent.
    $non_existing_key = $this
      ->randomMachineName(7);
    $this->collector
      ->get($non_existing_key);
    $this
      ->assertFalse($this->collector
      ->has($non_existing_key));
  }

  /**
   * Tests returning value from the collected cache.
   */
  public function testGetFromCache() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $cache = (object) [
      'data' => [
        $key => $value,
      ],
      'created' => (int) $_SERVER['REQUEST_TIME'],
    ];
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('get')
      ->with($this->cid)
      ->will($this
      ->returnValue($cache));
    $this
      ->assertTrue($this->collector
      ->has($key));
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
    $this
      ->assertEquals(0, $this->collector
      ->getCacheMisses());
  }

  /**
   * Tests setting and deleting values.
   */
  public function testDelete() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $this
      ->assertNull($this->collector
      ->get($key));
    $this->collector
      ->set($key, $value);
    $this
      ->assertTrue($this->collector
      ->has($key));
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('invalidate')
      ->with($this->cid);
    $this->collector
      ->delete($key);
    $this
      ->assertFalse($this->collector
      ->has($key));
    $this
      ->assertEquals(NULL, $this->collector
      ->get($key));
  }

  /**
   * Tests updating the cache when no changes were made.
   */
  public function testUpdateCacheNoChanges() {
    $this->lock
      ->expects($this
      ->never())
      ->method('acquire');
    $this->cacheBackend
      ->expects($this
      ->never())
      ->method('set');

    // Destruct the object to trigger the update data process.
    $this->collector
      ->destruct();
  }

  /**
   * Tests updating the cache after a set.
   */
  public function testUpdateCache() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $this->collector
      ->setCacheMissData($key, $value);
    $this->collector
      ->get($key);

    // Set up mock objects for the expected calls, first a lock acquire, then
    // cache get to look for conflicting cache entries, then a cache set and
    // finally the lock is released again.
    $this->lock
      ->expects($this
      ->once())
      ->method('acquire')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector')
      ->will($this
      ->returnValue(TRUE));
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('get')
      ->with($this->cid, FALSE);
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('set')
      ->with($this->cid, [
      $key => $value,
    ], Cache::PERMANENT, []);
    $this->lock
      ->expects($this
      ->once())
      ->method('release')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector');

    // Destruct the object to trigger the update data process.
    $this->collector
      ->destruct();
  }

  /**
   * Tests updating the cache when the lock acquire fails.
   */
  public function testUpdateCacheLockFail() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $this->collector
      ->setCacheMissData($key, $value);
    $this->collector
      ->get($key);

    // The lock acquire returns false, so the method should abort.
    $this->lock
      ->expects($this
      ->once())
      ->method('acquire')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector')
      ->will($this
      ->returnValue(FALSE));
    $this->cacheBackend
      ->expects($this
      ->never())
      ->method('set');

    // Destruct the object to trigger the update data process.
    $this->collector
      ->destruct();
  }

  /**
   * Tests updating the cache when there is a conflict after cache invalidation.
   */
  public function testUpdateCacheInvalidatedConflict() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $cache = (object) [
      'data' => [
        $key => $value,
      ],
      'created' => (int) $_SERVER['REQUEST_TIME'],
    ];
    $this->cacheBackend
      ->expects($this
      ->at(0))
      ->method('get')
      ->with($this->cid)
      ->will($this
      ->returnValue($cache));
    $this->cacheBackend
      ->expects($this
      ->at(1))
      ->method('invalidate')
      ->with($this->cid);
    $this->collector
      ->set($key, 'new value');

    // Set up mock objects for the expected calls, first a lock acquire, then
    // cache get to look for conflicting cache entries, which does find
    // and then it deletes the cache and aborts.
    $this->lock
      ->expects($this
      ->once())
      ->method('acquire')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector')
      ->will($this
      ->returnValue(TRUE));
    $cache = (object) [
      'data' => [
        $key => $value,
      ],
      'created' => (int) $_SERVER['REQUEST_TIME'] + 1,
    ];
    $this->cacheBackend
      ->expects($this
      ->at(0))
      ->method('get')
      ->with($this->cid)
      ->will($this
      ->returnValue($cache));
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('delete')
      ->with($this->cid);
    $this->lock
      ->expects($this
      ->once())
      ->method('release')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector');

    // Destruct the object to trigger the update data process.
    $this->collector
      ->destruct();
  }

  /**
   * Tests updating the cache when a different request
   */
  public function testUpdateCacheMerge() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $this->collector
      ->setCacheMissData($key, $value);
    $this->collector
      ->get($key);

    // Set up mock objects for the expected calls, first a lock acquire, then
    // cache get to look for existing cache entries, which does find
    // and then it merges them.
    $this->lock
      ->expects($this
      ->once())
      ->method('acquire')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector')
      ->will($this
      ->returnValue(TRUE));
    $cache = (object) [
      'data' => [
        'other key' => 'other value',
      ],
      'created' => (int) $_SERVER['REQUEST_TIME'] + 1,
    ];
    $this->cacheBackend
      ->expects($this
      ->at(0))
      ->method('get')
      ->with($this->cid)
      ->will($this
      ->returnValue($cache));
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('set')
      ->with($this->cid, [
      'other key' => 'other value',
      $key => $value,
    ], Cache::PERMANENT, []);
    $this->lock
      ->expects($this
      ->once())
      ->method('release')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector');

    // Destruct the object to trigger the update data process.
    $this->collector
      ->destruct();
  }

  /**
   * Tests updating the cache after a delete.
   */
  public function testUpdateCacheDelete() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $cache = (object) [
      'data' => [
        $key => $value,
      ],
      'created' => (int) $_SERVER['REQUEST_TIME'],
    ];
    $this->cacheBackend
      ->expects($this
      ->at(0))
      ->method('get')
      ->with($this->cid)
      ->will($this
      ->returnValue($cache));
    $this->collector
      ->delete($key);

    // Set up mock objects for the expected calls, first a lock acquire, then
    // cache get to look for conflicting cache entries, then a cache set and
    // finally the lock is released again.
    $this->lock
      ->expects($this
      ->once())
      ->method('acquire')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector')
      ->will($this
      ->returnValue(TRUE));

    // The second argument is set to TRUE because we triggered a cache
    // invalidation.
    $this->cacheBackend
      ->expects($this
      ->at(0))
      ->method('get')
      ->with($this->cid, TRUE)
      ->will($this
      ->returnValue($cache));
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('set')
      ->with($this->cid, [], Cache::PERMANENT, []);
    $this->lock
      ->expects($this
      ->once())
      ->method('release')
      ->with($this->cid . ':Drupal\\Core\\Cache\\CacheCollector');

    // Destruct the object to trigger the update data process.
    $this->collector
      ->destruct();
  }

  /**
   * Tests a reset of the cache collector.
   */
  public function testUpdateCacheReset() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();

    // Set the data and request it.
    $this->collector
      ->setCacheMissData($key, $value);
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
    $this
      ->assertEquals($value, $this->collector
      ->get($key));

    // Should have been added to the storage and only be requested once.
    $this
      ->assertEquals(1, $this->collector
      ->getCacheMisses());

    // Reset the collected cache, should call it again.
    $this->collector
      ->reset();
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
    $this
      ->assertEquals(2, $this->collector
      ->getCacheMisses());
  }

  /**
   * Tests a clear of the cache collector.
   */
  public function testUpdateCacheClear() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();

    // Set the data and request it.
    $this->collector
      ->setCacheMissData($key, $value);
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
    $this
      ->assertEquals($value, $this->collector
      ->get($key));

    // Should have been added to the storage and only be requested once.
    $this
      ->assertEquals(1, $this->collector
      ->getCacheMisses());

    // Clear the collected cache, should call it again.
    $this->cacheBackend
      ->expects($this
      ->once())
      ->method('delete')
      ->with($this->cid);
    $this->cacheTagsInvalidator
      ->expects($this
      ->never())
      ->method('invalidateTags');
    $this->collector
      ->clear();
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
    $this
      ->assertEquals(2, $this->collector
      ->getCacheMisses());
  }

  /**
   * Tests a clear of the cache collector using tags.
   */
  public function testUpdateCacheClearTags() {
    $key = $this
      ->randomMachineName();
    $value = $this
      ->randomMachineName();
    $tags = [
      $this
        ->randomMachineName(),
    ];
    $this->collector = new CacheCollectorHelper($this->cid, $this->cacheBackend, $this->lock, $tags);

    // Set the data and request it.
    $this->collector
      ->setCacheMissData($key, $value);
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
    $this
      ->assertEquals($value, $this->collector
      ->get($key));

    // Should have been added to the storage and only be requested once.
    $this
      ->assertEquals(1, $this->collector
      ->getCacheMisses());

    // Clear the collected cache using the tags, should call it again.
    $this->cacheBackend
      ->expects($this
      ->never())
      ->method('delete');
    $this->cacheTagsInvalidator
      ->expects($this
      ->once())
      ->method('invalidateTags')
      ->with($tags);
    $this->collector
      ->clear();
    $this
      ->assertEquals($value, $this->collector
      ->get($key));
    $this
      ->assertEquals(2, $this->collector
      ->getCacheMisses());
  }

}

Members

Name	Modifiers	Type	Description	Overrides
CacheCollectorTest::$cacheBackend	protected	property	The cache backend that should be used.
CacheCollectorTest::$cacheTagsInvalidator	protected	property	The cache tags invalidator.
CacheCollectorTest::$cid	protected	property	The cache id used for the test.
CacheCollectorTest::$collector	protected	property	Cache collector implementation to test.
CacheCollectorTest::$lock	protected	property	The lock backend that should be used.
CacheCollectorTest::setUp	protected	function	Overrides UnitTestCase::setUp
CacheCollectorTest::testDelete	public	function	Tests setting and deleting values.
CacheCollectorTest::testGetFromCache	public	function	Tests returning value from the collected cache.
CacheCollectorTest::testResolveCacheMiss	public	function	Tests the resolve cache miss function.
CacheCollectorTest::testSetAndGet	public	function	Tests setting and getting values when the cache is empty.
CacheCollectorTest::testSetAndGetNull	public	function	Makes sure that NULL is a valid value and is collected.
CacheCollectorTest::testUpdateCache	public	function	Tests updating the cache after a set.
CacheCollectorTest::testUpdateCacheClear	public	function	Tests a clear of the cache collector.
CacheCollectorTest::testUpdateCacheClearTags	public	function	Tests a clear of the cache collector using tags.
CacheCollectorTest::testUpdateCacheDelete	public	function	Tests updating the cache after a delete.
CacheCollectorTest::testUpdateCacheInvalidatedConflict	public	function	Tests updating the cache when there is a conflict after cache invalidation.
CacheCollectorTest::testUpdateCacheLockFail	public	function	Tests updating the cache when the lock acquire fails.
CacheCollectorTest::testUpdateCacheMerge	public	function	Tests updating the cache when a different request
CacheCollectorTest::testUpdateCacheNoChanges	public	function	Tests updating the cache when no changes were made.
CacheCollectorTest::testUpdateCacheReset	public	function	Tests a reset of the cache collector.
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.