Module com.sun.xml.ws.rt

Package com.sun.xml.ws.binding

Class BindingImpl

java.lang.Object

com.sun.xml.ws.binding.BindingImpl

All Implemented Interfaces:

WSBinding, javax.xml.ws.Binding

Direct Known Subclasses:

HTTPBindingImpl, SOAPBindingImpl

public abstract class BindingImpl
extends Object
implements WSBinding

Instances are created by the service, which then sets the handler chain on the binding impl.

This class is made abstract as we don't see a situation when a BindingImpl has much meaning without binding id. IOW, for a specific binding there will be a class extending BindingImpl, for example SOAPBindingImpl.

The spi Binding interface extends Binding.

Author:

WS Development Team

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	BindingImpl.MessageKey	Experimental: Identify messages based on the name of the message and the operation that uses this message.

Field Summary

Fields

Modifier and Type	Field	Description
protected static javax.xml.ws.WebServiceFeature[]	EMPTY_FEATURES
protected Map<BindingImpl.MessageKey,WebServiceFeatureList>	faultMessageFeatures
protected WebServiceFeatureList	features
protected Map<QName,WebServiceFeatureList>	inputMessageFeatures
protected MessageContextFactory	messageContextFactory
protected Map<QName,WebServiceFeatureList>	operationFeatures
protected Map<QName,WebServiceFeatureList>	outputMessageFeatures
protected javax.xml.ws.Service.Mode	serviceMode

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	BindingImpl(BindingID bindingId, javax.xml.ws.WebServiceFeature... features)

Method Summary

Modifier and Type	Method	Description
boolean	addKnownHeader(QName headerQName)	Adds header QName to set known to be supported by this binding
static BindingImpl	create(BindingID bindingId)
static BindingImpl	create(BindingID bindingId, javax.xml.ws.WebServiceFeature[] features)
Codec	createCodec()
AddressingVersion	getAddressingVersion()	Gets the WS-Addressing version of this binding.
BindingID	getBindingId()	Gets the binding ID, which uniquely identifies the binding.
String	getBindingID()
static WSBinding	getDefaultBinding()
WebServiceFeatureList	getFaultMessageFeatures(QName operationName, QName messageName)	Experimental: Returns a list of features associated with WSBinding that apply to one of the fault messages of an operation.
<F extends javax.xml.ws.WebServiceFeature> F	getFeature(Class<F> featureType)	Gets a WebServiceFeature of the specific type.
WebServiceFeatureList	getFeatures()	Returns a list of features associated with WSBinding.
List<javax.xml.ws.handler.Handler>	getHandlerChain()
HandlerConfiguration	getHandlerConfig()
WebServiceFeatureList	getInputMessageFeatures(QName operationName)	Experimental: Returns a list of features associated with WSBinding that apply to the input message of an operation.
Set<QName>	getKnownHeaders()	Returns set of header QNames known to be supported by this binding.
MessageContextFactory	getMessageContextFactory()
<F extends javax.xml.ws.WebServiceFeature> F	getOperationFeature(Class<F> featureType, QName operationName)	Experimental: Gets a WebServiceFeature of the specific type that applies to an operation.
WebServiceFeatureList	getOperationFeatures(QName operationName)	Experimental: Returns a list of features associated with WSBinding that apply to a particular operation.
WebServiceFeatureList	getOutputMessageFeatures(QName operationName)	Experimental: Returns a list of features associated with WSBinding that apply to the output message of an operation.
SOAPVersion	getSOAPVersion()	Gets the SOAP version of this binding.
static void	initializeJavaActivationHandlers()
boolean	isFeatureEnabled(Class<? extends javax.xml.ws.WebServiceFeature> feature)	Checks if a particular WebServiceFeature is enabled.
boolean	isOperationFeatureEnabled(Class<? extends javax.xml.ws.WebServiceFeature> featureType, QName operationName)	Experimental: Checks if a particular WebServiceFeature on an operation is enabled.
void	setFaultMessageFeatures(QName operationName, QName messageName, javax.xml.ws.WebServiceFeature... newFeatures)
protected void	setHandlerConfig(HandlerConfiguration handlerConfig)
void	setInputMessageFeatures(QName operationName, javax.xml.ws.WebServiceFeature... newFeatures)
void	setMode(javax.xml.ws.Service.Mode mode)
void	setOperationFeatures(QName operationName, javax.xml.ws.WebServiceFeature... newFeatures)
void	setOutputMessageFeatures(QName operationName, javax.xml.ws.WebServiceFeature... newFeatures)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.xml.ws.Binding

setHandlerChain

Field Detail

EMPTY_FEATURES

protected static final javax.xml.ws.WebServiceFeature[] EMPTY_FEATURES

features

protected final WebServiceFeatureList features

operationFeatures

protected final Map<QName,WebServiceFeatureList> operationFeatures

inputMessageFeatures

protected final Map<QName,WebServiceFeatureList> inputMessageFeatures

outputMessageFeatures

protected final Map<QName,WebServiceFeatureList> outputMessageFeatures

faultMessageFeatures

protected final Map<BindingImpl.MessageKey,WebServiceFeatureList> faultMessageFeatures

serviceMode

protected javax.xml.ws.Service.Mode serviceMode

messageContextFactory

protected MessageContextFactory messageContextFactory

Constructor Detail

BindingImpl

protected BindingImpl(BindingID bindingId,
                      javax.xml.ws.WebServiceFeature... features)

Method Detail

getHandlerChain

@NotNull
public List<javax.xml.ws.handler.Handler> getHandlerChain()

Specified by:

getHandlerChain in interface javax.xml.ws.Binding

Specified by:

getHandlerChain in interface WSBinding

getHandlerConfig

public HandlerConfiguration getHandlerConfig()

setHandlerConfig

protected void setHandlerConfig(HandlerConfiguration handlerConfig)

setMode

public void setMode(@NotNull
                    javax.xml.ws.Service.Mode mode)

getKnownHeaders

public Set<QName> getKnownHeaders()

Description copied from interface: WSBinding

Returns set of header QNames known to be supported by this binding.

Specified by:

getKnownHeaders in interface WSBinding

Returns:

Set of known QNames

addKnownHeader

public boolean addKnownHeader(QName headerQName)

Description copied from interface: WSBinding

Adds header QName to set known to be supported by this binding

Specified by:

addKnownHeader in interface WSBinding

Parameters:

headerQName - Known header QName

Returns:

true, if new entry was added; false, if known header QName was already known

getBindingId

@NotNull
public BindingID getBindingId()

Description copied from interface: WSBinding

Gets the binding ID, which uniquely identifies the binding.

The relevant specs define the binding IDs and what they mean. The ID is used in many places to identify the kind of binding (such as SOAP1.1, SOAP1.2, REST, ...)

Specified by:

getBindingId in interface WSBinding

Returns:

Always non-null same value.

getSOAPVersion

public final SOAPVersion getSOAPVersion()

Description copied from interface: WSBinding

Gets the SOAP version of this binding. TODO: clarify what to do with XML/HTTP binding

This is just a short-cut for getBindingID().getSOAPVersion()

Specified by:

getSOAPVersion in interface WSBinding

Returns:

If the binding is using SOAP, this method returns a SOAPVersion constant. If the binding is not based on SOAP, this method returns null. See Message for how a non-SOAP binding shall be handled by Tubes.

getAddressingVersion

public AddressingVersion getAddressingVersion()

Description copied from interface: WSBinding

Gets the WS-Addressing version of this binding.
TODO: clarify what to do with XML/HTTP binding

Specified by:

getAddressingVersion in interface WSBinding

Returns:

If the binding is using SOAP and WS-Addressing is enabled, this method returns a AddressingVersion constant. If binding is not using SOAP or WS-Addressing is not enabled, this method returns null. This might be little slow as it has to go over all the features on binding. Its advisable to cache the addressingVersion wherever possible and reuse it.

createCodec

@NotNull
public final Codec createCodec()

initializeJavaActivationHandlers

public static void initializeJavaActivationHandlers()

create

public static BindingImpl create(@NotNull
                                 BindingID bindingId)

create

public static BindingImpl create(@NotNull
                                 BindingID bindingId,
                                 javax.xml.ws.WebServiceFeature[] features)

getDefaultBinding

public static WSBinding getDefaultBinding()

getBindingID

public String getBindingID()

Specified by:

getBindingID in interface javax.xml.ws.Binding

getFeature

@Nullable
public <F extends javax.xml.ws.WebServiceFeature> F getFeature(@NotNull
                                                               Class<F> featureType)

Description copied from interface: WSBinding

Gets a WebServiceFeature of the specific type.

Specified by:

getFeature in interface WSBinding

Parameters:

featureType - The type of the feature to retrieve.

Returns:

If the feature is present and enabled, return a non-null instance. Otherwise null.

getOperationFeature

@Nullable
public <F extends javax.xml.ws.WebServiceFeature> F getOperationFeature(@NotNull
                                                                        Class<F> featureType,
                                                                        @NotNull
                                                                        QName operationName)

Description copied from interface: WSBinding

Experimental: Gets a WebServiceFeature of the specific type that applies to an operation.

Specified by:

getOperationFeature in interface WSBinding

Parameters:

featureType - The type of the feature to retrieve.

operationName - The WSDL name of the operation.

Returns:

If the feature is present and enabled, return a non-null instance. Otherwise null.

isFeatureEnabled

public boolean isFeatureEnabled(@NotNull
                                Class<? extends javax.xml.ws.WebServiceFeature> feature)

Description copied from interface: WSBinding

Checks if a particular WebServiceFeature is enabled.

Specified by:

isFeatureEnabled in interface WSBinding

Returns:

true if enabled.

isOperationFeatureEnabled

public boolean isOperationFeatureEnabled(@NotNull
                                         Class<? extends javax.xml.ws.WebServiceFeature> featureType,
                                         @NotNull
                                         QName operationName)

Description copied from interface: WSBinding

Experimental: Checks if a particular WebServiceFeature on an operation is enabled.

Specified by:

isOperationFeatureEnabled in interface WSBinding

operationName - The WSDL name of the operation.

Returns:

true if enabled.

getFeatures

@NotNull
public WebServiceFeatureList getFeatures()

Description copied from interface: WSBinding

Returns a list of features associated with WSBinding.

Specified by:

getFeatures in interface WSBinding

getOperationFeatures

@NotNull
public WebServiceFeatureList getOperationFeatures(@NotNull
                                                  QName operationName)

Description copied from interface: WSBinding

Experimental: Returns a list of features associated with WSBinding that apply to a particular operation.

Specified by:

getOperationFeatures in interface WSBinding

Parameters:

operationName - The WSDL name of the operation.

getInputMessageFeatures

@NotNull
public WebServiceFeatureList getInputMessageFeatures(@NotNull
                                                     QName operationName)

Description copied from interface: WSBinding

Experimental: Returns a list of features associated with WSBinding that apply to the input message of an operation.

Specified by:

getInputMessageFeatures in interface WSBinding

Parameters:

operationName - The WSDL name of the operation.

getOutputMessageFeatures

@NotNull
public WebServiceFeatureList getOutputMessageFeatures(@NotNull
                                                      QName operationName)

Description copied from interface: WSBinding

Experimental: Returns a list of features associated with WSBinding that apply to the output message of an operation.

Specified by:

getOutputMessageFeatures in interface WSBinding

Parameters:

operationName - The WSDL name of the operation.

getFaultMessageFeatures

@NotNull
public WebServiceFeatureList getFaultMessageFeatures(@NotNull
                                                     QName operationName,
                                                     @NotNull
                                                     QName messageName)

Description copied from interface: WSBinding

Experimental: Returns a list of features associated with WSBinding that apply to one of the fault messages of an operation.

Specified by:

getFaultMessageFeatures in interface WSBinding

Parameters:

operationName - The WSDL name of the operation.

messageName - The WSDL name of the fault message.

setOperationFeatures

public void setOperationFeatures(@NotNull
                                 QName operationName,
                                 javax.xml.ws.WebServiceFeature... newFeatures)

setInputMessageFeatures

public void setInputMessageFeatures(@NotNull
                                    QName operationName,
                                    javax.xml.ws.WebServiceFeature... newFeatures)

setOutputMessageFeatures

public void setOutputMessageFeatures(@NotNull
                                     QName operationName,
                                     javax.xml.ws.WebServiceFeature... newFeatures)

setFaultMessageFeatures

public void setFaultMessageFeatures(@NotNull
                                    QName operationName,
                                    @NotNull
                                    QName messageName,
                                    javax.xml.ws.WebServiceFeature... newFeatures)

getMessageContextFactory

@NotNull
public MessageContextFactory getMessageContextFactory()

Specified by:

getMessageContextFactory in interface WSBinding

Returns:

A MessageContextFactory configured according to the binding's features.