JAX-WS

Links

https://jax-ws-commons.dev.java.net/jaxws-maven-plugin/ JAX-WS Maven Plugin
Using JAX-WS with Maven, Enterprise Java Technologies Tech Tips

Project

Dependencies

<dependencies>
  <dependency>
    <groupId>com.sun.xml.ws</groupId>
    <artifactId>jaxws-rt</artifactId>
    <version>2.1.3</version>
    <scope>compile</scope>
  </dependency>
</dependencies>

Repositories

<repositories>
  <repository>
    <id>maven-repository.dev.java.net</id>
    <name>Java.net Repository for Maven 1</name>
    <url>http://download.java.net/maven/1/</url>
    <layout>legacy</layout>
  </repository>
  <repository>
    <id>maven2-repository.dev.java.net</id>
    <name>Java.net Repository for Maven 2</name>
    <url>http://download.java.net/maven/2/</url>
  </repository>
</repositories>
<pluginRepositories>
  <pluginRepository>
    <id>maven2-repository.dev.java.net</id>
    <url>http://download.java.net/maven/2/</url>
  </pluginRepository>
</pluginRepositories>

Configuration

Add the following to the pom.xml updating the packageName and wsdlUrl as required:

<build>
  <plugins>
    <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>jaxws-maven-plugin</artifactId>
      <executions>
        <execution>
          <goals>
            <goal>wsimport</goal>
          </goals>
          <configuration>
            <wsdlUrls>
              <wsdlUrl>
             http://winamini.promotiondemo.com/smsinbound/smsinbound.asmx?wsdl
              </wsdlUrl>
            </wsdlUrls>
            <packageName>com.sample.jaxws.client
            </packageName>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

Usage

Just run the package goal to build the stub classes… or you can run jaxws:wsimport:

mvn jaxws:wsimport

Note: I didn’t continue with these notes because I ended up using the Axis 2 - wsdl2code plugin, mvn-plugin-axis2-wsdl2code.

Issues

Class Loading Issues

See the solution for the Surefire plugin, mvn-plugin-surefire.

java.lang.LinkageError: loader constraints violated when linking javax/xml/namespace/QName class

Ignoring SOAP port “SMSInboundSoap12”: it uses non-standard SOAP 1.2 binding

No solution… (to this issue). To solve the problem I used Axis 2. For more information see Axis 2 - wsdl2code plugin, mvn-plugin-axis2-wsdl2code.

wsHttpDualBinding - a non-interoperable binding

Problems using JAX-WS 2.1 and JAXB 2.1 with JDK 6

Exception in thread "main" java.lang.LinkageError: JAXB 2.0 API is being loaded
  from the bootstrap classloader, but this RI (from jar:file:/D:/work/axws-ri/lib/jaxb-impl.jar!
  /com/sun/xml/bind/v2/model/impl/ModelBuilder.class) needs 2.1 API.
Use the endorsed directory mechanism to place jaxb-api.jar in the bootstrap classloader.
  (See http://java.sun.com/j2se/1.5.0/docs/guide/standards/)

Links

Solution

Copy version 2.1 of jaxb-api.jar and jaxws-api-2.1.jar to $JRE_HOME/lib/endorsed.

copy c:\Users\Patrick\.m2\repository\javax\xml\bind\jaxb-api\2.1\jaxb-api-2.1.jar \tools\Java\jre1.6.0_03\lib\endorsed\
copy c:\Users\Patrick\.m2\repository\javax\xml\ws\jaxws-api\2.1\jaxws-api-2.1.jar \tools\Java\jre1.6.0_03\lib\endorsed\

Note:

Check which JRE you are using! I assumed my build environment was using C:\\tools\\Java\\jre1.6.0_03, but it was not. It was, in fact, using the JRE in my JDK i.e. C:\\tools\\Java\\jdk1.6.0_03\\jre\.
You will probably have to create the lib/endorsed folder. On my workstation it was C:\\tools\\Java\\jdk1.6.0_03\\jre\\lib\\endorsed\.