Web 模組:Web 部署描述子編輯器
小心: Web 3.x Web 專案不需要 web.xml 檔,因為會使用註釋來管理部署資訊。
如果 Web 3.x Web 專案需要 Web 部署描述子,
請用滑鼠右鍵按一下專案,
並選取 。
Web 部署描述子編輯器可協助您針對在 Web 開發環境中建立的模組,指定部署資訊。
此資訊會出現在 web.xml 檔中。
註: 您可以使用 Web 部署描述子來設定部署描述子屬性。
您不能用它來操作 Web 資源內容。
Web 專案的 web.xml 檔提供部署 Web 應用程式模組所需的資訊。從專案建置 WAR 檔時,會用到此資訊。
Web 部署描述子編輯器是動態的,並且包含許多區段,代表部署描述子中的各種內容和設定。

Web 部署描述子編輯器包含下列區段:
- Web 應用程式結構
- 提供 Web 部署描述子內容的精簡摘要,並可讓您新增、移除或變更內容。
- 絕對排序
- 使用絕對排序來強制依一定的順序掃描網頁片段或掃描網頁片段子集。「絕對排序」配置適用於 Web3.x 和更新的版本。
- 環境定義參數
- Servlet 環境定義可定義伺服器如何檢視 Servlet 執行所在的 Web 應用程式。環境定義也可讓 Servlet 存取其可使用的資源。
- Servlet 可以利用環境定義來記錄事件、取得指向資源的 URL 參照,以及設定和儲存環境定義中其他 Servlet 可以使用的屬性。這些內容會針對其環境定義,宣告 Web 應用程式的參數,並且會傳送安裝資訊,例如網站管理員的電子郵件位址,或含有重要資料的系統名稱。
- 資料來源
- 配置資料來源資訊,以提供資料來源給應用程式使用。
- EJB 本端參照
- 建立透過其本端起始位置和本端介面存取之 Enterprise Bean 的參照。
- EJB 參照
- 建立透過其遠端起始位置和遠端介面存取之 Enterprise Bean 的參照。
- 環境變數
- 宣告應用程式的環境項目。
- 錯誤頁面
- 錯誤頁面位置可讓 Servlet 依據指定的錯誤狀態碼或異常狀況類型,來尋找 URI 並提供給用戶端。
- 如果錯誤處理常式是另一個 Servlet 或 JSP 檔,就會使用這些內容。這些內容會指定錯誤碼或異常狀況類型與 Web 應用程式中的資源路徑之間的對映。儲存器會依所定義的順序來檢查清單,並嘗試依狀態碼或依異常狀況類別來比對錯誤狀況。在第一個比對成功的錯誤狀況中,儲存器會傳回 Location 內容中所定義的資源。
- 過濾器
- 定義過濾器類別及其起始設定屬性。
- 建立新的過濾器、將現有的過濾器新增至部署描述子,或是將所選取的過濾器從部署描述子中移除。
- 過濾器對映
- 定義對 URL 型樣或 Servlet 的過濾器對映。
- JSP 配置
- 新增資源集合或標籤庫。
- 接聽器
- 定義應用程式接聽器。
- 語言環境編碼對映清單
- 將語言環境名稱對映至編碼名稱。
- 登入配置
- 配置鑑別使用者的方式。如果已指定登入配置,則使用者必須鑑別,才能存取安全限制參數所限制的資源。
- 訊息目的地
- 指定訊息驅動 Bean 的目的地。
- 訊息目的地參照
- 指定 J2C 受管理物件的「Java™ 命名和目錄介面 (JNDI)」名稱,以將訊息目的地參照連結至訊息驅動 Bean。請將應用程式中的每個訊息目的地參照,對映至受管理物件。
- MIME 對映
- 定義延伸與 MIME 類型之間的對映。
- 持續性環境定義參照
- 指定持續性環境定義的生命期限。
- 持續性單元參照
- 指定 persistence.xml 檔案。
- 後置建構
- 定義相依關係注入起始設定之後所執行的方法。
- 前置毀損
- 定義回呼通知,以告知儲存器正在移除實例。
- 資源環境參照
- 定義 Web 應用程式中,對相關聯之受管理物件的資源參照。
- 資源參照
- 定義查閱對外部資源的參照。
- 安全限制
- 安全限制可決定要如何保護 Web 內容。這些內容會使安全限制與一或多個 Web 資源集合產生關聯。
- 限制是由 Web 資源集合、授權限制和使用者資料限制所組成。
- Web 資源集合是一組資源(URL 型樣)及那些資源上的 HTTP 方法。其中包含的要求路徑符合 Web 資源集合中描述之 URL 型樣的所有要求,皆受制於此限制。如果未指定 HTTP 方法,則安全限制會套用至所有 HTTP 方法。
- 授權限制是一組角色,使用者必須要有這些角色,才能存取 Web 資源集合所描述的資源。如果使用者要求存取所指定的 URI,但沒有授權限制中指定的至少其中一個角色,則會拒絕使用者存取該資源。
- 使用者資料限制指出,用戶端或伺服器通訊程序的傳輸層,必須滿足下列其中一項需求:保證內容完整性(預防在傳輸時竄改)或保證機密性(預防在傳輸時讀取)。
- 安全角色
- 定義安全角色。
- 安全參照
- 定義安全角色對替代角色名稱的參照。
- Servlet
- 建立新的 Servlet、將現有的 Servlet 或 JSP 檔新增至部署描述子,或是將所選取的 Servlet 或 JSP 檔從部署描述子中移除。
- 階段作業配置
- 定義 Web 應用程式的階段作業屬性。
- 歡迎使用檔案清單
- 配置在找不到檔案時,所提供之預設網頁的排序清單。
- 「歡迎使用」檔案是一組相關 HTML 檔案的進入點檔案(例如 index.html)。
- 您可以使用一組局部 URI 來尋找「歡迎使用」檔案。當找不到起始 URI 時,Web 儲存器會使用局部 URI 來尋找有效的檔案。
- 程式碼
- 直接編輯 web.xml 程式碼。
使用「Web 部署描述子」編輯器中的多個標籤頁來編輯 web.xml 檔。指定部署資訊時,編輯器會自動將適當的 XML 標籤加入 web.xml 中。
除了 web.xml 檔中的配置資訊,Web 專案中的其他部署描述子還包含下列資訊:
- 連結資訊
- 應用程式伺服器需要有資訊,才能將應用程式中指定的部署資訊連結至特定實例。 例如,它可以將外部相依關係或資源的邏輯名稱,對映至資源的實際實體 JNDI 名稱。 它也可以將安全角色資訊對映至一組群組或使用者。
- IBM® 連結及延伸資訊(ibm-web-bnd.xml 及 ibm-web-ext.xml 檔)
- 對 Java EE 應用程式、Web 應用程式和 Enterprise Bean 的標準描述子增加的資訊。 延伸讓 Java Platform Enterprise Edition 或舊型(較舊的)系統能夠在現行的 WebSphere® Application Server 環境中運作。 延伸也可以用來指定下列應用程式行為:供應商特定行為、現行規格中未定義的行為,或是預期會包含在未來規格中的行為。
web.xml 檔案可以自動更新,以反映 Web 專案的變更。 例如,當您使用「新建 Servlet」精靈在 Web 專案中建立新的 Servlet 時,精靈會將適當的 Servlet 項目放入 web.xml 檔中。