wikimedia/mediawiki-extensions-Wikibase

<?php

declare( strict_types = 1 );

namespace Wikibase\Client\Usage;

use ArrayIterator;
use Traversable;
use Wikibase\DataModel\Entity\EntityId;

/**
 * No-op implementation of the UsageTracker and UsageLookup interfaces.
 *
 * @license GPL-2.0-or-later
 * @author Daniel Kinzler
 * @author Marius Hoch
 */
class NullUsageTracker implements UsageTracker, UsageLookup {

    /**
     * @see UsageTracker::addUsedEntities
     *
     * @param int $pageId
     * @param EntityUsage[] $usages
     */
    public function addUsedEntities( int $pageId, array $usages ): void {
        // no-op
    }

    /**
     * @see UsageTracker::replaceUsedEntities
     *
     * @param int $pageId
     * @param EntityUsage[] $usages
     *
     * @return EntityUsage[]
     */
    public function replaceUsedEntities( int $pageId, array $usages ): array {
        return [];
    }

    /**
     * @see UsageTracker::pruneUsages
     *
     * @param int $pageId
     *
     * @return EntityUsage[]
     */
    public function pruneUsages( int $pageId ): array {
        return [];
    }

    /**
     * @see UsageTracker::getUsagesForPage
     *
     * @param int $pageId
     *
     * @return EntityUsage[]
     */
    public function getUsagesForPage( int $pageId ): array {
        return [];
    }

    /**
     * @see UsageLookup::getUnusedEntities
     *
     * @param EntityId[] $entityIds
     *
     * @return EntityId[]
     */
    public function getUnusedEntities( array $entityIds ): array {
        return [];
    }

    /**
     * @see UsageLookup::getPagesUsing
     *
     * @param EntityId[] $entities
     * @param string[] $aspects
     *
     * @return Traversable Always empty.
     */
    public function getPagesUsing( array $entities, array $aspects = [] ): Traversable {
        return new ArrayIterator();
    }

}