Al iniciar un archivo WSDL existente (Web Services Description
Language), puede utilizar un método ascendente para desarrollar servicios web basados en el modelo de programación JAX-WS (Java™ API
for XML-Based Web Services).
Antes de empezar
Best practice: IBM®
WebSphere Application Server soporta el modelo de programación JAX-WS (Java API for XML-Based Web Services)
y el modelo de programación JAX-RPC (Java API
for XML-based RPC). JAX-WS es la siguiente generación del modelo de programación de servicios que amplía la base proporcionada por el modelo de programación JAX-RPC.
Con el modelo de programación JAX-WS estratégico, se
simplifica el desarrollo de clientes y servicios web ya que se da soporte
a un modelo de anotación basado en estándares. Aunque el modelo de
programación JAX-RPC y las aplicaciones siguen recibiendo soporte, puede
beneficiarse de la facilidad de implementación del modelo de programación
JAX-WS para desarrollar nuevas aplicaciones y clientes de servicios
web.best-practices
Localice el archivo WSDL que define el servicio web que desea implementar.
Puede desarrollar un archivo WSDL
u obtenerlo de un servicio web existente mediante correo electrónico,
bajándolo o a través de un URL (Uniform Resource Locator).
Acerca de esta tarea
Para desarrollar servicios web basándose en el modelo de programación de
JAX-WS, puede utilizar un enfoque de desarrollo ascendente, cuando empiece desde
JavaBeans
o enterprise beans, o puede utilizar un enfoque de desarrollo descendente, cuando empiece
con un archivo WSDL (Web Services Description Language) existente. Esta tarea describe los pasos para el método de desarrollo en sentido descendente.
- Consideraciones para el uso de JavaBeans
- Los JavaBeans que se exponen como servicios web JAX-WS sólo están soportados en un transporte HTTP.
- Los JavaBeans pueden
utilizar CDI (inyección de dependencias y contextos). Tenga en cuenta que no se admite la inyección de constructores.
- Consideraciones para el uso de enterprise beans
- El enterprise bean debe ser un bean de sesión sin estado o singleton.
- Los enterprise beans que se exponen como servicios web JAX-WS deben estar empaquetados en módulos
EJB 2.1 o EJB 3.0 o superiores.
- Las aplicaciones de servicio web JAX-WS que contienen enterprise beans se deben desplegar con el mandato endptEnabler.
- Los servicios web JAX-WS que utilizan enterprise beans sólo están soportados en un transporte HTTP
o JMS (Java Message
Service).
- Los enterprise bean pueden utilizar CDI. Tenga en cuenta que no se admite la inyección de constructores.
Procedimiento
- Configuración de un entorno de desarrollo para servicios web. No tiene que configurar un entorno de desarrollo, si utiliza Rational Application Developer.
- Desarrolle artefactos
Java para aplicaciones JAX-WS utilizando la herramienta de línea de mandatos wsimport. La herramienta wsimport procesa un archivo WSDL y genera los artefactos Java portátiles que se utilizan para crear un servicio web.
- (Opcional) Habilite MTOM para servicios Web JAX-WS. Puede utilizar el Mecanismo de Optimización de Transmisión de Mensaje SOAP (MTOM) para optimizar la transmisión de accesorios binarios, como imágenes o archivos junto con solicitudes de servicios web.
- (Opcional) Aplique la conformidad con los enlaces WSDL
en servicios Web JAX-WS. Puede utilizar RespectBindingFeature para controlar si es necesaria una implementación de JAX-WS para
respetar el contenido de un wsdl:binding asociado con un punto final.
- (Opcional) Desarrolle y configure un descriptor de despliegue webservices.xml
para aplicaciones JAX-WS. 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.
- Complete la implementación de la aplicación de servicio web JAX-WS.
- (Opcional) Personalice los patrones de URL en el archivo web.xml. Cuando los JavaBeans se exponen como puntos finales JAX-WS, puede personalizar opcionalmente los patrones de URL dentro del descriptor de despliegue web.xml contenido en el archivo WAR (Web Archive).
- Ensamble los artefactos del servicio web.
- Despliegue el archivo EAR en el servidor de aplicaciones. Ahora, puede desplegar el archivo
EAR que ha sido configurado y habilitado para los servicios web en el servidor de aplicaciones.
- Pruebe el servicio web para asegurarse de que el servicio funciona con el servidor de aplicaciones.
Resultados
Ha creado un servicio web JAX-WS a partir de un archivo WSDL existente.