ObjectMapper 简介
ObjectMapper 是 Jackson 库的核心类,用于 Java 对象与 JSON 数据之间的相互转换。它支持序列化(对象转 JSON)和反序列化(JSON 转对象),广泛应用于 REST API、数据存储和配置处理等场景。
基本依赖配置
在 Maven 项目中添加 Jackson 依赖:
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.15.0</version>
</dependency>
序列化(对象转 JSON)
将 Java 对象转换为 JSON 字符串:
ObjectMapper mapper = new ObjectMapper();
User user = new User("Alice", 25);
String json = mapper.writeValueAsString(user);
System.out.println(json); // 输出:{"name":"Alice","age":25}
package com.example.util;import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;public class ReSultMapUtil {public static void main(String[] args) throws JsonProcessingException {Map resultmap =new HashMap();Map map1=new HashMap();map1.put("age",18);map1.put("tel","18788909090");map1.put("name","zhangsan");Map map2=new HashMap();map2.put("age",19);map2.put("tel","18888909090");map2.put("name","lisan");List list=new ArrayList<>();list.add(map1);list.add(map2);resultmap.put("list",list);System.out.println( buildSuccessMesage(resultmap));}static String buildSuccessMesage(Map bodymap){ObjectMapper objectMapper = new ObjectMapper();Map resultmap =new HashMap();Map headtmap =new HashMap();String result="";headtmap.put("result","success");headtmap.put("msgcode","200");resultmap.put("SYSHEAD",headtmap);resultmap.put("BODY",bodymap);try {result= objectMapper.writeValueAsString(resultmap);} catch (JsonProcessingException e) {e.printStackTrace();}
return result;}
}
注意事项:
- 类字段需提供 getter 方法,否则字段可能被忽略。
- 使用
@JsonInclude(JsonInclude.Include.NON_NULL)
可忽略 null 值字段。
反序列化(JSON 转对象)
将 JSON 字符串转换为 Java 对象:
String json = "{\"name\":\"Bob\",\"age\":30}";
User user = mapper.readValue(json, User.class);
System.out.println(user.getName()); // 输出:Bob
常见注解:
@JsonProperty
:自定义 JSON 字段名。@JsonIgnore
:忽略字段序列化。
处理复杂结构
嵌套对象转换:
public class Order {private User user;private List<String> items;
}String orderJson = "{\"user\":{\"name\":\"Alice\"},\"items\":[\"item1\"]}";
Order order = mapper.readValue(orderJson, Order.class);
集合类型处理:
List<User> users = mapper.readValue("[{\"name\":\"Alice\"}]", new TypeReference<List<User>>() {});
高级配置
日期格式化:
mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd"));
美化输出:
String prettyJson = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(user);
忽略未知字段:
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
异常处理
捕获转换过程中的异常:
try {User user = mapper.readValue(invalidJson, User.class);
} catch (JsonProcessingException e) {e.printStackTrace();
}
性能优化
- 复用
ObjectMapper
实例(线程安全)。 - 使用
JsonFactory
处理流式 JSON(大文件场景)。
通过以上方法,可以高效利用 ObjectMapper 实现 Java 与 JSON 的灵活转换。