Stupid Question: Where the heck can I download JAX-WS?

[Philippe Desrosiers]

I've ready it's included with J2SE 1.6, but Ant still can't find the proper class. The only place I can find for downloads gives me a jar file with a single class in it (Main.class).

I'm trying to run the <wsimport> task in ANT (within Eclipse), using the following taskdef:

<taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport" classpath="${ant.classpath}" />

Obviously, the necessary Jax-ws libs are not in the classpath. If they're included with J2SE 1.6, where can I find them?

thanks!

[Philippe Desrosiers]

Alright, I figured it out. For the curious: Just run the jar. It launches some sort of license agreement / download manager, and downloads the libraries you'll actually need.

NEXT PROBLEM: The code generated by <wsimport> contains compilation errors (JAX-WS 1.5 On JDK6). Sample code:

    /**
     * 
     * @param features
     *     A list of {@link javax.xml.ws.WebServiceFeature} to configure on the proxy.  Supported features not in the <code>features</code> parameter will have their default values.
     * @return
     *     returns CustomerWSSoap
     */
    @WebEndpoint(name = "CustomerWSSoap")
    public CustomerWSSoap getCustomerWSSoap(WebServiceFeature... features) {
        return super.getPort(new QName("http://www.foo.com/services/", "CustomerWSSoap"), CustomerWSSoap.class, features);
    }

When I try to compile this, ANT throws the following:

    [javac] C:\projects\ngb-admin\src\gensrc\jaxws\com\ngb\services\customer\CustomerWS.java:68: cannot find symbol
    [javac] symbol  : method getPort(javax.xml.namespace.QName,java.lang.Class<com.ngb.services.customer.CustomerWSSoap>,javax.xml.ws.WebServiceFeature[])
    [javac] location: class javax.xml.ws.Service
    [javac]         return super.getPort(new QName("http://www.foo.com/services/", "CustomerWSSoap"), CustomerWSSoap.class, features);
    [javac]                     ^

The superclass for CustomerWS is javax.xml.ws.Service, and the getPort method looks like this:

  public <T> T getPort(QName portName,
		                 Class<T> serviceEndpointInterface)
  {
      return delegate.getPort(portName, serviceEndpointInterface);
  }

Which seems a little strange to me, given that javax.xml.ws.Service isn't a Parameterized class. But then again I don't know much about Generics. Even without the fancy Generics though, it's obvious the JAX-WS generated code is calling a method with three parameters, that doesn't happen to exist. Do I have the wrong version of something?

HELP!

[Philippe Desrosiers]

All right, I got around that by commenting out the offending method. Now, when I deploy my application, and try to hit a web service, I get the following:

java.lang.LinkageError: JAXB 2.0 API is being loaded from the bootstrap classloader, but this RI (from jar:file:/C:/Program%20Files/Apache%20Software%20Foundation/Tomcat%206.0/webapps/admin/WEB-INF/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/)
	com.sun.xml.bind.v2.model.impl.ModelBuilder.<clinit>(ModelBuilder.java:173)
	com.sun.xml.bind.v2.runtime.JAXBContextImpl.getTypeInfoSet(JAXBContextImpl.java:422)
	com.sun.xml.bind.v2.runtime.JAXBContextImpl.<init>(JAXBContextImpl.java:286)
	com.sun.xml.bind.v2.ContextFactory.createContext(ContextFactory.java:139)
	com.sun.xml.bind.v2.ContextFactory.createContext(ContextFactory.java:117)
	sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
	sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)

        etc, etc...

Endorsed? I don't get it. Does this mean I'm using an older version of something, or a newer, unsupported version of something else? This is complete gibberish to me, and now I'm stuck. Can anyone help?

[Ulf Dittmer]

It's a bit tricky to replace classes built onto the JRE with different versions. JAX-WS and JAXB go hand in hand, so you should either replace both, or neither. Personally, I'd start by trying to fix the Ant problem before I tried to replace the built-in versions.

But having said that, it is possible, if for no other reason than to get the newest JAX-WS and JAXB. See here for how to do that: https://jax-ws.dev.java.net/guide/Using_JAX_WS_2_1_with_JavaSE6.html

[Peer Reynders]

javax.xml.ws.Service.getPort(javax.xml.namespace.QName,java.lang.Class,javax.xml.ws.WebServiceFeature...) has been available since JAX-WS 2.1.

JAX-WS 2.1.1 is included in the JDK 1.6 build 11

JAX-WS 2.1.5 Release Notes: Running on top of JDK 6

release notes wrote:
6. Running on top of JDK 6
JDK 6u4 includes JAX-WS 2.1 and JAXB 2.1 API and RI. JAX-WS RI 2.1.5 includes newer and enhanced RI of JAX-WS/JAXB 2.1. In order to run JAX-WS RI 2.1.5 you would need to put the jars in the classpath(endorsed mechanism is not required anymore).

Furthermore you need to tell Tomcat where the separate jars are. For Tomcat 6.0 you need to modify conf/catalina.properties to load the JAX-WS jars.

# List of comma-separated paths defining the contents of the "shared"
# classloader. Prefixes should be used to define what is the repository type.
# Path may be relative to the CATALINA_BASE path or absolute. If left as blank,
# the "common" loader will be used as Catalina's "shared" loader.
# Examples:
# "foo": Add this folder as a class repository
# "foo/*.jar": Add all the JARs of the specified folder as class
# repositories
# "foo/bar.jar": Add bar.jar as a class repository
# Please note that for single jars, e.g. bar.jar, you need the URL form
# starting with file:.
shared.loader=C:/opt/jaxws-ri/lib/*.jar

See Running JAX-WS Samples with Tomcat 6.x

[Philippe Desrosiers]

Thanks for your help, guys. This turned out to be a problem with JAVA_HOME and CLASSPATH on the local dev machine I was using. By NOT including the JAX-WS libraries in the distributable WAR file, Tomcat loaded the whole thing from the JRE, which was perfect. Problem Solved!

thanks again,