Optional 的核心是语义化表达“值可能存在或不存在”，应仅用于可能为空的返回值，配合 map/flatMap/orElse 等链式方法主动处理空值，避免 get()、isPresent()+get() 及滥用为字段或参数。
用 Optional 包装可能为空的对象，核心不是“套一层 Optional 就安全了”，而是**用它的语义表达“值可能存在，也可能不存在”**，并配合链式方法主动处理两种情况，从而从设计上规避空指针。
只对明确可能为 null 的返回值使用 Optional
Optional 是为“计算结果可能没有”的场景设计的（比如查找、解析、转换），不是用来包装任意字段或参数的。别把成员变量、方法参数、集合元素强行塞进 Optional——这反而增加理解成本和调用负担。
✅ 推荐：作为方法返回类型
public Optional<User> findUserById(Long id) {
return users.stream()
.filter(u -> u.getId().equals(id))
.findFirst(); // Stream.findFirst() 返回 Optional
}
❌ 避免：
立即学习“Java免费学习笔记（深入）”；
// 不要这样定义字段或参数
private Optional<String> name; // 没必要，String 本身就能为 null
public void process(Optional<Order> order) { ... } // 调用方还得 .get() 或 isPresent()，更啰嗦
用 map/flatMap 替代手动判空 + 取值
这是最体现“优雅”的地方：把嵌套取值逻辑变成声明式链式调用，天然跳过 null 路径。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
map：用于对非空值做转换（如取属性、转类型），若原 Optional 为空，则整个链短路返回空 Optional -
flatMap：当转换后结果本身也是 Optional（比如另一个可能为空的方法调用），用它避免 Optional>
例子：获取用户收货地址的邮编
// 传统写法（易漏判空）
String zip = null;
if (user != null && user.getAddress() != null && user.getAddress().getZipCode() != null) {
zip = user.getAddress().getZipCode();
}
// Optional 链式写法（清晰、安全、不可绕过）
String zip = userOpt
.map(User::getAddress)
.map(Address::getZipCode)
.orElse("UNKNOWN");
用 orElse / orElseGet / orElseThrow 明确缺失时的行为
拿到 Optional 后，不要调用 get() —— 它在空时仍抛 NPE，完全违背 Optional 初衷。
-
orElse(T other)：提供默认值（适合轻量对象，如字符串、数字） -
orElseGet(Supplier extends T> supplier)：延迟执行，默认值创建开销大时用（比如 new 对象、查数据库） -
orElseThrow(() -> new XxxException())：明确表示“此处必须有值，否则算异常”
例子：
Optional<Config> config = loadConfig();
Config safeConfig = config.orElseGet(() -> Config.defaultConfig()); // 懒加载默认配置
Optional<Payment> payment = findPayment(orderId);
Payment confirmed = payment.orElseThrow(() ->
new BusinessException("支付记录不存在，订单号：" + orderId));
慎用 isPresent() + get() 组合
这种写法退化成“换种方式写 if (x != null)”，失去了 Optional 的函数式优势，还容易因忘记判空而误调 get()。
❌ 不推荐：
if (optional.isPresent()) {
doSomething(optional.get()); // 万一 later 修改代码删了 if？危险！
}
✅ 更好替代：
- 用
ifPresent(Consumer<t>)</t>执行副作用（如日志、发消息） - 用
map/filter/flatMap做转换和过滤 - 用
orElse*提供兜底
userOpt.ifPresent(user -> log.info("Processing user: {}", user.getName()));
String emailDomain = userOpt
.map(User::getEmail)
.filter(Objects::nonNull)
.map(e -> e.substring(e.indexOf('@') + 1))
.orElse("unknown-domain");
