使用Quartz框架定时发送预警邮件

1.  Quartz定时发送预警邮件

1.1.   需求及实现思路

定时查询库存预警信息，一旦存在库存预警的商品，则发邮件通知相关人员

1.2.   Quartz框架

Quartz是OpenSymphony开源组织在Job scheduling领域又一个开源项目，它完全由 Java 写成，并设计用于 J2SE 和 J2EE 应用中。Quartz可以用来创建简单或为运行十个，百个，甚至是好几万个Jobs这样复杂的程序。它提供了巨大的灵活性而不牺牲简单性。你能够用它来为执行一个作业而创建简单的或复杂的调度。

1)        Job

表示一个任务（工作），要执行的具体内容。

2)        JobDetail

JobDetail 表示一个具体的可执行的调度程序，Job 是这个可执行程调度程序所要    执行的内容，另外JobDetail 还包含了这个任务调度的方案和策略。

告诉调度容器，将来执行哪个类(job)的哪个方法

3)        Trigger 是一个类，代表一个调度参数的配置，描述触发Job执行的时间触发规则。一个Job可以对应多个Trigger，但一个Trigger只能对应一个Job

4)        Scheduler 代表一个调度容器，一个调度容器中可以注册多个 JobDetail 和Trigger。 Scheduler可以将Trigger绑定到某一JobDetail中，这样当Trigger触发时，对应的Job就被执行。

Note: 当JobDetail和Trigger在scheduler容器上注册后，形成了装配好的作业（JobDetail和Trigger所组成的一对儿），就可以伴随容器启动而调度执行了。

1.3.   入门Demo

1.3.1. 创建Demo工程，加入依赖

添加依赖:

1.3.2. 编写任务类

创建JobTest类，代码如下

1.3.3. 配置文件

添加applicationContext-job.xml文件

1.3.4. 测试

创建测试类QuartzTest，注：不能使用junit做测试，因为一运行完，程序就结束了。

测试结果:

1.4.   表达式cron详解

Cron 表达式是一个字符串，字符串以 5 或 6 个空格隔开，分为 6 或 7 个域，每一个域代表一个含义。也叫七子表达式。

1.4.1.     域

1)        Seconds（秒）：可出现",- * /"四个字符，有效范围为 0-59 的整数

2)        Minutes（分钟）：可出现",- * /"四个字符，有效范围为 0-59 的整数

3)        Hours（小时）:可出现", -* /"四个字符，有效范围为 0-23 的整数

4)        DayofMonth（日 of 月）:可出现", -* / ? LW C"八个字符，有效范围为 1-31 的整数

5)        Month（月）:可出现", -* /"四个字符，有效范围为 1-12 的整数

6)        DayofWeek（日 of 星期）:可出现", -* / ? L C #"八个字符，有效范围为 1-7 的整数

1 表示星期天，2 表示星期一，依次类推

7)        Year（年）:可出现", -* /"四个字符，有效范围为 1970-2099 年

1.4.2.     字符含义

1)         * 表示匹配该域的任意值，假如在 Minutes 域使用*, 即表示每分钟都会触发事件。

2)         ? 表示不指定值。只能用在 DayofMonth和 DayofWeek 两个域。因为DayofMonth 和 DayofWeek 会相互影响。例如想在每月的 20 日触发调度，不管20 日到底是星期几，则只能使用如下写法： 13 13 15 20 * ?, 其中最后一位只能用？，而不能使用*，如果使用*表示不管星期几都会触发。

3)         - 表示范围，例如在 Minutes 域使用 5-20，表示从 5 分到 20 分钟每分钟触发一次

4)         / 表示起始时间开始触发，然后每隔固定时间触发一次，例如在 Minutes 域使用 5/20,则意味着 5 分钟触发一次，而 25，45 等分别触发一次

5)         , 表示列出枚举值值。例如：在 Minutes 域使用 5,20，则意味着在 5 和 20 分每分钟触发一次。

6)        L 表示最后，只能出现在 DayofMonth 和 DayofWeek 域。如果在 DayofMonth写 L 表示这个月的最后一天，如果在 DayofWeek 写 L 表示每个星期的最后一天（星期六）。如果在 DayofWeek 域使用 5L,意味着在最后的一个星期四触发。

7)        W 表示最近有效工作日(周一到周五),只能出现在 DayofMonth 域，系统将在离指定日期的最近的有效工作日触发事件。例如：在 DayofMonth 使用 5W，如果 5 日是星期六，则将在最近的工作日：星期五，即 4 日触发。如果 5 日是星期天，则在 6 日(周一)触发；如果 5 日在星期一到星期五中的一天，则就在 5 日触发。另外一点，W 的最近寻找不会跨过月份

8)        LW:这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五

9)        #:用于确定每个月第几个星期几，只能出现在 DayofWeek 域。例如在 4#2，表示某月的第二个星期三。

1.4.3.     示例

"0 0 12 * * ?" 每天中午 12 点触发

"0 15 10 ? * *" 每天上午 10:15 触发

"0 15 10 * * ?" 每天上午 10:15 触发

"0 15 10 * * ? *" 每天上午 10:15 触发

"0 15 10 * * ? 2005" 2005 年的每天上午 10:15 触发

"0 * 14 * * ?" 在每天下午 2 点到下午 2:59 期间的每 1 分钟触发

"0 0/5 14 * * ?" 在每天下午 2 点到下午 2:55 期间的每 5 分钟触发

"0 0/5 14,18 * * ?" 在每天下午 2 点到 2:55 期间和下午 6 点到 6:55 期间的每 5 分钟触发

"0 0-5 14 * * ?" 在每天下午 2 点到下午 2:05 期间的每 1 分钟触发

"0 10,44 14 ? 3 4" 每年三月的星期三的下午2:10 和 2:44 触发

"0 15 10 ? * MON-FRI" 周一至周五的上午10:15 触发

"0 15 10 15 * ?" 每月 15 日上午 10:15 触发

"0 15 10 L * ?" 每月最后一日的上午 10:15 触发

"0 15 10 ? * 6L" 每月的最后一个星期五上午10:15 触发

"0 15 10 ? * 6L 2002-2005" 2002 年至 2005 年的每月的最后一个星期五上午 10:15触发

"0 15 10 ? * 6#3" 每月的第三个星期五上午10:15 触发

0 0 8 ? 5 1#2 母亲节

http://cron.qqe2.com/

1.5.   代码实现

1.5.1. 添加quartz依赖

打开父工程的pom.xml，添加quartz依赖：

1.5.2. 创建任务类

在业务逻辑层中新建MailJob类，包名为cn.andco.erp.job

package cn.andco.erp.job;

import java.text.DateFormat;

import java.text.SimpleDateFormat;

import java.util.Date;

import java.util.List;

import cn.andco.erp.biz.IStoredetailBiz;

import cn.andco.erp.entity.Storealert;

import cn.andco.erp.util.MailUtil;

/**

* 发邮件的任务

*/

public class MailJob {

private IStoredetailBizstoredetailBiz;

private MailUtilmailUtil;//邮件工具

private Stringto;//收件人

private Stringsubject;//邮件标题

private Stringtext;//邮件内容

/**

* 发送预警邮件任务的方法

*/

public void doJob(){

//获取预警的库存列表

List<Storealert> list =storedetailBiz.getStorealertList();

if(null !=list &&list.size() > 0){

DateFormat df = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss");

try {

//发送邮件

mailUtil.sendMail(to,subject.replace("[time]",df.format(new Date())),

text.replace("[count]",list.size() +""));

System.out.println("邮件发送成功!");

} catch (Exceptione) {

e.printStackTrace();

}

}

}

public void setStoredetailBiz(IStoredetailBiz storedetailBiz) {

this.storedetailBiz =storedetailBiz;

}

public void setMailUtil(MailUtil mailUtil) {

this.mailUtil =mailUtil;

}

public void setTo(String to) {

this.to =to;

}

public void setSubject(String subject) {

this.subject =subject;

}

public void setText(String text) {

this.text =text;

}

}

1.5.3. 配置文件

创建applicationContext_job.xml

<?xmlversion="1.0"encoding="UTF-8"?>

<beansxmlns="http://www.springframework.org/schema/beans"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="

         http://www.springframework.org/schema/beans

         http://www.springframework.org/schema/beans/spring-beans.xsd">

<!-- 定义一个任务类 -->

<beanid="mailJob"class="cn.andco.erp.job.MailJob">

<propertyname="mailUtil"ref="mailUtil"></property>

<propertyname="storedetailBiz"ref="storedetailBiz"></property>

<propertyname="to"value="erik2010163@163.com"></property>

<propertyname="subject"value="【Auto-Mail】库存预警_时间:[time]"></property>

<propertyname="text"value="亲!有[count]种商品已经库存不足，请登陆ERP系统查看"></property>

</bean>

<!-- 任务类描述 -->

<beanid="jobDetail"class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">

<propertyname="targetObject"ref="mailJob"></property>

<propertyname="targetMethod"value="doJob"></property>

<!-- 去掉并发执行 -->

<propertyname="concurrent"value="false"/>

</bean>

<!-- 触发器  -->

<beanid="jobTrigger"class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">

<propertyname="jobDetail"ref="jobDetail"></property>

<!-- 七子表达式: -->

<propertyname="cronExpression"value="0/30 * * * * ? *"></property>

</bean>

<!-- 任务调度管理容器 -->

<beanid="scheduler"class="org.springframework.scheduling.quartz.SchedulerFactoryBean">

<propertyname="triggers">

<list>

<refbean="jobTrigger"/>

</list>

</property>

<!-- 跳过 新版本的检查 -->

<propertyname="quartzProperties">

<props>

<propkey="org.quartz.scheduler.skipUpdateCheck">true</prop>

</props>

</property>

</bean>

</beans>