org.eclipse.jetty.ee8.annotations.AnnotationConfiguration Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jetty-ee8-annotations Show documentation
Show all versions of jetty-ee8-annotations Show documentation
Annotation support for deploying servlets in jetty.
//
// ========================================================================
// Copyright (c) 1995-2022 Mort Bay Consulting Pty Ltd and others.
//
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License v. 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0, or the Apache License, Version 2.0
// which is available at https://www.apache.org/licenses/LICENSE-2.0.
//
// SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
// ========================================================================
//
package org.eclipse.jetty.ee8.annotations;
import java.net.URI;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.ListIterator;
import java.util.Map;
import java.util.ServiceLoader;
import java.util.Set;
import java.util.concurrent.Callable;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.Semaphore;
import java.util.concurrent.TimeUnit;
import java.util.regex.Pattern;
import java.util.stream.Collectors;
import java.util.stream.Stream;
import javax.servlet.ServletContainerInitializer;
import javax.servlet.annotation.HandlesTypes;
import org.eclipse.jetty.ee8.plus.webapp.PlusConfiguration;
import org.eclipse.jetty.ee8.servlet.ServletContainerInitializerHolder;
import org.eclipse.jetty.ee8.servlet.Source;
import org.eclipse.jetty.ee8.servlet.Source.Origin;
import org.eclipse.jetty.ee8.webapp.AbstractConfiguration;
import org.eclipse.jetty.ee8.webapp.FragmentConfiguration;
import org.eclipse.jetty.ee8.webapp.FragmentDescriptor;
import org.eclipse.jetty.ee8.webapp.JettyWebXmlConfiguration;
import org.eclipse.jetty.ee8.webapp.MetaInfConfiguration;
import org.eclipse.jetty.ee8.webapp.WebAppClassLoader;
import org.eclipse.jetty.ee8.webapp.WebAppContext;
import org.eclipse.jetty.ee8.webapp.WebDescriptor;
import org.eclipse.jetty.ee8.webapp.WebXmlConfiguration;
import org.eclipse.jetty.util.ExceptionUtil;
import org.eclipse.jetty.util.IO;
import org.eclipse.jetty.util.Loader;
import org.eclipse.jetty.util.NanoTime;
import org.eclipse.jetty.util.ProcessorUtils;
import org.eclipse.jetty.util.StringUtil;
import org.eclipse.jetty.util.TypeUtil;
import org.eclipse.jetty.util.resource.Resource;
import org.eclipse.jetty.util.resource.ResourceFactory;
import org.eclipse.jetty.util.statistic.CounterStatistic;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* Configuration for Annotations
*/
public class AnnotationConfiguration extends AbstractConfiguration {
private static final Logger LOG = LoggerFactory.getLogger(AnnotationConfiguration.class);
// TODO review if these should be in ee9 space?
public static final String SERVLET_CONTAINER_INITIALIZER_EXCLUSION_PATTERN = "org.eclipse.jetty.containerInitializerExclusionPattern";
public static final String SERVLET_CONTAINER_INITIALIZER_ORDER = "org.eclipse.jetty.containerInitializerOrder";
public static final String CLASS_INHERITANCE_MAP = "org.eclipse.jetty.classInheritanceMap";
public static final String CONTAINER_INITIALIZERS = "org.eclipse.jetty.containerInitializers";
public static final String CONTAINER_INITIALIZER_STARTER = "org.eclipse.jetty.containerInitializerStarter";
public static final String MULTI_THREADED = "org.eclipse.jetty.ee8.annotations.multiThreaded";
public static final String MAX_SCAN_WAIT = "org.eclipse.jetty.ee8.annotations.maxWait";
public static final int DEFAULT_MAX_SCAN_WAIT = 60;
/* time in sec */
public static final boolean DEFAULT_MULTI_THREADED = true;
protected final List _discoverableAnnotationHandlers = new ArrayList<>();
protected ClassInheritanceHandler _classInheritanceHandler;
protected final List _containerInitializerAnnotationHandlers = new ArrayList<>();
protected final List _sciHolders = new ArrayList<>();
protected List _parserTasks;
protected CounterStatistic _containerPathStats;
protected CounterStatistic _webInfLibStats;
protected CounterStatistic _webInfClassesStats;
protected Pattern _sciExcludePattern;
private ResourceFactory.Closeable _resourceFactory;
public AnnotationConfiguration() {
addDependencies(WebXmlConfiguration.class, MetaInfConfiguration.class, FragmentConfiguration.class, PlusConfiguration.class);
addDependents(JettyWebXmlConfiguration.class);
hide("org.objectweb.asm.");
}
/**
* Simple class to capture elapsed time of an operation.
*/
public static class TimeStatistic {
public long _start = 0;
public long _end = 0;
public void start() {
_start = NanoTime.now();
}
public void end() {
_end = NanoTime.now();
}
public long getElapsedNanos() {
return NanoTime.elapsed(_start, _end);
}
}
/**
* ParserTask
*
* Task to executing scanning of a resource for annotations.
*/
public class ParserTask implements Callable {
protected Exception _exception;
protected final AnnotationParser _parser;
protected final Set _handlers;
protected final Resource _resource;
protected TimeStatistic _stat;
public ParserTask(AnnotationParser parser, Set handlers, Resource resource) {
_parser = parser;
_handlers = handlers;
_resource = resource;
}
public void setStatistic(TimeStatistic stat) {
_stat = stat;
}
@Override
public Void call() throws Exception {
if (_stat != null)
_stat.start();
if (_parser != null)
_parser.parse(_handlers, _resource);
if (_stat != null)
_stat.end();
return null;
}
public TimeStatistic getStatistic() {
return _stat;
}
public Resource getResource() {
return _resource;
}
}
/**
* ServletContainerInitializerOrdering
* Applies an ordering to the {@link ServletContainerInitializer}s for the context, using
* the value of the "org.eclipse.jetty.containerInitializerOrder" context attribute.
* The attribute value is a list of classnames of ServletContainerInitializers in the order in which
* they are to be called. One name only in the list can be "*", which is a
* wildcard which matches any other ServletContainerInitializer name not already
* matched.
*/
public class ServletContainerInitializerOrdering {
private Map _indexMap = new HashMap<>();
private Integer _star = null;
private String _ordering = null;
public ServletContainerInitializerOrdering(String ordering) {
if (ordering != null) {
_ordering = ordering;
String[] tmp = StringUtil.csvSplit(ordering);
for (int i = 0; i < tmp.length; i++) {
String s = tmp[i].trim();
_indexMap.put(s, i);
if ("*".equals(s)) {
if (_star != null)
throw new IllegalArgumentException("Duplicate wildcards in ServletContainerInitializer ordering " + ordering);
_star = i;
}
}
}
}
/**
* @return true if "*" is one of the values.
*/
public boolean hasWildcard() {
return _star != null;
}
/**
* @return the index of the "*" element, if it is specified. -1 otherwise.
*/
public int getWildcardIndex() {
if (!hasWildcard())
return -1;
return _star.intValue();
}
/**
* @return true if the ordering contains a single value of "*"
*/
public boolean isDefaultOrder() {
return (getSize() == 1 && hasWildcard());
}
/**
* Get the order index of the given classname
*
* @param name the classname to look up
* @return the index of the class name (or -1 if not found)
*/
public int getIndexOf(String name) {
Integer i = _indexMap.get(name);
if (i == null)
return -1;
return i.intValue();
}
/**
* Get the number of elements of the ordering
*
* @return the size of the index
*/
public int getSize() {
return _indexMap.size();
}
@Override
public String toString() {
if (_ordering == null)
return "";
return _ordering;
}
}
/**
* ServletContainerInitializerComparator
*
* Comparator impl that orders a set of ServletContainerInitializers according to the
* list of classnames (optionally containing a "*" wildcard character) established in a
* ServletContainerInitializerOrdering.
*
* @see ServletContainerInitializerOrdering
*/
public class ServletContainerInitializerComparator implements Comparator {
private ServletContainerInitializerOrdering _ordering;
public ServletContainerInitializerComparator(ServletContainerInitializerOrdering ordering) {
_ordering = ordering;
}
@Override
public int compare(ServletContainerInitializer sci1, ServletContainerInitializer sci2) {
String c1 = (sci1 != null ? sci1.getClass().getName() : null);
String c2 = (sci2 != null ? sci2.getClass().getName() : null);
if (c1 == null && c2 == null)
return 0;
int i1 = _ordering.getIndexOf(c1);
if (i1 < 0 && _ordering.hasWildcard())
i1 = _ordering.getWildcardIndex();
int i2 = _ordering.getIndexOf(c2);
if (i2 < 0 && _ordering.hasWildcard())
i2 = _ordering.getWildcardIndex();
return Integer.compare(i1, i2);
}
}
public static class DiscoveredServletContainerInitializerHolder extends ServletContainerInitializerHolder {
private Set> _handlesTypes = new HashSet<>();
private Set _discoveredClassNames = new HashSet<>();
public DiscoveredServletContainerInitializerHolder(Source source, ServletContainerInitializer sci, Class... startupClasses) {
super(source, sci);
// take the classes and set them aside until we can calculate all of their
// subclasses as necessary
_handlesTypes.addAll(_startupClasses);
}
/**
* Classes that have annotations that are listed in @HandlesTypes
* are discovered by the ContainerInitializerAnnotationHandler
* and added here.
* @param names of classnames that have an annotation that is listed as a class in HandlesTypes
*/
@Override
public void addStartupClasses(String... names) {
_discoveredClassNames.addAll(Arrays.asList(names));
}
/**
* Classes that are listed in @HandlesTypes and found by
* the createServletContainerInitializerAnnotationHandlers method.
* @param clazzes classes listed in HandlesTypes
*/
@Override
public void addStartupClasses(Class... clazzes) {
_handlesTypes.addAll(Arrays.asList(clazzes));
}
@Override
protected Set> resolveStartupClasses() throws Exception {
final Set> classes = new HashSet<>();
WebAppClassLoader.runWithServerClassAccess(() -> {
for (String name : _startupClassNames) {
classes.add(Loader.loadClass(name));
}
return null;
});
return classes;
}
/**
* Process each of the classes that are not annotations from @HandlesTypes and
* find all of the subclasses/implementations.
* Also process all of the classes that were discovered to have an annotation
* that was listed in @HandlesTypes, and find all of their subclasses/implementations
* in order to generate a complete set of classnames that can be passed into the
* onStartup method.
*
* @param classMap complete inheritance tree of all classes in the webapp, can be
* null if @HandlesTypes did not specify any classes.
*/
void resolveClasses(Map> classMap) {
Set finalClassnames = new HashSet<>();
if (classMap != null) {
for (Class c : _handlesTypes) {
// find all subclasses/implementations of the classes (not annotations) named in @HandlesTypes
if (!c.isAnnotation())
addInheritedTypes(finalClassnames, classMap, (Set) classMap.get(c.getName()));
}
for (String classname : _discoveredClassNames) {
// add each of the classes that were discovered to have an annotation listed in @HandlesTypes
finalClassnames.add(classname);
// walk its hierarchy and find all types that extend or implement the class
addInheritedTypes(finalClassnames, classMap, (Set) classMap.get(classname));
}
}
// finally, add the complete set of startup classnames
super.addStartupClasses(finalClassnames.toArray(new String[0]));
}
/**
* Recursively walk the class hierarchy for the given set of classnames.
*
* @param results all classes related to the set of classnames in names
* @param classMap full inheritance tree for all classes in the webapp
* @param names the names of classes for which to walk the hierarchy
*/
private void addInheritedTypes(Set results, Map> classMap, Set names) {
if (names == null || names.isEmpty())
return;
for (String s : names) {
results.add(s);
// walk the hierarchy and find all types that extend or implement the class
addInheritedTypes(results, classMap, (Set) classMap.get(s));
}
}
}
@Override
public void preConfigure(final WebAppContext context) throws Exception {
String tmp = (String) context.getAttribute(SERVLET_CONTAINER_INITIALIZER_EXCLUSION_PATTERN);
_sciExcludePattern = (tmp == null ? null : Pattern.compile(tmp));
_resourceFactory = ResourceFactory.closeable();
}
@Override
public void deconfigure(WebAppContext context) throws Exception {
IO.close(_resourceFactory);
_resourceFactory = null;
}
public void addDiscoverableAnnotationHandler(AbstractDiscoverableAnnotationHandler handler) {
_discoverableAnnotationHandlers.add(handler);
}
@Override
public void configure(WebAppContext context) throws Exception {
// handle introspectable annotations (postconstruct,predestroy, multipart etc etc)
context.getObjectFactory().addDecorator(new AnnotationDecorator(context));
if (!context.getMetaData().isMetaDataComplete()) {
// If web.xml not metadata-complete, if this is a servlet 3 webapp or above
// or configDiscovered is true, we need to search for annotations
if (context.getServletContext().getEffectiveMajorVersion() >= 3 || context.isConfigurationDiscovered()) {
_discoverableAnnotationHandlers.add(new WebServletAnnotationHandler(context));
_discoverableAnnotationHandlers.add(new WebFilterAnnotationHandler(context));
_discoverableAnnotationHandlers.add(new WebListenerAnnotationHandler(context));
}
}
// Regardless of metadata, if there are any ServletContainerInitializers with @HandlesTypes, then we need to scan all the
// classes so we can call their onStartup() methods correctly
createServletContainerInitializerAnnotationHandlers(context, getNonExcludedInitializers(context));
if (!_discoverableAnnotationHandlers.isEmpty() || _classInheritanceHandler != null || !_containerInitializerAnnotationHandlers.isEmpty())
scanForAnnotations(context);
Map> map = (Map>) context.getAttribute(AnnotationConfiguration.CLASS_INHERITANCE_MAP);
for (DiscoveredServletContainerInitializerHolder holder : _sciHolders) {
holder.resolveClasses(map);
// only add the holder now all classes are fully available
context.addServletContainerInitializer(holder);
}
}
@Override
public void postConfigure(WebAppContext context) throws Exception {
Map> classMap = (ClassInheritanceMap) context.getAttribute(CLASS_INHERITANCE_MAP);
if (classMap != null)
classMap.clear();
context.removeAttribute(CLASS_INHERITANCE_MAP);
_discoverableAnnotationHandlers.clear();
_classInheritanceHandler = null;
_containerInitializerAnnotationHandlers.clear();
_sciHolders.clear();
if (_parserTasks != null) {
_parserTasks.clear();
_parserTasks = null;
}
super.postConfigure(context);
}
/**
* Perform scanning of classes for discoverable
* annotations such as WebServlet/WebFilter/WebListener
*
* @param context the context for the scan
* @throws Exception if unable to scan
*/
protected void scanForAnnotations(WebAppContext context) throws Exception {
AnnotationParser parser = createAnnotationParser();
_parserTasks = new ArrayList();
if (LOG.isDebugEnabled())
LOG.debug("Annotation scanning commencing: webxml={}, metadatacomplete={}, configurationDiscovered={}, multiThreaded={}, maxScanWait={}", context.getServletContext().getEffectiveMajorVersion(), context.getMetaData().isMetaDataComplete(), context.isConfigurationDiscovered(), isUseMultiThreading(context), getMaxScanWait(context));
// scan selected jars on the container classpath first
parseContainerPath(context, parser);
// email from Rajiv Mordani jsrs 315 7 April 2010
// If there is a scis) throws Exception {
if (scis == null || scis.isEmpty())
// nothing to do
return;
for (ServletContainerInitializer sci : scis) {
Class[] classes = new Class[0];
HandlesTypes annotation = sci.getClass().getAnnotation(HandlesTypes.class);
if (annotation != null)
classes = annotation.value();
DiscoveredServletContainerInitializerHolder holder = new DiscoveredServletContainerInitializerHolder(new Source(Origin.ANNOTATION, sci.getClass().getName()), sci);
_sciHolders.add(holder);
if (classes.length > 0) {
if (LOG.isDebugEnabled())
LOG.debug("HandlesTypes {} on initializer {}", Arrays.asList(classes), sci.getClass());
// If we haven't already done so, we need to register a handler that will
// process the whole class hierarchy to satisfy the ServletContainerInitializer
if (context.getAttribute(CLASS_INHERITANCE_MAP) == null) {
Map> map = new ClassInheritanceMap();
context.setAttribute(CLASS_INHERITANCE_MAP, map);
_classInheritanceHandler = new ClassInheritanceHandler(map);
}
for (Class c : classes) {
// The value of one of the HandlesTypes classes is actually an Annotation itself so
// register a handler for it to discover all classes that contain this annotation
if (c.isAnnotation()) {
if (LOG.isDebugEnabled())
LOG.debug("Registering annotation handler for {}", c.getName());
_containerInitializerAnnotationHandlers.add(new ContainerInitializerAnnotationHandler(holder, c));
}
holder.addStartupClasses(c);
}
}
}
}
public Resource getJarFor(ServletContainerInitializer service) {
URI uri = TypeUtil.getLocationOfClass(service.getClass());
if (uri == null)
return null;
return _resourceFactory.newResource(uri);
}
/**
* Check to see if the ServletContainerIntializer loaded via the ServiceLoader came
* from a jar that is excluded by the fragment ordering. See ServletSpec 3.0 p.85.
*
* @param context the context for the jars
* @param sci the servlet container initializer
* @param sciResource the resource for the servlet container initializer
* @return true if excluded
* @throws Exception if unable to determine exclusion
*/
public boolean isFromExcludedJar(WebAppContext context, ServletContainerInitializer sci, Resource sciResource) throws Exception {
if (sci == null)
throw new IllegalArgumentException("ServletContainerInitializer null");
if (context == null)
throw new IllegalArgumentException("WebAppContext null");
// if we don't know where its from it can't be excluded
if (sciResource == null) {
if (LOG.isDebugEnabled())
LOG.debug("!Excluded {} null resource", sci);
return false;
}
// A ServletContainerInitialier that came from WEB-INF/classes or equivalent cannot be excluded by an ordering
if (isFromWebInfClasses(context, sciResource)) {
if (LOG.isDebugEnabled())
LOG.debug("!Excluded {} from web-inf/classes", sci);
return false;
}
// A ServletContainerInitializer that came from the container's classpath cannot be excluded by an ordering
// of WEB-INF/lib jars
if (isFromContainerClassPath(context, sci)) {
if (LOG.isDebugEnabled())
LOG.debug("!Excluded {} from container classpath", sci);
return false;
}
// If no ordering, nothing is excluded
if (!context.getMetaData().isOrdered()) {
if (LOG.isDebugEnabled())
LOG.debug("!Excluded {} no ordering", sci);
return false;
}
List orderedJars = context.getMetaData().getWebInfResources(true);
// there is an ordering, but there are no jars resulting from the ordering, everything excluded
if (orderedJars.isEmpty()) {
if (LOG.isDebugEnabled())
LOG.debug("Excluded {} empty ordering", sci);
return true;
}
// Check if it is excluded by an ordering
boolean included = false;
for (Resource r : orderedJars) {
included = r.equals(sciResource);
if (included)
break;
}
if (LOG.isDebugEnabled())
LOG.debug("{}Excluded {} found={}", included ? "!" : "", sci, included);
return !included;
}
/**
* Test if the ServletContainerIntializer is excluded by the
* o.e.j.containerInitializerExclusionPattern
*
* @param sci the ServletContainerIntializer
* @return true if the ServletContainerIntializer is excluded
*/
public boolean matchesExclusionPattern(ServletContainerInitializer sci) {
// no exclusion pattern, no SCI is excluded by it
if (_sciExcludePattern == null)
return false;
// test if name of class matches the regex
if (LOG.isDebugEnabled())
LOG.debug("Checking {} against containerInitializerExclusionPattern", sci.getClass().getName());
return _sciExcludePattern.matcher(sci.getClass().getName()).matches();
}
/**
* Test if the ServletContainerInitializer is from the container classpath
*
* @param context the context for the webapp classpath
* @param sci the ServletContainerIntializer
* @return true if ServletContainerIntializer is from container classpath
*/
public boolean isFromContainerClassPath(WebAppContext context, ServletContainerInitializer sci) {
if (sci == null)
return false;
ClassLoader sciLoader = sci.getClass().getClassLoader();
// if loaded by bootstrap loader, then its the container classpath
if (sciLoader == null)
return true;
// if there is no context classloader, then its the container classpath
if (context.getClassLoader() == null)
return true;
ClassLoader loader = sciLoader;
while (loader != null) {
if (loader == context.getClassLoader())
// the webapp classloader is in the ancestry of the classloader for the sci
return false;
else
loader = loader.getParent();
}
return true;
}
/**
* Test if the ServletContainerInitializer is from WEB-INF/classes
*
* @param context the webapp to test
* @param sci a Resource representing the SCI
* @return true if the sci Resource is inside a WEB-INF/classes directory, false otherwise
*/
public boolean isFromWebInfClasses(WebAppContext context, Resource sci) {
for (Resource dir : context.getMetaData().getWebInfClassesResources()) {
if (dir.equals(sci)) {
return true;
}
}
return false;
}
/**
* Get SCIs that are not excluded from consideration
*
* @param context the web app context
* @return the list of non-excluded servlet container initializers
* @throws Exception if unable to get list
*/
public List getNonExcludedInitializers(WebAppContext context) throws Exception {
ArrayList nonExcludedInitializers = new ArrayList();
// We use the ServiceLoader mechanism to find the ServletContainerInitializer classes to inspect
long start = NanoTime.now();
List scis = TypeUtil.serviceProviderStream(ServiceLoader.load(ServletContainerInitializer.class)).flatMap(provider -> {
try {
return Stream.of(provider.get());
} catch (Error e) {
// Probably a SCI discovered on the system classpath that is hidden by the context classloader
if (LOG.isDebugEnabled())
LOG.debug("Error: {} for {}", e.getMessage(), context, e);
else
LOG.info("Error: {} for {}", e.getMessage(), context);
return Stream.of();
}
}).collect(Collectors.toList());
if (LOG.isDebugEnabled())
LOG.debug("Service loaders found in {}ms", NanoTime.millisSince(start));
Map sciResourceMap = new HashMap<>();
ServletContainerInitializerOrdering initializerOrdering = getInitializerOrdering(context);
// Get initial set of SCIs that aren't from excluded jars or excluded by the containerExclusionPattern, or excluded
// because containerInitializerOrdering omits it
for (ServletContainerInitializer sci : scis) {
if (matchesExclusionPattern(sci)) {
if (LOG.isDebugEnabled())
LOG.debug("{} excluded by pattern", sci);
continue;
}
Resource sciResource = getJarFor(sci);
if (isFromExcludedJar(context, sci, sciResource)) {
if (LOG.isDebugEnabled())
LOG.debug("{} is from excluded jar", sci);
continue;
}
// check containerInitializerOrdering doesn't exclude it
String name = sci.getClass().getName();
if (initializerOrdering != null && (!initializerOrdering.hasWildcard() && initializerOrdering.getIndexOf(name) < 0)) {
if (LOG.isDebugEnabled())
LOG.debug("{} is excluded by ordering", sci);
continue;
}
sciResourceMap.put(sci, sciResource);
}
// Order the SCIs that are included
if (initializerOrdering != null && !initializerOrdering.isDefaultOrder()) {
if (LOG.isDebugEnabled())
LOG.debug("Ordering ServletContainerInitializers with {}", initializerOrdering);
// There is an ordering that is not just "*".
// Arrange ServletContainerInitializers according to the ordering of classnames given, irrespective of coming from container or webapp classpaths
nonExcludedInitializers.addAll(sciResourceMap.keySet());
Collections.sort(nonExcludedInitializers, new ServletContainerInitializerComparator(initializerOrdering));
} else {
// No jetty-specific ordering specified, or just the wildcard value "*" specified.
// Fallback to ordering the ServletContainerInitializers according to:
// container classpath first, WEB-INF/classes then WEB-INF/lib (obeying any web.xml jar ordering)
// First add in all SCIs that can't be excluded
int lastContainerSCI = -1;
for (Map.Entry entry : sciResourceMap.entrySet()) {
if (entry.getKey().getClass().getClassLoader() == context.getClassLoader().getParent()) {
// add all container SCIs before any webapp SCIs
nonExcludedInitializers.add(++lastContainerSCI, entry.getKey());
} else if (// can't work out provenance of SCI, so can't be ordered/excluded
entry.getValue() == null) {
// add at end of list
nonExcludedInitializers.add(entry.getKey());
} else {
for (Resource dir : context.getMetaData().getWebInfClassesResources()) {
if (// from WEB-INF/classes so can't be ordered/excluded
dir.equals(entry.getValue())) {
nonExcludedInitializers.add(entry.getKey());
}
}
}
}
// throw out the ones we've already accounted for
for (ServletContainerInitializer s : nonExcludedInitializers) {
sciResourceMap.remove(s);
}
if (context.getMetaData().getOrdering() == null) {
if (LOG.isDebugEnabled())
LOG.debug("No web.xml ordering, ServletContainerInitializers in random order");
// add the rest of the scis
nonExcludedInitializers.addAll(sciResourceMap.keySet());
} else {
if (LOG.isDebugEnabled())
LOG.debug("Ordering ServletContainerInitializers with ordering {}", context.getMetaData().getOrdering());
// add SCIs according to the ordering of its containing jar
for (Resource webInfJar : context.getMetaData().getWebInfResources(true)) {
for (Map.Entry entry : sciResourceMap.entrySet()) {
if (webInfJar.equals(entry.getValue()))
nonExcludedInitializers.add(entry.getKey());
}
}
}
}
// final pass over the non-excluded SCIs if the webapp version is < 3, in which case
// we will only call SCIs that are on the server's classpath
if (context.getServletContext().getEffectiveMajorVersion() < 3 && !context.isConfigurationDiscovered()) {
ListIterator it = nonExcludedInitializers.listIterator();
while (it.hasNext()) {
ServletContainerInitializer sci = it.next();
if (!isFromContainerClassPath(context, sci)) {
if (LOG.isDebugEnabled())
LOG.debug("Ignoring SCI {}: old web.xml version {}.{}", sci.getClass().getName(), context.getServletContext().getEffectiveMajorVersion(), context.getServletContext().getEffectiveMinorVersion());
it.remove();
}
}
}
if (LOG.isDebugEnabled()) {
int i = 0;
for (ServletContainerInitializer sci : nonExcludedInitializers) {
LOG.debug("ServletContainerInitializer: {} {} from {}", (++i), sci.getClass().getName(), sciResourceMap.get(sci));
}
}
return nonExcludedInitializers;
}
/**
* Jetty-specific extension that allows an ordering to be applied across ALL ServletContainerInitializers.
*
* @param context the context for the initializer ordering configuration
* @return the ordering of the ServletContainerIntializer's
*/
public ServletContainerInitializerOrdering getInitializerOrdering(WebAppContext context) {
if (context == null)
return null;
String tmp = (String) context.getAttribute(SERVLET_CONTAINER_INITIALIZER_ORDER);
if (StringUtil.isBlank(tmp))
return null;
return new ServletContainerInitializerOrdering(tmp);
}
/**
* Scan jars on container path.
*
* @param context the context for the scan
* @param parser the parser to scan with
* @throws Exception if unable to scan
*/
public void parseContainerPath(final WebAppContext context, final AnnotationParser parser) throws Exception {
// always parse for discoverable annotations as well as class hierarchy and servletcontainerinitializer related annotations
final Set handlers = new HashSet();
handlers.addAll(_discoverableAnnotationHandlers);
handlers.addAll(_containerInitializerAnnotationHandlers);
if (_classInheritanceHandler != null)
handlers.add(_classInheritanceHandler);
if (LOG.isDebugEnabled())
_containerPathStats = new CounterStatistic();
// scan the container classpath jars that were selected by
// filtering in MetaInfConfiguration
for (Resource r : context.getMetaData().getContainerResources()) {
if (_parserTasks != null) {
ParserTask task = new ParserTask(parser, handlers, r);
_parserTasks.add(task);
if (LOG.isDebugEnabled()) {
_containerPathStats.increment();
task.setStatistic(new TimeStatistic());
}
}
}
}
/**
* Scan jars in WEB-INF/lib.
*
* Only jars selected by MetaInfConfiguration, and that are not excluded
* by an ordering will be considered.
*
* @param context the context for the scan
* @param parser the annotation parser to use
* @throws Exception if unable to scan and/or parse
*/
public void parseWebInfLib(final WebAppContext context, final AnnotationParser parser) throws Exception {
// email from Rajiv Mordani jsrs 315 7 April 2010
// jars that do not have a web-fragment.xml are still considered fragments
// they have to participate in the ordering
// if there is an ordering, the ordered jars should be used.
// If there is no ordering, jars will be unordered.
List jars = context.getMetaData().getWebInfResources(context.getMetaData().isOrdered());
if (LOG.isDebugEnabled()) {
if (_webInfLibStats == null)
_webInfLibStats = new CounterStatistic();
}
for (Resource r : jars) {
// for each jar, we decide which set of annotations we need to parse for
final Set handlers = new HashSet();
FragmentDescriptor f = context.getMetaData().getFragmentDescriptorForJar(r);
// if its from a fragment jar that is metadata complete, we should skip scanning for @webservlet etc
// but yet we still need to do the scanning for the classes on behalf of the servletcontainerinitializers
// if a jar has no web-fragment.xml we scan it (because it is not excluded by the ordering)
// or if it has a fragment we scan it if it is not metadata complete
if (f == null || !WebDescriptor.isMetaDataComplete(f) || _classInheritanceHandler != null || !_containerInitializerAnnotationHandlers.isEmpty()) {
// register the classinheritance handler if there is one
if (_classInheritanceHandler != null)
handlers.add(_classInheritanceHandler);
// register the handlers for the @HandlesTypes values that are themselves annotations if there are any
handlers.addAll(_containerInitializerAnnotationHandlers);
// only register the discoverable annotation handlers if this fragment is not metadata complete, or has no fragment descriptor
if (f == null || !WebDescriptor.isMetaDataComplete(f))
handlers.addAll(_discoverableAnnotationHandlers);
if (_parserTasks != null) {
ParserTask task = new ParserTask(parser, handlers, r);
_parserTasks.add(task);
if (LOG.isDebugEnabled()) {
_webInfLibStats.increment();
task.setStatistic(new TimeStatistic());
}
}
}
}
}
/**
* Scan classes in WEB-INF/classes.
*
* @param context the context for the scan
* @param parser the annotation parser to use
* @throws Exception if unable to scan and/or parse
*/
public void parseWebInfClasses(final WebAppContext context, final AnnotationParser parser) throws Exception {
Set handlers = new HashSet();
handlers.addAll(_discoverableAnnotationHandlers);
if (_classInheritanceHandler != null)
handlers.add(_classInheritanceHandler);
handlers.addAll(_containerInitializerAnnotationHandlers);
if (LOG.isDebugEnabled())
_webInfClassesStats = new CounterStatistic();
for (Resource dir : context.getMetaData().getWebInfClassesResources()) {
if (_parserTasks != null) {
ParserTask task = new ParserTask(parser, handlers, dir);
_parserTasks.add(task);
if (LOG.isDebugEnabled()) {
_webInfClassesStats.increment();
task.setStatistic(new TimeStatistic());
}
}
}
}
public static class ClassInheritanceMap extends ConcurrentHashMap> {
@Override
public String toString() {
return String.format("ClassInheritanceMap@%x{size=%d}", hashCode(), size());
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy