DLZ-Kit 文档导航
JSONMap — 继承 HashMap，为 JSON 嵌套数据提供路径取值、自动类型转换、链式构建能力。
快速导航
我是 AI 助手，想快速了解 JSONMap
- AI 速读指南 — 30 秒掌握核心 API
我是新手，想快速上手
我想了解核心功能
我想查找某个工具类
我想看实际应用案例
我遇到了问题
完整目录
根目录文档
- AI 速读指南 — 给 AI 的核心概念和 API
第01章 快速入门
从零开始，5 分钟掌握 JSONMap 基本用法
- 1.1 安装配置 — Maven/Gradle 依赖、版本选择
- 1.2 五分钟上手 — 第一个示例，核心操作体验
- 1.3 核心概念 — JSONMap 定位、设计理念
- 1.4 与其他库的对比 — vs Jackson/FastJSON/Hutool
第02章 核心功能
三大核心能力：深层路径访问、智能构建、类型转换
- 2.1 JSONMap 完整指南 — 构造、取值、写入、API 参考
- 2.2 JSONList 完整指南 — 负索引、类型安全访问
- 2.3 深层路径详解 — 路径语法规则、数组访问、混合路径
- 2.4 功能特性速查表 — 所有功能快速查找
第03章 工具类库
开箱即用的工具类
- 3.1 ValUtil - 类型转换 — 万能类型转换、空值安全
- 3.2 JacksonUtil - JSON处理 — JSON 序列化/反序列化、路径取值
- 3.3 DateUtil - 日期处理 — 日期格式化、解析、计算
- 3.4 StringUtils - 字符串处理 — 判空、分割、连接
- 3.5 BeanUtil - Bean工具 — 属性复制、Bean↔Map
- 3.6 Cache - 缓存工具 — 内存缓存、过期管理
- 3.7 工具类速查表 — 所有工具类快速查找
第04章 高级特性
@SetValue 注解、有界宽容原则
- 4.1 @SetValue 注解映射 — 扁平 Bean ↔ 嵌套 JSON 双向映射
- 4.2 多维数组支持 — 多维数组操作、自动补齐
- 4.3 自动类型纠正 — 前端类型混乱处理、容错机制
- 4.4 有界宽容原则 — 设计理念：缺失容忍、类型容忍、内容不容忍
- 4.5 性能优化技巧 — 优化建议、常见误区
第05章 实战场景
真实项目中的应用案例
- 5.1 场景概览 — 核心场景与适用项目
- 5.2 API 响应处理 — 解析第三方 API、嵌套响应
- 5.3 表单数据处理 — 表单验证、类型转换、数据清洗
- 5.4 配置文件管理 — 配置读取、合并、动态配置
- 5.5 数据库 JSON 字段 — MySQL/PG JSON 字段处理
- 5.6 Excel 导入导出 — 配合 EasyExcel、复杂表头
- 5.7 实际案例集 — 电商订单、微信回调等完整案例
第06章 框架集成
与主流框架的集成指南
- 6.1 Spring Boot 集成 — 依赖配置、Controller 使用
- 6.2 Spring MVC 集成 — 传统 Spring 项目集成
- 6.3 MyBatis 集成 — 结果映射、JSON 字段处理
- 6.4 AI 辅助开发 — Cursor/Copilot 配置、Prompt 模板
- 6.5 最佳实践 — 使用建议、常见错误
第07章 附录
参考资料和补充信息
- 7.1 性能测试报告 — 性能测试数据
- 7.2 常见问题 FAQ — 安装/使用/性能问题
- 7.3 版本更新日志 — 版本历史、升级指南
- 7.4 贡献指南 — 如何贡献代码、提交 PR
- 7.5 API 索引 — JSONMap/JSONList/工具类 API 列表
- 7.6 术语表 — 专业术语解释
学习路径推荐
快速上手（30 分钟）
系统学习（2 小时）
- 第01章 快速入门 — 全部
- 第02章 核心功能 — 全部
- 第03章 工具类库 — 浏览速查表
- 第05章 实战场景 — 选择相关场景
高级进阶（4 小时）
- 完成系统学习内容
- 第04章 高级特性 — 全部
- 第06章 框架集成 — 全部
快速查找
按功能
- 深层取值 → 2.3 深层路径详解
- 类型转换 → 3.1 ValUtil
- Bean 映射 → 4.1 @SetValue 注解
- API 解析 → 5.2 API 响应处理
按问题
- 如何安装？ → 1.1 安装配置
- 如何上手？ → 1.2 五分钟上手
- 遇到问题？ → 7.2 常见问题 FAQ
- 查找 API？ → 7.5 API 索引
获取帮助
- GitHub Issues: 提交问题
- 常见问题: 7.2 FAQ
- 邮件联系: 59461202@qq.com