/* * Copyright (c) 1997, 2012, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package com.sun.istack.internal.tools; import java.io.InputStream; import java.io.ByteArrayOutputStream; import java.io.Closeable; import java.io.File; import java.io.IOException; import java.net.JarURLConnection; import java.net.URISyntaxException; import java.net.URL; import java.net.MalformedURLException; import java.net.URLConnection; import java.util.Collections; import java.util.Enumeration; import java.util.HashSet; import java.util.Set; import java.util.jar.JarFile; import java.util.logging.Level; import java.util.logging.Logger; /** * Load classes/resources from a side folder, so that * classes of the same package can live in a single jar file. * *
* For example, with the following jar file: *
* / * +- foo * +- X.class * +- bar * +- X.class **
* {@link ParallelWorldClassLoader}("foo/") would load X.class from * /foo/X.class (note that X is defined in the root package, not * foo.X. * *
* This can be combined with {@link MaskingClassLoader} to mask classes which are loaded by the parent * class loader so that the child class loader * classes living in different folders are loaded * before the parent class loader loads classes living the jar file publicly * visible * For example, with the following jar file: *
* / * +- foo * +- X.class * +- bar * +-foo * +- X.class **
* {@link ParallelWorldClassLoader}(MaskingClassLoader.class.getClassLoader()) would load foo.X.class from
* /bar/foo.X.class not the foo.X.class in the publicly visible place in the jar file, thus
* masking the parent classLoader from loading the class from foo.X.class
* (note that X is defined in the package foo, not
* bar.foo.X.
*
* @author Kohsuke Kawaguchi
*/
public class ParallelWorldClassLoader extends ClassLoader implements Closeable {
/**
* Strings like "prefix/", "abc/", or "" to indicate
* classes should be loaded normally.
*/
private final String prefix;
private final Set