編輯和驗證環境定義及相依關係注入專案

您可以使用環境定義和相依關係注入部署描述子編輯器,以編輯和驗證 beans.xml 檔。

開始之前

在工作區中建立 Java™ EE 資料類型的專案(亦即,公用程式、EJB、Web、連接器或應用程式用戶端專案)。如需建立其中一個這些專案的相關資訊,請參閱:使用精靈來建立及配置 Java EE 專案。

關於這項作業

在 CDI 1.0 中,包裝及部署已啟用 CDI 的專案時需要 beans.xml 檔。 存在 beans.xml 檔就是向儲存器表示已部署的模組是 Bean 保存檔。安裝 CDI 資料類型時會產生部署描述子。 請參閱建立使用環境定義和相依關係注入 (CDI) 的應用程式。beans.xml 檔最初是空的,這表示模組中存在的任何標註攔截程式、裝飾字元或替代方案都停用。 如果要啟用這些類別,您可以使用 CDI 部署描述子輯器來配置它們。

從 CDI 1.2 開始,在包裝和部署已啟用 CDI 的專案時,beans.xml 為選用的檔案。 新增 CDI 1.2 資料類型時不會建立此檔案。您可以用滑鼠右鍵按一下專案,然後從功能表中選取 Java EE 工具 > 產生 CDI Bean 部署描述子 Stub,以產生此檔案。

程序

  1. 如果要開啟環境定義和相依關係注入部署描述子編輯器,請按兩下 beans.xml 檔。
  2. 按一下新增,將替代方案、裝飾字元及攔截程式新增至 beans.xml 檔。

    從 CDI 1.2 開始,您也可以按一下新增來指定 scan,用來設定排除過濾器。排除過濾器可避免將類別探索為 Bean。

  3. 在 CDI 1.2 編輯器中,使用下列 bean-discovery-mode 值來指定如何掃描 Bean 保存檔:all、annotated 或 none。

    在下列情況中,CDI 部署描述子編輯器會發出驗證錯誤:

    • 如果替代方案類別、裝飾字元類別或攔截程式類別是空的。
    • 如果替代方案類別、裝飾字元類別或攔截程式類別不存在。
    • 如果替代方案類別、裝飾字元類別或攔截程式類別重複。
    • 如果類別沒有適當的 @Alternative、@Interceptor 或 @Decorator 註釋。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tcdideploymentdescriptoreditor.html