net.turnbig.pandora.mapper

Class JsonMapper

java.lang.Object

net.turnbig.pandora.mapper.JsonMapper

public class JsonMapper
extends Object

简单封装Jackson，实现JSON String<->Java Object的Mapper. 封装不同的输出风格, 使用不同的builder函数创建实例.

Author:

calvin

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	enableEnumUseToString() 設定是否使用Enum的toString函數來讀寫Enum, 為False時時使用Enum的name()函數來讀寫Enum, 默認為False.
void	enableJaxbAnnotation() 支持使用Jaxb的Annotation，使得POJO上的annotation不用与Jackson耦合。 默认会先查找jaxb的annotation，如果找不到再找jackson的。
<T> T	getBean(String jsonString, Class<T> beanClazz)
<T> T	getBean(String jsonString, com.fasterxml.jackson.core.type.TypeReference<T> type)
<T> List<T>	getListBean(String jsonString, Class<T> beanClazz)
<K,V> HashMap<K,V>	getMapBean(String jsonString, Class<K> keyClazz, Class<V> valueClazz)
com.fasterxml.jackson.databind.ObjectMapper	getMapper() 取出Mapper做进一步的设置或使用其他序列化API.
static JsonMapper	nonDefaultMapper() 创建只输出初始值被改变的属性到Json字符串的Mapper, 最节约的存储方式，建议在内部接口中使用。
static JsonMapper	nonEmptyMapper() 创建只输出非Null且非Empty(如List.isEmpty)的属性到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

Constructor Detail

JsonMapper

public JsonMapper()

JsonMapper

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

Method Detail

nonEmptyMapper

public static JsonMapper nonEmptyMapper()

创建只输出非Null且非Empty(如List.isEmpty)的属性到Json字符串的Mapper,建议在外部接口中使用.

nonDefaultMapper

public static JsonMapper nonDefaultMapper()

创建只输出初始值被改变的属性到Json字符串的Mapper, 最节约的存储方式，建议在内部接口中使用。

toJson

public String toJson(Object object)

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

getBean

public <T> T getBean(String jsonString,
                     Class<T> beanClazz)

getListBean

public <T> List<T> getListBean(String jsonString,
                               Class<T> beanClazz)

getMapBean

public <K,V> HashMap<K,V> getMapBean(String jsonString,
                                     Class<K> keyClazz,
                                     Class<V> valueClazz)

getBean

public <T> T getBean(String jsonString,
                     com.fasterxml.jackson.core.type.TypeReference<T> type)

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創建後, 所有的讀寫動作之前調用.

enableJaxbAnnotation

public void enableJaxbAnnotation()

支持使用Jaxb的Annotation，使得POJO上的annotation不用与Jackson耦合。 默认会先查找jaxb的annotation，如果找不到再找jackson的。

getMapper

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

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