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
class RespectBindingFeature
public final class RespectBindingFeature
extends WebServiceFeature
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:
- ENABLED: In this Mode, a JAX-WS runtime MUST assure that all
required
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 known WebServiceFeature using either the appropriate
annotation associated with that WebServiceFeature on the server, or one of
the following methods on the client:
- {@link Service#getPort(QName,Class,WebServiceFeature...)}
- {@link Service#getPort(Class,WebServiceFeature...)}
- {@link Service#getPort(EndpointReference,Class,WebServiceFeature...)}
- {@link Service#createDispatch(QName,Class,Service.Mode mode,WebServiceFeature...)}
- {@link Service#createDispatch(EndpointReference,Class,Service.Mode,WebServiceFeature...)}
- {@link Service#createDispatch(QName,JAXBContext,Service.Mode,WebServiceFeature...)}
- {@link Service#createDispatch(EndpointReference,JAXBContext,Service.Mode,WebServiceFeature...)}
- {@link EndpointReference#getPort(Class,WebServiceFeature...)}
- One of the
getXXXPort(WebServiceFeatures...) methods on a
generated Service.
The runtime MUST also make sure that binding of
SEI parameters/return values respect the wsdl:binding.
With this feature enabled, if a required (wsdl:required="true")
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:
- Client: runtime MUST throw a
WebServiceException no sooner than when one of the methods
above is invoked but no later than the first invocation of an endpoint
operation.
- Server: throw a WebServiceException and the endpoint MUST fail to deploy
- DISABLED: In this Mode, an implementation may choose whether
to inspect the
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.
|
Field Summary |
static String |
ID
Constant value identifying the RespectBindingFeature |
| Constructor Summary |
Creates an RespectBindingFeature.
|
Creates an RespectBindingFeature
|
| Method Summary |
String |
Get the unique identifier for this WebServiceFeature.
|
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
ID
public static final String ID
-
Constant value identifying the RespectBindingFeature
RespectBindingFeature
public RespectBindingFeature()
-
Creates an
RespectBindingFeature.
The instance created will be enabled.
RespectBindingFeature
public RespectBindingFeature(boolean enabled)
-
Creates an RespectBindingFeature
- Parameters:
enabled - specifies whether this feature should
be enabled or not.
getID
public String getID()
-
{@inheritDoc}
- Overrides:
getID in class WebServiceFeature
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:
The official Sun™ documentation can be found here at
http://java.sun.com/javase/6/docs/api/.
javax.xml.ws.WebServiceFeature