Servlet 3.0 新特性深度解析 (二)：@WebServlet、@WebInitParam 與 @WebFilter 完整屬性表

metadata-complete 控制掃描開關

<web-app metadata-complete="true">：僅依賴 web.xml，**忽略所有註解與 web-fragment.xml** (關閉可插性)。預設 false 即啟用註解掃描。

@WebServlet 完整屬性

完整範例

@WebServlet(
    urlPatterns={"/simple"},
    asyncSupported=true,
    loadOnStartup=-1,
    name="SimpleServlet",
    displayName="ss",
    initParams={@WebInitParam(name="username", value="tom")}
)
public class SimpleServlet extends HttpServlet { ... }

等效 web.xml 見上文。

@WebInitParam

配合 @WebServlet 或 @WebFilter 使用，屬性：name (必填)、value (必填)、description (選填)。

@WebFilter 完整屬性

屬性同前表，額外強調：value、urlPatterns、servletNames **三者至少一個**，且 value/urlPatterns 不可共存。