356. Java IO API -路径转换

356. Java IO API -路径转换

在 Java 中，Path 提供了多种转换方法，帮助我们以不同形式表示路径。下面介绍三种常见的转换方式：

---

🌐 1. toUri() — 转为可在浏览器中打开的 URI 格式

如果你希望将路径转换为标准 URI（例如 file:///home/logfile），可以使用 toUri() 方法。

示例：

Path p1 = Paths.get("/home/logfile");
System.out.println(p1.toUri());

输出结果：

file:///home/logfile

🎯 用途场景：

• 上传下载文件时生成下载链接
• 向浏览器、远程服务传递路径标识

---

📍 2. toAbsolutePath() — 转为绝对路径（不需要文件存在）

该方法会将相对路径补全为绝对路径，通常是在当前工作目录前加上前缀。

示例代码：

public class FileTest {
    public static void main(String[] args) {
        if (args.length < 1) {
            System.out.println("Usage: FileTest <filename>");
            System.exit(-1);
        }

        Path inputPath = Paths.get(args[0]);
        Path fullPath = inputPath.toAbsolutePath();

        System.out.println("Input Path: " + inputPath);
        System.out.println("Absolute Path: " + fullPath);
        System.out.println("Root: " + fullPath.getRoot());
        System.out.println("Parent: " + fullPath.getParent());
    }
}

假设输入参数为 foo，输出可能为：

Input Path: foo
Absolute Path: /home/user/project/foo
Root: /
Parent: /home/user/project

✅ 优点：

• 不依赖文件是否真实存在
• 能让后续调用 getRoot() / getParent() 等方法有意义

---

🔍 3. toRealPath() — 获取文件系统中真实路径（需要文件存在）

这个方法执行以下操作：

操作内容	说明
解析符号链接	如果传入参数为 true，且文件系统支持符号链接，则会解析它们
转为绝对路径	自动补齐相对路径前缀
语法标准化	自动删除 .、.. 等冗余路径元素
文件验证	如果路径无效或文件不存在，将抛出异常

示例代码：

try {
    Path realPath = path.toRealPath(); // path 必须存在！
    System.out.println("Real path: " + realPath);
} catch (NoSuchFileException e) {
    System.err.format("%s: no such file or directory%n", path);
    // 文件不存在的处理逻辑
} catch (IOException e) {
    System.err.println("Other IO error: " + e);
    // 其他 I/O 错误
}

🚨 注意事项：

• 如果路径不存在，会抛出 NoSuchFileException
• 如果你想要处理真实的物理位置（尤其是有符号链接时），推荐使用此方法

---

🆚 三者对比总结表：

方法	功能	是否检查文件存在	是否解析符号链接	是否清理路径
toUri()	转换为 URI	❌	❌	❌
toAbsolutePath()	转换为绝对路径	❌	❌	❌
toRealPath()	返回真实路径	✅	✅（默认）	✅

---

📌 小提示：

如果你在处理用户输入、命令行参数或构建跨平台工具时，这些方法尤其重要：

• toAbsolutePath() 是你与用户输入打交道的好帮手
• toRealPath() 用于确保路径真实有效且精确