Bekannte Probleme und Einschränkungen für Web-Service-Anwendungen
Bei der Arbeit mit Web-Service-Anwendungen und WebSphere Developer Tools können einige bekannte Probleme auftreten und Einschränkungen gelten. Zu den Problemen gehören u. a. Probleme bei der Verwendung einer geschützter WebSphere Application Server-Instanz und bei der Verwendung der Web-Service-Assistenten.
Weitere Informationen zu Einschränkungen und Tipps zur Fehlerbehebung finden Sie unter Bekannte Probleme und Einschränkungen für WebSphere Application Server Developer Tools for Eclipse Beta.
Die Beschränkungen, mit denen Sie es bei der Arbeit mit Web-Services zu tun bekommen, sind in folgende Abschnitte gegliedert:- Allgemeine Einschränkungen für Web-Services
- Probleme bei Verwendung eines geschützten WebSphere Application Server
- Probleme bei Verwendung des Web-Service-Assistenten
- Probleme bei Verwendung von WebSphere-JAX-WS-Laufzeitumgebung und JAXB
- Beschränkungen bei der Erstellung eines Web-Service-Clients
- Beschränkungen für die Web-Service-Beispiel-JSPs
- Probleme mit dem Web Services Explorer
- Probleme bei Verwendung des Web-Service-Befehlszeilentools
Allgemeine Einschränkungen für Web-Services
Wenn Sie bei Verwendung von Testclient-JSP die Option Asynchronen Aufruf aktivieren auswählen und dann den Service aufrufen, wird eine Fehlernachricht angezeigt, die darauf hinweist, dass die Antwortklasse nicht definiert ist.
Sie können dieses Problem umgehen, indem Sie den Service synchron testen.
Liberty unterstützt die Publizierung in UDDI nicht. Die Option Web-Service publizieren ist im Web-Service-Assistenten noch ausgewählt.
Sie können dieses Problem umgehen. Wählen Sie Web-Service publizieren ab. Die Seite "Web-Service-Publizierung" wird ebenfalls noch angezeigt. Inaktivieren Sie alle Kontrollkästchen auf dieser Seite.
Liberty unterstützt standardmäßig keine Thin Clients.
Sie können dieses Problem umgehen. Wenn Sie Unterstützung für Thin Clients hinzufügen möchten, können Sie WebSphere Application Server Traditional installieren und die Thin-Client-JAR-Dateien aus dem Ordner runtimes abrufen. Anschließend können Sie sie Ihrem Java-Projekt hinzufügen.
Sie können auch einen anderen Projekttyp, wie z. B. ein Webprojekt, verwenden.
Der Generic Service Client (GSC) wird unter OS X nicht unterstützt. Verwenden Sie WSE- oder Beispiel-JSPs, um Ihren Web-Service zu testen.
- Wenn ein Liberty-Server Ihr Ziel ist und Sie einen Bottom-up-JAX-WS-Web-Service mit dem Web-Service-Assistenten generieren, wird eine Nullzeigerausnahme ausgelöst.
- Wenn Sie die REST-Schablone im Assistenten "Neues Webprojekt" auswählen, ist als anfängliche JAX-RS-Facettenversion möglicherweise Version 2.0 eingestellt. Sie müssen die Versionsangabe manuell in "1.1" ändern, damit die JAX-RS-Bibliothek und die Klasse "IBMRestServlet" von IBM® WebSphere Application Server Liberty auf der Konfigurationsseite des REST-Service vorab eingetragen werden.
- [Liberty] Die Erstellung eines JAX-WS-Web-Service-Clients mit dem Web-Service-Assistenten schlägt möglicherweise fehl, wenn der JAX-WS-Web-Service ein OSGi-Bundleprojekt ist. Dieses Problem kann auftreten, wenn Sie einen Web-Service in einem OSGi-Bundleprojekt erstellen, den Eintrag WSDL in Projekt kopieren im Web-Service-Assistenten nicht auswählen und anschließend das OSGi-Bundleprojekt in Liberty implementieren.Dieser Prozess schlägt möglicherweise fehl, wenn Sie den JAX-WS-Client aus der Web-Service-URL mit angefügter WSDL-Datei (Web Services Description Language) erstellen. Die Tools zeigen die folgende Fehlernachricht an:
[FEHLER] Es ist bereits eine Klasse/Schnittstelle mit demselben Namen "sample.ObjectFactory" im Gebrauch. Verwenden Sie eine Klassenanpassung, um diesen Konflikt zu beheben.Dieser Prozess schlägt möglicherweise fehl, weil die Service-WSDL-Datei in dem Liberty-Server, den der Web-Services-Assistent verwendet, um den Client zu erstellen, das folgende Element enthält:<xs:complexType name="objectFactory"> <xs:sequence></xs:sequence> </xs:complexType>Um dieses Problem zu umgehen, können Sie den Eintrag WSDL in Projekt kopieren im Web-Service-Assistenten auswählen, wenn Sie ein Web-Service-Projekt in einem OSGi-Bundleprojekt erstellen. Alternativ können Sie die folgenden Schritte ausführen:- Zeigen Sie die WSDL-URL in einem Browser an und speichern Sie die WSDL-Datei auf Ihrem lokalen Computer.
- Entfernen Sie das Element complexType aus der WSDL-Datei.
- Kopieren Sie die WSDL-Datei in das Verzeichnis WEB-INF/wsdl Ihres OSGi-Bundleprojekts.
- Fügen Sie das Attribut wsdlLocation zum Element @WebService Ihrer Web-Service-Java-Quellendatei hinzu. Das Attribut wsdlLocation muss einen Wert haben, der auf Ihre lokale WSDL-Datei verweist. Die folgende Zeile ist ein Beispiel für dieses Attribut.
wsdlLocation="WEB-INF/wsdl/Sample.wsdl"
Tipp: Wenn Sie den Web-Service in einem Webprojekt anstelle eines OSGi-Bundleprojekts erstellen, können Sie den Web-Service-Client erfolgreich erstellen. Die Tools zeigen keine Fehlernachricht an. - [WebSphere Application Server Traditional] Nachdem Sie ein
JAX-RS-Webprojekt erstellt haben, können Sie die Facettenversion mit den Tools ändern. Wenn Sie die Facettenversion zwischen
JAX-RS 1.1 und 2.0 ändern, aktualisiert der Klassenpfadcontainer nicht automatisch die enthaltenen .jar-Dateien. Sie können die
enthaltenen .jar-Dateien aktualisieren, indem Sie alle anderen Facettenstufen, z. B. die JPA-Facettenstufen, aktualisieren.
Dann können Sie Ihre Änderungen auf die JPA-Facettenstufen zurücksetzen. Tipp: Wenn Sie ein JAX-RS-Projekt erstellen, ohne eine Facettenstufe anzugeben, verwenden die Tools standardmäßig JAX-RS 2.0.
Probleme bei Verwendung eines geschützten WebSphere Application Server
Die folgende Fehlernachricht kann angezeigt werden: SSLSocketFactory error message: java.net.SocketException: java.lang.ClassNotFoundException: Cannot find the specified class com.ibm.websphere.ssl.protocol.SSLSocketFactory
Bevor Sie den Web Services Explorer verwenden, Beispiel-JSPs generieren, einen Web-Service oder -Client aus einer HTTPS-WSDL-Datei erstellen oder einen Axis-Web-Service implementieren, müssen Sie die Workbench für die SSL-Kommunikation (Secure Sockets Layer) mit einem Server konfigurieren. Informationen zu dieser Aufgabe finden Sie im Artikel Probleme beim Arbeiten mit einem geschützten Server über SSL-Verbindungen.
Die folgende Fehlernachricht könnte angezeigt werden: Error opening socket: javax.net.ssl.SSLHandshakeException: unknown certifcate
Wenn Sie den Web-Service-Assistenten für den Empfang von HTTPS-WSDL oder den Web Services Explorer für einen geschützten WebSphere Application Server verwenden möchten, führen Sie die Schritte aus, die im Artikel IBM JRE für die Kommunikation mit einem geschützten WebSphere Application Server konfigurieren beschrieben sind.
Probleme bei Verwendung des Web-Service-Assistenten
Probleme bei Verwendung von WebSphere-JAX-WS-Laufzeitumgebung und JAXB
- Wenn Sie versuchen, eine Schemabibliothek zu erstellen, bei der verschiedene Schemadokumente denselben Namespace verwenden, generiert die Funktion Projekte und Code mit Kompilierungsfehlern. Die Kompilierungsfehler sind in der Datei ObjectFactory.java enthalten. Das Problem besteht darin, dass für den JAXB-Code für ein Schema ein Paket generiert wird, dessen Name auf dem targetNamespace des Schemas basiert. In diesem Paket wird auch eine Klasse ObjectFactory.java generiert, deren Inhalt auf allen Schemata in demselben Namespace basiert. Der Inhalt kann nicht aufgeteilt oder dupliziert werden, um die Kompilierungsfehler aufzulösen, weil die Laufzeitumgebung pro Paket diese eine Klasse erwartet. Das Schemabibliotheksfeature funktioniert daher nur, wenn sich alle Schemaabhängigkeiten in verschiedenen targetNamespaces befinden.
- Eine Neuerung in JAXB ist, dass die IBMWebSphere-JAX-WS-Laufzeitumgebung
nicht mehr die Aufgabe hat, Namenskonflikte aufzulösen. Wenn solche Konflikte auftreten, könnte eine Fehlernachricht wie die folgende
angezeigt werden: error:
Property "Eigenschaftsname" is already defined.
Das folgende Lernprogramm bietet weitere Informationen und einige Beispiele zur Umgehung von Namenskonflikten: The Java™ web services Tutorial: Customizing JAXB Bindings
Beschränkungen bei der Erstellung eines Web-Service-Clients
Wenn Sie einen Web-Service-Client in einem EJB-Projekt implementieren, müssen Sie auf der Proxy-Konfigurationsseite die EJB auswählen, die den Bereich für den Web-Service definiert. Diese Auswahl ist eine in JSR 109 definierte Anforderung, nach der der Komponentenname eines Elements component-scoped-refs mit dem ejb-name einer EJB im Modul übereinstimmen muss.
Wenn es im Projekt mindestens eine EJB gibt, treten keine Fehler auf. Enthält das Projekt jedoch keine EJBs, können die Optionen auf der Proxy-Konfigurationsseite bearbeitet werden. Der Standardwert dieser Optionen ist dann der mit dem Suffix "EJB" versehene Servicename aus der WSDL. Überdies zeigt der Clientassistent eine Warnung an, dass die Implementierung unvollständig ist, weil es keine EJB gibt, die den Bereich für den Web-Service-Client definiert. Sie können diesen Fehler beseitigen, indem Sie eine EJB mit dem in webservicesclient.xml verwendeten component-name erstellen.
Wenn Sie die Clienterstellung jedoch durch Abbrechen des Assistenten beenden, entfernt der Assistent nicht die unvollständigen component-scoped-refs aus der Datei webservicesclient.xml. Entfernen Sie die unvollständigen component-scoped-refs manuell vor der erneuten Implementierung.
Beschränkungen für die Web-Service-Beispiel-JSPs
- Web-Service-Beispiel-JSPs unterstützen keine Methoden, die Arrays oder Sammlungen als Parameter verwenden. Solche Methoden sind im Fensterbereich "Methoden" der Beispiel-JSPs nicht angegeben.
Probleme mit dem Web Services Explorer
- Wenn der Web Services Explorer WSDL-Dateien lädt, die mehrere integrierte Schemata verwenden, werden für Typen, die in diesen Schemata referenziert werden, Warnungen generiert. Eine solche Warnung lautet etwa wie folgt: Reference of type <qualifizierter_Name_des_Typs> isn't resolved. Diese Warnungen sind keine Fehler und beeinträchtigen nicht die Fähigkeit des Web Services Explorer, Operationen zu starten. Sie können diese Warnungen daher ignorieren.
- Der Web Services Explorer unterstützt nicht den Aufruf von Web-Services durch Authentifizierungs-Proxy-Server, die ein anderes Protokoll als die HTTP-Basisauthentifizierung verwenden, z. B. NTLM. Wenn der Web Services Explorer aus diesem oder einem anderen Grund keine Verbindung zum gewählten Web-Service herstellen kann, zeigt er in seinem Ergebnisfenster den Fehler IWAB0135E Ein unerwarteter Fehler ist aufgetreten, gefolgt von Informationen zum Fehler aus der HTTP-Antwort, an. Wechseln Sie zu einem Proxy-Server mit HTTP-Basisauthentifizierung, um dieses Problem zu lösen.
- Der Web Services Explorer hat Probleme, wenn Sie von der Quellenansicht zur Formularansicht wechseln, sofern das Schema Optionen mit Folgen enthält. Wenn Sie ein Auswahlelement in einem complexType verwenden, enthält dieses zwei oder mehr Elemente, zu denen auch eine Folge gehört. Wechseln Sie nun von der Formularansicht zur Quellenansicht, ist der Web Services Explorer möglicherweise nicht in der Lage, das entsprechende XML-Fragment der Quellenansicht richtig für die Formularansicht zu konvertieren, ohne dass Daten verlorengehen. Lösen Sie dieses Problem, indem Sie die Folge in der Formularansicht beginnen, wenn Sie mit der Dateneingabe anfangen. Bei dieser Konfiguration wird die Verwendung der Quellenansicht nicht empfohlen. Sollten Sie die Quellenansicht verwenden, schalten Sie nicht wieder auf die Formularansicht um.
- Der Web Services Explorer importiert WSDL, ohne relative Import-URLs aufzulösen. Bei Verwendung des Web Services Explorer gibt es ein Problem, wenn Sie WSDL von der WSDL-Seite in den Arbeitsbereich importieren. Ist die Option Als Serviceverweis auf ein WSIL-Dokument importieren ausgewählt, bezieht sie sich auf die ursprüngliche URL der WSDL, über die alle relativen Importe erreichbar sind. Wenn WSDL-Dokument importieren ausgewählt ist, enthält die WSDL-Datei relative Importe, die nicht mehr erreichbar sind, sodass es schwierig oder unmöglich ist, die Kopie der WSDL an anderer Stelle mit den Tools zu bearbeiten. Falls es bei der von Ihnen importierten WSDL relative Importe gibt, verwenden Sie die WSIL-Methode. Wenn eine Kopie der WSDL benötigt wird, überprüfen Sie nach dem Import manuell, ob relative Importe vorhanden sind, und korrigieren Sie ggf. defekte Links.
- Der Web Services Explorer funktioniert nicht, wenn Sie die JVM (Java Virtual Machine) mit Java 8 in Eclipse verwenden. Wenn Sie den Web Services Explorer mit Java 8 starten, wird im Hauptfenster der folgende Fehler angezeigt: HTTP Error 500. Wenn Sie dieses Problem beheben möchten, verwenden Sie Java 7 als Eclipse-JVM oder verwenden Sie den generischen Service-Client.
- Wenn Sie WebSphere Developer Tools in einer Eclipse
4.5.1-Workbench installieren, funktioniert der Web Services Explorer nicht. Wenn Sie versuchen, den Web Services Explorer zu verwenden, ist der Abschnitt Response/Status des Web Services Explorer leer und die Tools zeigen den folgenden Fehler an:
Installieren Sie WebSphere Developer Tools in einer Eclipse 4.5.2-Workbench, um dieses Problem zu umgehen. Weitere Informationen zu diesem Problem finden Sie auf der Seite 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.
Probleme bei Verwendung des Web-Service-Befehlszeilentools
- Wenn Sie in den Arbeitsbereich eine EAR-Datei importieren, die einen mit den Befehlszeilentools unter Verwendung von Java EE 1.4 generierten EJB-Client enthält, treten Kompilierungsfehler auf. Korrigieren Sie die Fehler, indem Sie mit der rechten Maustaste auf das EJB-Projekt klicken und Eigenschaften auswählen. Navigieren Sie zum Java-Erstellungspfad und wählen Sie die Registerkarte Bibliotheken aus. Entfernen Sie den Eintrag EJBClientProject/imported_classes(class folder). Fügen Sie den Klassenordner EJBServiceClient/imported_classes/Meta-inf/classess hinzu. Klicken Sie auf OK.
- [WebSphere Application Server Traditional] Wenn Sie in den Arbeitsbereich eine EAR-Datei importiert haben, die einen mit den Befehlszeilentools unter Verwendung von Java EE 1.4 generierten Anwendungsclient enthält, empfangen Sie bei Ausführung des Clients einen Fehler des Typs ClassNotFoundException. Wenn Sie die Fehler beheben möchten, klicken Sie mit der rechten Maustaste auf das Anwendungsclientprojekt und wählen Sie Eigenschaften aus. Navigieren Sie zum Java-Erstellungspfad und wählen Sie die Registerkarte Bibliotheken aus. Entfernen Sie den Eintrag ApplicationClientProject/imported_classes(class folder). Fügen Sie den Klassenordner ApplicationClientProject/imported_classes/Meta-Inf/classess hinzu. Klicken Sie auf OK.
- Die auf die Axis-Laufzeit abzielenden Web-Service-Ant-Tasks generieren Web-Services, implementieren diese jedoch nicht. Aus diesem Grund sind Axis-Web-Services, die mit den Ant-Tasks erstellt wurden, erst auf dem aktiven Server erreichbar, wenn Sie Ihre Services manuell mit dem nativen Dienstprogramm AdminClient von Apache Axis implementieren. Implementieren Sie die generierte Datei deploy.wsdd (die sich in Unterverzeichnissen des Verzeichnisses WebContent/WEB-INF des Webprojekts befindet) manuell mit dem Axis-Tool AdminClient in Axis. Weitere Details hierzu finden Sie im Abschnitt "Using the AdminClient" der Veröffentlichung "Axis 1.4 User's Guide".