Skip to content

📁 文件操作工具(FileHelper)

📖 功能介绍

TIP

FileHelper 是一个强大的文件操作工具类,提供了文件路径处理、文件读写、目录操作等常用功能,简化文件操作,提高开发效率。

🛠️ 核心功能

1. 路径处理

方法说明返回值
normalize(String filepath)规范化路径,合并分隔符String
getFullPath(String filename)获取文件完整路径String
getUrl(String path)获取文件URLURL

2. 文件操作

方法说明返回值
getMimeType(File file)获取文件MIME类型String
exists(String filePath)判断文件是否存在boolean
createNewFile(String filePathName)创建新文件boolean

3. 文件写入

方法说明参数
writeToFile(String, byte[])写入字节数组路径, 数据
writeToFile(String, String)写入字符串路径, 内容
writeToFile(String, String, String)指定编码写入路径, 内容, 编码

💡 使用示例

1. 路径处理

java
// 路径规范化
String path = FileHelper.normalize("c:\\temp//file\\\\test.txt");
// 结果: "c:/temp/file/test.txt"

// 获取完整路径
String fullPath = FileHelper.getFullPath("/data/files/test.txt");
// 结果: 包含系统路径的完整文件路径

// 获取文件URL
URL fileUrl = FileHelper.getUrl("classpath:config/app.properties");

2. 文件操作

java
// 获取MIME类型
File file = new File("document.pdf");
String mimeType = FileHelper.getMimeType(file);
// 结果: "application/pdf"

// 检查文件是否存在
boolean exists = FileHelper.exists("/path/to/file.txt");

// 创建新文件
boolean created = FileHelper.createNewFile("/path/to/new/file.txt");

3. 文件写入

java
// 写入字符串内容
String content = "Hello, WuEasy!";
FileHelper.writeToFile("/path/to/file.txt", content);

// 指定编码写入
FileHelper.writeToFile("/path/to/file.txt", content, "UTF-8");

// 写入字节数组
byte[] data = content.getBytes();
FileHelper.writeToFile("/path/to/file.txt", data);

4. 目录操作

java
// 创建目录
boolean created = FileHelper.createDirectory("/path/to/new/directory");

// 创建文件及其目录
String filePath = "/path/to/new/directory/file.txt";
if (!FileHelper.exists(filePath)) {
    FileHelper.createNewFile(filePath);
}

⚠️ 注意事项

  1. 路径处理

    • 注意跨平台路径分隔符
    • 使用规范化路径避免问题
    • 处理相对路径和绝对路径
  2. 文件操作

    • 注意文件权限问题
    • 处理文件不存在的情况
    • 正确关闭文件资源
  3. 编码处理

    • 指定正确的字符编码
    • 处理特殊字符
    • 注意跨平台编码问题
  4. 安全考虑

    • 验证文件路径合法性
    • 防止目录遍历攻击
    • 控制文件操作权限