功能特性速查表
核心功能
| 功能 | 说明 | 代码示例 | 详见 |
|---|---|---|---|
| 深层取值 | 路径表达式穿透嵌套 | getStr("a.b.c") | 2.1 |
| 智能构建 | 自动创建中间层 | set("a.b.c", v) | 2.1 |
| 类型转换 | 自动转换 | getInt("age") | 2.1 |
| 负索引 | 倒数访问 | getStr("tags[-1]") | 2.3 |
| 数组追加 | 自动创建并追加 | add("tags", v) | 2.1 |
| 链式操作 | 方法返回 this | new JSONMap().set().add() | 2.1 |
读取方法
getStr(key) // → String 或 null
getStr(key, defaultV) // → String 或 默认值
getInt(key) // → Integer 或 null
getInt(key, defaultV) // → Integer 或 默认值
getLong(key) // → Long 或 null
getDouble(key) // → Double 或 null
getFloat(key) // → Float 或 null
getBigDecimal(key) // → BigDecimal 或 null
getBoolean(key) // → Boolean 或 null
getMap(key) // → JSONMap 或 null
getList(key) // → JSONList 或 null
getList(key, Class) // → List<T> 或 null
getArray(key, Class) // → T[] 或 null
getObj(key, Class) // → T 或 null
getDate(key) // → Date 或 null
as(Class) // → T（整对象转 Bean）
写入方法
put(key, value) // 普通写入，key 不解析
set(key, value) // 深层写入，key 解析为路径
add(key, obj) // 数组追加
removes(key) // 深层删除
clearEmptyProp() // 清除 null 和空字符串
构造方式
new JSONMap() // 空对象
new JSONMap(jsonString) // 从 JSON 字符串
new JSONMap(map) // 从 Map
new JSONMap(user) // 从 Bean
new JSONMap("name", "张三", "age", 25) // 键值对
JSONList
new JSONList() // 空列表
new JSONList("[1,2,3]") // 从 JSON 字符串
new JSONList(collection) // 从集合
new JSONList("1,2,3", Integer.class) // 逗号分隔 + 类型转换
list.getInt(0) // 正向索引
list.getInt(-1) // 负索引
list.getMap(0) // 获取子对象
list.asList(User.class) // 转 Bean 列表
list.adds(obj) // 链式添加
工具类
| 工具类 | 核心方法 | 详见 |
|---|---|---|
| ValUtil | toInt(), toStr(), toList(), toBoolean(), toBigDecimal() | 3.1 |
| JacksonUtil | getJson(), readValue(), at() | 3.2 |
| BeanUtil | copyAsSource(), copyAsTarget() | 3.5 |
| DateUtil | format(), parse(), addDays() | 3.3 |
| StringUtils | isBlank(), split(), join() | 3.4 |
| Cache | get(), put(), remove(), keys() | 3.6 |