MediaWiki REL1_28
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 ()
 
 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

integer 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.
 
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.

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 35 of file CategoryMembershipChangeJob.php.

Constructor & Destructor Documentation

◆ __construct()

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

Definition at line 41 of file CategoryMembershipChangeJob.php.

References Job\$params, and Job\$title.

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 223 of file CategoryMembershipChangeJob.php.

References $content, $options, $output, $rev, Job\$title, and ParserOutput\getCategories().

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 236 of file CategoryMembershipChangeJob.php.

◆ getExplicitCategoriesChanges()

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

◆ notifyUpdatesForRevision()

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

◆ run()

CategoryMembershipChangeJob::run ( )

Member Data Documentation

◆ $ticket

integer null CategoryMembershipChangeJob::$ticket
private

Definition at line 37 of file CategoryMembershipChangeJob.php.

◆ ENQUEUE_FUDGE_SEC

const CategoryMembershipChangeJob::ENQUEUE_FUDGE_SEC = 60

Definition at line 39 of file CategoryMembershipChangeJob.php.

Referenced by run().


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