Java Web Servlet 開發總結 (二)：ServletConfig、ServletContext 進階應用與資源存取

前言

承接第一部分，本文深入剖析 ServletConfig (單一 Servlet 配置) 與 ServletContext (全域應用上下文) 的進階用法：初始化參數、屬性共享、請求轉發、資源檔案讀取 (兩種方式)、客戶端快取控制。

ServletConfig：單一 Servlet 初始化參數

web.xml 配置

<servlet>
  <servlet-name>ConfigDemo</servlet-name>
  <servlet-class>com.demo.ConfigDemoServlet</servlet-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>UTF-8</param-value>
  </init-param>
  <init-param>
    <param-name>maxUpload</param-name>
    <param-value>10485760</param-value>
  </init-param>
</servlet>

註解配置 (Servlet 3.0+)

@WebServlet(value = "/config", initParams = {
    @WebInitParam(name = "encoding", value = "UTF-8"),
    @WebInitParam(name = "maxUpload", value = "10485760")
})
public class ConfigDemoServlet extends HttpServlet { ... }

讀取參數

@Override
public void init(ServletConfig config) throws ServletException {
    this.config = config;  // 保存引用
    String encoding = config.getInitParameter("encoding");
    Enumeration<String> names = config.getInitParameterNames();
    while (names.hasMoreElements()) { ... }
}

ServletContext：Web 應用全域上下文

三大核心能力

1. 全域初始化參數：<context-param> → 全 Servlet 可見。
2. 屬性共享 (Context 屬性)：setAttribute/getAttribute/removeAttribute，跨 Servlet 共享資料 (快取、DataSource、配置物件)。
3. 資源存取與轉發：getResourceAsStream、getRealPath、getRequestDispatcher。

全域參數配置與讀取

<context-param>
  <param-name>jdbcUrl</param-name>
  <param-value>jdbc:mysql://localhost:3306/mydb</param-value>
</context-param>

// 讀取
String url = getServletContext().getInitParameter("jdbcUrl");

屬性共享實戰：跨 Servlet 傳遞資料

// Servlet A: 初始化時載入配置放入 Context
public class InitServlet extends HttpServlet {
    @Override public void init() {
        AppConfig cfg = loadConfig();
        getServletContext().setAttribute("appConfig", cfg);
    }
}

// Servlet B: 業務中直接取用
public class BizServlet extends HttpServlet {
    protected void doGet(...) {
        AppConfig cfg = (AppConfig) getServletContext().getAttribute("appConfig");
        // 使用 cfg...
    }
}

請求轉發

// 在 Servlet A 中轉發給 Servlet B
RequestDispatcher rd = getServletContext().getRequestDispatcher("/servlet/B");
rd.forward(req, resp);  // 瀏覽器地址列不變，請求物件同一個

資源檔案讀取：兩種方式對比

ServletContext 讀取範例

// 1. WEB-INF/classes 下
InputStream in = getServletContext().getResourceAsStream("/WEB-INF/classes/db.properties");

// 2. WebRoot 目錄下 (部署後可直接替換)
InputStream in = getServletContext().getResourceAsStream("/config.properties");

// 3. 任意路徑 + getRealPath 取得絕對路徑 (謹慎用，戰場環境可能非爆炸 war)
String path = getServletContext().getRealPath("/WEB-INF/classes/large.dat");
try (InputStream in = new FileInputStream(path)) { ... }

ClassLoader 讀取範例

ClassLoader cl = getClass().getClassLoader();
// classpath 根
InputStream in1 = cl.getResourceAsStream("db.properties");
// 套餐下
InputStream in2 = cl.getResourceAsStream("com/demo/db.properties");
Properties p = new Properties();
p.load(in1);

客戶端快取控制

// 快取 1 天 (86400 秒)
resp.setDateHeader("Expires", System.currentTimeMillis() + 24*3600*1000L);
// 或 HTTP 1.1 Cache-Control
resp.setHeader("Cache-Control", "max-age=86400, public");

適用於靜態資源、不常變動的 JSON/API 回應，減少頻繁請求壓力。

總結

ServletConfig 面向單一 Servlet 配置，ServletContext 面向整個 Web 應用。善用 Context 屬性共享單例資源 (DataSource、配置、快取)、用 getResourceAsStream 讀取部署後可熱替換的配置檔、用 forward 實現伺服器端流程控制，是 Servlet 進階開發的關鍵技能。