/*
    * Copyright 2002-2014 the original author or authors.
    *
    * Licensed under the Apache License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    *
    *      http://www.apache.org/licenses/LICENSE-2.0
    *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  package org.springframework.remoting.jaxws;
  
  import java.io.IOException;
  import java.net.URL;
  import java.util.concurrent.Executor;
  import javax.xml.namespace.QName;
  import javax.xml.ws.Service;
  import javax.xml.ws.WebServiceFeature;
  import javax.xml.ws.handler.HandlerResolver;
  
  import org.springframework.core.io.Resource;
  import org.springframework.lang.UsesJava7;
  import org.springframework.util.Assert;
  
  /**
   * Factory for locally defined JAX-WS {@link javax.xml.ws.Service} references.
   * Uses the JAX-WS {@link javax.xml.ws.Service#create} factory API underneath.
   *
   * <p>Serves as base class for {@link LocalJaxWsServiceFactoryBean} as well as
   * {@link JaxWsPortClientInterceptor} and {@link JaxWsPortProxyFactoryBean}.
   *
   * @author Juergen Hoeller
   * @since 2.5
   * @see javax.xml.ws.Service
   * @see LocalJaxWsServiceFactoryBean
   * @see JaxWsPortClientInterceptor
   * @see JaxWsPortProxyFactoryBean
   */
  public class LocalJaxWsServiceFactory {
  
  	private URL wsdlDocumentUrl;
  
  	private String namespaceUri;
  
  	private String serviceName;
  
  	private WebServiceFeature[] serviceFeatures;
  
  	private Executor executor;
  
  	private HandlerResolver handlerResolver;
  
  
  	/**
  	 * Set the URL of the WSDL document that describes the service.
  	 * @see #setWsdlDocumentResource(Resource)
  	 */
  	public void setWsdlDocumentUrl(URL wsdlDocumentUrl) {
  		this.wsdlDocumentUrl = wsdlDocumentUrl;
  	}
  
  	/**
  	 * Set the WSDL document URL as a {@link Resource}.
  	 * @throws IOException
  	 * @since 3.2
  	 */
  	public void setWsdlDocumentResource(Resource wsdlDocumentResource) throws IOException {
  		Assert.notNull(wsdlDocumentResource, "WSDL Resource must not be null.");
  		this.wsdlDocumentUrl = wsdlDocumentResource.getURL();
  	}
  
  	/**
  	 * Return the URL of the WSDL document that describes the service.
  	 */
  	public URL getWsdlDocumentUrl() {
  		return this.wsdlDocumentUrl;
  	}
  
  	/**
  	 * Set the namespace URI of the service.
  	 * Corresponds to the WSDL "targetNamespace".
  	 */
  	public void setNamespaceUri(String namespaceUri) {
  		this.namespaceUri = (namespaceUri != null ? namespaceUri.trim() : null);
  	}
  
  	/**
  	 * Return the namespace URI of the service.
  	 */
  	public String getNamespaceUri() {
  		return this.namespaceUri;
  	}
  
 	/**
 	 * Set the name of the service to look up.
 	 * Corresponds to the "wsdl:service" name.
 	 */
 	public void setServiceName(String serviceName) {
 		this.serviceName = serviceName;
 	}
 
 	/**
 	 * Return the name of the service.
 	 */
 	public String getServiceName() {
 		return this.serviceName;
 	}
 
 	/**
 	 * Specify WebServiceFeature objects (e.g. as inner bean definitions)
 	 * to apply to JAX-WS service creation.
 	 * <p>Note: This mechanism requires JAX-WS 2.2 or higher.
 	 * @since 4.0
 	 * @see Service#create(QName, WebServiceFeature...)
 	 */
 	public void setServiceFeatures(WebServiceFeature... serviceFeatures) {
 		this.serviceFeatures = serviceFeatures;
 	}
 
 	/**
 	 * Set the JDK concurrent executor to use for asynchronous executions
 	 * that require callbacks.
 	 * @see javax.xml.ws.Service#setExecutor
 	 */
 	public void setExecutor(Executor executor) {
 		this.executor = executor;
 	}
 
 	/**
 	 * Set the JAX-WS HandlerResolver to use for all proxies and dispatchers
 	 * created through this factory.
 	 * @see javax.xml.ws.Service#setHandlerResolver
 	 */
 	public void setHandlerResolver(HandlerResolver handlerResolver) {
 		this.handlerResolver = handlerResolver;
 	}
 
 
 	/**
 	 * Create a JAX-WS Service according to the parameters of this factory.
 	 * @see #setServiceName
 	 * @see #setWsdlDocumentUrl
 	 */
 	@UsesJava7  // optional use of Service#create with WebServiceFeature[]
 	public Service createJaxWsService() {
 		Assert.notNull(this.serviceName, "No service name specified");
 		Service service;
 
 		if (this.serviceFeatures != null) {
 			service = (this.wsdlDocumentUrl != null ?
 				Service.create(this.wsdlDocumentUrl, getQName(this.serviceName), this.serviceFeatures) :
 				Service.create(getQName(this.serviceName), this.serviceFeatures));
 		}
 		else {
 			service = (this.wsdlDocumentUrl != null ?
 					Service.create(this.wsdlDocumentUrl, getQName(this.serviceName)) :
 					Service.create(getQName(this.serviceName)));
 		}
 
 		if (this.executor != null) {
 			service.setExecutor(this.executor);
 		}
 		if (this.handlerResolver != null) {
 			service.setHandlerResolver(this.handlerResolver);
 		}
 
 		return service;
 	}
 
 	/**
 	 * Return a QName for the given name, relative to the namespace URI
 	 * of this factory, if given.
 	 * @see #setNamespaceUri
 	 */
 	protected QName getQName(String name) {
 		return (getNamespaceUri() != null ? new QName(getNamespaceUri(), name) : new QName(name));
 	}
 
 }