BacklinkJobUtils Class Reference

Class with Backlink related Job helper methods. More...

Static Public Member Functions
static	partitionBacklinkJob (Job $job, $bSize, $cSize, $opts=array())
	Break down $job into approximately ($bSize/$cSize) leaf jobs and a single partition job that covers the remaining backlink range (if needed). More...

Detailed Description

Class with Backlink related Job helper methods.

Since

1.23

Definition at line 31 of file BacklinkJobUtils.php.

Member Function Documentation

partitionBacklinkJob()

static BacklinkJobUtils::partitionBacklinkJob ( Job  $job,   $bSize,   $cSize,   $opts = array()  )

static

Break down $job into approximately ($bSize/$cSize) leaf jobs and a single partition job that covers the remaining backlink range (if needed).

Jobs for the first $bSize titles are collated ($cSize per job) into leaf jobs to do actual work. All the resulting jobs are of the same class as $job. No partition job is returned if the range covered by $job was less than $bSize, as the leaf jobs have full coverage.

The leaf jobs have the 'pages' param set to a (<page id>="">:(<namespace>,<DB key>="">),...) map so that the run() function knows what pages to act on. The leaf jobs will keep the same job title as the parent job (e.g. $job).

The partition jobs have the 'range' parameter set to a map of the format (start:<integer>, end:<integer>, batchSize:<integer>, subranges:((<start>,<end>),...)), the 'table' parameter set to that of $job, and the 'recursive' parameter set to true. This method can be called on the resulting job to repeat the process again.

The job provided ($job) must have the 'recursive' parameter set to true and the 'table' parameter must be set to a backlink table. The job title will be used as the title to find backlinks for. Any 'range' parameter must follow the same format as mentioned above. This should be managed by recursive calls to this method.

The first jobs return are always the leaf jobs. This lets the caller use push() to put them directly into the queue and works well if the queue is FIFO. In such a queue, the leaf jobs have to get finished first before anything can resolve the next partition job, which keeps the queue very small.

$opts includes:

• params : extra job parameters to include in each job

Parameters

Job	$job
int	$bSize	BacklinkCache partition size; usually $wgUpdateRowsPerJob
int	$cSize	Max titles per leaf job; Usually 1 or a modest value
array	$opts	Optional parameter map

Returns

Job[] List of Job objects

Definition at line 67 of file BacklinkJobUtils.php.

References $job, $params, $title, $titles, array(), as, list, and wfWarn().

Referenced by HTMLCacheUpdateJob\run(), RefreshLinksJob\run(), and RefreshLinksPartitionTest\testRefreshLinks().

---

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

• includes/jobqueue/utils/BacklinkJobUtils.php