IOUtils和FileUtils的使用区别

JDK中提供的文件操作相关的类，功能非常基础，进行复杂操作时需要做大量编程工作。实际开发中，往往需要你自己动手编写相关的，尤其在遍历目录文件时，经常用到递归，非常繁琐。 Apache-commons工具包中提供了FileUtils，可以让我们非常方便的对文件和目录进行操作。 本文就是让大家对FileUtils类有一个全面的认识，便于大家以后开发文件和目录相关功能。

 

Apache IOUtils和FileUtils类库为我们提供了更加简单、功能更加强大的文件操作和IO流操作功能。非常值得大家学习和使用。

Apache基金会介绍

Apache软件基金会（也就是Apache Software Foundation，简称为ASF），是专门为支持开源软件项目而办的一个非盈利性组织。在它所支持的Apache项目与子项目中，所发行的软件产品都遵循Apache许可证（Apache License）。 官方网址为：www.apache.org 

很多著名的JAVA开源项目都来源于这个组织。比如：commons、kafka、lucene、marven、shiro、struts等技术，以及大数据技术中的：hadoop（大数据第一技术）、hbase、spark、storm、mahout等。

FileUtils妙用

jar包下载和介绍

首先，我们要下载FileUtils相关的Apache-commons-iojar包以及api文档。FileUtils类库的下载页面在：

http://commons.apache.org/proper/commons-io/download_io.cgi

点击下载：

API文档的页面：

http://commons.apache.org/proper/commons-io/javadocs/api-2.5/index.html 

我们本次示例，下载了最新的2.5版本，作为测试和示范。

 

eclpise项目如何导入外部的jar包操作

1. 在eclipse项目下新建lib文件夹

2. 解压下载后的版本，找到commons-io-2.5.jar包，并拷贝到lib文件夹下

3. 设置jar包进入项目的classpath中。

项目名上右击，依次选择【Build Path】-->【Configure Build Path...】，在打开的窗口中，先选中【Libraries】页，再从右边的按钮中点击 【add JARs...】； 在打开的窗口中，我们依次展开本项目的项目和lib文件夹，然后选中我们刚才复制到项目中的jar包，然后点击【Apply】使刚刚操作生效，最后点击【OK】关闭窗口。

项目结构如下：

新手雷区： 很多初学者会忘记配置项目的classpath，从而项目找不到相关的jar包。大家可以在此处多配置几次，足够熟练！

FieUtils类中常用方法的介绍

打开FileUtils的api文档，我们抽出一些工作中比较常用的方法，进行总结和讲解。总结如下：

cleanDirectory：清空目录，但不删除目录

contentEquals：比较两个文件的内容是否相同

copyDirectory：将一个目录内容拷贝到另一个目录。可以通过FileFilter过滤需要拷贝的文件。

copyFile：将一个文件拷贝到一个新的地址

copyFileToDirectory：将一个文件拷贝到某个目录下

copyInputStreamToFile：将一个输入流中的内容拷贝到某个文件

deleteDirectory：删除目录

deleteQuietly：删除文件

listFiles：列出指定目录下的所有文件

openInputSteam：打开指定文件的输入流

readFileToString：将文件内容作为字符串返回

readLines：将文件内容按行返回到一个字符串数组中

size：返回文件或目录的大小

write：将字符串内容直接写到文件中

writeByteArrayToFile: 将字节数组内容写到文件中

writeLines：将容器中的元素的toString方法返回的内容依次写入文件中

writeStringToFile：将字符串内容写到文件中

 

代码演示

【示例1】：读出某个文件的内容，并打印在控制台上（只需一行代码！）

package com.bjsxt.test.fileutils; import java.io.File; import org.apache.commons.io.FileUtils;   public class Demo01 {      public static void main(String[] args) throws Exception {             String content = FileUtils.readFileToString(new File("d:/a.txt"),"gbk");             System.out.println(content);         } }

示例1  运行效果图

【示例2】：目录拷贝，并且使用FileFilter过来目录和文件名字html结尾的文件。

package com.bjsxt.test.fileutils;   import java.io.File; import java.io.FileFilter; import org.apache.commons.io.FileUtils;     public class Demo02 {     public static void main(String[] args) throws Exception {           FileUtils.copyDirectory(new File("d:/aaa"), new File("d:/bbb"), new FileFilter() {             @Override             public boolean accept(File pathname) {                                  //拷贝目录或html结尾的文件                 if(pathname.isDirectory()||pathname.getName().endsWith("html")){                     return true;                 }else{                     return false;                 }             }         });     } }

 示例2 目录拷贝结果图

IOUtils妙用

打开IOUtils的api文档，我们发现他的方法大部分都是重载的。所以，我们理解他的方法并不是难事。因此，对于他方法的用法总结如下：

buffer方法：将传入的流进行包装，变成缓冲流。并可以通过参数指定缓冲大小。

closeQueitly方法：关闭流

contentEquals方法：比较两个流中的内容是否一致

copy方法：将输入流中的内容拷贝到输出流中，并可以指定字符编码。

copyLarge方法：将输入流中的内容拷贝到输出流中，适合大于2G内容的拷贝。

lineIterator方法：返回可以迭代每一行内容的迭代器

read方法：将输入流中的部分内容读入到字节数组中

readFully方法：将输入流中的所有内容读入到字节数组中

readLine方法：读入输入流内容中的一行

toBufferedInputStream，toBufferedReader：将输入转为带缓存的输入流

toByteArray，toCharArray：将输入流的内容转为字节数组、字符数组。

toString：将输入流或数组中的内容转化为字符串

write方法：向流里面写入内容

writeLine方法：向流里面写入一行内容

我们没有必要对每个方法做测试，只是演示一下读入d:/a.txt文件内容到程序中，并转成String对象，打印出来。

package com.bjsxt.test.fileutils;   import java.io.*;   import org.apache.commons.io.IOUtils;   public class Demo03 {     public static void main(String[] args) throws Exception {         String content = IOUtils.toString(new FileInputStream("d:/a.txt"),"gbk");         System.out.println(content);     } }

---

「全栈Java笔记」是一部能帮大家从零到一成长为全栈Java工程师系列笔记。笔者江湖人称 Mr. G，10年Java研发经验，曾在神州数码、航天院某所研发中心从事软件设计及研发工作，从小白逐渐做到工程师、高级工程师、架构师。精通Java平台软件开发，精通JAVAEE，熟悉各种流行开发框架。