Spring Web Services
Spring Web Services (Spring-WS) es un producto de Spring Framework para facilitar la creación de servicios web basados en el intercambio de documentos (document driven).
Spring-WS Se basa en servicios en los cuales primero se establece un contrato y luego se implementan (contract first), evitando atar al contrato como sucede en los casos en los cuales se genera el mismo a partir de las clases java.
Contenido
Las principales características de SpringWS
Facilita aplicar las mejores practicas para la creación de servicios web Facilidad para distribuir los pedidos xml a través de diferentes tipos de mapeos Soporte para varias librerias de manejo de XML (DOM, SAX, StAX, JDOM, dom4j, XDOM) Soporte para mapeo de xml a objetos (Castor, JiBX, JAXB, XStream).
Interceptores
Si usamos org.springframework.ws.server.endpoint.mapping.PayloadRootQNameEndpointMapping para hacer el binding de los endpoints podemos agregar varios interceptores. Solo hay que definirlos dentro de la lista de interceptores que tiene como opción la clase.
Ejemplo:
<bean class="org.springframework.ws.server.endpoint.mapping.PayloadRootQNameEndpointMapping">
<property name="mappings">
<props>
<prop key="{http://dosideas.com/oc/schemas}OrdenDeCompraRequest">ordenDeCompraMarshallingEndPoint</prop>
<prop key="{http://dosideas.com/oc/schemas}ConsultaPrecioRequest">consultaPrecioMessageEndpoint</prop>
</props>
</property>
<property name="interceptors">
<list>
<bean class="org.springframework.ws.server.endpoint.interceptor.PayloadLoggingInterceptor"/>
<ref bean="validatingInterceptor"/>
</list>
</property>
</bean>
Interceptor de validaciones
El interceptor de validaciones es una herramienta muy útil, que nos permite verificar tanto el request como el response del web service. Verifica tanto el esquema de los xmls como las restricciones que tiene cada uno de los elementos de los xsd. Si alguna de las validaciones no se cumple devuelve un fault si es un request, y genera un warning en el log si es un response.
Ejemplo:
<bean id="validatingInterceptor"
class="org.springframework.ws.soap.server.endpoint.interceptor.PayloadValidatingInterceptor"> <property name="xsdSchemaCollection" ref="schemaCollection" /> <property name="validateRequest" value="true"/> <property name="validateResponse" value="true"/>
</bean> Este bean hace referencia a los esquemas(.xsd) y al interpretarlos puede saber la estructura y restricciones de los request/response.
Ejemplo:
<bean id="schemaCollection"
class="org.springframework.xml.xsd.commons.CommonsXsdSchemaCollection">
<property name="xsds">
<list>
<value>/WEB-INF/contratoDeDatos.xsd</value>
</list>
</property>
<property name="inline" value="true"/>
</bean>
Si el servicio tiene más de una operación, existirán varios xsd. Actualmente existe un error al querer ingresar más de un xsd(el interceptor ve solo el primero). Para salvar este error se aconseja generar un nuevo .xsd que incluya los definidos para cada operación.
Ejemplo de contratoDeDatos.xsd agrupador:
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema targetNamespace="http://www.movistar.com.ar/ws/schema/cater"
elementFormDefault="qualified"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://www.movistar.com.ar/ws/schema/cater">
<xsd:include schemaLocation="validarCentroEmisor.xsd"></xsd:include> <xsd:include schemaLocation="agenteUsuario.xsd"></xsd:include> <xsd:include schemaLocation="validarFactura.xsd"></xsd:include>
</xsd:schema>
Extendiendo interceptor de validaciones
Si quisieramos que el interceptor de validaciones devolviera un fault como respuesta, podemos extender de la clase de Spring-WS (PayloadValidatingInterceptor) y sobreescribir el metodo handleResponseValidationErrors con el mismo código que utiliza Spring-WS para manejar los errores en los requests, que quedaría de la siguiente forma:
@Override
protected boolean handleResponseValidationErrors(MessageContext messageContext, SAXParseException[] errors) {
for (int i = 0; i < errors.length; i++) {
logger.warn("XML validation error on response: " + errors[i].getMessage());
}
if (messageContext.getResponse() instanceof SoapMessage) {
SoapMessage response = (SoapMessage) messageContext.getResponse();
SoapBody body = response.getSoapBody();
SoapFault fault = body.addClientOrSenderFault(getFaultStringOrReason(), getFaultStringOrReasonLocale());
if (getAddValidationErrorDetail()) {
SoapFaultDetail detail = fault.addFaultDetail();
for (int i = 0; i < errors.length; i++) {
SoapFaultDetailElement detailElement = detail.addFaultDetailElement(getDetailElementName());
detailElement.addText(errors[i].getMessage());
}
}
}
return false;
}
