db987c700a
These new classes provide a mechanism for defining the behavior of slots, like the content models it supports. This acts as an extension point for extensions that need to define custom slots, like the MediaInfo extension for the SDC project. Bug: T194046 Change-Id: Ia20c98eee819293199e541be75b5521f6413bc2f
144 lines
4.7 KiB
PHP
144 lines
4.7 KiB
PHP
<?php
|
|
|
|
/**
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* 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
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* Attribution notice: when this file was created, much of its content was taken
|
|
* from the Revision.php file as present in release 1.30. Refer to the history
|
|
* of that file for original authorship.
|
|
*
|
|
* @file
|
|
*/
|
|
|
|
namespace MediaWiki\Revision;
|
|
|
|
use ActorMigration;
|
|
use CommentStore;
|
|
use MediaWiki\Logger\Spi as LoggerSpi;
|
|
use MediaWiki\Storage\BlobStoreFactory;
|
|
use MediaWiki\Storage\NameTableStoreFactory;
|
|
use WANObjectCache;
|
|
use Wikimedia\Assert\Assert;
|
|
use Wikimedia\Rdbms\ILBFactory;
|
|
|
|
/**
|
|
* Factory service for RevisionStore instances. This allows RevisionStores to be created for
|
|
* cross-wiki access.
|
|
*
|
|
* @warning Beware compatibility issues with schema migration in the context of cross-wiki access!
|
|
* This class assumes that all wikis are at compatible migration stages for all relevant schemas.
|
|
* Relevant schemas are: revision storage (MCR), the revision comment table, and the actor table.
|
|
* Migration stages are compatible as long as a) there are no wikis in the cluster that only write
|
|
* the old schema or b) there are no wikis that read only the new schema.
|
|
*
|
|
* @since 1.32
|
|
*/
|
|
class RevisionStoreFactory {
|
|
|
|
/** @var BlobStoreFactory */
|
|
private $blobStoreFactory;
|
|
/** @var ILBFactory */
|
|
private $dbLoadBalancerFactory;
|
|
/** @var WANObjectCache */
|
|
private $cache;
|
|
/** @var LoggerSpi */
|
|
private $loggerProvider;
|
|
|
|
/** @var CommentStore */
|
|
private $commentStore;
|
|
/** @var ActorMigration */
|
|
private $actorMigration;
|
|
/** @var int One of the MIGRATION_* constants */
|
|
private $mcrMigrationStage;
|
|
/**
|
|
* @var bool
|
|
* @see $wgContentHandlerUseDB
|
|
*/
|
|
private $contentHandlerUseDB;
|
|
|
|
/** @var NameTableStoreFactory */
|
|
private $nameTables;
|
|
|
|
/** @var SlotRoleRegistry */
|
|
private $slotRoleRegistry;
|
|
|
|
/**
|
|
* @param ILBFactory $dbLoadBalancerFactory
|
|
* @param BlobStoreFactory $blobStoreFactory
|
|
* @param NameTableStoreFactory $nameTables
|
|
* @param SlotRoleRegistry $slotRoleRegistry
|
|
* @param WANObjectCache $cache
|
|
* @param CommentStore $commentStore
|
|
* @param ActorMigration $actorMigration
|
|
* @param int $migrationStage
|
|
* @param LoggerSpi $loggerProvider
|
|
* @param bool $contentHandlerUseDB see {@link $wgContentHandlerUseDB}. Must be the same
|
|
* for all wikis in the cluster. Will go away after MCR migration.
|
|
*/
|
|
public function __construct(
|
|
ILBFactory $dbLoadBalancerFactory,
|
|
BlobStoreFactory $blobStoreFactory,
|
|
NameTableStoreFactory $nameTables,
|
|
SlotRoleRegistry $slotRoleRegistry,
|
|
WANObjectCache $cache,
|
|
CommentStore $commentStore,
|
|
ActorMigration $actorMigration,
|
|
$migrationStage,
|
|
LoggerSpi $loggerProvider,
|
|
$contentHandlerUseDB
|
|
) {
|
|
Assert::parameterType( 'integer', $migrationStage, '$migrationStage' );
|
|
$this->dbLoadBalancerFactory = $dbLoadBalancerFactory;
|
|
$this->blobStoreFactory = $blobStoreFactory;
|
|
$this->slotRoleRegistry = $slotRoleRegistry;
|
|
$this->nameTables = $nameTables;
|
|
$this->cache = $cache;
|
|
$this->commentStore = $commentStore;
|
|
$this->actorMigration = $actorMigration;
|
|
$this->mcrMigrationStage = $migrationStage;
|
|
$this->loggerProvider = $loggerProvider;
|
|
$this->contentHandlerUseDB = $contentHandlerUseDB;
|
|
}
|
|
|
|
/**
|
|
* @since 1.32
|
|
*
|
|
* @param bool|string $wikiId false for the current domain / wikid
|
|
*
|
|
* @return RevisionStore for the given wikiId with all necessary services and a logger
|
|
*/
|
|
public function getRevisionStore( $wikiId = false ) {
|
|
Assert::parameterType( 'string|boolean', $wikiId, '$wikiId' );
|
|
|
|
$store = new RevisionStore(
|
|
$this->dbLoadBalancerFactory->getMainLB( $wikiId ),
|
|
$this->blobStoreFactory->newSqlBlobStore( $wikiId ),
|
|
$this->cache, // Pass local cache instance; Leave cache sharing to RevisionStore.
|
|
$this->commentStore,
|
|
$this->nameTables->getContentModels( $wikiId ),
|
|
$this->nameTables->getSlotRoles( $wikiId ),
|
|
$this->slotRoleRegistry,
|
|
$this->mcrMigrationStage,
|
|
$this->actorMigration,
|
|
$wikiId
|
|
);
|
|
|
|
$store->setLogger( $this->loggerProvider->getLogger( 'RevisionStore' ) );
|
|
$store->setContentHandlerUseDB( $this->contentHandlerUseDB );
|
|
|
|
return $store;
|
|
}
|
|
}
|