建議：考慮遷移至 JAX-WS
如果您已經在遷移或現代化過程中對 JAX-RPC Web 服務進行變更，我們強烈建議您評估轉移到 JAX-WS ( Java API for XML Web Services)。

JAX-WS 是 JAX-RPC 的繼承者，具有多項優點：

現在遷移至 JAX-WS 可以減少未來的技術債務，並使您的應用程式符合目前的 Java Web 服務標準。

有关从 JAX-RPC 迁移到 JAX-WS 的指导，请参阅 Web 服務遷移方案：JAX-RPC 到 JAX-WS 和 JAXB 文档。

不要使用 JBoss Web 服務部署描述子
此規則會標示任何現有的 webservices.xml 以偵測是否存在適用於 JBoss 的 J2EE Web 服務部署描述子檔案。

要根據 JBoss Java Platform, Enterprise Edition ( Java EE ) Web 服務部署描述符產生 JAX-RPC Web 服務、 自動修補將建立 Ant 腳本，使用適當的 IBM Ant 任務。 這包括掃描網路服務部署 描述符，並配置 Ant 腳本以產生所需的工件。


觸發規則的條件：
此規則會根據下列準則，偵測 JAX-RPC Web 服務是否存在：
a. J2EE 網路服務部署描述檔的存在 webservices.xml
b. 二進位掃描器偵測到 IBM Ant 產生的檔案尚未存在於專案的根目錄。

規則內容：
您必須提供正確的規則內容值。 如果要變更此規則的內容值，請在「軟體分析器配置」視窗中選取該規則。 然後使用「內容」標籤中的欄位。 此規則的內容為：
  • 產生的 Ant Script 名稱：
    這是將產生的新 Ant 腳本的名稱。  檔案名稱必須是有效的檔案名稱。 名稱必須是有效的檔案名稱。  該值不得包含任何正向或反向斜線。  產生的檔案將會放在專案的根目錄。 專案的根目錄中。
    預設值：build-ibm-ws.xml

  • 產生資料夾名稱：
    這是放置已產生工件的資料夾名稱。 該值不得包含任何正向或反向斜線。 資料夾位於專案的根資料夾。
    預設值：ibm-ws-gen

Ant 類別路徑：
ant class 路徑是從 Eclipse project.  計算出來的； 重要的是要確認所有編譯所需的元素都在 編譯所需的所有元素都在 Eclipse class path 上。

定義於 webservices.xml 檔的 JAX-RPC 服務
根據定義於 webservices.xml 檔的資訊和服務類型，會產生 Ant Script，以重新產生 JAXRPC 服務。

  • 產生的 Ant 目標：
    產生的 Ant Script 包含目標，以產生 WSDL 檔和 JAX-RPC 服務。
    只有在下列情況下才會產生 WSDL 生成目標 您無法找到元素 <wsdl-file>.
    WSDL 生成标记（如果已创建）的名称为 genWSDL_ssss 其中 ssss 是在 <webservice-description-name> 元素中定義的服務名稱。 元素 <webservice-description-name> 中定義的服務名稱。
    服務產生目標的名稱、 genService_pppp, 其中 pppp 是由 元素，<port-component-name>。

IBM WebSphere Application Server Ant 作業
IBM WebSphere® Application Server 包含 Ant 作業，例如 java2wsdl 和 wsdl2java，以產生 JAX-RPC 服務的必要構件。 產生的 Ant Script 會使用這些作業來建置服務。 如需這些作業的相關資訊，請參閱 WebSphere Application Server 說明文件。

執行 Ant Script
在自動修復產生 Ant 指令碼後，請檢閱該指令碼並新增任何必要的自訂。 有關自訂任務的指引，請參閱 WebSphere Application Server 文件。 IBM Ant 任務。 您必須使用 IBM 提供的 Ant 工具來執行腳本，這些工具包含在 包括在 IBM WebSphere Application Server   IBM Ant 腳本 可從以下位置執行：
  • WAS_HOME\bin\ws_ant.bat（在 Windows® 作業系統上）
  • WAS_HOME\bin\ws_ant.sh（在 UNIX® 作業系統上）
範例：c:\IBM\AppServer\bin\ws_ant.bat -f c:\eclipse\MyProject\ibm-ws-gen.xml genService_TestService

當 Ant 目標執行時，產生的工件會存放在生成資料夾中。 在生成資料夾中。 代碼、部署描述符，然後將這些工件新增到其 模組。