首页 > 代码库 > java文件读取的路径问题解惑和最佳实践,让你远离FileNotFoundException
java文件读取的路径问题解惑和最佳实践,让你远离FileNotFoundException
使用java读取jar或war下的配置文件,是开发者经常需要处理的事情,大家是不是经常遇到FileNotFoundException呢?java读取文件的方式也有很多,比如new File(),Class.getResource(),ClassLoader.getResource(),这些方式的差别是什么呢?开源框架struts2的ClassLoaderUtils和Spring提供ClassPathResource,都提供了对资源读取进行封装的工具类,你是否了解他们的实现原理呢?本文结合网上的一些博客和自己的理解,和大家一起讨论下java的文件读取问题。
1.使用new File()的问题
public class TestFile { public static void main(String[] args) throws Exception { File absoluteFile = new File("c:/workspace/path_project/demo.txt"); File relativeFile = new File("demo.txt"); showFileContent(absoluteFile); showFileContent(relativeFile); } public static void showFileContent(File file) throws Exception { BufferedReader br = new BufferedReader(new FileReader(file)); StringBuilder contentHolder = new StringBuilder(); String lineContent = null; while ((lineContent = br.readLine()) != null) { contentHolder.append(lineContent); } br.close(); System.out.println("content=" + contentHolder); } }工程在硬盘和eclipse的目录结构如下:
在eclipse中运行上面的程序,发现2种方式都是能够正确读取文件的,不会抛FileNotFoundException。
使用绝对路径,虽然定位很清晰,但是不灵活。比如你将上面的工程放到D盘下,就必须要修改绝对路径路径,这显然很不方便。使用相对路径则跟工程所在的硬盘路径无关,直接导入eclipse中运行,就能够正确读取文件内容。而且实际情况是,很多时候我们并不知道文件的绝对路径,这会因为部署环境的不同而不同。比如将制作好的war放到tomcat或jboss容器下运行,很显然绝对路径是不同的,而我们的代码事先并不知道。
那么使用相对路径呢?很遗憾,也同样存在很多问题。File是java.io包的基础类,java.io 包中的类总是根据当前用户目录来分析相对路径名。也就是说以下2种方式是等价的,
File file1 = new File("demo.txt"); String asbPath = System.getProperty("user.dir") + "/demo.txt"; File file2 = new File(asbPath);也就是说相对路径是否好使,取决于user.dir的值。系统属性 user.dir是JVM启动的时候设置的,通常是 Java 虚拟机的调用目录,即执行java命令所在的目录。
对于tomcat/jboss容器,user.dir是%home/bin%/目录,因为这个目录就是我们启动web容器的地方。也就是说,user.dir也是可变的,不固定的。显然使用这种方式跟绝对路径没有什么本质差别,都是不推荐的。顺便提一下,我们在eclipse中运行程序的时候,eclipse会将user.dir的值设置为工程的根目录,在我们的例子中,user.dir是c:/workspace/path_project/
可以得出结论:使用java.io.File读取文件,无论是相对路径,还是绝对路径都不是好的做法,能不使用就不要使用。
2.使用Class.getResource()或ClassLoader.getResource()
TestClass.class.getResource("test.txt"); TestClass.class.getResource("/net/aty/test.txt"); TestClass.class.getClassLoader().getResource("net/aty/test.txt");
Class.getResource()有2种方式,绝对路径和相对路径。绝对路径以/开头,从classpath或jar包根目录下开始搜索;
相对路径是相对当前class所在的目录,允许使用..或.来定位文件。ClassLoader.getResource()只能使用绝对路径,而且不用以/开头。
这两种方式读取资源文件,不会依赖于user.dir,也不会依赖于具体部署的环境,是推荐的做法。
3.使用Class或ClassLoader.getResource()的相对路径和绝对路径问题
package net.aty; import java.io.BufferedReader; import java.io.InputStreamReader; import java.net.URL; public class TestClass { public static void main(String[] args) throws Exception { // 使用相对路径,正常读取b.jar中的文件 showContent(TestClass.class.getResource("b.txt")); // 使用相对路径,正常读取b.jar中的文件 showContent(TestClass.class.getResource("test/c.txt")); // 使用绝对对路径,正常读取b.jar中的文件 showContent(TestClass.class.getResource("/net/a.txt")); // 使用绝对对路径,正常读取b.jar中的文件 showContent(TestClass.class.getClassLoader().getResource("net/aty/test/c.txt")); // 使用相对路径,正常读取本jar中的same.txt showContent(TestClass.class.getResource("../same.txt")); // 错误 showContent(TestClass.class.getResource("../a.txt")); } public static void showContent(URL url) throws Exception { BufferedReader br = new BufferedReader(new InputStreamReader( url.openStream())); StringBuilder contentHolder = new StringBuilder(); String lineContent = null; while ((lineContent = br.readLine()) != null) { contentHolder.append(lineContent); } br.close(); System.out.println("content=" + contentHolder); } }可以得出结论:
4.spring框架的ClassPathResource实现
/** * This implementation opens an InputStream for the given class path resource. * @see java.lang.ClassLoader#getResourceAsStream(String) * @see java.lang.Class#getResourceAsStream(String) */ public InputStream getInputStream() throws IOException { InputStream is; if (this.clazz != null) { is = this.clazz.getResourceAsStream(this.path); } else { is = this.classLoader.getResourceAsStream(this.path); } if (is == null) { throw new FileNotFoundException(getDescription() + " cannot be opened because it does not exist"); } return is; }可以看出spring提供的ClassPathResource,底层使用的就是Class.getResource或ClassLoader.getResource()。spring提供的读取文件API功能,自然是与JDK一致。