This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.


javax.xml.ws.soap
annotation Addressing

java.lang.annotation.Annotation extended by javax.xml.ws.soap.Addressing

public interface annotation Addressing
extends Annotation

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:

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 {@link Action} and {@link FaultAction} annotations. The client MUST explicitly enable addresssing via the {@link AddressingFeature}, and for each invocation, the client MUST explicitly set the {@link 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.


Method Summary
 boolean

          Specifies if this feature is enabled or disabled.
 boolean

          Property to determine if WS-Addressing headers MUST be present on incoming messages.
 
Methods inherited from class java.lang.annotation.Annotation
annotationType, equals, hashCode, toString
 

Method Detail

enabled

public boolean enabled()
Specifies if this feature is enabled or disabled.


required

public boolean required()
Property to determine if WS-Addressing headers MUST be present on incoming messages.



This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.