All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.sun.xml.ws.transport.http.server.EndpointImpl Maven / Gradle / Ivy

There is a newer version: 4.0.3
Show newest version
/*
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright (c) 1997-2012 Oracle and/or its affiliates. All rights reserved.
 *
 * The contents of this file are subject to the terms of either the GNU
 * General Public License Version 2 only ("GPL") or the Common Development
 * and Distribution License("CDDL") (collectively, the "License").  You
 * may not use this file except in compliance with the License.  You can
 * obtain a copy of the License at
 * http://glassfish.java.net/public/CDDL+GPL_1_1.html
 * or packager/legal/LICENSE.txt.  See the License for the specific
 * language governing permissions and limitations under the License.
 *
 * When distributing the software, include this License Header Notice in each
 * file and include the License file at packager/legal/LICENSE.txt.
 *
 * GPL Classpath Exception:
 * Oracle designates this particular file as subject to the "Classpath"
 * exception as provided by Oracle in the GPL Version 2 section of the License
 * file that accompanied this code.
 *
 * Modifications:
 * If applicable, add the following below the License Header, with the fields
 * enclosed by brackets [] replaced by your own identifying information:
 * "Portions Copyright [year] [name of copyright owner]"
 *
 * Contributor(s):
 * If you wish your version of this file to be governed by only the CDDL or
 * only the GPL Version 2, indicate your decision by adding "[Contributor]
 * elects to include this software in this distribution under the [CDDL or GPL
 * Version 2] license."  If you don't indicate a single choice of license, a
 * recipient has the option to distribute your version of this file under
 * either the CDDL, the GPL Version 2 or to extend the choice of license to
 * its licensees as provided above.  However, if you add GPL Version 2 code
 * and therefore, elected the GPL Version 2 license, then the option applies
 * only if the new code is made subject to such option by the copyright
 * holder.
 */

package com.sun.xml.ws.transport.http.server;

import com.sun.istack.Nullable;
import com.sun.xml.stream.buffer.XMLStreamBufferResult;
import com.sun.xml.ws.api.Component;
import com.sun.xml.ws.api.WSBinding;
import com.sun.xml.ws.api.BindingID;
import com.sun.xml.ws.api.databinding.MetadataReader;
import com.sun.xml.ws.api.message.Packet;
import com.sun.xml.ws.binding.BindingImpl;
import com.sun.xml.ws.api.server.*;
import com.sun.xml.ws.server.EndpointFactory;
import com.sun.xml.ws.server.ServerRtException;
import com.sun.xml.ws.util.xml.XmlUtil;
import com.sun.xml.ws.transport.http.HttpAdapterList;
import com.sun.xml.ws.transport.http.HttpAdapter;
import com.sun.istack.NotNull;

import java.net.MalformedURLException;

import javax.xml.namespace.QName;
import javax.xml.transform.Source;
import javax.xml.transform.TransformerException;
import javax.xml.ws.*;
import javax.xml.ws.spi.http.HttpContext;
import javax.xml.ws.wsaddressing.W3CEndpointReference;
import javax.xml.parsers.ParserConfigurationException;

import java.io.IOException;
import java.net.URL;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.concurrent.Executor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;

import org.xml.sax.EntityResolver;
import org.xml.sax.SAXException;
import org.w3c.dom.Element;


/**
 * Implements {@link Endpoint}.
 * 

*

* This class accumulates the information necessary to create * {@link WSEndpoint}, and then when {@link #publish} method * is called it will be created. *

*

* This object also allows accumulated information to be retrieved. * * @author Jitendra Kotamraju */ public class EndpointImpl extends Endpoint { private static final WebServicePermission ENDPOINT_PUBLISH_PERMISSION = new WebServicePermission("publishEndpoint"); /** * Once the service is published, this field will * be set to the {@link HttpEndpoint} instance. *

* But don't declare the type as {@link HttpEndpoint} * to avoid static type dependency that cause the class loading to * fail if the LW HTTP server doesn't exist. */ private Object actualEndpoint; // information accumulated for creating WSEndpoint private final WSBinding binding; private @Nullable final Object implementor; private List metadata; private Executor executor; private Map properties = Collections.emptyMap(); // always non-null private boolean stopped; private @Nullable EndpointContext endpointContext; private @NotNull final Class implClass; private final Invoker invoker; private Container container; public EndpointImpl(@NotNull BindingID bindingId, @NotNull Object impl, WebServiceFeature ... features) { this(bindingId, impl, impl.getClass(), InstanceResolver.createSingleton(impl).createInvoker(), features); } public EndpointImpl(@NotNull BindingID bindingId, @NotNull Class implClass, javax.xml.ws.spi.Invoker invoker, WebServiceFeature ... features) { this(bindingId, null, implClass, new InvokerImpl(invoker), features); } private EndpointImpl(@NotNull BindingID bindingId, Object impl, @NotNull Class implClass, Invoker invoker, WebServiceFeature ... features) { binding = BindingImpl.create(bindingId, features); this.implClass = implClass; this.invoker = invoker; this.implementor = impl; } /** * Wraps an already created {@link WSEndpoint} into an {@link EndpointImpl}, * and immediately publishes it with the given context. * * @param wse created endpoint * @param serverContext supported http context * @deprecated This is a backdoor method. Don't use it unless you know what you are doing. */ public EndpointImpl(WSEndpoint wse, Object serverContext) { this(wse, serverContext, null); } /** * Wraps an already created {@link WSEndpoint} into an {@link EndpointImpl}, * and immediately publishes it with the given context. * * @param wse created endpoint * @param serverContext supported http context * @param ctxt endpoint context * @deprecated This is a backdoor method. Don't use it unless you know what you are doing. */ public EndpointImpl(WSEndpoint wse, Object serverContext, EndpointContext ctxt) { endpointContext = ctxt; actualEndpoint = new HttpEndpoint(null, getAdapter(wse, "")); ((HttpEndpoint) actualEndpoint).publish(serverContext); binding = wse.getBinding(); implementor = null; // this violates the semantics, but hey, this is a backdoor. implClass = null; invoker = null; } /** * Wraps an already created {@link WSEndpoint} into an {@link EndpointImpl}, * and immediately publishes it with the given context. * * @param wse created endpoint * @param address endpoint address * @deprecated This is a backdoor method. Don't use it unless you know what you are doing. */ public EndpointImpl(WSEndpoint wse, String address) { this(wse, address, null); } /** * Wraps an already created {@link WSEndpoint} into an {@link EndpointImpl}, * and immediately publishes it with the given context. * * @param wse created endpoint * @param address endpoint address * @param ctxt endpoint context * @deprecated This is a backdoor method. Don't use it unless you know what you are doing. */ public EndpointImpl(WSEndpoint wse, String address, EndpointContext ctxt) { URL url; try { url = new URL(address); } catch (MalformedURLException ex) { throw new IllegalArgumentException("Cannot create URL for this address " + address); } if (!url.getProtocol().equals("http")) { throw new IllegalArgumentException(url.getProtocol() + " protocol based address is not supported"); } if (!url.getPath().startsWith("/")) { throw new IllegalArgumentException("Incorrect WebService address=" + address + ". The address's path should start with /"); } endpointContext = ctxt; actualEndpoint = new HttpEndpoint(null, getAdapter(wse, url.getPath())); ((HttpEndpoint) actualEndpoint).publish(address); binding = wse.getBinding(); implementor = null; // this violates the semantics, but hey, this is a backdoor. implClass = null; invoker = null; } public Binding getBinding() { return binding; } public Object getImplementor() { return implementor; } public void publish(String address) { canPublish(); URL url; try { url = new URL(address); } catch (MalformedURLException ex) { throw new IllegalArgumentException("Cannot create URL for this address " + address); } if (!url.getProtocol().equals("http")) { throw new IllegalArgumentException(url.getProtocol() + " protocol based address is not supported"); } if (!url.getPath().startsWith("/")) { throw new IllegalArgumentException("Incorrect WebService address=" + address + ". The address's path should start with /"); } createEndpoint(url.getPath()); ((HttpEndpoint) actualEndpoint).publish(address); } public void publish(Object serverContext) { canPublish(); if (!com.sun.net.httpserver.HttpContext.class.isAssignableFrom(serverContext.getClass())) { throw new IllegalArgumentException(serverContext.getClass() + " is not a supported context."); } createEndpoint(((com.sun.net.httpserver.HttpContext)serverContext).getPath()); ((HttpEndpoint) actualEndpoint).publish(serverContext); } public void publish(HttpContext serverContext) { canPublish(); createEndpoint(serverContext.getPath()); ((HttpEndpoint) actualEndpoint).publish(serverContext); } public void stop() { if (isPublished()) { ((HttpEndpoint) actualEndpoint).stop(); actualEndpoint = null; stopped = true; } } public boolean isPublished() { return actualEndpoint != null; } public List getMetadata() { return metadata; } public void setMetadata(java.util.List metadata) { if (isPublished()) { throw new IllegalStateException("Cannot set Metadata. Endpoint is already published"); } this.metadata = metadata; } public Executor getExecutor() { return executor; } public void setExecutor(Executor executor) { this.executor = executor; } public Map getProperties() { return new HashMap(properties); } public void setProperties(Map map) { this.properties = new HashMap(map); } /* * Checks the permission of "publishEndpoint" before accessing HTTP classes. * Also it checks if there is an available HTTP server implementation. */ private void createEndpoint(String urlPattern) { // Checks permission for "publishEndpoint" SecurityManager sm = System.getSecurityManager(); if (sm != null) { sm.checkPermission(ENDPOINT_PUBLISH_PERMISSION); } // See if HttpServer implementation is available try { Class.forName("com.sun.net.httpserver.HttpServer"); } catch (Exception e) { throw new UnsupportedOperationException("Couldn't load light weight http server", e); } container = getContainer(); MetadataReader metadataReader = EndpointFactory.getExternalMetadatReader(implClass, binding); WSEndpoint wse = WSEndpoint.create( implClass, true, invoker, getProperty(QName.class, Endpoint.WSDL_SERVICE), getProperty(QName.class, Endpoint.WSDL_PORT), container, binding, getPrimaryWsdl(metadataReader), buildDocList(), (EntityResolver) null, false ); // Don't load HttpEndpoint class before as it may load HttpServer classes actualEndpoint = new HttpEndpoint(executor, getAdapter(wse, urlPattern)); } private T getProperty(Class type, String key) { Object o = properties.get(key); if (o == null) return null; if (type.isInstance(o)) return type.cast(o); else throw new IllegalArgumentException("Property " + key + " has to be of type " + type); // i18n } /** * Convert metadata sources using identity transform. So that we can * reuse the Source object multiple times. */ private List buildDocList() { List r = new ArrayList(); if (metadata != null) { for (Source source : metadata) { try { XMLStreamBufferResult xsbr = XmlUtil.identityTransform(source, new XMLStreamBufferResult()); String systemId = source.getSystemId(); r.add(SDDocumentSource.create(new URL(systemId), xsbr.getXMLStreamBuffer())); } catch (TransformerException te) { throw new ServerRtException("server.rt.err", te); } catch (IOException te) { throw new ServerRtException("server.rt.err", te); } catch (SAXException e) { throw new ServerRtException("server.rt.err", e); } catch (ParserConfigurationException e) { throw new ServerRtException("server.rt.err", e); } } } return r; } /** * Gets wsdl from @WebService or @WebServiceProvider */ private @Nullable SDDocumentSource getPrimaryWsdl(MetadataReader metadataReader) { // Takes care of @WebService, @WebServiceProvider's wsdlLocation EndpointFactory.verifyImplementorClass(implClass, metadataReader); String wsdlLocation = EndpointFactory.getWsdlLocation(implClass, metadataReader); if (wsdlLocation != null) { ClassLoader cl = implClass.getClassLoader(); URL url = cl.getResource(wsdlLocation); if (url != null) { return SDDocumentSource.create(url); } throw new ServerRtException("cannot.load.wsdl", wsdlLocation); } return null; } private void canPublish() { if (isPublished()) { throw new IllegalStateException( "Cannot publish this endpoint. Endpoint has been already published."); } if (stopped) { throw new IllegalStateException( "Cannot publish this endpoint. Endpoint has been already stopped."); } } public EndpointReference getEndpointReference(Element...referenceParameters) { return getEndpointReference(W3CEndpointReference.class, referenceParameters); } public T getEndpointReference(Class clazz, Element...referenceParameters) { if (!isPublished()) { throw new WebServiceException("Endpoint is not published yet"); } return ((HttpEndpoint)actualEndpoint).getEndpointReference(clazz,referenceParameters); } @Override public void setEndpointContext(EndpointContext ctxt) { this.endpointContext = ctxt; } private HttpAdapter getAdapter(WSEndpoint endpoint, String urlPattern) { HttpAdapterList adapterList = null; if (endpointContext != null) { if (endpointContext instanceof Component) { adapterList = ((Component) endpointContext).getSPI(HttpAdapterList.class); } if (adapterList == null) { for(Endpoint e : endpointContext.getEndpoints()) { if (e.isPublished() && e != this) { adapterList = ((HttpEndpoint)(((EndpointImpl)e).actualEndpoint)).getAdapterOwner(); assert adapterList != null; break; } } } } if (adapterList == null) { adapterList = new ServerAdapterList(); } return adapterList.createAdapter("", urlPattern, endpoint); } /** * Endpoints within a EndpointContext get the same container. */ private Container getContainer() { if (endpointContext != null) { if (endpointContext instanceof Component) { Container c = ((Component) endpointContext).getSPI(Container.class); if (c != null) return c; } for(Endpoint e : endpointContext.getEndpoints()) { if (e.isPublished() && e != this) { return ((EndpointImpl)e).container; } } } return new ServerContainer(); } private static class InvokerImpl extends Invoker { private javax.xml.ws.spi.Invoker spiInvoker; InvokerImpl(javax.xml.ws.spi.Invoker spiInvoker) { this.spiInvoker = spiInvoker; } @Override public void start(@NotNull WSWebServiceContext wsc, @NotNull WSEndpoint endpoint) { try { spiInvoker.inject(wsc); } catch (IllegalAccessException e) { throw new WebServiceException(e); } catch (InvocationTargetException e) { throw new WebServiceException(e); } } public Object invoke(@NotNull Packet p, @NotNull Method m, @NotNull Object... args) throws InvocationTargetException, IllegalAccessException { return spiInvoker.invoke(m, args); } } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy