d3b2b80067
* In LinksUpdate, put each table in its own class, so that the special code for each table has a more elegant place to go. * Use generators to abstract and flatten out the underlying ParserOutput data structures, without requiring the data to be copied. This allows the incremental logic which was previously duplicated for each table, i.e. computing insertions and deletions from the old and new state, to be factored out. The per-table batch classes act as container abstractions for the underlying data. Bug: T263437 Depends-On: I472f4a023969bfde6298eb56112c16d2ae842199 Change-Id: Id40be19a8caa7b4669911927964cfd6755c25238
88 lines
2.1 KiB
PHP
88 lines
2.1 KiB
PHP
<?php
|
|
|
|
namespace MediaWiki\Deferred\LinksUpdate;
|
|
|
|
use MediaWiki\Page\PageReferenceValue;
|
|
use Title;
|
|
|
|
/**
|
|
* An abstract base class for tables that link to local titles.
|
|
*
|
|
* @stable to extend
|
|
* @since 1.38
|
|
*/
|
|
abstract class TitleLinksTable extends LinksTable {
|
|
/**
|
|
* Convert a link ID to a PageReferenceValue
|
|
*
|
|
* @param mixed $linkId
|
|
* @return PageReferenceValue
|
|
*/
|
|
abstract protected function makePageReferenceValue( $linkId ): PageReferenceValue;
|
|
|
|
/**
|
|
* Convert a link ID to a Title
|
|
*
|
|
* @stable to override
|
|
* @param mixed $linkId
|
|
* @return Title
|
|
*/
|
|
protected function makeTitle( $linkId ): Title {
|
|
return Title::castFromPageReference( $this->makePageReferenceValue( $linkId ) );
|
|
}
|
|
|
|
/**
|
|
* Given an iterator over link IDs, remove links which go to the same
|
|
* title, leaving only one link per title.
|
|
*
|
|
* @param iterable<mixed> $linkIds
|
|
* @return iterable<mixed>
|
|
*/
|
|
abstract protected function deduplicateLinkIds( $linkIds );
|
|
|
|
/**
|
|
* Get link IDs for a given set type, filtering out duplicate links to the
|
|
* same title.
|
|
*
|
|
* @param int $setType
|
|
* @return iterable<mixed>
|
|
*/
|
|
protected function getDeduplicatedLinkIds( $setType ) {
|
|
$linkIds = $this->getLinkIDs( $setType );
|
|
// Only the CHANGED set type should have duplicates
|
|
if ( $setType === self::CHANGED ) {
|
|
$linkIds = $this->deduplicateLinkIds( $linkIds );
|
|
}
|
|
return $linkIds;
|
|
}
|
|
|
|
/**
|
|
* Get a link set as an array of Title objects. This is memory-inefficient.
|
|
*
|
|
* @deprecated since 1.38
|
|
* @param int $setType
|
|
* @return Title[]
|
|
*/
|
|
public function getTitleArray( $setType ) {
|
|
$linkIds = $this->getDeduplicatedLinkIds( $setType );
|
|
$titles = [];
|
|
foreach ( $linkIds as $linkId ) {
|
|
$titles[] = $this->makeTitle( $linkId );
|
|
}
|
|
return $titles;
|
|
}
|
|
|
|
/**
|
|
* Get a link set as an iterator over PageReferenceValue objects.
|
|
*
|
|
* @param int $setType
|
|
* @return iterable<PageReferenceValue>
|
|
* @phan-return \Traversable
|
|
*/
|
|
public function getPageReferenceIterator( $setType ) {
|
|
$linkIds = $this->getDeduplicatedLinkIds( $setType );
|
|
foreach ( $linkIds as $linkId ) {
|
|
yield $this->makePageReferenceValue( $linkId );
|
|
}
|
|
}
|
|
}
|