< prev index next >

src/java.xml.ws/share/classes/com/sun/xml/internal/ws/api/client/ServiceInterceptor.java

Print this page




  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     /**


< prev index next >