海量编程文章、技术教程与实战案例

网站首页 > 技术文章 正文

全面解读FileUtil与IoUtil工具类的高级功能及应用场景

yimeika 2025-07-25 02:31:57 技术文章 7 ℃

IO工具类如FileUtil或FileUtils主要用于简化和封装Java中的文件和流操作,使其更加便捷、高效且易于使用。这类工具类提供了广泛的功能,包括但不限于以下几个核心部分:

IO工具类的概述

IO工具类主要针对InputStreamOutputStreamReaderWriter等进行封装简化,同时也对NIO相关操作进行了封装,以便在便捷性、性能和灵活性之间找到最佳平衡点。

文件操作的复杂性

文件操作是IO操作中最复杂且使用频率最高的部分。几乎所有项目中都包含一个名为FileUtilFileUtils的工具类。

拷贝操作

拷贝是流读写的基本过程,涉及从输入流读取数据和向输出流写入数据。文档提供了一个文件流拷贝的示例代码,展示了如何使用IoUtil.copy方法进行操作,并提到了针对不同对象(如ReaderWriterChannel等)的重载方法。

流与字符流的转换

IoUtil提供了将InputStream转换为BufferedReader和将OutputStream转换为OutputStreamWriter的方法,以便于字符流的读取和写入。

/**
 * IO 操作
 *
 * <p>一:拷贝
 *
 * <p>copy方法同样针对Reader、Writer、Channel等对象有一些重载方法,并提供可选的缓存大小。
 * 默认的,缓存大小为1024个字节,如果拷贝大文件或流数据较大,可以适当调整这个参数。
 *
 * <p>IoUtil.getReader:将InputStream转为BufferedReader用于读取字符流,它是部分readXXX方法的基础。
 *
 * <p>IoUtil.getWriter:将OutputStream转为OutputStreamWriter用于写入字符流,它是部分writeXXX的基础。
 *
 * <p>二:读取
 *
 * <p>1、读取流中的内容总结下来,可以分为read方法和readXXX方法。
 *
 * <p>2、read方法有诸多的重载方法,根据参数不同,可以读取不同对象中的内容,这包括: InputStream Reader FileChannel
 * 这三个重载大部分返回String字符串,为字符流读取提供极大便利。
 *
 * <p>3、readXXX方法主要针对返回值做一些处理,例如: readBytes 返回byte数组(读取图片等) readHex 读取16进制字符串 readObj
 * 读取序列化对象(反序列化) readLines 按行读取 toStream方法则是将某些对象转换为流对象,便于在某些情况下操作: String
 * 转换为ByteArrayInputStream File 转换为FileInputStream
 *
 * <p>三:写入
 *
 * <p>IoUtil.write方法有两个重载方法,一个直接调用OutputStream.write方法, 另一个用于将对象转换为字符串(调用toString方法),然后写入到流中。
 *
 * <p>IoUtil.writeObjects 用于将可序列化对象序列化后写入到流中。 write方法并没有提供writeXXX,需要自己转换为String或byte[]。
 *
 * <p>四:关闭
 *
 * <p>对于IO操作来说,使用频率最高(也是最容易被遗忘)的就是close操作,好在Java规范使用了优雅的Closeable接口,这样我们只需简单封装调用此接口的方法即可。
 */
// 以文件流拷贝为例
BufferedInputStream in =
    FileUtil.getInputStream("/Users/mac/logs/cgnCloudLogs/collection/debug-2024-04-01.0.log");
BufferedOutputStream out = FileUtil.getOutputStream("/Users/mac/logs/debug-2024-04-01.0.log");

long copySize = IoUtil.copy(in, out, IoUtil.DEFAULT_BUFFER_SIZE);
// 打印复制大小 10530881
Console.log("copySize:" + copySize);

读取流中内容的方法

read方法和readXXX系列方法,这些方法根据不同的参数可以读取不同对象中的内容,并提供了多种读取方式,如按行读取、读取为字节数组、16进制字符串、序列化对象等。

写入流的方法

IoUtil提供了write方法和writeObjects方法,用于将数据写入流中。write方法可以处理直接写入字节或将对象转换为字符串后写入。

关闭操作

强调了关闭IO操作的重要性,并介绍了IoUtil.close方法,该方法能够优雅地处理关闭操作,包括处理被关闭对象为空或关闭失败的情况。

FileUtil工具类的功能

FileUtil类提供了一系列的文件操作方法,包括文件目录的新建、删除、复制、移动、改名等,以及文件判断、绝对路径转换、文件名获取等。此外,还包括了读取和写入操作的方法。

/**
 * 场景:
 *
 * <p>1、文件操作:包括文件目录的新建、删除、复制、移动、改名等
 *
 * <p>2、文件判断:判断文件或目录是否非空,是否为目录,是否为文件等等
 *
 * <p>3、绝对路径:针对ClassPath中的文件转换为绝对路径文件
 *
 * <p>4、文件名:主文件名,扩展名的获取
 *
 * <p>5、读操作:包括类似IoUtil中的getReader、readXXX操作
 *
 * <p>6、写操作:包括getWriter和writeXXX操作
 */
// 创建
File file = FileUtil.touch("/Users/mac/logs/test.txt");

// 判断是否为文件,如果file为null,则返回false
boolean b = FileUtil.isFile(file);
Console.log("b:" + b);

// 创建文件夹
File mkdir = FileUtil.mkdir("/Users/mac/logs/test/tt");
Console.log("mkdir:" + mkdir);
boolean directory = FileUtil.isDirectory(mkdir);
Console.log("directory:" + directory);

// 删除文件夹
boolean del = FileUtil.del(mkdir);
Console.log("del:" + del);
最近发表
标签列表