javax.xml.ws.soap

## Annotation Type Addressing

-     @Target(value=TYPE)
      @Retention(value=RUNTIME)
      @Documented
      @WebServiceFeatureAnnotation(id="http://www.w3.org/2005/08/addressing/module",
                                   bean=AddressingFeature.class)
      public @interface Addressing

  This feature represents the use of WS-Addressing with either the SOAP 1.1/HTTP or SOAP 1.2/HTTP binding. Using this feature with any other binding is NOT required.

  The following describes the effects of this feature with respect to be enabled or disabled:

  - ENABLED: In this Mode, WS-Addressing will be enabled. At runtime, WS-Addressing headers MUST be consumed by the receiver and produced by the sender even if the WSDL declares otherwise. The mustUnderstand="0" attribute MUST be used on the response WS-Addressing headers.
  - DISABLED: In this Mode, WS-Addressing will be disabled even if an associated WSDL specifies otherwise. At runtime, WS-Addressing headers MUST NOT be used. WS-Addressing may be explicitly disabled to prevent a JAX-WS implementation from consuming and producing WS-Addressing headers. If an application has implemented WS-Addressing itself, it MUST explicitly disable this feature. Not doing so may break compatibility with future versions of JAX-WS.

  The `required` property can be used to specify if WS-Addressing headers MUST be present on incoming messages. By default the `required` property is `false`.

  The definition of this annotation is incomplete in this release of JAX-WS as there is no standard way to convey the use of WS-Addressing via a WSDL and there is no standard definition for the default value of WS-Addressing `Action` headers; however, the runtime behavior of this annotation is well-defined. It is intended that a future version of JAX-WS will require the use of the standard mechanism to convey the use of WS-Addressing via WSDL and default values for WS-Addressing `Action` headers as defined by the W3C WG on WS-Addressing.

  To write a portable endpoint and its corresponding client with this version of JAX-WS, an endpoint MUST explicitly specify what WS-Addressing `Actions` are to be used via the `Action` and `FaultAction` annotations. The client MUST explicitly enable addresssing via the `AddressingFeature`, and for each invocation, the client MUST explicitly set the `BindingProvider.SOAPACTION_URI_PROPERTY`. After the W3C WG on WS-Addressing has specified how the use of WS-Addressing is specified in the WSDL, and what the default value must be for Action headers, a future version of JAX-WS will remove these requirements.

  See Web Services Addressing - Core and Web Services Addressing 1.0 - SOAP Binding for more information on WS-Addressing.

  Since:
    JAX-WS 2.1

- - ### Optional Element Summary

    Optional Elements
    Modifier and Type | Optional Element and Description
    --- | ---
    `boolean` | `enabled` Specifies if this feature is enabled or disabled.
    `boolean` | `required` Property to determine if WS-Addressing headers MUST be present on incoming messages.

- - ### Element Detail

    - #### enabled

          public abstract boolean enabled

      Specifies if this feature is enabled or disabled.
      Default:
        true

    - #### required

          public abstract boolean required

      Property to determine if WS-Addressing headers MUST be present on incoming messages.
      Default:
        false

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.