0

0

Java中使用Jackson将JSON数组转换为List的完整教程

心靈之曲

心靈之曲

发布时间:2026-02-16 13:06:03

|

584人浏览过

|

来源于php中文网

原创

Java中使用Jackson将JSON数组转换为List的完整教程

本文详解如何利用Jackson库将JSON字符串数组安全、高效地反序列化为List,重点解决TypeReference类型引用错误及驼峰命名映射问题,并提供可运行示例与关键注意事项。

本文详解如何利用jackson库将json字符串数组安全、高效地反序列化为list,重点解决typereference类型引用错误及驼峰命名映射问题,并提供可运行示例与关键注意事项。

在Java开发中,处理动态结构的JSON数据(如无固定POJO类的键值对集合)时,常需将其解析为 List> 或其变体。但直接使用Jackson进行泛型反序列化易因类型擦除引发编译或运行时错误——典型如 readValue(String, TypeReference) 方法不可用,这往往源于Jackson版本不匹配或导入包错误。

✅ 正确做法:选用兼容的Jackson版本与API

核心前提:确认使用的是 Jackson Databind(而非旧版 Codehaus Jackson)
现代项目应使用 com.fasterxml.jackson.core:jackson-databind(推荐 2.15+),而非已废弃的 org.codehaus.jackson。后者已于2013年停止维护,其 ObjectMapper 不支持 TypeReference 的泛型反序列化方法重载。

✅ 正确导入(Maven依赖):

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.3</version>
</dependency>

✅ 正确代码实现(无需自定义CamelCaseHashMap类):

Cleanup.pictures
Cleanup.pictures

智能移除图片中的物体、文本、污迹、人物或任何不想要的东西

下载
import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.*;

public class JsonToListHashMap {
    public static void main(String[] args) throws Exception {
        String json = "[{\"alarmCount\":\"192\",\"sensorId\":\"CM07000071\"},{\"alarmCount\":\"192\",\"sensorId\":\"CM07000072\"}]";

        ObjectMapper mapper = new ObjectMapper();
        // 直接反序列化为 List<Map<String, String>> —— 简洁、安全、标准
        List<Map<String, String>> data = mapper.readValue(
            json, 
            new TypeReference<List<Map<String, String>>>() {}
        );

        // 验证结果
        for (Map<String, String> item : data) {
            System.out.println("sensorId: " + item.get("sensorId") 
                             + ", alarmCount: " + item.get("alarmCount"));
        }
        // 输出:
        // sensorId: CM07000071, alarmCount: 192
        // sensorId: CM07000072, alarmCount: 192
    }
}

? 如需自动下划线转驼峰(如 alarm_count → alarmCount)

若原始JSON字段为蛇形命名(如 {"alarm_count":"192"}),而你希望在Map中以驼峰形式访问键,则不建议继承HashMap重写put()(易引发并发/序列化问题,且Jackson默认不调用自定义put)。推荐以下两种专业方案:

立即学习Java免费学习笔记(深入)”;

方案1:配置ObjectMapper全局启用蛇形转驼峰(推荐)

ObjectMapper mapper = new ObjectMapper();
// 启用自动将下划线分隔键转为驼峰键(仅影响Map反序列化)
mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);
List<Map<String, String>> data = mapper.readValue(json, 
    new TypeReference<List<Map<String, String>>>() {});
// 此时即使JSON是 {"alarm_count":"192"},map.get("alarmCount") 也能返回值

方案2:使用@JsonAlias或自定义KeyDeserializer(适用于复杂场景)

⚠️ 关键注意事项

  • 禁止使用org.codehaus.jackson:该包的ObjectMapper无readValue(String, TypeReference)签名,强制使用会导致编译失败;
  • TypeReference必须匿名子类化:new TypeReference>>() {} 中的 {} 不可省略,否则类型信息丢失;
  • 避免继承HashMap做运行时转换:CamelCaseHashMap在Jackson反序列化过程中不会被调用其put()方法;Jackson直接操作内部哈希表,绕过自定义逻辑;
  • 类型安全建议:优先使用 Map 接收,再按需转换值类型(如String.valueOf(map.get("alarmCount"))),以兼容数字/布尔等混合类型;
  • 异常处理:生产环境务必捕获 JsonProcessingException 和 IOException。

✅ 总结

将JSON数组转为List的本质,是利用Jackson的泛型反序列化能力配合TypeReference。正确选择Jackson 2.x版本、规范使用TypeReference语法、合理配置命名策略,即可零侵入、高可靠地完成转换。摒弃过时API与非标准继承方案,方能写出健壮、可维护的JSON处理代码。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

441

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

321

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

0

2025.09.15

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

750

2023.08.02

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

552

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

216

2023.09.04

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

145

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 3.6万人学习

C# 教程
C# 教程

共94课时 | 9.6万人学习

Java 教程
Java 教程

共578课时 | 66.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号