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
class AddressingFeature

java.lang.Object extended by javax.xml.ws.WebServiceFeature extended by javax.xml.ws.soap.AddressingFeature

public final class AddressingFeature
extends WebServiceFeature

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.

Enabling this feature on the client will cause the JAX-WS runtime to include WS-Addressing headers in SOAP messages.

If the web service developer has not explicitly enabled this feature, it MAY be automatically enabled if the associated WSDL enables WS-Addressing with an implementation recognized WSDL extension element. However, in this version of JAX-WS, there is no standard WSDL extension that a client can rely on to automatically enable WS-Addressing, nor is there a standard default value specified for WS-Addressing Action headers.

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 this 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 {@link javax.xml.ws.RespectBindingFeature} for more information on required WSDL extensions.

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

The {@link #required} property can be used to specify if WS-Addressing headers MUST be present on incoming messages. This property only has meaning when used on the endpoint and has no affect when used on the client. By default the required property is false.

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


Field Summary
static String ID
          Constant value identifying the AddressingFeature
protected boolean required
          Property for the required feature parameter.
 
Fields inherited from class javax.xml.ws.WebServiceFeature
enabled
 
Constructor Summary

          Create an AddressingFeature.
AddressingFeature(boolean enabled)

          Create an AddressingFeature
AddressingFeature(boolean enabled, boolean required)

          Create an AddressingFeature
 
Method Summary
 String

          Get the unique identifier for this WebServiceFeature.
 boolean

          Gets the boolean value used to determine if WS-Addressing headers MUST be present on incoming messages.
 
Methods inherited from class javax.xml.ws.WebServiceFeature
getID, isEnabled
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ID

public static final String ID
Constant value identifying the AddressingFeature

required

protected boolean required
Property for the required feature parameter. When WS-Addressing is enabled, the value of this property will be used to specify if WS-Addressing headers MUST be present on incoming messages. This property only has meaning on the endpoint and has no affect when used on the client.
Constructor Detail

AddressingFeature

public AddressingFeature()
Create an AddressingFeature. The instance created will be enabled.


AddressingFeature

public AddressingFeature(boolean enabled)
Create an AddressingFeature

Parameters:
enabled - specifies whether this feature should be enabled or not.

AddressingFeature

public AddressingFeature(boolean enabled,
                         boolean required)
Create an AddressingFeature

Parameters:
enabled - specifies whether this feature should be enabled or not.
required - specifies whether WS-Addressing headers MUST be present on incoming messages. This property only has meaning on the endpoint and has no affect when used on the client.
Method Detail

getID

public String getID()
{@inheritDoc}

Overrides:
getID in class WebServiceFeature

isRequired

public boolean isRequired()
Gets the boolean value used to determine if WS-Addressing headers MUST be present on incoming messages. This property only has meaning on the endpoint, and has no affect when used on the client.

Returns:
the current required value


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/.