EJB 部署描述子編輯器係用來修改 EJB JAR 檔和相關聯的
Java™ 檔。
EJB 部署描述子編輯器是利用代表 EJB 部署描述子中之各種內容和設定的頁面和區段來組織的。另外,編輯器也包括 WebSphere® Application Server 之 EJB 規格連結和延伸所明確相關的區段和頁面。
核心功能通常在編輯器頁面的頂端。如果要查看核心頁面和區段,請將焦點移至編輯器,按 alt-shift-c。
這時會用藍色來強調顯示核心頁面、區段、標頭和標籤,且會保持這個狀態,直到您再按一次 alt-shift-c 為止。
延伸和連結通常是巢狀區段,其位於編輯器頁面的底端。收合區段會將內容隱藏起來,只留下標題資訊。
在過濾每個頁面中的資料和內容上,這非常有用。當您關閉和重新開啟編輯器時,編輯器會記住您收合的區段。
另外,您也可以在每個區段的尾端和開頭拖曳隱藏的邊框來調整區段大小。
編輯器的另一項重要特性是加強的精靈支援。您可以從編輯器開啟各個精靈,它們會帶您逐步建立和修改各種元素。這些精靈會逐步通過建立程序,協助您判斷問題。
如果發生錯誤,或是您輸入了無效的資料,精靈會在精靈頁面的頂端顯示警告或錯誤訊息。精靈提供了一次建立或編輯多個物件的功能,且您可同時處理多個 Bean。
EJB 編輯器會修改下列資源:
- ejb-jar.xml
- ibm-ejb-jar-bnd.xmi
- ibm-ejb-jar-ext.xmi
- ibm-ejb-access-bean.xml
- ws-handler.xmi
- webservicesclient.xml
- ibm-webservicesclient-bnd.xmi
- ibm-webservicesclient-ext.xmi
雖然 EJB 部署描述子編輯器頁面會隨著您啟用的功能()而改變,但 EJB 部署描述子編輯器通常會顯示下列主要標籤頁:
「概觀」頁面
請利用概觀頁面來檢視、建立和修改 EJB 模組的基本內容。
這應該是您尋找編輯器內容的第一個位置。這個頁面的主體是 ejb-jar.xml 檔的使用者介面表示法。ejb-jar.xml 的核心 XML 標示可分解成以下區段:
- 一般資訊
- 您可使用這個區段來新增顯示和說明名稱。這些名稱會用來識別 Web 伺服器和 J2EE 視圖。
- 用法
- 您可使用這個區段來檢視和 EJB JAR 相關聯之編輯器的鏈結清單。比方說,如果 EJB JAR 定義在 EAR 中,EAR 的名稱就會顯示成鏈結。
按一下鏈結會啟動 EAR 部署描述子編輯器。
- Enterprise JavaBeans™
- 您可以使用這個區段來檢視對應於 EJB 中的 Bean 之鏈結清單。按一下鏈結會帶您進入 Bean 頁面並強調顯示 Enterprise Bean。
- 組合描述子
- 這個區段有一個會鏈結至組合頁面的詳細資料按鈕。組合頁面有安全角色、方法許可權、儲存器交易和排除清單的區段和精靈。
- EJB 用戶端 JAR
- 這個區段所顯示的,是針對 EJB 模組所建立的 EJB 用戶端 JAR 檔名稱。如果沒有建立任何 EJB 用戶端 JAR 檔,
則可以按一下建立按鈕,開啟「建立 EJB 用戶端 JAR」精靈來建立 JAR 檔。
- 參照
- 這個區段也有一個詳細資料按鈕,其會鏈結至參照頁面。
- 關係 2.0
- 本區段只適用於 EJB 2.0 模組。關係區段會包含現有關係的清單。
這裡可以執行關係的所有建立和修改動作。
- 圖示
- 請利用這個區段來指派 EJB JAR 的圖示。
這主要是在執行時期用來進行識別。
- WebSphere 延伸
- 只有在專案目標是 WebSphere Application Server 時,才會顯示。
這個區段包含 1.x 關係和繼承等組合。
每個區域都有一個編輯按鈕,可用來啟動精靈以更新所選 Bean 的部署描述子內容。
- WebSphere 連結
- 只有在專案目標是 WebSphere Application Server 時,才會顯示。
EJB 1.1 模組:
- JNDI 預設資料來源連結:
您可以利用這個區段,來指定資料來源 JNDI 名稱、JNDI 使用者 ID 和資料來源密碼。
EJB 2.0 模組:
- 後端系統 ID:您可以利用這個區段,來決定在部署時所載入的 Persister 類別。
- JNDI CMP Factory 連線連結:您可以利用這個區段,來指定 JNDI 名稱儲存器授權類型。您可以選擇儲存器管理的鑑別,或是元件管理的鑑別。
Bean 頁面
請利用 Bean 頁面來建立、修改和移除 Enterprise Bean 中的函數和資源。Bean 頁面的左側會顯示 EJB 專案中的 Bean 清單。
右側有一個可捲動的區段,其中有所選 Bean 的詳細資料。
比方說,如果您選取 EJB 1.x CMP Entity Bean,就只會顯示這個 Bean 類型的相關區段。
Bean 頁面有下列幾個區段:
- 「一般」區段
- 所有的 Enterprise Bean 都有「一般」區段,提供您快速存取共用資訊。這個區段含有顯示名稱、重新進入類型、說明以及 CMP 欄位,供 EJB 1.x CMP Entity Bean 使用。EJB 2.x CMP Entity Bean 也有抽象綱目名稱的欄位。
顯示名稱和說明欄位係供在 J2EE 視圖和 Web 伺服器內的進行識別之用。如果您不要 Bean 在完成現行執行作業之前被存取,您可以使用重新進入欄位。當您建立 EJBQL 陳述式時,會設定和使用抽象綱目名稱。「屬性」區段可讓您建立和移除屬性。
屬性是用來存取資料庫以持續保存和擷取資料的對映欄位。
請按兩下 Bean,以在 Java 編輯器中開啟 Java 程式碼。
- 類別和介面檔
- 適用於 EJB 1.1 和 EJB 2.x Bean。您可使用這個區段來修改和 Bean 相關聯的 Java 資源。比方說,如果您要開啟 Bean Java 類別和新增商業邏輯,您可以按兩下 Bean 類別,或選取表格中的 Bean 類別,再按一下開啟。
這時開啟按鈕會啟動 Java 編輯器,讓您編輯 Enterprise Bean。類別介面區段也使您能夠將 Java
資源,改成其他現有的資源。按一下瀏覽按鈕可存取這個重複使用功能。這時會提示資源瀏覽對話框。您也可以使用移除功能來啟動可協助您刪除資源的精靈。
- 環境變數
- 適用於 EJB 1.1 和 EJB 2.x Bean。您可以在這個區段新增、移除和修改環境變數。
在編輯器中按兩下某個變數,會在「程式碼」視圖中強調顯示適當的元素。
環境變數是您定義在 Web 和 EJB 元件中的常數變數。比方說,如果您定義一個 Circle Bean,您可以建立一個名為 PI 的環境變數,並將值設為 3.1415926。如果有另一個名為 Cone 的 Enterprise Bean 或 Servlet,它可以執行 JNDI 查閱來存取 PI 變數。
- 圖示
- 適用於 EJB 1.1 和 EJB 2.x Bean。「圖示」區段類似於 EJB JAR 區段。
您可使用這個區段來指定 Bean 層次的圖示。這主要是供執行時期識別之用。
- 訊息驅動目的地
- 適用於 EJB 2.x 訊息驅動 Bean。您可以在這個區段,指定訊息驅動 Bean 的目的地類型和訂閱延續性。
- 關係
- 適用於 EJB 2.x CMP Entity Bean。您可以在這個區段,
建立和使用 EJB 2.0 CMP Entity Bean 的關係。
- Access Bean
- 適用於 EJB 1.1 和 EJB 2.x Session Bean 和 Entity Bean。但不適用於訊息驅動 Bean。您可使用這個區段來建立和編輯 Access Bean。Access Bean 是存取 Enterprise Bean 的便利方法。
- 查詢
- 適用於 EJB 2.x CMP Entity Bean。您可使用這個區段來建立 finder 方法,以及將 finder 陳述式指派給這些方法。您也可以移除搜尋器描述子。finder 方法在 Home 介面中。finder 描述子會指派給這些方法。finder 描述子用來查詢資料庫以傳回特定 Bean 實例。您可按一下新增來開啟搜尋器精靈,
該精靈提供的選項可讓您建立或使用現有的 finder 方法。在建立方法之後,精靈可協助您新增描述子資訊。
- WebSphere 連結
- 只有在專案目標是 WebSphere Application Server 時,才會顯示。
適用於 EJB 1.1 和 EJB 2.x Bean。您可以在這個區段,指定 WebSphere Application Server 的連結內容。
資料來源用來在執行時期查閱指出的資料庫。
您必須在伺服器配置中建立資料來源。如果您使用的是 WebSphere Application Server,
您可以使用伺服器工具來進行這個作業。使用者名稱和密碼是在存取資料庫時,供驗證之用。
- WebSphere 延伸
- 只有在專案目標是 WebSphere Application Server 時,才會顯示。
適用於 EJB 1.1 和 EJB 2.x Bean。請利用這個區段來指定 WebSphere Applicatoin Server 所用的其他延伸。您可以根據所選 Bean 的類型和層次,來使用下列區段或欄位:
- 階段作業逾時值
- 如果您所用的是 Session Bean,請在這個區段指定逾時值和活動階段作業類型。
- 關係
- 適用於 EJB 1.1 CMP Entity Bean。您可以在這個區段定義關係。
- 搜尋器
- 適用於 EJB 1.1 CMP Entity Bean。您可使用這個區段來建立 finder 方法,以及將 finder 陳述式指派給這些方法。您也可以移除搜尋器描述子。finder 方法在 Home 介面中。finder 描述子會指派給這些方法。finder 描述子用來查詢資料庫以傳回特定 Bean 實例。您可按一下新增來開啟搜尋器精靈,
該精靈提供的選項可讓您建立或使用現有的 finder 方法。在建立方法之後,精靈可協助您新增描述子資訊。
- Bean 快取
- 您可以在這個區段定義 Bean 快取設定。
- 本端交易 2.0
- 您可以在這個區段定義區域交易設定。
- 語言環境呼叫
- 使用這些設定可以使在 WebSphere Application Server 中執行的 EJB 有最好的效能。
- 資料快取
- 適用於 EJB 2.x CMP Entity Bean。您可以在這個區段,指定快取記憶體的生命期限,以及快取記憶體使用情形的生命期限。
- 並行控制
- 適用於 1.1 CMP Entity Bean。依預設,系統不會啟用樂觀鎖定,這表示如果 Entity Bean 正在存取資料庫中的某一列,另一個 Bean 就無法編輯這一列,直到原來的 Bean 釋放它為止。
如果列已遭到鎖定,但仍試圖編輯,就會擲出異常狀況。
「參照」頁面
請利用「參照」頁面來定義專案之 Enterprise Bean 的參照。這個頁面也會設定參照的 WebSphere 連結,如參照的 JNDI 名稱。請選取一個 Bean,按一下新增來開啟「新增參照」精靈。
請參閱定義 J2EE 模組的參照,以取得詳細資訊。
「參照」頁面的設定和 Bean 頁面類似,其左邊主區段中的選擇會動態變更右邊的「詳細資料」區段。
「WS 處理常式」頁面
請利用「處理常式」頁面,針對已定義給 EJB 模組中之 Enterprise Bean 的每個 Web 服務參照來定義 Web 服務處理常式。請參閱定義 Web 服務處理常式,以取得詳細資訊。
「組合」頁面
請利用這個頁面來定義安全角色、方法許可權和方法交易。它也可以讓您從安全限制中排除方法。「組合」頁面有下列區段:
- 安全角色
- 請利用這個區段來定義安全角色。需要安全角色是為了建置方法許可權。
這個區段會列出所定義的安全角色,且會顯示所選安全角色的詳細資料。
- 方法許可權
- 請利用這個區段,在方法層次上,新增 Bean 的許可權。
這個區段含有一個樹狀結構,它有一份現有方法許可權的清單。
當您建立新的方法許可權時,它就會出現在樹狀結構當中。如果您展開樹狀結構,會顯示方法許可權中所定義的 Bean 和方法。
- 儲存器交易
- 如果要新增儲存器交易,請按一下新增,啟動「儲存器交易」精靈。如果在任何樹狀結構物件被選取的情況下,按一下移除按鈕,則會移除該交易。
- 排除清單
- 如果是 EJB 2.x 模組,請利用這個區段,將方法元素標示為不能被部署描述子呼叫。
「存取」頁面
請利用「存取」頁面來定義 CMP Entity Bean 的存取目的、隔離層次和安全身分內容變數。
存取頁面會依 EJB 專案的 EJB 版本層次而顯示不同的區段,其中包括 WebSphere 延伸。可用的區段包括下列區段:
- 安全身分(Bean 層次)
- 您可以在這個區段新增安全身分。
- Entities 2.x 的預設存取目的(Bean 層次)
- 您可以在這個區段,定義 Bean 層次安全身分的預設存取目的。
- Entities 2.x 的存取目的(方法層次)
- 您可以在這個區段,定義方法層次安全身分的存取目的。
- Entities 1.x 的存取目的
- WebSphere Application Server 延伸。您可以在這個區段,定義 Bean 層次安全身分的預設存取目的。
- 隔離層次
- WebSphere Application Server 延伸。您可以在這個區段,定義 Bean 層次安全身分的預設存取目的。
- 安全身分(方法層次)
- WebSphere Application Server 延伸。您可以在這個區段新增安全身分。
「WS 延伸」頁面
請利用這個頁面來定義 WebSphere Application Server 的 Web 服務用戶端安全延伸。
「WS 連結」頁面
請利用這個頁面來定義 WebSphere Application Server 的 Web 服務用戶端連結。
「程式碼」頁面
請利用「程式碼」頁面來檢視和修改 EJB 模組的部署描述子 (ejb-jar.xml) 所關聯的 XML 程式碼。
「程式碼」頁面是一個 XML 編輯器。當您編輯 EJB 部署描述子編輯器時,會動態變更 XML。
當您變更 XML 程式碼時,EJB 部署描述子編輯器的其他頁面也會反映這些變更。
EJB 部署描述子編輯器中的變更要等到儲存編輯器時才會確定。
如果關閉編輯器,但沒有儲存,變更就不會獲得確定。
這也包括可藉由 EJB 部署描述子編輯器來編輯之 Java
檔以及連結與延伸檔的變更。
如果現有的 Java 編輯器目前已開啟,
且在 EJB 部署描述子編輯器中進行了變更,使程式碼產生到目前開啟的 Java 檔內,
則這些變更就會產生到開啟的編輯器中。如果您儲存了 EJB 部署描述子編輯器,
就會同時儲存 Java 變更。
如果您關閉了 EJB 部署描述子編輯器,但沒有儲存,則除了目前在開啟之 Java 編輯器中的變更之外,所有其他的變更都會遺失。
這些變更仍會保留著,因為有其他參照指向目前在開啟狀態的檔案。只有在沒有其他參照指向 EJB 部署描述子編輯器或它的資源時,系統才會提示您儲存 EJB 部署描述子編輯器。如果有兩個 EJB 部署描述子編輯器開啟在兩個不同的視景中,
或您在一或多個視景中開啟了 EJB 部署描述子編輯器,
變更會同時出現在這兩個編輯器中,且只有在最後一個編輯器關閉時,系統才會提示您儲存變更。