Another Random Developer Blog

This short blog entry will show you how easily you can integrate JAX-WS into a Spring 2 Project. The example sourcecode is depending on my previous blog How to modify JAX-WS SOAP-Messages and i am using NetBeans 6.1.


Prerequisites

Download the JAX-WS commons and XBean.


Transform the SOAP Web Services Project into a Spring Project

First open the Non-Spring-Project “How to modify JAX-WS SOAP-Messages“, switch to the project-properties and add the XBean, JAX-WS commons and Spring Framework 2.5 JAR-files.




You can see in this picture which JAR-files have to be included in the project:




Now you have to create the Spring Configuration file. Create the new XML-file: /WEB-INF/applicationContext.xml. If you are using NetBeans 6.1, navigate to File->New File->Spring Framework->Spring XML Configuration File.




Replace the content with this:

applicationContext.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ws="http://jax-ws.dev.java.net/spring/core"
xmlns:wss="http://jax-ws.dev.java.net/spring/servlet"
xsi:schemaLocation="
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://jax-ws.dev.java.net/spring/core http://jax-ws.dev.java.net/spring/core.xsd
http://jax-ws.dev.java.net/spring/servlet http://jax-ws.dev.java.net/spring/servlet.xsd">
    <ws:service id="SOAPservice" impl="eu.jdevelop.soapwebservices.service.ServiceImpl">
        <ws:handlers>
            <ref bean="myHandler" />
        </ws:handlers>
    </ws:service>

    <wss:bindings id="jax-ws.http">
        <wss:bindings>
            <wss:binding url="/soapwebservices" service="#SOAPservice"/>
        </wss:bindings>
    </wss:bindings>

    <bean id="myHandler" class="eu.jdevelop.soapwebservices.handler.ServerSOAPHandler" />
</beans>

Modify the web.xml to load the Spring Configuration file.

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
    <display-name>SpringWeb</display-name>
    <welcome-file-list>
        <welcome-file>index.html</welcome-file>
        <welcome-file>index.htm</welcome-file>
        <welcome-file>index.jsp</welcome-file>
        <welcome-file>default.html</welcome-file>
        <welcome-file>default.htm</welcome-file>
        <welcome-file>default.jsp</welcome-file>
    </welcome-file-list>
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <servlet>
        <servlet-name>jaxws-servlet</servlet-name>
        <servlet-class>com.sun.xml.ws.transport.http.servlet.WSSpringServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>jaxws-servlet</servlet-name>
        <url-pattern>/soapwebservices</url-pattern>
    </servlet-mapping>
</web-app>

Open the file “ServiceImpl.java” and remove this line:

@HandlerChain(name = "ServerSOAPHandler", file = "serversoaphandler.xml")

You don’t need this annotation anymore, Spring is injecting the “ServerSOAPHandler.java” into the ServiceImpl.java.



This application is now Spring-enabled. Enjoy the benefits of JAX-WS with Spring 2.

Technorati Tags: Java, jax-ws, NetBeans, soap, soaphandler, Spring, web services

Tags: Java, jax-ws, NetBeans, soap, soaphandler, Spring, web services

Trackback URI | Comments RSS