LinkBatch.php

Go to the documentation of this file.

<?php
use MediaWiki\Linker\LinkTarget;
use MediaWiki\MediaWikiServices;
use Wikimedia\Rdbms\IDatabase;
use Wikimedia\Rdbms\ILoadBalancer;
use Wikimedia\Rdbms\IResultWrapper;
 
class LinkBatch {
    public $data = [];
 
    protected $caller;
 
    private $linkCache;
 
    private $titleFormatter;
 
    private $contentLanguage;
 
    private $genderCache;
 
    private $loadBalancer;
 
    public function __construct(
        iterable $arr = [],
        ?LinkCache $linkCache = null,
        ?TitleFormatter $titleFormatter = null,
        ?Language $contentLanguage = null,
        ?GenderCache $genderCache = null,
        ?ILoadBalancer $loadBalancer = null
    ) {
        $getServices = function () {
            // BC hack. Use a closure so this can be unit-tested.
            return MediaWikiServices::getInstance();
        };
 
        $this->linkCache = $linkCache ?? $getServices()->getLinkCache();
        $this->titleFormatter = $titleFormatter ?? $getServices()->getTitleFormatter();
        $this->contentLanguage = $contentLanguage ?? $getServices()->getContentLanguage();
        $this->genderCache = $genderCache ?? $getServices()->getGenderCache();
        $this->loadBalancer = $loadBalancer ?? $getServices()->getDBLoadBalancer();
 
        foreach ( $arr as $item ) {
            $this->addObj( $item );
        }
    }
 
    public function setCaller( $caller ) {
        $this->caller = $caller;
 
        return $this;
    }
 
    public function addObj( $linkTarget ) {
        if ( is_object( $linkTarget ) ) {
            $this->add( $linkTarget->getNamespace(), $linkTarget->getDBkey() );
        } else {
            wfDebug( "Warning: LinkBatch::addObj got invalid LinkTarget object" );
        }
    }
 
    public function add( $ns, $dbkey ) {
        if ( $ns < 0 || $dbkey === '' ) {
            return; // T137083
        }
        if ( !array_key_exists( $ns, $this->data ) ) {
            $this->data[$ns] = [];
        }
 
        $this->data[$ns][strtr( $dbkey, ' ', '_' )] = 1;
    }
 
    public function setArray( $array ) {
        $this->data = $array;
    }
 
    public function isEmpty() {
        return $this->getSize() == 0;
    }
 
    public function getSize() {
        return count( $this->data );
    }
 
    public function execute() {
        return $this->executeInto( $this->linkCache );
    }
 
    protected function executeInto( $cache ) {
        $res = $this->doQuery();
        $this->doGenderQuery();
        $ids = $this->addResultToCache( $cache, $res );
 
        return $ids;
    }
 
    public function addResultToCache( $cache, $res ) {
        if ( !$res ) {
            return [];
        }
 
        // For each returned entry, add it to the list of good links, and remove it from $remaining
 
        $ids = [];
        $remaining = $this->data;
        foreach ( $res as $row ) {
            $title = TitleValue::tryNew( (int)$row->page_namespace, $row->page_title );
            if ( $title ) {
                $cache->addGoodLinkObjFromRow( $title, $row );
                $pdbk = $this->titleFormatter->getPrefixedDBkey( $title );
                $ids[$pdbk] = $row->page_id;
            } else {
                wfLogWarning( __METHOD__ . ': encountered invalid title: ' .
                    $row->page_namespace . '-' . $row->page_title );
            }
 
            unset( $remaining[$row->page_namespace][$row->page_title] );
        }
 
        // The remaining links in $data are bad links, register them as such
        foreach ( $remaining as $ns => $dbkeys ) {
            foreach ( $dbkeys as $dbkey => $unused ) {
                $title = TitleValue::tryNew( (int)$ns, (string)$dbkey );
                if ( $title ) {
                    $cache->addBadLinkObj( $title );
                    $pdbk = $this->titleFormatter->getPrefixedDBkey( $title );
                    $ids[$pdbk] = 0;
                } else {
                    wfLogWarning( __METHOD__ . ': encountered invalid title: ' . $ns . '-' . $dbkey );
                }
            }
        }
 
        return $ids;
    }
 
    public function doQuery() {
        if ( $this->isEmpty() ) {
            return false;
        }
 
        // This is similar to LinkHolderArray::replaceInternal
        $dbr = $this->loadBalancer->getConnectionRef( DB_REPLICA );
        $table = 'page';
        $fields = array_merge(
            LinkCache::getSelectFields(),
            [ 'page_namespace', 'page_title' ]
        );
 
        $conds = $this->constructSet( 'page', $dbr );
 
        // Do query
        $caller = __METHOD__;
        if ( strval( $this->caller ) !== '' ) {
            $caller .= " (for {$this->caller})";
        }
        $res = $dbr->select( $table, $fields, $conds, $caller );
 
        return $res;
    }
 
    public function doGenderQuery() {
        if ( $this->isEmpty() ) {
            return false;
        }
 
        if ( !$this->contentLanguage->needsGenderDistinction() ) {
            return false;
        }
 
        $this->genderCache->doLinkBatch( $this->data, $this->caller );
 
        return true;
    }
 
    public function constructSet( $prefix, $db ) {
        return $db->makeWhereFrom2d( $this->data, "{$prefix}_namespace", "{$prefix}_title" );
    }
}