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

com.sun.jersey.server.impl.container.servlet.JerseyServletContainerInitializer Maven / Gradle / Ivy

There is a newer version: 1.19.4
Show newest version
/*
 *
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 *
 * Copyright 1997-2007 Sun Microsystems, Inc. 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 https://jersey.dev.java.net/CDDL+GPL.html
 * or jersey/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 jersey/legal/LICENSE.txt.
 * Sun designates this particular file as subject to the "Classpath" exception
 * as provided by Sun in the GPL Version 2 section of the License file that
 * accompanied this code.  If applicable, add the following below the License
 * Header, with the fields enclosed by brackets [] replaced by your own
 * identifying information: "Portions Copyrighted [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.jersey.server.impl.container.servlet;

import com.sun.jersey.api.core.DefaultResourceConfig;
import com.sun.jersey.server.impl.application.DeferredResourceConfig;
import com.sun.jersey.spi.container.servlet.ServletContainer;
import java.util.ArrayList;
import java.util.Collections;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.logging.Logger;
import javax.servlet.ServletContainerInitializer;
import javax.servlet.ServletContext;
import javax.servlet.ServletRegistration;
import javax.servlet.annotation.HandlesTypes;
import javax.ws.rs.ApplicationPath;
import javax.ws.rs.Path;
import javax.ws.rs.core.Application;
import javax.ws.rs.ext.Provider;

/*
It is RECOMMENDED that implementations support the Servlet 3 framework 
 pluggability mechanism to enable portability between containers and to avail
 themselves of container-supplied class scanning facilities.
 When using the pluggability mechanism the following conditions MUST be met:

- If no Application subclass is present the added servlet MUST be
 named "javax.ws.rs.core.Application" and all root resource classes and
 providers packaged in the web application MUST be included in the published
 JAX-RS application. The application MUST be packaged with a web.xml that
 specifies a servlet mapping for the added servlet.

- If an Application subclass is present and there is already a servlet defined
 that has a servlet initialization parameter named "javax.ws.rs.Application"
 whose value is the fully qualified name of the Application subclass then no
 servlet should be added by the JAX-RS implementation's ContainerInitializer
 since the application is already being handled by an existing servlet.

- If an application subclass is present that is not being handled by an
 existing servlet then the servlet added by the ContainerInitializer MUST be
 named with the fully qualified name of the Application subclass.  If the
 Application subclass is annotated with @PathPrefix and no servlet-mapping
 exists for the added servlet then a new servlet mapping is added with the
 value of the @PathPrefix  annotation with "/*" appended otherwise the existing
 mapping is used. If the Application subclass is not annotated with @PathPrefix
 then the application MUST be packaged with a web.xml that specifies a servlet
 mapping for the added servlet. It is an error for more than one Application
 to be deployed at the same effective servlet mapping.

In either of the latter two cases, if both Application#getClasses and
 Application#getSingletons return an empty list then all root resource classes
 and providers packaged in the web application MUST be included in the
 published JAX-RS application. If either getClasses or getSingletons return a
 non-empty list then only those classes or singletons returned MUST be included
 in the published JAX-RS application.

If not using the Servlet 3 framework pluggability mechanism
 (e.g. in a pre-Servet 3.0 container), the servlet-class or filter-class
 element of the web.xml descriptor SHOULD name the JAX-RS
 implementation-supplied Servlet or Filter class respectively. The
 application-supplied subclass of Application SHOULD be identied using an
 init-param with a param-name of javax.ws.rs.Application.
 
 */
/**
 *
 * @author [email protected]
 */
@HandlesTypes({Path.class, Provider.class, Application.class})
public class JerseyServletContainerInitializer implements ServletContainerInitializer {

    private static final Logger LOGGER =
            Logger.getLogger(JerseyServletContainerInitializer.class.getName());

    public void onStartup(Set> classes, ServletContext sc) {
        if (classes == null) {
            classes = Collections.>emptySet();
        }
        final int nOfRegisterations = sc.getServletRegistrations().size();
        for (Class a : getApplicationClasses(classes)) {
            final ServletRegistration appReg = sc.getServletRegistration(a.getName());
            if (appReg != null) {
                // Servlet is registered with app name
                
                addServletWithExistingRegistration(sc, appReg, a, classes);
            } else {
                // Servlet is not registered with app name

                final List srs = getInitParamDeclaredRegistrations(sc, a);
                if (!srs.isEmpty()) {
                    // List of servlets registered with app name in init param
                    
                    for (ServletRegistration sr : srs) {
                        addServletWithExistingRegistration(sc, sr, a, classes);
                    }
                } else {
                    addServletWithApplication(sc, a, classes);
                }
            }            
        }
        
        if (nOfRegisterations == sc.getServletRegistrations().size()) {
            // No app was registered
            addServletWithDefaultConfiguration(sc, classes);
        }
    }

    private List getInitParamDeclaredRegistrations(ServletContext sc, Class a) {
        final List srs = new ArrayList(1);
        for (ServletRegistration sr : sc.getServletRegistrations().values()) {

            Map ips = sr.getInitParameters();
            if (ips.containsKey(ServletContainer.APPLICATION_CONFIG_CLASS)) {
                if (ips.get(ServletContainer.APPLICATION_CONFIG_CLASS).equals(a.getName())) {
                    if (sr.getClassName() == null) {
                        srs.add(sr);
                    }
                }
            } else if (ips.containsKey(ServletContainer.RESOURCE_CONFIG_CLASS)) {
                if (ips.get(ServletContainer.RESOURCE_CONFIG_CLASS).equals(a.getName())) {
                    if (sr.getClassName() == null) {
                        srs.add(sr);
                    }
                }
            }
        }

        return srs;
    }

    private void addServletWithDefaultConfiguration(ServletContext sc, Set> classes) {
        ServletRegistration appReg = sc.getServletRegistration(Application.class.getName());
        if (appReg != null && appReg.getClassName() == null) {
            final Set> x = getRootResourceAndProviderClasses(classes);
            final ServletContainer s = new ServletContainer(
                    new DefaultResourceConfig(x));
            appReg = sc.addServlet(appReg.getName(), s);

            if (appReg.getMappings().isEmpty()) {
                // Error
                LOGGER.severe("The Jersey servlet application, named " +
                        appReg.getName() +
                        ", has no servlet mapping");
            } else {
                LOGGER.info("Registering the Jersey servlet application, named " +
                        appReg.getName() +
                        ", with the following root resource and provider classes: " + x);
            }
        }
    }
    
    private void addServletWithApplication(ServletContext sc,
            Class a, Set> classes) {
        final ApplicationPath ap = a.getAnnotation(ApplicationPath.class);
        if (ap != null) {
            // App is annotated with ApplicationPath
            
            final ServletContainer s = new ServletContainer(
                    new DeferredResourceConfig(a, getRootResourceAndProviderClasses(classes)));

            final String mapping = createMappingPath(ap);
            if (!mappingExists(sc, mapping)) {
                sc.addServlet(a.getName(), s).
                        addMapping(mapping);

                LOGGER.info("Registering the Jersey servlet application, named " +
                        a.getName() +
                        ", at the servlet mapping, "
                        + mapping +
                        ", with the Application class of the same name");
            } else {
                LOGGER.severe("Mapping conflict. " +
                        "A Servlet declaration exists with same mapping as the Jersey servlet application, named " +
                        a.getName() +
                        ", at the servlet mapping, "
                        + mapping +
                        ". The Jersey servlet is not deployed.");
            }
        }
    }

    private void addServletWithExistingRegistration(ServletContext sc, ServletRegistration sr,
            Class a, Set> classes) {
        if (sr.getClassName() == null) {
            final ServletContainer s = new ServletContainer(
                    new DeferredResourceConfig(a, getRootResourceAndProviderClasses(classes)));
            sr = sc.addServlet(a.getName(), s);
            if (sr.getMappings().isEmpty()) {
                final ApplicationPath ap = a.getAnnotation(ApplicationPath.class);
                if (ap != null) {
                    final String mapping = createMappingPath(ap);
                    if (!mappingExists(sc, mapping)) {
                        sr.addMapping(mapping);

                        LOGGER.info("Registering the Jersey servlet application, named " +
                                a.getName() +
                                ", at the servlet mapping, "
                                + mapping +
                                ", with the Application class of the same name");
                    } else {
                        LOGGER.severe("Mapping conflict. " +
                                "A Servlet registration exists with same mapping as the Jersey servlet application, named " +
                                a.getName() +
                                ", at the servlet mapping, "
                                + mapping +
                                ". The Jersey servlet is not deployed.");
                    }
                } else {
                    // Error
                    LOGGER.severe("The Jersey servlet application, named " +
                            a.getName() +
                            ", is not annotated with " + ApplicationPath.class.getSimpleName() + " " +
                            "and has no servlet mapping");
                }
            } else {
                LOGGER.info("Registering the Jersey servlet application, named " +
                        a.getName() +
                        ", with the Application class of the same name");
            }
        }
    }

    private boolean mappingExists(ServletContext sc, String mapping) {
        for (ServletRegistration sr : sc.getServletRegistrations().values()) {
            for (String declaredMapping : sr.getMappings()) {
                if (mapping.equals(declaredMapping)) {
                    return true;
                }
            }
        }

        return false;
    }

    private String createMappingPath(ApplicationPath ap) {
        String path = ap.value();
        if (!path.startsWith("/")) {
            path = "/" + path;
        }

        if (!path.endsWith("/*")) {
            if (path.endsWith("/")) {
                path += "*";
            } else {
                path += "/*";
            }
        }

        return path;
    }

    private Set> getApplicationClasses(Set> classes) {
        Set> s = new LinkedHashSet>();
        for (Class c : classes) {
            if (Application.class != c && Application.class.isAssignableFrom(c)) {
                s.add(c.asSubclass(Application.class));
            }
        }

        return s;
    }

    private Set> getRootResourceAndProviderClasses(Set> classes) {
        // TODO filter out any classes from the Jersey jars
        Set> s = new LinkedHashSet>();
        for (Class c : classes) {
            if (c.isAnnotationPresent(Path.class) || c.isAnnotationPresent(Provider.class))
                s.add(c);
        }

        return s;
    }

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy