51 * @since 2.1 EA3
52 * @see ServiceInterceptorFactory
53 */
54 public abstract class ServiceInterceptor {
55 /**
56 * Called before {@link WSBinding} is created, to allow interceptors
57 * to add {@link WebServiceFeature}s to the created {@link WSBinding}.
58 *
59 * @param port
60 * Information about the port for which dispatch/proxy will be created.
61 * @param serviceEndpointInterface
62 * Null if the created binding is for {@link Dispatch}. Otheriwse
63 * it represents the port interface of the proxy to be created.
64 * @param defaultFeatures
65 * The list of features that are currently scheduled to be set for
66 * the newly created {@link WSBinding}.
67 *
68 * @return
69 * A set of features to be added to the newly created {@link WSBinding}.
70 * Can be empty but never null.
71 * <tt>defaultFeatures</tt> will take precedence over what this method
72 * would return (because it includes user-specified ones which will
73 * take the at-most priority), but features you return from this method
74 * will take precedence over {@link BindingID}'s
75 * {@link BindingID#createBuiltinFeatureList() implicit features}.
76 */
77 public List<WebServiceFeature> preCreateBinding(@NotNull WSPortInfo port, @Nullable Class<?> serviceEndpointInterface, @NotNull WSFeatureList defaultFeatures) {
78 return Collections.emptyList();
79 }
80
81 /**
82 * A callback to notify the event of creation of proxy object for SEI endpoint. The
83 * callback could set some properties on the {@link BindingProvider}.
84 *
85 * @param bp created proxy instance
86 * @param serviceEndpointInterface SEI of the endpoint
87 */
88 public void postCreateProxy(@NotNull WSBindingProvider bp,@NotNull Class<?> serviceEndpointInterface) {
89 }
90
91 /**
|
51 * @since 2.1 EA3
52 * @see ServiceInterceptorFactory
53 */
54 public abstract class ServiceInterceptor {
55 /**
56 * Called before {@link WSBinding} is created, to allow interceptors
57 * to add {@link WebServiceFeature}s to the created {@link WSBinding}.
58 *
59 * @param port
60 * Information about the port for which dispatch/proxy will be created.
61 * @param serviceEndpointInterface
62 * Null if the created binding is for {@link Dispatch}. Otheriwse
63 * it represents the port interface of the proxy to be created.
64 * @param defaultFeatures
65 * The list of features that are currently scheduled to be set for
66 * the newly created {@link WSBinding}.
67 *
68 * @return
69 * A set of features to be added to the newly created {@link WSBinding}.
70 * Can be empty but never null.
71 * {@code defaultFeatures} will take precedence over what this method
72 * would return (because it includes user-specified ones which will
73 * take the at-most priority), but features you return from this method
74 * will take precedence over {@link BindingID}'s
75 * {@link BindingID#createBuiltinFeatureList() implicit features}.
76 */
77 public List<WebServiceFeature> preCreateBinding(@NotNull WSPortInfo port, @Nullable Class<?> serviceEndpointInterface, @NotNull WSFeatureList defaultFeatures) {
78 return Collections.emptyList();
79 }
80
81 /**
82 * A callback to notify the event of creation of proxy object for SEI endpoint. The
83 * callback could set some properties on the {@link BindingProvider}.
84 *
85 * @param bp created proxy instance
86 * @param serviceEndpointInterface SEI of the endpoint
87 */
88 public void postCreateProxy(@NotNull WSBindingProvider bp,@NotNull Class<?> serviceEndpointInterface) {
89 }
90
91 /**
|