1.概述
本文着重于理解Jackson ObjectMapper类，以及如何将Java对象序列化为JSON以及如何将JSON字符串反序列化为Java对象。
2.依存关系
首先，将以下依赖项添加到pom.xml：
<dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.9.8</version> </dependency>
此依赖项还将在类路径中可传递地添加以下库：
jackson-annotations-2.9.8.jar
jackson core2.9.8.jar
jackson-databind-2.9.8.jar
始终在Maven中央存储库上使用最新版本的Jackson数据绑定。
3.使用ObjectMapper进行读写
让我们从基本的读写操作开始。
ObjectMapper的简单readValue API 是一个很好的入口点。我们可以使用它来将JSON内容解析或反序列化为Java对象。
同样，在编写方面，我们可以使用writeValue API将任何Java对象序列化为JSON输出。
在本文中，我们将使用以下带有两个字段的Car类作为对象来序列化或反序列化：
public class Car { private String color; private String type; // standard getters setters }
3.1 Java对象到JSON
让我们看一个使用ObjectMapper类的writeValue方法将Java对象序列化为JSON的示例：
ObjectMapper objectMapper = new ObjectMapper(); Car car = new Car("yellow", "renault"); objectMapper.writeValue(new File("target/car.json"), car);
文件中上述内容的输出将是：
{"color":"yellow","type":"renault"}
方法writeValueAsString和writeValueAsBytes的ObjectMapper类生成从Java对象，并返回所生成的JSON作为一个字符串或字节数组JSON：
String carAsString = objectMapper.writeValueAsString(car);
3.2 JSON到Java对象
以下是使用ObjectMapper类将JSON字符串转换为Java对象的简单示例：
String json = "{ \"color\" : \"Black\", \"type\" : \"BMW\" }"; Car car = objectMapper.readValue(json, Car.class);
所述readValue（）函数还接受其它形式像含有JSON字符串文件输入的：
Car car = objectMapper.readValue(new File("src/test/resources/json_car.json"), Car.class);
或网址：
Car car = objectMapper.readValue(new URL("file:src/test/resources/json_car.json"), Car.class);
3.3 JSON至Jackson JsonNode
或者，可以将JSON解析为JsonNode对象，并用于从特定节点检索数据：
String json = "{ \"color\" : \"Black\", \"type\" : \"FIAT\" }"; JsonNode jsonNode = objectMapper.readTree(json); String color = jsonNode.get("color").asText(); // Output: color -> Black
3.4 从JSON数组字符串创建Java列表
我们可以使用TypeReference将数组形式的JSON解析为Java对象列表：
String jsonCarArray = "[{ \"color\" : \"Black\", \"type\" : \"BMW\" }, { \"color\" : \"Red\", \"type\" : \"FIAT\" }]"; List<Car> listCar = objectMapper.readValue(jsonCarArray, new TypeReference<List<Car>>(){});
3.5 从JSON字符串创建Java Map
同样，我们可以将JSON解析为Java Map：
String json = "{ \"color\" : \"Black\", \"type\" : \"BMW\" }"; Map<String, Object> map = objectMapper.readValue(json, new TypeReference<Map<String,Object>>(){});
4.高级功能
Jackson库的最大优势之一是高度可定制的序列化和反序列化过程。
在本节中，我们将介绍一些高级功能，其中输入或输出JSON响应可能不同于生成或使用响应的对象。
4.1 配置序列化或反序列化功能
在将JSON对象转换为Java类时，如果JSON字符串包含一些新字段，则默认过程将导致异常：
String jsonString = "{ \"color\" : \"Black\", \"type\" : \"Fiat\", \"year\" : \"1970\" }";
上面示例中的默认解析过程中，针对Class Car的Java对象的JSON字符串将导致UnrecognizedPropertyException异常。
通过configure方法，我们可以扩展默认过程以忽略新字段：
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); Car car = objectMapper.readValue(jsonString, Car.class); JsonNode jsonNodeRoot = objectMapper.readTree(jsonString); JsonNode jsonNodeYear = jsonNodeRoot.get("year"); String year = jsonNodeYear.asText();
另一个选择是基于FAIL_ON_NULL_FOR_PRIMITIVES的，它定义了是否允许原始值的空值：
objectMapper.configure(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES, false);
同样，FAIL_ON_NUMBERS_FOR_ENUM控制是否允许将枚举值序列化/反序列化为数字：
objectMapper.configure(DeserializationFeature.FAIL_ON_NUMBERS_FOR_ENUMS, false);
您可以在官方网站上找到序列化和反序列化功能的完整列表。
4.2 创建自定义序列化器或反序列化器
ObjectMapper类的另一个基本功能是能够注册自定义序列化器和反序列化器。在输入或输出JSON响应的结构不同于必须对其进行序列化或反序列化的Java类的结构时，自定义序列化器和反序列化器非常有用。
以下是自定义JSON序列化程序的示例：
public class CustomCarSerializer extends StdSerializer<Car> { public CustomCarSerializer() { this(null); } public CustomCarSerializer(Class<Car> t) { super(t); } @Override public void serialize( Car car, JsonGenerator jsonGenerator, SerializerProvider serializer) { jsonGenerator.writeStartObject(); jsonGenerator.writeStringField("car_brand", car.getType()); jsonGenerator.writeEndObject(); } }
此自定义序列化器可以这样调用：
ObjectMapper mapper = new ObjectMapper(); SimpleModule module = new SimpleModule("CustomCarSerializer", new Version(1, 0, 0, null, null, null)); module.addSerializer(Car.class, new CustomCarSerializer()); mapper.registerModule(module); Car car = new Car("yellow", "renault"); String carJson = mapper.writeValueAsString(car);
这是Car在客户端的外观（作为JSON输出）：
var carJson = {"car_brand":"renault"}
这是一个自定义JSON解串器的示例：
public class CustomCarDeserializer extends StdDeserializer<Car> { public CustomCarDeserializer() { this(null); } public CustomCarDeserializer(Class<?> vc) { super(vc); } @Override public Car deserialize(JsonParser parser, DeserializationContext deserializer) { Car car = new Car(); ObjectCodec codec = parser.getCodec(); JsonNode node = codec.readTree(parser); // try catch block JsonNode colorNode = node.get("color"); String color = colorNode.asText(); car.setColor(color); return car; } }
可以通过以下方式调用此自定义反序列化器：
String json = "{ \"color\" : \"Black\", \"type\" : \"BMW\" }"; ObjectMapper mapper = new ObjectMapper(); SimpleModule module = new SimpleModule("CustomCarDeserializer", new Version(1, 0, 0, null, null, null)); module.addDeserializer(Car.class, new CustomCarDeserializer()); mapper.registerModule(module); Car car = mapper.readValue(json, Car.class);
4.3 处理日期格式
java.util.Date的默认序列化产生一个数字，即epoch时间戳（自1970年1月1日以来，以毫秒为单位，UTC）。但这不是人类可读的，并且需要进一步转换以人类可读的格式显示。
让我们使用datePurchased属性将到目前为止使用的Car实例包装在Request类中：
public class Request { private Car car; private Date datePurchased; // standard getters setters }
要控制日期的字符串格式，并将其设置为yyyy-MM-dd HH：mm az，请考虑以下代码段：
ObjectMapper objectMapper = new ObjectMapper(); DateFormat df = new SimpleDateFormat("yyyy-MM-dd HH:mm a z"); objectMapper.setDateFormat(df); String carAsString = objectMapper.writeValueAsString(request); // output: {"car":{"color":"yellow","type":"renault"},"datePurchased":"2016-07-03 11:43 AM CEST"}
要了解有关使用Jackson进行日期序列化的更多信息，请阅读我们更深入的文章。
4.4 处理集合
DeserializationFeature类提供的另一个小而有用的功能是能够从JSON数组响应生成我们想要的集合类型的功能。
例如，我们可以将结果生成为数组：
String jsonCarArray = "[{ \"color\" : \"Black\", \"type\" : \"BMW\" }, { \"color\" : \"Red\", \"type\" : \"FIAT\" }]"; ObjectMapper objectMapper = new ObjectMapper(); objectMapper.configure(DeserializationFeature.USE_JAVA_ARRAY_FOR_JSON_ARRAY, true); Car[] cars = objectMapper.readValue(jsonCarArray, Car[].class); // print cars
或作为清单：
String jsonCarArray = "[{ \"color\" : \"Black\", \"type\" : \"BMW\" }, { \"color\" : \"Red\", \"type\" : \"FIAT\" }]"; ObjectMapper objectMapper = new ObjectMapper(); List<Car> listCar = objectMapper.readValue(jsonCarArray, new TypeReference<List<Car>>(){}); // print cars
5.结论
Jackson是一个针对Java的成熟可靠的JSON序列化/反序列化库。所述ObjectMapper API提供一个简单的方法有很多的灵活性解析和生成JSON响应对象
