Un escucha de punto final es el punto (dirección) en el que se reciben mensajes de un
servicio de entrada. Los escuchas de punto final proporcionados con el soporte WebSphere Application Server SOAP sobre HTTP y SOAP sobre enlaces JMS.
Acerca de esta tarea
Los escuchas de punto final son un punto final físico para recibir solicitudes de servicio de entrada. Un servicio de entrada describe un destino de bus como un servicio web lógico. Un puerto de entrada asocia un servicio de entrada (lógico) a un escucha de punto final para proporcionar un punto final (físico) donde se pueda invocar al servicio. Por lo tanto, debe haber definido un escucha de punto final antes de poder crear un puerto de entrada.
Una petición llega a un escucha de punto final. Pasa a un puerto de entrada, en el que pueden aplicarse las listas de manejadores JAX-RPC y la seguridad y, a continuación, se envía al destino de servicio. Las respuestas siguen la misma vía pero a la inversa.
La configuración de un nuevo escucha de punto final para ser utilizado con un servicio de entrada es un proceso de dos fases:
- Configure el escucha para un servidor de aplicaciones o clúster específico (tal como se describe en esta tarea).
- Configure un servicio de entrada en el mismo bus para utilizar el escucha (tal como se describe en la tarea Convertir un servicio alojado internamente en disponible como servicio web).
Para utilizar la consola administrativa para configurar un escucha de punto final, efectúe los pasos siguientes:
Procedimiento
- Inicie la consola administrativa.
- En el panel de navegación, pulse una de las siguientes vías de acceso:
Se visualiza el formulario de colección de escuchas de punto final.
- Pulse Nuevo. Se visualiza el nuevo asistente de escucha de punto final.
- Utilice el asistente para crear la nueva configuración de escucha de punto final efectuando los pasos siguientes. Para obtener más información acerca de las propiedades que se establecen con el asistente, consulte Escuchas de punto final [Valores]. Es posible que desee utilizar los valores determinados de
Valores de ejemplo de la configuración de escucha de punto final.
- Seleccione el nombre de escucha y el tipo de enlace.
- Nombre de escucha de punto final
- Escriba el nombre elegido por el que se conoce el escucha de punto final. Por ejemplo: wsgwsoaphttp; wsgwsoaphttp2; SOAPJMSChannel1; SOAPJMSChannel2.
- Tipo de enlace
- Seleccione el tipo de enlace que este escucha de punto final soporta.
Para un escucha de punto final SOAP sobre HTTP o SOAP sobre HTTPS, seleccione SOAP/HTTP o SOAP/HTTPS.
Para un escucha de punto final SOAP sobre JMS, seleccione SOAP/JMS.
- Opcional: Configure valores JMS.
Este panel sólo se visualiza si ha seleccionado SOAP/JMS en el panel anterior.
Puede elegir desplegar la aplicación de escucha de punto final para utilizar una especificación de activación o un puerto de escucha.
Los puertos de escucha se han estabilizado. Para obtener más información, consulte el artículo sobre las características estabilizadas. Siempre que sea posible, deberá desplegar la aplicación de escucha de punto final para utilizar una especificación de activación. Sólo puede utilizar las especificaciones de activación con el proveedor de mensajería predeterminado; puede utilizar las especificaciones de activación o bien los puertos de escucha con el proveedor de mensajería WebSphere MQ.
Seleccione en las listas desplegables el puerto de escucha o la
especificación de activación y fábrica de conexiones de cola que ha
configurado previamente como se describe en
Configuración de recursos JMS para el escucha de punto final SOAP sobre JMS síncrono.
- Configure los URL necesarios. Configure las direcciones web para la raíz de la aplicación y la raíz de servicio WSDL. Puede seleccionar direcciones preconfiguradas basándose en los hosts virtuales conocidos o crear nuevos valores.
- Raíz de URL
- Seleccione o escriba la dirección desde la que los clientes externos acceden al escucha de punto final. La raíz de URL es la raíz de contexto de la aplicación de escucha de punto final y proporciona la raíz de la dirección web que se utiliza para generar las direcciones de punto final dentro de los archivos WSDL para dirigir a los solicitantes a este escucha de punto final.
- Se puede utilizar un servidor HTTP con un servidor de aplicaciones autónomo.
De forma alternativa, si clientes externos utilizan el escucha de punto final para acceder a un clúster que proporciona alta disponibilidad o gestión de carga de trabajo, normalmente, el clúster emplea un servidor HTTP configurado de forma apropiada (o servidor proxy WebSphere) que funciona como un distribuidor de IP. En cualquier caso, si los clientes externos acceder al escucha de punto final a través de un servidor
HTTP o un clúster de servidores, que utiliza el puerto predeterminado 80, debe especificar el nombre de servidor HTTP y no el número de puerto. Por ejemplo (para el escucha de punto final SOAP sobre HTTP 1):
http://www.suempresa.com/wsgwsoaphttp1
Para un servidor de aplicaciones autónomo, el escucha de punto final suele estar configurada para clientes que se conectan directamente a un servidor de aplicaciones individual.
Si los clientes externos utilizan el escucha de punto final para acceder a un clúster, puede configurar el escucha para que los clientes se conecten directamente a un servidor de aplicaciones
individual dentro del clúster, tal como se muestra en el siguiente ejemplo, pero esto podría limitar las capacidades de alta disponibilidad o gestión de carga de trabajo del clúster. Sin embargo, si permite a los clientes externos conectarse directamente al servidor de aplicaciones (por ejemplo, porque es un servidor autónomo o en un entorno de desarrollo o de prueba) especifique el nombre de host y el número de puerto del servidor de aplicaciones. Por ejemplo (para el escucha de punto final SOAP sobre HTTP 1):http://su.nombre.servidor:9080/wsgwsoaphttp1
donde el número de puerto (especificado como 9080 en este ejemplo) coincide con el valor de puerto WC_defaultHost para el servidor de aplicaciones implicado.
- Raíz de URL HTTP de servicio WSDL
- Escriba la raíz de la dirección web para los archivos WSDL de los servicios de entrada que están disponibles en el escucha de punto final. Esta dirección consta del raíz de la dirección HTTP desde el que los clientes externos acceden a la aplicación de la escucha de punto final, seguido de /sibws. Esto representa el URL que se utiliza al publicar el URL de
WSDL en un registro de UDDI.
El nombre de host y de puerto que especifica para la Raíz del URL HTTP que da servicio al WSDL normalmente coinciden con los que ha especificado para la Raíz del URL.
Si los clientes externos acceden al escucha de punto final a través de un servidor HTTP o un clúster de servidores utilizando normalmente el puerto 80 predeterminado, esta raíz de URL incluye el nombre del servidor HTTP pero no un número de puerto. Por ejemplo:
http://www.suempresa.com/sibws
No obstante, si permite a los clientes externos conectarse directamente al servidor de aplicaciones (por ejemplo, en un entorno de desarrollo o de prueba), esta raíz de URL incluye el nombre de host del servidor de aplicaciones y el número de puerto.
Por ejemplo:
http://su.nombre.servidor:9080/sibws
Nota: Otros componentes de WebSphere Application Server (especialmente el registro UDDI de IBM) son los únicos que utilizan internamente el raíz del URL HTTP que da servicio al WSDL. Para los demás usos, debe acceder al archivo WSDL a través del escucha de punto final para el servicio de entrada. Para obtener detalles de la ubicación para un archivo WSDL de servicio de entrada determinado, publique el archivo WSDL en un archivo comprimido tal como se describe en Modificación de una configuración de servicio de entrada existente y, a continuación, busque la ubicación dentro del archivo WSDL exportado.
- Seleccione los buses de integración de servicios a los que deberá conectar el nuevo escucha de punto final. Sólo los buses de los que es miembro el servidor de aplicación o clúster están disponibles para ser seleccionados.
- Pulse Finalizar.
Resultados
Si el proceso se completa correctamente, la lista de escuchas de punto final se actualiza para incluir el nuevo escucha de punto final. De lo contrario,
aparece un mensaje de error.
Qué hacer a continuación
Ya está preparado para seleccionar este escucha de punto final para su uso en un servicio de entrada, como se describe en
Convertir un servicio alojado internamente en disponible como servicio web.