Développement de liaisons client à partir d'un fichier WSDL pour un client de services Web JAX-RPC

Vous pouvez développer des liaisons client à partir d'un fichier WSDL pour un client de services web JAX-RPC.

Avant de commencer

Pour développer des liaisons client à partir d'un fichier WSDL pour les applications de services Web JAX-RPC, vous devez obtenir l'URL du fichier WSDL à utiliser. Les liaisons et les descripteurs de déploiement permettent à un client d'utiliser un service Web.

[Windows][z/OS]S'il s'agit d'un fichier local, l'URL est du type suivant : file:unité:\chemin\nom_fichier.wsdl.

[Linux][AIX][HP-UX][Solaris][IBM i]S'il s'agit d'un fichier local, l'URL est du type suivant : file:/chemin\nom_fichier.wsdl.

Vous pouvez également spécifier des fichiers locaux à l'aide du chemin d'accès au système de fichiers absolu ou relatif.

Les liaisons client sont générées à l'aide de l'option -role develop-client associée à l'option -container de la commande WSDL2Java . L'option -container prend les paramètres suivants :
  • -container client

    Génère les liaisons et les descripteurs de déploiement d'un client résidant dans le conteneur du client de l'application.

  • -container ejb

    Génère les liaisons et les descripteurs de déploiement d'un client correspondant à un bean enterprise d'un module EJB (Enterprise JavaBeans).

  • -container web

    Génère les liaisons et les descripteurs de déploiement d'un client résidant dans le conteneur web.

[z/OS]L'outil de ligne de commande WSDL2Java n'est pas pris en charge sur la plateforme z/OS. Cette fonctionnalité est fournie par les outils d'assemblage fournis avec la version z/OS du produit. Pour plus d'informations sur cet outil, consultez les informations relatives à l'outil WSDL2Java pour les applications JAX-RPC (Java™ API for XML-based Remote Procedure Call).

Pourquoi et quand exécuter cette tâche

Pour développer les liaisons client à partir d'un fichier WSDL, procédez comme suit.

Pratiques recommandées Pratiques recommandées: La meilleure méthode consiste à utiliser des espaces de nom absolus dans votre WSDL ou votre schéma. Par défaut, l'outil WSDL2Java ne permet pas d'utiliser les espaces de nom relatifs. Ces derniers ont été dépréciés par le XML Plenary Interest Group et l'utilisation d'espaces de nom relatifs entraîne l'échec de la signature numérique XML comme requis par la spécification Canonical XML version 1.0. Vous pouvez convertir un espace de nom relatif en espace de nom absolu. Pour plus d'informations sur l'utilisation des espaces de nom avec l'outil WSDL2Java, consultez la documentation relative à la commande WSDL2Java pour les applications JAX-RPC. bprac

Procédure

Exécutez la commande WSDL2Java -verbose -role develop-client -container type URL_wsdl,

type est ejb pour un client d'EJB enterprise, web pour un client JavaBeans ou client pour un client d'application.

Vous pouvez utiliser les combinaisons suivantes dans la ligne de commande :
  • -container web
  • -container ejb
  • -container client
L'option -verbose étant spécifiée, une liste de tous les fichiers générés s'affiche lors de l'exécution de la commande.

Résultats

Vous avez développé les liaisons et les descripteurs de déploiement dont un client a besoin pour utiliser un service Web.

Exemple

L'exemple suivant utilise le bean enterprise AddressBook et le fichier WSDL AddressBook.wsdl. Une fois que les liaisons ont été générées à partir de la commande WSDL2Java -verbose -role develop-client -container client AddressBook.wsdl, les fichiers suivants sont générés :
Parsing XML file:  file:e:/example/app/topdown/step1/AddressBook.wsdl 
WSWS3185I: Info: Parsing XML file:  AddressBook.wsdl
WSWS3282I: Info: Generating addr\Address.java.
WSWS3282I: Info: Generating addr\Phone.java.
WSWS3282I: Info: Generating addr\StateType.java.
WSWS3282I: Info: Generating addr\AddressBook.java.
WSWS3282I: Info: Generating addr\AddressBookService.java.
WSWS3282I: Info: Generating META-INF\ibm-webservicesclient-bnd.xmi.
WSWS3282I: Info: Generating META-INF\AddressBook_mapping.xml.
WSWS3282I: Info: Generating META-INF\ibm-webservicesclient-ext.xmi.

Que faire ensuite

Effectuez l'implémentation du client en écrivant votre application de client et en assemblant les artefacts de client.

.

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_devclientbindings
Nom du fichier : twbs_devclientbindings.html