El cliente de servicio genérico permite probar una mayor variedad de servicios web que otros mecanismos de prueba como, por ejemplo, los servicios web JMS o los servicios web protegidos.
El cliente de servicio genérico invoca llamadas a cualquier tipo de servicio que utiliza un transporte HTTP, JMS o WebSphere® MQ y visualiza el mensaje que devuelve el servicio. El cliente de servicio genérico es útil para depurar o probar un servicio cuando no tiene acceso a un cliente dedicado para invocar la llamada de servicio. Puede configurar una gran variedad de configuraciones de transporte y seguridad
para el servicio, editar los parámetros de la llamada y enviar adjuntos.
Para obtener información detallada sobre cómo utilizar el cliente de servicio genérico para probar servicios web, consulte Envío de solicitudes de servicio con el cliente de servicio genérico.
Servicios soportados
El cliente de servicio genérico puede invocar solicitudes para varios tipos de servicios que utilizan los siguientes protocolos de transporte:
- HTTP
- Java™ Message
Service (JMS), incluidas las implementaciones JBoss y WebSphere
- WebSphere MQ
El cliente de servicio genérico no da soporte actualmente a las pruebas de servicios web protegidos.
Vea una demostración del cliente de servicio genérico que se utiliza para probar un servicio web: Prueba de servicios web con el cliente de servicio genérico
Inicio del cliente de servicio genérico
Puede iniciar el cliente de servicio genérico de varias formas:
- Pulse con el botón derecho un archivo WSDL en la vista Explorador empresarial y seleccione
- Pulse con el botón derecho un nodo de servicio en la vista Servicios y seleccione Probar con cliente de servicio genérico
- En el menú Ejecutar, seleccione Iniciar el cliente de servicio genérico
- En los asistentes de servicios web, seleccione el cliente de servicio genérico como recurso de prueba. También puede establecerlo como el recurso de prueba predeterminado en las preferencias de los servicios web.
- Pulse el icono Iniciar el cliente de servicio genérico en la barra de herramientas:
Invocación del cliente de servicio genérico desde un archivo WSDL
Antes de empezar, asegúrese de tener un archivo de lenguaje de descripción de servicios web (WSDL) válido en el espacio de trabajo (a diferencia de un archivo WSDL generado dinámicamente, como el soportado en los servicios web JAX-WS). Asegúrese de que los archivos WSDL utilicen la sintaxis correcta para el entorno de prueba. Es posible que el cliente de servicio genérico no funcione con algunos archivos WSDL.
Para invocar una llamada de servicio basada en un archivo WSDL, siga estos pasos:
- Inicie el cliente de servicio genérico y añádale el archivo WSDL si es necesario. El archivo WSDL se añade a la Biblioteca de llamadas.
- En la Biblioteca de llamadas, expanda el WSDL, el enlace y la operación, y seleccione el elemento de llamada. La llamada se configura automáticamente con cualquier punto final SOAP o JMS disponible en el WSDL. El cliente de servicio genérico muestra tres pasos: Editar datos, Invocar y Ver respuesta. Los detalles de la llamada se muestran en el paso Editar datos.
- En la página Mensaje de la llamada, utilice las vistas Formulario, Árbol u Origen para editar el contenido de la llamada. Cada vista muestra los mismos datos de forma diferente. Si desea añadir o eliminar elementos XML en la vista Formulario o Árbol, pulse para cumplir la definición de esquema XML (XSD) especificada en el catálogo de esquemas.
- En la página Adjuntos, especifique los archivos adjuntos que desee enviar con la llamada. Primero debe configurar el entorno con las bibliotecas y los archivos de configuración correctos para manejar los archivos adjuntos.
- En la página Transporte, especifique una configuración de transporte HTTP, JMS o WebSphere MQ que utilizará la llamada. Puede crear y editar las configuraciones de transporte y de seguridad pulsando la pestaña Transporte.
- En las páginas Seguridad para solicitud y Seguridad para respuesta, especifique si desea alterar temporalmente los valores de seguridad del WSDL. Si desea editar los valores de seguridad actuales del WSDL, pulse Editar seguridad WSDL para abrir el Editor de seguridad de WSDL.
- Cuando esté preparado, pulse Invocar para invocar la llamada de servicio. El cliente de servicio genérico envía la solicitud y muestra el retorno de mensaje en el paso Ver respuesta.
Limitaciones:
No se da soporte a las matrices.
Debido a la falta de especificación, los adjuntos no están soportados con el transporte JMS
(Java Message Service). El sobre se envía directamente utilizando la codificación UTF-8.
Todos los algoritmos de seguridad que no están siempre disponibles para cada implementación de Java Runtime Environment (JRE). Si una determinada implementación de seguridad no está disponible, añada las bibliotecas necesarias a la vía de acceso de clases del JRE que utiliza este producto.
El probador de servicios genérico muestra el sobre tal como se refleja en el documento XML. No obstante, los algoritmos de seguridad consideran el sobre como un binario. Por lo tanto, debe establecer la configuración de seguridad de SOAP de modo que los mensajes entrantes y salientes estén correctamente cifrados, pero permanezcan sin cifrar dentro de la prueba.