LinkBatch.php

Go to the documentation of this file.

<?php
use MediaWiki\Linker\LinkTarget;
use MediaWiki\MediaWikiServices;
use Wikimedia\Rdbms\IResultWrapper;
use Wikimedia\Rdbms\IDatabase;

class LinkBatch {
    public $data = [];

    protected $caller;

    public function __construct( $arr = [] ) {
        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\n" );
        }
    }

    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() {
        $linkCache = MediaWikiServices::getInstance()->getLinkCache();

        return $this->executeInto( $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 [];
        }

        $titleFormatter = MediaWikiServices::getInstance()->getTitleFormatter();
        // 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 = $titleFormatter->getPrefixedDBkey( $title );
                $ids[$pdbk] = $row->page_id;
            } else {
                wfLogWarning( __METHOD__ . ': encountered invalid title: ' . $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 = $titleFormatter->getPrefixedDBkey( $title );
                } else {
                    wfLogWarning( __METHOD__ . ': encountered invalid title: ' . $row->page_title );
                }

                $ids[$pdbk] = 0;
            }
        }

        return $ids;
    }

    public function doQuery() {
        if ( $this->isEmpty() ) {
            return false;
        }

        // This is similar to LinkHolderArray::replaceInternal
        $dbr = wfGetDB( 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;
        }
        $services = MediaWikiServices::getInstance();

        if ( !$services->getContentLanguage()->needsGenderDistinction() ) {
            return false;
        }

        $genderCache = $services->getGenderCache();
        $genderCache->doLinkBatch( $this->data, $this->caller );

        return true;
    }

    public function constructSet( $prefix, $db ) {
        return $db->makeWhereFrom2d( $this->data, "{$prefix}_namespace", "{$prefix}_title" );
    }
}