com.vip.vjtools.vjkit.mapper

Class JsonMapper

java.lang.Object

com.vip.vjtools.vjkit.mapper.JsonMapper

public class JsonMapper
extends Object

简单封装Jackson，实现JSON String<->Java Object转换的Mapper. 可以直接使用公共示例JsonMapper.INSTANCE, 也可以使用不同的builder函数创建实例，封装不同的输出风格, 不要使用GSON, 在对象稍大时非常缓慢. 注意: 需要参考本模块的POM文件，显式引用jackson.

Author:

calvin

Field Summary

Fields

Modifier and Type	Field and Description
static JsonMapper	INSTANCE

Constructor Summary

Constructors

Constructor and Description
JsonMapper()
JsonMapper(com.fasterxml.jackson.annotation.JsonInclude.Include include)

Method Summary

Methods

Modifier and Type	Method and Description
com.fasterxml.jackson.databind.JavaType	buildCollectionType(Class<? extends Collection> collectionClass, Class<?> elementClass) 构造Collection类型.
com.fasterxml.jackson.databind.JavaType	buildMapType(Class<? extends Map> mapClass, Class<?> keyClass, Class<?> valueClass) 构造Map类型.
static JsonMapper	defaultMapper() 默认的全部输出的Mapper, 区别于INSTANCE，可以做进一步的配置
void	enableEnumUseToString() 設定是否使用Enum的toString函數來讀寫Enum, 為False時時使用Enum的name()函數來讀寫Enum, 默認為False.
<T> T	fromJson(String jsonString, Class<T> clazz) 反序列化POJO或简单Collection如List.
<T> T	fromJson(String jsonString, com.fasterxml.jackson.databind.JavaType javaType) 反序列化复杂Collection如List, contructCollectionType()或contructMapType()构造类型, 然后调用本函数.
com.fasterxml.jackson.databind.ObjectMapper	getMapper() 取出Mapper做进一步的设置或使用其他序列化API.
static JsonMapper	nonEmptyMapper() 创建只输出非Null且非Empty(如List.isEmpty)的属性到Json字符串的Mapper.
static JsonMapper	nonNullMapper() 创建只输出非Null的属性到Json字符串的Mapper.
String	toJson(Object object) Object可以是POJO，也可以是Collection或数组。 如果对象为Null, 返回"null".
String	toJsonP(String functionName, Object object) 輸出JSONP格式數據.
void	update(String jsonString, Object object) 当JSON里只含有Bean的部分属性時，更新一個已存在Bean，只覆盖該部分的属性.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INSTANCE

public static final JsonMapper INSTANCE

Constructor Detail

JsonMapper

public JsonMapper()

JsonMapper

public JsonMapper(com.fasterxml.jackson.annotation.JsonInclude.Include include)

Method Detail

nonNullMapper

public static JsonMapper nonNullMapper()

创建只输出非Null的属性到Json字符串的Mapper.

nonEmptyMapper

public static JsonMapper nonEmptyMapper()

创建只输出非Null且非Empty(如List.isEmpty)的属性到Json字符串的Mapper. 注意，要小心使用, 特别留意empty的情况.

defaultMapper

public static JsonMapper defaultMapper()

默认的全部输出的Mapper, 区别于INSTANCE，可以做进一步的配置

toJson

public String toJson(Object object)

Object可以是POJO，也可以是Collection或数组。 如果对象为Null, 返回"null". 如果集合为空集合, 返回"[]".

fromJson

public <T> T fromJson(String jsonString,
             Class<T> clazz)

反序列化POJO或简单Collection如List. 如果JSON字符串为Null或"null"字符串, 返回Null. 如果JSON字符串为"[]", 返回空集合. 如需反序列化复杂Collection如List, 请使用fromJson(String, JavaType)

See Also:

fromJson(String, JavaType)

fromJson

public <T> T fromJson(String jsonString,
             com.fasterxml.jackson.databind.JavaType javaType)

反序列化复杂Collection如List, contructCollectionType()或contructMapType()构造类型, 然后调用本函数.

See Also:

#createCollectionType(Class, Class...)

buildCollectionType

public com.fasterxml.jackson.databind.JavaType buildCollectionType(Class<? extends Collection> collectionClass,
                                                          Class<?> elementClass)

构造Collection类型.

buildMapType

public com.fasterxml.jackson.databind.JavaType buildMapType(Class<? extends Map> mapClass,
                                                   Class<?> keyClass,
                                                   Class<?> valueClass)

构造Map类型.

update

public void update(String jsonString,
          Object object)

当JSON里只含有Bean的部分属性時，更新一個已存在Bean，只覆盖該部分的属性.

toJsonP

public String toJsonP(String functionName,
             Object object)

輸出JSONP格式數據.

enableEnumUseToString

public void enableEnumUseToString()

設定是否使用Enum的toString函數來讀寫Enum, 為False時時使用Enum的name()函數來讀寫Enum, 默認為False. 注意本函數一定要在Mapper創建後, 所有的讀寫動作之前調用.

getMapper

public com.fasterxml.jackson.databind.ObjectMapper getMapper()

取出Mapper做进一步的设置或使用其他序列化API.