JSF 入門實戰：從零跑通第一個 HelloWorld

新手視角：為什麼要先跑通例子？

學習 Java 一周後，終於跑通第一個 JSF 程式。網上資料多講原理少給完整可運行步驟，對菜鳥來說，目錄結構、faces-config.xml 作用、文件放置位置等基礎知識若不點破，極易卡關。本文記錄完整搭建過程，助同類新手少走彎路。

環境：MyEclipse 6.0.1

集成常用功能，體驗良好。

步驟 1：建立 Web 專案並添加 JSF 支持

1. 新建 Web Project，命名 EXP_HelloWorld。
2. 右鍵專案 → MyEclipse → Add JSF Capabilities → Finish。

此後專案目錄多出：

• JSF RI 1.1.01 Libraries (含所需 JAR)。
• WebRoot/WEB-INF 下新增三文件：faces-config.xml (JSF 核心配置)、html_basic.tld、jsf_core.tld (標籤庫描述符，免去 JSP 手動引入標籤庫指令)。

步驟 2：解析自動生成的 web.xml

關鍵新增內容：

<context-param>
  <param-name>javax.faces.CONFIG_FILES</param-name>
  <param-value>/WEB-INF/faces-config.xml</param-value>
</context-param>
<servlet>
  <servlet-name>Faces Servlet</servlet-name>
  <servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
  <load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>Faces Servlet</servlet-name>
  <url-pattern>*.faces</url-pattern>
</servlet-mapping>

• CONFIG_FILES 可指定多個配置文件，逗號分隔。
• url-pattern 為 *.faces，意味著訪問 xxx.faces 才會觸發 JSF 解析；可改為 *.jsf。

步驟 3：理解核心文件職責

• faces-config.xml：管理 Managed Bean、導航規則、轉換器/驗證器等。
• web.xml：部署描述符，掛載 FacesServlet。
• .tld 文件：讓 JSP 頁面直接使用 h:、f: 標籤無需聲明。

步驟 4：無工具手工搭建的啟示

對照上述文件，完全可手工創建 JSF 專案，關鍵在於理解每個文件的作用與放置位置。工具只是自動化這些步驟，掌握本質才能舉一反三。

新手建議

1. 先跑通最小可運行例子，建立整體認知。
2. 重點理解 faces-config.xml、web.xml、URL 模式映射。
3. 不要一開始就鑽研生命周期、組件樹等深層原理，用時再查。
4. 善用 IDE 自動生成代碼，逐步過渡到手寫。

JSF 學習曲線雖陡，但跨過「環境搭建」這道坎，後續將順暢許多。