2014-02-11 13:00:24 +00:00
|
|
|
<?php
|
|
|
|
/**
|
2014-02-12 12:32:16 +00:00
|
|
|
* Copyright (c) 2014 Robin Appelman <icewind@owncloud.com>
|
2014-02-11 13:00:24 +00:00
|
|
|
* This file is licensed under the Affero General Public License version 3 or
|
|
|
|
* later.
|
|
|
|
* See the COPYING-README file.
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace OCP\BackgroundJob;
|
|
|
|
|
|
|
|
interface IJobList {
|
|
|
|
/**
|
2014-02-12 12:32:16 +00:00
|
|
|
* Add a job to the list
|
|
|
|
*
|
2014-02-11 13:00:24 +00:00
|
|
|
* @param \OCP\BackgroundJob\IJob |string $job
|
2014-02-12 12:32:16 +00:00
|
|
|
* @param mixed $argument The argument to be passed to $job->run() when the job is exectured
|
2014-02-19 08:31:54 +00:00
|
|
|
* @param string $job
|
|
|
|
* @return void
|
2014-02-11 13:00:24 +00:00
|
|
|
*/
|
|
|
|
public function add($job, $argument = null);
|
|
|
|
|
|
|
|
/**
|
2014-02-12 12:32:16 +00:00
|
|
|
* Remove a job from the list
|
|
|
|
*
|
2014-02-19 08:31:54 +00:00
|
|
|
* @param IJob $job
|
2014-02-11 13:00:24 +00:00
|
|
|
* @param mixed $argument
|
2014-02-19 08:31:54 +00:00
|
|
|
* @return void
|
2014-02-11 13:00:24 +00:00
|
|
|
*/
|
|
|
|
public function remove($job, $argument = null);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* check if a job is in the list
|
|
|
|
*
|
|
|
|
* @param $job
|
|
|
|
* @param mixed $argument
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function has($job, $argument);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* get all jobs in the list
|
|
|
|
*
|
|
|
|
* @return \OCP\BackgroundJob\IJob[]
|
|
|
|
*/
|
|
|
|
public function getAll();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* get the next job in the list
|
|
|
|
*
|
|
|
|
* @return \OCP\BackgroundJob\IJob
|
|
|
|
*/
|
|
|
|
public function getNext();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @param int $id
|
|
|
|
* @return \OCP\BackgroundJob\IJob
|
|
|
|
*/
|
|
|
|
public function getById($id);
|
|
|
|
|
|
|
|
/**
|
2014-02-12 12:32:16 +00:00
|
|
|
* set the job that was last ran to the current time
|
2014-02-11 13:00:24 +00:00
|
|
|
*
|
|
|
|
* @param \OCP\BackgroundJob\IJob $job
|
2014-02-19 08:31:54 +00:00
|
|
|
* @return void
|
2014-02-11 13:00:24 +00:00
|
|
|
*/
|
|
|
|
public function setLastJob($job);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* get the id of the last ran job
|
|
|
|
*
|
|
|
|
* @return int
|
|
|
|
*/
|
|
|
|
public function getLastJob();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* set the lastRun of $job to now
|
|
|
|
*
|
|
|
|
* @param \OCP\BackgroundJob\IJob $job
|
2014-02-19 08:31:54 +00:00
|
|
|
* @return void
|
2014-02-11 13:00:24 +00:00
|
|
|
*/
|
|
|
|
public function setLastRun($job);
|
|
|
|
}
|