* @ingroup Maintenance
*/
class ShowJobs extends Maintenance {
+ protected static $stateMethods = array(
+ 'unclaimed' => 'getAllQueuedJobs',
+ 'delayed' => 'getAllDelayedJobs',
+ 'claimed' => 'getAllAcquiredJobs',
+ 'abandoned' => 'getAllAbandonedJobs',
+ );
+
public function __construct() {
parent::__construct();
$this->mDescription = "Show number of jobs waiting in master database";
$this->addOption( 'group', 'Show number of jobs per job type' );
- $this->addOption(
- 'list',
- 'Show a complete list of all jobs in a machine-readable format, instead of statistics'
- );
+ $this->addOption( 'list', 'Show a list of all jobs instead of counts' );
+ $this->addOption( 'type', 'Only show/count jobs of a given type', false, true );
+ $this->addOption( 'status', 'Filter list by state (unclaimed,delayed,claimed,abandoned)' );
+ $this->addOption( 'limit', 'Limit of jobs listed' );
}
public function execute() {
+ $typeFilter = $this->getOption( 'type', '' );
+ $stateFilter = $this->getOption( 'status', '' );
+ $stateLimit = (float)$this->getOption( 'limit', INF );
+
$group = JobQueueGroup::singleton();
+
+ $filteredTypes = $typeFilter
+ ? array( $typeFilter )
+ : $group->getQueueTypes();
+ $filteredStates = $stateFilter
+ ? array_intersect_key( self::$stateMethods, array( $stateFilter => 1 ) )
+ : self::$stateMethods;
+
if ( $this->hasOption( 'list' ) ) {
- foreach ( $group->getQueueTypes() as $type ) {
+ $count = 0;
+ foreach ( $filteredTypes as $type ) {
$queue = $group->get( $type );
- foreach ( $queue->getAllQueuedJobs() as $job ) {
- $this->output( $job->toString() . " status=unclaimed\n" );
- }
- foreach ( $queue->getAllDelayedJobs() as $job ) {
- $this->output( $job->toString() . " status=delayed\n" );
+ foreach ( $filteredStates as $state => $method ) {
+ foreach ( $queue->$method() as $job ) {
+ /** @var Job $job */
+ $this->output( $job->toString() . " status=$state\n" );
+ if ( ++$count >= $stateLimit ) {
+ return;
+ }
+ }
}
}
} elseif ( $this->hasOption( 'group' ) ) {
- foreach ( $group->getQueueTypes() as $type ) {
+ foreach ( $filteredTypes as $type ) {
$queue = $group->get( $type );
$delayed = $queue->getDelayedCount();
$pending = $queue->getSize();
$claimed = $queue->getAcquiredCount();
$abandoned = $queue->getAbandonedCount();
$active = max( 0, $claimed - $abandoned );
- if ( ( $pending + $claimed + $delayed ) > 0 ) {
+ if ( ( $pending + $claimed + $delayed + $abandoned ) > 0 ) {
$this->output(
"{$type}: $pending queued; " .
"$claimed claimed ($active active, $abandoned abandoned); " .
}
} else {
$count = 0;
- foreach ( $group->getQueueTypes() as $type ) {
+ foreach ( $filteredTypes as $type ) {
$count += $group->get( $type )->getSize();
}
$this->output( "$count\n" );