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

  1. Déterminez si vous souhaitez que le client JAX-WS utilise un mécanisme de transport HTTP ou HTTPS.
  2. Configurez le port d'écoute de réponse asynchrone pour les communications non sécurisées à l'aide de HTTP.

    Vous pouvez configurer le port HTTP pour le programme d'écoute de réponses asynchrones comme une propriété système Java ou comme propriété personnalisée dans la règle de transport. Les propriétés définies dans les fichiers de liaison de l'ensemble de règles remplacent tout propriété système Java pouvant avoir été définie.

    1. Définissez la propriété com.ibm.websphere.webservices.http.listenerPort comme une propriété système Java. Si cette propriété est définie comme une propriété système Java, alors tous les programmes de réponses asynchrones dans cette machine virtuelle Java (JVM) sont affectés.
    2. Définissez la propriété com.ibm.websphere.webservices.http.listenerPort dans les fichiers de liaison de l'ensemble de règles de transport HTTPTransport. Si cette propriété est définie en tant que propriété personnalisée dans une liaison d'ensemble de règles de transport, alors seuls les services pour lesquels l'ensemble de règles a été configuré sont concernés.
  3. Configurez le port d'écoute de réponse asynchrone pour les communications sécurisées à l'aide de HTTPS.

    Vous pouvez configurer le port HTTPS pour le programme d'écoute de réponses asynchrones comme une propriété système Java ou comme propriété personnalisée dans la règle de transport.

    1. Définissez la propriété com.ibm.websphere.webservices.https.listenerPort comme une propriété système Java. Si cette propriété est définie comme une propriété système Java, tous les programmes de réponses asynchrones dans cette machine virtuelle Java (JVM) sont affectés.
    2. Définissez la propriété com.ibm.websphere.webservices.https.listenerPort dans les fichiers de liaison de l'ensemble de règles de transport SSLTransport. Si cette propriété est définie en tant que propriété personnalisée dans une liaison d'ensemble de règles de transport, alors seuls les services pour lesquels l'ensemble de règles a été configuré sont concernés.

Résultats

Votre client de services Web JAX-WS est configuré pour utiliser le port d'écoute de réponse asynchrone pour recevoir des réponses asynchrones.

Exemple

L'exemple suivant illustre comment activer le port d'écoute de réponse asynchrone lors de l'attribution de la valeur 9999 au port personnalisé :
  • 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>

Que faire ensuite

Exécutez le client JAX-WS avec les options du port d'écoute des réponses asynchrones spécifié.

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_httpasyncresplist
Nom du fichier : twbs_httpasyncresplist.html