您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> J2EE

JSF 2 打造可重用 Ajax 組件實戰（八）：Eclipse 專案配置與目錄結構

編輯：J2EE

前言：標準化專案結構 — 讓組件代碼「跑起來」

本文演示如何在 Eclipse 中創建 Dynamic Web Project，配置目標運行時、模塊版本、內容目錄、源碼目錄，並展示最終專案結構，為後續部署運行奠基。

1. 創建 Dynamic Web Project

File → New → Dynamic Web Project
Project name: `autoComplete`
Project contents：取消 "Use default"，Browse 選擇源碼根目錄 `autoComplete` (包含 `src/java`、`web` 等)
Target Runtime: GlassFish v3 Java EE 6
Dynamic Web Module version: 2.5 (或 3.0)
Configuration: Default Configuration for GlassFish v3 Java EE 6
EAR Membership: 取消勾選
Next

專案配置步驟1

2. Web 模塊設置

Context root: `autoComplete`
Content directory: `web` (存放 Facelet、JS、CSS、resources)
Java source directory: `src/java`
取消 "Generate web.xml deployment descriptor" (JSF 2.0 / Servlet 3.0 可選)
Finish

專案配置步驟2

3. 最終專案結構 (Project Explorer 視圖)

autoComplete
├─ Deployment Descriptor: autoComplete
├─ Java Resources
│  └─ src/java
│     └─ com.corejsf
│        ├─ AutocompleteListener.java
│        ├─ AutoComplete.java
│        └─ User.java
├─ JavaScript Resources
├─ build
├─ WebContent (或 web)
│  ├─ META-INF
│  ├─ resources
│  │  └─ util
│  │     └─ autoComplete.xhtml   <-- 復合組件定義
│  ├─ WEB-INF
│  │  ├─ faces-config.xml (可選)
│  │  └─ lib (第三方 JAR)
│  ├─ index.xhtml                <-- 演示頁面
│  └─ template.xhtml (可選)
└─ .settings / .project / .classpath

專案結構

4. 關鍵目錄約定說明

目錄/文件	用途	備註
`web/resources/util/autoComplete.xhtml`	復合組件定義 (cc:interface + cc:implementation)	命名空間 `xmlns:cc="https://java.sun.com/jsf/composite"`，資源庫 `util` 對應標籤前綴 ``
`src/java/com/corejsf/AutocompleteListener.java`	Ajax 監聽器 (SessionScoped CDI Bean)	處理 `valueChangeEvent` (輸入框) 和 `completionItemSelected` (列表選擇)
`src/java/com/corejsf/AutoComplete.java`	應用級 Bean (ApplicationScoped)，提供完成項數據 `getCountries()`	模擬數據源，實際可注入 Service/JPA Repository
`src/java/com/corejsf/User.java`	會話級 Bean (SessionScoped)，綁定輸入框值 `country`	模擬表單數據模型
`web/index.xhtml`	演示頁面，引用 ``	展示組件使用方式
`web/resources/` 下的 JS/CSS	JSF 2 標準資源庫機制	`` 自動載入