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.

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 :
    1. Affichez l'URL WSDL dans un navigateur et enregistrez le fichier WSDL sur votre ordinateur local.
    2. Supprimez l'élément complexType du fichier WSDL.
    3. Copiez le fichier WSDL dans le répertoire WEB-INF/wsdl de votre projet de bundle OSGi.
    4. 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é

Important : Applicable à WebSphere Application Server Traditional
  • 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

  • Si vous cliquez sur Annuler à mi-chemin dans l'un des assistants de services Web, il se peut que des entrées de service Web apparaissent dans les descripteurs de déploiement et les fichiers générés dans votre espace de travail. Supprimez manuellement ces fichiers après avoir fermé l'assistant.
  • Les assistants de services Web ne parviennent pas à publier des fichiers EAR

    Problème : lorsqu'un serveur distant est créé avec l'environnement d'exécution du module de remplacement, le fichier EAR n'est pas publié.

    Cause : l'assistant de services Web ne peut pas déterminer si un serveur peut être démarré ou non.

    Solution : dans une perspective dans laquelle la vue Serveurs est disponible, cliquez avec le bouton droit de la souris sur le serveur distant et sélectionnez Ajout et suppression de projets. Sélectionnez le projet et ajoutez-le au serveur.

  • Les assistants de services Web ne parviennent pas à consommer le type de projet choisi

    Problème : si vous tentez d'exécuter les assistants de services Web sur un fichier EAR qui contient un projet client d'application Java™ EE et que l'option Installer le service Web sur le serveur est sélectionnée, ou sur un projet EJB qui ne contient pas d'EJB, vous ne pouvez pas utiliser l'assistant pur générer le service Web.

    Cause : les assistants de services Web vérifient qu'ils peuvent consommer le type de projet sélectionné dans la troisième page de l'assistant. Si ce n'est pas le cas, vous ne pouvez pas continuer.

    Solution : si vous annulez l'assistant et l'exécutez à nouveau sans sélectionner l'option Installer le service Web sur le serveur ou si vous ajoutez un EJB à un projet EJB, vous pouvez continuer l'assistant.

  • Si un fichier WSIL est sélectionné dans l'espace de travail et que l'assistant de services Web est lancé, ce dernier indique que la sélection n'est pas valide car un fichier WSDL doit être sélectionné depuis le fichier WSIL. Pour résoudre ce problème, cliquez sur Parcourir dans l'assistant de services Web pour sélectionner un fichier WSDL spécifique.
  • L'assistant de services Web peut générer une erreur au cours de la création d'un service Web si le nom du projet Web cible inclut des caractères autres que des caractères latin-1. Le problème survient car les générateurs de code de services Web calculent les adresses URL HTTP en fonction du nom de projet et que les caractères autres que les caractères latin-1 ne sont pas admis dans les adresses URL HTTP. Pour résoudre ce problème, utilisez des noms de projet comportant des caractères latin-1 seulement.
  • Si vous disposez de plusieurs projets EAR dans l'espace de travail et que vous sélectionnez Beans EJB dans un projet EJB, puis lancez l'assistant de services Web, il se peut que le bean enterprise sélectionné ne soit pas sélectionné lorsque l'assistant s'ouvre. Dans la boîte de dialogue Sélection de l'implémentation du service, le projet EAR qui est sélectionné est le premier par ordre alphabétique dans l'espace de travail, et non le projet EAR associé au projet EJB contenant le bean. Pour résoudre ce problème, dans la boîte de dialogue Sélection de l'implémentation du service, sélectionnez manuellement le projet EAR de votre choix.
  • Lorsque vous choisissez de surveiller le trafic des services Web dans la première page de l'assistant de services Web, il peut arriver que la vue Moniteur TCP/IP ne s'affiche pas automatiquement. Vous pouvez l'ouvrir manuellement en sélectionnant Fenêtre > Afficher la vue > Déboguer > Moniteur TCP/IP. La demande et la réponse pour le service Web sont affichées dans cette vue.

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 :
    Page load failed with error: cannot parse response.
    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.

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.
Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: rlimit.html