Top Description Methods
javax.xml.ws.soap

public @Interface Addressing

extends Annotation
Annotations
@Target:TYPE, METHOD, FIELD
@Retention:RUNTIME
@Documented
@WebServiceFeatureAnnotation
id:http://www.w3.org/2005/08/addressing/module
bean:AddressingFeature
Imports
java.lang.annotation.Documented, .Target, .ElementType, .Retention, .RetentionPolicy, javax.xml.ws.WebServiceRef, .WebServiceProvider, javax.xml.ws.soap.AddressingFeature.Responses, javax.xml.ws.spi.WebServiceFeatureAnnotation
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 javax.jws.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
1.6, JAX-WS 2.1

Method Summary

Modifier and TypeMethod and Description
public boolean

Returns:

true if endpoint supports WS-Addressing, false otherwise
enabled()

Specifies if this feature is enabled or disabled.

public boolean

Returns:

true if endpoint requires WS-Addressing, false otherwise
required()

If addressing is enabled, this property determines whether the endpoint requires WS-Addressing.

public AddressingFeature.Responses

Returns:

supported response types
responses()

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

Inherited from java.lang.annotation.Annotation:
annotationTypeequalshashCodetoString

Method Detail

enabledback to summary
public 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.

Returns:boolean

true if endpoint supports WS-Addressing, false otherwise

requiredback to summary
public 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.

Returns:boolean

true if endpoint requires WS-Addressing, false otherwise

responsesback to summary
public AddressingFeature.Responses responses()

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

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

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.

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.

Returns:AddressingFeature.Responses

supported response types

Since
1.7, JAX-WS 2.2