SpringBoot中JSON工具类JsonUtils的实践教学

<dependency>
  <groupId>com.gitee.apanlh</groupId>
  <artifactId>apanlh-common</artifactId>
  <version>2.0.6</version>
</dependency>

<dependency>
  <groupId>com.gitee.apanlh</groupId>
  <artifactId>apanlh-common</artifactId>
  <version>3.0.6</version>
</dependency>

import com.gitee.apanlh.util.dataformat.JsonUtils;
import com.gitee.apanlh.util.dataformat.TypeReference;

// JSON 字符串转 Bean
User user = JsonUtils.parseObject("{\"name\":\"Pan\",\"age\":28}", User.class);

// 带泛型的复杂类型，用 TypeReference 避免类型擦除
Map<String, List<Order>> map = JsonUtils.parseObject(json,
    new TypeReference<Map<String, List<Order>>>() {});

// JSON 数组转 List
List<User> users = JsonUtils.parseArray(jsonArray, User.class);

// 对象转 JSON 字符串
String json = JsonUtils.toJson(user);

// 对象转 JSON 字节数组（UTF-8）
byte[] bytes = JsonUtils.toJsonBytes(user);

// 转为标准 HashMap，不是 JSONObject
Map<String, Object> map = JsonUtils.parseToMap(json);

// 保持插入顺序的 LinkedHashMap
Map<String, Object> linked = JsonUtils.parseToLinkedMap(json);

// 按键自然排序的 TreeMap
Map<String, Object> sorted = JsonUtils.parseToSortedMap(json);

// JSON 数组转为 List<Map>
List<Map<String, Object>> listMap = JsonUtils.parseToListMap(json);

// 把 Map、List 或其他对象转为指定类型
Map<String, Object> map = JsonUtils.parseToMap(json);
User user = JsonUtils.to(map, User.class);

// 三种库都能正确解析这些日期字符串
String json = "{\"createTime\":\"2024年1月15日\"}";
User user = JsonUtils.parseObject(json, User.class);
// user.createTime → 2024-01-15T00:00:00

JsonUtils.hasJson("{\"name\":\"test\"}");       // true
JsonUtils.hasJson("not json");                  // false

JsonUtils.hasJsonArray("[1,2,3]");              // true
JsonUtils.hasJsonArray("{\"a\":1}");            // false

JsonUtils.hasJsonObject("{\"a\":1}");           // true
JsonUtils.hasJsonObject("[1,2,3]");             // false

byte[] jsonBytes = ...;
List<User> users = JsonUtils.parseArray(jsonBytes, User.class);

List<User> users = Arrays.asList(new User("A"), new User("B"));

// 每行一个 JSON 对象
String lines = JsonUtils.toJsonLines(users);
// {"name":"A"}
// {"name":"B"}

// 自定义分隔符
String delimited = JsonUtils.toJsonDelimited(users, ";");
// {"name":"A"};
// {"name":"B"}

import com.gitee.apanlh.util.dataformat.JsonUtils;
import com.gitee.apanlh.util.dataformat.FastJson2Provider;

// 应用启动时设置一次，后续所有调用都用这个 Provider
JsonUtils.setProvider(new FastJson2Provider());