老版本的 Jackson 使用的包名为 org.codehaus.jackson,而新版本使用的是com.fasterxml.jackson。
Jackson主要包含了3个模块:
其中,jackson-databind 又依赖于 jackson-annotations。jackson-annotations 又依赖于 jackson-core,
Jackson有三种方式处理 json:
通常来说,我们在日常开发中使用的是第3种方式,有时为了简便也会使用第2种方式,比如你要从一个很大的Json对象中只读取那么一两个字段的时候,采用databind方式显得有些重,JsonNode 反而更简单。
maven 导入
<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.11.4</version>
</dependency>
或 gradle 导入
// https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind
implementation group: 'com.fasterxml.jackson.core', name: 'jackson-databind', version: '2.11.4'
Man man = new Man(12, "哈哈", new Date());
// 序列化
ObjectMapper objectMapper = new ObjectMapper();
String jsonString = objectMapper.writeValueAsString(man);
// 输出
System.out.println(jsonString);
ObjectMapper支持从 byte[]、File、InputStream、字符串等数据的 JSON 反序列化。
// 反序列化对象
ObjectMapper mapper = new ObjectMapper();
User user = mapper.readValue(json, User.class);
// 反序列化为List<类>的对象, 使用 TypeReference 这个标志
String json = "[{\"name\":\"zhangsan\",\"age\":20,\"birthday\":844099200000,\"email\":\"zhangsan@163.com\"}]";
List<User> beanList = mapper.readValue(json, new TypeReference<List<User>>() {});
System.out.println(beanList);
(no Creators, like default construct, exist): cannot deserialize from Object value (no delegate- or property-based Creator)
。这个时候说明缺少空构造(无论是默认构造还是手动构造)或者在带参的构造中需要搭配注解 @JsonCreator 进行使用。com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: Unrecognized field "name2"
。 如果某些输入字段在对应实体类中无匹配,则该字段值为赋予 null 属正常. 或者在class上面加上@JsonIgnoreProperties(ignoreUnknown = true)
注解可用于方法上 或者 字段上。
value的用法:
默认情况下映射的JSON属性与注解的属性名称相同,不过可以使用该注解的value
值修改JSON属性名, 例如 value = "mobileNumber"
access的用法:
@JsonProperty(access = Access.WRITE_ONLY)
private String password;
@JsonIgnore 注解 注解用于排除某个属性,这样该属性就不会被Jackson序列化和反序列化。
@JsonIgnoreProperties(value = {"mobile","name"}) @JsonIgnoreProperties主要用于类上, 表示该字段在序列化和反序列化的时候都将被忽略。
我感觉有硬编码的味道。
@JsonIgnoreProperties(ignoreUnknown = true) 默认为false, 如果在反序列化的过程中,字符串有新增的字段并且是 YourClass类中不存在的,则需要在会转换错误需要加上此注解 ignoreUnknown = true
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
@JsonIgnoreProperties(ignoreUnknown = true)
public class YourClass {
...
}
当 json 在反序列化时,默认选择类的无参构造函数创建类对象,当没有无参构造函数时会报错,@JsonCreator作用就是指定反序列化时用的无参构造函数。构造方法的参数前面需要加上@JsonProperty,否则会报错。
@JsonCreator
public Person(@JsonProperty("id") String id) {
this.id = id;
}
@JsonFormat 用来表示json序列化的一种格式或者类型,主要有下面几个常用的属性
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy年MM月dd日 HH:mm:ss", timezone = "GMT+8")
private Date date;
@JsonFormat(shape = JsonFormat.Shape.NUMBER)
private Date date2;
@JsonFormat(locale = "zh_CN")
private Date date3;
shap: 表示序列化后的一种类型
上面三种格式序列化后的结果:
{
"date":"2018年10月11日 21:47:48",
"date2":1539265668956,
"date3":"2018-10-11T13:47:48.956+0000"
}
也是用于微调序列化
示例
@JsonInclude(JsonInclude.Include.NON_NULL)
public class Person {
....
}
源码
public static enum Include {
ALWAYS, // 默认
NON_NULL, // 属性值为NULL 的不参与序列化
NON_ABSENT,
NON_EMPTY, // 属性为 空(””) 或者为 NULL 都不序列化
NON_DEFAULT, // 属性为默认值不序列化
CUSTOM,
USE_DEFAULTS;
private Include() {
}
}
正常情况下建议不要使用@JsonInclude(JsonInclude.Include.NON_EMPTY)和@JsonInclude(JsonInclude.Include.NON_NULL),因为这样序列化之后的数据无法展现出数据的schema,对客户端不友好。一般而言使用默认的就行。
@JsonValue 可以用在get方法或者属性字段上,一个类只能用一个,当加上@JsonValue注解是,序列化是只返回这一个字段的值(用某个方法的返回值序列化整个对象的返回结果)。
public class Man {
private String name;
@JsonValue
private Integer age;
...
}
序列化这个类是,只返回了age的字符串值
接下来这个案例是枚举 搭配 JsonValue 使用的一种用法: Enums and @JsonValue
public enum Distance {
...
@JsonValue
public String getMeters() {
return meters;
}
}
objectMapper
// 序列化生成对人友好的日期展示
.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false)
// 反序列化时自动忽略多余字段:
.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
可选配置 通过启用SerializationFeature.INDENT_OUTPUT缩进输出配置,可以使得内容格式化后再输出,非常友好。
mapper.enable(SerializationFeature.INDENT_OUTPUT); // 格式化
建议 POJO 中布尔值一律定义为 Boolean 类型,且都不要加 is前缀,防止一些框架解析引起的序列化错误。
public static class Person {
private Boolean male;
public Boolean getMale() {
return male;
}
public void setMale(Boolean male) {
this.male = male;
}
@Override
public String toString() {
return "Person [male=" + male + "]";
}
}
用于反序列中将 boolean 转成 Y 或者 N
@Data
@NoArgsConstructor
public class FieldFromBqRecordDeserializer extends JsonDeserializer<Boolean> {
@Override
public Boolean deserialize(final JsonParser jsonParser, final DeserializationContext context) throws IOException {
// Y 为 true,否则为 false
return "Y".equals(jsonParser.getText());
}
}
用于序列中将字符串 Y 或者 N 转成 boolean
@Data
@NoArgsConstructor
public class FieldFromBqRecordSerializer extends JsonSerializer<Boolean> {
@Override
public void serialize(Boolean aBoolean, JsonGenerator jsonGenerator, SerializerProvider provider) throws IOException {
// Y 为 true,否则为 false
jsonGenerator.writeString(Boolean.TRUE.equals(aBoolean) ? "Y" : "N");
}
}
这里只自定义了反序列化器
public final class TrialRequest {
/**
* 是否从保全记录种跳转进入。必传字段
*/
@JsonDeserialize(using = FieldFromBqRecordDeserializer.class)
private boolean fromBqRecord;
}
FasterXML Jackson学习笔记 https://www.jianshu.com/p/4bd355715419
Jackson注解 @JsonFormat_徐海兴的专栏-CSDN博客 https://blog.csdn.net/u012326462/article/details/83019681
《轻松学习Jackson》教程 - 996极客教程 https://996geek.com/articles/164