/*
 * JBoss, Home of Professional Open Source
 * Copyright 2005, JBoss Inc., and individual contributors as indicated
 * by the @authors tag. See the copyright.txt in the distribution for a
 * full listing of individual contributors.
 *
 * This is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1 of
 * the License, or (at your option) any later version.
 *
 * This software 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this software; if not, write to the Free
 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
 * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
 */
package javax.xml.ws;

// $Id: Service.java 3576 2007-06-14 09:23:52Z thomas.diesler@jboss.com $

import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.net.URL;
import java.util.Iterator;

import javax.xml.bind.JAXBContext;
import javax.xml.namespace.QName;
import javax.xml.ws.handler.HandlerResolver;
import javax.xml.ws.spi.Provider;
import javax.xml.ws.spi.ServiceDelegate;

/**
 * <code>Service</code> objects provide the client view of a Web service.
 * <p><code>Service</code> acts as a factory of the following:
 * <ul>
 * <li>Proxies for a target service endpoint.
 * <li>Instances of <code>javax.xml.ws.Dispatch</code> for
 *     dynamic message-oriented invocation of a remote
 *     operation.
 * </li>
 *
 * <p>The ports available on a service can be enumerated using the
 * <code>getPorts</code> method. Alternatively, you can pass a
 * service endpoint interface to the unary <code>getPort</code> method
 * and let the runtime select a compatible port.
 *
 * <p>Handler chains for all the objects created by a <code>Service</code>
 * can be set by means of a <code>HandlerResolver</code>.
 *
 * <p>An <code>Executor</code> may be set on the service in order
 * to gain better control over the threads used to dispatch asynchronous
 * callbacks. For instance, thread pooling with certain parameters
 * can be enabled by creating a <code>ThreadPoolExecutor</code> and
 * registering it with the service.
 *
 * @since JAX-WS 2.0
 *
 * @see javax.xml.ws.spi.Provider
 * @see javax.xml.ws.handler.HandlerResolver
 * @see java.util.concurrent.Executor
 **/
public class Service
{
   protected ServiceDelegate delegate;

   /**
    * The orientation of a dynamic client or service. MESSAGE provides
    * access to entire protocol message, PAYLOAD to protocol message
    * payload only.
    **/
   public enum Mode
   {
      MESSAGE, PAYLOAD
   };

   protected Service(java.net.URL wsdlDocumentLocation, QName serviceName)
   {
      delegate = Provider.provider().createServiceDelegate(wsdlDocumentLocation, serviceName, this.getClass());
   }

   /** 
    * The getPort method returns a proxy. A service client
    * uses this proxy to invoke operations on the target
    * service endpoint. The <code>serviceEndpointInterface</code>
    * specifies the service endpoint interface that is supported by
    * the created dynamic proxy instance.
    *
    * @param portName  Qualified name of the service endpoint in
    *                  the WSDL service description.
    * @param serviceEndpointInterface Service endpoint interface
    *                  supported by the dynamic proxy instance.
    * @return Object Proxy instance that
    *                supports the specified service endpoint
    *                interface.
    * @throws WebServiceException This exception is thrown in the
    *                  following cases:
    *                  <UL>
    *                  <LI>If there is an error in creation of
    *                      the proxy.
    *                  <LI>If there is any missing WSDL metadata
    *                      as required by this method.
    *                  <LI>If an illegal
    *                      <code>serviceEndpointInterface</code>
    *                      or <code>portName</code> is specified.
    *                  </UL>
    * @see java.lang.reflect.Proxy
    * @see java.lang.reflect.InvocationHandler
    **/
   public <T> T getPort(QName portName, Class<T> serviceEndpointInterface)
   {
      return delegate.getPort(portName, serviceEndpointInterface);
   }

   /** 
    * The getPort method returns a proxy. A service client
    * uses this proxy to invoke operations on the target
    * service endpoint. The <code>serviceEndpointInterface</code>
    * specifies the service endpoint interface that is supported by
    * the created dynamic proxy instance.
    *
    * @param portName  Qualified name of the service endpoint in
    *                  the WSDL service description.
    * @param serviceEndpointInterface Service endpoint interface
    *                  supported by the dynamic proxy instance.
    * @param features  A list of WebServiceFeatures to configure on the 
    *                proxy.  Supported features not in the <code>features
    *                </code> parameter will have their default values.
    * @return Object Proxy instance that
    *                supports the specified service endpoint
    *                interface.
    * @throws WebServiceException This exception is thrown in the
    *                  following cases:
    *                  <UL>
    *                  <LI>If there is an error in creation of
    *                      the proxy.
    *                  <LI>If there is any missing WSDL metadata
    *                      as required by this method.
    *                  <LI>If an illegal
    *                      <code>serviceEndpointInterface</code>
    *                      or <code>portName</code> is specified.
    *                  <LI>If a feature is enabled that is not compatible
    *                      with this port or is unsupported.
    *                  </UL>
    * @see java.lang.reflect.Proxy
    * @see java.lang.reflect.InvocationHandler
    * @see WebServiceFeature
    * 
    * @since JAX-WS 2.1
    **/
   public <T> T getPort(QName portName, Class<T> serviceEndpointInterface, WebServiceFeature... features)
   {
      return delegate.getPort(portName, serviceEndpointInterface, features);
   }

   /** 
    * The getPort method returns a proxy. The parameter
    * <code>serviceEndpointInterface</code> specifies the service
    * endpoint interface that is supported by the returned proxy.
    * In the implementation of this method, the JAX-WS
    * runtime system takes the responsibility of selecting a protocol
    * binding (and a port) and configuring the proxy accordingly.
    * The returned proxy should not be reconfigured by the client.
    *
    * @param serviceEndpointInterface Service endpoint interface.
    * @return Object instance that supports the
    *                  specified service endpoint interface.
    * @throws WebServiceException
    *                  <UL>
    *                  <LI>If there is an error during creation
    *                      of the proxy.
    *                  <LI>If there is any missing WSDL metadata
    *                      as required by this method.
    *                  <LI>If an illegal.
    *                      <code>serviceEndpointInterface</code>
    *                      is specified.
    *                  </UL>
    **/
   public <T> T getPort(Class<T> serviceEndpointInterface)
   {
      return delegate.getPort(serviceEndpointInterface);
   }

   /**
    * The getPort method returns a proxy. The parameter
    * <code>serviceEndpointInterface</code> specifies the service
    * endpoint interface that is supported by the returned proxy.
    * In the implementation of this method, the JAX-WS
    * runtime system takes the responsibility of selecting a protocol
    * binding (and a port) and configuring the proxy accordingly.
    * The returned proxy should not be reconfigured by the client.
    *
    * @param serviceEndpointInterface Service endpoint interface.
    * @param features  A list of WebServiceFeatures to configure on the 
    *                proxy.  Supported features not in the <code>features
    *                </code> parameter will have their default values.
    * @return Object instance that supports the
    *                  specified service endpoint interface.
    * @throws WebServiceException
    *                  <UL>
    *                  <LI>If there is an error during creation
    *                      of the proxy.
    *                  <LI>If there is any missing WSDL metadata
    *                      as required by this method.
    *                  <LI>If an illegal
    *                      <code>serviceEndpointInterface</code>
    *                      is specified.
    *                  <LI>If a feature is enabled that is not compatible
    *                      with this port or is unsupported.
    *                  </UL>
    *
    * @see WebServiceFeature
    *
    * @since JAX-WS 2.1
    **/
   public <T> T getPort(Class<T> serviceEndpointInterface, WebServiceFeature... features)
   {
      return delegate.getPort(serviceEndpointInterface, features);
   }

   /** 
    * The getPort method returns a proxy.
    * The parameter <code>endpointReference</code> specifies the
    * endpoint that will be invoked by the returned proxy.  If there
    * are any reference parameters in the 
    * <code>endpointReference</code>, then those reference
    * parameters MUST appear as SOAP headers, indicating them to be
    * reference parameters, on all messages sent to the endpoint.
    * The <code>endpointReference's</code> address MUST be used
    * for invocations on the endpoint.
    * The parameter <code>serviceEndpointInterface</code> specifies
    * the service endpoint interface that is supported by the 
    * returned proxy.
    * In the implementation of this method, the JAX-WS
    * runtime system takes the responsibility of selecting a protocol
    * binding (and a port) and configuring the proxy accordingly from
    * the WSDL associated with this <code>Service</code> instance or
    * from the WSDL Metadata from the <code>endpointReference</code>.
    * If this <code>Service</code> instance has a WSDL and 
    * the <code>endpointReference</code>
    * also has a WSDL, then the WSDL from this instance will be used.
    * If this <code>Service</code> instance does not have a WSDL and
    * the <code>endpointReference</code> does have a WSDL, then the 
    * WSDL from the <code>endpointReference</code> will be used.
    * The returned proxy should not be reconfigured by the client.
    * If this <code>Service</code> instance has a known proxy 
    * port that matches the information contained in 
    * the WSDL,
    * then that proxy is returned, otherwise a WebServiceException
    * is thrown.
    * <p>
    * Calling this method has the same behavior as the following
    * <pre>
    * port = service.getPort(portName, serviceEndpointInterface);
    * </pre>
    * where the <code>portName</code> is retrieved from the 
    * <code>wsaw:EndpontName</code> attribute of the
    * <code>wsaw:ServiceName</code> element in the 
    * metadata of the <code>endpointReference</code> or from the 
    * <code>serviceEndpointInterface</code> and the WSDL
    * associated with this <code>Service</code> instance.
    * <br>
    * See <a href="http://www.w3.org/TR/2006/CR-ws-addr-wsdl-20060529/">WS-Addressing - WSDL 1.0
    * </a>.
    *
    * @param endpointReference  The <code>EndpointReference</code>
    * for the target service endpoint that will be invoked by the
    * returned proxy.
    * @param serviceEndpointInterface Service endpoint interface.
    * @param features  An array of WebServiceFeatures to configure on the 
    *                proxy.  Supported features not in the <code>features
    *                </code> parameter will have their default values.
    * @return Object Proxy instance that supports the
    *                  specified service endpoint interface.
    * @throws WebServiceException
    *                  <UL>
    *                  <LI>If there is an error during creation
    *                      of the proxy.
    *                  <LI>If there is any missing WSDL metadata
    *                      as required by this method.
    *                  <LI>If the <code>wsaw:EndpointName</code> is
    *                      missing from the <code>endpointReference</code>
    *                      or does not match a wsdl:Port
    *                      in the WSDL metadata.
    *                  <LI>If the <code>wsaw:ServiceName</code> in the
    *                      <code>endpointReference</code> metadata does not
    *                      match the <code>serviceName</code> of this
    *                      <code>Service</code> instance.
    *                  <LI>If an invalid
    *                      <code>endpointReference</code>
    *                      is specified.
    *                  <LI>If an invalid
    *                      <code>serviceEndpointInterface</code>
    *                      is specified.
    *                  <LI>If a feature is enabled that is not compatible
    *                      with this port or is unsupported.
    *                  </UL>
    *
    *  @since JAX-WS 2.1
    **/
   public <T> T getPort(EndpointReference endpointReference, Class<T> serviceEndpointInterface, WebServiceFeature... features)
   {
      return delegate.getPort(endpointReference, serviceEndpointInterface, features);
   }

   /** 
    * Creates a new port for the service. Ports created in this way contain
    * no WSDL port type information and can only be used for creating
    * <code>Dispatch</code>instances.
    *
    * @param portName  Qualified name for the target service endpoint.
    * @param bindingId A String identifier of a binding.
    * @param endpointAddress Address of the target service endpoint as a URI.
    * @throws WebServiceException If any error in the creation of
    * the port.
    *
    * @see javax.xml.ws.soap.SOAPBinding#SOAP11HTTP_BINDING
    * @see javax.xml.ws.soap.SOAPBinding#SOAP12HTTP_BINDING
    * @see javax.xml.ws.http.HTTPBinding#HTTP_BINDING
    **/
   public void addPort(QName portName, String bindingId, String endpointAddress)
   {
      delegate.addPort(portName, bindingId, endpointAddress);
   }

   /** 
    * Creates a <code>Dispatch</code> instance for use with objects of
    * the users choosing.
    *
    * @param portName  Qualified name for the target service endpoint
    * @param type The class of object used for messages or message
    * payloads. Implementations are required to support
    * <code>javax.xml.transform.Source</code>, <code>javax.xml.soap.SOAPMessage</code>
    * and <code>javax.activation.DataSource</code>, depending on
    * the binding in use.
    * @param mode Controls whether the created dispatch instance is message
    * or payload oriented, i.e. whether the user will work with complete
    * protocol messages or message payloads. E.g. when using the SOAP
    * protocol, this parameter controls whether the user will work with
    * SOAP messages or the contents of a SOAP body. Mode MUST be MESSAGE
    * when type is SOAPMessage.
    *
    * @return Dispatch instance.
    * @throws WebServiceException If any error in the creation of
    *                  the <code>Dispatch</code> object.
    *
    * @see javax.xml.transform.Source
    * @see javax.xml.soap.SOAPMessage
    **/
   public <T> Dispatch<T> createDispatch(QName portName, Class<T> type, Mode mode)
   {
      return delegate.createDispatch(portName, type, mode);
   }

   /** 
    * Creates a <code>Dispatch</code> instance for use with objects of
    * the users choosing.
    *
    * @param portName  Qualified name for the target service endpoint
    * @param type The class of object used for messages or message
    * payloads. Implementations are required to support
    * javax.xml.transform.Source and javax.xml.soap.SOAPMessage.
    * @param mode Controls whether the created dispatch instance is message
    * or payload oriented, i.e. whether the user will work with complete
    * protocol messages or message payloads. E.g. when using the SOAP
    * protocol, this parameter controls whether the user will work with
    * SOAP messages or the contents of a SOAP body. Mode MUST be MESSAGE
    * when type is SOAPMessage.
    * @param features  A list of WebServiceFeatures to configure on the 
    *                proxy.  Supported features not in the <code>features
    *                </code> parameter will have their default values.
    *
    * @return Dispatch instance.
    * @throws WebServiceException If any error in the creation of
    *                  the <code>Dispatch</code> object or if a 
    *                  feature is enabled that is not compatible with 
    *                  this port or is unsupported.
    *
    * @see javax.xml.transform.Source
    * @see javax.xml.soap.SOAPMessage
    * @see WebServiceFeature
    *
    * @since JAX-WS 2.1
    **/
   public <T> Dispatch<T> createDispatch(QName portName, Class<T> type, Service.Mode mode, WebServiceFeature... features)
   {
      return delegate.createDispatch(portName, type, mode, features);
   }

   /** 
    * Creates a <code>Dispatch</code> instance for use with objects of
    * the users choosing. If there
    * are any reference parameters in the 
    * <code>endpointReference</code>, then those reference
    * parameters MUST appear as SOAP headers, indicating them to be
    * reference parameters, on all messages sent to the endpoint.
    * The <code>endpointReference's</code> address MUST be used
    * for invocations on the endpoint.
    * In the implementation of this method, the JAX-WS
    * runtime system takes the responsibility of selecting a protocol
    * binding (and a port) and configuring the dispatch accordingly from
    * the WSDL associated with this <code>Service</code> instance or
    * from the WSDL Metadata from the <code>endpointReference</code>.
    * If this <code>Service</code> instance has a WSDL and 
    * the <code>endpointReference</code>
    * also has a WSDL, then the WSDL from this instance will be used.
    * If this <code>Service</code> instance does not have a WSDL and
    * the <code>endpointReference</code> does have a WSDL, then the 
    * WSDL from the <code>endpointReference</code> will be used.     
    * <p>
    * This method behaves the same as calling
    * <pre>
    * dispatch = service.createDispatch(portName, type, mode, features);
    * </pre>
    * where the <code>portName</code> is retrieved from the 
    * <code>wsaw:EndpointName</code> attribute of the <code>wsaw:ServiceName</code>
    * element in the 
    * metadata of the <code>endpointReference</code>.
    * <br>
    * See <a href="http://www.w3.org/TR/2006/CR-ws-addr-wsdl-20060529/">WS-Addressing - WSDL 1.0
    * </a>.
    *
    * @param endpointReference  The <code>EndpointReference</code>
    * for the target service endpoint that will be invoked by the
    * returned <code>Dispatch</code> object.
    * @param type The class of object used to messages or message
    * payloads. Implementations are required to support
    * javax.xml.transform.Source and javax.xml.soap.SOAPMessage.
    * @param mode Controls whether the created dispatch instance is message
    * or payload oriented, i.e. whether the user will work with complete
    * protocol messages or message payloads. E.g. when using the SOAP
    * protocol, this parameter controls whether the user will work with
    * SOAP messages or the contents of a SOAP body. Mode MUST be MESSAGE
    * when type is SOAPMessage.
    * @param features  An array of WebServiceFeatures to configure on the 
    *                proxy.  Supported features not in the <code>features
    *                </code> parameter will have their default values.
    *
    * @return Dispatch instance
    * @throws WebServiceException 
    *                  <UL>
    *                    <LI>If there is any missing WSDL metadata
    *                      as required by this method.
    *                    <li>If the <code>wsaw:ServiceName</code> element 
    *                    or the <code>wsaw:EndpointName</code> attribute
    *                    is missing in the metdata of the 
    *                    <code>endpointReference</code>.
    *                    <li>If the <code>wsaw:ServiceName</code> does not
    *                    match the <code>serviceName</code> of this instance.
    *                    <li>If the <code>wsaw:EndpointName</code> does not
    *                    match a valid wsdl:Port in the WSDL metadata.
    *                    <li>If any error in the creation of
    *                     the <code>Dispatch</code> object.
    *                    <li>if a feature is enabled that is not 
    *                    compatible with this port or is unsupported.
    *                  </UL>
    *
    * @see javax.xml.transform.Source
    * @see javax.xml.soap.SOAPMessage
    * @see WebServiceFeature;
    *
    * @since JAX-WS 2.1
    **/
   public <T> Dispatch<T> createDispatch(EndpointReference endpointReference, Class<T> type, Service.Mode mode, WebServiceFeature... features)
   {
      return delegate.createDispatch(endpointReference, type, mode, features);
   }

   /** 
    * Creates a <code>Dispatch</code> instance for use with JAXB
    * generated objects.
    *
    * @param portName  Qualified name for the target service endpoint
    * @param context The JAXB context used to marshall and unmarshall
    * messages or message payloads.
    * @param mode Controls whether the created dispatch instance is message
    * or payload oriented, i.e. whether the user will work with complete
    * protocol messages or message payloads. E.g. when using the SOAP
    * protocol, this parameter controls whether the user will work with
    * SOAP messages or the contents of a SOAP body.
    *
    * @return Dispatch instance.
    * @throws WebServiceException If any error in the creation of
    *                  the <code>Dispatch</code> object.
    *
    * @see javax.xml.bind.JAXBContext
    **/
   public Dispatch<Object> createDispatch(QName portName, JAXBContext context, Mode mode)
   {
      return delegate.createDispatch(portName, context, mode);
   }

   /** 
    * Creates a <code>Dispatch</code> instance for use with JAXB
    * generated objects.
    *
    * @param portName  Qualified name for the target service endpoint
    * @param context The JAXB context used to marshall and unmarshall
    * messages or message payloads.
    * @param mode Controls whether the created dispatch instance is message
    * or payload oriented, i.e. whether the user will work with complete
    * protocol messages or message payloads. E.g. when using the SOAP
    * protocol, this parameter controls whether the user will work with
    * SOAP messages or the contents of a SOAP body.
    * @param features  A list of WebServiceFeatures to configure on the 
    *                proxy.  Supported features not in the <code>features
    *                </code> parameter will have their default values.
    *
    * @return Dispatch instance.
    * @throws WebServiceException If any error in the creation of
    *                  the <code>Dispatch</code> object or if a 
    *                  feature is enabled that is not compatible with 
    *                  this port or is unsupported.
    *
    * @see javax.xml.bind.JAXBContext
    * @see WebServiceFeature
    *
    * @since JAX-WS 2.1
    **/
   public Dispatch<Object> createDispatch(QName portName, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
   {
      return delegate.createDispatch(portName, context, mode, features);
   }

   /** 
    * Creates a <code>Dispatch</code> instance for use with JAXB
    * generated objects. If there
    * are any reference parameters in the 
    * <code>endpointReference</code>, then those reference
    * parameters MUST appear as SOAP headers, indicating them to be
    * reference parameters, on all messages sent to the endpoint.
    * The <code>endpointReference's</code> address MUST be used
    * for invocations on the endpoint.
    * In the implementation of this method, the JAX-WS
    * runtime system takes the responsibility of selecting a protocol
    * binding (and a port) and configuring the dispatch accordingly from
    * the WSDL associated with this <code>Service</code> instance or
    * from the WSDL Metadata from the <code>endpointReference</code>.
    * If this <code>Service</code> instance has a WSDL and 
    * the <code>endpointReference</code>
    * also has a WSDL, then the WSDL from this instance will be used.
    * If this <code>Service</code> instance does not have a WSDL and
    * the <code>endpointReference</code> does have a WSDL, then the 
    * WSDL from the <code>endpointReference</code> will be used.      
    * <p>
    * This method behavies the same as calling
    * <pre>
    * dispatch = service.createDispatch(portName, context, mode, features);
    * </pre>
    * where the <code>portName</code> is retrieved from the 
    * <code>wsaw:EndpointName</code> attribute of the <code>wsaw:ServiceName</code>
    * element in the 
    * metadata of the <code>endpointReference</code>.
    * <br>
    * See <a href="http://www.w3.org/TR/2006/CR-ws-addr-wsdl-20060529/">WS-Addressing - WSDL 1.0
    * </a>.
    *
    * @param endpointReference  The <code>EndpointReference</code>
    * for the target service endpoint that will be invoked by the
    * returned <code>Dispatch</code> object.
    * @param context The JAXB context used to marshall and unmarshall
    * messages or message payloads.
    * @param mode Controls whether the created dispatch instance is message
    * or payload oriented, i.e. whether the user will work with complete
    * protocol messages or message payloads. E.g. when using the SOAP
    * protocol, this parameter controls whether the user will work with
    * SOAP messages or the contents of a SOAP body.
    * @param features  An array of WebServiceFeatures to configure on the 
    *                proxy.  Supported features not in the <code>features
    *                </code> parameter will have their default values.
    *
    * @return Dispatch instance
    * @throws WebServiceException 
    * @throws WebServiceException 
    *                  <UL>
    *                    <li>If there is any missing WSDL metadata
    *                      as required by this method.
    *                    <li>If the <code>wsaw:ServiceName</code> element 
    *                    or the <code>wsaw:EndpointName</code> attribute
    *                    is missing in the metdata of the 
    *                    <code>endpointReference</code>.
    *                    <li>If the <code>wsaw:ServiceName</code> does not
    *                    match the <code>serviceName</code> of this instance.
    *                    <li>If the <code>wsaw:EndpointName</code> does not
    *                    match a valid wsdl:Port in the WSDL metadata.
    *                    <li>If any error in the creation of
    *                  the <code>Dispatch</code> object.
    *                    <li>if a feature is enabled that is not 
    *                    compatible with this port or is unsupported.
    *                  </UL>
    *
    * @see javax.xml.bind.JAXBContext
    * @see WebServiceFeature
    *
    * @since JAX-WS 2.1
    **/
   public Dispatch<Object> createDispatch(EndpointReference endpointReference, JAXBContext context, Service.Mode mode, WebServiceFeature... features)
   {
      return delegate.createDispatch(endpointReference, context, mode, features);
   }

   /** 
    * Gets the name of this service.
    * @return Qualified name of this service
    **/
   public QName getServiceName()
   {
      return delegate.getServiceName();
   }

   /** 
    * Returns an <code>Iterator</code> for the list of
    * <code>QName</code>s of service endpoints grouped by this
    * service
    *
    * @return Returns <code>java.util.Iterator</code> with elements
    *         of type <code>javax.xml.namespace.QName</code>.
    * @throws WebServiceException If this Service class does not
    *         have access to the required WSDL metadata.
    **/
   public Iterator<javax.xml.namespace.QName> getPorts()
   {
      return delegate.getPorts();
   }

   /** 
    * Gets the location of the WSDL document for this Service.
    *
    * @return URL for the location of the WSDL document for
    *         this service.
    **/
   public java.net.URL getWSDLDocumentLocation()
   {
      return delegate.getWSDLDocumentLocation();
   }

   /**
    * Returns the configured handler resolver.
    *
    * @return HandlerResolver The <code>HandlerResolver</code> being
    *         used by this <code>Service</code> instance, or <code>null</code>
    *         if there isn't one.
    **/
   public HandlerResolver getHandlerResolver()
   {
      return delegate.getHandlerResolver();
   }

   /**
    * Sets the <code>HandlerResolver</code> for this <code>Service</code>
    * instance.
    * <p>
    * The handler resolver, if present, will be called once for each
    * proxy or dispatch instance that is created, and the handler chain
    * returned by the resolver will be set on the instance.
    *
    * @param handlerResolver The <code>HandlerResolver</code> to use
    *        for all subsequently created proxy/dispatch objects.
    *
    * @see javax.xml.ws.handler.HandlerResolver
    **/
   public void setHandlerResolver(HandlerResolver handlerResolver)
   {
      delegate.setHandlerResolver(handlerResolver);
   }

   /**
    * Returns the executor for this <code>Service</code>instance.
    *
    * The executor is used for all asynchronous invocations that
    * require callbacks.
    *
    * @return The <code>java.util.concurrent.Executor</code> to be
    *         used to invoke a callback.
    *
    * @see java.util.concurrent.Executor
    **/
   public java.util.concurrent.Executor getExecutor()
   {
      return delegate.getExecutor();
   }

   /**
    * Sets the executor for this <code>Service</code> instance.
    *
    * The executor is used for all asynchronous invocations that
    * require callbacks.
    *
    * @param executor The <code>java.util.concurrent.Executor</code>
    *        to be used to invoke a callback.
    *
    * @throws SecurityException If the instance does not support
    *         setting an executor for security reasons (e.g. the
    *         necessary permissions are missing).
    *
    * @see java.util.concurrent.Executor
    **/
   public void setExecutor(java.util.concurrent.Executor executor)
   {
      delegate.setExecutor(executor);
   }

   /**
    * Create a <code>Service</code> instance.
    *
    * The specified WSDL document location and service qualified name MUST
    * uniquely identify a <code>wsdl:service</code> element.
    *
    * @param wsdlLocation URL for the WSDL document location
    *                             for the service
    * @param serviceName QName for the service
    * @throws WebServiceException If any error in creation of the
    *                    specified service.
    **/
   public static Service create(URL wsdlLocation, QName serviceName)
   {
      return new Service(wsdlLocation, serviceName);
   }

   /**
    * Create a <code>Service</code> instance.
    *
    * @param serviceName QName for the service
    * @throws WebServiceException If any error in creation of the
    *                    specified service
    */
   public static Service create(QName serviceName)
   {
      return create(null, serviceName);
   }
}
