Utilisation du protocole HTTP pour le transport des demandes de services Web pour les applications JAX-WS

Vous pouvez développer un service Web JAX-WS (Java™ API for XML-Based Web Services) accessible par HTTP lorsque vous avez un objet JavaBeans existant à activer en tant que service Web.

Avant de commencer

Vous devez disposer d'un objet JAX-WS JavaBeans annoté à activer en tant que service Web. Vous n'êtes pas obligé,mais vous pouvez exécuter la commande wsgen pour créer un fichier WSDL à partir de votre JAX-WS JavaBeans annoté. Vous devez indiquer l'option -wsdl pour la commande wsgen afin de créer le fichier WSDL.

Par exemple : [Windows]
racine_serveur_app/bin wsgen.bat  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
[AIX][HP-UX][Linux][Solaris]
racine_serveur_app/bin wsgen.sh  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
[IBM i]
racine_serveur_app/bin wsgen  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
Configurations prises en charge Configurations prises en charge: Les outils de ligne de commande wsimport, wsgen, schemagen et xjc ne sont pas pris en charge sur la plateforme z/OS. Leur fonctionnalité est assurée par les outils d'assemblage fournis avec WebSphere Application Server s'exécutant sur la plateforme z/OS. Pour plus d'informations sur ces outils de ligne de commande, reportez-vous aux outils de ligne de commande pour les applications JAX-WS.sptcfg

Pour développer un service Web JAX-WS à l'aide des annotations, lisez la rubrique sur les artefacts Java des applications JAX-WS avec JavaBeans.

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 qui est utilisé dans des services Web qui prennent en charge les services Web pour Java EE (Java Platform, Enterprise Edition) et les spécifications JAX-WS (Java API for XML-Based Web Services call).

HTTP est le transport utilisé le plus fréquemment pour les services Web.

Procédure

  1. 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 point de contact HTTP accessible sur le transport HTTP. Une liaison HTTP est un élément wsdl:binding qui contient un élément soap: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 soap:address avec un attribut d'emplacement (location) qui spécifie une chaîne d'URL de point de contact HTTP.

    Lorsque vous développez le service Web, vous pouvez utiliser une marque de réservation, telle file:unspecified_location pour la chaîne d'URL de noeud final.

    Remarque : Si vous déployez un composant JAX-WS JavaBeans en tant que service Web sans le fichier WSDL file, celui-ci est généré automatiquement pour le composant.
  2. Pour les applications de service Web JAX-W, aucune configuration de transport HTTP n'est requise. Les paramètres de transport HTTP sont générés dynamiquement par le serveur d'applications. Seul le fichier WAR (web application archive) a besoin de l'objet JavaBeans avec le fichier WSDL facultatif mais installé proprement
  3. Déployez l'application de services Web
  4. Configurez la sécurité pour le transport HTTP.

    Pour configurer un transport HTTP sécurisé, associez la règle SSLTransport à l'application. Pour spécifier le jeton de transport d'authentification de base, utilisez la console d'administration pour définir les attributs d'ID utilisateur et de mot de passe dans la liaison HTTPTransport.

  5. (Facultatif) Configurez la gestion des sessions HTTP.

    La gestion des sessions HTTP permet aux applications de services Web JAX-WS d'apparaître comme étant dynamiques pour les utilisateurs de l'application.

  6. (Facultatif) Configurez le port d'écoute de réponse asynchrone pour les clients JAX-WS.

    Vous pouvez utiliser le port d'écoute de réponse asynchrone dans le client partiel pour les environnements de client d'application et JAX-WS pour recevoir des réponses aux demandes appelées de manière asynchrone.

  7. 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.

Résultats

Vous avez un objet JavaBeans qui utilise HTTP pour transporter des demandes de clients de services Web JAX-WS.

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_httptransportjaxws
Nom du fichier : twbs_httptransportjaxws.html