org.dromara.hutool.json.mapper.JSONValueMapper Maven / Gradle / Ivy
/*
* Copyright (c) 2013-2024 Hutool Team and hutool.cn
*
* 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.
*/
package org.dromara.hutool.json.mapper;
import org.dromara.hutool.core.array.ArrayUtil;
import org.dromara.hutool.core.util.ObjUtil;
import org.dromara.hutool.json.JSON;
import org.dromara.hutool.json.JSONArray;
import org.dromara.hutool.json.JSONConfig;
import org.dromara.hutool.json.JSONObject;
import org.dromara.hutool.json.serialize.JSONStringer;
import org.dromara.hutool.json.writer.GlobalValueWriters;
import java.io.Serializable;
/**
* 对象和JSON值映射器，用于转换对象为JSON对象中的值
* 有效的JSON值包括：
*
* - JSONObject
* - JSONArray
* - String
* - 数字（int、long等）
* - Boolean值，如true或false
* - {@code null}
*
*
* @author looly
* @since 6.0.0
*/
public class JSONValueMapper implements Serializable {
private static final long serialVersionUID = -6714488573738940582L;
/**
* 创建ObjectMapper
*
* @param jsonConfig 来源对象
* @return ObjectMapper
*/
public static JSONValueMapper of(final JSONConfig jsonConfig) {
return new JSONValueMapper(jsonConfig);
}
private final JSONConfig jsonConfig;
/**
* 构造
*
* @param jsonConfig JSON配置
*/
public JSONValueMapper(final JSONConfig jsonConfig) {
this.jsonConfig = jsonConfig;
}
/**
* 在需要的时候转换映射对象
* 包装包括：
*
* - array or collection =》 JSONArray
* - map =》 JSONObject
* - standard property (Double, String, et al) =》 原对象
* - 来自于java包 =》 字符串
* - 其它 =》 尝试包装为JSONObject，否则返回{@code null}
*
*
* @param object 被映射的对象
* @return 映射后的值，null表示此值需被忽略
*/
public Object map(final Object object) {
// null、JSON、字符串和自定义对象原样存储
if (null == object
// 当用户自定义了对象的字符串表示形式，则保留这个对象
|| null != GlobalValueWriters.get(object)
|| object instanceof JSON //
|| object instanceof JSONStringer //
|| object instanceof CharSequence //
|| ObjUtil.isBasicType(object) //
) {
return object;
}
// 特定对象转换
try {
// JSONArray
if (object instanceof Iterable || ArrayUtil.isArray(object)) {
return new JSONArray(object, jsonConfig);
}
// 默认按照JSONObject对待
return new JSONObject(object, jsonConfig);
} catch (final Exception exception) {
return null;
}
}
}