Java TM API for XML Web Services
Release Notes

Specification Version: 2.1
Implementation Version: 2.1.7


  1. 1. Overview
  1. 2. Features in this release
    1. 3. Online Documentation
      1. 4. Required Software
        1. 5. Installation Instructions
          1. 6. Running on top of JDK 6
            1. 7. Jar dependency
              1. 8. Current Limitations
                1. 9. Bugs Fixed in this release
                  1. 10. Changes from JAX-WS 2.1.5 RI
                    1. 11. Known Bugs/Issues
                      1. 12. For More Information
                        1. 1. Overview

                          JAX-WS RI 2.1.7 is a Web Services framework that provides tools and infrastructure to develop Web Services solutions for the end users and middleware developers.

                          2. Features in this release

                          This release brings in the highly pluggable framework through abstractions such as Tube and Message. Refer to the latest architecture document . This architecture document is a glorified javadoc which includes all the JAX-WS RI specific APIs. JAX-WS RI 2.1.7 has many bug fixes made for interoperability with .NET 3.0. This is made mostly possible due to WSIT, which uses JAX-WS plugabble architecture to plug in support for WS-Metadata, WS-Policy, WS-ReliableMessaging, WS-Transaction, WS-SecureConversation and WS-Security.

                          If you wish to use JAX-WS RI 2.1.7 in a Java EE container in a Java EE portable manner you need to use the standard Java EE 5 deployment descriptor; please refer to the Java EE 5 or Glassfish documentation/samples. The majority of the documentation included with JAX-WS is valid with Java EE 5 as well.

                          3. Online Documentation

                          The documentation for JAX-WS RI 2.1.7 as well as the sample applications will be periodically updated in the JAX-WS project.

                          The architecture document describing the latest JAX-WS RI 2.1.7 can be found here .

                          Please go to for the latest documentation and samples.

                          4. Required Software

                          5. Installation Instructions

                          The following applies to the JAX-WS standalone bundles.

                          • Extract JAX-WS RI 2.1.7 bundle
                          • Install on Glassfish v2
                            • If you want to use the JAX-WS RI 2.1.7 overriding the one with Glassfish v2 follow the instructions for installing it on top of Sun One Application Server 9.0 Update 1
                          • Install on Sun One Application Server 9.0 Update 1
                            • Set AS_HOME to the installation directory of Glassfish
                            • cd to the root directory of the extracted JAX-WS RI bundle
                            • Set JAXWS_HOME to the root directory of the extracted JAX-WS RI bundle
                            • Invoke '$ANT_HOME/bin/ant install' to install JAX-WS RI jar on the applciation servers - Glassfish v1/v2 or Sun One AS 9.0 UR1
                          • Install on Tomcat
                            • Copy lib/*.jar from the root of JAX-WS RI extracted bundle to TOMCAT_HOME/shared/lib

                          If you intend to only invoke an already existing Web service, then alternatively you can use the wsimport and wsgen scripts in the bin directory of the JAX-WS RI 2.1.7 bundle.

                          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.7 includes newer and enhanced RI of JAX-WS/JAXB 2.1. In order to run JAX-WS RI 2.1.7 you would need to put the jars in the classpath(endorsed mechanism is not required anymore).

                          7. Jar dependency

                          Runtime Jars FastInfoset.jar, activation.jar, http.jar, jaxb-api.jar, jaxb-impl.jar, jaxws-api.jar, jaxws-rt.jar, jsr173_api.jar, jsr181-api.jar, jsr250-api.jar, mimepull.jar, resolver.jar, saaj-api.jar, saaj-impl.jar, woodstox.jar, stax-ex.jar, streambuffer.jar
                          Tooltime Jars All the runtime jars + jaxb-xjc.jar, jaxws-tools.jar

                          8. Current Limitations

                          • The java.util.Collection classes cannot be used with rpc/literal or document/literal BARE style due to a limitation in JAXB. However, they do work in the default document/literal WRAPPED style.

                          9. Bugs Fixed in this release

                          10. Changes from JAX-WS 2.1.5 RI

                          11. Known Bugs/Issues

                          • Although JAX-WS customizations are portable across implementations, the names of WSDL and schema files generated are not specified. Therefore each vendor may and most likely will generate different names. Therefore, when switching between implementations of JAX-WS, it may be necessary to modify your customization files to reflect different WSDL and schema file names.
                          • This holds true for different releases of the JAX-WS RI. The JAX-WS RI may in each release change these file names to resolve bugs. If and when this does occur, a developer would need to change the filenames in their customization files to match the new file names.
                          • A bug in Apt ant task makes it not work by default. Workaround is to use fork="true" option in the apt task.
                          • See With SOAP 1.2 binding, MustUnderstand faults created by JAX-WS are not interoerable. The fault messages sent by server have the reverse order order of <env:Code> and <env:Reason>

                          12. For More Information

                          Go to

                          Send your feedback to or use the Metro and JAXB Forum

                          Terms of Use; Privacy Policy; Copyright ©2013-2017 (revision 20160708.bf2ac18)
                          Please Confirm