MediaWiki REL1_31
CategoryMembershipChangeJob Class Reference

Job to add recent change entries mentioning category membership changes. More...

Inheritance diagram for CategoryMembershipChangeJob:
Collaboration diagram for CategoryMembershipChangeJob:

Public Member Functions

 __construct (Title $title, array $params)
 
 getDeduplicationInfo ()
 Subclasses may need to override this to make duplication detection work.
 
 run ()
 Run the job.
 
- Public Member Functions inherited from Job
 __construct ( $command, $title, $params=false)
 
 allowRetries ()
 
 getLastError ()
 
 getParams ()
 
 getQueuedTimestamp ()
 
 getReadyTimestamp ()
 
 getReleaseTimestamp ()
 
 getRequestId ()
 
 getRootJobParams ()
 
 getTitle ()
 
 getType ()
 
 hasExecutionFlag ( $flag)
 
 hasRootJobParams ()
 
 ignoreDuplicates ()
 Whether the queue should reject insertion of this job if a duplicate exists.
 
 insert ()
 Insert a single job into the queue.
 
 isRootJob ()
 
 teardown ( $status)
 Do any final cleanup after run(), deferred updates, and all DB commits happen.
 
 toString ()
 
 workItemCount ()
 

Public Attributes

const ENQUEUE_FUDGE_SEC = 60
 
- Public Attributes inherited from Job
string $command
 
array $metadata = []
 Additional queue metadata.
 
array $params
 Array of job parameters.
 

Protected Member Functions

 notifyUpdatesForRevision (LBFactory $lbFactory, WikiPage $page, Revision $newRev)
 
- Protected Member Functions inherited from Job
 addTeardownCallback ( $callback)
 
 setLastError ( $error)
 

Private Member Functions

 getCategoriesAtRev (Title $title, Revision $rev, $parseTimestamp)
 
 getExplicitCategoriesChanges (Title $title, Revision $newRev, Revision $oldRev=null)
 

Private Attributes

int null $ticket
 

Additional Inherited Members

- Static Public Member Functions inherited from Job
static batchInsert ( $jobs)
 Batch-insert a group of jobs into the queue.
 
static factory ( $command, Title $title, $params=[])
 Create the appropriate object to handle a specific job.
 
static newRootJobParams ( $key)
 Get "root job" parameters for a task.
 
- Protected Attributes inherited from Job
string $error
 Text for error that occurred last.
 
int $executionFlags = 0
 Bitfield of JOB_* class constants.
 
bool $removeDuplicates
 Expensive jobs may set this to true.
 
callable[] $teardownCallbacks = []
 
Title $title
 

Detailed Description

Job to add recent change entries mentioning category membership changes.

This allows users to easily scan categories for recent page membership changes

Parameters include:

  • pageId : page ID
  • revTimestamp : timestamp of the triggering revision

Category changes will be mentioned for revisions at/after the timestamp for this page

Since
1.27

Definition at line 38 of file CategoryMembershipChangeJob.php.

Constructor & Destructor Documentation

◆ __construct()

CategoryMembershipChangeJob::__construct ( Title $title,
array $params )

Definition at line 44 of file CategoryMembershipChangeJob.php.

References Job\$params.

Member Function Documentation

◆ getCategoriesAtRev()

CategoryMembershipChangeJob::getCategoriesAtRev ( Title $title,
Revision $rev,
$parseTimestamp )
private
Parameters
Title$title
Revision$rev
string$parseTimestampTS_MW
Returns
string[] category names

Definition at line 234 of file CategoryMembershipChangeJob.php.

References $options, $output, and $rev.

Referenced by getExplicitCategoriesChanges().

◆ getDeduplicationInfo()

CategoryMembershipChangeJob::getDeduplicationInfo ( )

Subclasses may need to override this to make duplication detection work.

The resulting map conveys everything that makes the job unique. This is only checked if ignoreDuplicates() returns true, meaning that duplicate jobs are supposed to be ignored.

Returns
array Map of key/values
Since
1.21

Reimplemented from Job.

Definition at line 247 of file CategoryMembershipChangeJob.php.

◆ getExplicitCategoriesChanges()

CategoryMembershipChangeJob::getExplicitCategoriesChanges ( Title $title,
Revision $newRev,
Revision $oldRev = null )
private

Definition at line 205 of file CategoryMembershipChangeJob.php.

References getCategoriesAtRev().

Referenced by notifyUpdatesForRevision().

◆ notifyUpdatesForRevision()

CategoryMembershipChangeJob::notifyUpdatesForRevision ( LBFactory $lbFactory,
WikiPage $page,
Revision $newRev )
protected
Parameters
LBFactory$lbFactory
WikiPage$page
Revision$newRev
Exceptions
MWException

Definition at line 154 of file CategoryMembershipChangeJob.php.

References getExplicitCategoriesChanges(), RequestContext\getMain(), WikiPage\getTitle(), list, and NS_CATEGORY.

Referenced by run().

◆ run()

CategoryMembershipChangeJob::run ( )

Run the job.

Returns
bool Success

Reimplemented from Job.

Definition at line 51 of file CategoryMembershipChangeJob.php.

References $dbr, $res, $revQuery, DB_MASTER, DB_REPLICA, ENQUEUE_FUDGE_SEC, notifyUpdatesForRevision(), Job\setLastError(), and wfTimestamp().

Member Data Documentation

◆ $ticket

int null CategoryMembershipChangeJob::$ticket
private

Definition at line 40 of file CategoryMembershipChangeJob.php.

◆ ENQUEUE_FUDGE_SEC

const CategoryMembershipChangeJob::ENQUEUE_FUDGE_SEC = 60

Definition at line 42 of file CategoryMembershipChangeJob.php.

Referenced by run().


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