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