|
JAX-WS v2.1 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.xml.ws.WebServiceFeature
javax.xml.ws.RespectBindingFeature
public class RespectBindingFeature
This feature clarifies the use of the wsdl:binding
in a JAX-WS runtime.
This feature is only useful with web services that have an
associated WSDL. Enabling this feature requires that a JAX-WS
implementation inspect the wsdl:binding
for an
endpoint at runtime to make sure that all wsdl:extensions
that have the required
attribute set to true
are understood and are being used.
The following describes the affects of this feature with respect to be enabled or disabled:
wsdl:binding
extensions are either understood
and used by the runtime, or explicitly disabled by the web service
application. A web service application can disable a particular
extension that has a know WebServiceFeature
using
either the BindingType.features()
element on the server
or one of the following methods on the client:
Service.getPort(QName,Class,WebServiceFeature...)
Service.getPort(Class,WebServiceFeature...)
Service.getPort(EndpointReference,Class,WebServiceFeature...)
Service.createDispatch(QName,Class,
Service.Mode mode,WebServiceFeature...)
Service.createDispatch(EndpointReference,
Class,Service.Mode,
WebServiceFeature...)
Service.createDispatch(QName,
JAXBContext, Service.Mode, WebServiceFeature...)
Service.createDispatch(EndpointReference,
JAXBContext, Service.Mode, WebServiceFeature...)
EndpointReference.getPort(Class,WebServiceFeature...)
getXXXPort(WebServiceFeatures...)
methods on a
generated Service
.
wsdl:binding
.
With this feature enabled, if a required
wsdl:binding
extension is in the WSDL and it is not
supported by a JAX-WS runtime and it has not
been explicitly turned off by the web service developer, then
that JAX-WS runtime must behave appropriately based on whether it is
on the client or server:
WebServiceException
no sooner than one of the method
above is invoked but no later than the first invocation of an endpoint
operation.
wsdl:binding or not and to what degree
the wsdl:binding
will be inspected. For example,
one implementation may choose to behave as if this feature is enabled,
another implementation may only choose to verify the SEI's
parameter/return type bindings.
AddressingFeature
Field Summary | |
---|---|
static java.lang.String |
ID
Constant value identifying the RespectBindingFeature |
Fields inherited from class javax.xml.ws.WebServiceFeature |
---|
enabled |
Constructor Summary | |
---|---|
RespectBindingFeature()
Create an RespectBindingFeature . |
|
RespectBindingFeature(boolean enabled)
Create an RespectBindingFeature |
Method Summary | |
---|---|
java.lang.String |
getID()
Get the unique identifier for this WebServiceFeature. |
Methods inherited from class javax.xml.ws.WebServiceFeature |
---|
isEnabled |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String ID
Constructor Detail |
---|
public RespectBindingFeature()
RespectBindingFeature
.
The instance created will be enabled.
public RespectBindingFeature(boolean enabled)
enabled
- specifies whether this feature should
be enabled or not.Method Detail |
---|
public java.lang.String getID()
getID
in class WebServiceFeature
|
JAX-WS v2.1 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright © 2006 by Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A. All Rights Reserved.