Web 服務應用程式的已知問題及限制
使用 WebSphere® Developer Tools 時可能會遇到各種已知問題及限制。其中包括使用安全的 WebSphere Application Server 及使用 Web 服務精靈時發生的問題。
如需限制和疑難排解提示的相關資訊,請參閱 WebSphere Application Server Developer Tools for Eclipse 測試版的已知問題和限制。
使用 Web 服務時可能遇到的限制分成下列幾節來說明:Web 服務的一般限制
使用測試用戶端 JSP,如果您選取啟用非同步呼叫,並呼叫服務,則會顯示下列錯誤訊息:The Response Class is not defined.
您可以同步測試服務來解決此問題。
Liberty 不支援發佈至 UDDI。 但是,在 Web 服務精靈中仍然選取了發佈 Web 服務。
您可以暫時解決這個問題。清除發佈 Web 服務勾選選項。「Web 服務發佈」頁面還是會出現;清除此頁面上的所有勾選框。
依預設,Liberty 不支援小型用戶端。
您可以暫時解決這個問題。如果要新增支援小型用戶端,您可以安裝 WebSphere Application Server 傳統版, 並從 runtimes 資料夾取得小型用戶端 JAR 檔。然後,您可以將它們新增至 Java 專案。
您也可以使用不同的專案類型,例如 Web 專案。
OS X 不支援「通用服務用戶端」。請使用 WSE 或範例 JSP 來測試 Web 服務。
- 如果您以 Liberty 伺服器為目標,而且使用 Web 服務精靈產生由下而上的 JAX-WS Web 服務,可能會收到空值指標異常狀況。
- 在「新建 Web 專案」精靈中選取 REST 範本時,起始 JAX-RS 資料類型版本可能是 2.0。您必須手動變更為 1.1, 以便在 REST 服務配置頁面中預先填入 IBM® WebSphere Application Server Liberty JAX-RS 程式庫和 IBMRestServlet 類別。
- [Liberty] 如果 JAX-WS Web 服務在 OSGi 軟體組專案中,使用 Web 服務精靈建立 JAX-WS Web 服務用戶端可能會失敗。
如果您在 OSGi 軟體組專案中建立 Web 服務,而在 Web 服務精靈中未選取將 WSDL 複製到專案,
然後將 OSGi 軟體組專案部署到 Liberty,就可能發生此問題。當您從 Web 服務 URL 並附加「Web 服務說明語言 (WSDL)」檔來建立 JAX-WS 用戶端時,此程序可能會失敗。 工具會顯示下列錯誤訊息:
[錯誤] 相同名稱 "sample.ObjectFactory" 的類別/介面已在使用中。請使用類別自訂作業來解決此衝突。此程序可能失敗,因為 Liberty 伺服器上供 Web 服務精靈用來建立用戶端的服務 WSDL 檔包含下列元素:<xs:complexType name="objectFactory"> <xs:sequence></xs:sequence> </xs:complexType>如果要解決此問題,當您在 OSGi 軟體組專案中建立 Web 服務專案時,您可以在 Web 服務精靈中選取將 WSDL 複製到專案。 或者,您可以完成下列步驟:- 在瀏覽器中檢視 WSDL URL,然後將 WSDL 檔儲存到本端電腦。
- 從 WSDL 檔中移除 complexType 元素。
- 將 WSDL 檔複製到 OSGi 軟體組專案的 WEB-INF/wsdl 目錄。
- 將 wsdlLocation 屬性新增至 Web 服務 Java 原始檔的 @WebService 元素。
wsdlLocation 屬性必須有一個值指向您的本端 WSDL 檔。下一行是此屬性的範例。
wsdlLocation="WEB-INF/wsdl/Sample.wsdl"
提示: 如果您在 Web 專案而非 OSGi 軟體組專案中建立 Web 服務,則會成功產生 Web 服務用戶端。工具不會顯示錯誤訊息。 - [WebSphere Application Server 傳統版]建立 JAX-RS Web 專案後,您可以使用工具來變更資料類型版本。變更 JAX-RS 1.1 和 2.0 之間的資料類型版本時,
類別路徑儲存器不會自動更新所包含的 .jar 檔。您可以提示工具藉由更新其他任何資料類型層次
(例如,JPA 資料類型層次),來更新所包含的 .jar 檔。然後,您可以反轉對 JPA 資料類型層次所做的變更。提示: 如果您建立 JAX-RS 專案時,沒有指定資料類型層次, 依預設,工具會使用 JAX-RS 2.0。
使用安全的 WebSphere Application Server 時發生的問題
您可能會看到下列錯誤訊息:SSLSocketFactory error message: java.net.SocketException: java.lang.ClassNotFoundException: Cannot find the specified class com.ibm.websphere.ssl.protocol.SSLSocketFactory
使用「Web 服務瀏覽器」來產生 JSP、從 HTTPS WSDL 檔建立 Web 服務或用戶端,或部署 Axis Web 服務之前,您必須配置工作台來透過 Secure Sockets Layer (SSL) 與伺服器進行通訊。 如需此作業的相關資訊,請參閱:透過 SSL 連線使用安全伺服器時的問題。
您可能會發現下列錯誤訊息:Error opening socket: javax.net.ssl.SSLHandshakeException: unknown certifcate
如果要使用 Web 服務精靈擷取 HTTPS WSDL,或使用「Web 服務瀏覽器」來存取安全的 WebSphere Application Server,請完成配置 IBM JRE 與安全的 WebSphere Application Server 通訊中的步驟。
使用 Web 服務精靈時發生的問題
使用 WebSphere JAX-WS 執行時期環境及 JAXB 時發生的問題
- 如果您嘗試建立綱目程式庫,而其中有不同的綱目文件使用相同的名稱空間,則此功能產生專案和程式碼時會發生編譯錯誤。 編譯錯誤發生在 ObjectFactory.java 檔中。就綱目而言,問題在於產生 JAXB 程式碼的套件是根據綱目的 targetNamespace 來命名。 ObjectFactory.java 類別也會在此套件中產生,而其內容是根據相同名稱空間的所有綱目。 無法分割或複製來解決此編譯錯誤,因為執行時期環境預期每個套件都有這一個類別。 因此,所有綱目相依關係必須在不同的 targetNamespace 中,綱目程式庫特性才會發揮作用。
- IBMWebSphere JAX-WS 執行時期環境不再負責解決名稱衝突,這是 JAXB 的新特性。
發生衝突時,您可能會看到錯誤:內容 "property_name" 已定義之類的錯誤訊息。
下列指導教學提供如何解決命名衝突的相關資訊及一些範例:Java Web 服務指導教學:自訂 JAXB 連結
建立 Web 服務用戶端時的限制
將 Web 服務用戶端部署至 EJB 專案時,您必須在 Proxy 配置頁面挑選 EJB 作為 Web 服務用戶端的範圍。 此選擇是 JSR-109 定義的需求,其中規定 component-scoped-refs 元素的 component-name 必須符合模組中 EJB 的 ejb-name。
當專案中至少有一個 EJB 時,不會發生錯誤。但是,如果專案中沒有 EJB,則 Proxy 配置頁面上的選項會變成可編輯,且預設值等於來自 WSDL 的服務名稱,字尾是 "EJB"。 此外,用戶端精靈會顯示警告,指出部署不完整,因為 Web 服務用戶端未以現有的 EJB 為範圍。您可以建立與 webservicesclient.xml 中使用的 component-name 同名的 EJB,以解決此錯誤。
不過,如果您選擇取消精靈來結束建立用戶端,精靈不會從 webservicesclient.xml 中移除不完整的 component-scoped-refs。在重新部署之前,請手動移除不完整的 component-scoped-refs。
Web 服務範例 JSP 的限制
- Web 服務範例 JSP 不支援以陣列或集合作為參數的方法。範例 JSP 的「方法」窗格中會省略這樣的方法。
Web 服務瀏覽器的問題
- 當「Web 服務瀏覽器」載入的 WSDL 檔使用多個行內綱目時, 這些綱目之間參照的類型會產生警告訊息。警告訊息類似於:無法解析類型 <qualified_type_name> 的參照。這些是警告, 不是錯誤,不影響「Web 服務瀏覽器」啟動作業的能力,因此可放心忽略。
- 在呼叫 Web 服務時,「Web 服務瀏覽器」不支援鑑別的 Proxy 伺服器使用「HTTP 基本鑑別」以外的通訊協定, 例如 NTLM。如果「Web 服務瀏覽器」因此或其他任何原因而無法連接至選擇的 Web 服務,它會在結果窗格中顯示錯誤 IWAB0135E An unexpected error has occurred,並接著顯示從 HTTP 回應擷取的失敗相關資訊。 如果要解決此問題,請切換至 HTTP 基本鑑別 Proxy 伺服器。
- 如果綱目使用的選擇包含順序,當您從程式碼視圖切換至表單視圖時,「Web 服務瀏覽器」會發生問題。 如果您在 complexType 中使用 choice 元素,且 choice 包含兩個以上的元素(包括 sequence),然後您從表單視圖切換至程式碼視圖, 「Web 服務瀏覽器」可能無法將程式碼視圖中對應的 XML 片段正確地轉換回表單視圖, 而不遺失資料。如果要解決此問題,請從最初輸入資料時的表單視圖來起始順序。 發生此配置時,不建議使用程式碼視圖。如果使用程式碼視圖,請勿切回表單視圖。
- 「Web 服務瀏覽器」匯入 WSDL 時不會解析相對匯入 URL。使用「Web 服務瀏覽器」時, 從 WSDL 頁面將 WSDL 匯入至工作區會發生問題。如果選擇匯入為 WSIL 文件的服務參照選項,則這是指向 WSDL 的原始 URL,因此可取得所有相對匯入項目。 如果選擇匯入 WSDL 文件,而 WSDL 檔包含相對匯入項目,則無法再取得這些匯入項目,導致在工具的其他地方都無法或難以處理 WSDL 的副本。 如果您匯入的 WSDL 中有相對匯入項目,請使用 WSIL 方法。如果需要 WSDL 的副本,請在匯入之後手動檢查相對匯入項目,以解決任何中斷的鏈結。
- 如果您在 Eclipse 中使用 Java 第 8 版的 Java 虛擬機器 (JVM), 則「Web 服務瀏覽器」無法運作。如果您以 Java 8 啟動「Web 服務瀏覽器」,主視窗會顯示 HTTP 錯誤 500。如果要解決此問題,請使用 Java 7 作為 Eclipse JVM,或使用通用服務用戶端。
- 如果在 Eclipse
4.5.1 工作台中安裝 WebSphere Developer Tools,「Web 服務瀏覽器」不起作用。如果嘗試使用「Web 服務瀏覽器」,
且「Web 服務瀏覽器」的 Response/Status 區段空白,工具會顯示下列錯誤:
如果要暫時解決這個問題,請將 WebSphere Developer Tools 安裝在 Eclipse 4.5.2 工作台中。如需此問題的相關資訊, 請參閱 Bug 476132 - Web services explorer issue with Java 8 - Page load failed with error: cannot parse response。Page load failed with error: cannot parse response.
使用 Web 服務指令行工具時的問題
- 將 EAR 匯入至工作區時,如果 EAR 包含使用 Java EE 1.4 的指令行工具所產生的 EJB 用戶端, 則會導致編譯錯誤。如果要解決錯誤,請用滑鼠右鍵按一下 EJB 專案,並選取內容。移至 Java 建置路徑,選取程式庫標籤。移除 EJBClientProject/imported_classes(class folder) 項目。新增類別資料夾 EJBServiceClient/imported_classes/Meta-inf/classess。按一下確定。
- [WebSphere Application Server 傳統版] 如果 EAR 包含使用 Java EE 1.4 的指令行工具所產生的「應用程式用戶端」, 將此 EAR 匯入至工作區之後,在您執行用戶端時會發生 ClassNotFoundException 錯誤。如果要解決錯誤,請用滑鼠右鍵按一下「應用程式用戶端」專案,並選取內容。移至 Java 建置路徑,選取程式庫標籤。移除 ApplicationClientProject/imported_classes(class folder) 項目。新增類別資料夾 ApplicationClientProject/imported_classes/Meta-Inf/classess。按一下確定。
- 以 Axis 執行時期為目標的 Web 服務 Ant 作業會處理如何產生 Web 服務,但不會部署它們。 因此,在執行中伺服器上無法呼叫到使用 Ant 作業建立的 Axis Web 服務,除非您使用 Apache Axis 原生 AdminClient 公用程式來手動部署服務。 請使用 Axis AdminClient 工具,將 Web 專案的 WebContent/WEB-INF 目錄下的子目錄中產生的 deploy.wsdd 檔,手動部署至 Axis。 如需詳細資訊,請參閱《Axis 1.4 使用手冊》中的「使用 AdminClient」一節。