使用 Ant 作業為 IBM WebSphere JAX-WS 執行時期環境建立 Java Web 服務
您可以使用 Ant 作業(而非 Web 服務精靈),針對 IBM® WebSphere® JAX-WS 執行時期環境,產生 Java™ Web 服務。Ant 作業支援由下而上和由上而下的 Web 服務部署。
開始之前
- 為您的 Web 服務建立伺服器和 Web 專案:建立啟用 JAX-WS 的 WebSphere 伺服器
- 將 Ant 作業和內容檔匯入至工作區:匯入 JAX-WS Web 服務的 Ant 檔案
- 為 Web 服務自訂 Ant 內容檔:
- 根據您想建立的 Web 服務類型,建立或匯入檔案至您所建立之 Web 專案的資料夾:
- 如果您想建立由下而上的服務,請建立或匯入 Bean 至 src 資料夾
- 如果您想建立由上而下的服務,請尋找或建立 WSDL 檔案,或是將 WSDL 檔案匯入至您所建立的專案。
關於這項作業
- 如果您想建立由下而上的服務,Ant 內容檔的名稱是 was_jaxws_bujava.properties。
- 如果您想建立由上而下的服務,Ant 內容檔的名稱是 was_jaxws_tdjava.properties。
- 如果您想建立用戶端,Ant 內容檔的名稱是 was_jaxws_client.properties。
程序
執行 Ant 作業:
- 如果您想在產品工作區中執行作業,請執行下列動作:
- 用滑鼠右鍵按一下所匯入的 Web 服務產生 XML 檔,並選取。
- 在對話框中,按一下 JRE 標籤,並選取在與工作區相同的 JRE 中執行。
- 按一下套用,然後按一下執行。
結果
產生 Web 服務時,視您選取的選項和產生的 Web 服務類型而定,會建立下列檔案:
- 由上而下:服務端點介面 (SEI)。SEI 是用所標註的 Java 來表示 Web 服務的 WSDL 檔案。此介面用來實作 JavaBeans 端點,或用來建立動態 Proxy 用戶端實例。SEI 中的資料類型參照。
- 由下而上:委派類別。此類別是一個封套,含有 Bean 中的所有方法,以及被執行時期環境視為 Web 服務的 JAX-WS 註釋。在您執行 Ant 作業之前,若已有一個 Bean 含有 @javax.jws.WebService 註釋,則會依現狀使用這個 Bean,而不會新增註釋。
- Request/Response/Exception 封套類別。
提示: wsant.bat 檔安裝在產品的
bin 目錄中。在某些系統上,此目錄可能是唯讀。在這些情況下,Ant 作業無法建立輸出,且 Web 服務建立失敗。有兩種作法來更正此問題:
- 將 PATH 設為指向 bin 資料夾,切換至您有權寫入的目錄,並從該處執行 Script。
- 將 wsant.bat 檔複製到可寫入的目錄。