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.
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
- 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.
- 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
- Déployez l'application de services Web
- 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.
- (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.
- (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.
- 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.