Java Web 應用中實現定時任務的輕量級方案

簡介

在 Web 應用中需定期執行任務 (如資料庫備份、報表生成)，除引入 Quartz 等重型框架外，Java 內建 Timer 與 TimerTask 配合 ServletContextListener 即可輕鬆實現，零依賴、部署簡單。

實作步驟

1. 建立任務管理類實作 ServletContextListener

public class TaskManager implements ServletContextListener {
    public static final long PERIOD_DAY = 24 * 60 * 60 * 1000L;
    public static final long PERIOD_WEEK = PERIOD_DAY * 7;
    public static final long NO_DELAY = 0;

    private Timer timer;

    public void contextInitialized(ServletContextEvent event) {
        timer = new Timer("資料庫表備份", true); // daemon thread
        // 每 4 週 (約一個月) 執行一次
        timer.schedule(new BackUpTableTask(), NO_DELAY, PERIOD_WEEK * 4);
        // 測試用：每 30 秒執行
        // timer.schedule(new BackUpTableTask(), NO_DELAY, 30000);
    }

    public void contextDestroyed(ServletContextEvent event) {
        timer.cancel(); // 銷毀定時器
    }
}

2. 建立具體任務類繼承 TimerTask

public class BackUpTableTask extends TimerTask {
    private static final Log log = LogFactory.getLog(BackUpTableTask.class);
    private static boolean isRunning = false;

    public void run() {
        if (!isRunning) {
            isRunning = true;
            log.debug("開始執行任務...");
            // TODO: 實際業務邏輯 (備份、清理等)
            log.debug("執行任務完成...");
            isRunning = false;
        } else {
            log.debug("上一次任務執行尚未結束...");
        }
    }
}

isRunning 旗標防止任務重疊執行，確保同一時間僅有一個實例運行。

3. 在 web.xml 註冊監聽器

<listener>
    <listener-class>com.example.TaskManager</listener-class>
    <description>定期執行的備份任務</description>
</listener>

運作原理

• Web 容器啟動 → 呼叫 contextInitialized → 建立 Timer 並排程任務
• Timer 依指定間隔在背景執行緒執行 TimerTask.run()
• Web 容器關閉 → 呼叫 contextDestroyed → 取消 Timer，優雅關閉

優缺點與適用場景

適用於：單機部署、簡單週期性任務、不需高可用性排程的中小型專案。若需叢集、持久化、彈性排程表達式 (Cron)、監控管理，請改用 Quartz 或 Spring Task。