用Optional实现JSON深层字段安全提取的核心是显式表达每层可能为空的语义，通过Optional.ofNullable与flatMap链式访问避免空指针和嵌套if；不解析JSON本身，需先用JSONObject或Jackson完成初步解析；推荐从JSONObject入手，封装safeGet工具方法支持点号路径与类型校验，并结合orElse/orElseGet提供默认值及filter/map做清洗。
用 Optional 实现 JSON 深层字段的安全提取，核心是把“每层可能为空”的语义显式表达出来，避免 if-else 嵌套和空指针异常。它不直接解析 JSON，而是配合 JSONObject 或 Jackson 等解析器，在对象已构建后做链式安全访问。
先将 JSON 转为 Java 对象（或保留 JSONObject）
Optional 本身不解析 JSON 字符串，需先借助库完成初步解析：
- 用 org.json.JSONObject：保留原始结构，适合动态字段场景
- 用 Jackson（ObjectMapper）：反序列化为强类型 POJO，配合 Lombok 可大幅简化 getter
- 推荐初阶实践从 JSONObject 入手，便于理解空值传播逻辑
用 Optional.ofNullable 封装每一层非空判断
对每个可能为 null 的中间对象（如 profile、address、city），都用 Optional.ofNullable 包裹，再通过 flatMap 向下传递：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
-
不要用 map：比如
optUser.map(u → u.getProfile())返回的是Optional<Optional<Profile>>，造成嵌套 -
必须用 flatMap：传入一个返回
Optional<T>的函数，自动展平一层 - 典型链路：
Optional.ofNullable(user).flatMap(u → Optional.ofNullable(u.getProfile())).flatMap(p → Optional.ofNullable(p.getAddress())).map(a → a.getCity())
封装通用 safeGet 工具方法提升复用性
手动写一长串 flatMap 易错且重复。可抽象出静态工具方法，统一处理 JSONObject 中任意深度的 key：
- 定义枚举 JsonValueType 明确期望类型（STRING、INT、JSONOBJECT 等）
- 方法签名如：
safeGet(JSONObject obj, String path, JsonValueType type)，其中 path 支持点号分隔（"saleInfo.listPrice.amount"） - 内部按层级 split(".")，逐层调用
opt.getJSONObject(key)并用 Optional.ofNullable 包裹，任一环节为 null 即终止并返回 null - 这样业务代码就简化为：
String city = JsonUtils.safeGet(jsonObj, "user.profile.address.city", STRING);
结合 orElse / orElseGet 提供默认值与兜底逻辑
提取结果常需 fallback，Optional 天然支持：
-
.orElse("Unknown")：适用于简单默认值，无计算开销 -
.orElseGet(() → computeDefaultCity())：延迟执行，适合耗时或依赖上下文的默认值生成 - 还可接
.filter(Objects::nonNull).map(String::trim)做二次校验与清洗
