Vous pouvez développer un service Web JAX-RPC (Java™ API for XML-based remote
procedure call) accessible via le protocole HTTP lorsque vous avez déjà un objet JavaBeans à activer en tant que service
Web.
Avant de commencer
Exécutez la commande
Java2WSDL pour créer un fichier
WSDL (Web Services Description Language). Lorsque vous exécutez la commande
Java2WSDL, spécifiez l'option -bindingsTypes, ainsi que
http,
pour définir les liaisons de transport HTTP. Par
exemple :
java2wsdl -bindingTypes http, jms -implClass my.pkg.MyEJBClass my.pkg.MySEI
Pour
plus d'informations sur l'utilisation de la commande
Java2WSDL, voir la documentation des applications JAX-RPC.
L'outil de ligne de commande Java2WSDL
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. Consultez les informations relatives à l'outil de ligne de commande Java2WSDL des applications JAX-RPC (Java API for XML-based Remote Procedure Call), pour plus de détails sur cet outil.
Pourquoi et quand exécuter cette tâche
Le serveur d'applications prend en charge l'utilisation de HTTP pour le transport
des demandes des clients de services Web. Avec HTTP, les clients de services Web et les serveurs peuvent communiquer
par messages SOAP. SOAP est le protocole de communication sous-jacent
utilisé dans les services Web qui prennent en charge les spécifications Web Services for Java EE (Java
Platform Enterprise Edition) et JAX-RPC (Java API for XML-based remote
procedure call).
HTTP est le transport utilisé le plus fréquemment pour les services Web.
Pour développer un service Web accessible par HTTP à partir d'un objet JavaBeans existant :
- Ajoutez une liaison HTTP et une adresse SOAP au fichier WSDL.
Le fichier WSDL d'un service Web doit inclure une liaison HTTP et une
adresse SOAP qui spécifie une chaîne d'URL de noeud final HTTP, afin d'être
accessible sur le transport HTTP. Une liaison HTTP est un élément wsdl:binding qui contient un élément
wsdlsoap:binding dont l'attribut transport se termine par soap/http.
Outre la liaison HTTP, un élément wsdl:port référençant cette liaison
doit être inclus dans l'élément wsdl:service du fichier WSDL. L'élément
wsdl:port contient un élément wsdlsoap:address avec un attribut
d'emplacement (location) qui spécifie une chaîne d'URL de noeud final HTTP.
Lorsque vous développez le service Web, une marque de réservation telle que file:unspecified_location peut être utilisée pour la chaîne d'URL de noeud final.
- Ajoutez les noeuds finaux HTTP à votre fichier EAR à l'aide de la
commande endptEnabler, si votre application contient des beans
enterprise.
Par défaut, la commande endptEnabler n'ajoute que des noeuds finaux HTTP.
- Déployez l'application de services Web
- Configurez la sécurité de la connexion HTTP.
Pour que
la connexion HTTP soit sécurisée, ajoutez la propriété d'assemblage basicAuth
au fichier de descripteur de déploiement
ibm-webservicesclient-bnd.xmi. Définissez les attributs ID utilisateur
et Mot de passe.
- Configurez les informations d'URL de noeud final pour les liaisons HTTP.
Le serveur d'informations WSDL utilise cette chaîne d'URL partielle pour générer l'URL HTTP réelle de chaque composant de port défini dans le fichier EAR. Le fichier WSDL publié peut être utilisé par les clients qui ont besoin
d'invoquer le service Web.