play框架手冊-09.異步任務.doc

09.異步Jobs因為play是一個web應用程序，因此許多應用程序邏輯都是由控制器返回給http請求的。但有些時候，我們需要在http請求外執(zhí)行一些應用邏輯。比如非常有用的初始化任務，維護任務或運行不能被http請求池中斷的長時運行的任務等等。Jobs可以被框架全面進行管理。意思是play負責管理所有的數據庫連接原料stuff，JPA實體管理器負責管理數據同步和事務管理。要想創(chuàng)建一個job，只需要繼承.Job即可。package jobs; import .*; public class MyJob extends Job public void doJob() /在這兒執(zhí)行某些邏輯 有些時候需要任務返回結果，這時就需要重載doJobWithResult()方法。package jobs; import .*; public class MyJob extends Job public String doJobWithResult() /在這兒執(zhí)行某些邏輯 return result; 本示例僅使用了String作為返回類型，當然可以返回任何對象類型。引導程序任務Bootstrap jobs引導程序任務會在play應用啟動時執(zhí)行。要想實現該任務，只需要在你的任務上添加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.); 注意：在這里不需要返回結果，即使這樣做了，結果也會丟失。默認情況下，所有標識為OnApplicationStart的任務都將以隊列方式執(zhí)行。當所有的job執(zhí)行結束后，應用程序才正式啟動并開始處理請求。如果你打算讓你的任務在應用程序啟動時執(zhí)行，但你又想立即管理進行請求處理，那么可以使用OnApplicationStart(async=true)注釋。然后，你的job將在后臺啟動。警告！當運行于DEV模式時，應用程序將在第一個請求到達時才啟動。此外，在DEV模式時，在需要的時候，應用程序會自動重啟。當運行于PROD模式時，應用程序將和服務器一起同步啟動。預定義任務Scheduled jobs預定義任務由框架周期性執(zhí)行。你可以使用Every注釋要求play在一個特定的周期內運行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表達式的On注釋來運行你的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表達式的。你不能返回結果，即使這樣做了，結果也會被丟棄。觸發(fā)任務job調用Job實例的now()方法可以在任何時候觸發(fā)job來執(zhí)行一段特定的任務。這個時候，job將以非阻塞方式立即執(zhí)行。 public static void encodeVideo(Long videoId) new VideoEncoder(videoId).now(); renderText(Encoding started);調用job的now()方法以返回一個Promise值。停止應用程序 使用OnApplicationStop注釋可以在應用程序關閉時執(zhí)行某些操作。import .*