Maven WebService

Introducción

El Eclipse junto con el Maven nos ofrece una opción para la creación de clientes WebServices(WS), los cuales nos proveen de las herramientas necesarias para consumir WS en el entorno Java, todo ésto se explica en el desarrollo de la página.

Creación de Clientes Web Services (WS) con Maven

Utilizando una aplicación de ejemplo

Para poder crear un cliente WS con Maven se puede utilizar/clonar el repositorio laboratorio que se encuentra en el repositorio git.

Posicionarse en la carpeta donde deseamos clonar el proyecto, luego ejecutar en consola el siguiente comando:

$ env GIT_SSL_NO_VERIFY=true git clone 'https://git.setics.gov.py/laboratorio/.git'
Cloning into 'laboratorio'...
$ ls laboratorio/
autenticacion  mbohapeWSClient  tekoporu-se-standalone  tekoporu-shiro  tekoporu-wsimport

Con ésto ya tenemos todo el repositorio de laboratorio.

Ir a Eclipse e Importar (File => Import => Existing Maven Project => Luego click en Next) y elegir el tekoporu-wsimport, que es el proyecto en el cuál se estarán creando las clases para poder consumir un web service.

Configuración del pom.xml

La estructura del archivo pom.xml es la siguiente:

<source lang="xml"><?xml version="1.0" encoding="UTF-8"?> <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

<modelVersion>4.0.0</modelVersion>

<groupId>py.gov.senatics.sii</groupId> <artifactId>prueba-ws</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging>

<name></name> <description></description> <url></url>

<parent> <groupId>org.ticpy.tekoporu</groupId> <artifactId>tekoporu-minimal-parent</artifactId> <version>2.2.2-SNAPSHOT</version> </parent>

<dependencies> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> </dependency>

<dependency> <groupId>org.ticpy.tekoporu</groupId> <artifactId>tekoporu-se</artifactId> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> </dependency> <dependency> <groupId>com.sun.xml.ws</groupId> <artifactId>jaxws-rt</artifactId> <version>2.2</version> </dependency> </dependencies>

<repositories> <repository> <id>maven.ticpy.org</id> <url>http://maven.ticpy.org/repository/release</url> </repository>

<repository> <id>maven2-repository.dev.java.net</id> <name>Java.net Repository for Maven</name> <url>http://download.java.net/maven/2</url> </repository> </repositories>

<build> <plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>jaxws-maven-plugin</artifactId> <version>1.12</version> <configuration> <extension>true</extension> <sourceDestDir>src/main/java</sourceDestDir> <packageName>py.gov.senatics.sii.ws.proxy</packageName> </configuration> <dependencies> <dependency> <groupId>com.sun.xml.bind</groupId> <artifactId>jaxb-xjc</artifactId> <version>2.2.2</version> </dependency> <dependency> <groupId>com.sun.xml.ws</groupId> <artifactId>jaxws-rt</artifactId> <version>2.1.4</version> </dependency> </dependencies> </plugin> </plugins> </build>

</project> </source>

Agregando la funcionalidad a un proyecto existente que utiliza tekoporu

En caso de que ud. quiera agregar esta funcionalidad a un proyecto suyo ya existente que utilice tekoporu, fíjese en los comentarios de los agregados en el pom.xml

Generando el cliente

Crear un directorio llamado wsdl en el directorio src, los archivos WSDL irán allí. El plugin de Maven realiza la búsqueda para los archivos que coincidan con *.wsdl en éste directorio.

Obtener un WSDL válido y guardarlo en src/wsdl(carpeta anteriormente creada)

Para generar todo lo que se necesita y así poder consumir el web service, click derecho sobre el proyecto(en éste caso como muestra la imagen anterior prueba) => Run As => Maven Build... (Elegir la opción que tiene al final puntos suspensivos), aparecerá la siguiente ventana:

En la pestaña Main sección Goals escribir el siguiente comando

 jaxws:wsimport 

Luego click en Run

En consola la salida debe ser algo parecido a ésto:

Si todo fue bien entonces se tuvieron que haber creado las clases necesarias para consumir el web service dentro del <packageName></packageName> que definimos en el pom.xml

Observación

Si por alguna razón deseamos volver a generar dichas clases, el Maven genera automáticamente dentro de la carpeta target un subdirectorio en modo bandera jaxws, la misma deberá ser borrada(Ver imagen) y luego seguir el mismo procedimiento Generando el cliente

Ir al inicio