接口用來用戶在泛普OA辦公軟件ThinkOne系統(tǒng)自由定義一些需要定時(shí)執(zhí)行的操作

申請(qǐng)免費(fèi)試用、咨詢電話：400-8352-114

自定義定時(shí)器
一. 接口說明
該接口用來用戶在泛普OA辦公軟件泛普OA系統(tǒng)系統(tǒng)自由定義一些需要定時(shí)執(zhí)行的操作，它是由Quartz這一個(gè)開源的作業(yè)調(diào)度框架來實(shí)現(xiàn)；
該接口通過配置調(diào)度時(shí)間和自行開發(fā)調(diào)度動(dòng)作來實(shí)現(xiàn)需要定時(shí)執(zhí)行的任務(wù)。
該接口提供了兩種調(diào)度方式
IntervalJob接口，此接口每隔一段時(shí)間執(zhí)行一次(自己定義間隔時(shí)間)
CronJob接口，此接口在指定的時(shí)間點(diǎn)執(zhí)行(自己定義時(shí)間點(diǎn))
在開發(fā)調(diào)度動(dòng)作需要實(shí)現(xiàn)泛普OA辦公軟件泛普OA系統(tǒng)提供的自定義動(dòng)作接口。

二. 實(shí)現(xiàn)方法&步驟
1. 配置調(diào)度文件schedule.xml(該文件位于泛普OA辦公軟件泛普OA系統(tǒng)的WEB-INF/service/目錄下)
<?xml version="1.0" encoding="GBK"?>
<module id="datasource" version="1.0.0">
<service-point id="job1" interface="OA.interfaces.schedule.IntervalJob">
        <invoke-factory>
            <construct class="MyIntervalJob "> 
            <set-service property="ds" service-id="datasource.dt1"/>
               <set property="second" value="60"/>
            </construct>
        </invoke-factory>
</service-point>
<service-point id="job2" interface="OA.interfaces.schedule.CronJob">
        <invoke-factory>
            <construct class="MyCronJob ">
        <set-service property="ds" service-id="datasource.dt2"/>
                <set property="cronExpr" value="0 44 12 ? * MON-FRI"/>
            </construct>
        </invoke-factory>
</service-point>

上文中配置兩個(gè)調(diào)度任務(wù)job1,job2，實(shí)現(xiàn)了兩種調(diào)度策略，其中黑體部分是在配置每個(gè)調(diào)度時(shí)需要改變的內(nèi)容；

注意：每次配置后需要重啟OA服務(wù)方可生效；
2. 屬性說明
 Id：唯一標(biāo)識(shí)該調(diào)度任務(wù)，無其他作用
 service-id：上文定義的自定義數(shù)據(jù)源，如果任務(wù)執(zhí)行的動(dòng)作中需要和數(shù)據(jù)源中的數(shù)據(jù)庫(kù)交付數(shù)據(jù)，需要設(shè)置該屬性
 class：該任務(wù)真正執(zhí)行的操作，其中job1中MyIntervalJob必須繼承OA.interfaces.schedule.IntervalJob，job2中MyCronJob必須繼承OA.interfaces.schedule.CronJob；繼承后需要實(shí)現(xiàn)的方法是其中的execute();
 value：任務(wù)執(zhí)行的頻率，在JOB1中表示沒60秒執(zhí)行一次，在JOB2中表示每周一到周五12：44執(zhí)行(JOB2的執(zhí)行頻率配置方式和一般LINUX操作系統(tǒng)的定時(shí)任務(wù)配置方式一致)
3. 在5.0及以上版本對(duì)于CronJob可以直接在進(jìn)行可視化的配置
通過頂部菜單【設(shè)置中心】【外部接口設(shè)置】【配置計(jì)劃任務(wù)接口】即可進(jìn)入配置界面
 

點(diǎn)擊右鍵【新建】即可創(chuàng)建一個(gè)新的【計(jì)劃任務(wù)】
 
注意：該配置，不需要重啟OA服務(wù)即可生效

4. 可視化配置屬性說明
 計(jì)劃任務(wù)標(biāo)識(shí)，即xml配置中的Id：唯一標(biāo)識(shí)該調(diào)度任務(wù)，無其他作用
 計(jì)劃任務(wù)類，即xml配置中的class：該任務(wù)真正執(zhí)行的操作，MyCronJo必須繼承OA.interfaces.schedule.CronJob；繼承后需要實(shí)現(xiàn)的方法是其中的execute();
 定時(shí)時(shí)間，即xml配置中的value：任務(wù)執(zhí)行的頻率，表示每周一到周五12：44執(zhí)行(執(zhí)行頻率配置方式和一般LINUX操作系統(tǒng)的定時(shí)任務(wù)配置方式一致)

5. 如何實(shí)現(xiàn)任務(wù)執(zhí)行的操作
實(shí)現(xiàn)定時(shí)執(zhí)行的操作，實(shí)際上就是實(shí)現(xiàn)OA.interfaces.schedule.BaseIntervalJob 或者OA.interfaces.schedule.BaseCronJob中的execute()方法
import OA.interfaces.schedule.BaseIntervalJob;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
/**
 * IntervalJob示范代碼,集成BaseIntervalJob,用自己的業(yè)務(wù)邏輯覆蓋了execute()方法,實(shí)際使用中這里可以編寫用戶需要實(shí)現(xiàn)的代碼
 */
public class MyIntervalJob extends BaseIntervalJob {
    public void execute() {
        //從數(shù)據(jù)源中獲取連接
        Connection conn = getDs().getConnection();  //此處是取得上文定義的數(shù)據(jù)源dt1,如果需要操作其他系統(tǒng)的數(shù)據(jù)才需要該定義
        try {
            //通過jdbc獲取人數(shù)
            PreparedStatement s = conn.prepareStatement("select count(*) as amount from hrmresource");  //此時(shí)假設(shè)在數(shù)據(jù)源dt1定義的數(shù)據(jù)庫(kù)中有hrmresource表
            ResultSet rs = s.executeQuery();
            rs.next();
            String amount = rs.getString("amount");
            //輸出到控制臺(tái)
            System.out.println("人數(shù):" + amount);
            //關(guān)閉記錄集
            rs.close();
            //關(guān)閉statement
            s.close();
        } catch (Exception e) {
                   } finally {
            try {
                //關(guān)閉連接
                conn.close();
            } catch (Exception e) {
                           }
        }
    }
}