Package org.eclipse.jetty.webapp

Class JarScanner

java.lang.Object
org.eclipse.jetty.util.PatternMatcher
org.eclipse.jetty.webapp.JarScanner
@Deprecated public abstract class JarScanner extends org.eclipse.jetty.util.PatternMatcher
Deprecated.
Does not handle MR Jars
JarScannerConfiguration Abstract base class for configurations that want to scan jars in WEB-INF/lib and the classloader hierarchy. Jar name matching based on regexp patterns is provided. Subclasses should implement the processEntry(URL jarUrl, JarEntry entry) method to handle entries in jar files whose names match the supplied pattern.

  • Constructor Summary

    Constructors
    Constructor
    Description
    JarScanner()
    Deprecated.
     

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    matched(URI uri)
    Deprecated.
     
    abstract void
    processEntry(URI jarUri, JarEntry entry)
    Deprecated.
     
    void
    scan(Pattern pattern, ClassLoader loader, boolean isNullInclusive, boolean visitParent)
    Deprecated.
    Find jar names from the classloader matching a pattern.
    void
    scan(Pattern pattern, URI[] uris, boolean isNullInclusive)
    Deprecated.
    Find jar names from the provided list matching a pattern.

    Methods inherited from class org.eclipse.jetty.util.PatternMatcher

    match, matchPatterns

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • JarScanner

      public JarScanner()
      Deprecated.

  • Method Details

    • processEntry

      public abstract void processEntry(URI jarUri, JarEntry entry)
      Deprecated.

    • scan

      public void scan(Pattern pattern, URI[] uris, boolean isNullInclusive) throws Exception
      Deprecated.
      Find jar names from the provided list matching a pattern. If the pattern is null and isNullInclusive is true, then all jar names will match. A pattern is a set of acceptable jar names. Each acceptable jar name is a regex. Each regex can be separated by either a "," or a "|". If you use a "|" this or's together the jar name patterns. This means that ordering of the matches is unimportant to you. If instead, you want to match particular jar names, and you want to match them in order, you should separate the regexs with "," instead. Eg "aaa-.*\\.jar|bbb-.*\\.jar" Will iterate over the jar names and match in any order. Eg "aaa-*\\.jar,bbb-.*\\.jar" Will iterate over the jar names, matching all those starting with "aaa-" first, then "bbb-".
      Parameters:
      pattern - the pattern to use for jar matching
      uris - the uris of the jars to scan
      isNullInclusive - if true, an empty pattern means all names match, if false, none match
      Throws:
      Exception - if unable to scan

    • scan

      public void scan(Pattern pattern, ClassLoader loader, boolean isNullInclusive, boolean visitParent) throws Exception
      Deprecated.
      Find jar names from the classloader matching a pattern. If the pattern is null and isNullInclusive is true, then all jar names in the classloader will match. A pattern is a set of acceptable jar names. Each acceptable jar name is a regex. Each regex can be separated by either a "," or a "|". If you use a "|" this or's together the jar name patterns. This means that ordering of the matches is unimportant to you. If instead, you want to match particular jar names, and you want to match them in order, you should separate the regexs with "," instead. Eg "aaa-.*\\.jar|bbb-.*\\.jar" Will iterate over the jar names in the classloader and match in any order. Eg "aaa-*\\.jar,bbb-.*\\.jar" Will iterate over the jar names in the classloader, matching all those starting with "aaa-" first, then "bbb-". If visitParent is true, then the pattern is applied to the parent loader hierarchy. If false, it is only applied to the classloader passed in.
      Parameters:
      pattern - the pattern to use for jar matching
      loader - the class loader to look for jars in
      isNullInclusive - if true, an empty pattern means all names match, if false, none match
      visitParent - if true, visit parent classloaders too
      Throws:
      Exception - if unable to scan

    • matched

      public void matched(URI uri) throws Exception
      Deprecated.
      Specified by:
      matched in class org.eclipse.jetty.util.PatternMatcher
      Throws:
      Exception