對於包含 Web 服務參照的 J2EE 1.3 和 1.4 模組而言,您可以利用部署描述子編輯器來定義和配置每個 Web 服務參照的 Web 服務處理常式。處理常式可讓您處理 Web 服務遠端呼叫的 SOAP 訊息標頭資料傳輸。SOAP 標頭是 SOAP 規格所定義的。處理常式則是 JAX-RPC 和 Web Services for J2EE 規格所定義的。
當您定義 Web 服務參照的處理常式時,會將 handler 元素新增至相關的服務參照(service-ref 元素)中。如果是 J2EE 1.3,service-ref 元素在 webservicesclient.xml 檔中。如果是 J2EE 1.4,它是在部署描述子中。
如果要定義 Web 服務參照的 Web 服務處理常式,請執行下列動作:
- 在 J2EE 視景的專案瀏覽器中,展開專案樹,選取您要在其中定義 Web 服務處理常式的專案之部署描述子節點。 您可以在 EJB 專案、應用程式用戶端專案和動態 Web 專案中,定義 Web 服務參照的 Web 服務處理常式。
- 用滑鼠右鍵按一下部署描述子節點,從蹦現功能表中,選取。 這時會開啟您的模組類型的適當部署描述子。
比方說,在 EJB 部署描述子編輯器中開啟 EJB 模組。
- 按一下 WS 處理常式標籤來移至部署描述子編輯器的「處理常式」頁面。
- 在服務參照下拉清單中,選取要定義處理常式的 Web 服務參照。
- 按一下新增來開啟「新建處理常式」對話框和定義處理常式:
- 請在顯示名稱欄位中,輸入部署描述子中的 display-name 元素值。
- 在說明欄位中,輸入處理常式的 description 元素值。
- 在處理常式名稱欄位中,輸入 handler-name 元素值。
- 在處理常式類別欄位中,輸入處理常式的 Java™ 類別的完整名稱。handler-class 元素會使用這個值。您可以按一下瀏覽來尋找 Java 類別。
- 按一下完成。這時處理常式會新增至定義給所選參照的處理常式清單中。如果您選取處理常式,您可以查看和修改內容。
- 選擇性的: 在圖示區段中,您可以指定小型和大型 GIF 或 JPEG 影像,以在執行時期,協助識別 Web 服務處理常式。這些影像必須先匯入專案中。
- 選擇性的: 在起始參數區段中,按一下新增按鈕來定義所選處理常式之起始設定參數的名稱和值。
- 選擇性的: 在 SOAP 標頭區段中,按一下新增按鈕來定義處理常式的新 SOAP 標頭的名稱空間 URL 和本端部分。