391. Java 文件操作基础 - 方法链式调用

391. Java 文件操作基础 - 方法链式调用

在 Java 文件 I/O API 中，你会经常看到一种“连珠炮”式的调用写法：

👉 一个方法返回一个对象，立刻调用这个对象的下一个方法，层层递进，这就是方法链（Method Chaining）。

---

1️⃣ 基本概念

传统写法（逐个赋值）：

Charset charset = Charset.defaultCharset();
CharsetDecoder decoder = charset.newDecoder();
CharBuffer result = decoder.decode(buf);
String value = result.toString();

1. 将字符串"Hello 世界"按照UTF-8编码转换为字节数组。这里包含了英文和中文字符。
2. 使用ByteBuffer包装字节数组，创建一个缓冲区对象用于后续处理。
3. 获取系统的默认字符集（通常是GBK或UTF-8，取决于运行环境）。
4. 基于默认字符集创建解码器，用于将字节数据转换为字符。
5. 使用解码器将ByteBuffer中的字节数据解码为字符缓冲区。
6. 将字符缓冲区转换为字符串。

链式调用写法：

String value = Charset.defaultCharset().decode(buf).toString();

🔎 对比：

• 前者需要声明一堆临时变量。
• 后者一行搞定，简洁明了。

---

2️⃣ 文件 I/O 示例

看一个文件系统相关的例子：

Path file = Paths.get(".");
UserPrincipal group = file.getFileSystem().getUserPrincipalLookupService().lookupPrincipalByName("Administrator");
System.out.println(group);

解读：

1. file.getFileSystem() → 获取文件系统
2. .getUserPrincipalLookupService() → 获取用户查找服务
3. .lookupPrincipalByName("me") → 查找名为 "me" 的用户

✅ 三步连在一起，不需要写中间变量。

---

3️⃣ 方法链的优点

• 代码简洁：减少样板代码和临时变量
• 可读性高：调用顺序自然符合逻辑（从大到小、从外到内）
• 常见于 Fluent API（比如 Java Streams、Builder 模式、文件 I/O）

例如：

Files.lines(Paths.get("names.txt"))
    .map(String::toUpperCase)
    .filter(line -> line.startsWith("白"))
    .forEach(System.out::println);

👉 一气呵成，就像“流水线”一样处理数据。

---

4️⃣ 方法链的局限

不过，方法链也不是万能的：

• 太长时可读性差：一行写十几个方法，调试和阅读都会痛苦。
• 调试不便：无法轻易在中间插入断点查看结果。
• 推荐做法：如果链条超过 3–4 步，考虑适当拆开，用临时变量增强可读性。

---

5️⃣ 小练习 🎯

请问下面的代码，执行顺序是什么？

String result = Paths.get("file.txt")
                     .toAbsolutePath()
                     .normalize()
                     .toString();

答：

1. Paths.get("file.txt") → 得到一个相对路径
2. .toAbsolutePath() → 转换为绝对路径
3. .normalize() → 规范化路径（比如去掉 ./、../）
4. .toString() → 转换为字符串

👉 链式调用让路径转换逻辑非常直观。

---

✅ 总结一句： **方法链（Method Chaining）就像把多个操作串在一条链子上，适合用在“逐步加工”的场景。**在文件 I/O 和 Streams 中，你会经常遇到。