這兩個介面名字只差一個字,職責卻完全不同:一個描述「這個 Servlet 自己的設定」,一個描述「整個應用程式的環境」。釐清它們,也順便把 Servlet 生命週期與 service 方法的分派邏輯一起理清楚。
ServletConfig 用來描述 Servlet 本身的相關設定資訊,每個 Servlet 各有一份。ServletContext 則描述整個應用程式(在 server.xml 中一個 Context 設定,也就是一個虛擬目錄)的資訊,同一個應用內所有 Servlet 共用同一份。
<servlet>
<servlet-name>XXX</servlet-name>
<servlet-class>Xxx</servlet-class>
<init-param>
<param-name>yyy</param-name>
<param-value>xxx</param-value>
</init-param>
</servlet>
這些參數可透過 this.getServletConfig().getInitParameter("yyy") 取得。
javax.servlet.Servlet 是所有 Servlet 都必須實作的基本介面。GenericServlet 提供了基礎實作,HttpServlet 則繼承自 GenericServlet。由於 GenericServlet 已經實作了 ServletConfig 介面,因此在 HttpServlet 的子類中可以直接呼叫 getInitParameter()、getServletName()、getServletContext() 等方法,不必每次都寫成 this.getServletConfig().getInitParameter()。
javax.servlet.Servlet 介面定義的 init 方法是帶參數的:init(ServletConfig config)。GenericServlet 在實作這個方法、完成基本設定後,會再呼叫無參數的 init() 作為擴充點。因此我們繼承 HttpServlet 時,習慣上重寫的都是無參數版本;此時 ServletConfig 已由父類處理妥當,可以直接使用。
若真要重寫帶參數的版本,記得呼叫 super.init(config),否則父類的初始化不會執行,getServletConfig() 會回傳 null。
service() 是 Servlet 的主要方法,所有請求都交給它執行。HttpServlet 的 service 會依請求方法(GET、POST、PUT、DELETE 等)把請求分派給 doGet、doPost 等對應方法。
因此實務上的規則是:在 HttpServlet 子類中只重寫 doGet/doPost;一旦重寫了 service,doGet 與 doPost 就不會被呼叫。這也是一個常見的除錯陷阱——有人為了「攔所有請求」而重寫 service,之後發現 doPost 裡的邏輯完全不執行。
init(ServletConfig) → 內部再呼叫 init(),僅執行一次service() → 分派到 doGet/doPostdestroy(),僅執行一次因為實例被多執行緒共用,不要在 Servlet 中宣告可變的實例變數來儲存請求狀態,否則會發生執行緒安全的資料錯亂。請求層級的資料應放在方法區域變數或 request 屬性中。