java - 如何列出 JAR 文件中的文件？

Question

我有这段代码，它从目录中读取所有文件。

    File textFolder = new File("text_directory");

    File [] texFiles = textFolder.listFiles( new FileFilter() {
           public boolean accept( File file ) {
               return file.getName().endsWith(".txt");
           }
    });

它工作得很好。它用目录“text_directory”中以“.txt”结尾的所有文件填充数组。

如何在JAR 文件中以类似的方式读取目录的内容？

所以我真正想做的是，列出我的 JAR 文件中的所有图像，这样我就可以加载它们：

ImageIO.read(this.getClass().getResource("CompanyLogo.png"));

（因为“CompanyLogo”是“硬编码”的，但 JAR 文件中的图像数量可能是 10 到 200 个可变长度。）

编辑

所以我想我的主要问题是：如何知道我的主类所在的 JAR 文件的名称？

当然，我可以使用java.util.Zip.

我的结构是这样的：

它们就像：

my.jar!/Main.class
my.jar!/Aux.class
my.jar!/Other.class
my.jar!/images/image01.png
my.jar!/images/image02a.png
my.jar!/images/imwge034.png
my.jar!/images/imagAe01q.png
my.jar!/META-INF/manifest

现在我可以使用以下方法加载例如“images/image01.png”：

    ImageIO.read(this.getClass().getResource("images/image01.png));

但仅仅因为我知道文件名，其余的我必须动态加载它们。

score 107 · Accepted Answer

CodeSource src = MyClass.class.getProtectionDomain().getCodeSource();
if (src != null) {
  URL jar = src.getLocation();
  ZipInputStream zip = new ZipInputStream(jar.openStream());
  while(true) {
    ZipEntry e = zip.getNextEntry();
    if (e == null)
      break;
    String name = e.getName();
    if (name.startsWith("path/to/your/dir/")) {
      /* Do something with this entry. */
      ...
    }
  }
} 
else {
  /* Fail... */
}

请注意，在 Java 7 中，您可以FileSystem从 JAR (zip) 文件中创建一个，然后使用 NIO 的目录遍历和过滤机制来搜索它。这将使编写处理 JAR 和“爆炸”目录的代码变得更容易。

score 91 · Accepted Answer

适用于 IDE 和 .jar 文件的代码：

import java.io.*;
import java.net.*;
import java.nio.file.*;
import java.util.*;
import java.util.stream.*;

public class ResourceWalker {
    public static void main(String[] args) throws URISyntaxException, IOException {
        URI uri = ResourceWalker.class.getResource("/resources").toURI();
        Path myPath;
        if (uri.getScheme().equals("jar")) {
            FileSystem fileSystem = FileSystems.newFileSystem(uri, Collections.<String, Object>emptyMap());
            myPath = fileSystem.getPath("/resources");
        } else {
            myPath = Paths.get(uri);
        }
        Stream<Path> walk = Files.walk(myPath, 1);
        for (Iterator<Path> it = walk.iterator(); it.hasNext();){
            System.out.println(it.next());
        }
    }
}

score 22 · Accepted Answer

埃里克森的回答完美：

这是工作代码。

CodeSource src = MyClass.class.getProtectionDomain().getCodeSource();
List<String> list = new ArrayList<String>();

if( src != null ) {
    URL jar = src.getLocation();
    ZipInputStream zip = new ZipInputStream( jar.openStream());
    ZipEntry ze = null;

    while( ( ze = zip.getNextEntry() ) != null ) {
        String entryName = ze.getName();
        if( entryName.startsWith("images") &&  entryName.endsWith(".png") ) {
            list.add( entryName  );
        }
    }

 }
 webimages = list.toArray( new String[ list.size() ] );

我刚刚修改了我的加载方法：

File[] webimages = ... 
BufferedImage image = ImageIO.read(this.getClass().getResource(webimages[nextIndex].getName() ));

对此：

String  [] webimages = ...

BufferedImage image = ImageIO.read(this.getClass().getResource(webimages[nextIndex]));

score 13 · Accepted Answer

我想扩展 acheron55 的答案，因为它是一个非常不安全的解决方案，原因如下：

它不会关闭FileSystem对象。
它不检查FileSystem对象是否已经存在。
它不是线程安全的。

这是一个更安全的解决方案：

private static ConcurrentMap<String, Object> locks = new ConcurrentHashMap<>();

public void walk(String path) throws Exception {

    URI uri = getClass().getResource(path).toURI();
    if ("jar".equals(uri.getScheme()) {
        safeWalkJar(path, uri);
    } else {
        Files.walk(Paths.get(path));
    }
}

private void safeWalkJar(String path, URI uri) throws Exception {

    synchronized (getLock(uri)) {    
        // this'll close the FileSystem object at the end
        try (FileSystem fs = getFileSystem(uri)) {
            Files.walk(fs.getPath(path));
        }
    }
}

private Object getLock(URI uri) {

    String fileName = parseFileName(uri);  
    locks.computeIfAbsent(fileName, s -> new Object());
    return locks.get(fileName);
}

private String parseFileName(URI uri) {

    String schemeSpecificPart = uri.getSchemeSpecificPart();
    return schemeSpecificPart.substring(0, schemeSpecificPart.indexOf("!"));
}

private FileSystem getFileSystem(URI uri) throws IOException {

    try {
        return FileSystems.getFileSystem(uri);
    } catch (FileSystemNotFoundException e) {
        return FileSystems.newFileSystem(uri, Collections.<String, String>emptyMap());
    }
}

没有真正需要同步文件名；每次都可以简单地在同一个对象上同步（或制作方法synchronized），这纯粹是一种优化。

我想说这仍然是一个有问题的解决方案，因为代码中可能有其他部分在FileSystem相同文件上使用接口，并且可能会干扰它们（即使在单线程应用程序中）。
此外，它不检查nulls （例如， on getClass().getResource().

这个特殊的 Java NIO 接口有点可怕，因为它引入了一个全局/单例非线程安全资源，而且它的文档非常模糊（由于提供者特定的实现，很多未知数）。FileSystem其他提供程序（不是 JAR）的结果可能会有所不同。也许有一个很好的理由。我不知道，我还没有研究过实现。

score 9 · Accepted Answer

所以我想我的主要问题是，如何知道我的主要班级所在的罐子的名称。

假设您的项目被打包在一个 Jar 中（不一定是真的！），您可以使用 ClassLoader.getResource() 或 findResource() 以及类名（后跟 .class）来获取包含给定类的 jar。您必须从返回的 URL 中解析 jar 名称（不是那么难），我将把它作为练习留给读者:-)

一定要测试类不是 jar 的一部分的情况。

score 8 · Accepted Answer

我已将acheron55 的答案移植到 Java 7 并关闭了该FileSystem对象。此代码在 IDE、jar 文件和 Tomcat 7 上的战争中的 jar 中有效；但请注意，它在 JBoss 7 的战争中的罐子中不起作用（它提供了FileSystemNotFoundException: Provider "vfs" not installed，另见这篇文章）。此外，与原始代码一样，它不是线程安全的，正如errr所建议的那样。由于这些原因，我放弃了这个解决方案；但是，如果您可以接受这些问题，这是我的现成代码：

import java.io.IOException;
import java.net.*;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
import java.util.Collections;

public class ResourceWalker {

    public static void main(String[] args) throws URISyntaxException, IOException {
        URI uri = ResourceWalker.class.getResource("/resources").toURI();
        System.out.println("Starting from: " + uri);
        try (FileSystem fileSystem = (uri.getScheme().equals("jar") ? FileSystems.newFileSystem(uri, Collections.<String, Object>emptyMap()) : null)) {
            Path myPath = Paths.get(uri);
            Files.walkFileTree(myPath, new SimpleFileVisitor<Path>() { 
                @Override
                public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
                    System.out.println(file);
                    return FileVisitResult.CONTINUE;
                }
            });
        }
    }
}

score 6 · Accepted Answer

这是一个使用Reflections库通过正则表达式名称模式递归扫描类路径的示例，该模式增加了几个Guava特权以获取资源内容：

Reflections reflections = new Reflections("com.example.package", new ResourcesScanner());
Set<String> paths = reflections.getResources(Pattern.compile(".*\\.template$"));

Map<String, String> templates = new LinkedHashMap<>();
for (String path : paths) {
    log.info("Found " + path);
    String templateName = Files.getNameWithoutExtension(path);
    URL resource = getClass().getClassLoader().getResource(path);
    String text = Resources.toString(resource, StandardCharsets.UTF_8);
    templates.put(templateName, text);
}

这适用于罐子和爆炸类。

score 5 · Accepted Answer

这是我为“在一个包下运行所有 JUnit”而编写的方法。您应该能够使其适应您的需求。

private static void findClassesInJar(List<String> classFiles, String path) throws IOException {
    final String[] parts = path.split("\\Q.jar\\\\E");
    if (parts.length == 2) {
        String jarFilename = parts[0] + ".jar";
        String relativePath = parts[1].replace(File.separatorChar, '/');
        JarFile jarFile = new JarFile(jarFilename);
        final Enumeration<JarEntry> entries = jarFile.entries();
        while (entries.hasMoreElements()) {
            final JarEntry entry = entries.nextElement();
            final String entryName = entry.getName();
            if (entryName.startsWith(relativePath)) {
                classFiles.add(entryName.replace('/', File.separatorChar));
            }
        }
    }
}

编辑：啊，在那种情况下，你可能也想要这个片段（相同的用例:)）

private static File findClassesDir(Class<?> clazz) {
    try {
        String path = clazz.getProtectionDomain().getCodeSource().getLocation().getFile();
        final String codeSourcePath = URLDecoder.decode(path, "UTF-8");
        final String thisClassPath = new File(codeSourcePath, clazz.getPackage().getName().repalce('.', File.separatorChar));
    } catch (UnsupportedEncodingException e) {
        throw new AssertionError("impossible", e);
    }
}

score 3 · Accepted Answer

jar 文件只是一个带有结构化清单的 zip 文件。您可以使用通常的 java zip 工具打开 jar 文件并以这种方式扫描文件内容，膨胀流等。然后在 getResourceAsStream 调用中使用它，它应该是所有的 hunky dory。

编辑/澄清后

我花了一分钟来记住所有的点点滴滴，我确信有更干净的方法可以做到这一点，但我想看看我没有疯。在我的项目中 image.jpg 是主 jar 文件的某些部分中的一个文件。我得到了主类的类加载器（SomeClass 是入口点）并用它来发现 image.jpg 资源。然后一些流魔术将它放入这个 ImageInputStream 事物中，一切都很好。

InputStream inputStream = SomeClass.class.getClassLoader().getResourceAsStream("image.jpg");
JPEGImageReaderSpi imageReaderSpi = new JPEGImageReaderSpi();
ImageReader ir = imageReaderSpi.createReaderInstance();
ImageInputStream iis = new MemoryCacheImageInputStream(inputStream);
ir.setInput(iis);
....
ir.read(0); //will hand us a buffered image

score 3 · Accepted Answer

给定一个实际的 JAR 文件，您可以使用JarFile.entries(). 不过，您将需要知道 JAR 文件的位置 - 您不能只要求类加载器列出它可以获取的所有内容。

您应该能够根据从返回的 URL 计算出 JAR 文件的位置ThisClassName.class.getResource("ThisClassName.class")，但这可能有点繁琐。

score 3 · Accepted Answer

前段时间我做了一个从 JAR 中获取类的函数：

public static Class[] getClasses(String packageName) 
throws ClassNotFoundException{
    ArrayList<Class> classes = new ArrayList<Class> ();

    packageName = packageName.replaceAll("\\." , "/");
    File f = new File(jarName);
    if(f.exists()){
        try{
            JarInputStream jarFile = new JarInputStream(
                    new FileInputStream (jarName));
            JarEntry jarEntry;

            while(true) {
                jarEntry=jarFile.getNextJarEntry ();
                if(jarEntry == null){
                    break;
                }
                if((jarEntry.getName ().startsWith (packageName)) &&
                        (jarEntry.getName ().endsWith (".class")) ) {
                    classes.add(Class.forName(jarEntry.getName().
                            replaceAll("/", "\\.").
                            substring(0, jarEntry.getName().length() - 6)));
                }
            }
        }
        catch( Exception e){
            e.printStackTrace ();
        }
        Class[] classesA = new Class[classes.size()];
        classes.toArray(classesA);
        return classesA;
    }else
        return null;
}

score 2 · Accepted Answer

public static ArrayList<String> listItems(String path) throws Exception{
    InputStream in = ClassLoader.getSystemClassLoader().getResourceAsStream(path);
    byte[] b = new byte[in.available()];
    in.read(b);
    String data = new String(b);
    String[] s = data.split("\n");
    List<String> a = Arrays.asList(s);
    ArrayList<String> m = new ArrayList<>(a);
    return m;
}

score 1 · Accepted Answer

有两个非常有用的实用程序都称为 JarScan：

另请参阅此问题：JarScan, scan all JAR files in all subfolders for specific class

score 1 · Accepted Answer

列出类路径中所有资源的最强大的机制目前是将此模式与 ClassGraph 一起使用，因为它处理最广泛的类路径规范机制，包括新的 JPMS 模块系统。（我是 ClassGraph 的作者。）

如何知道我的主类所在的 JAR 文件的名称？

URI mainClasspathElementURI;
try (ScanResult scanResult = new ClassGraph().whitelistPackages("x.y.z")
        .enableClassInfo().scan()) {
    mainClasspathElementURI =
            scanResult.getClassInfo("x.y.z.MainClass").getClasspathElementURI();
}

如何在 JAR 文件中以类似的方式读取目录的内容？

List<String> classpathElementResourcePaths;
try (ScanResult scanResult = new ClassGraph().overrideClasspath(mainClasspathElementURI)
        .scan()) {
    classpathElementResourcePaths = scanResult.getAllResources().getPaths();
}

还有很多其他方法可以处理资源。

score 1 · Accepted Answer

对于匹配特定文件名更灵活一点的道路，因为它使用通配符通配符。在功能样式中，这可能类似于：

import java.io.IOException;
import java.net.URISyntaxException;
import java.nio.file.FileSystem;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.function.Consumer;

import static java.nio.file.FileSystems.getDefault;
import static java.nio.file.FileSystems.newFileSystem;
import static java.util.Collections.emptyMap;

/**
 * Responsible for finding file resources.
 */
public class ResourceWalker {
  /**
   * Globbing pattern to match font names.
   */
  public static final String GLOB_FONTS = "**.{ttf,otf}";

  /**
   * @param directory The root directory to scan for files matching the glob.
   * @param c         The consumer function to call for each matching path
   *                  found.
   * @throws URISyntaxException Could not convert the resource to a URI.
   * @throws IOException        Could not walk the tree.
   */
  public static void walk(
    final String directory, final String glob, final Consumer<Path> c )
    throws URISyntaxException, IOException {
    final var resource = ResourceWalker.class.getResource( directory );
    final var matcher = getDefault().getPathMatcher( "glob:" + glob );

    if( resource != null ) {
      final var uri = resource.toURI();
      final Path path;
      FileSystem fs = null;

      if( "jar".equals( uri.getScheme() ) ) {
        fs = newFileSystem( uri, emptyMap() );
        path = fs.getPath( directory );
      }
      else {
        path = Paths.get( uri );
      }

      try( final var walk = Files.walk( path, 10 ) ) {
        for( final var it = walk.iterator(); it.hasNext(); ) {
          final Path p = it.next();
          if( matcher.matches( p ) ) {
            c.accept( p );
          }
        }
      } finally {
        if( fs != null ) { fs.close(); }
      }
    }
  }
}

考虑参数化文件扩展名，留给读者练习。

小心Files.walk。根据文档：

此方法必须在 try-with-resources 语句或类似的控制结构中使用，以确保在流的操作完成后立即关闭流的打开目录。

同样，newFileSystem必须关闭，但不能在 walker 有机会访问文件系统路径之前关闭。

score 1 · Accepted Answer

顺便提一下，如果您已经在使用 Spring，则可以利用PathMatchingResourcePatternResolver.

例如从images资源文件夹中获取所有 PNG 文件

ClassLoader cl = this.getClass().getClassLoader(); 
ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(cl);
Resource[] resources = resolver.getResources("images/*.png");
for (Resource r: resources){
    logger.info(r.getFilename());
    // From your example
    // ImageIO.read(cl.getResource("images/" + r.getFilename()));
}

score 0 · Accepted Answer

只是从 jar URL 列出/读取文件的另一种方式，它对嵌套 jar 递归执行

https://gist.github.com/trung/2cd90faab7f75b3bcbaa

URL urlResource = Thead.currentThread().getContextClassLoader().getResource("foo");
JarReader.read(urlResource, new InputStreamCallback() {
    @Override
    public void onFile(String name, InputStream is) throws IOException {
        // got file name and content stream 
    }
});

java - 如何列出 JAR 文件中的文件？

17 回答 17

Related

Reference