1 /* 2 * Copyright 2007 Sun Microsystems, Inc. All rights reserved. 3 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. 4 */ 5 6 package javax.xml.ws; 7 8 9 /** The <code>Binding</code> interface is the base interface 10 * for JAX-WS protocol bindings. 11 * 12 * @since JAX-WS 2.0 13 **/ 14 public interface Binding { 15 16 /** 17 * Gets a copy of the handler chain for a protocol binding instance. 18 * If the returned chain is modified a call to <code>setHandlerChain</code> 19 * is required to configure the binding instance with the new chain. 20 * 21 * @return java.util.List<Handler> Handler chain 22 */ 23 public java.util.List<javax.xml.ws.handler.Handler> getHandlerChain(); 24 25 /** 26 * Sets the handler chain for the protocol binding instance. 27 * 28 * @param chain A List of handler configuration entries 29 * @throws WebServiceException On an error in the configuration of 30 * the handler chain 31 * @throws java.lang.UnsupportedOperationException If this 32 * operation is not supported. This may be done to 33 * avoid any overriding of a pre-configured handler 34 * chain. 35 */ 36 public void setHandlerChain(java.util.List<javax.xml.ws.handler.Handler> chain); 37 38 /** 39 * Get the URI for this binding instance. 40 * 41 * @return String The binding identifier for the port. 42 * Never returns <code>null</code> 43 * 44 * @since JAX-WS 2.1 45 */ 46 String getBindingID(); 47 } 48