1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
|
/*
* JBoss, Home of Professional Open Source
* Copyright 2005, JBoss Inc., and individual contributors as indicated
* by the @authors tag. See the copyright.txt in the distribution for a
* full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package javax.xml.ws;
// $Id: RespectBindingFeature.java 4630 2007-09-26 10:14:18Z heiko.braun@jboss.com $
import javax.xml.ws.WebServiceFeature;
/**
* This feature clarifies the use of the <code>wsdl:binding</code>
* in a JAX-WS runtime.
* <p>
* This feature is only useful with web services that have an
* associated WSDL. Enabling this feature requires that a JAX-WS
* implementation inspect the <code>wsdl:binding</code> for an
* endpoint at runtime to make sure that all <code>wsdl:extensions</code>
* that have the <code>required</code> attribute set to <code>true</code>
* are understood and are being used.
* <p>
* The following describes the affects of this feature with respect
* to be enabled or disabled:
* <ul>
* <li> ENABLED: In this Mode, a JAX-WS runtime MUST assure that all
* required <code>wsdl:binding</code> 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 <code>WebServiceFeature</code> using
* either the {@link BindingType#features} element on the server
* or one of the following methods on the client:
* <ul>
* <li>{@link Service#getPort(QName,Class,WebServiceFeature...)}
* <li>{@link Service#getPort(Class,WebServiceFeature...)}
* <li>{@link Service#getPort(EndpointReference,Class,WebServiceFeature...)}
* <li>{@link Service#createDispatch(QName,Class,
* Service.Mode mode,WebServiceFeature...)}
* <li>{@link Service21#createDispatch(EndpointReference,
* Class,Service.Mode,
* WebServiceFeature...)}
* <li>{@link Service#createDispatch(QName,
* JAXBContext, Service.Mode, WebServiceFeature...)}
* <li>{@link Service#createDispatch(EndpointReference,
* JAXBContext, Service.Mode, WebServiceFeature...)}
* <li>{@link EndpointReference#getPort(Class,WebServiceFeature...)}
* <li>One of the <code>getXXXPort(WebServiceFeatures...)</code> methods on a
* generated <code>Service</code>.
* </ul>
* The runtime MUST also make sure that binding of
* SEI parameters/return values respect the <code>wsdl:binding</code>.
* With this feature enabled, if a required
* <code>wsdl:binding</code> 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:
* <UL>
* <li>Client: runtime MUST throw a
* <code>WebServiceException</code> no sooner than when one of the methods
* above is invoked but no later than the first invocation of an endpoint
* operation.
* <li>throw a WebServiceException and the endpoint MUST fail to deploy
* </ul>
* <li> DISABLED: In this Mode, an implementation may choose whether
* to inspect the <code>wsdl:binding<code> or not and to what degree
* the <code>wsdl:binding</code> 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.
* </ul>
*
* @see javax.xml.ws.soap.AddressingFeature
*
* @since JAX-WS 2.1
*/
public final class RespectBindingFeature extends WebServiceFeature
{
/**
*
* Constant value identifying the RespectBindingFeature
*/
public static final String ID = "javax.xml.ws.InspectBindingFeature";
/**
* Create an <code>RespectBindingFeature</code>.
* The instance created will be enabled.
*/
public RespectBindingFeature()
{
this.enabled = true;
}
/**
* Create an RespectBindingFeature
*
* @param enabled specifies whether this feature should
* be enabled or not.
*/
public RespectBindingFeature(boolean enabled)
{
this.enabled = enabled;
}
/**
* {@inheritDoc}
*/
public String getID()
{
return ID;
}
}
|
