Problèmes connus et limitations concernant les applications de service Web
Vous pouvez rencontrer des problèmes connus et des limitations lorsque vous utilisez des applications de service Web avec WebSphere Developer Tools. Un de ces problèmes peut survenir lorsque vous utilisez un serveur WebSphere Application Server sécurisé et lorsque vous utilisez les assistants de service Web.
Pour plus d'informations sur les limitations et pour des recommandations sur le traitement des incidents, voir Problèmes connus et limitations concernant WebSphere Application Server Developer Tools for Eclipse Beta.
Les limitations que vous pouvez rencontrer lorsque vous utilisez des services Web peuvent être classées dans deux sections :- Limitations générales pour les services Web
- Problèmes rencontrés lors de l'utilisation d'un serveur WebSphere Application Server sécurisé
- Problèmes rencontrés lors de l'utilisation de l'assistant de services Web
- Problèmes rencontrés lors de l'utilisation d'un environnement d'exécution WebSphere JAX-WS et de JAXB
- Limitations lors de la création d'un client de service Web
- Limitations des exemples de page JSP de service Web
- Problèmes liés à l'explorateur de services Web
- Problèmes lors de l'utilisation de l'outil de ligne de commande des services Web
Limitations générales pour les services Web
A l'aide du client JSP de test, si vous sélectionnez Activer l'appel asynchrone et que vous appelez ensuite le service, le message d'erreur suivant s'affiche : La classe de réponse n'est pas définie.
Vous pouvez contourner ce problème en testant le service en mode synchrone.
Liberty ne prend pas en charge la publication UDDI. Cependant, Publier le service Web est toujours sélectionné dans l'assistant de service Web.
Vous pouvez contourner ce problème. Décochez la case Publier le service Web. La page de publication du service Web apparaît toujours également ; décochez toutes les cases de cette page.
Liberty ne prend pas en charge par défaut les clients légers.
Vous pouvez contourner ce problème. Pour ajouter une prise en charge de clients légers, vous pouvez installer WebSphere Application Server Traditional et vous procurer les fichiers JAR de client léger depuis le dossier runtimes. Vous pouvez ensuite les ajouter à votre projet Java.
Vous pouvez également utiliser un type de projet différent, comme un projet Web.
Le client Generic Service Client n'est pas pris en charge sur OS X. Utilisez le WSE ou les JSP exemples pour tester votre service Web.
- Si vous ciblez un serveur Liberty et générez un service Web JAX-WS de bas en haut à l'aide de l'assistant de service Web, une exception de pointeur null peut être renvoyée.
- Lorsque vous sélectionnez le modèle REST dans l'assistant Nouveau projet Web, la version de facette JAX-RS initiale peut être la version 2.0. Vous devez la modifier manuellement en 1.1 de telle sorte que les zones IBM® WebSphere Application Server Liberty JAX-RS Library et IBMRestServlet Class apparaissent pré-renseignées dans la page de configuration du service REST.
- [Liberty]La création d'un client de service Web JAX-WS
à l'aide de l'assistant de service Web peut échouer si ce service réside dans un projet de bundle OSGi.
Ce problème peut survenir si vous créez un service Web dans un projet
de bundle OSGi, que vous ne sélectionnez pas Copier le document WSDL
dans le projet dans l'assistant de service Web, puis déployez le
projet de bundle OSGi dans Liberty.Ce processus peut échouer lorsque vous créez le client JAX-WS depuis l'URL du service Web en ajoutant le fichier WSDL (Web Services Description Language). Les outils affichent le message d'erreur suivant :
[ERREUR] Une classe/interface portant le même nom, "sample.ObjectFactory", est déjà utilisée. Utilisez une personnalisation de classe pour résoudre ce conflit.Ce processus peut échouer étant donné que le fichier WSDL du service sur le serveur Liberty utilisé par l'assistant de services Web pour créer le client contient l'élément suivant :<xs:complexType name="objectFactory"> <xs:sequence></xs:sequence> </xs:complexType>Pour contourner ce problème, vous pouvez sélectionner Copier le document WSDL dans le projet dans l'assistant de service Web lorsque vous créez un projet de service Web dans un projet de bundle OSGi. Autrement, vous pouvez procéder comme suit :- Affichez l'URL WSDL dans un navigateur et enregistrez le fichier WSDL sur votre ordinateur local.
- Supprimez l'élément complexType du fichier WSDL.
- Copiez le fichier WSDL dans le répertoire WEB-INF/wsdl de votre projet de bundle OSGi.
- Ajoutez l'attribut wsdlLocation à l'élément @WebService du fichier source Java de votre service
Web.La valeur de l'attribut wsdlLocation doit pointer sur votre fichier WSDL local. Un exemple de cet attribut figure sur la ligne suivante.
wsdlLocation="WEB-INF/wsdl/Sample.wsdl"
Conseil : Si vous créez le service Web dans un projet Web au lieu d'un projet de bundle OSGi, la génération du client de service Web aboutit. Les outils n'affichent pas de message d'erreur. - [WebSphere Application Server Traditional]
Après avoir créé un projet Web JAX-RS, vous pouvez utiliser les outils pour
modifier la version de la facette. Lorsque vous modifiez la version de la
facette de JAX-RS 1.1 en 2.0, le conteneur du chemin d'accès aux classes ne met
pas automatiquement à jour les fichiers .jar inclus. Vous
pouvez inviter les outils à mettre à jour les fichiers
.jar inclus en mettant à jour les autres niveaux de
facette, comme les niveau de facette JPA.
Vous pouvez ensuite annuler les modifications apportées aux niveau de facette
JPA. Conseil : Si vous créez un projet JAX-RS sans indiquer de niveau de facette, les outils utilisent JAX-RS 2.0 par défaut.
Problèmes rencontrés lors de l'utilisation d'un serveur WebSphere Application Server sécurisé
Vous pouvez rencontrer le message d'erreur suivant : Message d'erreur SSLSocketFactory : java.net.SocketException: java.lang.ClassNotFoundException: Classe spécifiée com.ibm.websphere.ssl.protocol.SSLSocketFactory introuvable
Avant d'utiliser l'explorateur de services Web, de générer des exemples de fichier JSP, de créer un service Web ou un client à partir d'un fichier WDSL HTTPS ou de déployer un service Web Axis, vous devez configurer le plan de travail pour qu'il communique avec un serveur via le protocole Secure Sockets Layer (SSL). La rubrique suivante contient des informations sur cette tâche : Problèmes liés à l'utilisation d'un serveur sécurisé avec des connexions SSL.
Vous pouvez rencontrer le message d'erreur suivant : Error opening socket: javax.net.ssl.SSLHandshakeException: unknown certificate (Erreur lors de l'ouverture du socket : javax.net.ssl.SSLHandshakeException: certificat inconnu)
Pour utiliser l'assistant des services Web afin d'extraire un fichier WSDL HTTPS ou d'utiliser l'explorateur de services Web sur un serveur WebSphere Application Server sécurisé, effectuez les étapes décrites dans la rubrique Configuration de l'environnement d'exécution Java IBM pour la communication avec un serveur WebSphere Application Server sécurisé.
Problèmes rencontrés lors de l'utilisation de l'assistant de services Web
Problèmes rencontrés lors de l'utilisation d'un environnement d'exécution WebSphere JAX-WS et de JAXB
- Si vous essayez de créer une bibliothèque de schémas qui contient différents documents de schéma utilisant le même espace de nom, la fonction génère des projets et un code avec des erreurs de compilation. Les erreurs de compilation se trouvent dans le fichier ObjectFactory.java. En effet, pour un schéma, le code JAXB est généré dans un package dont le nom repose sur l'espace de nom cible du schéma. Une classe ObjectFactory.java est également générée dans ce package et son contenu repose sur tous les schémas du même espace de nom. Elle ne peut pas être fractionnée ni dupliquée pour résoudre les erreurs de compilation car l'environnement d'exécution attend cette classe pour chaque package. Par conséquent, la fonction de bibliothèque de schémas fonctionne uniquement si tous les dépendances de schéma se trouvent dans des espaces de nom cible différents.
- Nouveau dans JAXB, l'environnement d'exécution IBMWebSphere JAX-WS n'est plus responsable de la résolution des conflits de nom. Lorsque de tels conflits surviennent, un message d'erreur indiquant que la propriété est déjà définie (error:
Property "property_name" is already defined) peut s'afficher.
Le tutoriel suivant fournit des informations supplémentaires et des exemples de résolution des conflits de nom : The Java web services Tutorial: Customizing JAXB Bindings.
Limitations lors de la création d'un client de service Web
Lorsque vous déployez un client de service Web dans un projet EJB, dans la page de configuration du proxy, vous devez sélectionner l'EJB qui constitue la portée du client de service Web. Cette sélection est une exigence définie par JSR-109, où l'élément component-name d'un élément component-scoped-refs doit correspondre à l'élément ejb-name d'un EJB dans le module.
Lorsqu'il existe un EJB au moins dans le projet, aucune erreur ne survient. Toutefois, s'il n'existe pas d'EJB dans le projet, vous pouvez éditer les options de la page de configuration du proxy et définir une valeur par défaut égale au nom du service du WSDL, avec le suffixe "EJB". De plus, l'assistant du client affiche un avertissement qui indique que le déploiement est incomplet car le client de service Web n'a pas pour portée un EJB existant. Vous pouvez corriger cette erreur en créant un EJB avec le même nom que l'élément component-name utilisé dans webservicesclient.xml.
Toutefois, si vous choisissez de mettre fin à la création du client en annulant l'assistant, ce dernier ne supprime pas l'élément component-scoped-refs incomplet dans le fichier webservicesclient.xml. Vous devez supprimer manuellement l'élément component-scoped-refs incomplet avant le redéploiement.
Limitations des exemples de page JSP de service Web
- Les exemples de page JSP de service Web ne proposent pas de prise en charge pour les méthodes qui admettent des tableaux ou des collections comme paramètres. De telles méthodes sont omises dans le panneau des méthodes des exemples de page JSP.
Problèmes liés à l'explorateur de services Web
- Lorsque l'explorateur de services Web charge des fichiers WSDL qui utilisent plusieurs schémas intégrés, des messages d'avertissement sont générés pour des types qui sont référencés dans ces schémas. Ce message est similaire au suivant : La référence du type <nom_type_qualifié> n'est pas résolue. Il ne s'agit pas d'erreurs mais d'avertissements qui n'interfèrent pas avec la capacité de l'explorateur de services Web à démarrer des opérations. Par conséquent, vous pouvez les ignorer.
- L'explorateur de services Web ne prend pas en charge l'appel de services Web via l'authentification de serveurs proxy qui utilisent un protocole autre que l'authentification de base HTTP, tel que NTLM. Si l'explorateur de services Web ne parvient pas à se connecter au service Web choisi pour une raison quelconque, il affiche dans son panneau de résultats l'erreur IWAB0135E Une erreur inattendue s'est produite, suivie d'informations sur l'échec provenant de la réponse HTTP. Pour résoudre ce problème, utilisez un serveur proxy appliquant l'authentification de base HTTP.
- L'explorateur de services Web génère des erreurs lorsque vous passez de la vue source à la vue de formulaire si le schéma utilise des choix contenant des séquences. Si vous utilisez un élément de choix dans un élément complexType, que le choix contient deux éléments ou plus incluant une séquence, et que vous passez de la vue de formulaire à la vue source, il se peut que l'explorateur de services Web ne soit pas capable de convertir correctement le fragment XML correspondant dans la vue source lorsque vous revenez à la vue de formulaire sans perte de données. Pour résoudre ce problème, démarrez la séquence depuis la vue de formulaire lorsque les données sont entrées initialement. Dans cette configuration, il n'est pas recommandé d'utiliser la vue source. Si la vue source est utilisée, ne revenez pas à la vue de formulaire.
- L'explorateur de services Web importe le fichier WSDL sans résoudre les adresses URL d'importation relatives. Lorsque vous utilisez l'explorateur de services Web, un problème survient lorsque vous importez un fichier WSDL de la page WSDL dans l'espace de travail. Si l'option Importer comme référence de service dans un document WSIL est sélectionnée, il s'agit de l'adresse URL d'origine du fichier WSDL et par conséquent, tous les importations relatives sont inaccessibles. Si l'option Importer le document WSDL est sélectionnée et que le fichier WSDL contient des importations relatives, ces importations ne sont plus accessibles, ce qui rend la copie du fichier WSDL difficile ou le traitement du fichier WSDL impossible ailleurs dans les outils. S'il existe des importations relatives dans le fichier WSDL que vous importez, utilisez la méthode WSIL. Si vous devez copier le fichier WSDL, vérifiez manuellement les importations relatives après l'importation afin de résoudre les liens rompus.
- L'explorateur de services Web ne fonctionne pas si vous utilisez la version Java 8 de la machine virtuelle Java (JVM) dans Eclipse. Si vous lancez l'explorateur de services Web avec Java 8, la fenêtre principale affiche Erreur HTTP 500. Pour résoudre ce problème, utilisez Java 7 comme machine virtuelle Java Eclipse ou utilisez le client de service générique.
- Si vous installez WebSphere
Developer Tools dans un plan de travail Eclipse
4.5.1, l'explorateur de services Web ne fonctionne pas. Si vous tentez
d'utiliser l'explorateur de services Web, sa section
Response/Status reste vide et les outils affichent l'erreur
suivante :
Pour contourner ce problème, installez WebSphere Developer Tools dans un plan de travail Eclipse 4.5.2. Pour plus d'informations sur ce problème, voir 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.
Problèmes lors de l'utilisation de l'outil de ligne de commande des services Web
- L'importation d'un fichier EAR contenant un client EJB généré par les outils de ligne de commande avec Java EE 1.4 dans l'espace de travail génère des erreurs de compilation. Pour corriger les erreurs, cliquez avec le bouton droit de la souris sur le projet EJB et sélectionnez Propriétés. Accédez à Chemin de génération Java et sélectionnez l'onglet Bibliothèques. Supprimez l'entrée EJBClientProject/imported_classes(class folder). Ajoutez le dossier de classes EJBServiceClient/imported_classes/Meta-inf/classes. Cliquez sur OK.
- [WebSphere Application Server Traditional] Après avoir importé dans l'espace de travail un fichier EAR contenant un client d'application généré par les outils de ligne de commande à l'aide de Java EE 1.4, une erreur ClassNotFoundException est renvoyée lorsque vous lancez le client. Pour corriger les erreurs, cliquez avec le bouton droit de la souris sur le projet client d'application et sélectionnez Propriétés. Accédez à Chemin de génération Java et sélectionnez l'onglet Bibliothèques. Supprimez l'entrée ApplicationClientProject/imported_classes(class folder). Ajoutez le dossier de classe ApplicationClientProject/imported_classes/Meta-Inf/classess. Cliquez sur OK.
- Les tâches Ant de services Web qui ciblent l'environnement d'exécution Axis traitent la génération des services Web mais pas leur déploiement. Par conséquent, les services Web Axis qui sont créés avec les tâches Ant ne sont pas accessibles sur le serveur en cours d'exécution tant que vous ne déployez pas manuellement vos services avec l'utilitaire natif AdminClient d'Apache Axis. Déployez le fichier deploy.wsdd généré dans les sous-répertoires du répertoire WebContent/WEB-INF du projet Web dans Axis manuellement à l'aide de l'outil AdminClient d'Axis. Pour plus de détails, reportez-vous à la section relative à l'utilisation d'AdminClient dans le guide d'utilisation d'Axis 1.4.