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 的靈活轉換。