JAX WS Documentation

  • View
    288

  • Download
    5

Embed Size (px)

DESCRIPTION

JAX-WS Documentation.

Text of JAX WS Documentation

  • JAX-WS Release Documentation

  • JAX-WS Release Documentation

  • iii

    Table of ContentsOverview .......................................................................................................................... 1

    1. Documentation ....................................................................................................... 12. Software Licenses ................................................................................................... 13. Useful Links .......................................................................................................... 1

    Release Notes .................................................................................................................... 31. Required Software .................................................................................................. 32. Installation Instructions ............................................................................................ 33. Running on top of JDK 6 ......................................................................................... 44. Jar dependency ....................................................................................................... 45. Current Limitations / Bugs / Issues ............................................................................. 46. Changelog ............................................................................................................. 4

    Users Guide ...................................................................................................................... 91. Overview ............................................................................................................. 10

    1.1. Introduction ............................................................................................... 101.2. Features .................................................................................................... 111.3. Programming Model .................................................................................... 151.4. Useful Information ...................................................................................... 21

    2. Provider ............................................................................................................... 212.1. Provider and PAYLOAD ........................................................... 212.2. Provider and MESSAGE ................................................. 222.3. Provider and MESSAGE ........................................................... 222.4. WSDL Customization .................................................................................. 222.5. The sun-jaxws.xml file .......................................................................... 222.6. Provider and Binding .................................................................................. 232.7. RESTful Provider endpoints ......................................................................... 232.8. Provider and Handlers ................................................................................. 24

    3. AsyncProvider ...................................................................................................... 243.1. AsyncProvider Example ......................................................................... 253.2. AsyncProvider sample ........................................................................... 253.3. AsyncService sample ............................................................................. 25

    4. Dispatch .............................................................................................................. 254.1. Programming Model .................................................................................... 264.2. Dispatch and Asynchronous Invocations ......................................................... 27

    5. Asynchronous Client .............................................................................................. 285.1. Asynchronous Invocation Using Static Stub ..................................................... 285.2. Asynchronous Invocation Using Dispatch ........................................................ 31

    6. Handler ............................................................................................................... 316.1. Handler Types ............................................................................................ 316.2. MessageContext ......................................................................................... 326.3. Handler Chain Configuration ........................................................................ 326.4. Handler Samples ......................................................................................... 35

    7. MTOM and Swaref ............................................................................................... 357.1. MTOM and XOP ........................................................................................ 357.2. MTOM in JAX-WS 2.0 ............................................................................... 357.3. swaRef ...................................................................................................... 40

    8. SOAP 1.2 ............................................................................................................ 418.1. Introduction ............................................................................................... 418.2. SOAP 1.2 Endpoint ..................................................................................... 418.3. Client ....................................................................................................... 428.4. Samples .................................................................................................... 43

    9. WSDL Customization ............................................................................................ 43

  • JAX-WS Release Documentation

    iv

    9.1. Declaring Customizations ............................................................................. 449.2. Standard Customizations .............................................................................. 46

    10. Annotations ........................................................................................................ 5310.1. Overview ................................................................................................. 5310.2. JSR 181 (Web Services Metadata) Annotations ............................................... 5310.3. JSR 224 (JAX-WS) Annotations .................................................................. 6210.4. JSR 222 (JAXB) Annotations ...................................................................... 8110.5. JSR 250 (Common Annotations) Annotations ................................................. 90

    11. WS-Addressing ................................................................................................... 9311.1. WS-Addressing in JAX-WS RI .................................................................... 9311.2. Why WS-Addressing? ................................................................................ 9311.3. WS-Addressing Versions ............................................................................ 9711.4. Describing WS-Addressing in WSDL ........................................................... 9811.5. Configuring Addressing on Endpoint ............................................................ 9911.6. On the client side .................................................................................... 10111.7. When is WS-Addressing engaged? ............................................................. 10311.8. Associating Action with an operation .......................................................... 103

    12. Stateful Webservice ............................................................................................ 10412.1. Introduction ............................................................................................ 10412.2. Usage .................................................................................................... 10412.3. Things To Consider ................................................................................. 105

    13. Catalog ............................................................................................................ 10513.1. Catalog Support ...................................................................................... 105

    14. WAR File Packaging .......................................................................................... 10614.1. The WAR Contents ................................................................................. 10614.2. The sun-jaxws.xml File ...................................................................... 10714.3. The web.xml File .................................................................................. 108

    15. Interoperability .................................................................................................. 10916. Endpoint API .................................................................................................... 109

    16.1. Endpoint ............................................................................................ 10916.2. Endpoint and Properties .................................................................. 11016.3. Endpoint and Binding ........................................................................ 11016.4. Endpoint and metadata ...................................................................... 111

    17. Modular Databinding .......................................................................................... 11117.1. Introduction ..............