Job that has a run() method and metadata accessors for JobQueue::pop() and JobQueue::ack() More...
Public Member Functions | |
| allowRetries () | |
| getLastError () | |
| getMetadata ( $field=null) | |
| getReadyTimestamp () | |
| getRequestId () | |
| hasExecutionFlag ( $flag) | |
| run () | |
| Run the job. | |
| setMetadata ( $field, $value) | |
| tearDown ( $status) | |
| Do any final cleanup after run(), deferred updates, and all DB commits happen. | |
| toString () | |
| workItemCount () | |
 Public Member Functions inherited from IJobSpecification | |
| getDeduplicationInfo () | |
| Subclasses may need to override this to make duplication detection work. | |
| getParams () | |
| getReleaseTimestamp () | |
| getRootJobParams () | |
| getType () | |
| hasRootJobParams () | |
| ignoreDuplicates () | |
| isRootJob () | |
Detailed Description
Job that has a run() method and metadata accessors for JobQueue::pop() and JobQueue::ack()
Instances are not only enqueueable via JobQueue::push(), but they can also be executed by by calling their run() method. When constructing a job to be enqueued via JobQueue::push(), it will not be possible to construct a RunnableJob instance if the class for that job is not loaded by the application for the local DB domain. In that case, the general-purpose JobSpecification class can be used instead.
Stable to implement
- Since
- 1.33
Definition at line 37 of file RunnableJob.php.
Member Function Documentation
◆ allowRetries()
| RunnableJob::allowRetries | ( | ) |
- Returns
- bool Whether this job can be retried on failure by job runners
- Since
- 1.21
Implemented in Job, AssembleUploadChunksJob, PublishStashedFileJob, and ThumbnailRenderJob.
◆ getLastError()
| RunnableJob::getLastError | ( | ) |
- Returns
- string
Implemented in Job.
◆ getMetadata()
| RunnableJob::getMetadata | ( | $field = null | ) |
- Parameters
-
string | null $field Metadata field or null to get all the metadata
- Returns
- mixed|null Value; null if missing
Implemented in Job.
◆ getReadyTimestamp()
| RunnableJob::getReadyTimestamp | ( | ) |
◆ getRequestId()
| RunnableJob::getRequestId | ( | ) |
- Returns
- string|null Id of the request that created this job. Follows jobs recursively, allowing to track the id of the request that started a job when jobs insert jobs which insert other jobs.
- Since
- 1.27
Implemented in Job.
◆ hasExecutionFlag()
| RunnableJob::hasExecutionFlag | ( | $flag | ) |
◆ run()
| RunnableJob::run | ( | ) |
Run the job.
- Returns
- bool Success
Implemented in ActivityUpdateJob, AssembleUploadChunksJob, CategoryMembershipChangeJob, CdnPurgeJob, ClearUserWatchlistJob, ClearWatchlistNotificationsJob, DeleteLinksJob, DeletePageJob, DoubleRedirectJob, DuplicateJob, EmaillingJob, EnotifNotifyJob, EnqueueJob, HTMLCacheUpdateJob, NullJob, PublishStashedFileJob, RecentChangesUpdateJob, RefreshLinksJob, ThumbnailRenderJob, UserGroupExpiryJob, UserOptionsUpdateJob, and WatchlistExpiryJob.
◆ setMetadata()
| RunnableJob::setMetadata | ( | $field, | |
| $value | |||
| ) |
- Parameters
-
string $field Key name to set the value for mixed $value The value to set the field for
- Returns
- mixed|null The prior field value; null if missing
Implemented in Job.
◆ tearDown()
| RunnableJob::tearDown | ( | $status | ) |
Do any final cleanup after run(), deferred updates, and all DB commits happen.
- Parameters
-
bool $status Whether the job, its deferred updates, and DB commit all succeeded
- Since
- 1.27
◆ toString()
| RunnableJob::toString | ( | ) |
- Returns
- string Debugging string describing the job
Implemented in Job.
◆ workItemCount()
| RunnableJob::workItemCount | ( | ) |
- Returns
- int Number of actually "work items" handled in this job
- See also
- $wgJobBackoffThrottling
- Since
- 1.23
Implemented in Job, HTMLCacheUpdateJob, and RefreshLinksJob.
The documentation for this interface was generated from the following file:
- includes/jobqueue/RunnableJob.php
