Document use of WsdlDefinition when not using MessageDispatcherServlet [SWS-527]

[gregturn]

Kenny MacLeod opened SWS-527 and commented

A lot of the logic for handling publishing of WSDL using WsdlDefinition beans is handled in the MessageDispatcherServlet. In cases where this servlet is not being used, this makes it quite awkward to use the WsdlDefinition stuff.

Specifically, MessageDispatcherServlet has an explicit bit of code hor dealing with WSDL requests, and it doesn't use the HandlerMapping framework - it intercepts the request before getting that far. When using the vanilla DispatcherServlet (using the guidelines in the ref docs), all requests are routed to the MessageDispatcher, which knows nothing about WSDL requests.

Can either either provuide an easier mechanism for handling this, or improve the ref docs to demonstrate how to publish WSDL when using DispatcherServlet?

---

Affects: 1.5.7

Referenced from: commits 2884472

[gregturn]

Arjen Poutsma commented

Actually, most of the logic for dealing with WSDLs is in the WsdlDefinitionHandlerAdapter , so you need to wire that up. In a plain DispatcherServlet scenario, you can map all *.wsdl requests to the WsdlDefinition beans like so:

<beans>

    <bean class="org.springframework.ws.transport.http.WebServiceMessageReceiverHandlerAdapter"/>
    <bean class="org.springframework.ws.transport.http.WsdlDefinitionHandlerAdapter"/>

    <bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
        <property name="mappings">
           <props>
             <prop key="*.wsdl">myServiceDefinition</prop>
           </props>
        </property>
        <property name="defaultHandler" ref="messageDispatcher"/>
    </bean>

    <bean id="messageDispatcher" class="org.springframework.ws.soap.server.SoapMessageDispatcher"/>

    <bean id="myServiceDefinition" class="org.springframework.ws.wsdl.wsdl11.SimpleWsdl11Definition">
       <prop name="wsdl" value="/WEB-INF/myServiceDefintion.wsdl"/>
    </bean>

</beans>

See http://static.springframework.org/spring/docs/2.5.x/reference/mvc.html#mvc-handlermapping-urlhandlermapping for more info.

[gregturn]

Kenny MacLeod commented

Ah, that's pretty easy, right enough. Perhaps a line or two in the Spring-WS docs?

[gregturn]

Arjen Poutsma commented

That's a good idea. I'll re-open, and change the title to something more fitting.

[gregturn]

Arjen Poutsma commented

Added documentation.

[gregturn]

Arjen Poutsma commented

Closing old issues