Release Notes
Prev |  | Next

Links: Table of Contents | Single HTML | Single PDF

## Release Notes

## 1. Overview

JAX-WS RI 2.2.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

- Reference Implementation (RI) of JAX-WS 2.2 API. Full JAX-WS 2.2 compliance

- Development Tools

  - WSDL to Java generator

    - wsimport, wsimport Ant Task and Maven2 plugin

  - Java to WSDL generator

    - wsgen, wsgen Ant Task and Maven2 plugin

- Standards

  - Web Services Addressing 1.0 - Core

  - Web Services Addressing 1.0 - SOAP Binding

  - Web Services Addressing 1.0 - Metadata

  - Web Services Addressing 1.0 - WSDL Binding (RI specific support)

  - WS-Addressing - Member Submission

  - SOAP 1.1 and 1.2

  - REST and XML/HTTP

  - WS-I Basic Profile 1.2 and 2.0

  - WS-I Simple SOAP Binding Profile 1.0

  - WS-I Attachment Profile 1.0

  - MTOM

- Extensions (May not be final unless says so)

  - Web Services Interoperable Technologies (WSIT) - enables .NET 3.x interoperability

    - WS-ReliableMessaging

    - WS-Policy

    - WS-MEX

    - WS-Security/WS-Security Policy

    - WS-Trust/WS-Secure Conversation

    - WS-AT/WS-Tx (Supported only on Glassfish v2)

    - SOAP/TCP

  - Spring support

  - Pluggable Transport

    - In-VM transport

    - Servlet transport (bundled with the RI)

    - JMS transport

    - SOAP over TCP transport (part of WSIT)

  - FastInfoset (bundled with JAX-WS RI 2.2.7)

    - ITU-T Rec. X.891 | ISO/IEC 24824-1

  - JBI Service Engine and Binding Component(part of Glassfish v2)

  - HTTP Binding Component, used by Open JBI component

- Data binding - JAXB RI 2.2.3 u1

- Server Side Asynchrony - AsyncProvider

- Stateful Web Services

- Support for custom WebServiceFeature

- Hosting API

  - These APIs can be used b y a J2EE application server to integrate JAX-WS RI 2.2.7 for hosting JAX-WS services

- Endpoint Deployment

  - Glassfish v3

    - Tightly integrated with Glassfish

    - Supports EJB and Web endpoints

    - 109 based deployment support for better portability

    - JAX-WS RI specific deployment descriptor support

  - Sun One Application Server 9.0 ur1

  - Light weight HTTP server

    - Bundled with JDK 6

  - Any other container that supports Servlet 2.4, such as Tomcat, Jetty, Geronimo, JBoss, Resin, ... You name it!

This release brings in the highly pluggable framework through abstractions such as Tube and Message. This architecture document is a glorified javadoc which includes all the JAX-WS RI specific APIs. JAX-WS RI 2.2.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.2.7 in a Java EE container in a Java EE portable manner you need to use the standard Java EE 6 deployment descriptor; please refer to the Java EE 6 or Glassfish documentation/samples. The majority of the documentation included with JAX-WS is valid with Java EE 6 as well.

## 3. Online Documentation

The documentation for JAX-WS RI 2.2.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.2.7 can be found here .

Please go to http://jax-ws.java.net for the latest documentation and samples.

## 4. Required Software

- Requires JDK 5.0 Update 2 or later

- Requires Ant 1.6.2 or later

- Tested to work with GlassFish v3.1 and Apache Tomcat 5.5.x

## 5. Installation Instructions

The following applies to the JAX-WS standalone bundles.

- Extract JAX-WS RI 2.2.7 bundle

- To install on GlassFish v2

  - If you want to use the JAX-WS RI 2.2.7 overriding the one with Glassfish v2, Download Metro 2.1 bundle from http://metro.java.net and follow the instructions in that bundle

- To use with GlassFish v3.1

  - GlassFish v3.1 has JAX-WS RI 2.2.7, so there is no installation step.

- To install on Tomcat

  - Set `CATALINA_HOME` to your Tomcat installation.

  - Run

        ant install

    This essentially copies `lib/*.jar` from the root of JAX-WS RI extracted bundle to `$CATALINA_HOME/shared/lib`

  - If you are running on top of JDK6, run

        ant install-api

    or use

        ant -help

    for detailed information.

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.2.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.2.7 includes RI of JAX-WS/JAXB 2.2. In order to run JAX-WS RI 2.2.7 you would need to specify ONLY `jaxws-api.jar`, and `jaxb-api.jar` jars using the Java Endorsed Standards Override Mechanism

## 7. Jar dependency

Table 1. Jar dependencies summary

Runtime Jars | `FastInfoset.jar`, `jaxb-api.jar`, `jaxb-impl.jar`, `jaxws-api.jar`, `jaxws-rt.jar`, `jsr181-api.jar`, `javax.annotation.jar`, `mimepull.jar`, `saaj-api.jar`, `saaj-impl.jar *`, `stax2-api.jar`, `woodstox-core-asl.jar`, `stax-ex.jar`, `streambuffer.jar`, `policy.jar`, `gmbal-api-only.jar`, `management-api.jar`, `ha-api.jar`
Tooltime Jars | All the runtime jars + `jaxb-xjc.jar`, `jaxws-tools.jar`

If you run JAX-WS RI 2.2.7 with IBM JDK, there are two options:

- to add Oracles's JAXP implementation jars along

- to remove the saaj-impl.jar from the libraries in order IBM SAAJ implementation to be used

First approach is recommended.

## 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

- Bug fixes

## 10. 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.

## 11. For More Information

Go to http://jax-ws.java.net.

Send your feedback to users@metro.java.net or use the Metro and JAXB Forum

## 12. Changelog

### 12.1. Changes from JAX-WS RI 2.2.1 to JAX-WS RI 2.2.3

- Add -clientjar option for wsimport

- Add support for Async Servlet Transport using Servlet 3.0 api

- Bug fixes

### 12.2. Changes from JAX-WS RI 2.2 to JAX-WS RI 2.2.1

- wsgen can inline schemas in a generated wsdl using a switch

- Schema Validation support is enhanced

- Bug fixes

### 12.3. Changes from JAX-WS RI 2.1.7 to JAX-WS RI 2.2

- Add WS-Addressing 1.0 Metadata support as per 2.2 spec

- Support for `@XmlElement` on SEI's wrapper parameter

- Support for `@XmlType` on exception classes

- Implement HTTP SPI

- Implement Endpoint API with features

- Generate new constructors in the generated Service class(service level features, wsdllocation)

- Add support for customizing wrapper `wsdl:part` names as defined in 2.2

- Add support for customizing `wsdl:message` name using `@WebFault` as defined in 2.2

- Fault customization should accept fully qualified name of the exception class to be generated

- Customization of Service should accept fully qualified class name

- Add Xnocompile option for wsgen similar to wsimport

- XPath expressions in jax-ws customization can now select multiple nodes

- Disable server-side exception stacktrace for service specific exceptions

- Optimzation of LogicalMessage implementation

- wsimport now handles URL redirection of imported wsdls correctly

- Bug fixes

### 12.4. Changes from JAX-WS RI 2.1.6 to JAX-WS RI 2.1.7

- Bug fixes

### 12.5. Changes from JAX-WS RI 2.1.5 to JAX-WS RI 2.1.6

- Supportfor transport attribute for bindings like SOAP/JMS binding

- Bug fixes

### 12.6. Changes from JAX-WS RI 2.1.4 to JAX-WS RI 2.1.5

- Allowing HTTP response code to be set via MessageContext property

- New feature: UsesJAXBContextFeature, to control JAXBContext creation

- New wsimport option: -XdisableSSLHostnameVerfication, to disable SSL Hostname verification

- Wsimport ant task accepts nested args for specifying additional options

- Bug fixes

### 12.7. Changes from JAX-WS RI 2.1.3 to JAX-WS RI 2.1.4

- Simplified "Starting from Java Programming model" through dynamic generation of request and response wrappers

- Samples

- Bug fixes

### 12.8. Changes from JAX-WS RI 2.1.2 to JAX-WS RI 2.1.3

- Authentication support in wsimport

- Additional header support

- Large and Streaming attachment support

- XML Schema validation support for SOAP message

- Expose the -Xnocompile as an Ant task option

- Additional WSDL object methods for policy

- Wsimport should be able to handle redirects and see Others

- Remove SJSXP and SAAJ RI dependency

- Wsimport should write to passed OutputStream

- Efficient Handler using Handler<Message> support

- Bug fixes

### 12.9. Changes from JAX-WS RI 2.1.1 to JAX-WS RI 2.1.2

- JMX Agent for the server side

- Mtom Interop with .NET 2.0/WSE 3.0

- Bug fixes

### 12.10. Changes from JAX-WS 2.0 RI to JAX-WS RI 2.1.1

- JAXB 2.1 RI Integration

- JAX-WS 2.1 MR (JSR 224) implementation

- Type substitution support

- WS-Addressing - W3C and Memeber Submission

- APIs to create EPR and use it to invoke endpoint

- Support for enabling/disabling features, such as WS-Addressing/MTOM

- Asynchronous server

- Tubes and Fiber for asynchronous message processing

- Dispatch<Message> and Provider<Message>

- Stateful Webservice support

- Bug fixes

Prev |  | Next
Overview | Home | Users Guide