Spring Web Service

Spring Framework tiene un soporte para poder invocar web services de forma muy simple.
A continuación vamos a ver un ejemplo concreto invocando a un Web Service de prueba.

El web service HolaMundo

Supongamos que tenemos un web service funcionando, con la siguiente operación:
decirHola(nombre : String) : String
De este web service, por supuesto, conocemos la URL del WSDL.

Invocando al web service con Spring

Acceder a un web service con Spring implica programar una única interfaz, que será nuestra interfaz de negocio que representará las operaciones del web service.
El resto es configuración, asociando dicha interfaz al web service que queremos consumir.

La interfaz

La interfaz HolaMundo será entonces muy simple:
package com.dosideas.ws.business;
 
public interface HolaMundoBo {
    public String decirHola(String nombre);
}
Eso será todo lo que programaremos para consumir a nuestro web service.

La configuración

Claro que, falta la magia de la configuración. Deberemos declarar nuestro bean para ser consumible en un archivo de configuración de Spring.
 id="business.HolaMundoBo" 
    class="org.springframework.remoting.jaxrpc.JaxRpcPortProxyFactoryBean">
     name="serviceInterface"
        value="com.dosideas.ws.business.HolaMundoBo" />
     name="wsdlDocumentUrl"
        value="http://localhost:8080/HolaMundoWS/HolaMundoWebServiceService?wsdl" />
     name="namespaceUri"
        value="http://ws.demo.dosideas.com/" />
     name="serviceName"
        value="HolaMundoWebServiceService" />
     name="portName"
        value="HolaMundoWebServicePort" />
     name="serviceFactoryClass"
        value="org.apache.axis.client.ServiceFactory"/>
El atributo serviceInterface es la interfaz de negocio que deberá implementar Spring, y es la interfaz que escribimos en el punto anterior.
El atributo wsdlDocumentUrl es justamente la URL del WSDL.
Los atributos namespaceUriserviceName y portName son los datos necesarios para invocar un web service cualquiera, y salen del mismo WSDL.

Invocando al web service

A partir de aquí, invocar al web service es exactamente igual que invocar a cualquier otra clase. Supongamos entonces el método de un test:
public void testHolaMundo() {
    HolaMundoBo instance = (HolaMundoBo) ApplicationContext.getBean("business.HolaMundoBo");
    String result = instance.decirHola("Zim");
    assertEquals("Hola, Zim", result);
}

Sobre los tipos de Web Services

Existen dos tipos de web services: RPC y Document.
Si bien el nombre de la clase no parece indicarlo, es posible usar el método arriba indicado para acceder a web services Document.

Si el web service contiene objetos no comunes (DTOs propios, por ejemplo) será necesario declarar serializadores para dichos DTO. El subcapítulo 17.5.3 Register Bean Mappings tiene un ejemplo de cómo registrar mapeos propios.

No hay comentarios:

Publicar un comentario en la entrada