play框架手冊(cè)-09.異步任務(wù).doc

09.異步Jobs因?yàn)閜lay是一個(gè)web應(yīng)用程序，因此許多應(yīng)用程序邏輯都是由控制器返回給http請(qǐng)求的。但有些時(shí)候，我們需要在http請(qǐng)求外執(zhí)行一些應(yīng)用邏輯。比如非常有用的初始化任務(wù)，維護(hù)任務(wù)或運(yùn)行不能被http請(qǐng)求池中斷的長時(shí)運(yùn)行的任務(wù)等等。Jobs可以被框架全面進(jìn)行管理。意思是play負(fù)責(zé)管理所有的數(shù)據(jù)庫連接原料stuff，JPA實(shí)體管理器負(fù)責(zé)管理數(shù)據(jù)同步和事務(wù)管理。要想創(chuàng)建一個(gè)job，只需要繼承.Job即可。package jobs; import .*; public class MyJob extends Job public void doJob() /在這兒執(zhí)行某些邏輯 有些時(shí)候需要任務(wù)返回結(jié)果，這時(shí)就需要重載doJobWithResult()方法。package jobs; import .*; public class MyJob extends Job public String doJobWithResult() /在這兒執(zhí)行某些邏輯 return result; 本示例僅使用了String作為返回類型，當(dāng)然可以返回任何對(duì)象類型。引導(dǎo)程序任務(wù)Bootstrap jobs引導(dǎo)程序任務(wù)會(huì)在play應(yīng)用啟動(dòng)時(shí)執(zhí)行。要想實(shí)現(xiàn)該任務(wù)，只需要在你的任務(wù)上添加OnApplicationStart注釋：import .*; OnApplicationStartpublic class Bootstrap extends Job public void doJob() if(Page.count() = 0) new Page(root).save(); L(A root page has been created.); 注意：在這里不需要返回結(jié)果，即使這樣做了，結(jié)果也會(huì)丟失。默認(rèn)情況下，所有標(biāo)識(shí)為OnApplicationStart的任務(wù)都將以隊(duì)列方式執(zhí)行。當(dāng)所有的job執(zhí)行結(jié)束后，應(yīng)用程序才正式啟動(dòng)并開始處理請(qǐng)求。如果你打算讓你的任務(wù)在應(yīng)用程序啟動(dòng)時(shí)執(zhí)行，但你又想立即管理進(jìn)行請(qǐng)求處理，那么可以使用OnApplicationStart(async=true)注釋。然后，你的job將在后臺(tái)啟動(dòng)。警告！當(dāng)運(yùn)行于DEV模式時(shí)，應(yīng)用程序?qū)⒃诘谝粋€(gè)請(qǐng)求到達(dá)時(shí)才啟動(dòng)。此外，在DEV模式時(shí)，在需要的時(shí)候，應(yīng)用程序會(huì)自動(dòng)重啟。當(dāng)運(yùn)行于PROD模式時(shí)，應(yīng)用程序?qū)⒑头?wù)器一起同步啟動(dòng)。預(yù)定義任務(wù)Scheduled jobs預(yù)定義任務(wù)由框架周期性執(zhí)行。你可以使用Every注釋要求play在一個(gè)特定的周期內(nèi)運(yùn)行job。import .*; Every(1h)public class Bootstrap extends Job public void doJob() List newUsers = User.find(newAccount = true).fetch(); for(User user : newUsers) Notifier.sayWelcome(user); 如果Every注釋還不足以滿足需要，你可使用帶有CRON表達(dá)式的On注釋來運(yùn)行你的job。import .*; /* Fire at 12pm (noon) every day */ On(0 0 12 * * ?)public class Bootstrap extends Job public void doJob() L(Maintenance job .); . 小建議我們是使用Quartz library來解析CRON表達(dá)式的。你不能返回結(jié)果，即使這樣做了，結(jié)果也會(huì)被丟棄。觸發(fā)任務(wù)job調(diào)用Job實(shí)例的now()方法可以在任何時(shí)候觸發(fā)job來執(zhí)行一段特定的任務(wù)。這個(gè)時(shí)候，job將以非阻塞方式立即執(zhí)行。 public static void encodeVideo(Long videoId) new VideoEncoder(videoId).now(); renderText(Encoding started);調(diào)用job的now()方法以返回一個(gè)Promise值。停止應(yīng)用程序 使用OnApplicationStop注釋可以在應(yīng)用程序關(guān)閉時(shí)執(zhí)行某些操作。import .*