Configuración del descriptor de despliegue webservices.xml para las clases de manejador
Puede utilizar una herramienta de ensamblaje para configurar el descriptor de despliegue webservices.xml para las clases de manejador proporcionadas por el usuario.
Antes de empezar
Puede configurar descriptores de despliegue con las herramientas de ensamblaje proporcionadas con el servidor de aplicaciones.
Una clase de manejador es una clase que se escribe para modificar un mensaje SOAP que representa una solicitud o una respuesta a una llamada de procedimiento remoto (RPC). Los manejadores pueden asociarse a un servicio web o a un cliente de servicio web.
Del mismo modo que para los servicios web JAX-RPC (API de Java™ para RPC basado en XML), puede utilizar descriptores de despliegue para describir los servicios web JAX-WS (API de Java para servicios web basados en XML). Para los servicios Web JAX-WS, el uso del descriptor de despliegue webservices.xml es opcional porque puede utilizar anotaciones para especificar toda la información incluida dentro del archivo del descriptor de despliegue. Puede utilizar el archivo del descriptor de despliegue para aumentar o alterar temporalmente las anotaciones de JAX-WS existentes. Cualquier información que defina en el descriptor de despliegue webservices.xml altera temporalmente la información correspondiente especificada por las anotaciones.
Para llevar a cabo esta tarea, es necesario un archivo EAR (Enterprise Archive) para las aplicaciones que desea configurar. Para algunos usos del manejador, tales como el registro cronológico o el rastreo, sólo es necesario configurar el servidor o cliente de aplicaciones. Para los demás usos del manejador, incluido el envío de la información en las cabeceras SOAP, es necesario configurar el cliente y servidor de aplicaciones con manejadores simétricos.
Acerca de esta tarea
Los módulos del archivo EAR contienen las clases de manejador que se deben configurar. Estas clases implementan la interfaz javax.xml.rpc.handler.Handler. Para obtener más información acerca de cómo escribir clases de manejador, consulte el capítulo 6 de los servicios web para la especificación Java EE. Consulte el capítulo 9 de la especificación JAX-WS o el capítulo 12 de la especificación JAX-RPC para obtener información adicional acerca de la infraestructura de manejadores de su modelo de programación. Los módulos de aplicaciones deben contener el descriptor de despliegue de webservices.xml. Consulte las especificaciones de servicios web y la información de la API para revisar la especificación JAX-RPC junto con una lista completa de estándares y especificaciones admitidos.
Procedimiento
- Inicie la herramienta de ensamblaje. Consulte cómo iniciar la herramienta de ensamblaje en la información de Rational Application Developer.
- Si todavía no lo ha hecho, configure la herramienta de ensamblaje para que funcione con los módulos Java EE. Deberá asegurarse de que están habilitadas las categorías Java EE y Web. Consulte cómo configurar la herramienta de ensamblaje en la información de Rational Application Developer.
- Migre los archivos WAR (Web Application Archive) que se han creado con Assembly Toolkit, AAT (Application Assembly Tool) o una herramienta diferente a la herramienta de ensamblaje de Rational Application Developer. Para migrar archivos, importe los archivos WAR a la herramienta de ensamblaje. Consulte cómo migrar artefactos de código a una herramienta de ensamblaje en la información de Rational Application Developer.
- Configure el descriptor de despliegue de cliente. Consulte cómo configurar el descriptor de despliegue de cliente en la información de Rational Application Developer.