JDBI 中如何为特定字段注册自定义列映射器
2025-07-05 10:48:28作者:温艾琴Wonderful
在数据库开发中,我们经常会遇到需要将数据库中的原始数据类型转换为应用程序中更合适的类型的情况。JDBI 作为一个强大的 Java 数据库访问工具,提供了灵活的列映射机制来实现这种转换。本文将介绍如何在 JDBI 中为特定字段注册自定义列映射器,而不是全局注册。
问题背景
假设我们有一个数据库表,其中某个字段以逗号分隔的字符串形式存储了一个字符串列表(TEXT 类型),而不是使用 SQL 数组类型。我们需要将这个字段从 String 类型映射到 List<String> 类型。如果简单地创建一个全局的 ColumnMapper<List<String>>,它会应用于所有 List<String> 类型的字段,这显然不是我们想要的结果。
解决方案:使用限定类型
JDBI 提供了"限定类型"(Qualified Types)的功能,允许我们为特定字段注册自定义的列映射器。以下是实现步骤:
1. 创建自定义注解
首先,我们需要定义一个注解来标记需要特殊处理的字段:
import java.lang.annotation.*;
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface CommaSeparatedList {
}
2. 实现列映射器工厂
接下来,我们创建一个列映射器工厂,它将为带有我们自定义注解的字段提供特定的映射器:
import org.jdbi.v3.core.mapper.ColumnMapper;
import org.jdbi.v3.core.mapper.ColumnMapperFactory;
public class CommaSeparatedListMapperFactory implements ColumnMapperFactory {
@Override
public ColumnMapper<?> build(Type type, ConfigRegistry config) {
if (type instanceof ParameterizedType) {
ParameterizedType pt = (ParameterizedType) type;
if (pt.getRawType() == List.class
&& pt.getActualTypeArguments()[0] == String.class) {
return (rs, col, ctx) ->
Arrays.asList(rs.getString(col).split(","));
}
}
return null;
}
}
3. 注册映射器工厂
在使用 JDBI 时,我们需要注册这个工厂:
jdbi.registerColumnMapper(new CommaSeparatedListMapperFactory());
4. 在数据类中使用
最后,在我们的数据类中,我们可以这样使用:
public class User {
@CommaSeparatedList
private List<String> emails;
// 其他字段和getter/setter
}
高级用法:更精确的控制
如果需要更精确的控制,我们可以结合 JDBI 的 @MapWith 注解和限定类型来实现:
- 首先定义一个更具体的列映射器:
public class CommaSeparatedListMapper implements ColumnMapper<List<String>> {
@Override
public List<String> map(ResultSet rs, int columnNumber, StatementContext ctx) {
String value = rs.getString(columnNumber);
return Arrays.asList(value.split(","));
}
}
- 然后在数据类中使用:
public class User {
@MapWith(CommaSeparatedListMapper.class)
private List<String> emails;
}
总结
通过使用 JDBI 的限定类型功能,我们可以为特定字段注册自定义的列映射器,而不影响其他同类型的字段。这种方法特别适用于处理数据库中的非标准数据格式,或者需要特殊转换逻辑的字段。相比全局注册映射器,这种方式更加灵活和安全,避免了意外影响其他字段的风险。
在实际应用中,开发者可以根据具体需求选择简单注解方式还是更复杂的工厂模式,JDBI 提供了足够的灵活性来满足各种场景的需求。
登录后查看全文
热门项目推荐
相关项目推荐
Kimi-K2.5Kimi K2.5 是一款开源的原生多模态智能体模型,它在 Kimi-K2-Base 的基础上,通过对约 15 万亿混合视觉和文本 tokens 进行持续预训练构建而成。该模型将视觉与语言理解、高级智能体能力、即时模式与思考模式,以及对话式与智能体范式无缝融合。Python00
PaddleOCR-VL-1.5PaddleOCR-VL-1.5 是 PaddleOCR-VL 的新一代进阶模型,在 OmniDocBench v1.5 上实现了 94.5% 的全新 state-of-the-art 准确率。 为了严格评估模型在真实物理畸变下的鲁棒性——包括扫描伪影、倾斜、扭曲、屏幕拍摄和光照变化——我们提出了 Real5-OmniDocBench 基准测试集。实验结果表明,该增强模型在新构建的基准测试集上达到了 SOTA 性能。此外,我们通过整合印章识别和文本检测识别(text spotting)任务扩展了模型的能力,同时保持 0.9B 的超紧凑 VLM 规模,具备高效率特性。Python00
xw-cli实现国产算力大模型零门槛部署,一键跑通 Qwen、GLM-4.7、Minimax-2.1、DeepSeek-OCR 等模型Go06
yuanrongopenYuanrong runtime:openYuanrong 多语言运行时提供函数分布式编程,支持 Python、Java、C++ 语言,实现类单机编程高性能分布式运行。Go051
pc-uishopTNT开源商城系统使用java语言开发,基于SpringBoot架构体系构建的一套b2b2c商城,商城是满足集平台自营和多商户入驻于一体的多商户运营服务系统。包含PC 端、手机端(H5\APP\小程序),系统架构以及实现案例中应满足和未来可能出现的业务系统进行对接。Vue00
ebook-to-mindmapepub、pdf 拆书 AI 总结TSX01
项目优选
收起
deepin linux kernel
C
27
11
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
540
3.77 K
Ascend Extension for PyTorch
Python
351
417
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
889
614
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
338
185
openJiuwen agent-studio提供零码、低码可视化开发和工作流编排,模型、知识库、插件等各资源管理能力
TSX
988
253
openGauss kernel ~ openGauss is an open source relational database management system
C++
169
233
暂无简介
Dart
778
193
华为昇腾面向大规模分布式训练的多模态大模型套件,支撑多模态生成、多模态理解。
Python
115
141
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.35 K
758