play框架使用起来(11)

Job

 由于Play是Web应用框架,所以大部分的应用逻辑是由响应HTTP请求的控制器来完成的。但是有时候我们需要在HTTP请求之外执行一些应用逻辑操作,比如初始化工作,维护任务或者在不阻塞HTTP请求执行池的情况下运行一些时间花费较长的任务。这时就可以利用Play提供的Job来满足这些需求。

      Job完全由框架管理,这意味着Play会管理所有的数据库连接,JPA实体管理器的同步以及事务

补充:

Job就是需要在指定的时刻或者时间段内执行的任务,通常由作业调度程序来执行调度和管理。


1、实现

 在Play中建立Job只需要继承play.jobs.Job类:

package jobs;
 
import play.jobs.*;
 
public class MyJob extends Job {
   
   
public void doJob() {
       
// 执行一些业务逻辑
   
}
}

      如果希望创建具有返回值的Job,那么需要覆盖doJobWithResult()方法:

package jobs;
 
import play.jobs.*;
 
public class MyJob extends Job<String> {
   
   
public String doJobWithResult() {
       
// 执行一些业务逻辑
       
return result;
   
}
   
}

      上例自定义的Job覆盖了doJobWithResult()方法,并且方法的返回类型为String,事实上Job可以返回任何类型的值。



 2、Bootstrap 

2.1 应用启动#

      Bootstrap Job,顾名思义就是在应用开始时运行的任务,只需要添加@OnApplicationStart注解就可以把当前Job设置为Bootstrap Job:

import play.jobs.*;
 
@OnApplicationStart
public class Bootstrap extends Job {
   
   
public void doJob() {
       
if(Page.count() == 0) {
           
new Page("root").save();
           
Logger.info("A root page has been created.");
       
}
   
}
   
}
      需要注意的是,Bootstrap Job不需要任何返回值。如果有多个带有@OnApplicationStart注解的Bootstrap Job,那么默认情况下这些Job会按照定义的先后顺序执行。当所有的Bootstrap Job执行完成之后,Web应用就处于等待阶段,等待处理那些即将到来的请求。

      如果希望Web应用启动后,能够在执行Bootstrap Job的同时,又能很快地处理到来的请求,可以为@OnApplicationStart注解添加async=true属性:@OnApplicationStart(async=true)。这样应用程序开启后,Bootstrap Job就会作为后台程序异步执行了。不仅如此,所有的异步Job(async=true)也会在Web应用开启之后同时运行。


注意:

Play具有两种不同的工作模式:开发模式(DEV)和产品模式(PROD),因此Job的启动时间也有略微差异。在DEV模式下,直到第一个HTTP请求到达时才会开启应用,且不会预先编译Java文件。如果在该模式下更改Java源文件可以立即生效,刷新浏览器即可查看修改后的结果。此外,应用还会在需要的时候自动重启;而在PROD模式下,应用会在服务器启动时同步开启,一旦应用开启就会自动编译所有的Java文件,之后不再重载任何文件(包括模板文件和配置文件),所以如果有文件修改必须重启应用才能生效。所以DEV模式下Job会延迟启动。

2.2 应用停止#

      Web应用停止或关闭的时候,常常也需要进行一些额外的操作,如进行数据的清理、日志的打印等。如果开发者需要这类任务调度操作,可以使用Play提供的@OnApplicationStop注解。

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

      用法非常简单,继承Job类之后,重写doJob()方法即可。


3、Scheduled Job 


  Scheduled Job是指可以被框架周期性执行的任务,可以使用@Every注解指定时间间隔控制Scheduled Job运行,例如:

import play.jobs.*;
 
@Every("1h")
public class Bootstrap extends Job {
   
   
public void doJob() {
       
List<User> newUsers = User.find("newAccount = true").fetch();
       
for(User user : newUsers) {
           
Notifier.sayWelcome(user);
       
}
   
}
   
}
      在实际开发中,@Every注解并不能够完全满足开发需求,比如有时候需要指定Scheduled Job在具体的某个时间点执行。这时候可以使用@On注解指定时间点来执行Job,例如:
import play.jobs.*;
 
/** Fire at 12pm (noon) every day **/
@On("0 0 12 * * ?")
public class Bootstrap extends Job {
   
   
public void doJob() {
       
Logger.info("Maintenance job ...");
       
...
   
}
   
}

      与Bootstrap Job一样,Scheduled Job也是不需要任何返回值的,即使返回了也会丢失。


补充:

@On标签中使用的是Quartz库的CRON表达式。CRON表达式是由7个子表达式组成的字符串,每个子表达式都描述了单独的日程细节。这些子表达式用空格分隔,分别表示:

  • Seconds 秒
  • Minutes 分钟
  • Hours 小时
  • Day-of-Month 一个月中的某一天
  • Month 月
  • Day-of-Week 一周中的某一天
  • Year 年(可选)

具体CRON表达式的例子:"0 0 12 ? * WED",表示“每周三的中午12:00”。



4、Job的直接调用


 Play的Job除了被框架自动调用外,也可以通过now()方法手动调用Job对象的实例,随时触发Job来执行指定任务。使用now()方法调用Job后,任务会立即执行:

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

      now()方法的返回值是Promise对象,通过该值可以在结束后获得Job的执行结果。


Job的价值就体现在能够无缝集成到Play应用当中,从而进一步提高了开发效率。Play针对不同的需求提供了各种形式的Job:Bootstrap Job在应用开始时执行;Scheduled Job会被框架周期性执行,本章最后还提到了如何直接在业务程序中调用Job。

Bootstrap 
Scheduled Job
MVC应用程序模型 - 7 - app/controllers - 8 - app/models - 8 - app/views - 8 - 请求生命周期 - 8 - 标准应用程序布局layout - 9 - app目录 - 9 - public目录 - 10 - conf目录 - 10 - lib目录 - 11 - 开发生命周期 - 11 - 连接到java调试器 - 12 - 类增强Enhancement - 13 - 02.HTTP路由 - 13 - 关于REST - 14 - routes文件语法 - 14 - HTTP方法 - 15 - URI范示 Pattern - 15 - Java调用定义 - 17 - 把404当作action来用 - 17 - 指派静态参数 - 17 - 变量和脚本 - 18 - 路由优先级 - 18 - 服务器静态资源 - 18 - staticDir: mapping - 18 - staticFile: mapping - 19 - URL 编码 - 19 - 反转路由:用于生成某些URL - 19 - 设置内容风格(CSS) - 20 - HTTP 内容协商 negotiation - 21 - 从http headers开始设置内容类型 - 21 - 定制格式 - 22 - 03.控制器 - 23 - 控制器概览 - 23 - 获取http参数 - 24 - 使用params map - 25 - 还可以从action方法签名实现转换 - 25 - 高级HTTP Java绑定 - 26 - 简单类型 - 26 - Date类型 - 26 - Calendar日历 - 27 - File - 27 - 支持类型的数组或集合 - 28 - POJO对象绑定 - 29 - JPA 对象绑定 - 30 - 定制绑定 - 30 - @play.data.binding.As - 30 - @play.data.binding.NoBinding - 31 - play.data.binding.TypeBinder - 31 - @play.data.binding.Global - 32 - 结果类型 - 32 - 返回一些文本类型的内容 - 33 - 返回一个JSON字符串 - 33 - 返回一个XML字符串F - 34 - 返回二进制内容 - 34 - 作为附件下载文件 - 34 - 执行一个模板 - 35 - 跳转到其他URL - 36 - Action链 - 36 - 定制web编码 - 37 - 拦截器 - 38 - @Before - 38 - @After - 39 - @Catch - 40 - @Finally - 41 - 控制器继承 - 42 - 使用@With注释添加更多的拦截器 - 42 - Because Java does not allow multiple inheritance, it can be very limiting to rely on the Controller hierarchy to apply interceptors. But you can define some interceptors in a totally different class, and link them with any controller using the @With annotation.由于java不允许多继承,通过控制器继承特点来应用拦截器就受到极大的限制。但是我们可以在一个完全不同的类里定义一些拦截器,然后在任何控制器里使用@With注释来链接他们。 - 42 - Session和Flash作用域 - 42 - 04.模板引擎 - 43 - 模板语法 - 43 - Expressions: ${…} - 44 - Template decorators : #{extends /} and #{doLayout /} - 44 - Tags: #{tagName /} - 45 - Actions: @{…} or @@{…} - 46 - Messages: &{…} - 46 - Comment: *{…}* - 46 - Scripts: %{…}% - 46 - Template inheritance继承 - 47 - 定制模板标签 - 48 - 检索tag参数 - 48 - 调用标签体 - 48 - 格式化特定标签 - 49 - 定制java标签 - 49 - 标签命名空间 - 50 - 在模板里的Java对象扩展 - 51 - 创建定制扩展 - 52 - 模板里可以使用的保留对象 - 52 - 05.用play验证http数据
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值