{"id":323,"date":"2010-11-25T13:13:00","date_gmt":"2010-11-25T13:13:00","guid":{"rendered":"http:\/\/www.javacodegeeks.com\/2012\/10\/jax-ws-with-spring-and-maven-tutorial.html"},"modified":"2012-10-21T19:21:35","modified_gmt":"2012-10-21T19:21:35","slug":"jaxws-with-spring-and-maven-tutorial","status":"publish","type":"post","link":"https:\/\/www.javacodegeeks.com\/2010\/11\/jaxws-with-spring-and-maven-tutorial.html","title":{"rendered":"JAX\u2013WS with Spring and Maven Tutorial"},"content":{"rendered":"

Spring<\/a> framework provides remoting support for web services via JAX\u2013WS<\/a>, in fact, as stated in Spring<\/a> reference documentation<\/a>, there are three ways of exposing Spring<\/a> POJO services as a JAX\u2013WS<\/a> web services :<\/p>\n

    \n
  1. Exposing Servlet<\/a> \u2013 based web services (suitable for Java EE 5 environments)<\/li>\n
  2. Exporting standalone web services (suitable when utilizing Sun’s JDK 1.6 build\u2013in JAX\u2013WS<\/a> provider)<\/li>\n
  3. Exporting web services using the JAX\u2013WS<\/a> RI’s Spring<\/a> support (similar to the standalone approach, but this time in a Servlet<\/a> environment. Suitable for non \u2013 Java EE environments such as Tomcat<\/a>, embedding the JAX\u2013WS<\/a> RI as part of the web application)<\/li>\n<\/ol>\n

    Selecting one of the three approaches mentioned above depends mainly on your execution environment. Having said that, we will show you how to setup and expose a simple Spring<\/a> service using all of the above approaches.<\/p>\n

    Our preferred development environment is Eclipse<\/a>, so as a prerequisite you must have Eclipse<\/a> with Maven<\/a> support installed. The installation of Maven<\/a> plugin for Eclipse<\/a> is out of the scope of this tutorial and will not be discussed. Nevertheless you will need the following components :<\/p>\n

      \n
    1. Eclipse<\/a> from here<\/a><\/li>\n
    2. Maven<\/a> Plugin for Eclipse<\/a> from here<\/a><\/li>\n<\/ol>\n

      We will be using Eclipse<\/a> Galileo, \u201em2eclipse\u201c Maven<\/a> Integration for Eclipse<\/a> Plugin version 0.10.0 and Spring<\/a> version 3.0.1 for this tutorial.<\/p>\n

      Lets begin,<\/p>\n

        \n
      1. Create a new Maven project, go to File ? Project ? Maven ? Maven Project<\/li>\n
      2. In the \u201eSelect project name and location\u201c page of the wizard, make sure that \u201eCreate a simple project (skip archetype selection)\u201c option is unchecked<\/strong>, hit \u201eNext\u201c to continue with default values<\/li>\n
      3. In the \u201eSelect an Archetype\u201c page of the wizard, select \u201eNexus Indexer\u201c at the \u201eCatalog\u201c drop down list and after the archetypes selection area is refreshed, select the \u201ewebapp-javaee6\u201c archetype from \u201eorg.codehaus.mojo.archetypes\u201c to use. You can use the \u201efilter\u201c text box to narrow search results. Hit \u201eNext\u201c to continue<\/li>\n
      4. In the \u201eEnter an artifact id\u201c page of the wizard, you can define the name and main package of your project. We will set the \u201eGroup Id\u201c variable to \u201ecom.javacodegeeks\u201c and the \u201eArtifact Id\u201c variable to \u201ejaxwsspring\u201c. The aforementioned selections compose the main project package as \u201ecom.javacodegeeks.jaxwsspring \u201c and the project name as \u201ejaxwsspring\u201c. Hit \u201eFinish\u201c to exit the wizard and to create your project<\/li>\n<\/ol>\n

        Let’s recap a few things about the Maven<\/a> Web project structure<\/p>\n

          \n
        1. \/src\/main\/java folder contains source files for the dynamic content of the application<\/li>\n
        2. \/src\/test\/java folder contains all source files for unit tests<\/li>\n
        3. \/src\/main\/webapp folder contains essential files for creating a valid web application, e.g. \u201eweb.xml\u201c<\/li>\n
        4. \/target folder contains the compiled and packaged deliverables<\/li>\n
        5. The \u201epom.xml\u201c is the project object model (POM) file. The single file that contains all project related configuration.<\/li>\n<\/ol>\n

          One thing to notice here is that we have chosen to utilize the Java EE6<\/strong><\/i> compatible Maven<\/a> project archetype. Our selection is made on purpose so as to be easy to demonstrate all available approaches mentioned above. Nevertheless you can follow this tutorial and expose your Spring<\/a> services as JAX\u2013WS<\/a> services even if you utilize a different environment (such as a standalone Servlet<\/a> environment e.g. Apache Tomcat<\/a> or a Java EE 5 compatible application server e.g. JBoss<\/a> Application Server).<\/p>\n

          In order to properly use Spring<\/a> at runtime, we must provide all necessary libraries to the web application. Open the graphical editor of your \u201epom.xml\u201c and perform the following changes :<\/p>\n

            \n
          1. Locate the \u201eProperties\u201c section at the \u201eOverview\u201c page of the POM editor and perform the following changes :<\/li>\n