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
|
/*
* 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: RespectBinding.java 4630 2007-09-26 10:14:18Z heiko.braun@jboss.com $
import java.lang.annotation.Documented;
import java.lang.annotation.Target;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import javax.xml.ws.spi.WebServiceFeatureAnnotation;
/**
* 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.RespectBindingFeature
*
* @since JAX-WS 2.1
*/
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@WebServiceFeatureAnnotation(id = RespectBindingFeature.ID, bean = RespectBindingFeature.class)
public @interface RespectBinding {
/**
* Specifies if this feature is enabled or disabled.
*/
boolean enabled() default true;
}
|
