Optional用于显式表达值可能不存在的语义，应仅作返回类型，避免用作参数或字段；善用orElseGet、flatMap和Stream结合实现安全、函数式的空值处理。
Java中用Optional不是为了“包装null”，而是为了**显式表达“值可能存在也可能不存在”这一语义**，从而让空值处理更安全、更可读、更函数式。关键不在于套一层Optional，而在于用对它的方法链。
别用Optional做参数或字段
Optional设计初衷是作为返回值类型，不是用来存状态的。把它当方法参数、类字段或集合元素，反而增加复杂度和装箱开销。
- ❌ 错误示范：
public void process(Optional<string> name) { ... }</string> - ✅ 正确做法：参数保持原始类型，内部用
Objects.requireNonNull或直接判空；返回值才用Optional表明“可能无结果” - ❌ 字段写成
private Optional<user> user;</user>—— 这等于把null换成Optional.empty()，没解决根本问题，还多一次对象创建
用orElse、orElseGet、orElseThrow选对默认行为
三者区别直接影响性能和逻辑健壮性：
-
orElse(T other)：不管Optional是否有值，都会执行other的计算（比如new一个对象、查一次数据库） -
orElseGet(Supplier extends T> supplier)：只在为空时才调用supplier，适合开销大的默认值构造 -
orElseThrow()或带Supplier的重载：明确表达“这里必须有值，否则抛异常”，比if+throw更简洁
例如：config.getPort().orElseGet(() -> findFreePort()) 比 orElse(findFreePort()) 更合理。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
链式调用替代嵌套if，但别滥用map/flatMap
Optional的核心优势在于组合操作：
-
user.flatMap(u -> u.getAddress().flatMap(a -> a.getCity()))可安全穿透多层可能为null的引用 - 但注意：
map适用于转换非Optional结果，flatMap用于返回另一个Optional的操作——混用会导致编译错误或意外空值 - 避免过度嵌套：如果连续3次flatMap，说明领域模型可能需要重构（比如Address本就该是User的必有属性）
与Stream结合处理集合中的“可能空”元素
Optional常和Stream配合过滤掉空值：
list.stream().map(this::findUserById).filter(Optional::isPresent).map(Optional::get).collect(toList())- 更优雅写法：
list.stream().map(this::findUserById).flatMap(Optional::stream).collect(toList())——Optional.stream()会把empty转为空流，present转为单元素流，天然去null
基本上就这些。Optional不是银弹，它不能消灭null，但能帮你把“是否为空”的判断从隐式变成显式，从散落在各处的if变成连贯的声明式表达。用得自然，代码就清爽；硬套，反而更绕。
