cn.ponfee.disjob.common.util

类 Jsons

java.lang.Object

cn.ponfee.disjob.common.util.Jsons

@ThreadSafe
public final class Jsons
extends Object

The json utility based jackson

json5

json5-QA

线程安全

作者:

Ponfee

字段概要

字段

限定符和类型	字段和说明
static Jsons	ALL 不排除任何属性
static com.fasterxml.jackson.databind.ObjectMapper	JSON5 Object mapper support json5
static com.fasterxml.jackson.core.type.TypeReference<List<String>>	LIST_STRING
static com.fasterxml.jackson.core.type.TypeReference<Map<String,Object>>	MAP_NORMAL
static Jsons	NORMAL 标准：忽略对象中值为null的属性

方法概要

限定符和类型	方法和说明
byte[]	bytes(Object target) Serialize the byte array of json
static void	configObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)
static com.fasterxml.jackson.databind.ObjectMapper	createObjectMapper(com.fasterxml.jackson.annotation.JsonInclude.Include include) 也可以使用JsonMapper.Builder来构建： ObjectMapper objectMapper = JsonMapper.builder() .serializationInclusion(JsonInclude.Include.NON_NULL) // 序列化时忽略值为null的字段 .disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES) // 反序列化时忽略未知字段 .enable(JsonReadFeature.ALLOW_SINGLE_QUOTES) // 键和值：可以用单引号 .enable(JsonReadFeature.ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER) // 字符串值：可以通过转义换行符来跨越多行 .enable(JsonReadFeature.ALLOW_TRAILING_COMMA) // 对象或数组：可以有一个尾随逗号 .enable(JsonReadFeature.ALLOW_UNESCAPED_CONTROL_CHARS) // 允许有未转义的控制符 .enable(JsonReadFeature.ALLOW_JAVA_COMMENTS) // 允许单行和多行注释 .build();
static <T> T	fromJson(byte[] json, Class<T> target)
static <T> T	fromJson(byte[] json, com.fasterxml.jackson.databind.JavaType javaType)
static <T> T	fromJson(byte[] json, Type target)
static <T> T	fromJson(byte[] json, com.fasterxml.jackson.core.type.TypeReference<T> type)
static <T> T	fromJson(String json, Class<T> target)
static <T> T	fromJson(String json, com.fasterxml.jackson.databind.JavaType javaType)
static <T> T	fromJson(String json, Type target)
static <T> T	fromJson(String json, com.fasterxml.jackson.core.type.TypeReference<T> type)
<T> T	parse(byte[] json, Class<T> target)
<T> T	parse(byte[] json, com.fasterxml.jackson.databind.JavaType javaType) Deserialize the json byte array to java object
<T> T	parse(byte[] json, Type type)
<T> T	parse(byte[] json, com.fasterxml.jackson.core.type.TypeReference<T> type)
<T> T	parse(String json, Class<T> target)
<T> T	parse(String json, com.fasterxml.jackson.databind.JavaType javaType) Deserialize the json string to java object
<T> T	parse(String json, Type type)
<T> T	parse(String json, com.fasterxml.jackson.core.type.TypeReference<T> type)
static Object[]	parseArgs(String body, Type[] parameterTypes)
static Object[]	parseArray(String body, Class<?>... types)
static Object[]	parseMethodArgs(String body, Method method)
static void	registerJavaTimeModule(com.fasterxml.jackson.databind.ObjectMapper objectMapper)
static void	registerSimpleModule(com.fasterxml.jackson.databind.ObjectMapper objectMapper)
String	string(Object target) Converts an object(POJO, Array, Collection, ...) to json string
static byte[]	toBytes(Object target)
static String	toJson(Object target)
void	write(OutputStream output, Object target) Converts object to json, and write to output stream

从类继承的方法 java.lang.Object

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

字段详细资料

MAP_NORMAL

public static final com.fasterxml.jackson.core.type.TypeReference<Map<String,Object>> MAP_NORMAL

LIST_STRING

public static final com.fasterxml.jackson.core.type.TypeReference<List<String>> LIST_STRING

NORMAL

public static final Jsons NORMAL

标准：忽略对象中值为null的属性

ALL

public static final Jsons ALL

不排除任何属性

JSON5

public static final com.fasterxml.jackson.databind.ObjectMapper JSON5

Object mapper support json5

方法详细资料

write

public void write(OutputStream output,
                  Object target)

Converts object to json, and write to output stream

参数:

output - the output stream

target - the target object

string

public String string(Object target)

Converts an object(POJO, Array, Collection, ...) to json string

参数:

target - target object

返回:

json string

bytes

public byte[] bytes(Object target)

Serialize the byte array of json

参数:

target - object

返回:

byte[] array

parse

public <T> T parse(String json,
                   com.fasterxml.jackson.databind.JavaType javaType)

Deserialize the json string to java object

参数:

json - json string

javaType - JavaType

返回:

the javaType's object

另请参阅:

ObjectMapper.getTypeFactory(), ObjectMapper.constructType(Type), TypeFactory.constructGeneralizedType(JavaType, Class)

parse

public <T> T parse(byte[] json,
                   com.fasterxml.jackson.databind.JavaType javaType)

Deserialize the json byte array to java object

参数:

json - json byte array

javaType - JavaType

返回:

the javaType's object

parse

public <T> T parse(String json,
                   Class<T> target)

parse

public <T> T parse(byte[] json,
                   Class<T> target)

parse

public <T> T parse(String json,
                   Type type)

parse

public <T> T parse(byte[] json,
                   Type type)

parse

public <T> T parse(String json,
                   com.fasterxml.jackson.core.type.TypeReference<T> type)

parse

public <T> T parse(byte[] json,
                   com.fasterxml.jackson.core.type.TypeReference<T> type)

toJson

public static String toJson(Object target)

toBytes

public static byte[] toBytes(Object target)

parseArray

public static Object[] parseArray(String body,
                                  Class<?>... types)

parseMethodArgs

public static Object[] parseMethodArgs(String body,
                                       Method method)

parseArgs

public static Object[] parseArgs(String body,
                                 Type[] parameterTypes)

fromJson

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

fromJson

public static <T> T fromJson(byte[] json,
                             com.fasterxml.jackson.databind.JavaType javaType)

fromJson

public static <T> T fromJson(String json,
                             Class<T> target)

fromJson

public static <T> T fromJson(byte[] json,
                             Class<T> target)

fromJson

public static <T> T fromJson(String json,
                             Type target)

fromJson

public static <T> T fromJson(byte[] json,
                             Type target)

fromJson

public static <T> T fromJson(String json,
                             com.fasterxml.jackson.core.type.TypeReference<T> type)

fromJson

public static <T> T fromJson(byte[] json,
                             com.fasterxml.jackson.core.type.TypeReference<T> type)

createObjectMapper

public static com.fasterxml.jackson.databind.ObjectMapper createObjectMapper(com.fasterxml.jackson.annotation.JsonInclude.Include include)

也可以使用JsonMapper.Builder来构建：
  ObjectMapper objectMapper = JsonMapper.builder()
    .serializationInclusion(JsonInclude.Include.NON_NULL)           // 序列化时忽略值为null的字段
    .disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES)     // 反序列化时忽略未知字段
    .enable(JsonReadFeature.ALLOW_SINGLE_QUOTES)                    // 键和值：可以用单引号
    .enable(JsonReadFeature.ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER) // 字符串值：可以通过转义换行符来跨越多行
    .enable(JsonReadFeature.ALLOW_TRAILING_COMMA)                   // 对象或数组：可以有一个尾随逗号
    .enable(JsonReadFeature.ALLOW_UNESCAPED_CONTROL_CHARS)          // 允许有未转义的控制符
    .enable(JsonReadFeature.ALLOW_JAVA_COMMENTS)                    // 允许单行和多行注释
    .build();
 

参数:

include - the JsonInclude

返回:

ObjectMapper instance

configObjectMapper

public static void configObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper)

registerSimpleModule

public static void registerSimpleModule(com.fasterxml.jackson.databind.ObjectMapper objectMapper)

registerJavaTimeModule

public static void registerJavaTimeModule(com.fasterxml.jackson.databind.ObjectMapper objectMapper)