Java中文件上传前重命名的最佳实践

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption; // 用于处理文件已存在的情况
import org.springframework.web.multipart.MultipartFile; // 假设使用Spring框架

public class FileRenameAndSave {

    /**
     * 将上传的文件保存到指定路径并重命名
     *
     * @param file          上传的MultipartFile对象
     * @param targetDirectory 目标存储目录的路径
     * @param newFileName   希望赋予文件的新名称（包含扩展名）
     * @return 保存后的文件完整路径
     * @throws IOException 如果文件操作失败
     */
    public Path saveFileWithNewName(MultipartFile file, String targetDirectory, String newFileName) throws IOException {
        // 1. 验证输入参数
        if (file == null || file.isEmpty()) {
            throw new IllegalArgumentException("上传文件不能为空。");
        }
        if (newFileName == null || newFileName.trim().isEmpty()) {
            throw new IllegalArgumentException("新文件名不能为空。");
        }

        // 2. 构建目标目录的Path对象
        Path uploadPath = Paths.get(targetDirectory);

        // 3. 检查并创建父目录（如果不存在）
        if (!Files.exists(uploadPath)) {
            Files.createDirectories(uploadPath); // 创建所有不存在的父目录
        }

        // 4. 构建目标文件的完整Path，包含新文件名
        Path finalTargetPath = uploadPath.resolve(newFileName);

        // 5. 使用 Files.copy() 将文件内容复制到新路径
        // file.getInputStream() 获取MultipartFile的输入流
        // StandardCopyOption.REPLACE_EXISTING 表示如果目标文件已存在则替换
        Files.copy(file.getInputStream(), finalTargetPath, StandardCopyOption.REPLACE_EXISTING);

        return finalTargetPath;
    }

    public static void main(String[] args) {
        // 模拟一个MultipartFile对象（在实际应用中，这会从HTTP请求中获取）
        // 这里只是一个概念性示例，实际的MultipartFile创建会更复杂
        // MockMultipartFile mockFile = new MockMultipartFile("test.txt", "original_content".getBytes());

        // 假设我们有一个名为 'file' 的 MultipartFile 对象
        // String localPath = "c:/Users/foody/Documents/write_file_local/"; // Windows路径示例
        String localPath = "/tmp/uploads/"; // Linux/macOS路径示例
        String customFileName = "my_renamed_document.pdf"; // 假设原文件是PDF，或者我们希望它被视为PDF

        // 假设这里有一个实际的 MultipartFile 对象 'uploadedFile'
        // FileRenameAndSave saver = new FileRenameAndSave();
        // try {
        //     Path savedFilePath = saver.saveFileWithNewName(uploadedFile, localPath, customFileName);
        //     System.out.println("文件已成功保存并重命名为: " + savedFilePath.toString());
        // } catch (IOException e) {
        //     System.err.println("文件保存失败: " + e.getMessage());
        //     e.printStackTrace();
        // } catch (IllegalArgumentException e) {
        //     System.err.println("参数错误: " + e.getMessage());
        // }
    }
}