Outils de services Web - Notes sur l'édition

© Copyright International Business Machines Corporation 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM® Corp.

Notes sur l'édition

1.0 Limitations
   1.1 UDDI ne fonctionne pas dans l'Explorateur de services Web lorsque vous utilisez un serveur proxy avec authentification standard
2.0 Problèmes connus et leurs solutions
   2.1 Erreurs de validation avec les projets de client de service Web que vous importez d'une version précédente
   2.2 Pas de message vous invitant à extraire un fichier WSDL lorsque vous tentez de le modifier alors qu'il est en lecture seule et archivé. Vos modifications sont ensuite perdues lorsque vous enregistrez le fichier.
   2.3 Page d'erreur "HTTP Error 404" s'affichant par intermittence lorsque vous lancez l'exemple de JSP de service Web
   2.4 Sur la page de préférences Serveur et environnement d'exécution (catégorie Services Web), il arrive que l'environnement d'exécution des services Web change lorsque vous sélectionnez un autre serveur
   2.5 Publication UDDI : le bouton Suivant de la première page est désactivé
   2.6 NullPointerException lors de la génération d'un service Web après l'ouverture et la fermeture de la boîte de dialogue Sélection de la définition du service
   2.7 L'éditeur Java ne se lance pas automatiquement après la génération d'un service Web selon l'approche descendante
   2.8 ClassCastException lorsque vous créez un service Web dans la branche JSR-109 Services Web de l'Explorateur de projets J2EE
   2.9 Les assistants de création de services Web mémorisent l'ID utilisateur et le mot de passe
   2.10 L'Explorateur de services Web peut ne pas fonctionner avec les URL HTTPS

1.0 Limitations

1.1 UDDI ne fonctionne pas dans l'Explorateur de services Web lorsque vous utilisez un serveur proxy avec authentification standard

Si vous utilisez un serveur proxy exigeant une authentification standard (nom d'utilisateur et mot de passe) pour l'accès à Internet, vous recevrez un message d'erreur en cas d'utilisation d'UDDI dans l'Explorateur de services Web.

Par exemple :

Si la page UDDI de l'Explorateur de services Web est affichée et que vous tentez de vous connecter à un annuaire et de rechercher une entité commerciale, vous obtiendrez le message suivant dans le volet de résultats :
IWAB0135E Une erreur inattendue s'est produite.
UDDIException
java.net.SocketException: Connection reset

2.0 Problèmes connus et leurs solutions

2.1 Erreurs de validation avec les projets de client de service Web que vous importez d'une version précédente

Si vous importez dans votre espace de travail un projet de client de service Web généré dans une version antérieure du produit et que vous regénérez le client de service Web et les exemples de JSP dans le même projet, il est possible que des erreurs de validation soient signalées sur la page Result.jsp générée, indiquant que la classe org.eclipse.jst.ws.util.JspUtils ne peut pas être résolue.Cette classe se trouve dans webserviceutils.jar ; les exemples de JSP sont en réalité compilés et exécutés sans problème, malgré les erreurs de validation signalées.

Pour remédier à cette situation, fermez et rouvrez le projet, puis nettoyez-le et générez-le.

2.2 Pas de message vous invitant à extraire un fichier WSDL lorsque vous tentez de le modifier alors qu'il est en lecture seule et archivé. Vos modifications sont ensuite perdues lorsque vous enregistrez le fichier.

Lorsque vous tentez de modifier un fichier WSDL ouvert dans l'éditeur WSDL, s'il est sous contrôle des sources et archivé/en lecture seule, aucun message ne vous invite à l'extraire. Vos modifications initiales, ainsi que toutes celles qui suivent, ne seront pas enregistrées.La solution est d'extraire le fichier WSDL avant de tenter de le modifier. 

Il existe un problème similaire avec l'éditeur de schéma XML.Vous recevez un message d'invite lorsque vous extrayez le fichier, mais si vous le modifiez dans la vue graphique, vos changements seront perdus après l'enregistrement du fichier.Si vous le modifiez dans la vue Source, vos changements seront bien enregistrés.La solution est d'extraire le fichier XSD avant de tenter de le modifier.

2.3 Page d'erreur "HTTP Error 404" s'affichant par intermittence lorsque vous lancez l'exemple de JSP de service Web

Lorsque vous lancez l'exemple de JSP d'un service Web, il peut arriver que vous obteniez la page d'erreur "HTTP Error code 404" accompagnée du message "Impossible de trouver la ressource /sampleProjProxy/TestClient.jsp".La solution à ce problème est d'attendre que le message "Publication sur le serveur" disparaisse dans l'indicateur de progression (en bas à droite du plan de travail), puis de sélectionner l'exemple de JSP dans la navigateur, de cliquez dessus avec le bouton droit et de l'actualiser en sélectionnant l'option Actualiser (ou Régénérer).

2.4 Sur la page de préférences Serveur et environnement d'exécution (catégorie Services Web), il arrive que l'environnement d'exécution des services Web change lorsque vous sélectionnez un autre serveur

Sur la page de préférences Serveur et environnement d'exécution (catégorie Services Web), le contenu du champ Environnement d'exécution du service Web peut changer lorsque vous changez celui du champ Serveur.Il peut en résulter une combinaison de serveur et d'environnement d'exécution non valide.Avant d'appliquer vos modifications, assurez-vous que le serveur et l'environnement d'exécution sont bien ceux que vous souhaitez et qu'ils forment une combinaison valide.

2.5 Publication UDDI : le bouton Suivant de la première page est désactivé

Lorsque vous publiez un service Web vers un annuaire UDDI de test unitaire, le bouton Suivant de la page Publication du service Web vous mène à une page où vous pouvez choisir le serveur sur lequel doit avoir lieu la publication.Dans certains cas, le bouton Suivant est désactivé et vous pouvez seulement cliquer sur Terminer.Si vous cliquez sur Terminer, l'Explorateur de services Web s'affiche, mais le service Web n'est pas publié dans l'annuaire UDDI.

2.6 NullPointerException lors de la génération d'un service Web après l'ouverture et la fermeture de la boîte de dialogue Sélection de la définition du service

Lorsque vous générez un service Web à l'aide de l'assistant correspondant en utilisant une approche descendante, une exception NullPointerException est émise si les conditions suivantes sont réunies :
1. Le champ Définition du service est initialement vide.
2. Vous cliquez sur Parcourir pour ouvrir la boîte de dialogue Sélection de la définition du service.
3. Vous fermez la boîte de dialogue Sélection de la définition du service sans rien sélectionner.
4. Vous entrez une URL de fichier WSDL valide dans le champ Définition du service, puis vous cliquez sur Suivant ou Terminer.

Vous pouvez éviter cette exception (ou rétablir la situation si elle est émise) en naviguant jusqu'à une URL de fichier WSDL valide dans la boîte de dialogue Sélection de la définition du service au lieu d'entrer directement le texte de cette URL dans le champ Définition du service.

2.7 L'éditeur Java ne se lance pas automatiquement après la génération d'un service Web selon l'approche descendante

Si le chemin de votre espace de travail comporte des espaces, l'éditeur Java ne se lance pas automatiquement après la génération d'un service Web selon l'approche descendante.Dans ce cas, vous devez ouvrir manuellement le
fichier d'implémentation du service généré.Par convention, le nom du fichier d'implémentation du service est de la forme <nom du fichier WSDL><type de port>Impl.java

2.8 ClassCastException lorsque vous créez un service Web dans la branche JSR-109 Services Web de l'Explorateur de projets J2EE

Lorsque vous créez un service Web selon l'approche ascendante en utilisant le menu contextuel de la branche JSR-109 Services Web de l'Explorateur de projets J2EE, il est possible que vous receviez le message "Une exception inattendue s'est produite - java.lang.ClassCastException" si vous avez choisi l'option Masquer la boîte de dialogue Créer un service Web sur la page de préférences Sélection des boîtes de dialogue en incrustation (catégorie Services Web) ou si vous avez coché la case Ne plus afficher cette boîte de dialogue dans l'assistant Services Web.

2.9 Les assistants de création de services Web mémorisent l'ID utilisateur et le mot de passe

Les assistants de création de services Web mémorisent l'ID utilisateur et le mot de passe d'accès aux serveurs sur lesquels l'authentification standard est activée. Cela peut être source de problèmes si vous entrez une combinaison ID utilisateur/mot de passe incorrecte.
Pour remédier à cette situation, vous devez redémarrer le plan de travail Eclipse.

2.10 L'Explorateur de services Web peut ne pas fonctionner avec les URL HTTPS

Lorsque vous accédez à une URL HTTPS via l'Explorateur de services Web, celui-ci peut générer l'erreur suivante :

java.lang.ClassNotFoundException on com.ibm.websphere.ssl.protocol.SSLSocketFactory

Pour remédier à cette situation et ne plus y être confronté à l'avenir, redémarrez le plan de travail Eclipse et, avant de lancer l'Explorateur de services Web, veillez à ne pas exécuter d'opération en rapport avec les serveurs, par exemple la commande “Initialiser le statut du serveur” ou une “publication”.