Bueno, este es mi primer artículo técnico, así que supongo que tendrá montones de errores y fallas de estilo. Sugerencias y correcciones bienvenidas.
Creando el Servidor
Lo primero es crear un DispatcherServlet con su correspondiente WebApplicationContext conteniendo los servicios que van a ser expuestos, en el fichero Web Pages/WEB-INF/web.xml de nuestro proyecto.
<servlet>
<servlet-name>xfire</servlet-name>
<servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class>
</servlet>
Ahora añadiremos un servlet-mapping (mapeando /* hacia el servlet XFire declarado arriba)
Sólo nos quedará añadir un bean extra para exponer el servicio usando Xfire. Este bean será añadido en el fichero Web Pages/WEB-INF/xfire-servlet.xml:
<servlet-mapping>
<servlet-name>xfire</servlet-name>
<url-pattern>/xfire/*</url-pattern>
</servlet-mapping>
Vemos la siguiente propiedad: <property name="serviceBean" ref="data"/>. Esta propiedad hace referencia a un bean declarado en Pages/WEB-INF/applicationContext.xml:
<bean name="/Tempo" class="org.codehaus.xfire.spring.remoting.XFireExporter">
<property name="serviceBean" ref="data"/>
<property name="serviceInterface" value="es.usc.time.ITempo"/>
<property name="xfire" ref="xfire"/>
<property name="serviceFactory" ref="xfire.serviceFactory"/>
</bean>
En la clase es.usc.time.Tempo se procesará toda la información que debe tratar el WS.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans public "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<bean id="...";
...
<bean id="data" class="es.usc.time.Tempo"/>
</beans>
XFire se ocupará del resto. Hará una introspección de la interfaz del servicio y generará el WSDL a partir de él. Para información más detallada acerca de la integración entre XFire y Spring echa un vistazo a docs.codehaus.org/display/XFIRE/Spring.
Este es el código fuente de nuestro servicio. Primero, la interfaz:
Esta interfaz es la que deberá ser referida en el archivo xfire-servlet.xml, en la propiedad "serviceInterface". Observa que se ha incluido el nombre completo, incluyendo la ruta dentro del paquete.
package
es.usc.time;
/** @author contremo */
public interface ITempo {
public String agora();
}
El siguiente archivo muestra nuestra clase principal, donde se va a procesar toda la información. Básicamente lo que hace es averiguar cual es la fecha y hora actuales y devolverlo en un String.
Si en lugar de un String quisiéramos enviar un tipo complejo, tendríamos que definirlo como un Bean. Recuerda que debe implementar la interfaz "Serializable", y recuerda también registrarlo en el cliente, o te verás en problemas.
package es.usc.time;
import java.util.Date;
/**@author contremo */
public class Tempo implements ITempo{
/*constructor*/
public Tempo(){}
public String agora(){
return (new Date()).toString();
}
}
Próximamente veremos como crear el cliente.
