javax.xml.ws.soap
Annotation Type Addressing


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

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

This annotation MUST only be used in conjunction with the WebService, WebServiceProvider, and WebServiceRef annotations. When used with a javax.jws.WebService annotation, this annotation MUST only be used on the service endpoint implementation class. When used with a WebServiceRef annotation, this annotation MUST only be used when a proxy instance is created. The injected SEI proxy, and endpoint MUST honor the values of the Addressing annotation.

This annotation's behaviour is defined by the corresponding feature AddressingFeature.

Since:
JAX-WS 2.1

Optional Element Summary
 boolean enabled
          Specifies if this feature is enabled or disabled.
 boolean required
          If addressing is enabled, this property determines whether the endpoint requires WS-Addressing.
 AddressingFeature.Responses responses
          If addressing is enabled, this property determines whether endpoint requires the use of anonymous responses, or non-anonymous responses, or all.
 

enabled

public abstract boolean enabled
Specifies if this feature is enabled or disabled. If enabled, it means the endpoint supports WS-Addressing but does not require its use. Corresponding 3.1.1 Addressing Assertion must be generated in the generated WSDL.

Default:
true

required

public abstract boolean required
If addressing is enabled, this property determines whether the endpoint requires WS-Addressing. If required is true, the endpoint requires WS-Addressing and WS-Addressing headers MUST be present on incoming messages. A corresponding 3.1.1 Addressing Assertion must be generated in the WSDL.

Default:
false

responses

public abstract AddressingFeature.Responses responses
If addressing is enabled, this property determines whether endpoint requires the use of anonymous responses, or non-anonymous responses, or all.

AddressingFeature.Responses.ALL supports all response types and this is the default value.

AddressingFeature.Responses.ANONYMOUS requires the use of only anonymous responses. It will result into wsam:AnonymousResponses nested assertion as specified in 3.1.2 AnonymousResponses Assertion in the generated WSDL.

AddressingFeature.Responses.NON_ANONYMOUS requires the use of only non-anonymous responses. It will result into wsam:NonAnonymousResponses nested assertion as specified in 3.1.3 NonAnonymousResponses Assertion in the generated WSDL.

Since:
JAX-WS 2.2
Default:
javax.xml.ws.soap.AddressingFeature.Responses.ALL


Submit a bug or feature

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41