All Downloads are FREE. Search and download functionalities are using the official Maven repository.
  • Log In
  • Register

    • com.jfinal.json.Jackson Maven / Gradle / Ivy

    The newest version!
    /**
 * Copyright (c) 2011-2023, James Zhan 詹波 ([email protected]).
 *
 * 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 com.jfinal.json;

import com.fasterxml.jackson.annotation.JsonInclude.Include;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
import com.jfinal.kit.TimeKit;

/**
 * Json 转换 jackson 实现.
 *
 * json 到 java 类型转换规则: http://wiki.fasterxml.com/JacksonInFiveMinutes
 * JSON TYPE				JAVA TYPE
 * object					LinkedHashMap
 * array					ArrayList
 * string					String
 * number (no fraction)		Integer, Long or BigInteger (smallest applicable)
 * number (fraction)		Double (configurable to use BigDecimal)
 * true|false				Boolean
 * null						null
 */
@SuppressWarnings("deprecation")
public class Jackson extends Json {

	// Jackson 生成 json 的默认行为是生成 null value，可设置此值全局改变默认行为
	private static boolean defaultGenerateNullValue = true;

	// generateNullValue 通过设置此值，可临时改变默认生成 null value 的行为
	protected Boolean generateNullValue = null;

	protected static final ObjectMapper objectMapper = new ObjectMapper();

	// https://gitee.com/jfinal/jfinal-weixin/issues/I875U
	static {
		objectMapper.configure(com.fasterxml.jackson.core.JsonParser.Feature.ALLOW_UNQUOTED_CONTROL_CHARS, true);
		objectMapper.configure(com.fasterxml.jackson.core.JsonParser.Feature.ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER, true);

		// 没有 getter 方法时不抛异常
		objectMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false);
		// 自动发现并注册所有可用的 jackson 模块
		objectMapper.findAndRegisterModules();
	}

	public static void setDefaultGenerateNullValue(boolean defaultGenerateNullValue) {
		Jackson.defaultGenerateNullValue = defaultGenerateNullValue;
	}

	public Jackson setGenerateNullValue(boolean generateNullValue) {
		this.generateNullValue = generateNullValue;
		return this;
	}

	/**
	 * 通过获取 ObjectMapper 进行更个性化设置，满足少数特殊情况
	 */
	public ObjectMapper getObjectMapper() {
		return objectMapper;
	}

	public static Jackson getJson() {
		return new Jackson();
	}

	public String toJson(Object object) {
		try {
			// 优先使用对象级的属性 datePattern, 然后才是全局性的 defaultDatePattern
			String dp = datePattern != null ? datePattern : getDefaultDatePattern();
			if (dp != null) {
				objectMapper.setDateFormat(TimeKit.getSimpleDateFormat(dp));
			}

			// 优先使用对象属性 generateNullValue，决定转换 json时是否生成 null value
			boolean pnv = generateNullValue != null ? generateNullValue : defaultGenerateNullValue;
			if (!pnv) {
				objectMapper.setSerializationInclusion(Include.NON_NULL);
			}

			return objectMapper.writeValueAsString(object);
		} catch (Exception e) {
			throw e instanceof RuntimeException ? (RuntimeException)e : new RuntimeException(e);
		}
	}

	public  T parse(String jsonString, Class type) {
		try {
			return objectMapper.readValue(jsonString, type);
		} catch (Exception e) {
			throw e instanceof RuntimeException ? (RuntimeException)e : new RuntimeException(e);
		}
	}
}



    
    
    
    

    




    
    
    © 2015 - 2024 Weber Informatics LLC | Privacy Policy