Tue, 07 Nov 2017 18:54:04 -0800
Added tag jdk8u162-b06 for changeset 6095742f8034
1 /*
2 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
26 package javax.xml.ws;
28 import java.lang.annotation.Documented;
29 import java.lang.annotation.Target;
30 import java.lang.annotation.ElementType;
31 import java.lang.annotation.Retention;
32 import java.lang.annotation.RetentionPolicy;
33 import javax.xml.ws.spi.WebServiceFeatureAnnotation;
36 /**
37 * This feature clarifies the use of the <code>wsdl:binding</code>
38 * in a JAX-WS runtime.
39 * <p>
40 * This annotation MUST only be used in conjunction the
41 * <code>javax.jws.WebService</code>, {@link WebServiceProvider},
42 * {@link WebServiceRef} annotations.
43 * When used with the <code>javax.jws.WebService</code> annotation this
44 * annotation MUST only be used on the service endpoint implementation
45 * class.
46 * When used with a <code>WebServiceRef</code> annotation, this annotation
47 * MUST only be used when a proxy instance is created. The injected SEI
48 * proxy, and endpoint MUST honor the values of the <code>RespectBinding</code>
49 * annotation.
50 * <p>
51 *
52 * This annotation's behaviour is defined by the corresponding feature
53 * {@link RespectBindingFeature}.
54 *
55 * @see RespectBindingFeature
56 *
57 * @since JAX-WS 2.1
58 */
59 @Target({ElementType.TYPE, ElementType.METHOD, ElementType.FIELD})
60 @Retention(RetentionPolicy.RUNTIME)
61 @Documented
62 @WebServiceFeatureAnnotation(id=RespectBindingFeature.ID,bean=RespectBindingFeature.class)
63 public @interface RespectBinding {
64 /**
65 * Specifies if this feature is enabled or disabled.
66 */
67 boolean enabled() default true;
68 }