移動(dòng)辦公OA系統(tǒng)的計(jì)劃任務(wù)接口

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

移動(dòng)辦公OA系統(tǒng)的計(jì)劃任務(wù)接口
客戶開(kāi)發(fā)人員可以利用計(jì)劃任務(wù)接口定時(shí)執(zhí)行一段自己定義的操作，比如在兩個(gè)數(shù)據(jù)源之間交換數(shù)據(jù)。
廈門(mén)OA提供兩種計(jì)劃任務(wù)接口
IntervalJob接口，此接口每隔一段時(shí)間執(zhí)行一次（自己定義間隔時(shí)間）
CronJob接口，此接口在指定的時(shí)間點(diǎn)執(zhí)行（自己定義時(shí)間點(diǎn)）
定義計(jì)劃任務(wù)的方法是在泛普OA安裝目錄/WEB-INF/service/schedule.xml中聲明：
<service-point id="job1" interface="think.interfaces.schedule.IntervalJob">
        <invoke-factory>
            <construct class="think.interfaces.schedule.BaseIntervalJob"> 
     <set-service property="ds" service-id="local"/>
     <set property="second" value="60"/>
            </construct>
        </invoke-factory>
</service-point>
上面的聲明定義了一個(gè)名為job1的IntervalJob，該接口中的方法execute()將會(huì)每60秒執(zhí)行一次。同時(shí)把前面定義的local數(shù)據(jù)源注入到了接口中，這樣的話就可以在execute（）中讀寫(xiě)local數(shù)據(jù)源。我們也可以注入兩個(gè)數(shù)據(jù)源到接口中，這樣就可以在兩個(gè)數(shù)據(jù)源之間交換數(shù)據(jù)：
<service-point id="job2" interface="think.interfaces.schedule.IntervalJob">
        <invoke-factory>
            <construct class="think.interfaces.schedule.BaseIntervalJob"> 
     <set-service property="ds" service-id="local"/>
　　　　　　　<set-service property="ds1" service-id="msds"/>
     <set property="second" value="60"/>
            </construct>
        </invoke-factory>
</service-point>
聲明一個(gè)CronJob的方法和IntervalJob類似，在廈門(mén)OA軟件安裝目錄/WEB-INF/service/schedule.xml中聲明：
<service-point id="job3" interface="think.interfaces.schedule.CronJob">
<invoke-factory>
            <construct class="think.interfaces.schedule.BaseCronJob"> 
     <set-service property="ds" service-id="local"/>
　　　　　　　<set-service property="ds1" service-id="msds"/>
     <set property="cronExpr" value="0 44 12 ? * MON-FRI"/>
            </construct>
        </invoke-factory>
 </service-point>
上面的聲明定義了一個(gè)周一到周五12：44執(zhí)行的計(jì)劃任務(wù)。什么時(shí)候執(zhí)行計(jì)劃任務(wù)由cronExpr表達(dá)式?jīng)Q定。一個(gè)cron表達(dá)式有至少6個(gè)有空格分隔的時(shí)間元素，
按順序依次為：
秒（0~59）
分鐘（0~59）
小時(shí)（0~23）
天（月）（0~31，但是你需要考慮你月的天數(shù)）
月（0~11）
天（星期）（1~7 1=SUN 或 SUN，MON，TUE，WED，THU，F(xiàn)RI，SAT）
0 0 10,14,16 * * ? 每天上午10點(diǎn)，下午2點(diǎn)，4點(diǎn)
0 0/30 9-17 * * ?   朝九晚五工作時(shí)間內(nèi)每半小時(shí)
0 0 12 ? * WED 表示每個(gè)星期三中午12點(diǎn)
"0 0 12 * * ?" 每天中午12點(diǎn)觸發(fā)
"0 15 10 ? * *" 每天上午10:15觸發(fā)
"0 15 10 * * ?" 每天上午10:15觸發(fā)
"0 * 14 * * ?" 在每天下午2點(diǎn)到下午2:59期間的每1分鐘觸發(fā)
"0 0/5 14 * * ?" 在每天下午2點(diǎn)到下午2:55期間的每5分鐘觸發(fā)
"0 0/5 14,18 * * " 在每天下午2點(diǎn)到2:55期間和下午6點(diǎn)到6:55期間的每5分鐘觸發(fā)
"0 0-5 14 * * ?" 在每天下午2點(diǎn)到下午2:05期間的每1分鐘觸發(fā)
"0 10,44 14 ? 3 WED" 每年三月的星期三的下午2:10和2:44觸發(fā)
"0 15 10 ? * MON-FRI" 周一至周五的上午10:15觸發(fā)
"0 15 10 15 * ?" 每月15日上午10:15觸發(fā)
"0 15 10 L * ?" 每月最后一日的上午10:15觸發(fā)
"0 15 10 ? * 6L" 每月的最后一個(gè)星期五上午10:15觸發(fā)
"0 15 10 ? * 6#3" 每月的第三個(gè)星期五上午10:15觸發(fā)

有些子表達(dá)式能包含一些范圍或列表
例如：子表達(dá)式（天（星期））可以為 “MON-FRI”，“MON，WED，F(xiàn)RI”，“MON-WED,SAT”
“*”字符代表所有可能的值
因此，“*”在子表達(dá)式（月）里表示每個(gè)月的含義，“*”在子表達(dá)式（天（星期））表示星期的每一天
“/”字符用來(lái)指定數(shù)值的增量
例如：在子表達(dá)式（分鐘）里的“0/15”表示從第0分鐘開(kāi)始，每15分鐘
         在子表達(dá)式（分鐘）里的“3/20”表示從第3分鐘開(kāi)始，每20分鐘（它和“3，23，43”）的含義一樣

“？”字符僅被用于天（月）和天（星期）兩個(gè)子表達(dá)式，表示不指定值
當(dāng)2個(gè)子表達(dá)式其中之一被指定了值以后，為了避免沖突，需要將另一個(gè)子表達(dá)式的值設(shè)為“？”
注意，上文中的think.interfaces.schedule.BaseIntervalJob和think.interfaces.schedule.BaseIntervalJob是OA提供的默認(rèn)接口實(shí)現(xiàn)，它們的execute()是空的，不做任何操作。客戶開(kāi)發(fā)人員如果要使用計(jì)劃任務(wù)接口的話，必需繼承think.interfaces.schedule.BaseIntervalJob或think.interfaces.schedule.BaseIntervalJob，用自己的業(yè)務(wù)邏輯覆蓋它們的execute().
舉個(gè)簡(jiǎn)單的例子，我需要OA系統(tǒng)每隔一小時(shí)統(tǒng)計(jì)一下系統(tǒng)人數(shù)并輸出到控制臺(tái)，步驟如下
編寫(xiě)自己的計(jì)劃任務(wù)實(shí)現(xiàn)
import think.interfaces.schedule.BaseIntervalJob;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
/**
 * IntervalJob示范代碼,集成BaseIntervalJob,用自己的業(yè)務(wù)邏輯覆蓋了execute()方法
 */
public class MyIntervalJob extends BaseIntervalJob {
    public void execute() {
        //從數(shù)據(jù)源中獲取連接
        Connection conn = getDs().getConnection();
        try {
            //通過(guò)jdbc獲取人數(shù)
            PreparedStatement s = conn.prepareStatement("select count(*) as amount from 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) {
            getLog().error(e);
        } finally {
            try {
                //關(guān)閉連接
                conn.close();
            } catch (Exception e) {
                getLog().error(e);
            }
        }
    }
}
在schedule.xml中聲明
<service-point id="job3" interface="think.interfaces.schedule.IntervalJob">
        <invoke-factory>
            <construct class="MyIntervalJob"> 
     <set-service property="ds" service-id="local"/>
     <set property="second" value="3600"/>
            </construct>
        </invoke-factory>
</service-point>
可以用類似的方法實(shí)現(xiàn)自己的cronJob,本文不再贅述。