Documentation Contents

# Java API for XML Web Services

The Java API for XML Web Services (JAX-WS) simplifies creating and deploying web services and web services clients. Java SE includes JAX-WS 2.2.

## Backward Compatibility

Two small source compatibility anomalies exist between JAX-WS versions 2.1 and 2.2. The changes in the API are as follows:

- In the `FaultAction` annotation, the `className` element's type changed from being a plain vanilla `java.lang.Class` to being `java.lang.Class<? extends java.lang.Exception>`.
- In the `WebServiceRef` annotation, the `value` element's type is now more specific. Instead of being `java.lang.Class`, the type is now `java.lang.Class<? extends Service>`.

Because of these changes, some applications that compile with Java SE 6 might not compile with Java SE 7. There will be a deployment error if incorrect types are used with JAX-WS 2.1 API. In Java SE 7, these type errors are caught at compile time instead of deployment time.

## References

- `javax.xml.ws`
- Building Web Services with JAX-WS, part of the Java EE 6 Tutorial
- JAX-WS project page on GitHub

## Specification

- JSR 224: Java API for XML-Based Web Services (JAX-WS) 2.0

Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved.
Contact Us