Utilización del escucha de respuestas asíncronas JAX-WS

JAX-WS (API de Java™ para servicios web XML) incluye un escucha de respuestas asíncronas, que se utiliza en el cliente ligero para JAX-WS y en los entornos de cliente de aplicación para recibir respuestas a solicitudes que se invocan de forma asíncrona.

Antes de empezar

JAX-WS proporciona soporte para invocar servicios web utilizando una invocación de cliente asíncrona mediante un modelo de retorno de llamada o un modelo de sondeo. Ambos modelos, el de retorno de llamada y el de sondeo, están disponibles en el cliente Dispatch y el cliente de proxy dinámico. Cuando el cliente JAX-WS utiliza una invocación de cliente asíncrona, las respuestas son recibidas por un escucha de respuestas asíncronas. Si desea más información sobre cómo utilizar el modelo de invocación de cliente asíncrona, lea acerca de cómo invocar los servicios web JAX-WS de forma asíncrona.

Acerca de esta tarea

El escucha de respuestas asíncronas se utiliza en un cliente de servicios web para manejar las respuestas asíncronas entrantes. Puede utilizar un escucha en el cliente ligero para entornos JAX-WS y entornos de cliente de aplicación. De forma predeterminada, un escucha abre un puerto aleatorio para escuchar las respuestas asíncronas o bien, de forma opcional, puede configurar un puerto específico para que lo utilice un escucha. El escucha se inicia automáticamente en el tiempo de ejecución de JAX-WS, si el cliente de JAX-WS está configurado para esperar una respuesta asíncrona.

Existen dos versiones de escucha de respuestas asíncronas. La versión no segura del escucha de respuestas asíncronas soporta el protocolo HTTP, y la versión segura del escucha de respuestas asíncronas soporta el protocolo HTTPS. El escucha de respuestas asíncronas correcto se inicia automáticamente de acuerdo con el transporte concreto utilizado por el cliente de JAX-WS. Para garantizar que se produce el reconocimiento de comunicación correcto de SSL (Capa de sockets seguros) entre un escucha de respuestas asíncronas y el servidor de aplicaciones, configure las propiedades de SSL utilizando la política de transporte SSL o las propiedades del sistema Java.

Para los clientes de servicios web que se ejecutan en el entorno de servidor de aplicaciones, utilice el servlet de respuestas asíncronas para recibir respuestas asíncronas.

Procedimiento

  1. Decida si desea que el cliente JAX-WS utilice el mecanismo de transporte HTTP o HTTPS.
  2. Configure un escucha de respuestas asíncronas para la comunicación no segura utilizando HTTP.

    Puede configurar el puerto HTTP para un escucha de respuestas asíncronas como una propiedad del sistema Java, o como una propiedad personalizada dentro de la política de transporte. Las propiedades definidas en los archivos de enlace de conjunto de políticas alteran temporalmente cualquier propiedad del sistema Java que se pudiera haber definido.

    1. Defina la propiedad com.ibm.websphere.webservices.http.listenerPort como una propiedad del sistema Java. Si esta propiedad se ha establecido como una propiedad del sistema Java, se verán afectados todos los escuchas de respuestas asíncronas incluidos en la máquina virtual Java (JVM).
    2. Defina la propiedad com.ibm.websphere.webservices.http.listenerPort dentro de los archivos de enlaces de conjuntos de políticas de transporte HTTPTransport. Si esta propiedad se establece como una propiedad personalizada dentro de un enlace de conjunto de políticas de transporte, sólo se verán afectados los servicios para los cuales se ha configurado el conjunto de políticas.
  3. Configure un escucha de respuestas asíncronas para la comunicación segura utilizando HTTPS.

    Puede configurar el puerto HTTPS para un escucha de respuestas asíncronas como una propiedad del sistema Java, o como una propiedad personalizada dentro de la política de transporte.

    1. Defina la propiedad com.ibm.websphere.webservices.https.listenerPort como una propiedad del sistema Java. Si esta propiedad se establece como una propiedad del sistema Java, se verán afectados todos los escuchas de respuestas asíncronas incluidos en dicha JVM.
    2. Defina la propiedad com.ibm.websphere.webservices.https.listenerPort incluida en los archivos de enlaces del conjunto de políticas de transporte SSLTransport. Si esta propiedad se establece como una propiedad personalizada dentro de un enlace de conjunto de políticas de transporte, sólo se verán afectados los servicios para los cuales se ha configurado el conjunto de políticas.

Resultados

El cliente de servicios web JAX-WS se ha configurado para utilizar un escucha de respuestas asíncronas para recibir respuestas asíncronas entrantes.

Ejemplo

En el ejemplo siguiente se muestra cómo habilitar un escucha de respuestas asíncronas, cuando se define el puerto personalizado de 9999:
  • Utilice el mandato Java siguiente para configurar el puerto HTTP personalizado para un escucha de respuestas asíncronas en un entorno de cliente ligero:
    - java.exe -Dcom.ibm.websphere.webservices.http.listenerPort=9999 com.ibm.websphere.my_program
  • Utilice el mandato launchClient siguiente para configurar el puerto HTTP personalizado para la escucha de respuestas asíncronas en un contenedor de cliente de aplicación:
    - launchClient.bat MyClient.ear -CCDcom.ibm.websphere.webservices.http.listenerPort=9999
  • A continuación aparece un fragmento de un archivo binding.xml de la política HTTPTransport que incluye las propiedades de la escucha de respuestas asíncronas:
    </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>

Qué hacer a continuación

Ejecute el cliente JAX-WS con las opciones especificadas del escucha de respuestas asíncronas.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_httpasyncresplist
File name: twbs_httpasyncresplist.html