Java之Apache Commons-IO使用精讲

Commons IO是针对开发IO流功能的工具类库。
主要包括六个区域：

工具类——使用静态方法执行共同任务
输入——用于InputStream和Reader实现
输出——用于OutputStream和Writer实现
过滤器——各种文件过滤器实现
比较器——各种文件的java.util.Comparator实现
文件监听器——监听文件系统事件的组件

工具类

IOUtils

该工具类可能是平时使用得最多的工具类了。
IOUtils包含处理读、写和复制的工具方法。方法对InputStream、OutputStream、Reader和Writer起作用。

例如，从一个URL读取字节的任务，并且打印它们：

    public static void main(String[] args) throws Exception {
        //从网络上读取一个网页资源
        InputStream in = new URL("http://commons.apache.org").openStream();
        try {
            InputStreamReader inR = new InputStreamReader(in);
            BufferedReader buf = new BufferedReader(inR);
            String line;
            while ((line = buf.readLine()) != null) {
                System.out.println(line);
            }
        } finally {
            if (in != null) {
                in.close();
            }
        }
    }
//结果：
//控制台打印出了这个网页的所有内容

使用IOUtils：

    public static void main(String[] args) throws Exception {
        //从网络上读取一个网页资源
        try (InputStream in = new URL("http://commons.apache.org").openStream()) {
            System.out.println(IOUtils.toString(in, StandardCharsets.UTF_8));
        }
        //finally {
        //    IOUtils.closeQuietly(in);
        //}
    }

主要方式介绍：

buffer：一句话可以吧inputStream、outputStream、Reader、Witter等包装成带缓冲区的流，提高效率
closeQuietly：可以关闭各种流、socket等任何closeable的实例（不过官方推荐使用try-with-resources来代替）
contentEquals：比较两个InputStream或者两个Reader里面的内容（字节流）是否完全相同

    public static void main(String[] args) throws Exception {
        try (InputStream in1 = new URL("http://commons.apache.org").openStream(); InputStream in2 = new URL("http://commons.apache.org").openStream()) {
            System.out.println(in1.equals(in2)); //false
            System.out.println(IOUtils.contentEquals(in1, in2)); //true
        }
    }

备注：contentEqualsIgnoreEOL(final Reader input1, final Reader input2) 该方法会忽略ignoring EOL characters

copy：流的互相拷贝。可以将输入流拷到输出流。copy(final InputStream input, final OutputStream output, final int bufferSize),Reader拷贝到Writer等等
copyLarge：当你的流拷贝的是大文件（一般大于2G级别），请使用此方法拷贝
lineIterator：BufferedReader 通常在只有读到空格或者换行符时才会结束读取，攻击者很容易构内存攻击导致系统瘫痪，出于安全考虑这里推荐使用io包的LineIterator，并且其在性能上也优于普通流。

lineIterator(final InputStream input, final Charset encoding)
lineIterator(final InputStream input, final String encoding)
lineIterator(final Reader reader)

    public static void main(String[] args) throws Exception {
        try (InputStream in1 = new URL("http://commons.apache.org").openStream()) {
            LineIterator lineIterator = IOUtils.lineIterator(in1, StandardCharsets.UTF_8);
            while (lineIterator.hasNext()) {
                lineIterator.nextLine();
            }
            lineIterator.close();
        }
    }

read、readFully：把输入流的东西读取添加到第二个参数中的字节数组里
readLines：不解释
resourceToByteArray、resourceToString：直接传入一个文件的路径，读取进来
toBufferedInputStream：把普通的inputStream转换成带缓冲区的，返回一个新的InputStream
toByteArray：吧输入流转换到字节数组
toCharArray：
toInputStream：吧字符、字符串等等直接读到流里
toString：强大的方法，可以吧各种输出流读成一个串
write、writeChunked、writeLines：把传入的字节数组，写入到输出流里（可指定编码）

各种常用的常量：

public static final char DIR_SEPARATOR_UNIX = '/';
public static final char DIR_SEPARATOR_WINDOWS = '\\';
/**
    * The system directory separator character.  系统文件夹的分隔符 通用的
    */
   public static final char DIR_SEPARATOR = File.separatorChar;
    /**
    * The Unix line separator string.  换行符
    */
   public static final String LINE_SEPARATOR_UNIX = "\n";
   //winows换行符
   public static final String LINE_SEPARATOR_WINDOWS = "\r\n";
    /**
    * The system line separator string.  通用的换行符
    */
   public static final String LINE_SEPARATOR;

FilenameUtils

FilenameUtils类包含工具方法不需要使用File对象就可以操作文件名。该类致力于屏蔽Unix和Windows之间的不同，避免这些环境之间的转换（例如，从开发到生产）。开发在windows、生产在Linux

一般使用较少，这里不做过多介绍.

FileSystemUtils：2.6版本已经废弃。推荐使用JDK自己的FileStore代替

Java之Apache Commons-IO使用精讲

工具类

IOUtils

猜你喜欢