http://blog.sina.com.cn/s/blog_9f2dd2f301014rrv.html
APScheduler是基於Quartz的 一個Python定時任務框架,實現了Quartz的所有功能,使用起來十分方便。提供了基於日期、固定時間間隔以及crontab類型的任務,並且可以 持久化任務。基於這些功能,我們可以很方便的實現一個python定時任務系統,寫python還是要比java舒服多了。
安裝過程很簡單,可以基於easy_install和源碼。
[plain] view plaincopyprint?
easy_install apscheduler
或者下載源碼,運行命令:
[plain] view plaincopyprint?
python setup.py install
APScheduler是進程內的調度器,可以定時觸發具體的函數,並且可以訪問應用的所有變量和函數。在web應用中通過APScheduler實現定時任務是很方便的。下面看例子:
[python] view plaincopyprint?
from apscheduler.scheduler import Scheduler
schedudler = Scheduler(daemonic = False)
@schedudler.cron_schedule(second='*', day_of_week='0-4', hour='9-12,13-15')
def quote_send_sh_job():
print 'a simple cron job start at', datetime.datetime.now()
schedudler.start()
上面通過裝飾器定義了cron job,可以通過函數scheduler.add_cron_job添加,用裝飾器更方便。Scheduler構造函數中傳入daemonic參數,表示執行線程是非守護的,在Schduler的文檔中推薦使用非守護線程:
[plain] view plaincopyprint?
Jobs are always executed in non-daemonic threads.
具體cron job的配置參看doc,基本上與Quartz一致。
在添加job時還有一個比較重要的參數max_instances,指定一個job的併發實例數,默認值是1。默認情況下,如果一個job準備執行,但是該job的前一個實例尚未執行完,則後一個job會失敗,可以通過這個參數來改變這種情況。
APScheduler提供了jobstore用於存儲job的執行信息,默認使用的是RAMJobStore,還提供了 SQLAlchemyJobStore、ShelveJobStore和MongoDBJobStore。APScheduler允許同時使用多個 jobstore,通過別名(alias)區分,在添加job時需要指定具體的jobstore的別名,否則使用的是別名是default的 jobstore,即RAMJobStore。下面以MongoDBJobStore舉例說明。
[python] view plaincopyprint?
import pymongo
from apscheduler.scheduler import Scheduler
from apscheduler.jobstores.mongodb_store import MongoDBJobStore
import time
sched = Scheduler(daemonic = False)
mongo = pymongo.Connection(host='127.0.0.1', port=27017)
store = MongoDBJobStore(connection=mongo)
sched.add_jobstore(store, 'mongo')<span style="white-space:pre"> </span># 別名是mongo
@sched.cron_schedule(second='*', day_of_week='0-4', hour='9-12,13-15', jobstore='mongo')<span style="white-space:pre"> </span># 向別名爲mongo的jobstore添加job
def job():
print 'a job'
time.sleep(1)
sched.start()
注意start必須在添加job動作之後調用,否則會拋錯。默認會把job信息保存在apscheduler數據庫下的jobs表:
[plain] view plaincopyprint?
> db.jobs.findOne()
{
"_id" : ObjectId("502202d1443c1557fa8b8d66"),
"runs" : 20,
"name" : "job",
"misfire_grace_time" : 1,
"coalesce" : true,
"args" : BinData(0,"gAJdcQEu"),
"next_run_time" : ISODate("2012-08-08T14:10:46Z"),
"max_instances" : 1,
"max_runs" : null,
"trigger" : BinData(0,"gAJjYXBzY2hlZHVsZXIudHJpZ2dlcnMuY3JvbgpDcm9uVHJpZ2dlcgpxASmBcQJ9cQMoVQZmaWVsZHNxBF1xBShjYXBzY2hlZHVsZXIudHJpZ2dlcnMuY3Jvbi5maWVsZHMKQmFzZUZpZWxkCnEGKYFxB31xCChVCmlzX2RlZmF1bHRxCYhVC2V4cHJlc3Npb25zcQpdcQtjYXBzY2hlZHVsZXIudHJpZ2dlcnMuY3Jvbi5leHByZXNzaW9ucwpBbGxFeHByZXNzaW9uCnEMKYFxDX1xDlUEc3RlcHEPTnNiYVUEbmFtZXEQVQR5ZWFycRF1YmgGKYFxEn1xEyhoCYhoCl1xFGgMKYFxFX1xFmgPTnNiYWgQVQVtb250aHEXdWJjYXBzY2hlZHVsZXIudHJpZ2dlcnMuY3Jvbi5maWVsZHMKRGF5T2ZNb250aEZpZWxkCnEYKYFxGX1xGihoCYhoCl1xG2gMKYFxHH1xHWgPTnNiYWgQVQNkYXlxHnViY2Fwc2NoZWR1bGVyLnRyaWdnZXJzLmNyb24uZmllbGRzCldlZWtGaWVsZApxHymBcSB9cSEoaAmIaApdcSJoDCmBcSN9cSRoD05zYmFoEFUEd2Vla3EldWJjYXBzY2hlZHVsZXIudHJpZ2dlcnMuY3Jvbi5maWVsZHMKRGF5T2ZXZWVrRmllbGQKcSYpgXEnfXEoKGgJiWgKXXEpY2Fwc2NoZWR1bGVyLnRyaWdnZXJzLmNyb24uZXhwcmVzc2lvbnMKUmFuZ2VFeHByZXNzaW9uCnEqKYFxK31xLChoD05VBGxhc3RxLUsEVQVmaXJzdHEuSwB1YmFoEFULZGF5X29mX3dlZWtxL3ViaAYpgXEwfXExKGgJiWgKXXEyKGgqKYFxM31xNChoD05oLUsMaC5LCXViaCopgXE1fXE2KGgPTmgtSw9oLksNdWJlaBBVBGhvdXJxN3ViaAYpgXE4fXE5KGgJiGgKXXE6aAwpgXE7fXE8aA9Oc2JhaBBVBm1pbnV0ZXE9dWJoBimBcT59cT8oaAmJaApdcUBoDCmBcUF9cUJoD05zYmFoEFUGc2Vjb25kcUN1YmVVCnN0YXJ0X2RhdGVxRE51Yi4="),
"func_ref" : "__main__:job",
"kwargs" : BinData(0,"gAJ9cQEu")
}
上面就是存儲的具體信息。