no message
This commit is contained in:
@@ -0,0 +1,341 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JacksonJsonApi.java
|
||||
* LastUpdate 2025-09-09 09:31:31
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.json;
|
||||
|
||||
import com.fasterxml.jackson.core.JsonGenerator;
|
||||
import com.fasterxml.jackson.core.JsonProcessingException;
|
||||
import com.fasterxml.jackson.databind.JsonNode;
|
||||
import com.fasterxml.jackson.databind.ObjectMapper;
|
||||
import com.fasterxml.jackson.databind.ObjectReader;
|
||||
import com.fasterxml.jackson.databind.node.ObjectNode;
|
||||
import java.io.IOException;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* 基于Jackson的JSON处理实现类,提供JSON字符串解析、格式化、合并、节点操作等功能。
|
||||
*/
|
||||
public class JacksonJsonApi implements JsonApi {
|
||||
|
||||
private final ObjectMapper objectMapper;
|
||||
|
||||
/**
|
||||
* 使用默认的ObjectMapper构造实例
|
||||
*/
|
||||
public JacksonJsonApi() {
|
||||
this.objectMapper = new ObjectMapper();
|
||||
}
|
||||
|
||||
/**
|
||||
* 使用指定的ObjectMapper构造实例
|
||||
*
|
||||
* @param objectMapper 自定义的ObjectMapper实例
|
||||
*/
|
||||
public JacksonJsonApi(ObjectMapper objectMapper) {
|
||||
this.objectMapper = objectMapper.copy();
|
||||
}
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定类型的对象
|
||||
*
|
||||
* @param json 待解析的JSON字符串
|
||||
* @param clazz 目标对象类型
|
||||
* @param <T> 泛型参数,表示目标对象类型
|
||||
* @return 解析后的对象
|
||||
* @throws JsonException 当解析失败时抛出异常
|
||||
*/
|
||||
@Override
|
||||
public <T> T parse(String json, Class<T> clazz) {
|
||||
try {
|
||||
return objectMapper.readValue(json, clazz);
|
||||
} catch (IOException e) {
|
||||
throw new JsonException("Failed to parse JSON string", e);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为复杂泛型结构的对象(如List、Map等)
|
||||
*
|
||||
* @param json JSON字符串
|
||||
* @param type 泛型类型引用
|
||||
* @param <T> 泛型参数,表示目标对象类型
|
||||
* @return 解析后的对象
|
||||
* @throws JsonException 当解析失败时抛出异常
|
||||
*/
|
||||
@Override
|
||||
public <T> T parse(String json, JsonTypeReference<T> type) {
|
||||
try {
|
||||
ObjectReader reader = objectMapper.readerFor(
|
||||
objectMapper.constructType(type.getType())
|
||||
);
|
||||
return reader.readValue(json);
|
||||
} catch (IOException e) {
|
||||
throw new JsonException("Failed to parse JSON string", e);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 将对象格式化为JSON字符串
|
||||
*
|
||||
* @param object 待格式化的对象
|
||||
* @return 格式化后的JSON字符串
|
||||
* @throws JsonException 当格式化失败时抛出异常
|
||||
*/
|
||||
@Override
|
||||
public String format(Object object) {
|
||||
try {
|
||||
return objectMapper.writeValueAsString(object);
|
||||
} catch (JsonProcessingException e) {
|
||||
throw new JsonException(
|
||||
"Failed to format object to JSON string",
|
||||
e
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
@Override
|
||||
public String formatUnicode(Object object) {
|
||||
try {
|
||||
return objectMapper
|
||||
.writer()
|
||||
.with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
|
||||
.writeValueAsString(object);
|
||||
} catch (JsonProcessingException e) {
|
||||
throw new JsonException(e);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 将对象格式化为美化(带缩进)的JSON字符串
|
||||
*
|
||||
* @param object 待格式化的对象
|
||||
* @return 美化后的JSON字符串
|
||||
* @throws JsonException 当格式化失败时抛出异常
|
||||
*/
|
||||
@Override
|
||||
public String formatPretty(Object object) {
|
||||
try {
|
||||
return objectMapper
|
||||
.writerWithDefaultPrettyPrinter()
|
||||
.writeValueAsString(object);
|
||||
} catch (JsonProcessingException e) {
|
||||
throw new JsonException(
|
||||
"Failed to format object to pretty JSON string",
|
||||
e
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
@Override
|
||||
public String formatPrettyUnicode(Object object) {
|
||||
try {
|
||||
return objectMapper
|
||||
.writerWithDefaultPrettyPrinter()
|
||||
.with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
|
||||
.writeValueAsString(object);
|
||||
} catch (JsonProcessingException e) {
|
||||
throw new JsonException(
|
||||
"Failed to format object to pretty JSON string",
|
||||
e
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定元素类型的List
|
||||
*
|
||||
* @param json JSON字符串
|
||||
* @param elementType List中元素的类型
|
||||
* @param <T> 泛型参数,表示List中元素的类型
|
||||
* @return 解析后的List对象
|
||||
*/
|
||||
@Override
|
||||
public <T> List<T> parseList(String json, Class<T> elementType) {
|
||||
return parse(json, JsonTypeUtils.listType(elementType));
|
||||
}
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定键值类型的Map
|
||||
*
|
||||
* @param json JSON字符串
|
||||
* @param keyType Map中键的类型
|
||||
* @param valueType Map中值的类型
|
||||
* @param <K> 泛型参数,表示Map中键的类型
|
||||
* @param <V> 泛型参数,表示Map中值的类型
|
||||
* @return 解析后的Map对象
|
||||
*/
|
||||
@Override
|
||||
public <K, V> Map<K, V> parseMap(
|
||||
String json,
|
||||
Class<K> keyType,
|
||||
Class<V> valueType
|
||||
) {
|
||||
return parse(json, JsonTypeUtils.MapType(keyType, valueType));
|
||||
}
|
||||
|
||||
/**
|
||||
* 判断给定字符串是否是有效的JSON格式
|
||||
*
|
||||
* @param json 待验证的字符串
|
||||
* @return 如果是有效JSON返回true,否则返回false
|
||||
*/
|
||||
@Override
|
||||
public boolean isValidJson(String json) {
|
||||
try {
|
||||
objectMapper.readTree(json);
|
||||
return true;
|
||||
} catch (Exception e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 合并多个JSON字符串为一个JSON对象
|
||||
*
|
||||
* @param jsons 多个JSON字符串
|
||||
* @return 合并后的JSON字符串
|
||||
* @throws JsonException 当合并失败时抛出异常
|
||||
*/
|
||||
@Override
|
||||
public String merge(String... jsons) {
|
||||
ObjectNode result = objectMapper.createObjectNode();
|
||||
for (String json : jsons) {
|
||||
try {
|
||||
JsonNode node = objectMapper.readTree(json);
|
||||
if (node.isObject()) {
|
||||
result.setAll((ObjectNode) node);
|
||||
}
|
||||
} catch (IOException e) {
|
||||
// 忽略无效的JSON字符串
|
||||
}
|
||||
}
|
||||
try {
|
||||
return objectMapper.writeValueAsString(result);
|
||||
} catch (JsonProcessingException e) {
|
||||
throw new JsonException("Failed to merge JSON strings", e);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取JSON字符串中指定路径的节点值
|
||||
*
|
||||
* @param json JSON字符串
|
||||
* @param path 节点路径,使用"."分隔
|
||||
* @return 节点值的文本表示,如果路径不存在则返回null
|
||||
* @throws JsonException 当获取节点值失败时抛出异常
|
||||
*/
|
||||
@Override
|
||||
public String getNodeValue(String json, String path) {
|
||||
try {
|
||||
JsonNode node = objectMapper.readTree(json);
|
||||
String[] paths = path.split("\\.");
|
||||
for (String p : paths) {
|
||||
node = node.get(p);
|
||||
if (node == null) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
return node.asText();
|
||||
} catch (IOException e) {
|
||||
throw new JsonException("Failed to get node value", e);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 更新JSON字符串中指定路径的节点值
|
||||
*
|
||||
* @param json JSON字符串
|
||||
* @param path 节点路径,使用"."分隔
|
||||
* @param newValue 新的节点值
|
||||
* @return 更新后的JSON字符串
|
||||
* @throws JsonException 当更新节点值失败时抛出异常
|
||||
*/
|
||||
@Override
|
||||
public String updateNodeValue(String json, String path, Object newValue) {
|
||||
try {
|
||||
JsonNode node = objectMapper.readTree(json);
|
||||
if (node instanceof ObjectNode) {
|
||||
ObjectNode objectNode = (ObjectNode) node;
|
||||
String[] paths = path.split("\\.");
|
||||
JsonNode current = objectNode;
|
||||
|
||||
// 导航到目标节点的父节点
|
||||
for (int i = 0; i < paths.length - 1; i++) {
|
||||
current = current.get(paths[i]);
|
||||
if (current == null || !(current instanceof ObjectNode)) {
|
||||
return json; // 路径不存在或无效
|
||||
}
|
||||
}
|
||||
|
||||
// 更新值
|
||||
if (current instanceof ObjectNode) {
|
||||
ObjectNode parent = (ObjectNode) current;
|
||||
if (newValue == null) {
|
||||
parent.remove(paths[paths.length - 1]);
|
||||
} else {
|
||||
parent.set(
|
||||
paths[paths.length - 1],
|
||||
objectMapper.valueToTree(newValue)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
return objectMapper.writeValueAsString(objectNode);
|
||||
}
|
||||
return json;
|
||||
} catch (IOException e) {
|
||||
throw new JsonException("Failed to update node value", e);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 在不同对象类型之间进行转换
|
||||
*
|
||||
* @param source 源对象
|
||||
* @param destinationClass 目标对象类型
|
||||
* @param <T> 源对象类型
|
||||
* @param <D> 目标对象类型
|
||||
* @return 转换后的对象
|
||||
*/
|
||||
@Override
|
||||
public <T, D> D convert(T source, Class<D> destinationClass) {
|
||||
return objectMapper.convertValue(source, destinationClass);
|
||||
}
|
||||
|
||||
/**
|
||||
* 在不同泛型对象类型之间进行转换
|
||||
*
|
||||
* @param source 源对象
|
||||
* @param destinationType 目标对象的泛型类型引用
|
||||
* @param <T> 源对象类型
|
||||
* @param <D> 目标对象类型
|
||||
* @return 转换后的对象
|
||||
*/
|
||||
@Override
|
||||
public <T, D> D convert(T source, JsonTypeReference<D> destinationType) {
|
||||
return objectMapper.convertValue(
|
||||
source,
|
||||
objectMapper.constructType(destinationType.getType())
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,393 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JsonApi.java
|
||||
* LastUpdate 2025-09-09 09:22:02
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.json;
|
||||
|
||||
import com.mingliqiye.utils.collection.Maps;
|
||||
import java.io.*;
|
||||
import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
import java.nio.file.Paths;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* JSON处理接口,提供JSON字符串与Java对象之间的相互转换功能
|
||||
*/
|
||||
public interface JsonApi {
|
||||
final Map<String, String> UNICODE_BIND = Maps.of("1", "");
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定类型的对象
|
||||
*
|
||||
* @param json 待解析的JSON字符串
|
||||
* @param clazz 目标对象的Class类型
|
||||
* @param <T> 泛型参数,表示目标对象的类型
|
||||
* @return 解析后的对象实例
|
||||
*/
|
||||
<T> T parse(String json, Class<T> clazz);
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定泛型类型对象
|
||||
*
|
||||
* @param json 待解析的JSON字符串
|
||||
* @param type 目标对象的Type类型(支持泛型)
|
||||
* @param <T> 泛型参数,表示目标对象的类型
|
||||
* @return 解析后的对象实例
|
||||
*/
|
||||
<T> T parse(String json, JsonTypeReference<T> type);
|
||||
|
||||
/**
|
||||
* 将对象格式化为JSON字符串
|
||||
*
|
||||
* @param object 待格式化的对象
|
||||
* @return 格式化后的JSON字符串
|
||||
*/
|
||||
String format(Object object);
|
||||
|
||||
String formatUnicode(Object object);
|
||||
|
||||
default <T> T parseFrom(String path, Class<T> clazz) throws IOException {
|
||||
return parseFrom(Paths.get(path), clazz);
|
||||
}
|
||||
|
||||
default <T> T parseFrom(Path path, Class<T> clazz) throws IOException {
|
||||
return parseFrom(path.toFile(), clazz);
|
||||
}
|
||||
|
||||
default <T> T parseFrom(File file, Class<T> clazz) throws IOException {
|
||||
try (InputStream inputStream = Files.newInputStream(file.toPath())) {
|
||||
return parseFrom(inputStream, clazz);
|
||||
}
|
||||
}
|
||||
|
||||
default <T> T parseFrom(InputStream inputStream, Class<T> clazz)
|
||||
throws IOException {
|
||||
if (inputStream == null) {
|
||||
throw new IllegalArgumentException("inputStream cannot be null");
|
||||
}
|
||||
if (clazz == null) {
|
||||
throw new IllegalArgumentException("clazz cannot be null");
|
||||
}
|
||||
byte[] bytes = new byte[1024];
|
||||
try (ByteArrayOutputStream bos = new ByteArrayOutputStream()) {
|
||||
int readlength;
|
||||
while ((readlength = inputStream.read(bytes)) != -1) {
|
||||
bos.write(bytes, 0, readlength);
|
||||
}
|
||||
return parse(bos.toByteArray(), clazz);
|
||||
}
|
||||
}
|
||||
|
||||
default <T> T parseFrom(String path, JsonTypeReference<T> type)
|
||||
throws IOException {
|
||||
return parseFrom(Paths.get(path), type);
|
||||
}
|
||||
|
||||
default <T> T parseFrom(Path path, JsonTypeReference<T> type)
|
||||
throws IOException {
|
||||
return parseFrom(path.toFile(), type);
|
||||
}
|
||||
|
||||
default <T> T parseFrom(File file, JsonTypeReference<T> type)
|
||||
throws IOException {
|
||||
try (InputStream inputStream = Files.newInputStream(file.toPath())) {
|
||||
return parseFrom(inputStream, type);
|
||||
}
|
||||
}
|
||||
|
||||
default <T> T parseFrom(InputStream inputStream, JsonTypeReference<T> type)
|
||||
throws IOException {
|
||||
if (inputStream == null) {
|
||||
throw new IllegalArgumentException("inputStream cannot be null");
|
||||
}
|
||||
if (type == null) {
|
||||
throw new IllegalArgumentException("type cannot be null");
|
||||
}
|
||||
byte[] bytes = new byte[1024];
|
||||
try (ByteArrayOutputStream bos = new ByteArrayOutputStream()) {
|
||||
int readlength;
|
||||
while ((readlength = inputStream.read(bytes)) != -1) {
|
||||
bos.write(bytes, 0, readlength);
|
||||
}
|
||||
return parse(bos.toByteArray(), type);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 将字节数组形式的JSON解析为指定类型的对象
|
||||
*
|
||||
* @param json 待解析的JSON字节数组
|
||||
* @param clazz 目标对象的Class类型
|
||||
* @param <T> 泛型参数,表示目标对象的类型
|
||||
* @return 解析后的对象实例
|
||||
*/
|
||||
default <T> T parse(byte[] json, Class<T> clazz) {
|
||||
return parse(new String(json), clazz);
|
||||
}
|
||||
|
||||
/**
|
||||
* 将字节数组形式的JSON解析为指定泛型类型对象
|
||||
*
|
||||
* @param json 待解析的JSON字节数组
|
||||
* @param type 目标对象的Type类型(支持泛型)
|
||||
* @param <T> 泛型参数,表示目标对象的类型
|
||||
* @return 解析后的对象实例
|
||||
*/
|
||||
default <T> T parse(byte[] json, JsonTypeReference<T> type) {
|
||||
return parse(new String(json), type);
|
||||
}
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定类型的对象,解析失败时返回默认值
|
||||
*
|
||||
* @param json 待解析的JSON字符串
|
||||
* @param clazz 目标对象的Class类型
|
||||
* @param defaultValue 解析失败时返回的默认值
|
||||
* @param <T> 泛型参数,表示目标对象的类型
|
||||
* @return 解析后的对象实例或默认值
|
||||
*/
|
||||
default <T> T parse(String json, Class<T> clazz, T defaultValue) {
|
||||
try {
|
||||
return parse(json, clazz);
|
||||
} catch (Exception e) {
|
||||
return defaultValue;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定泛型类型对象,解析失败时返回默认值
|
||||
*
|
||||
* @param json 待解析的JSON字符串
|
||||
* @param type 目标对象的Type类型(支持泛型)
|
||||
* @param defaultValue 解析失败时返回的默认值
|
||||
* @param <T> 泛型参数,表示目标对象的类型
|
||||
* @return 解析后的对象实例或默认值
|
||||
*/
|
||||
default <T> T parse(
|
||||
String json,
|
||||
JsonTypeReference<T> type,
|
||||
T defaultValue
|
||||
) {
|
||||
try {
|
||||
return parse(json, type);
|
||||
} catch (Exception e) {
|
||||
return defaultValue;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 将对象格式化为美化格式的JSON字符串(带缩进和换行)
|
||||
*
|
||||
* @param object 待格式化的对象
|
||||
* @return 格式化后的美化JSON字符串
|
||||
*/
|
||||
String formatPretty(Object object);
|
||||
|
||||
default byte[] formatPrettyBytes(Object object) {
|
||||
return formatPretty(object).getBytes();
|
||||
}
|
||||
|
||||
String formatPrettyUnicode(Object object);
|
||||
|
||||
default byte[] formatPrettyUnicodeBytes(Object object) {
|
||||
return formatPrettyUnicode(object).getBytes();
|
||||
}
|
||||
|
||||
default void formatPretty(Object object, String file) throws IOException {
|
||||
formatPretty(object, Paths.get(file));
|
||||
}
|
||||
|
||||
default void formatPretty(Object object, Path file) throws IOException {
|
||||
formatPretty(object, file.toFile());
|
||||
}
|
||||
|
||||
default void formatPretty(Object object, File file) throws IOException {
|
||||
try (FileOutputStream fos = new FileOutputStream(file)) {
|
||||
formatPretty(object, fos);
|
||||
}
|
||||
}
|
||||
|
||||
default void formatPretty(Object object, OutputStream stream)
|
||||
throws IOException {
|
||||
stream.write(formatPrettyBytes(object));
|
||||
}
|
||||
|
||||
default void formatPrettyUnicode(Object object, String file)
|
||||
throws IOException {
|
||||
formatPrettyUnicode(object, Paths.get(file));
|
||||
}
|
||||
|
||||
default void formatPrettyUnicode(Object object, Path file)
|
||||
throws IOException {
|
||||
formatPrettyUnicode(object, file.toFile());
|
||||
}
|
||||
|
||||
default void formatPrettyUnicode(Object object, File file)
|
||||
throws IOException {
|
||||
try (FileOutputStream fos = new FileOutputStream(file)) {
|
||||
formatPrettyUnicode(object, fos);
|
||||
}
|
||||
}
|
||||
|
||||
default void formatPrettyUnicode(Object object, OutputStream stream)
|
||||
throws IOException {
|
||||
stream.write(formatPrettyUnicodeBytes(object));
|
||||
}
|
||||
|
||||
default byte[] formatBytes(Object object) {
|
||||
return format(object).getBytes();
|
||||
}
|
||||
|
||||
default byte[] formatUnicodeBytes(Object object) {
|
||||
return formatUnicode(object).getBytes();
|
||||
}
|
||||
|
||||
default void format(Object object, String file) throws IOException {
|
||||
format(object, Paths.get(file));
|
||||
}
|
||||
|
||||
default void format(Object object, Path file) throws IOException {
|
||||
format(object, file.toFile());
|
||||
}
|
||||
|
||||
default void format(Object object, File file) throws IOException {
|
||||
try (FileOutputStream fos = new FileOutputStream(file)) {
|
||||
format(object, fos);
|
||||
}
|
||||
}
|
||||
|
||||
default void format(Object object, OutputStream stream) throws IOException {
|
||||
stream.write(formatPrettyBytes(object));
|
||||
}
|
||||
|
||||
default void formatUnicode(Object object, String file) throws IOException {
|
||||
formatUnicode(object, Paths.get(file));
|
||||
}
|
||||
|
||||
default void formatUnicode(Object object, Path file) throws IOException {
|
||||
formatUnicode(object, file.toFile());
|
||||
}
|
||||
|
||||
default void formatUnicode(Object object, File file) throws IOException {
|
||||
try (FileOutputStream fos = new FileOutputStream(file)) {
|
||||
formatUnicode(object, fos);
|
||||
}
|
||||
}
|
||||
|
||||
default void formatUnicode(Object object, OutputStream stream)
|
||||
throws IOException {
|
||||
stream.write(formatPrettyUnicodeBytes(object));
|
||||
}
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定元素类型的List集合
|
||||
*
|
||||
* @param json 待解析的JSON字符串
|
||||
* @param elementType List中元素的类型
|
||||
* @param <T> 泛型参数,表示List中元素的类型
|
||||
* @return 解析后的List集合
|
||||
*/
|
||||
default <T> List<T> parseList(String json, Class<T> elementType) {
|
||||
return parse(json, JsonTypeUtils.listType(elementType));
|
||||
}
|
||||
|
||||
/**
|
||||
* 将JSON字符串解析为指定键值类型的Map集合
|
||||
*
|
||||
* @param json 待解析的JSON字符串
|
||||
* @param keyType Map中键的类型
|
||||
* @param valueType Map中值的类型
|
||||
* @param <K> 泛型参数,表示Map中键的类型
|
||||
* @param <V> 泛型参数,表示Map中值的类型
|
||||
* @return 解析后的Map集合
|
||||
*/
|
||||
default <K, V> Map<K, V> parseMap(
|
||||
String json,
|
||||
Class<K> keyType,
|
||||
Class<V> valueType
|
||||
) {
|
||||
JsonTypeReference<Map<K, V>> mapType = new JsonTypeReference<
|
||||
Map<K, V>
|
||||
>() {};
|
||||
return parse(json, mapType);
|
||||
}
|
||||
|
||||
/**
|
||||
* 验证字符串是否为有效的JSON格式
|
||||
*
|
||||
* @param json 待验证的字符串
|
||||
* @return 如果是有效的JSON格式返回true,否则返回false
|
||||
*/
|
||||
boolean isValidJson(String json);
|
||||
|
||||
/**
|
||||
* 将对象转换为JSON字节数组
|
||||
*
|
||||
* @param object 待转换的对象
|
||||
* @return 转换后的JSON字节数组
|
||||
*/
|
||||
default byte[] toBytes(Object object) {
|
||||
return format(object).getBytes();
|
||||
}
|
||||
|
||||
/**
|
||||
* 将对象转换为美化格式的JSON字节数组
|
||||
*
|
||||
* @param object 待转换的对象
|
||||
* @return 转换后的美化格式JSON字节数组
|
||||
*/
|
||||
default byte[] toBytesPretty(Object object) {
|
||||
return formatPretty(object).getBytes();
|
||||
}
|
||||
|
||||
/**
|
||||
* 合并多个JSON字符串为一个JSON对象
|
||||
*
|
||||
* @param jsons 待合并的JSON字符串数组
|
||||
* @return 合并后的JSON字符串
|
||||
*/
|
||||
String merge(String... jsons);
|
||||
|
||||
/**
|
||||
* 获取JSON字符串中指定路径节点的值
|
||||
*
|
||||
* @param json JSON字符串
|
||||
* @param path 节点路径(如:"user.name")
|
||||
* @return 节点值的字符串表示
|
||||
*/
|
||||
String getNodeValue(String json, String path);
|
||||
|
||||
/**
|
||||
* 更新JSON字符串中指定路径节点的值
|
||||
*
|
||||
* @param json 原始JSON字符串
|
||||
* @param path 节点路径(如:"user.name")
|
||||
* @param newValue 新的节点值
|
||||
* @return 更新后的JSON字符串
|
||||
*/
|
||||
String updateNodeValue(String json, String path, Object newValue);
|
||||
|
||||
<T, D> D convert(T source, Class<D> destinationClass);
|
||||
|
||||
<T, D> D convert(T source, JsonTypeReference<D> destinationType);
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JsonException.java
|
||||
* LastUpdate 2025-09-09 09:25:08
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.json;
|
||||
|
||||
public class JsonException extends RuntimeException {
|
||||
|
||||
public JsonException(String message) {
|
||||
super(message);
|
||||
}
|
||||
|
||||
public JsonException(String message, Throwable cause) {
|
||||
super(message, cause);
|
||||
}
|
||||
|
||||
public JsonException(Throwable cause) {
|
||||
this(cause.getMessage(), cause);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,175 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JsonTypeReference.java
|
||||
* LastUpdate 2025-09-09 09:20:05
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.json;
|
||||
|
||||
import java.lang.reflect.ParameterizedType;
|
||||
import java.lang.reflect.Type;
|
||||
import java.util.Arrays;
|
||||
import java.util.Objects;
|
||||
import lombok.Getter;
|
||||
|
||||
/**
|
||||
* 通用的 JSON 类型引用类,用于在运行时保留泛型类型信息
|
||||
* 适用于所有 JSON 库(Jackson、Gson、Fastjson 等)
|
||||
*
|
||||
* @param <T> 引用的泛型类型
|
||||
*/
|
||||
@Getter
|
||||
public abstract class JsonTypeReference<T>
|
||||
implements Comparable<JsonTypeReference<T>> {
|
||||
|
||||
protected final Type type;
|
||||
|
||||
/**
|
||||
* 构造函数,通过反射获取泛型类型信息
|
||||
* 仅供内部匿名子类使用
|
||||
*/
|
||||
protected JsonTypeReference() {
|
||||
Type superClass = getClass().getGenericSuperclass();
|
||||
|
||||
// 检查是否为匿名子类,防止直接实例化导致无法获取泛型信息
|
||||
if (superClass instanceof Class) {
|
||||
throw new IllegalArgumentException(
|
||||
"必须使用匿名子类方式创建 JsonTypeReference," +
|
||||
"例如: new JsonTypeReference<List<String>>() {}"
|
||||
);
|
||||
}
|
||||
|
||||
this.type =
|
||||
((ParameterizedType) superClass).getActualTypeArguments()[0];
|
||||
}
|
||||
|
||||
/**
|
||||
* 构造函数,直接指定类型
|
||||
* @param type 具体的类型信息
|
||||
*/
|
||||
protected JsonTypeReference(Type type) {
|
||||
this.type = Objects.requireNonNull(type, "Type cannot be null");
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建类型引用实例
|
||||
* @param <T> 目标类型
|
||||
* @return 类型引用实例
|
||||
*/
|
||||
public static <T> JsonTypeReference<T> of() {
|
||||
return new JsonTypeReference<T>() {};
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据 Class 创建类型引用
|
||||
* @param clazz 目标类
|
||||
* @param <T> 目标类型
|
||||
* @return 类型引用实例
|
||||
*/
|
||||
public static <T> JsonTypeReference<T> of(Class<T> clazz) {
|
||||
return new JsonTypeReference<T>(clazz) {};
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据 Type 创建类型引用
|
||||
* @param type 目标类型
|
||||
* @param <T> 目标类型
|
||||
* @return 类型引用实例
|
||||
*/
|
||||
public static <T> JsonTypeReference<T> of(Type type) {
|
||||
return new JsonTypeReference<T>(type) {};
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取原始类型(去掉泛型参数的类型)
|
||||
* @return 原始类型 Class
|
||||
*/
|
||||
@SuppressWarnings("unchecked")
|
||||
public Class<T> getRawType() {
|
||||
Type rawType = type;
|
||||
|
||||
// 如果是参数化类型,则提取原始类型部分
|
||||
if (type instanceof ParameterizedType) {
|
||||
rawType = ((ParameterizedType) type).getRawType();
|
||||
}
|
||||
|
||||
if (rawType instanceof Class) {
|
||||
return (Class<T>) rawType;
|
||||
}
|
||||
|
||||
throw new IllegalStateException("无法获取原始类型: " + type);
|
||||
}
|
||||
|
||||
@Override
|
||||
public boolean equals(Object o) {
|
||||
if (this == o) return true;
|
||||
if (o == null || getClass() != o.getClass()) return false;
|
||||
JsonTypeReference<?> that = (JsonTypeReference<?>) o;
|
||||
|
||||
// 对于 ParameterizedType,需要更完整的比较
|
||||
if (
|
||||
this.type instanceof ParameterizedType &&
|
||||
that.type instanceof ParameterizedType
|
||||
) {
|
||||
ParameterizedType thisParamType = (ParameterizedType) this.type;
|
||||
ParameterizedType thatParamType = (ParameterizedType) that.type;
|
||||
|
||||
return (
|
||||
Objects.equals(
|
||||
thisParamType.getRawType(),
|
||||
thatParamType.getRawType()
|
||||
) &&
|
||||
Arrays.equals(
|
||||
thisParamType.getActualTypeArguments(),
|
||||
thatParamType.getActualTypeArguments()
|
||||
) &&
|
||||
Objects.equals(
|
||||
thisParamType.getOwnerType(),
|
||||
thatParamType.getOwnerType()
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
return Objects.equals(type, that.type);
|
||||
}
|
||||
|
||||
@Override
|
||||
public int hashCode() {
|
||||
// 针对 ParameterizedType 进行完整哈希计算
|
||||
if (type instanceof ParameterizedType) {
|
||||
ParameterizedType paramType = (ParameterizedType) type;
|
||||
return Objects.hash(
|
||||
paramType.getRawType(),
|
||||
Arrays.hashCode(paramType.getActualTypeArguments()),
|
||||
paramType.getOwnerType()
|
||||
);
|
||||
}
|
||||
return Objects.hash(type);
|
||||
}
|
||||
|
||||
@Override
|
||||
public String toString() {
|
||||
return "JsonTypeReference{" + type + '}';
|
||||
}
|
||||
|
||||
@Override
|
||||
public int compareTo(JsonTypeReference<T> o) {
|
||||
return this.type.toString().compareTo(o.type.toString());
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,253 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JsonTypeUtils.java
|
||||
* LastUpdate 2025-09-09 09:18:08
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.json;
|
||||
|
||||
import java.lang.reflect.ParameterizedType;
|
||||
import java.lang.reflect.Type;
|
||||
import java.util.Arrays;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.Objects;
|
||||
|
||||
/**
|
||||
* JSON 类型工具类,提供类型相关的工具方法
|
||||
*/
|
||||
public class JsonTypeUtils {
|
||||
|
||||
private JsonTypeUtils() {
|
||||
// 工具类,防止实例化
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定的类型是否是指定类或其子类/实现类。
|
||||
*
|
||||
* @param type 要检查的类型
|
||||
* @param expectedClass 期望匹配的类
|
||||
* @return 如果类型匹配则返回 true,否则返回 false
|
||||
*/
|
||||
public static boolean isTypeOf(Type type, Class<?> expectedClass) {
|
||||
if (type instanceof Class) {
|
||||
return expectedClass.isAssignableFrom((Class<?>) type);
|
||||
} else if (type instanceof ParameterizedType) {
|
||||
return isTypeOf(
|
||||
((ParameterizedType) type).getRawType(),
|
||||
expectedClass
|
||||
);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取泛型类型的参数类型。
|
||||
*
|
||||
* @param type 泛型类型
|
||||
* @param index 参数索引(从0开始)
|
||||
* @return 指定位置的泛型参数类型
|
||||
* @throws IllegalArgumentException 当无法获取指定索引的泛型参数时抛出异常
|
||||
*/
|
||||
public static Type getGenericParameter(Type type, int index) {
|
||||
if (type instanceof ParameterizedType) {
|
||||
Type[] typeArgs =
|
||||
((ParameterizedType) type).getActualTypeArguments();
|
||||
if (index >= 0 && index < typeArgs.length) {
|
||||
return typeArgs[index];
|
||||
}
|
||||
}
|
||||
throw new IllegalArgumentException(
|
||||
"无法获取泛型参数: " + type + " at index " + index
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取类型名称,支持普通类和泛型类型。
|
||||
*
|
||||
* @param type 类型对象
|
||||
* @return 类型名称字符串
|
||||
*/
|
||||
public static String getTypeName(Type type) {
|
||||
if (type instanceof Class) {
|
||||
return ((Class<?>) type).getSimpleName();
|
||||
} else if (type instanceof ParameterizedType) {
|
||||
ParameterizedType pType = (ParameterizedType) type;
|
||||
Class<?> rawType = (Class<?>) pType.getRawType();
|
||||
Type[] typeArgs = pType.getActualTypeArguments();
|
||||
|
||||
StringBuilder sb = new StringBuilder(rawType.getSimpleName());
|
||||
sb.append("<");
|
||||
for (int i = 0; i < typeArgs.length; i++) {
|
||||
if (i > 0) sb.append(", ");
|
||||
sb.append(getTypeName(typeArgs[i]));
|
||||
}
|
||||
sb.append(">");
|
||||
return sb.toString();
|
||||
}
|
||||
return type.getTypeName();
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建一个表示数组类型的引用对象。
|
||||
*
|
||||
* @param componentType 数组元素的类型
|
||||
* @param <T> 元素类型
|
||||
* @return 表示数组类型的 JsonTypeReference 对象
|
||||
*/
|
||||
public static <T> JsonTypeReference<T[]> arrayType(Class<T> componentType) {
|
||||
return new JsonTypeReference<T[]>() {
|
||||
private final Type arrayType = java.lang.reflect.Array.newInstance(
|
||||
componentType,
|
||||
0
|
||||
).getClass();
|
||||
|
||||
@Override
|
||||
public Type getType() {
|
||||
return new ParameterizedType() {
|
||||
private final Type[] actualTypeArguments = new Type[] {
|
||||
componentType,
|
||||
};
|
||||
|
||||
@Override
|
||||
public Type[] getActualTypeArguments() {
|
||||
return actualTypeArguments;
|
||||
}
|
||||
|
||||
@Override
|
||||
public Type getRawType() {
|
||||
return arrayType;
|
||||
}
|
||||
|
||||
@Override
|
||||
public Type getOwnerType() {
|
||||
return null;
|
||||
}
|
||||
};
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建一个表示 List 类型的引用对象。
|
||||
*
|
||||
* @param componentType List 中元素的类型
|
||||
* @param <T> 元素类型
|
||||
* @return 表示 List 类型的 JsonTypeReference 对象
|
||||
* @throws IllegalArgumentException 如果 componentType 为 null,则抛出异常
|
||||
*/
|
||||
public static <T> JsonTypeReference<List<T>> listType(
|
||||
Class<T> componentType
|
||||
) {
|
||||
if (componentType == null) {
|
||||
throw new IllegalArgumentException("componentType cannot be null");
|
||||
}
|
||||
|
||||
return new JsonTypeReference<List<T>>() {
|
||||
@Override
|
||||
public Type getType() {
|
||||
return new ParameterizedType() {
|
||||
@Override
|
||||
public Type[] getActualTypeArguments() {
|
||||
return new Type[] { componentType };
|
||||
}
|
||||
|
||||
@Override
|
||||
public Type getRawType() {
|
||||
return List.class;
|
||||
}
|
||||
|
||||
@Override
|
||||
public Type getOwnerType() {
|
||||
return null;
|
||||
}
|
||||
};
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建一个表示 Map 类型的引用对象。
|
||||
*
|
||||
* @param keyType Map 键的类型
|
||||
* @param valueType Map 值的类型
|
||||
* @param <K> 键类型
|
||||
* @param <V> 值类型
|
||||
* @return 表示 Map 类型的 JsonTypeReference 对象
|
||||
* @throws IllegalArgumentException 如果 keyType 或 valueType 为 null,则抛出异常
|
||||
*/
|
||||
public static <K, V> JsonTypeReference<Map<K, V>> MapType(
|
||||
Class<K> keyType,
|
||||
Class<V> valueType
|
||||
) {
|
||||
if (keyType == null) {
|
||||
throw new IllegalArgumentException("keyType cannot be null");
|
||||
}
|
||||
if (valueType == null) {
|
||||
throw new IllegalArgumentException("valueType cannot be null");
|
||||
}
|
||||
|
||||
return new JsonTypeReference<Map<K, V>>() {
|
||||
@Override
|
||||
public Type getType() {
|
||||
return new ParameterizedType() {
|
||||
@Override
|
||||
public Type[] getActualTypeArguments() {
|
||||
return new Type[] { keyType, valueType };
|
||||
}
|
||||
|
||||
@Override
|
||||
public Type getRawType() {
|
||||
return Map.class;
|
||||
}
|
||||
|
||||
@Override
|
||||
public Type getOwnerType() {
|
||||
return null;
|
||||
}
|
||||
|
||||
@Override
|
||||
public boolean equals(Object obj) {
|
||||
if (this == obj) return true;
|
||||
if (!(obj instanceof ParameterizedType)) return false;
|
||||
|
||||
ParameterizedType that = (ParameterizedType) obj;
|
||||
return (
|
||||
Objects.equals(getRawType(), that.getRawType()) &&
|
||||
Arrays.equals(
|
||||
getActualTypeArguments(),
|
||||
that.getActualTypeArguments()
|
||||
) &&
|
||||
Objects.equals(getOwnerType(), that.getOwnerType())
|
||||
);
|
||||
}
|
||||
|
||||
@Override
|
||||
public int hashCode() {
|
||||
return (
|
||||
Arrays.hashCode(getActualTypeArguments()) ^
|
||||
Objects.hashCode(getRawType()) ^
|
||||
Objects.hashCode(getOwnerType())
|
||||
);
|
||||
}
|
||||
};
|
||||
}
|
||||
};
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user