Class representing a list of titles The execute() method checks them all for existence and adds them to a LinkCache object. More...

Collaboration diagram for LinkBatch:

[legend]

Public Member Functions
	__construct (iterable $arr=[], ?LinkCache $linkCache=null, ?TitleFormatter $titleFormatter=null, ?Language $contentLanguage=null, ?GenderCache $genderCache=null, ?ILoadBalancer $loadBalancer=null)

	add ( $ns, $dbkey)

	addObj ( $link)

	addResultToCache ( $cache, $res)
	Add a result wrapper containing IDs and titles to a LinkCache object. More...

	constructSet ( $prefix, $db)
	Construct a WHERE clause which will match all the given titles. More...

	doGenderQuery ()
	Do (and cache) {{GENDER:...}} information for userpages in this LinkBatch. More...

	doQuery ()
	Perform the existence test query, return a result wrapper with page_id fields. More...

	execute ()
	Do the query and add the results to the LinkCache object. More...

	getPageIdentities ()
	Do the query, add the results to the LinkCache object, and return PageIdentity instances corresponding to the pages in the batch. More...

	getSize ()
	Returns the size of the batch. More...

	isEmpty ()
	Returns true if no pages have been added, false otherwise. More...

	setArray ( $array)
	Set the link list to a given 2-d array First key is the namespace, second is the DB key, value arbitrary. More...

	setCaller ( $caller)
	Use ->setCaller( METHOD ) to indicate which code is using this class. More...

Public Attributes
array[]	$data = []
	2-d array, first index namespace, second index dbkey, value arbitrary More...

Protected Member Functions
	executeInto ( $cache)
	Do the query and add the results to a given LinkCache object Return an array mapping PDBK to ID. More...

Protected Attributes
string null	$caller
	For debugging which method is using this class. More...

Private Attributes
Language	$contentLanguage

GenderCache	$genderCache

LinkCache	$linkCache

ILoadBalancer	$loadBalancer

PageIdentity[] null	$pageIdentities = null
	PageIdentity objects corresponding to the links in the batch. More...

TitleFormatter	$titleFormatter

Detailed Description

Class representing a list of titles The execute() method checks them all for existence and adds them to a LinkCache object.

Definition at line 42 of file LinkBatch.php.

Constructor & Destructor Documentation

◆ __construct()

LinkBatch::__construct	(	iterable	$arr = `[]`,
		?LinkCache	$linkCache = `null`,
		?TitleFormatter	$titleFormatter = `null`,
		?Language	$contentLanguage = `null`,
		?GenderCache	$genderCache = `null`,
		?ILoadBalancer	$loadBalancer = `null`
	)

Parameters

	iterable<LinkTarget>\|iterable<PageReference>	$arr Initial items to be added to the batch
LinkCache \| null	$linkCache
TitleFormatter \| null	$titleFormatter
Language \| null	$contentLanguage
GenderCache \| null	$genderCache
ILoadBalancer \| null	$loadBalancer

Deprecated:: 1.35 Use makeLinkBatch of the LinkBatchFactory service instead

Definition at line 92 of file LinkBatch.php.

References $contentLanguage, $genderCache, $linkCache, $loadBalancer, $titleFormatter, and addObj().

Member Function Documentation

◆ add()

LinkBatch::add	(	$ns,
		$dbkey
	)

Parameters

int	$ns
string	$dbkey

Definition at line 152 of file LinkBatch.php.

Referenced by addObj().

◆ addObj()

LinkBatch::addObj ( $link )

Parameters

LinkTarget | PageReference $link

Definition at line 133 of file LinkBatch.php.

References add(), and wfBacktrace().

Referenced by __construct().

◆ addResultToCache()

LinkBatch::addResultToCache	(	$cache,
		$res
	)

Add a result wrapper containing IDs and titles to a LinkCache object.

As normal, titles will go into the static Title cache field. This function also stores extra fields of the title used for link parsing to avoid extra DB queries.

Parameters

LinkCache	$cache
IResultWrapper	$res

Returns: int[] Array of remaining titles

Definition at line 239 of file LinkBatch.php.

References $cache, $data, $res, and $title.

Referenced by executeInto().

◆ constructSet()

LinkBatch::constructSet	(	$prefix,
		$db
	)

Construct a WHERE clause which will match all the given titles.

Parameters

string	$prefix	The appropriate table's field name prefix ('page', 'pl', etc)
IDatabase	$db	DB object to use

Returns: string|bool String with SQL where clause fragment, or false if no items.

Definition at line 358 of file LinkBatch.php.

Referenced by doQuery().

◆ doGenderQuery()

LinkBatch::doGenderQuery ( )

Do (and cache) {{GENDER:...}} information for userpages in this LinkBatch.

Returns: bool Whether the query was successful

Definition at line 337 of file LinkBatch.php.

References isEmpty().

Referenced by executeInto().

◆ doQuery()

LinkBatch::doQuery ( )

Perform the existence test query, return a result wrapper with page_id fields.

Returns: bool|IResultWrapper

Definition at line 308 of file LinkBatch.php.

References $caller, $dbr, constructSet(), DB_REPLICA, LinkCache\getSelectFields(), and isEmpty().

Referenced by executeInto().

◆ execute()

LinkBatch::execute ( )

Do the query and add the results to the LinkCache object.

Returns: int[] Mapping PDBK to ID

Definition at line 197 of file LinkBatch.php.

References executeInto().

Referenced by getPageIdentities().

◆ executeInto()

LinkBatch::executeInto ( $cache )

protected

Do the query and add the results to a given LinkCache object Return an array mapping PDBK to ID.

Parameters

LinkCache $cache

Returns: int[] Remaining IDs

Definition at line 223 of file LinkBatch.php.

References $cache, $res, addResultToCache(), doGenderQuery(), and doQuery().

Referenced by execute().

◆ getPageIdentities()

LinkBatch::getPageIdentities ( )

Do the query, add the results to the LinkCache object, and return PageIdentity instances corresponding to the pages in the batch.

Since: 1.37

Returns: PageIdentity[] A list of PageIdentities

Definition at line 208 of file LinkBatch.php.

References $pageIdentities, and execute().

◆ getSize()

LinkBatch::getSize ( )

Returns the size of the batch.

Returns: int

Definition at line 188 of file LinkBatch.php.

Referenced by isEmpty().

◆ isEmpty()

LinkBatch::isEmpty ( )

Returns true if no pages have been added, false otherwise.

Returns: bool

Definition at line 179 of file LinkBatch.php.

References getSize().

Referenced by doGenderQuery(), and doQuery().

◆ setArray()

LinkBatch::setArray ( $array )

Set the link list to a given 2-d array First key is the namespace, second is the DB key, value arbitrary.

Parameters

array $array

Definition at line 170 of file LinkBatch.php.

◆ setCaller()

LinkBatch::setCaller ( $caller )

Use ->setCaller( METHOD ) to indicate which code is using this class.

Only used in debugging output.

Since: 1.17

Parameters

string $caller

Returns: self (since 1.32)

Definition at line 124 of file LinkBatch.php.

References $caller.

Member Data Documentation

◆ $caller

string null LinkBatch::$caller

protected

For debugging which method is using this class.

Definition at line 56 of file LinkBatch.php.

Referenced by doQuery(), and setCaller().

◆ $contentLanguage

Language LinkBatch::$contentLanguage

private

Definition at line 71 of file LinkBatch.php.

Referenced by __construct().

◆ $data

array [] LinkBatch::$data = []

2-d array, first index namespace, second index dbkey, value arbitrary

Definition at line 46 of file LinkBatch.php.

Referenced by addResultToCache().

◆ $genderCache

GenderCache LinkBatch::$genderCache

private

Definition at line 76 of file LinkBatch.php.

Referenced by __construct().

◆ $linkCache

LinkCache LinkBatch::$linkCache

private

Definition at line 61 of file LinkBatch.php.

Referenced by __construct().

◆ $loadBalancer

ILoadBalancer LinkBatch::$loadBalancer

private

Definition at line 81 of file LinkBatch.php.

Referenced by __construct().

◆ $pageIdentities

PageIdentity [] null LinkBatch::$pageIdentities = null

private

PageIdentity objects corresponding to the links in the batch.

Definition at line 51 of file LinkBatch.php.

Referenced by getPageIdentities().

◆ $titleFormatter

TitleFormatter LinkBatch::$titleFormatter

private

Definition at line 66 of file LinkBatch.php.

Referenced by __construct().

The documentation for this class was generated from the following file:

includes/cache/LinkBatch.php

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ add()

◆ addObj()

◆ addResultToCache()

◆ constructSet()

◆ doGenderQuery()

◆ doQuery()

◆ execute()

◆ executeInto()

◆ getPageIdentities()

◆ getSize()

◆ isEmpty()

◆ setArray()

◆ setCaller()

Member Data Documentation

◆ $caller

◆ $contentLanguage

◆ $data

◆ $genderCache

◆ $linkCache

◆ $loadBalancer

◆ $pageIdentities

◆ $titleFormatter