play framework 添加启动任务、定时任务

前人总结了很多东西，真的受益良多，有一个详细的博客在这里，看完立马就明白，我这里只是做一个记录，方便日后查找

http://desert3.iteye.com/blog/1586708

Play framework是一个web应用程序，大部分的应用逻辑都是通过在Controllers中以响应HTTP请求的方式来完成的。 

有时候你可能需要执行一些和HTTP请求无关的应用逻辑。这在处理一些初始化任务、维护任务、不阻塞HTTP请求连接池的耗时任务时非常有用。 

Jobs是完全受Framework管理的。也就是说play框架会为你管理所有数据库连接事宜、JPA entity manager同步、事物管理。 

要创建一个Job，只需要简单地继承play.jobs.Job类就可以。 

Java代码  

1. package jobs;  
2.    
3. import play.jobs.*;  
4.    
5. public class MyJob extends Job {  
6.       
7.     public void doJob() {  
8.         // execute some application logic here ...  
9.     }  
10.       

} 
如果Job需要返回值的话 ，那么覆盖doJobWithResult()方法即可。 

Java代码  

1. package jobs;  
2.    
3. import play.jobs.*;  
4.     
5. public class MyJob extends Job<String> {  
6.       
7.     public String doJobWithResult() {  
8.         // execute some application logic here ...  
9.         return result;  
10.     }  
11.       
12. }  

这里的String只是一个例子，你可以用任何其他类型。 

引导Job（Bootstrap job）：  
Bootstrap jobs是在 play应用程序启动的时候被执行 （注意DEV、PROD模式的区别）。通过@OnApplicationStart注解就可以把一个job标记为bootstrap job。 

Java代码  

1. import play.jobs.*;  
2.    
3. @OnApplicationStart  
4. public class Bootstrap extends Job {  
5.       
6.     public void doJob() {  
7.         if(Page.count() == 0) {  
8.             new Page("root").save();  
9.             Logger.info("The page tree was empty. A root page has been created.");  
10.         }  
11.     }  
12.       
13. }  

对于 Bootstrap jobs不需要返回值，即使你做了，返回值也会丢失 。 
默认情况下，所有被@OnApplicationStart注解标记的 job按顺序执行完成后，应用程序才开始处理进来的HTTP请求 。 
如果你想要在应用程序启动时就开始一个job，同时，你想不等这个job执行完就直接开始处理进来的HTTP请求，你可以如下这样通过给注解增加 async=true 这个参数来达到要求的效果：@OnApplicationStart(async=true)。 
所有@OnApplicationStart(async=true)标记的job 在应用程序启动时会自动启动，并且所有这些异步job是在同一时刻启动的 。 

定时任务：  
定时任务就是play框架根据用户的设置周期性地执行任务。使用 @Every 注解来标记job每隔多久执行一次。 

Java代码  

1. import play.jobs.*;  
2.    
3. @Every("1h")  
4. public class Bootstrap extends Job {  
5.       
6.     public void doJob() {  
7.         List<User> newUsers = User.find("newAccount = true").fetch();  
8.         for(User user : newUsers) {  
9.             Notifier.sayWelcome(user);  
10.         }  
11.     }  
12.       
13. }  

如果@Every不够用的话，也可以使用更加灵活的 @On注解来设置定时任务的时间间隔 。 @On的设置采用的是CRON表达式 。 

Java代码  

1. import play.jobs.*;  
2.    
3. /** Fire at 12pm (noon) every day **/   
4. @On("0 0 12 * * ?")  
5. public class Bootstrap extends Job {  
6.       
7.     public void doJob() {  
8.         Logger.info("Maintenance job ...");  
9.         ...  
10.     }  
11.       
12. }  

在 定时任务时，也不需要返回值，即使你做了，返回值也会丢失 。 

触发task jobs：  
在任何时候，你都可以通过 调用job实例的now()方法来触发job来执行一个特殊的任务 。然后这个job就会 以非阻塞的方式被立即执行 。 

Java代码  

1. public static void encodeVideo(Long videoId) {  
2.     new VideoEncoder(videoId).now();  
3.     renderText("Encoding started");  
4. }  

在job实例上调用now()方法，将会返回一个Promise约定的值。当job完成后， 你可以用Promise来接收job的执行结果 。看怎么做的？？ 

应用程序关闭时执行的任务：  
可以通过@OnApplicationStop注解来声明在应用程序关闭时要执行的job。 

Java代码  

1. import play.jobs.*;  
2. @OnApplicationStop  
3. public class Bootstrap extends Job {  
4. public void doJob() { Fixture.deleteAll(); }  
5. }