La API de Java™ para servicios web basados en XML (JAX-WS) es el modelo de programación de servicios web de próxima generación. Utilizando JAX-WS, el desarrollo de clientes y servicios web se simplifica con una mayor independencia de la plataforma para las aplicaciones Java mediante el uso de proxies dinámicos y anotaciones Java.
Habilitación del entorno de ejecución JAX-WS de WebSphere
Puede crear clientes y servicios web Java descendentes o ascendentes. La generación de servicios web EJB utilizando el entorno de ejecución JAX-WS sólo está soportada por WebSphere Application Server V7.0 y posteriores, y WebSphere Application Server Liberty Profile V8.5.5 y posteriores.
El tiempo de ejecución de JAX-WS está habilitado de forma predeterminada en WebSphere Application Server V7.0 y posteriores. Cuando crea proyectos web, siempre que seleccione la configuración predeterminada para su versión de WebSphere Application Server, se seleccionan las facetas correctas.
Artefactos de servicios web JAX-WS
Un servicio web JAX-WS está contenido en un archivo de archivador web (WAR) o un módulo WAR dentro de un archivo de archivador empresarial (EAR). Un archivo WAR habilitado para JAX-WS contiene:
- Un archivo WEB-INF/web.xml.
- El archivo web.xml no contiene elementos de servlet o correlación de servlets. El tiempo de ejecución de WebSphere Application Server los define dinámicamente mientras se carga el módulo.
- Clases anotadas que implementan los servicios web, que están contenidas en el módulo de aplicación.
- Las clases anotadas deben contener, como mínimo, una clase de implementación de servicio web que incluya la anotación @javax.jws.WebService. La definición y la especificación de las anotaciones relacionadas con los servicios web las proporcionan
las especificaciones JAX-WS y JSR-181. Las clases de implementación de servicios web
pueden existir en el directorio WEB-INF/classes o en un archivo JAR (Java Archive)
contenido en el directorio WEB-INF/lib del archivo WAR.
- Los documentos WSDL (lenguaje de descripción de servicios web) que describen los servicios web que están contenidos en el módulo de aplicación [opcional].
- De manera opcional, puede incluir documentos WSDL en el empaquetado de la
aplicación JAX-WS. Si el documento WSDL de un determinado servicio web se omite, el entorno de ejecución de WebSphere Application Server crea la definición WSDL dinámicamente a partir de las anotaciones que están contenidas en las clases de implementación de servicio web. Debe incluir la anotación @javax.jws.WebService y, de manera opcional, las anotaciones @WebMethod, @WebParam, @WebResult y @SOAPBinding si el documento WSDL se omite.