Utilisation du port d'écoute des réponses asynchrones JAX-WS
JAX-WS (Java™ API for XML-Based Web Services) inclut un port d'écoute de réponses asynchrones, qui est utilisé dans le client partiel pour JAX-WS et dans les environnements de client d'applications pour recevoir des demandes appelées de manière asynchrone.
Avant de commencer
JAX-WS fournit le support pour l'appel des services Web à l'aide d'un appel de client asynchrone en utilisant un modèle de rappel ou d'interrogation. Les modèles d'interrogation et de rappel sont disponibles sur le client Dispatch et le client Dynamic Proxy. Lorsque le client JAX-WS utilise un appel de client asynchrone, les réponses sont reçues par le port d'écoute des réponses asynchrones. Pour savoir comment utiliser le modèle d'appel client asynchrone, consultez les informations relatives à l'appel des services Web JAX-WS de manière asynchrone.
Pourquoi et quand exécuter cette tâche
Le port d'écoute des réponses asynchrones est utilisé dans un client de services Web pour gérer les réponses asynchrones entrantes. Vous pouvez utiliser le port d'écoute dans le client partiel pour les environnements JAX-WS et les environnements de client d'applications. Par défaut, le port d'écoute ouvre un port aléatoire pour écouter les réponses asynchrones. Vous pouvez également configurer un port spécifique pour le port d'écoute à utiliser. Le port d'écoute démarre automatiquement dans l'environnement d'exécution JAX-WS lorsque le client JAX-WS est configuré pour attendre une réponse asynchrone.
Il existe deux versions du port d'écoute des réponses asynchrones. La version non sécurisée du port d'écoute des réponses asynchrones prend en charge le protocole HTTP et la version sécurisée du port d'écoute des réponses asynchrones prend en charge le protocole HTTPS. Le port d'écoute des réponses asynchrones correct est automatiquement démarré en fonction du transport spécifique utilisé par le client JAX-WS. Pour vous assurer que le protocole d'établissement de liaison de la couche Secure Sockets (SSL) se situe entre le programme d'écoute de réponses asynchrones et le serveur d'applications, configurez les propriétés SSL en utilisant la règle de transport SSL ou les propriétés système Java.
Pour les clients de services Web exécutés sur les environnements de serveur d'applications, utilisez le servlet de réponse asynchrone pour la réception de réponses asynchrones.
Procédure
Résultats
Exemple
- Utilisez la commande Java suivante pour configurer le port HTTP personnalisé pour le programme d'écoute de réponses asynchrones dans un environnement client léger :
- java.exe -Dcom.ibm.websphere.webservices.http.listenerPort=9999 com.ibm.websphere.my_program
- Utilisez
la commande launchClient suivante pour configurer le port HTTP personnalisé pour le port d'écoute de réponse
asynchrone dans un conteneur client d'application :
- launchClient.bat MyClient.ear -CCDcom.ibm.websphere.webservices.http.listenerPort=9999
- Vous
trouverez ci-dessous un extrait d'un fichier binding.xml d'une règle TTPTransport qui inclut les propriétés
du port d'écoute de réponse asynchrone :
</wsp:Policy> </wsp:ExactlyOne> </wsp:All> <wshttp:outAsyncResponseProxy> <wshttp:connectInfo host="" port=""></wshttp:connectInfo> <wshttp:basicAuth userid="" password=""></wshttp:basicAuth> </wshttp:outAsyncResponseProxy> <wshttp:properties> <wshttp:customProperty name="com.ibm.websphere.webservices.http.listenerPort" value="9999" /> </wshttp:properties> </wsp:All> </wsp:ExactlyOne> </wsp:Policy>