当前位置：首页 > news >正文

MyBatis TypeHandler 详解与实战：FastJson 实现字符串转 List

news 来源：原创 2025/9/10 0:23:17

在 MyBatis 中，TypeHandler 是实现 Java 类型与数据库类型双向转换 的核心组件。无论是处理基础数据类型还是复杂的 JSON、枚举或自定义对象，它都能通过灵活的扩展机制满足开发需求。本文将通过一个 将数据库 JSON 字符串转换为 List<User> 的案例，详解 TypeHandler 的原理与实践。

一、TypeHandler 的作用与原理

1. 核心功能

类型转换桥梁：将 Java 对象属性转换为 JDBC 参数（如 PreparedStatement 设置值）；
结果集映射：将数据库查询结果（如 ResultSet）转换为 Java 对象属性；
空值处理：统一处理 Java 对象与数据库字段的 NULL 值逻辑。

2. 应用场景

内置类型处理：MyBatis 已支持 String、Integer、Date 等常见类型的转换；
复杂类型处理：如 JSON 字符串与对象互转、枚举值与数据库标记映射、CSV 字符串与集合转换等。

二、TypeHandler 的配置与扩展

1. 内置 TypeHandler

MyBatis 默认提供多种 TypeHandler，例如：

StringTypeHandler：处理 VARCHAR 与 String；
EnumTypeHandler：处理枚举与数据库标记（如 disabled 转 0）；
DateTypeHandler：处理日期类型与 TIMESTAMP 的转换。

2. 自定义 TypeHandler 步骤

继承 BaseTypeHandler：实现 setNonNullParameter（Java→JDBC）和 getNullableResult（JDBC→Java）方法；
注册处理器：
- 全局注册：在 mybatis-config.xml 中通过 <typeHandlers> 标签配置；
- 局部指定：在 Mapper XML 或注解中通过 typeHandler 属性标记；
应用转换逻辑：在实体类字段或 SQL 映射中声明使用自定义 TypeHandler。

三、实战：FastJson 实现 JSON 字符串与 List 转换

1. 场景描述

假设数据库表 user_group 的 users 字段存储 JSON 字符串，需在 Java 中映射为 List<User> 对象：

CREATE TABLE user_group (id BIGINT PRIMARY KEY,users VARCHAR(2048)  -- 存储格式：[{"id":1,"name":"Alice","age":25},...]
);

2. 实现步骤

① 引入依赖

<dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.83</version>
</dependency>

② 定义 User 实体

public class User {private Long id;private String name;private Integer age;// getters/setters
}

③ 自定义 TypeHandler

public class ListUserTypeHandler extends BaseTypeHandler<List<User>> {@Overridepublic void setNonNullParameter(PreparedStatement ps, int i, List<User> users, JdbcType jdbcType) throws SQLException {ps.setString(i, JSON.toJSONString(users));  // Java→JSON字符串}@Overridepublic List<User> getNullableResult(ResultSet rs, String columnName) throws SQLException {String json = rs.getString(columnName);return parseJson(json);}private List<User> parseJson(String json) {return json == null ? null : JSON.parseObject(json, new TypeReference<List<User>>(){});}// 其他重写方法略...
}

④ 全局注册 TypeHandler

<!-- mybatis-config.xml -->
<typeHandlers><typeHandler handler="com.example.ListUserTypeHandler" javaType="java.util.List" jdbcType="VARCHAR"/>
</typeHandlers>

⑤ 实体类与 Mapper 映射

public class UserGroup {private Long id;@TableField(typeHandler = ListUserTypeHandler.class)private List<User> users;// getters/setters
}

<!-- UserGroupMapper.xml -->
<select id="selectUserGroup" resultType="UserGroup">SELECT * FROM user_group WHERE id = #{id}
</select>

四、测试与验证

UserGroup group = sqlSession.selectOne("selectUserGroup", 1L);
System.out.println(group.getUsers()); 
// 输出：[User{id=1, name='Alice', age=25}, User{id=2, name='Bob', age=30}]

五、总结与扩展

优势
- 解耦业务与持久化逻辑：将类型转换代码集中管理，提升可维护性；
- 支持复杂场景：通过自定义逻辑处理加密数据、多语言字段等特殊需求。
扩展方向
- 泛型支持：抽象通用 JSON TypeHandler，通过 TypeReference 适配不同泛型类；
- 性能优化：针对高频转换类型缓存解析结果，减少重复计算。

通过合理使用 TypeHandler，开发者可以显著提升 MyBatis 在处理复杂数据类型时的灵活性与代码整洁度，是高效 ORM 实践的重要工具。

MyBatis TypeHandler 详解与实战：FastJson 实现字符串转 List

在 MyBatis 中，TypeHandler 是实现 Java 类型与数据库类型双向转换的核心组件。无论是处理基础数据类型还是复杂的 JSON、枚举或自定义对象，它都能通过灵活的扩展机制满足开发需求。本文将通过一个将数据库 JSON 字符串转换为 List<User> 的案例…...

编程日记 2025/9/10 0:23:17

实验环境搭建集锦（docker linux ros2+强化学习环境+linux上单片机串口调试）

为了记住一些实验环境配置开的文章，边配置边记，免得之后忘了。 Docker环境搭建 yay -S docker //下载docker docker info //查看docker配置 sudo systemctl start docker //系统配置打开docker sudo systemctl enable docker //系统配置后台开启d…...

编程日记 2025/9/10 0:22:48

第十三届蓝桥杯大赛软件赛决赛C/C++ 大学 B 组

A 【2022——暴力DP / 优雅背包】-CSDN博客 B 【钟表——类日期问题】-CSDN博客 C 【卡牌——二分】-CSDN博客 D 【最大数字——DFS】-CSDN博客 E 【出差——Dijkstra】-CSDN博客 F 【费用报销——01背包】-CSDN博客 G 【故障——条件概率】-CSDN博客 H 【机房—…...

编程日记 2025/9/10 0:19:44

商城系统单商户开源版源码

环境配置 1.软件安装宝塔安装系统软件:Nginx、MySQL5.6、PHP( PHP用7.1-7.4版本)、phpMyAdmin(Web端MySQL管理工具)。 2.配置mysql 设置mysql，在已安装的软件里面找到 mysql点击进行设置 3.修改sql-mode 选择左侧配置修改，找到里面的sql-mode&…...

编程日记 2025/9/10 0:18:04

【SpringBoot+Vue】博客项目开发二：用户登录注册模块

后端用户模块开发制定参数交互约束当前，我们使用MybatisX工具快速生成的代码中，包含了一个实体类，这个类中包含我们数据表中的所有字段。但因为有些字段，是不应该返回到前端的，比如用户密码，或者前端传…...

编程日记 2025/9/7 12:03:07

HTTP 协议的发展历程：从 HTTP/1.0 到 HTTP/2.0

HTTP 协议的发展历程：从 HTTP/1.0 到 HTTP/2.0 HTTP（HyperText Transfer Protocol，超文本传输协议）是 Web 的基础协议，用于客户端和服务器之间的通信。从 HTTP/1.0 到 HTTP/2.0，HTTP 协议经历了多次重大改…...

编程日记 2025/9/9 1:48:54

每日十个计算机专有名词 (7)

Metasploit 词源：Meta（超越，超出） exploit（漏洞利用） Metasploit 是一个安全测试框架，用来帮助安全专家（也叫渗透测试人员）发现和利用计算机系统中的漏洞。你可以把它想…...

编程日记 2025/9/4 19:15:44

SQL经典题型

查询不在表里的数据，一张学生表，一张学生的选课表，要求查出没有选课的学生？ select students.student_name from students left join course_selection on students.student_idcourse_selection.student_id where course_selecti…...

编程日记 2025/9/8 5:38:49

基于Linux系统的物联网智能终端

背景产品研发和项目研发有什么区别？一个令人发指的问题，刚开始工作时项目开发居多，认为项目开发和产品开发区别不大，待后来随着自身能力的提升，逐步感到要开发一个好产品还是比较难的，我认为项目开发的目的…...

编程日记 2025/9/9 15:09:11

文字描边实现内黄外绿效果

网页使用 <!DOCTYPE html> <html> <head> <style> .text-effect {color: #ffd700; /* 黄色文字 */-webkit-text-stroke: 2px #008000; /* 绿色描边（兼容Webkit内核） */text-stroke: 2px #008000; /* 标准语法 *…...

编程日记 2025/8/16 10:33:19

next实现原理

Next.js 是一个基于 React 的服务器端渲染（SSR） 和静态生成（SSG） 框架，它的实现原理涉及多个关键技术点，包括服务端渲染（SSR）、静态生成（SSG）、客户端渲染…...

编程日记 2025/9/2 15:27:53

什么是 jQuery

一、jQuery 基础入门 （一）什么是 jQuery jQuery 本质上是一个快速、小巧且功能丰富的 JavaScript 库。它将 JavaScript 中常用的功能代码进行了封装，为开发者提供了一套简洁、高效的 API，涵盖了 HTML 文档遍历与操作、事件处理、…...

编程日记 2025/8/29 13:11:45

014 rocketmq角色介绍

文章目录 NameServer1 服务发现机制2 为什么要使⽤NameServer3 NameServer如何保证数据的最终⼀致？4 特点 BrokerProducerConsumerTopicQueueProducer GroupConsumer GroupMessageTagOffset 同一消费者组下，队列只能由一个消费者消费广播模式&#xff1…...

编程日记 2025/9/3 13:49:58

如何防止Python网络爬虫爬取网站内容

要防止Python网络爬虫爬取网站内容，可以从以下几个方面入手： 遵守Robots.txt文件：首先，网站管理员可以通过robots.txt文件明确告知爬虫哪些页面可以抓取，哪些不可以。爬虫在抓取之前应先检查该文件，尊重网站…...

编程日记 2025/9/4 1:36:19

项目准备（flask+pyhon+MachineLearning）- 3

目录 1.商品信息 2. 商品销售预测 2.1 机器学习 2.2 预测功能 3. 模型评估 1.商品信息 app.route(/products) def products():"""商品分析页面"""data load_data()# 计算当前期间和上期间current_period data[data[成交时间] > data[成…...

编程日记 2025/9/6 7:54:13

选开源CMS建站系统时，插件越多越好吗？

在选择开源CMS建站系统时，插件数量并不是唯一的衡量标准，更不能简单地说“插件越多就越好”，还是需要综合评估来考虑选择结果，以下是有关选择开源CMS系统时对插件数量的考量。插件数量的优势插件数量可能带来的问题功能丰富性&a…...

编程日记 2025/9/4 6:52:48

注：本文为 “OSPF BIT 类型 | LSA 类型 ” 相关文章合辑。机翻，未校。 15 OSPF BIT Types Explained 15 种 OSPF BIT 类型说明 Rashmi Bhardwaj Distribution of routing information within a single autonomous system in larger networks is per…...

编程日记 2025/9/2 1:44:37

C语言(3)—循环、数组、函数的详解

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档文章目录前言一、函数二、循环与数组 1.循环2.数组总结前言提示：以下是本篇文章正文内容，下面案例可供参考一、函数在C语言中，函数…...

编程日记 2025/9/9 14:21:13

大唐杯——阶段二01

03 5G寻呼 UE（User Equipment） UE是用户设备（User Equipment）的缩写，指的是移动通信网络中的终端设备，例如手机、平板电脑、物联网传感器等。 AMF（Access and Mobility Management Function&a…...

编程日记 2025/9/4 14:36:41

清华大学Deepseek第六版AIGC发展研究3.0（共186页，附PDF下载）

人工智能生成内容（AIGC）正以前所未有的速度改变我们的生活。 2024年底，清华大学新闻与传播学院与人工智能学院联合发布了《AIGC发展研究3.0版》，这份报告系统梳理了AIGC技术的突破性进展、应用场景及社会影响，并展望了…...

编程日记 2025/9/6 19:03:18

【漫话机器学习系列】114.逻辑 Sigmoid 函数

逻辑 Sigmoid 函数详解 1. 引言逻辑回归（Logistic Regression）是机器学习中常用的分类算法，而 Sigmoid 函数是逻辑回归的核心数学工具。Sigmoid 函数能够将任意实数映射到 (0,1) 之间，因此特别适用于概率估计。在这篇文章中&a…...

编程日记 2025/9/7 18:29:22

Cocos Creator3.8.6拖拽物体的几种方式

文章目录前言一、第一种通过UILocation二、第二种通过UIDelta实现总结前言在游戏开发中，拖拽物体是一个非常常见的交互功能，无论是用于UI元素的拖动，还是场景中物体的移动，拖拽操作都能极大地提升用户体验。Cocos Creator 3.8…...

编程日记 2025/8/28 8:04:31

01_NLP基础之文本处理的基本方法

自然语言处理入门自然语言处理（Natural Language Processing, 简称NLP）是计算机科学与语言学中关注于计算机与人类语言间转换的领域，主要目标是让机器能够理解和生成自然语言，这样人们可以通过语言与计算机进行更自然的互动。 …...

编程日记 2025/9/8 14:19:04

Minio搭建并在SpringBoot中使用完成用户头像的上传

Minio使用搭建并上传用户头像到服务器操作,学习笔记 Minio介绍 minio官网 MinIO是一个开源的分布式对象存储服务器，支持S3协议并且可以在多节点上实现数据的高可用和容错。它采用Go语言开发，拥有轻量级、高性能、易部署等特点，并且可以自由…...

编程日记 2025/9/7 0:50:12

深入解析 Kubernetes CRD：原理、特点与典型应用场景

深入解析 Kubernetes CRD：原理、特点与典型应用场景一、CRD 的本质与原理 1.1 什么是 CRD？ CRD（Custom Resource Definition）是 Kubernetes 提供的核心扩展机制，允许用户自定义 API 资源类型。通过 CRD，开发者可以将业务逻辑抽象为 Kubernetes 原生资源模型，实现与…...

编程日记 2025/9/7 19:33:26

【新手入门】SQL注入之盲注

一、引言在我们的注入语句被带入数据库查询但却什么都没有返回的情况我们该怎么办? 例如应用程序返回到一个"通用的"的页面，或者重定向一个通用页面(可能为网站首页)。这时，我们之前学习的SQL注入的办法就无法使用了。这种情况我们称之为无…...

编程日记 2025/8/16 11:31:04

功能丰富的自动化任务软件zTasker_2.1.0_绿色版_屏蔽强制更新闪退

🚀 zTasker 一键式效率倍增器使用指南 🙏 致谢首先感谢开发者提供如此高效的工具！ 软件本身功能强大，但部分机制需特别注意！ 📖 软件概述 zTasker 是一款通过自动化脚本/任务流实现效率飞跃的生产力工…...

编程日记 2025/9/8 22:02:38

YOLOv11-ultralytics-8.3.67部分代码阅读笔记-model.py

model.py ultralytics\models\yolo\model.py 目录 model.py 1.所需的库和模块 2.class YOLO(Model): 3.class YOLOWorld(Model): 1.所需的库和模块 # Ultralytics 🚀 AGPL-3.0 License - https://ultralytics.com/licensefrom pathlib import Pathfrom ult…...

编程日记 2025/9/7 11:16:24

深入浅出 Go 语言：协程(Goroutine)详解

深入浅出 Go 语言：协程(Goroutine)详解引言 Go 语言的协程（goroutine）是其并发模型的核心特性之一。协程允许你轻松地编写并发代码，而不需要复杂的线程管理和锁机制。通过协程，你可以同时执行多个任务，并…...

编程日记 2025/9/7 16:13:33

【深度学习】Hopfield网络：模拟联想记忆

Hopfield网络是一种经典的循环神经网络，由物理学家John Hopfield在1982年提出。它的核心功能是模拟联想记忆，类似于人类大脑通过部分信息回忆完整记忆的能力。以下是通俗易懂的解释： 1. 核心思想想象你看到一张模糊的老照片，虽然…...

编程日记 2025/9/5 13:45:19

为什么深度学习选择Tensor而非NumPy数组？核心优势深度解析

简短总结： 支持 GPU 加速：Tensor 提供对 GPU 的原生支持，能够有效加速计算，而 NumPy 则通常只能在 CPU 上运行。支持自动求导：深度学习模型的训练依赖于参数的优化，而 Tensor 提供了自动求导功能&#xff…...

编程日记 2025/8/24 4:52:22

MongoDB—(一主、一从、一仲裁)副本集搭建

MongoDB集群介绍： MongoDB 副本集是由多个MongoDB实例组成的集群，其中包含一个主节点（Primary）和多个从节点（Secondary），用于提供数据冗余和高可用性。以下是搭建 MongoDB 副本集的详细步骤&am…...

编程日记 2025/9/1 16:19:47

【Leetcode 每日一题】132. 分割回文串 II

问题背景给你一个字符串 s s s，请你将 s s s 分割成一些子串，使每个子串都是回文串。返回符合要求的最少分割次数。数据约束 1 ≤ s . l e n g t h ≤ 2000 1 \le s.length \le 2000 1≤s.length≤2000 s s s 仅由小写英文字母组成解题过程 …...

编程日记 2025/9/4 9:49:50

面试常问的压力测试问题

性能测试作为软件开发中的关键环节，确保系统在高负载下仍能高效运行。压力测试作为性能测试的重要类型，旨在通过施加超出正常负载的压力，观察系统在极端条件下的表现。面试中，相关问题常被问及，包括定义、重要性、与负…...

编程日记 2025/9/8 4:54:32

信刻光盘安全隔离与信息交换系统让“数据摆渡”安全高效

随着数据传输、存储及信息技术的飞速发展，信息安全保护已成为重中之重。各安全领域对跨网数据交互的需求日益迫切，数据传输的安全可靠性成为不可忽视的关键。为满足业务需求并遵守保密规范，针对于涉及重要秘密信息，需做到安全的物…...

编程日记 2025/9/4 13:16:24

MySQL InnoDB 引擎中的聚簇索引和非聚簇索引有什么区别？

在 MySQL 的 InnoDB 存储引擎中，聚簇索引（Clustered Index）和非聚簇索引（Non-Clustered Index）是两种重要的索引类型，它们在数据存储结构、性能特点和适用场景上存在显著区别。以下是对它们的详细对比和解释…...

编程日记 2025/8/31 5:23:42

微信小程序开发学习笔记

微信小程序开发学习笔记一、基础结构项目结构配置文件（app.json） 二、常用组件视图组件表单组件导航组件三、API 常用功能网络请求数据缓存用户信息支付功能四、框架与工具框架开发者工具五、开发流程六、最佳实践七、常见问题路由跳转：权…...

编程日记 2025/9/9 11:45:47

动态规划刷题

文章目录动态规划三步问题题目解析代码动态规划 1. 状态表示：dp[i]，表示dp表中i下标位置的值 2. 状态转移方程：以i位置位置的状态，最近的一步来划分问题，比如可以将状态拆分成前状态来表示现状态，dp[i] …...

编程日记 2025/9/8 19:37:20

uniapp 系统学习，从入门到实战（七）—— 网络请求与数据交互

全篇大概 3600 字(含代码)，建议阅读时间 25min 📚 目录使用uni.request发起请求封装全局请求工具破解跨域难题总结在跨平台应用开发中，网络请求是连接前端与后端服务的核心环节。UniApp 提供了 uni.request 方法处理网络请求，但…...

编程日记 2025/9/7 16:07:17

AI人工智能机器学习之聚类分析

1、概要本篇学习AI人工智能机器学习之聚类分析，以KMeans、AgglomerativeClustering、DBSCAN为例，从代码层面讲述机器学习中的聚类分析。 2、聚类分析 - 简介聚类分析是一种无监督学习的方法，用于将数据集中的样本划分为不同的组&#xff…...

编程日记 2025/9/4 4:40:18

安当全栈式PostgreSQL数据库安全解决方案：透明加密、动态凭据与勒索防护一体化实践

引言：数字化转型下的数据库安全挑战随着PostgreSQL在企业核心业务中的广泛应用，其承载的敏感数据价值日益攀升。然而，近年来针对数据库的攻击事件频发，如SQL注入漏洞（CVE-2025-1094）、勒索病毒攻击、内部…...

编程日记 2025/9/7 7:37:35

进程的状态 ─── linux第11课

目录编辑补充知识: 1.并行和并发分时操作系统（Time-Sharing Systems） 实时操作系统（Real-Time Systems） 进程的状态(操作系统层面) 编辑运行状态阻塞状态状态总结: 挂起状态 linux下的进程状态补充知识: …...

编程日记 2025/9/7 23:01:34

DevOps原理和实现面试题及参考答案

解释 DevOps 的核心目标与文化价值观，如何理解 “CAMS” 模型？ DevOps 的核心目标是打破开发（Development）和运维（Operations）之间的壁垒，通过自动化、协作和持续反馈，实现软件的快速、可靠交付，以更好地满足业务需求和客户期望。具体来说，DevOps 旨在缩短软件的交付…...

编程日记 2025/9/7 1:39:32

牛客刷题自留-深度学习

1、当在卷积神经网络中加入池化层(pooling layer)时，平移变换的不变性会被保留，是吗？ 正常答案: C A 不知道 B 看情况 C 是 D 否平移变换不变性的概念平移变换不变性指的是当输入图像发生小范围的平移时，模型的输出结果不会发…...

编程日记 2025/9/8 20:05:09

网络空间安全（6）web应用程序技术

前言 Web应用程序技术是指用于开发和构建基于Web的应用程序的技术和工具，涵盖了前端开发、后端开发、数据库管理、安全性等多个方面的技术。一、前端开发技术 HTML/CSS/JavaScript：HTML用于构建网页结构，CSS用于进行样式设计，Jav…...

编程日记 2025/9/4 0:33:12

kubernetes 初学命令

基础命令 kubectl 运维命令常用： #查看pod创建过程以及相关日志 kubectl describe pod pod-command -n dev #查看某个pod，以yaml格式展示结果 kubectl get pod nginx -o yaml #查看pod 详情以及对应的集群IP地址 kubectl get pods -o wide 1. kubetc…...

编程日记 2025/9/9 6:34:37