Eclipse Implementation of XML Web Services Release Documentation Eclipse Implementation of XML Web Services Release Documenta- tion Table of Contents Overview .......................................................................................................................... 1 1. Documentation ....................................................................................................... 1 2. Software Licenses ................................................................................................... 1 3. Useful Links .......................................................................................................... 1 Release Notes .................................................................................................................... 3 1. Required Software .................................................................................................. 3 2. Installation Instructions ............................................................................................ 3 3. Running on top of JDK 8 ......................................................................................... 4 4. Jar dependency ....................................................................................................... 4 5. Current Limitations / Bugs / Issues ............................................................................. 4 6. Changelog ............................................................................................................. 4 Users Guide ...................................................................................................................... 9 1. Overview ............................................................................................................. 10 1.1. Introduction ............................................................................................... 10 1.2. Features .................................................................................................... 11 1.3. Programming Model .................................................................................... 15 1.4. Useful Information ...................................................................................... 21 2. Provider ............................................................................................................... 21 2.1. Provider<Source> and PAYLOAD ........................................................... 22 2.2. Provider<SOAPMessage> and MESSAGE ................................................. 22 2.3. Provider<Source> and MESSAGE ........................................................... 22 2.4. WSDL Customization .................................................................................. 22 2.5. The sun-jaxws.xml file .......................................................................... 23 2.6. Provider and Binding .................................................................................. 23 2.7. RESTful Provider endpoints ......................................................................... 24 2.8. Provider and Handlers ................................................................................. 24 3. AsyncProvider ...................................................................................................... 25 3.1. AsyncProvider Example ......................................................................... 25 3.2. AsyncProvider sample ........................................................................... 25 3.3. AsyncService sample ............................................................................. 25 4. Dispatch .............................................................................................................. 25 4.1. Programming Model .................................................................................... 26 4.2. Dispatch and Asynchronous Invocations ......................................................... 27 5. Asynchronous Client .............................................................................................. 29 5.1. Asynchronous Invocation Using Static Stub ..................................................... 29 5.2. Asynchronous Invocation Using Dispatch ........................................................ 31 6. Handler ............................................................................................................... 31 6.1. Handler Types ............................................................................................ 31 6.2. MessageContext ......................................................................................... 32 6.3. Handler Chain Configuration ........................................................................ 32 6.4. Handler Samples ......................................................................................... 35 7. MTOM and Swaref ............................................................................................... 35 7.1. MTOM and XOP ........................................................................................ 35 7.2. MTOM in Jakarta XML Web Services ........................................................... 35 7.3. swaRef ...................................................................................................... 40 8. SOAP 1.2 ............................................................................................................ 41 8.1. Introduction ............................................................................................... 41 8.2. SOAP 1.2 Endpoint ..................................................................................... 42 8.3. Client ....................................................................................................... 43 8.4. Samples .................................................................................................... 43 9. WSDL Customization ............................................................................................ 44 iii Eclipse Implementation of XML Web Services Release Documentation 9.1. Declaring Customizations ............................................................................. 44 9.2. Standard Customizations .............................................................................. 46 10. Annotations ........................................................................................................ 53 10.1. Overview ................................................................................................. 53 10.2. Jakarta Web Services Metadata Annotations ................................................... 53 10.3. Jakarta XML Web Services Annotations ........................................................ 62 10.4. Jakarta XML Binding Annotations ............................................................... 81 10.5. JSR 250 (Common Annotations) Annotations ................................................. 90 11. WS-Addressing ................................................................................................... 93 11.1. WS-Addressing in Eclipse Implementation of XML Web Services ...................... 93 11.2. Why WS-Addressing? ................................................................................ 94 11.3. WS-Addressing Versions ............................................................................ 97 11.4. Describing WS-Addressing in WSDL ........................................................... 98 11.5. Configuring Addressing on Endpoint ........................................................... 100 11.6. On the client side .................................................................................... 101 11.7. When is WS-Addressing engaged? ............................................................. 103 11.8. Associating Action with an operation .......................................................... 103 12. Stateful Webservice ............................................................................................ 104 12.1. Introduction ............................................................................................ 104 12.2. Usage .................................................................................................... 104 12.3. Things To Consider ................................................................................. 105 13. Catalog ............................................................................................................ 106 13.1. Catalog Support ...................................................................................... 106 14. WAR File Packaging .......................................................................................... 107 14.1. The WAR Contents ................................................................................. 107 14.2. The sun-jaxws.xml File ...................................................................... 107 14.3. The web.xml File .................................................................................. 109 15. Interoperability .................................................................................................. 109 16. Endpoint API .................................................................................................... 110 16.1. Endpoint ............................................................................................ 110 16.2. Endpoint and Properties .................................................................. 110 16.3. Endpoint and Binding .......................................................................