原文链接:http://www.dubby.cn/detail.html?id=9070

前几篇介绍Jackson的文章(Jackson介绍,Jackson之jackson-core),虽然很好,但是我相信你并愿意在项目中使用,因为使用起来很复杂,也许这也是很多人愿意使用Fastjson的原因吧。为什么会感觉这么复杂呢,因为jackson-core提供的是很低级的API,我们可以充分的了解细节,但是代价就是操作起来更复杂。

这篇文章介绍使用高级的API,让你看到Jackson也可以这么的简单,容易。

Maven依赖

<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-core -->
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.9.2</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-annotations -->
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.9.2</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.9.2</version>
</dependency>

因为jackson-databind依赖core和annotations,所以在这里需要依赖这三个jar。

POJO和JSON之间的转化

给出一个足够简单的POJO:

public class MyValue {public String name;public int age;
}

注意:如果使用getters/setters的话,可以用private/protected修饰属性,这里直接用public修饰了,就不需要getters/setters了。

使用databind,我们需要一个最基础的对象com.fasterxml.jackson.databind.ObjectMapper,这里我们构造一个:

ObjectMapper mapper = new ObjectMapper(); 

注意:这个mapper是可以复用的,就好比HttpClient一样。

简单的把JSON反序列化成Object的用法如下:

MyValue value = mapper.readValue(new File("data.json"), MyValue.class);
// or:
value = mapper.readValue(new URL("http://www.dubby.cn/api/entry.json"), MyValue.class);
// or:
value = mapper.readValue("{\"name\":\"Bob\", \"age\":13}", MyValue.class);

简单的把Object序列化成JSON的用法如下:

mapper.writeValue(new File("result.json"), myResultObject);
// or:
byte[] jsonBytes = mapper.writeValueAsBytes(myResultObject);
// or:
String jsonString = mapper.writeValueAsString(myResultObject);

其实到这一步,对于很多读者来说已经足够了。因为大部分时候我们要的就是这些。但是不妨继续看下去,还有一些你可能会用到的。

集合、树

如果你使用的不是简单的POJO,而是List,Map:

Map<String, Integer> scoreByName = mapper.readValue(jsonSource, Map.class);
List<String> names = mapper.readValue(jsonSource, List.class);mapper.writeValue(new File("names.json"), names);

如果你反序列化的更复杂,你可以指定类型:

Map<String, ResultValue> results = mapper.readValue(jsonSource, new TypeReference<Map<String, ResultValue>>() { } );

思考:为什么需要指定类型?(类型擦除)

注意:序列化的时候不需要指定,只有反序列化的时候需要。

虽然看起来处理的很方便,但是某些时候会有一些很麻烦的情况,这时候可以考虑使用树模型:

//如果结果可能是Object或者是Array,那可以使用JsonNode;
//如果你知道是Object,你可以直接强转成ObjectNode;如果你知道是Array,你可以直接强转成ArrayNode;
ObjectNode root = (ObjectNode) mapper.readTree("stuff.json");
String name = root.get("name").asText();
int age = root.get("age").asInt();// 还可以修改这个树,然后再输出成json字符串
root.with("other").put("type", "student");
String json = mapper.writeValueAsString(root);// with above, we end up with something like as 'json' String:
// {//   "name" : "Bob", "age" : 13,
//   "other" : {//      "type" : "student"
//   }
// }

上面的例子中的JSON如下:

{"name" : "Bob", "age" : 13,"other" : {"type" : "student"}
}

如果 json 类型太过动态,不适合反序列化成对象的时候,树模型比数据绑定更合适。

流式解析器、生成器

看完上面的介绍,我想你应该相当满意ObjectMapper的能力了,但是如果你希望控制底层的一些细节,或者对性能有更高的要求,你可以通过ObjectMapper来设置。建议你先看看Jackson之jackson-core:

JsonFactory f = mapper.getFactory();
// 1、输入JSON字符串
ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
JsonGenerator g = f.createGenerator(outputStream);
// 输出JSON: { "message" : "Hello world!" }
g.writeStartObject();
g.writeStringField("message", "Hello world!");
g.writeEndObject();
g.close();
// 2、把JSON字符串反序列化
JsonParser p = f.createParser(outputStream.toString());
JsonToken t = p.nextToken(); // Should be JsonToken.START_OBJECT
t = p.nextToken(); // JsonToken.FIELD_NAME
if ((t != JsonToken.FIELD_NAME) || !"message".equals(p.getCurrentName())) {// handle error
}
t = p.nextToken();
if (t != JsonToken.VALUE_STRING) {// similarly
}
String msg = p.getText();
System.out.printf("My message to you is: %s!\n", msg);
p.close();

你也可以直接构造JsonFactory,然后作为构造参数传给ObjectMapper

配置

有两个方面的配置,特性注解

特性配置

给出一个简单的使用特性配置的例子,先给出序列化配置:

// 设置序列化成漂亮的JSON,而不是压缩的字符串
mapper.enable(SerializationFeature.INDENT_OUTPUT);
// 如果你要序列化的对象没有字段(很搞笑吧),会抛异常,可以设置这个来避免异常,直接序列化成`{}`
mapper.disable(SerializationFeature.FAIL_ON_EMPTY_BEANS);
// 默认Date会序列化成时间戳,可以设置这个来序列化成`date":"2017-12-09T12:50:13.000+0000`这个样子
mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);

反序列化配置的例子:

// 默认,如果反序列化时,JSON字符串里有字段,而POJO中没有定义,会抛异常,可以设置这个来忽略未定义的字段
mapper.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
// 默认如果是字符串(""),反序列化会失败,可以开启这个设置,字符串("")会被反序列化成(null)
mapper.enable(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT);

除此之外,还可以针对序列化和反序列化的底层细节指定一些配置,先给出parsing的配置:

// 默认如果JSON中有C/C++风格的注释,在反序列化的时候会报错,可以指定这个配置来忽略C/C++风格的注释
mapper.configure(JsonParser.Feature.ALLOW_COMMENTS, true);
//默认JSON字符串如果字段名没有用双引号包裹,回报错,可以设置这个来支持这种非正规的JSON(JS支持这种非正规的JSON)
mapper.configure(JsonParser.Feature.ALLOW_UNQUOTED_FIELD_NAMES, true);
// 默认如果JSON中是用的单引号包裹字段和值,反序列化时会报错,可以设置这个来兼容单引号这种非正规的JSON
mapper.configure(JsonParser.Feature.ALLOW_SINGLE_QUOTES, true);

再给出generation的配置:

// 把非ASCII转义成ASCII值,如(杨正)会被转义成(\u6768\u6B63)
mapper.configure(JsonGenerator.Feature.ESCAPE_NON_ASCII, true);

注解配置

改变字段名

注解@JsonProperty:

public class MyBean {private String _name;// 默认是`theName`,现在改为`name`@JsonProperty("name")public String getTheName() { return _name; }// 只需要修饰getter或者setter其中的一个就可以了,这里可以省略不写public void setTheName(String n) { _name = n; }
}

忽略字段

@JsonIgnore可以忽略单个字段,@JsonIgnoreProperties可以加在类定义上:

// 序列化和反序列化时,直接忽略JSON中的foo和bar字段
@JsonIgnoreProperties({ "foo", "bar" })
public class MyBean
{// 序列化和反序列化时,直接忽略JSON中的internal字段@JsonIgnorepublic String internal;// 正常字段public String external;@JsonIgnorepublic void setCode(int c) { _code = c; }// 虽然这里没有修饰,但是setter被修饰了,所以也会被忽略public int getCode() { return _code; }
}

从上面我们可以看出,注解在字段名、setter和getter上都是一样的,修饰任何一个都会直接忽略这个字段,但是我们可以值忽略反序列化,而不忽略序列化,或者反之:

public class ReadButDontWriteProps {private String _name;@JsonProperty public void setName(String n) { _name = n; }@JsonIgnore public String getName() { return _name; }
}

这里使用@JsonProperty保证,虽然序列化是name会被忽略,但是从JSON中反序列化时,可以正常接收这个字段。

自定义构造方法

和其他数据绑定工具不一样,Jackson不会强制要求你的POJO必须有个默认构造方法(无参构造方法)。你可以指定一个构造方法来接收反序列化的字段值:

public class CtorBean
{public final String name;public final int age;@JsonCreatorprivate CtorBean(@JsonProperty("name") String name,@JsonProperty("age") int age){this.name = name;this.age = age;}
}

构造方法可以是public,private或者任何其他修饰符修饰

对于一些不可改变的对象,这个会很有用,除了构造方法,@JsonCreator这个注解还可以定义一个工厂方法:

public class FactoryBean
{// fields etc omitted for brewity@JsonCreatorpublic static FactoryBean create(@JsonProperty("name") String name) {// construct and return an instance}
}

注意:构造方法(@JsonCreator@JsonProperty)和setter不互斥,你可以混合使用。

填充、转换

Jackson还有一个很有意思的功能,虽然没有广泛的被人所知道。那就是POJO和POJO之间的转换。概念性的可以理解成POJO1->JSON->POJO2,但是实际上会省略中间这一步,不会真正的生成JSON,而会用其他更高效的实现:

ResultType result = mapper.convertValue(sourceObject, ResultType.class);

还有其他用法:

// List<Integer> -> int[]
List<Integer> sourceList = ...;
int[] ints = mapper.convertValue(sourceList, int[].class);
// POJO -> Map
Map<String,Object> propertyMap = mapper.convertValue(pojoValue, Map.class);
// Map -> POJO
PojoType pojo = mapper.convertValue(propertyMap, PojoType.class);
// decode Base64! (default byte[] representation is base64-encoded String)

甚至还可以解码base64码:

//解码
String base64 = "TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb24sIGJ1dCBieSB0aGlz";
byte[] binary = mapper.convertValue(base64, byte[].class);
System.out.println(new String(binary));
//编码
String str = "Man is distinguished, not only by his reason, but by this";
String base = mapper.convertValue(str.getBytes(), String.class);
System.out.println(base);

所以,Jackson甚至强大到可以代替Apache Commons组件。

Jackson之jackson-databind相关推荐

  1. 【Jackson】jackson 语法介绍 关键字

    文章目录 1.概述 2.引入类库 3.Jackson注解 3.1 属性命名 3.2 属性包含 3.3 序列化相关 4.案例 4.1 简单映射 4.2 集合的映射 4.3 Jackson配置 4.4 用 ...

  2. java jackson maven,jackson中objectMapper的使用

    Jackson可以轻松的将Java对象转换成json对象和xml文档,同样也可以将json.xml转换成Java对象 ObjectMapper类是Jackson库的主要类.它称为ObjectMappe ...

  3. Jackson用法详解

    Spring MVC 默认采用Jackson解析Json,尽管还有一些其它同样优秀的json解析工具,例如Fast Json.GSON,但是出于最小依赖的考虑,也许Json解析第一选择就应该是Jack ...

  4. Jackson使用详解

    本文来说下序列化框架Jackson的详细使用.Spring MVC默认采用Jackson解析Json,尽管还有一些其它同样优秀的json解析工具,例如Fast Json.GSON,但是出于最小依赖的考 ...

  5. Json学习总结(9)——放弃FastJson!Jackson的功能原来如此之牛

    什么是Jackson Jackson是比较主流的基于Java的JSON类库,可用于Json和XML与JavaBean之间的序列化和反序列化.没看错,Jackson也可以处理JavaBean与XML之间 ...

  6. JAVA 序列化 Jackson_SpringBoot系列——Jackson序列化

    前言 Spring Boot提供了与三个JSON映射库的集成: Gson Jackson JSON-B Jackson是首选的默认库. 官网介绍: 通常,我们将Java对象转成Json时称之为序列化, ...

  7. Jackson 解析 JSON 详细教程

    JSON 对于开发者并不陌生,如今的 WEB 服务.移动应用.甚至物联网大多都是以 JSON 作为数据交换的格式.学习 JSON 格式的操作工具对开发者来说是必不可少的.这篇文章将介绍如何使用 Jac ...

  8. Json的FastJson与Jackson

    FastJson 需要引入 fastjson-1.2.40.jar包 FastJson的介绍 JSON协议使用方便,越来越流行,JSON的处理器有很多,这里我介绍一下FastJson,FastJson ...

  9. jackson 官网 java_jackson

    [TOC] # 导包 Jackson包含一个core JAR,和两个依赖core JAR的JAR: * Jackson Core * Jackson Annotations * Jackson Dat ...

  10. Jackson的使用与创建Jackson工具类

    1.Jackson的使用 Jackson 是当前用的比较广泛的,用来序列化和反序列化 json 的 Java 的开源框架.Jackson 社 区相对比较活跃,更新速度也比较快, 从 Github 中的 ...

最新文章

  1. 性能测试关注点整理总结
  2. mongodb系列教程
  3. 普通卷积armv7-neon指令集实现—QNNPACK
  4. Web前端笔试面试题汇总(转自github)
  5. asp.net core中负载均衡场景下http重定向https的问题
  6. SQL Server 数据库构架
  7. sql 查询上个月的数据_数据分析-SQL 进阶篇 多表查询
  8. C#LeetCode刷题之#367-有效的完全平方数(Valid Perfect Square)
  9. php private ,public protected三者的区别
  10. Java Excel文件下载
  11. 删除文件批处理delete file.bat
  12. Json Formatter 1.0 Json格式化工具
  13. Unity 讯飞实时语音转写(一)—— 使用WebSocket连接讯飞语音服务器
  14. 5G注册流程分级详解
  15. minio实现大文件分片上传+断点续传+预览
  16. Bresenham快速画直线算法
  17. OpenCv-C++-小案例实战-切边(二)
  18. c语言之圆的周长、面积、圆球的体积--改良版
  19. 在python语言中ipo模式不包括_下面不是IPO模式的一部分的是()_学小易找答案
  20. SL651-2014 《水文监测数据通信规约》 中心站查询遥测站实时数据详解

热门文章

  1. Android 消息推送 离线也可以收到通知消息
  2. 计算机硬件设施落后,计算机硬件课程的改革和探索.pdf
  3. 比较好用的python编译器_比的解释|比的意思|汉典“比”字的基本解释
  4. 疫情期各类数据图表背后的七个方法、三驾马车与一个工具
  5. app图标圆角角度_[转载]iOS app 图标的圆角半径是多少?
  6. RSocket与springboot整合
  7. C语言单链表基本操作总结
  8. 华为云HCIA鲲鹏结业考试笔记 试题及答案
  9. 贰零壹壹,壹壹,壹柒
  10. 龙梦拿下3万片大单 龙芯电脑年底量产无悬疑