<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>JAX-WS Release Documentation</title><link rel="stylesheet" href="style/documentation.css" type="text/css"><meta name="generator" content="DocBook XSL-NS Stylesheets V1.75.2"><link rel="home" href="index.html" title="JAX-WS Release Documentation"><link rel="next" href="ch01.html" title="Overview"><script xmlns:fo="http://www.w3.org/1999/XSL/Format" type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-2105126-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">JAX-WS Release Documentation</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr></table><hr></div><small xmlns:fo="http://www.w3.org/1999/XSL/Format" class="small">Links: <a href="index.html">Table of Contents</a> | <a href="release-documentation.html">Single HTML</a> | <a href="release-documentation.pdf">Single PDF</a></small><div lang="en" class="book" title="JAX-WS Release Documentation" id="user-guide"><div class="titlepage"><div><div><h1 class="title">JAX-WS Release Documentation</h1></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="ch01.html">Overview</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#section-159360148062263">1. Documentation</a></span></dt><dt><span class="section"><a href="ch01.html#section-0073999762824">2. Software Licenses</a></span></dt><dt><span class="section"><a href="ch01.html#section-302002852812141">3. Useful Links</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#other-links">3.1. Other links</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch02.html">Release Notes</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#overview">1. Overview</a></span></dt><dt><span class="section"><a href="ch02.html#features-in-this-release">2. Features in this release</a></span></dt><dt><span class="section"><a href="ch02.html#online-documentation">3. Online Documentation</a></span></dt><dt><span class="section"><a href="ch02.html#required-software">4. Required Software</a></span></dt><dt><span class="section"><a href="ch02.html#installation-instructions">5. Installation Instructions</a></span></dt><dt><span class="section"><a href="ch02.html#running-on-top-of-jdk-6">6. Running on top of JDK 6</a></span></dt><dt><span class="section"><a href="ch02.html#jar-dependency">7. Jar dependency</a></span></dt><dt><span class="section"><a href="ch02.html#current-limitations">8. Current Limitations</a></span></dt><dt><span class="section"><a href="ch02.html#bugs-fixed-in-this-release">9. Bugs Fixed in this release</a></span></dt><dt><span class="section"><a href="ch02.html#known-bugs-issues">10. Known Bugs/Issues</a></span></dt><dt><span class="section"><a href="ch02.html#for-more-information">11. For More Information</a></span></dt><dt><span class="section"><a href="ch02.html#jax-ws-ri-changelog">12. Changelog</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#changes-221-223">12.1. Changes from JAX-WS RI 2.2.1 to JAX-WS RI 2.2.3 </a></span></dt><dt><span class="section"><a href="ch02.html#changes-22-221">12.2. Changes from JAX-WS RI 2.2 to JAX-WS RI 2.2.1 </a></span></dt><dt><span class="section"><a href="ch02.html#changes-217-22">12.3. Changes from JAX-WS RI 2.1.7 to JAX-WS RI 2.2 </a></span></dt><dt><span class="section"><a href="ch02.html#changes-216-217">12.4. Changes from JAX-WS RI 2.1.6 to JAX-WS RI 2.1.7 </a></span></dt><dt><span class="section"><a href="ch02.html#changes-215-216">12.5. Changes from JAX-WS RI 2.1.5 to JAX-WS RI 2.1.6 </a></span></dt><dt><span class="section"><a href="ch02.html#changes-214-215">12.6. Changes from JAX-WS RI 2.1.4 to JAX-WS RI 2.1.5 </a></span></dt><dt><span class="section"><a href="ch02.html#changes-213-214">12.7. Changes from JAX-WS RI 2.1.3 to JAX-WS RI 2.1.4</a></span></dt><dt><span class="section"><a href="ch02.html#changes-211-213">12.8. Changes from JAX-WS RI 2.1.2 to JAX-WS RI 2.1.3</a></span></dt><dt><span class="section"><a href="ch02.html#changes-211-212">12.9. Changes from JAX-WS RI 2.1.1 to JAX-WS RI 2.1.2</a></span></dt><dt><span class="section"><a href="ch02.html#changes-20-21">12.10. Changes from JAX-WS 2.0 RI to JAX-WS RI 2.1.1</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch03.html">Users Guide</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#users-guide-overview">1. Overview</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#introduction">1.1. Introduction</a></span></dt><dt><span class="section"><a href="ch03.html#features">1.2. Features</a></span></dt><dt><span class="section"><a href="ch03.html#programming-model">1.3. Programming Model</a></span></dt><dt><span class="section"><a href="ch03.html#useful-information">1.4. Useful Information</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-provider">2. Provider</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-3091238697838234">2.1. <code class="literal">Provider<Source></code> and
<code class="literal">PAYLOAD</code></a></span></dt><dt><span class="section"><a href="ch03.html#section-8519606736474974">2.2. <code class="literal">Provider<SOAPMessage></code> and
<code class="literal">MESSAGE</code></a></span></dt><dt><span class="section"><a href="ch03.html#section-7319353703410434">2.3. <code class="literal">Provider<Source></code> and
<code class="literal">MESSAGE</code></a></span></dt><dt><span class="section"><a href="ch03.html#section-674124516240791">2.4. WSDL Customization</a></span></dt><dt><span class="section"><a href="ch03.html#section-648626808421419">2.5. The <code class="literal">sun-jaxws.xml</code> file</a></span></dt><dt><span class="section"><a href="ch03.html#section-343591403757231">2.6. Provider and Binding</a></span></dt><dt><span class="section"><a href="ch03.html#section-330867941262645">2.7. RESTful Provider endpoints</a></span></dt><dt><span class="section"><a href="ch03.html#section-017933327977469">2.8. Provider and Handlers</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-asyncprovider">3. AsyncProvider</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-091974998856598">3.1. <code class="literal">AsyncProvider</code> Example</a></span></dt><dt><span class="section"><a href="ch03.html#section-930633228695613">3.2. <code class="literal">AsyncProvider</code> sample</a></span></dt><dt><span class="section"><a href="ch03.html#section-5233554712491355">3.3. <code class="literal">AsyncService</code> sample</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-dispatch">4. Dispatch</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-71379735580733">4.1. Programming Model</a></span></dt><dt><span class="section"><a href="ch03.html#section-21282255346754875">4.2. Dispatch and Asynchronous Invocations</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-asynchronous-client">5. Asynchronous Client</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-346120708971664">5.1. Asynchronous Invocation Using Static Stub</a></span></dt><dt><span class="section"><a href="ch03.html#section-85273158180115">5.2. Asynchronous Invocation Using Dispatch</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-handler">6. Handler</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-524340464580105">6.1. Handler Types</a></span></dt><dt><span class="section"><a href="ch03.html#section-276528078695232">6.2. MessageContext</a></span></dt><dt><span class="section"><a href="ch03.html#section-165423693536683">6.3. Handler Chain Configuration</a></span></dt><dt><span class="section"><a href="ch03.html#section-8594509924044">6.4. Handler Samples</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-mtom-and-swaref">7. MTOM and Swaref</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#mtom-and-xop">7.1. MTOM and XOP</a></span></dt><dt><span class="section"><a href="ch03.html#mtom-in-jaxws-2-0">7.2. MTOM in JAX-WS 2.0</a></span></dt><dt><span class="section"><a href="ch03.html#swaref">7.3. swaRef</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-soap-1-2">8. SOAP 1.2</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-94073181229507">8.1. Introduction</a></span></dt><dt><span class="section"><a href="ch03.html#section-627071591090577">8.2. SOAP 1.2 Endpoint</a></span></dt><dt><span class="section"><a href="ch03.html#section-696486497021005">8.3. Client</a></span></dt><dt><span class="section"><a href="ch03.html#section-7037754311590527">8.4. Samples</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-wsdl-customization">9. WSDL Customization</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#declaring-customizations">9.1. Declaring Customizations</a></span></dt><dt><span class="section"><a href="ch03.html#standard-customizations">9.2. Standard Customizations</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-annotations">10. Annotations</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-031540603185018">10.1. Overview</a></span></dt><dt><span class="section"><a href="ch03.html#jsr-181">10.2. JSR 181 (Web Services Metadata) Annotations</a></span></dt><dt><span class="section"><a href="ch03.html#jsr-224-jax-ws-annotations-outline">10.3. JSR 224 (JAX-WS) Annotations</a></span></dt><dt><span class="section"><a href="ch03.html#jsr-222-jaxb-annotations-outline">10.4. JSR 222 (JAXB) Annotations</a></span></dt><dt><span class="section"><a href="ch03.html#jsr-250-common-annotations">10.5. JSR 250 (Common Annotations) Annotations</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-why-ws-addressing">11. Why WS-Addressing?</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#what-is-ws-addressing">11.1. What is WS-Addressing?</a></span></dt><dt><span class="section"><a href="ch03.html#ws-addressing-versions">11.2. WS-Addressing Versions</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-ws-addressing">12. WS-Addressing</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#ws-addressing-in">12.1. WS-Addressing in JAX-WS RI</a></span></dt><dt><span class="section"><a href="ch03.html#why-ws-addressing">12.2. Why WS-Addressing?</a></span></dt><dt><span class="section"><a href="ch03.html#describing-ws-addressing-in-wsdl">12.3. Describing WS-Addressing in WSDL</a></span></dt><dt><span class="section"><a href="ch03.html#configuring-addressing-on-endpoint">12.4. Configuring Addressing on Endpoint</a></span></dt><dt><span class="section"><a href="ch03.html#on-the-client-side">12.5. On the client side</a></span></dt><dt><span class="section"><a href="ch03.html#when-is-ws-addressing-engaged">12.6. When is WS-Addressing engaged?</a></span></dt><dt><span class="section"><a href="ch03.html#associating-action-with-an-operation">12.7. Associating Action with an operation</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-stateful-webservice">13. Stateful Webservice</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#introduction-1">13.1. Introduction</a></span></dt><dt><span class="section"><a href="ch03.html#usage">13.2. Usage</a></span></dt><dt><span class="section"><a href="ch03.html#things-to-consider">13.3. Things To Consider</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-catalog">14. Catalog</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-529979392543239">14.1. Catalog Support</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-war-file-packaging">15. WAR File Packaging</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-5694250262578">15.1. The WAR Contents</a></span></dt><dt><span class="section"><a href="ch03.html#the-sun-jaxws-xml-file">15.2. The <code class="literal">sun-jaxws.xml</code> File</a></span></dt><dt><span class="section"><a href="ch03.html#section-42577169574826">15.3. The <code class="literal">web.xml</code> File</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-interoperability">16. Interoperability</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-4101350549640481">16.1. WSDL and Message Level Interoperability</a></span></dt><dt><span class="section"><a href="ch03.html#section-325661411410258">16.2. .NET 3.5 Interoperability</a></span></dt></dl></dd><dt><span class="section"><a href="ch03.html#users-guide-endpoint-api">17. Endpoint API</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#section-0499646435494807">17.1. <code class="literal">Endpoint</code></a></span></dt><dt><span class="section"><a href="ch03.html#section-2491869058427427">17.2. <code class="literal">Endpoint</code> and
<code class="literal">Properties</code></a></span></dt><dt><span class="section"><a href="ch03.html#section-9038221558727715">17.3. <code class="literal">Endpoint</code> and
<code class="literal">Binding</code></a></span></dt><dt><span class="section"><a href="ch03.html#section-091994350952741">17.4. <code class="literal">Endpoint</code> and
<code class="literal">metadata</code></a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch04.html">Tools</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#tools-overview">1. Overview</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#apttool">1.1. <span class="command"><strong>apt</strong></span></a></span></dt><dt><span class="section"><a href="ch04.html#wscompiletool">1.2. <span class="command"><strong>wsimport</strong></span></a></span></dt><dt><span class="section"><a href="ch04.html#wsdeploytool">1.3. <span class="command"><strong>wsgen</strong></span></a></span></dt><dt><span class="section"><a href="ch04.html#how">1.4. How do I pick a tool?</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-wsimport">2. <span class="command"><strong>wsimport</strong></span></a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#wsimport-overview">2.1. <span class="command"><strong>wsimport</strong></span> Overview</a></span></dt><dt><span class="section"><a href="ch04.html#launching-wsimport">2.2. Launching <span class="command"><strong>wsimport</strong></span></a></span></dt><dt><span class="section"><a href="ch04.html#running-wsimport-on-jdk-6">2.3. Running <span class="command"><strong>wsimport</strong></span> on JDK 6</a></span></dt><dt><span class="section"><a href="ch04.html#wsimport-syntax">2.4. <span class="command"><strong>wsimport</strong></span> Syntax</a></span></dt><dt><span class="section"><a href="ch04.html#wsimport-example">2.5. <span class="command"><strong>wsimport</strong></span> Example</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-wsimport-ant-task">3. <span class="command"><strong>wsimport</strong></span> Ant Task</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#wsimport-task-overview">3.1. <span class="command"><strong>wsimport</strong></span> Task Overview</a></span></dt><dt><span class="section"><a href="ch04.html#using-wsimport-task">3.2. Using <span class="command"><strong>wsimport</strong></span> Task</a></span></dt><dt><span class="section"><a href="ch04.html#running-wsimport-task-on-jdk-6">3.3. Running <span class="command"><strong>wsimport</strong></span> Task on JDK 6</a></span></dt><dt><span class="section"><a href="ch04.html#examples">3.4. <span class="command"><strong>wsimport</strong></span> Examples</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-wsgen">4. <span class="command"><strong>wsgen</strong></span></a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#wsgen-overview">4.1. <span class="command"><strong>wsgen</strong></span> Overview</a></span></dt><dt><span class="section"><a href="ch04.html#launching-wsgen">4.2. Launching <span class="command"><strong>wsgen</strong></span></a></span></dt><dt><span class="section"><a href="ch04.html#running-wsgen-on-jdk-6">4.3. Running <span class="command"><strong>wsgen</strong></span> on JDK 6</a></span></dt><dt><span class="section"><a href="ch04.html#wsgen-syntax">4.4. <span class="command"><strong>wsgen</strong></span> Syntax</a></span></dt><dt><span class="section"><a href="ch04.html#wsgen-example">4.5. <span class="command"><strong>wsgen</strong></span> Example</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-wsgen-ant-task">5. <span class="command"><strong>wsgen</strong></span> Ant Task</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#wsgen-task-overview">5.1. <span class="command"><strong>wsgen</strong></span> Task Overview</a></span></dt><dt><span class="section"><a href="ch04.html#wsgen-task-attributes">5.2. <span class="command"><strong>wsgen</strong></span> Task Attributes</a></span></dt><dt><span class="section"><a href="ch04.html#running-wsgen-task-on-jdk-6">5.3. Running <span class="command"><strong>wsgen</strong></span> Task on JDK 6</a></span></dt><dt><span class="section"><a href="ch04.html#wsgen-task-example">5.4. <span class="command"><strong>wsgen</strong></span> Task Example</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-apt">6. <span class="command"><strong>apt</strong></span></a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#section-8324588054404016">6.1. <span class="command"><strong>apt</strong></span></a></span></dt><dt><span class="section"><a href="ch04.html#running-apt-on-jdk-6">6.2. Running <span class="command"><strong>apt</strong></span> on JDK 6</a></span></dt><dt><span class="section"><a href="ch04.html#moztocid408933">6.3. <span class="command"><strong>apt</strong></span> Syntax</a></span></dt></dl></dd><dt><span class="section"><a href="ch04.html#tools-apt-ant-task">7. <span class="command"><strong>apt</strong></span> Ant Task</a></span></dt><dd><dl><dt><span class="section"><a href="ch04.html#d0e9861">7.1. <span class="command"><strong>apt</strong></span> Task Overview</a></span></dt><dt><span class="section"><a href="ch04.html#d0e9871">7.2. <span class="command"><strong>apt</strong></span> Task Attributes</a></span></dt><dt><span class="section"><a href="ch04.html#running-apt-task-on-jdk-6">7.3. Running <span class="command"><strong>apt</strong></span> Task on JDK 6</a></span></dt><dt><span class="section"><a href="ch04.html#section-26459256796099617">7.4. <span class="command"><strong>apt</strong></span> Task Examples</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch05.html">Extensions</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#jax-ws-ri-extensions-extensions">1. Extensions</a></span></dt><dd><dl><dt><span class="section"><a href="ch05.html#sending-and-receiving-soap-headers">1.1. Sending and Receiving SOAP Headers</a></span></dt><dt><span class="section"><a href="ch05.html#message-logging">1.2. Message logging</a></span></dt><dt><span class="section"><a href="ch05.html#propagation-of-server-side-stacktrace">1.3. Propagation of Server-side Stacktrace</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch06.html">Samples</a></span></dt><dd><dl><dt><span class="section"><a href="ch06.html#samples-samples">1. Samples</a></span></dt><dd><dl><dt><span class="section"><a href="ch06.html#a-1-0">1.1. Directory Structure</a></span></dt><dt><span class="section"><a href="ch06.html#a-2-0">1.2. Prerequisites</a></span></dt><dt><span class="section"><a href="ch06.html#a-3-0">1.3. Installing JAX-WS RI 2.2.7</a></span></dt><dt><span class="section"><a href="ch06.html#a-4-0">1.4. Running the sample</a></span></dt></dl></dd></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Overview</td></tr></table></div></body></html>