import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
public JspServletWrapper(ServletContext servletContext,
                         Options options,
                         String tagFilePath,
                         TagInfo tagInfo,
                         JspRuntimeContext rctxt,
                         Jar tagJar) {

    this.isTagFile = true;
    this.config = null;        // not used
    this.options = options;
    this.jspUri = tagFilePath;
    this.tripCount = 0;
    unloadByCount = options.getMaxLoadedJsps() > 0 ? true : false;
    unloadByIdle = options.getJspIdleTimeout() > 0 ? true : false;
    unloadAllowed = unloadByCount || unloadByIdle ? true : false;
    ctxt = new JspCompilationContext(jspUri, tagInfo, options,
                                     servletContext, this, rctxt,
                                     tagJar);
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
public static InputStream getInputStream(String fname, Jar jar,
        JspCompilationContext ctxt) throws IOException {

    InputStream in = null;

    if (jar != null) {
        String jarEntryName = fname.substring(1, fname.length());
        in = jar.getInputStream(jarEntryName);
    } else {
        in = ctxt.getResourceAsStream(fname);
    }

    if (in == null) {
        throw new FileNotFoundException(Localizer.getMessage(
                "jsp.error.file.not.found", fname));
    }

    return in;
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
static InputStreamReader getReader(String fname, String encoding,
        Jar jar, JspCompilationContext ctxt, ErrorDispatcher err, int skip)
        throws JasperException, IOException {

    InputStreamReader reader = null;
    InputStream in = getInputStream(fname, jar, ctxt);
    for (int i = 0; i < skip; i++) {
        in.read();
    }
    try {
        reader = new InputStreamReader(in, encoding);
    } catch (UnsupportedEncodingException ex) {
        err.jspError("jsp.error.unsupported.encoding", encoding);
    }

    return reader;
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
private TagFileInfo createTagFileInfo(TagFileXml tagFileXml, Jar jar) throws JasperException {

        String name = tagFileXml.getName();
        String path = tagFileXml.getPath();

        if (path == null) {
            // path is required
            err.jspError("jsp.error.tagfile.missingPath");
        } else if (!path.startsWith("/META-INF/tags") && !path.startsWith("/WEB-INF/tags")) {
            err.jspError("jsp.error.tagfile.illegalPath", path);
        }

        TagInfo tagInfo =
                TagFileProcessor.parseTagFileDirectives(parserController, name, path, jar, this);
        return new TagFileInfo(name, path, tagInfo);
    }
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
/**
 * Scan JARs that contain web-fragment.xml files that will be used to
 * configure this application to see if they also contain static resources.
 * If static resources are found, add them to the context. Resources are
 * added in web-fragment.xml priority order.
 */
protected void processResourceJARs(Set<WebXml> fragments) {
    for (WebXml fragment : fragments) {
        URL url = fragment.getURL();
        Jar jar = null;
        try {
            // Note: Ignore file URLs for now since only jar URLs will be accepted
            if ("jar".equals(url.getProtocol())) {
                jar = JarFactory.newInstance(url);
                if (jar.entryExists("META-INF/resources/")) {
                    context.addResourceJarUrl(url);
                }
            }
        } catch (IOException ioe) {
            log.error(sm.getString("contextConfig.resourceJarFail", url,
                    context.getName()));
        } finally {
            if (jar != null) {
                jar.close();
            }
        }
    }
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
@Override
public void scan(JarURLConnection jarConn) throws IOException {

    URL url = jarConn.getURL();
    URL resourceURL = jarConn.getJarFileURL();
    Jar jar = null;
    InputStream is = null;
    WebXml fragment = new WebXml();

    try {
        jar = JarFactory.newInstance(url);
        if (parseRequired || context.getXmlValidation()) {
            is = jar.getInputStream(FRAGMENT_LOCATION);
        }

        if (is == null) {
            // If there is no web-fragment.xml to process there is no
            // impact on distributable
            fragment.setDistributable(true);
        } else {
            InputSource source = new InputSource(
                    "jar:" + resourceURL.toString() + "!/" +
                    FRAGMENT_LOCATION);
            source.setByteStream(is);
            parseWebXml(source, fragment, true);
        }
    } finally {
        if (jar != null) {
            jar.close();
        }
        fragment.setURL(url);
        if (fragment.getName() == null) {
            fragment.setName(fragment.getURL().toString());
        }
        fragment.setJarName(extractJarFileName(url));
        fragments.put(fragment.getName(), fragment);
    }
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
@Override
public void scan(JarURLConnection jarConn) throws IOException {

	URL url = jarConn.getURL();
	URL resourceURL = jarConn.getJarFileURL();
	Jar jar = null;
	InputStream is = null;
	WebXml fragment = new WebXml();

	try {
		jar = JarFactory.newInstance(url);
		if (parseRequired || context.getXmlValidation()) {
			is = jar.getInputStream(FRAGMENT_LOCATION);
		}

		if (is == null) {
			// If there is no web-fragment.xml to process there is no
			// impact on distributable
			fragment.setDistributable(true);
		} else {
			InputSource source = new InputSource("jar:" + resourceURL.toString() + "!/" + FRAGMENT_LOCATION);
			source.setByteStream(is);
			parseWebXml(source, fragment, true);
		}
	} finally {
		if (jar != null) {
			jar.close();
		}
		fragment.setURL(url);
		if (fragment.getName() == null) {
			fragment.setName(fragment.getURL().toString());
		}
		fragment.setJarName(extractJarFileName(url));
		fragments.put(fragment.getName(), fragment);
	}
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
public Jar openJar() throws IOException {
    if (entryName == null) {
        return null;
    } else {
        return JarFactory.newInstance(url);
    }
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
@Override
public void scan(JarURLConnection urlConn, String webappPath,
        boolean isWebapp) throws IOException {
    if (!jarFound) {
        jarFound = true;
    }
    boolean found = false;
    URL jarURL = null;
    try (Jar jar = JarFactory.newInstance(urlConn.getURL())) {
        jarURL = jar.getJarFileURL();
        jar.nextEntry();
        for (String entryName = jar.getEntryName();
            entryName != null;
            jar.nextEntry(), entryName = jar.getEntryName()) {
            if (!(entryName.startsWith("META-INF/") &&
                    entryName.endsWith(TLD_EXT))) {
                continue;
            }
            found = true;
            TldResourcePath tldResourcePath =
                    new TldResourcePath(jarURL, webappPath, entryName);
            try {
                parseTld(tldResourcePath);
            } catch (SAXException e) {
                throw new IOException(e);
            }
        }
    }
    if (found) {
        tldFound = true;
    } else {
        if (log.isDebugEnabled()) {
            log.debug(Localizer.getMessage("jsp.tldCache.noTldInJar",
                    jarURL.toString()));
        }
    }
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
private JspCompilationContext(String jspUri, TagInfo tagInfo,
        Options options, ServletContext context, JspServletWrapper jsw,
        JspRuntimeContext rctxt, Jar tagJar, boolean isTagFile) {

    this.jspUri = canonicalURI(jspUri);
    this.options = options;
    this.jsw = jsw;
    this.context = context;

    String baseURI = jspUri.substring(0, jspUri.lastIndexOf('/') + 1);
    // hack fix for resolveRelativeURI
    if (baseURI == null) {
        baseURI = "/";
    } else if (baseURI.charAt(0) != '/') {
        // strip the base slash since it will be combined with the
        // uriBase to generate a file
        baseURI = "/" + baseURI;
    }
    if (baseURI.charAt(baseURI.length() - 1) != '/') {
        baseURI += '/';
    }
    this.baseURI = baseURI;

    this.rctxt = rctxt;
    this.basePackageName = Constants.JSP_PACKAGE_NAME;

    this.tagInfo = tagInfo;
    this.tagJar = tagJar;
    this.isTagFile = isTagFile;
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
public static InputSource getInputSource(String fname, Jar jar, JspCompilationContext ctxt)
    throws IOException {
    InputSource source;
    if (jar != null) {
        String jarEntryName = fname.substring(1, fname.length());
        source = new InputSource(jar.getInputStream(jarEntryName));
        source.setSystemId(jar.getURL(jarEntryName));
    } else {
        source = new InputSource(ctxt.getResourceAsStream(fname));
        source.setSystemId(ctxt.getResource(fname).toExternalForm());
    }
    return source;
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
/**
 * The constructor
 */
private Parser(ParserController pc, JspReader reader, boolean isTagFile,
        boolean directivesOnly, Jar jar) {
    this.parserController = pc;
    this.ctxt = pc.getJspCompilationContext();
    this.pageInfo = pc.getCompiler().getPageInfo();
    this.err = pc.getCompiler().getErrorDispatcher();
    this.reader = reader;
    this.scriptlessCount = 0;
    this.isTagFile = isTagFile;
    this.directivesOnly = directivesOnly;
    this.jar = jar;
    start = reader.mark();
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
/**
 * The main entry for Parser
 *
 * @param pc
 *            The ParseController, use for getting other objects in compiler
 *            and for parsing included pages
 * @param reader
 *            To read the page
 * @param parent
 *            The parent node to this page, null for top level page
 * @return list of nodes representing the parsed page
 */
public static Node.Nodes parse(ParserController pc, JspReader reader,
        Node parent, boolean isTagFile, boolean directivesOnly,
        Jar jar, String pageEnc, String jspConfigPageEnc,
        boolean isDefaultPageEncoding, boolean isBomPresent)
        throws JasperException {

    Parser parser = new Parser(pc, reader, isTagFile, directivesOnly, jar);

    Node.Root root = new Node.Root(reader.mark(), parent, false);
    root.setPageEncoding(pageEnc);
    root.setJspConfigPageEncoding(jspConfigPageEnc);
    root.setIsDefaultPageEncoding(isDefaultPageEncoding);
    root.setIsBomPresent(isBomPresent);

    // For the Top level page, add include-prelude and include-coda
    PageInfo pageInfo = pc.getCompiler().getPageInfo();
    if (parent == null && !isTagFile) {
        parser.addInclude(root, pageInfo.getIncludePrelude());
    }
    if (directivesOnly) {
        parser.parseFileDirectives(root);
    } else {
        while (reader.hasMoreInput()) {
            parser.parseElements(root);
        }
    }
    if (parent == null && !isTagFile) {
        parser.addInclude(root, pageInfo.getIncludeCoda());
    }

    Node.Nodes page = new Node.Nodes(root);
    return page;
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
private long[] getLastModified(TldResourcePath tldResourcePath) {
    long[] result = new long[2];
    result[0] = -1;
    result[1] = -1;
    try {
        String webappPath = tldResourcePath.getWebappPath();
        if (webappPath != null) {
            // webappPath will be null for JARs containing TLDs that are on
            // the class path but not part of the web application
            URL url = servletContext.getResource(tldResourcePath.getWebappPath());
            URLConnection conn = url.openConnection();
            result[0] = conn.getLastModified();
            if ("file".equals(url.getProtocol())) {
                // Reading the last modified time opens an input stream so we
                // need to make sure it is closed again otherwise the TLD file
                // will be locked until GC runs.
                conn.getInputStream().close();
            }
        }
        try (Jar jar = tldResourcePath.openJar()) {
            if (jar != null) {
                result[1] = jar.getLastModified(tldResourcePath.getEntryName());
            }
        }
    } catch (IOException e) {
        // Ignore (shouldn't happen)
    }
    return result;
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
/**
 * Extracts tag file directive information from the given tag file.
 *
 * This is invoked by the compiler
 *
 * @param inFileName    The name of the tag file to be parsed.
 * @param jar The location of the tag file.
 */
public Node.Nodes parseTagFileDirectives(String inFileName, Jar jar)
        throws FileNotFoundException, JasperException, IOException {
    boolean isTagFileSave = isTagFile;
    boolean directiveOnlySave = directiveOnly;
    isTagFile = true;
    directiveOnly = true;
    Node.Nodes page = doParse(inFileName, null, jar);
    directiveOnly = directiveOnlySave;
    isTagFile = isTagFileSave;
    return page;
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
@Override
public void visit(Node.CustomTag n) throws JasperException {
    TagFileInfo tagFileInfo = n.getTagFileInfo();
    if (tagFileInfo != null) {
        String tagFilePath = tagFileInfo.getPath();
        if (tagFilePath.startsWith("/META-INF/")) {
            // For tags in JARs, add the TLD and the tag as a dependency
            TldResourcePath tldResourcePath =
                compiler.getCompilationContext().getTldResourcePath(
                    tagFileInfo.getTagInfo().getTagLibrary().getURI());

            try (Jar jar = tldResourcePath.openJar()) {

                if (jar != null) {
                    // Add TLD
                    pageInfo.addDependant(jar.getURL(tldResourcePath.getEntryName()),
                                          Long.valueOf(jar.getLastModified(tldResourcePath.getEntryName())));
                    // Add Tag
                    pageInfo.addDependant(jar.getURL(tagFilePath.substring(1)),
                                          Long.valueOf(jar.getLastModified(tagFilePath.substring(1))));
                } else {
                    pageInfo.addDependant(tagFilePath,
                                          compiler.getCompilationContext().getLastModified(
                                                                                           tagFilePath));
                }
            } catch (IOException ioe) {
                throw new JasperException(ioe);
            }
        } else {
            pageInfo.addDependant(tagFilePath,
                    compiler.getCompilationContext().getLastModified(
                            tagFilePath));
        }
        Class<?> c = loadTagFile(compiler, tagFilePath, n.getTagInfo(),
                pageInfo);
        n.setTagHandlerClass(c);
    }
    visitBody(n);
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
@Test
public void testClassParserPerformance() throws IOException {
    File libDir = new File(JAR_LOCATION);
    String[] libs = libDir.list();

    Set<URL> jarURLs = new HashSet<URL>();

    for (String lib : libs) {
        if (!lib.toLowerCase(Locale.ENGLISH).endsWith(".jar")) {
            continue;
        }
        jarURLs.add(new URL("jar:" + new File (libDir, lib).toURI().toURL().toExternalForm() + "!/"));
    }

    long duration = 0;

    for (URL jarURL : jarURLs) {
        Jar jar = JarFactory.newInstance(jarURL);
        jar.nextEntry();
        String jarEntryName = jar.getEntryName();
        while (jarEntryName != null) {
            if (jarEntryName.endsWith(".class")) {
                InputStream is = jar.getEntryInputStream();
                long start = System.nanoTime();
                ClassParser cp = new ClassParser(is);
                cp.parse();
                duration += System.nanoTime() - start;
            }
            jar.nextEntry();
            jarEntryName = jar.getEntryName();
        }
    }

    System.out.println("ClassParser performance test took: " + duration + "ns");
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
private void tldScanJar(JarURLConnection jarConn) throws IOException {

        Jar jar = null;
        InputStream is;
        boolean foundTld = false;
        
        URL resourceURL = jarConn.getJarFileURL();
        String resourcePath = resourceURL.toString();
        
        try {
            jar = JarFactory.newInstance(jarConn.getURL());
            
            jar.nextEntry();
            String entryName = jar.getEntryName();
            while (entryName != null) {
                if (entryName.startsWith("META-INF/") &&
                        entryName.endsWith(".tld")) {
                    is = null;
                    try {
                        is = jar.getEntryInputStream();
                        foundTld = true;
                        tldScanStream(resourcePath, entryName, is);
                    } finally {
                        if (is != null) {
                            try {
                                is.close();
                            } catch (IOException ioe) {
                                // Ignore
                            }
                        }
                    }
                }
                jar.nextEntry();
                entryName = jar.getEntryName();
            }
        } finally {
            if (jar != null) {
                jar.close();
            }
        }

        if (!foundTld) {
            if (log.isDebugEnabled()) {
                log.debug(Localizer.getMessage("jsp.tldCache.noTldInJar",
                        resourcePath));
            } else if (showTldScanWarning) {
                // Not entirely thread-safe but a few duplicate log messages are
                // not a huge issue
                showTldScanWarning = false;
                log.info(Localizer.getMessage("jsp.tldCache.noTldSummary"));
            }
        }
    }
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
@Test
public void testClassParserPerformance() throws IOException {
    File libDir = new File(JAR_LOCATION);
    String[] libs = libDir.list();

    Assert.assertNotNull(libs);

    Set<URL> jarURLs = new HashSet<URL>();

    for (String lib : libs) {
        if (!lib.toLowerCase(Locale.ENGLISH).endsWith(".jar")) {
            continue;
        }
        jarURLs.add(new URL("jar:" + new File (libDir, lib).toURI().toURL().toExternalForm() + "!/"));
    }

    long duration = 0;

    for (URL jarURL : jarURLs) {
        Jar jar = JarFactory.newInstance(jarURL);
        try {
            jar.nextEntry();
            String jarEntryName = jar.getEntryName();
            while (jarEntryName != null) {
                if (jarEntryName.endsWith(".class")) {
                    InputStream is = jar.getEntryInputStream();
                    long start = System.nanoTime();
                    ClassParser cp = new ClassParser(is);
                    cp.parse();
                    duration += System.nanoTime() - start;
                }
                jar.nextEntry();
                jarEntryName = jar.getEntryName();
            }
        } finally {
            jar.close();
        }
    }

    System.out.println("ClassParser performance test took: " + duration + " ns");
}
 

import org.apache.tomcat.util.scan.Jar; //导入依赖的package包/类
private void tldScanJar(JarURLConnection jarConn) throws IOException {

		Jar jar = null;
		InputStream is;
		boolean foundTld = false;

		URL resourceURL = jarConn.getJarFileURL();
		String resourcePath = resourceURL.toString();

		try {
			jar = JarFactory.newInstance(jarConn.getURL());

			jar.nextEntry();
			String entryName = jar.getEntryName();
			while (entryName != null) {
				if (entryName.startsWith("META-INF/") && entryName.endsWith(".tld")) {
					is = null;
					try {
						is = jar.getEntryInputStream();
						foundTld = true;
						tldScanStream(resourcePath, entryName, is);
					} finally {
						if (is != null) {
							try {
								is.close();
							} catch (IOException ioe) {
								// Ignore
							}
						}
					}
				}
				jar.nextEntry();
				entryName = jar.getEntryName();
			}
		} finally {
			if (jar != null) {
				jar.close();
			}
		}

		if (!foundTld) {
			if (log.isDebugEnabled()) {
				log.debug(Localizer.getMessage("jsp.tldCache.noTldInJar", resourcePath));
			} else if (showTldScanWarning) {
				// Not entirely thread-safe but a few duplicate log messages are
				// not a huge issue
				showTldScanWarning = false;
				log.info(Localizer.getMessage("jsp.tldCache.noTldSummary"));
			}
		}
	}