应优先用 Optional.ofNullable() 处理可能为 null 的值，配合 map/filter/flatMap 链式操作表达业务逻辑，避免 get()；非空场景用 of()；需默认值时选 orElse/orElseGet/orElseThrow。
直接用 optional.ofnullable() 包裹可能为 null 的变量，是 java 8+ 中避免显式 null 检查、提升代码可读性和安全性的常用做法。关键不在于“包裹”本身，而在于后续如何链式使用 optional 的方法来表达业务意图。
何时用 ofNullable() 而非 of()
Optional.of() 要求参数**绝对非 null**，否则抛 NullPointerException；而 ofNullable() 可安全接收 null —— 若传入 null，它返回空的 Optional.empty()，不会崩溃。
- ✅ 正确：数据库查询结果、HTTP 响应体、Map.get() 返回值、用户输入字段等可能为空的场景
- ❌ 错误：已明确初始化的对象、常量、方法契约保证非空的返回值（此时该用
of()或根本无需 Optional）
包裹后别急着 get()，优先用 map/flatMap/filter
调用 .get() 会破坏 Optional 的意义，且仍需处理空值异常。应把逻辑“移进” Optional 链中：
-
map()：对非空值做转换，空值自动跳过。例如：Optional.ofNullable(user).map(User::getProfile).map(Profile::getAvatarUrl)—— 任意一环为null，结果就是Optional.empty() -
filter()：添加条件约束，不满足则变为空。例如：Optional.ofNullable(str).filter(s -> !s.trim().isEmpty()) -
flatMap()：用于返回另一个Optional的操作，避免嵌套Optional<optional>></optional>。例如：Optional.ofNullable(user).flatMap(u -> Optional.ofNullable(u.getAddress()))
提供默认值或兜底行为，用 orElse / orElseGet / orElseThrow
当必须拿到一个实际值时，用这些方法替代 if (opt.isPresent()) 手动判断：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
orElse(T other)：直接传默认值（总是执行构造，适合简单字面量） -
orElseGet(Supplier extends T> supplier)：延迟执行，默认值创建开销大时更优。例如：opt.orElseGet(() -> loadDefaultConfig()) -
orElseThrow()：明确表达“此处不应为空”，抛出有意义的异常。例如：Optional.ofNullable(id).orElseThrow(() -> new IllegalArgumentException("ID 不能为空"))
注意边界：Optional 不是万能解药
Optional 设计初衷是**作为方法返回类型**，表示“计算结果可能不存在”。不建议用于以下场景：
立即学习“Java免费学习笔记（深入）”；
- ❌ 作为实体类字段（序列化、ORM 映射、内存开销等问题）
- ❌ 作为集合元素（
List<optional>></optional>是反模式） - ❌ 替代
if (obj != null)写在方法入口做防御性校验（此时用Objects.requireNonNull()更直接） - ✅ 推荐：服务层方法返回、流式处理中间结果、配置解析等“存在性不确定”的语义场景
