Package com.sun.xml.ws.api.client

Class ServiceInterceptor

java.lang.Object

com.sun.xml.ws.api.client.ServiceInterceptor

public abstract class ServiceInterceptor
extends Object

Interception point for inner working of WSService.

System-level code could hook an implementation of this to WSService to augument its behavior.

Since:

2.1 EA3

Author:

Kohsuke Kawaguchi

See Also:

• ServiceInterceptorFactory

Constructor Summary

Constructors

Constructor	Description
ServiceInterceptor()

Method Summary

Modifier and Type	Method	Description
static ServiceInterceptor	aggregate(ServiceInterceptor... interceptors)	Aggregates multiple interceptors into one facade.
void	postCreateDispatch(WSBindingProvider bp)	A callback to notify that a Dispatch object is created.
void	postCreateProxy(WSBindingProvider bp, Class<?> serviceEndpointInterface)	A callback to notify the event of creation of proxy object for SEI endpoint.
List<jakarta.xml.ws.WebServiceFeature>	preCreateBinding(WSPortInfo port, Class<?> serviceEndpointInterface, WSFeatureList defaultFeatures)	Called before WSBinding is created, to allow interceptors to add WebServiceFeatures to the created WSBinding.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ServiceInterceptor

public ServiceInterceptor()

Method Details

preCreateBinding

public List<jakarta.xml.ws.WebServiceFeature> preCreateBinding(@NotNull
 WSPortInfo port,
 @Nullable
 Class<?> serviceEndpointInterface,
 @NotNull
 WSFeatureList defaultFeatures)

Called before WSBinding is created, to allow interceptors to add WebServiceFeatures to the created WSBinding.

Parameters:

port - Information about the port for which dispatch/proxy will be created.

serviceEndpointInterface - Null if the created binding is for Dispatch. Otheriwse it represents the port interface of the proxy to be created.

defaultFeatures - The list of features that are currently scheduled to be set for the newly created WSBinding.

Returns:

A set of features to be added to the newly created WSBinding. Can be empty but never null. defaultFeatures will take precedence over what this method would return (because it includes user-specified ones which will take the at-most priority), but features you return from this method will take precedence over BindingID's implicit features.

postCreateProxy

public void postCreateProxy(@NotNull
 WSBindingProvider bp,
 @NotNull
 Class<?> serviceEndpointInterface)

A callback to notify the event of creation of proxy object for SEI endpoint. The callback could set some properties on the BindingProvider.

Parameters:

bp - created proxy instance

serviceEndpointInterface - SEI of the endpoint

postCreateDispatch

public void postCreateDispatch(@NotNull
 WSBindingProvider bp)

A callback to notify that a Dispatch object is created. The callback could set some properties on the BindingProvider.

Parameters:

bp - BindingProvider of dispatch object

aggregate

public static ServiceInterceptor aggregate(ServiceInterceptor... interceptors)

Aggregates multiple interceptors into one facade.