git.gumartinm.name Git - SpringWebServicesForFun/.git/blob

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <beans xmlns="http://www.springframework.org/schema/beans"
   3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   4     xmlns:context="http://www.springframework.org/schema/context"
   5     xmlns:sws="http://www.springframework.org/schema/web-services"
   6     xmlns:oxm="http://www.springframework.org/schema/oxm"
   7     xmlns:aop="http://www.springframework.org/schema/aop"
   8     xmlns:util="http://www.springframework.org/schema/util"
   9
  10     xsi:schemaLocation="http://www.springframework.org/schema/beans
  11         http://www.springframework.org/schema/beans/spring-beans.xsd
  12         http://www.springframework.org/schema/context
  13         http://www.springframework.org/schema/context/spring-context.xsd
  14         http://www.springframework.org/schema/web-services
  15         http://www.springframework.org/schema/web-services/web-services.xsd
  16         http://www.springframework.org/schema/oxm
  17         http://www.springframework.org/schema/oxm/spring-oxm.xsd
  18         http://www.springframework.org/schema/util
  19         http://www.springframework.org/schema/util/spring-util.xsd">
  20
  21     <!--
  22         This file is an example about how someone should write code in order to send and
  23         receive data from the Web Services.
  24     -->
  25
  26     <!-- Searches for beans in packages (instead of XML configuration we can use in this way annotations like @Service, @Component, etc, etc)  -->
  27     <context:component-scan base-package="de.spring.webservices"/>
  28
  29     <!--
  30         Three ways of using a marshallers/unmarshallers.
  31
  32         1. No declarar nada en el XML y dejar que Spring lo haga internamente todo por nosotros.
  33         Esto equivale a esta configuracion en XML
  34
  35         <oxm:jaxb2-marshaller id="marshaller" context-path="de.spring.webservices"/>
  36         El context-path Spring supongo que lo rellena automáticamente en base al component-scan declarado arriba.
  37
  38         2. Especificando el context-path para ser escaneado por Spring usando anotaciones. Esto
  39         se hace de este modo:
  40
  41         <oxm:jaxb2-marshaller id="marshaller" context-path="de.spring.webservices.auto"/>
  42         Esto es lo mismo que haría Spring si no declaramos nada en el XML pero así tenemos opción de
  43         de especificar un context-path en concreto.
  44
  45         3. Especificando la implementación concreta del marshaller.
  46         Con esta opción además puedo usar packagesToScan, contest-path si no recuerdo mal tenía problemas
  47         cuando había dos ObjectFactory con el mismo package. Uno está en globalxsds y otro en este proyecto.
  48         De todos modos, probablemente habría que usar un package distinto para lo que hay
  49         en globalxsds (quizás incluso basado en el namespace del xsd) y así podría evitar esta configuración.
  50
  51
  52         <bean id="marshaller" class="org.springframework.oxm.jaxb.Jaxb2Marshaller">
  53                 <property name="packagesToScan" value="de.spring.webservices.auto"/>
  54                 </bean>
  55
  56         NO PUEDO USAR ESTA CONFIGURACION PORQUE SE PRODUCE ESTE ERROR:
  57
  58         Caused by: org.springframework.oxm.UncategorizedMappingException: Unknown JAXB exception;
  59         nested exception is com.sun.xml.internal.bind.v2.runtime.IllegalAnnotationsException: 1 counts of IllegalAnnotationExceptions
  60                 de.spring.webservices.auto.Examples es una interfaz y JAXB no puede manejar interfaces.
  61                         this problem is related to the following location: at de.spring.webservices.auto.Examples
  62
  63                         at org.springframework.oxm.jaxb.Jaxb2Marshaller.convertJaxbException(Jaxb2Marshaller.java:888)
  64
  65                 ESTE ERROR SE PRODUCE PORQUE cxf-codegen-plugin GENERA Examples QUE ES UN inteface @WebService
  66                 maven-jaxb2-plugin NO GENERA ESTOS OBJETOS pero maven-jaxb2-plugin NO ES BUENO PARA GENERAR CLASES
  67                 DESDE WSDLs POR LAS RAZONES EXPLICADAS EN EL pom.xml DEL PROYECTO web-services-spring-jaxb2-client.
  68      -->
  69      <bean id="marshaller" class="org.springframework.oxm.jaxb.Jaxb2Marshaller">
  70         <!--
  71                 contextPath because of Examples autogenerated class, which is an @Weberservice interface.
  72
  73                 cxf-codegen-plugin DOES generate again the objects in web-services-spring-jaxb2-globalxsds :(
  74                 So we MAY NOT scan everything because there is more than one class representing
  75                 the same XML element. :(
  76
  77                 We scan the objects generated in this package.
  78          -->
  79         <property name="contextPath" value="de.spring.webservices.client.auto:name.gumartinm.spring_ws.parent"/>
  80          </bean>
  81
  82
  83
  84     <!-- Required in order to use SOAP 1.2
  85          id="messageFactory" is not a random choice, if you use another name it will not work
  86          (Spring will end up loading SOAP 1.1)
  87     -->
  88     <bean id="messageFactory" class="org.springframework.ws.soap.saaj.SaajSoapMessageFactory">
  89         <property name="soapVersion">
  90             <util:constant static-field="org.springframework.ws.soap.SoapVersion.SOAP_12" />
  91         </property>
  92     </bean>
  93
  94
  95     <!--
  96         ¿Este validador funciona teniendo inheritance en el xsd? (inheritances es una cosa especial
  97         del JAXB2 que estoy usando para generar las clases desde el xsd)
  98         Parece que el unmarshal (que supongo que se hace con el JAXB2 que está en el classpath
  99         debido al tipo de Endpoint que estoy usando, que por cierto no sé cual JAXB2 está cogiendo realmente)
 100         funciona, así que supongo el validador tambien :/
 101         Lo que realmente tampoco sé es si hay alguna relación entre los validadores y JAXB2 :/
 102     -->
 103     <bean id="payloadValidatingInterceptor"
 104         class="org.springframework.ws.client.support.interceptor.PayloadValidatingInterceptor">
 105         <property name="schemas">
 106             <list>
 107                 <!--
 108                         ALWAYS FIRST THE XSD FILES TO BE IMPORTED!!!!!  O.o
 109                         OTHERWISE THE import IN examples.xsd WILL BE SOLVED BY MEANS OF DOWNLOADING THE
 110                         EXTERNAL parent.xsd (USING THE URL LINKED BY THE IMPORT STATEMENT IN examples.xsd)
 111
 112                                 IF YOU DON'T DO THIS, PayloadValidatingInterceptor WILL TRY TO CONNECT TO THE
 113                                 EXTERNAL SERVER WHERE parent.xsd IS LOCATED AND IT WILL FAIL IF BECAUSE SOME
 114                                 REASON YOU DON'T HAVE IN THAT VERY MOMENT NETWORK CONNECTION. SO, DON'T MESS WITH THIS
 115                                 CONFIGURATION.
 116                  -->
 117                  <value>classpath:parent.xsd</value>
 118
 119                  <value>classpath:examples.xsd</value>
 120             </list>
 121         </property>
 122         <property name="validateRequest" value="true"/>
 123         <property name="validateResponse" value="true"/>
 124     </bean>
 125
 126         <!--
 127                 Los errores de validacion se devuelven así:
 128
 129                 <env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope">
 130                    <env:Header/>
 131                    <env:Body>
 132                       <env:Fault>
 133                          <env:Code>
 134                             <env:Value>env:Sender</env:Value>
 135                          </env:Code>
 136                          <env:Reason>
 137                             <env:Text xml:lang="en">Validation error</env:Text>
 138                          </env:Reason>
 139                          <env:Detail>
 140                             <spring-ws:ValidationError xmlns:spring-ws="http://springframework.org/spring-ws">cvc-maxLength-valid: El valor 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' con la longitud = '91' no es de faceta válida con respecto a maxLength '30' para el tipo 'limitedString'.</spring-ws:ValidationError>
 141                             <spring-ws:ValidationError xmlns:spring-ws="http://springframework.org/spring-ws">cvc-type.3.1.3: El valor 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' del elemento 'exam:data' no es válido.</spring-ws:ValidationError>
 142                          </env:Detail>
 143                       </env:Fault>
 144                    </env:Body>
 145                 </env:Envelope>
 146
 147                 El manejador de errores de validación es implementado por AbstractValidatingInterceptor (PayloadValidatingInterceptor)
 148                 luego si quisiéramos loguear los mensaje de error de validación de algún modo especial tendríamos que crear nuestro propio PayloadValidatingInterceptor :(
 149          -->
 150
 151     <!-- Enables us to log custom Fault remote messages. No loguea mensajes de error de validación :( -->
 152     <bean id="customFaultMessageResolver" class="de.spring.webservices.client.CustomFaultMessageResolver">
 153                 <property name="unmarshaller" ref="marshaller"/>
 154         </bean>
 155
 156     <!--
 157     WebServiceTemplate using these strategies by default (see WebServiceTemplate.properties file)
 158
 159     org.springframework.ws.client.core.FaultMessageResolver=org.springframework.ws.soap.client.core.SoapFaultMessageResolver
 160         org.springframework.ws.WebServiceMessageFactory=org.springframework.ws.soap.saaj.SaajSoapMessageFactory
 161         org.springframework.ws.transport.WebServiceMessageSender=org.springframework.ws.transport.http.HttpUrlConnectionMessageSender
 162
 163      -->
 164
 165     <bean id="webServiceTemplate" class="org.springframework.ws.client.core.WebServiceTemplate">
 166         <constructor-arg ref="messageFactory"/>
 167         <property name="marshaller" ref="marshaller" />
 168         <property name="unmarshaller" ref="marshaller" />
 169
 170         <!-- For local deployments change to http://localhost:8080/web-services-spring-cxf-server/spring-ws/example -->
 171         <property name="defaultUri" value="http://gumartinm.name/spring-ws/example"/>
 172
 173         <property name="interceptors">
 174             <list>
 175                 <ref bean="payloadValidatingInterceptor" />
 176             </list>
 177         </property>
 178
 179         <property name="faultMessageResolver" ref="customFaultMessageResolver" />
 180
 181         <property name="messageSenders">
 182                 <list>
 183                         <bean class="de.spring.webservices.client.transport.http.CustomHttpRequestMessageSender" />
 184                 </list>
 185         </property>
 186     </bean>
 187
 188     <!--
 189     Using @Service and @Autowired
 190     We could use just XML configuration, or XML confirguration and @Autowired or as I am doing now @Service and @Autowired.
 191     <bean id="exampleClientService" class="de.spring.webservices.client.ExampleClientService">
 192
 193         @Autowired works even using XML configuration as long as you use context:component-scan
 194         <property name="webServiceTemplate" ref="webServiceTemplate"/>
 195     </bean>
 196     -->
 197
 198 </beans>