Puede utilizar una tarea Ant en lugar de los asistentes de servicios web para generar un servicio web Java™ para el entorno de ejecución JAX-WS de IBM® WebSphere. Las tareas Ant dan soporte al desarrollo de servicios web ascendente y descendente.
Antes de empezar
Antes de crear un servicio web, debe cumplir los siguientes requisitos previos:
- Cree un servidor y un proyecto web para el servicio web: Creación de un servidor WebSphere habilitado para JAX-WS
- Importe la tarea Ant y los archivos de propiedades al espacio de trabajo: Importación de archivos Ant para el servicio web JAX-WS
- Personalice los archivos de propiedades Ant para el servicio web:
- Cree o importe los archivos en una carpeta del proyecto web que ha creado, según el tipo de servicio web que desee crear:
- Si desea crear un servicio ascendente, cree o importe un bean en la carpeta src
- Si desea crear un servicio descendente, localice o cree un archivo WSDL, o importe uno al proyecto que ha creado.
Acerca de esta tarea
Para crear el servicio web, modifique el archivo de propiedades Ant del servicio. El nombre del archivo de propiedades Ant depende del tipo de servicio web que desee crear:
- Si desea crear un servicio ascendente, el nombre del archivo de propiedades Ant es was_jaxws_bujava.properties.
- Si desea crear un servicio descendente, el nombre del archivo de propiedades Ant es was_jaxws_tdjava.properties.
- Si desea crear un cliente, el nombre del archivo de propiedades Ant es was_jaxws_client.properties.
Procedimiento
Ejecute la tarea Ant: - Si desea ejecutar la tarea en el espacio de trabajo del producto:
- Pulse con el botón derecho el archivo XML de generación de servicios web importado y seleccione .
- En el recuadro de diálogo, pulse la pestaña JRE y seleccione Ejecutar en el JRE mismo que el espacio de trabajo.
- Pulse Aplicar y, a continuación, Ejecutar.
Una vez generado el servicio web, la consola o la línea de mandatos muestra un mensaje
Build Successful.
Resultados
Cuando se genera el servicio web, se crean los siguientes archivos dependiendo de las opciones seleccionadas y del tipo de servicio web generado:
- Descendente: la interfaz de punto final de servicio (SEI). La SEI es la representación Java anotada del archivo WSDL para el servicio web. Esta interfaz se utiliza para implementar puntos finales de JavaBeans o crear instancias de cliente de proxy dinámico. Las referencias de los tipos de datos están en la SEI.
- Ascendente: la clase delegada. Esta clase es una envoltura que contiene todos los métodos del bean y la anotación JAX-WS que el entorno de ejecución reconoce como un servicio web. Si ya tiene un bean con la anotación @javax.jws.WebService antes de ejecutar la tarea Ant, este bean se utiliza tal cual y no se añaden nuevas anotaciones.
- Clases de envoltura de solicitud/respuesta/excepción.
Consejo: El archivo
wsant.bat se instala en el directorio
bin del producto. En algunos sistemas, este directorio puede ser de sólo lectura. En estos casos, la tarea Ant no puede crear la salida y la creación del servicio web falla. Hay dos formas de corregir este problema:
- Establezca la variable PATH para que apunte a la carpeta bin, cambie a un directorio donde tenga permisos de escritura y ejecute el script en él.
- Copie el archivo wsant.bat en un directorio modificable.