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
Resultados
Ejemplo
- 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>