diff -r 88b85470e72c -r f50545b5e2f1 src/share/jaxws_classes/com/sun/xml/internal/ws/api/client/ServiceInterceptor.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/share/jaxws_classes/com/sun/xml/internal/ws/api/client/ServiceInterceptor.java Tue Mar 06 16:09:35 2012 -0800 @@ -0,0 +1,125 @@ +/* + * Copyright (c) 1997, 2010, Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. Oracle designates this + * particular file as subject to the "Classpath" exception as provided + * by Oracle in the LICENSE file that accompanied this code. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +package com.sun.xml.internal.ws.api.client; + +import com.sun.istack.internal.NotNull; +import com.sun.istack.internal.Nullable; +import com.sun.xml.internal.ws.api.BindingID; +import com.sun.xml.internal.ws.api.WSBinding; +import com.sun.xml.internal.ws.api.WSFeatureList; +import com.sun.xml.internal.ws.api.WSService; +import com.sun.xml.internal.ws.developer.WSBindingProvider; + +import javax.xml.ws.BindingProvider; +import javax.xml.ws.Dispatch; +import javax.xml.ws.WebServiceFeature; +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; + +/** + * Interception point for inner working of {@link WSService}. + * + *

+ * System-level code could hook an implementation of this to + * {@link WSService} to augument its behavior. + * + * @author Kohsuke Kawaguchi + * @since 2.1 EA3 + * @see ServiceInterceptorFactory + */ +public abstract class ServiceInterceptor { + /** + * Called before {@link WSBinding} is created, to allow interceptors + * to add {@link WebServiceFeature}s to the created {@link WSBinding}. + * + * @param port + * Information about the port for which dispatch/proxy will be created. + * @param serviceEndpointInterface + * Null if the created binding is for {@link Dispatch}. Otheriwse + * it represents the port interface of the proxy to be created. + * @param defaultFeatures + * The list of features that are currently scheduled to be set for + * the newly created {@link WSBinding}. + * + * @return + * A set of features to be added to the newly created {@link 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 {@link BindingID}'s + * {@link BindingID#createBuiltinFeatureList() implicit features}. + */ + public List preCreateBinding(@NotNull WSPortInfo port, @Nullable Class serviceEndpointInterface, @NotNull WSFeatureList defaultFeatures) { + return Collections.emptyList(); + } + + /** + * A callback to notify the event of creation of proxy object for SEI endpoint. The + * callback could set some properties on the {@link BindingProvider}. + * + * @param bp created proxy instance + * @param serviceEndpointInterface SEI of the endpoint + */ + public void postCreateProxy(@NotNull WSBindingProvider bp,@NotNull Class serviceEndpointInterface) { + } + + /** + * A callback to notify that a {@link Dispatch} object is created. The callback + * could set some properties on the {@link BindingProvider}. + * + * @param bp BindingProvider of dispatch object + */ + public void postCreateDispatch(@NotNull WSBindingProvider bp) { + } + + /** + * Aggregates multiple interceptors into one facade. + */ + public static ServiceInterceptor aggregate(final ServiceInterceptor... interceptors) { + if(interceptors.length==1) + return interceptors[0]; + return new ServiceInterceptor() { + public List preCreateBinding(@NotNull WSPortInfo port, @Nullable Class portInterface, @NotNull WSFeatureList defaultFeatures) { + List r = new ArrayList(); + for (ServiceInterceptor si : interceptors) + r.addAll(si.preCreateBinding(port,portInterface,defaultFeatures)); + return r; + } + + public void postCreateProxy(@NotNull WSBindingProvider bp, @NotNull Class serviceEndpointInterface) { + for (ServiceInterceptor si : interceptors) + si.postCreateProxy(bp,serviceEndpointInterface); + } + + public void postCreateDispatch(@NotNull WSBindingProvider bp) { + for (ServiceInterceptor si : interceptors) + si.postCreateDispatch(bp); + } + }; + } +}