Package: RespectBinding

RespectBinding

Coverage

1: /*
2: * Copyright (c) 2005, 2020 Oracle and/or its affiliates. All rights reserved.
3: *
4: * This program and the accompanying materials are made available under the
5: * terms of the Eclipse Distribution License v. 1.0, which is available at
6: * http://www.eclipse.org/org/documents/edl-v10.php.
7: *
8: * SPDX-License-Identifier: BSD-3-Clause
9: */
10:
11: package jakarta.xml.ws;
12:
13: import java.lang.annotation.Documented;
14: import java.lang.annotation.Target;
15: import java.lang.annotation.ElementType;
16: import java.lang.annotation.Retention;
17: import java.lang.annotation.RetentionPolicy;
18: import jakarta.xml.ws.spi.WebServiceFeatureAnnotation;
19:
20:
21: /**
22: * This feature clarifies the use of the {@code wsdl:binding}
23: * in a Jakarta XML Web Services runtime.
24: * <p>
25: * This annotation MUST only be used in conjunction the
26: * {@code jakarta.jws.WebService}, {@link WebServiceProvider},
27: * {@link WebServiceRef} annotations.
28: * When used with the {@code jakarta.jws.WebService} annotation this
29: * annotation MUST only be used on the service endpoint implementation
30: * class.
31: * When used with a {@code WebServiceRef} annotation, this annotation
32: * MUST only be used when a proxy instance is created. The injected SEI
33: * proxy, and endpoint MUST honor the values of the {@code RespectBinding}
34: * annotation.
35: * <p>
36: *
37: * This annotation's behaviour is defined by the corresponding feature
38: * {@link RespectBindingFeature}.
39: *
40: * @see RespectBindingFeature
41: *
42: * @since 1.6, JAX-WS 2.1
43: */
44: @Target({ElementType.TYPE, ElementType.METHOD, ElementType.FIELD})
45: @Retention(RetentionPolicy.RUNTIME)
46: @Documented
47: @WebServiceFeatureAnnotation(id=RespectBindingFeature.ID,bean=RespectBindingFeature.class)
48: public @interface RespectBinding {
49: /**
50: * Specifies if this feature is enabled or disabled.
51: *
52: * @return {@code true} if this feature is enabled, {@code false} otherwise
53: */
54: boolean enabled() default true;
55: }