開發 Java Web 專案時,我們修改 JSP 後存檔,重新整理頁面就能看到最新結果,不必手動重新編譯——這背後正是 Tomcat 中 Jasper 引擎的自動檢測機制在運作。本文帶你拆解它的運作原理與實作細節。
整體而言,Jasper 的自動檢測原理並不複雜:它靠一個背景執行緒不斷比對 JSP 原始檔與編譯後 class 檔的最後修改時間,若兩者一致就視為沒有變動,否則重新編譯。不過實際情況更複雜些,因為 Tomcat 上部署的專案,其 JSP 可能引入了其他頁面或 jar 包,而這些資源甚至可能位於遠端,因此還得額外遍歷檢查這些被引入的資源是否有改動。

上圖是個形象的示意。Tomcat 架構有四個層級的容器:Engine、Host、Context 與 Wrapper,而 JSP 編譯對應在 Wrapper 層級,因此由 StandardWrapper 不斷執行任務去呼叫 Jasper,Jasper 則持續檢測校驗本地與遠端的各種資源,一旦發現需要重新編譯就動手處理。以下看具體實作。
一、背景執行緒
Tomcat 中有一條專門處理各容器背景任務的執行緒。想在某個容器中執行背景任務,只要重寫 backgroundProcess 方法即可。由於 JspServlet 對應 Wrapper 層級,因此在 StandardWrapper 中重寫 backgroundProcess,它會去呼叫實作了 PeriodicEventListener 介面的 Servlet,而 JspServlet 正好實作了這個介面。該介面只有一個 periodicEvent 方法,具體的檢測邏輯就在其中實作。
二、判斷是否需要重新編譯的依據
重新編譯就是把 JSP 再變成 Java、再變成 class,觸發條件是「某個 JSP 或其引入的資源被修改」。因此最合適的判斷依據就是最後修改時間 lastmodified 屬性。正常流程是 JSP 編譯後產生 class,並把 class 的 lastmodified 設成 JSP 的 lastmodified,此時兩者相同;當我們修改 JSP 並存檔後,JSP 的 lastmodified 被更新為當前時間,比對兩者不同即可判定需要重新編譯,編譯完成後兩者又再度被設為一致。至於被引入的資源,則在記憶體中維護上次編譯時各自的 lastmodified,不斷比對即可判斷是否變動。
三、本地與遠端資源的檢測
對本地資源而言,用 java.io.File 類就能方便地讀取 JSP 或其他檔案的 lastmodified。對遠端資源(例如 jar 包),則可用 java.net.URL 操作,它支援 jar、file、ftp 等多種協議,使用相當便利:
URL includeUrl = new URL("jar:https://hostname/third.jar!/"); URLConnection iuc = includeUrl.openConnection(); long includeLastModified = ((JarURLConnection) iuc).getJarEntry().getTime();
三步即可完成對遠端 jar 包最後修改時間的讀取。URL 同樣支援本地檔案,因此是很好的資源讀取抽象物件,Tomcat 對引入資源的管理也都以 URL 作為操作對象。
了解 Jasper 的自動檢測機制後,就能明白我們日常「存檔即生效」的便利從何而來——Tomcat 透過 Jasper 定時幫我們完成檢測與編譯,讓開發體驗更順暢。