Web 服務應用程式的已知問題及限制

使用 WebSphere® Developer Tools 時可能會遇到各種已知問題及限制。其中包括使用安全的 WebSphere Application Server 及使用 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 複製到專案。 或者,您可以完成下列步驟:
    1. 在瀏覽器中檢視 WSDL URL,然後將 WSDL 檔儲存到本端電腦。
    2. 從 WSDL 檔中移除 complexType 元素。
    3. 將 WSDL 檔複製到 OSGi 軟體組專案的 WEB-INF/wsdl 目錄。
    4. 將 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 時發生的問題

重要: 適用於 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 服務精靈時發生的問題

  • 如果您在 Web 服務精靈的中途按一下取消,部署描述子中可能會有 Web 服務項目,而工作區中出現已產生的檔案。 關閉精靈之後,請手動刪除這些檔案。
  • Web 服務精靈無法發佈 EAR:

    問題:使用 stub 執行時期建立遠端伺服器時,不會發佈 EAR。

    原因:Web 服務精靈無法判斷伺服器是否能夠啟動。

    解決方案:在有「伺服器」視圖可用的任何視景中,用滑鼠右鍵按一下遠端伺服器,並選取新增與移除專案。選取專案並新增至伺服器。

  • Web 服務精靈無法耗用選擇的專案類型:

    問題: 如果您嘗試對包含 Java™ EE 應用程式用戶端專案的 EAR 執行 Web 服務精靈, 且選取在伺服器上安裝服務選項,或嘗試對不含 EJB 的 EJB 專案執行 Web 服務精靈, 則無法使用精靈來產生 Web 服務。

    原因:Web 服務精靈會檢查以確定可使用在精靈第三頁選取的專案類型。 如果無法使用,精靈不會讓您繼續進行。

    解決方案:如果您取消精靈,再重新執行且不選取在伺服器上安裝服務,或將 EJB 新增至 EJB 專案,則可以繼續執行精靈。

  • 如果在工作區中選取 WSIL 檔,然後啟動 Web 服務精靈,精靈會指出選擇無效,因為必須從 WSIL 檔中選取 WSDL 檔。 如果要解決此問題,請在 Web 服務精靈中按一下瀏覽,以選取特定的 WSDL 檔。
  • 如果目標 Web 專案的名稱包含非 latin-1 字元,則建立 Web 服務期間,Web 服務精靈可能會產生錯誤。 發生此問題是因為 Web 服務程式碼產生器會根據專案名稱來計算 HTTP URL,而 HTTP URL 中不允許非 Latin-1 字元。 如果要解決此問題,請使用只包含 latin-1 字元的專案名稱。
  • 如果您在工作區中有多個 EAR 專案,然後在 EJB 專案中選取 Enterprise JavaBeans 並啟動 Web 服務精靈, 則啟動精靈時,原本已選取的 Enterprise Bean 可能未選取。在「選取服務實作」對話框中,選取的 EAR 專案是工作區中按字母順序排列的第一個 EAR,而不是與包含 Bean 的 EJB 專案相關聯的 EAR。 如果要解決此問題,請在「選取服務實作」對話框中手動選取想要的 EAR 專案。
  • 在 Web 服務精靈第一頁選擇監視 Web 服務資料流量時,有時不會自動顯示「TCP/IP 監視器」視圖。 您可以選取視窗 > 顯示視圖 > 除錯 > TCP/IP 監視器,以手動開啟此視圖。該視圖中會顯示 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 區段空白,工具會顯示下列錯誤:
    Page load failed with error: cannot parse response.
    如果要暫時解決這個問題,請將 WebSphere Developer Tools 安裝在 Eclipse 4.5.2 工作台中。如需此問題的相關資訊, 請參閱 Bug 476132 - Web services explorer issue with Java 8 - 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」一節。
Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: rlimit.html