首页 > 编程语言 > Java 获取 jar包以外的资源操作
2020
10-09

Java 获取 jar包以外的资源操作

在使用 jar 执行 java 代码时,有一个需求是从 jar 包所在目录的同级目录下读取配置文件的需求,从网上找了很多方法感觉都挺复杂的,

在这里总结一下.

以classpath 开头的 URL 表示该文件为jar包内文件的路径.

如:classpath://config/app.config表示jar包根路径config文件夹下的app.config文件

以file开头的URL表示该文件为jar 包外文件的路径

如:file://./config/app.config表示

摘要

// 当前我想从jar包的同级目录下读取一个名为 'config.txt'的文件的话,我需要指定目录为.

File file = new File(".","config.txt")

说明

File file = new File("config.txt")

当只包含文件名称时,java程序会默认尝试从jar包的根路径去读取文件,当尝试使用 file.getCanonicalPath() 方法读取时,便会得到该文件在jar包内的路径.

示例

我当前的工程的路径为D:\WorkSpace\path_demo01\

在工程执行以下java代码:

当指定parent时:

会从parent下查找path资源.

log(FileUtil.file(".", "/config/app.config").getCanonicalPath());
log(FileUtil.file(".", "config/app.config").getCanonicalPath());
// D:\WorkSpace\path_demo01\config\app.config

//加载与当前jar包同级目录下的文件
log(FileUtil.file(".", "app.config").getCanonicalPath());

当没有指定parent:

如果path为绝对路径时,会从绝对路径下查找

如果path为相对路径时,会从classpath的根路径下开始查找

log(FileUtil.file("/config/app.config").getCanonicalPath());
// D:\config\app.config

log(FileUtil.file("config/app.config").getCanonicalPath());
// D:\WorkSpace\path_demo01\target\classes\config\app.config

通过当前类加载资源:

如果path为相对路径会指定要加载的资源路径与当前类所在包的路径一致

如果path为绝对路径,那么就会从classpath的根路径下开始查找

log(App.class.getResource("/config/app.config"));
// file:/D:/WorkSpace/path_demo01/target/classes/config/app.config

log(App.class.getResource("config/app.config"));
// file:/D:/WorkSpace/path_demo01/target/classes/top/ghimi/config/app.config

通过类加载器加载资源:

默认是从ClassPath根下获取,path不能以/开头,最终是由ClassLoader获取资源.

log(App.class.getClassLoader().getResource("/config/app.config"));
// null

log(App.class.getClassLoader().getResource("config/app.config"));
// file:/D:/WorkSpace/path_demo01/target/classes/config/app.config

加载jar包内的资源

当代码打包成jar包的形式后,是无法通过new File()的形式加载jar包内的资源的.此时有可能抛出

FileNotFoundException异常,是由于将path当成jar包外的目录查找不到资源导致的.

URI is not hierarchical异常,是由于无法直接读取jar包中资源(透明)而抛出的异常.

解决方法:

使用 getResourceAsStream()方法直接获取资源的流而不是getResource()获取资源文件对象的方式读取资源.

//修改前,未打包成jar包时能够正常执行,打包后会抛出异常
log(App.class.getClassLoader().getResource("config/app.config"));

// 修改后,打成jar包后也可以正常加载资源
log(App.class.getClassLoader().getResourceAsStream("config/app.config"));

加载jar包外的资源

会从parent目录下查找path资源.

//加载与当前jar包同级目录下的文件
log(FileUtil.file(".", "app.config").getCanonicalPath());
// D:\WorkSpace\path_demo01\app.config

//加载与当前jar包的上一级目录下的文件
log(FileUtil.file("..", "app.config").getCanonicalPath());
// D:\WorkSpace\app.config

借用工具hutool:

<dependency>
  <groupId>cn.hutool</groupId>
  <artifactId>hutool-all</artifactId>
  <version>4.5.6</version>
</dependency>

补充知识:java中jar包内的类访问jar包内部的资源文件的路径问题

在本地项目中,若我们要访问项目中的资源文件,则一般使用相对路径或者用System.getProperities("user.dir")得到项目根目录,然后再访问资源文件,但是在将该工程和资源文件打包为jar包,运行该jar文件时,会显示找不到资源文件的错误。

在如下项目结构树中,项目根目录为nlpir,如果我们要在src下的某个package的某个java文件中访问blackWhite文件夹中的文件,则相对路径为"blackWhite/....."即可。但是在打包为jar包时,即使我们把blackWhite文件夹同样加入到打包的文件行列,在运行该jar包时,会出错:找不到blackWhite中某文件的路径。

解决方法:

使用Class.getResource或者是ClassLoader.getResourceAsStream()将文件内容放到InputStream中,具体使用如下:

String s1 = this.getClass().getResource("/library.properties").getPath();

或者为:

String s1 = CodeTest.class.getResource("/library.properties").getPath();

注意,使用class的getRescource时,要注意路径前要加"/",即根目录,此处的根目录是src

若像如下使用:

String class_str = this.getClass().getResource("logback.xml").getPath();

则会出错如下:

使用ClassLoader时,如下:

this.getClass().getClassLoader().getResource()

在使用ClassLoader时,路径前面不能加"/",使用相对路径。

如下示例:

@Test
 public void test4(){
 String class_str = this.getClass().getResource("/logback.xml").getPath();
 String class_str2 = TempTest.class.getResource("/logback.xml").getPath();
   String classLoader_str = this.getClass().getClassLoader().getResource("logback.xml").getPath();
   InputStream is = this.getClass().getClassLoader().getResourceAsStream("logback.xml");
 System.out.println(class_str);
   System.out.println(class_str2);
 System.out.println(classLoader_str);
   System.out.println(is == null );
 }

结果如下:

String ss = TempTest.class.getResource("/").getPath();

上述该代码得到的是项目的根目录,即nlpir的根目录,结果如下:

/C:/eclipse/eclipse/workspace/nlpir/out/production/nlpir/

如下代码:

@Test
 public void readProperties(){
 String ss = TempTest.class.getResource("/").getPath();
 System.out.println(ss);
 String s = new File(ss).getParentFile().getPath();
 System.out.println(s);
 String system_str = System.getProperty("user.dir");
 System.out.println(system_str);
 }</span>

运行结果如下:

其中,File.getParentFile()可用于求父目录

将上述readProperties函数打包为jar包在命令行使用java -jar TempTest.jar运行时,结果如下:

由此可见,打包成jar包时和在ide中直接运行的结果并不一样,所以在jar包中的class类要访问自己jar包中的资源文件时,应该使用Class.getResource或者是getResourceAsStream放在InputStream中,再进行访问。但是该方法只能访问到src下的资源文件,因为其根目录对应的就是src,无法访问到项目根目录下src外的文件,如上述项目结构图中的blackWhite中的文件无法访问到,解决方法还木有找到。。。。。。

当jar包外部的类需要访问某个jar包的资源文件时,使用JarFile类,

具体使用方法如下:

如果你对于常用的ZIP格式比较熟悉的话,JAR文件也就差不多。JAR文件提供一种将多个文件打包到一个文件中的方法,其中每一个文件可能独立地被压缩。JAR文件所增加的内容是manifest,它允许开发者可以提供附加的关于内容的信息。例如,manifest表明JAR文件中的哪个文件是用来运行一个程序的,或者库的版本号等。

J2SEDK提供了一个JAR工具,你可以用它从控制台读写JAR文件。然而,如果你需要在程序中代码读写JAR文件,可能需要一点时间(本文只包含如何在程序中读写JAR文件)。好消息是你可以做到这一点,而且你不用担心解压的事,因为类库将帮助你完成这些。

首先,通过把将JAR文件位置传给构造函数,创建一个JarFile的实例,位置可能是String或File的形式,如下:

JarFile jf = new JarFile("C:/jxl.jar");

或者为:

File file = new File("C:/jxl.jar");

JarFile jarFile = new JarFile(file);

你可能注意到当文件不在class path中时,JarFile类对于从JAR中读取文件文件是很有用的。当你想指定目标JAR文件时,JarFile类对于从JAR中读取文件同样也很有用。

当然,如果JAR文件在class path中,从其中读取文件的方法比较简单,你可以用下面的方法:

URL url = ClassLoader.getSystemResource(name);

或者为:

InputStream stream =

ClassLoader.getSystemResourceAsStream("javax/servlet/LocalStrings_fr.properties");

当你有了该JAR文件的一个引用之后,你就可以读取其文件内容中的目录信息了。JarFile的entries方法返回所有entries的枚举集合 (Enumeration)。通过每一个entry,你可以从它的manifest文件得到它的属性,任何认证信息,以及其他任何该entry的信息,如它的名字或者大小等。

Enumeration enu = jf.entries();
while (enu.hasMoreElements()) {
JarEntry element = (JarEntry) enu.nextElement();
        String name = element.getName();
        Long size = element.getSize();
        Long time = element.getTime();
        Long compressedSize = element.getCompressedSize();
        
        System.out.print(name+"/t");
        System.out.print(size+"/t");
        System.out.print(compressedSize+"/t");
        System.out.println(new SimpleDateFormat("yyyy-MM-dd").format(new Date(time)));
}

为了从JAR文件中真正读取一个指定的文件,你必须到其entry的InputStream。这和JarEntry不一样。这是因为JarEntry只是包含该entry的有关信息,但是并不实际包含该entry的内容。这和File和FileInputStream的区别有点儿相似。访问文件没有打开文件,它只是从目录中读取了该文件的信息。

下面是如何得到entry的InputStream:

InputStream input = jarFile.getInputStream(entry);

当你有了输入流,你就可以像读取其他流一样读取它。在文本流中(text stream),记得使用读取器(Reader)从流中取得字符。对于面向字节的流,如图片文件,直接读取就行了。

示例:

下面的程序演示如何从JAR文件中读取文件。指定JAR文件的名称,要读取的文件的名称(打包JAR文件中的某一个文件)作为参数来调用该程序。要读取的文件应该有一个文本类型的。

import java.io.*; 
   import java.util.jar.*; 
  
   public class JarRead { 
    public static void main (String args[]) 
      throws IOException { 
     if (args.length != 2) { 
      System.out.println( 
       "Please provide a JAR filename and file to read"); 
      System.exit(-1); 
     } 
     JarFile jarFile = new JarFile(args[0]); 
     JarEntry entry = jarFile.getJarEntry(args[1]); 
     InputStream input = jarFile.getInputStream(entry); 
     process(input); 
     jarFile.close(); 
    } 
  
    private static void process(InputStream input) 
      throws IOException { 
     InputStreamReader isr = 
     new InputStreamReader(input); 
     BufferedReader reader = new BufferedReader(isr); 
     String line; 
     while ((line = reader.readLine()) != null) { 
      System.out.println(line); 
     } 
     reader.close(); 
    } 
   }

假设在myfiles.jar文件中有一个spider.txt文件,spider文件的内容如下:

The itsy bitsy spider
   Ran up the water spout
   Down came the rain and
   Washed the spider out 

可以通过下面的命令在命令行来显示该文本文件的内容:

java JarRead myfiles.jar spider.txt

以上这篇Java 获取 jar包以外的资源操作就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持自学编程网。

编程技巧