Desarrollo de un descriptor de despliegue webservices.xml para aplicaciones JAX-WS
Descriptores de despliegue son archivos de texto estándar con formato XML y empaquetados en una aplicación de servicios web. Opcionalmente utilice el descriptor de despliegue webservices.xml para aumentar o alterar temporalmente los metadatos de aplicación especificados en las anotaciones dentro de los servicios web JAX-WS (API de Java™ para servicios web XML).
Acerca de esta tarea
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. 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.
Un servicio web JAX-WS, requiere que anote la clase Java con la anotación javax.jws.WebService o la anotación javax.jws.WebServiceProvider para puntos finales de proveedor. Puede utilizar los descriptores de despliegue del extremo del servidor para alterar temporalmente los atributos correspondiente de la anotación o para ampliar la información en las anotaciones. Existe una relación definida entre los elementos del descriptor de despliegue y las anotaciones @WebService y @WebServiceProvider. Consulte la sección 5.3 de la especificación de servicios web para Java EE (Java Platform, Enterprise Edition) Versión 1.2 para obtener información detallada relacionada con los elementos del descriptor de despliegue y la correlación con los atributos de las anotaciones @WebService y @WebServiceProvider. En el descriptor de despliegue webservice.xml existen también elementos que se correlacionan con otras anotaciones. Por ejemplo, el elemento del descriptor de despliegue <protocol-binding> se correlaciona con la anotación @BindingType y el elemento del descriptor de despliegue <enable-mtom> se correlaciona con la anotación @MTOM. Para obtener más información relacionada con los elementos de descriptor de despliegue de servicios web, consulte la sección 7.1 de la especificación de servicios web para Java EE (Java Platform, Enterprise Edition).
Procedimiento
Resultados
Tiene plantillas de descriptor de despliegue que puede utilizar para alterar temporalmente los atributos de anotaciones JAX-WS o para especificar atributos no definidos por la anotación.
Ejemplo
@WebService(wsdlLocation=”http://myhost.com/location/of/the/wsdl/ExampleService.wsdl”)
El descriptor de despliegue webservices.xml asociado especifica un nombre de archivo diferente para el documento WSDL como se indica a continuación: <webservices>
<webservice-description>
<webservice-description-name>ExampleService</webservice-description-name>
<wsdl-file>META-INF/wsdl/ExampleService.wsdl</wsdl-file>
…
</webservice-description>
</webservices>
El valor que se especifica en el descriptor de despliegue, META-INF/wsdl/ExampleService.wsdl, altera temporalmente el valor de la anotación. Qué hacer a continuación
Configure el descriptor de despliegue webservice.xml. Después de configurar los descriptores de servicios web para su despliegue.