2套表方案、6个配置点MyBatis多语言支持i18n快速指南【免费下载链接】mybatis-3MyBatis SQL mapper framework for Java项目地址: https://gitcode.com/gh_mirrors/my/mybatis-3同一张商品表中文用户看到苹果法国用户看到的还是Apple。语言字段没设计好商品页就毁了。这篇文章解决一件事用 MyBatis 做多语言支持——数据怎么存、SQL 怎么按语言切换、环境怎么隔离、缓存怎么不串。方案速览先看结论30秒定位你的选择维度单表多列翻译子表推荐场景语言≤5种只译 name/description 这类少数字段语言≥6种或译文由运营持续补充查询成本一条 SQL无 JOIN必须按 lang 关联或二次查询新增语言ALTER TABLE发版才能上只 INSERT 数据随时加存储每行存全量语言空位浪费存实际有的译文写入一次 UPDATE 改多列只改一行一句话建议语言少、字段少选单表多列语言多、会持续增长选翻译子表。数据层表怎么建单表多列每种语言一组固定列这段建表 SQL 演示单表多列布局每种语言各占一组列CREATE TABLE product ( id BIGINT PRIMARY KEY, price DECIMAL(10,2), name_en VARCHAR(120), name_fr VARCHAR(120), name_ja VARCHAR(120), description_en TEXT, description_fr TEXT, description_ja TEXT );查询最简单不用 JOIN。边界也很清楚每加一种语言、每个字段都多一列加德语得先跑 DDL语言多了表又宽又难维护。翻译子表新增语言只插数据下面是翻译子表布局用 (product_id, lang) 做联合主键保证同一语言不会存两条CREATE TABLE product ( id BIGINT PRIMARY KEY, price DECIMAL(10,2) ); CREATE TABLE product_translation ( product_id BIGINT, lang CHAR(5) NOT NULL, name VARCHAR(120), description TEXT, PRIMARY KEY (product_id, lang) );为什么扩展更省事加西班牙语只是 INSERT 一批行不碰表结构还能单独给 lang 建索引。代价是所有查询都要带上 lang 条件。访问层SQL怎么按语言切换 动态SQL${lang} 切换列名但必须白名单${}是字符串直接替换能拼列名但语言码不能裸奔进 SQL。这段先展示按语言切列的写法select idfindProduct resultTypeProduct SELECT id, price, name_${lang} AS name, description_${lang} AS description FROM product WHERE id #{id} /select风险点直说lang en WHERE 11 --这样的入参会直接改写 SQL。规避办法只有一条——在 Java 侧做白名单校验只放行en/fr/ja这类固定值再进入 SQL。#{id}是预编译占位符天然安全两种用法不要混。不想让任何语言码进 SQL可以改用choose写死每个分支choose when testlang janame_ja AS name/when when testlang frname_fr AS name/when otherwisename_en AS name/otherwise /choose这段把每种语言写成字面量安全性最高缺点是新增语言要改 XML。取舍语言稳定选choose语言可能变选白名单 ${lang}。注解方式SelectProvider 动态拼 SQL不喜欢 XML 的话用注解在接口上挂 SQL ProviderJava 里拼串。这段示例同时演示了白名单public class ProductSqlProvider { private static final SetString LANGS Set.of(en, fr, ja); public String byLang(Param(id) Long id, Param(lang) String lang) { if (!LANGS.contains(lang)) { throw new IllegalArgumentException(unsupported lang: lang); } return SELECT id, price, name_ lang AS name FROM product WHERE id #{id}; } } public interface ProductMapper { SelectProvider(type ProductSqlProvider.class, method byLang) Product byLang(Param(id) Long id, Param(lang) String lang); }注意 MyBatis 的 Provider 方法里#{}仍会被解析成预编译参数只有你手动拼进去的片段是裸替换所以拼列名没问题拼值不行。配置层环境怎么隔离多环境 environments properties 占位符各语言版本部署到不同库、或连接参数随环境变时把值外置到 properties 文件XML 里只用${}占位properties resourcedb.properties/ environments defaultprod environment idprod transactionManager typeJDBC/ dataSource typePOOLED property namedriver value${driver}/ property nameurl value${url}/ /dataSource /environment /environments有个容易踩的点一个 SqlSessionFactory 只能生效一个环境用default属性或代码里的第三个参数选SqlSessionFactory f new SqlSessionFactoryBuilder().build(is, props, prod);自定义 TypeHandler 统一语言相关格式MyBatis 用 TypeHandler 做 Java 类型与 JDBC 类型互转。如果不同语言要求不同的日期、数字格式继承 BaseTypeHandler 自己写一个。这段演示按 Locale 格式化日期public class LocaleDateTypeHandler extends BaseTypeHandlerLocalDate { private final Locale locale; public LocaleDateTypeHandler(Locale locale) { this.locale locale; } Override public void setNonNullParameter(PreparedStatement ps, int i, LocalDate param, JdbcType jdbcType) throws SQLException { ps.setString(i, param.format(DateTimeFormatter.ofLocalizedDate( FormatStyle.SHORT).withLocale(locale))); } }两个注意点XML 里typeHandler handler.../只会调无参构造要传 Locale 就得在代码里注册configuration.getTypeHandlerRegistry().register(LocalDate.class, new LocaleDateTypeHandler(locale))。内置 TypeHandler 清单可以看 org/apache/ibatis/type/ 目录基类是 BaseTypeHandler.java。进阶性能与避坑 ⚠️缓存key必须包含语言参数MyBatis 一级缓存的 CacheKey 由 statement id、RowBounds 和参数对象共同构成所以只要 lang 作为查询参数传进来findProduct(1, en)和findProduct(1, fr)的 key 天然不同。真正的坑是lang 只出现在${}拼出的 SQL 文本里、没进参数列表——这时两次查询共用一个缓存项法语用户直接读到英文译文。自查方法确认语言码在方法签名参数里。延迟加载多语言数据只需要价格时别把 10 种语言的译文全拉回来。用 association 的 select 属性 fetchTypelazy访问 translation 属性时才触发子查询resultMap idproductMap typeProduct id propertyid columnid/ result propertyprice columnprice/ association propertytranslation columnid selectProductMapper.findTranslation fetchTypelazy/ /resultMap select idfindTranslation resultTypeProductTranslation SELECT name, description FROM product_translation WHERE product_id #{productId} AND lang #{lang} /select常见坑清单硬编码语言码SQL 里写死name_fr新增语言时永远漏改。统一收敛到${lang}或choose。新增语言忘改 SQL白名单 Set、choose分支、列定义三处要同步建议加个集成测试跑一遍所有语言码。缓存串扰见上一节lang 必须进参数。译文缺失无兜底子表方案下某语言可能没译文要么 lang 查询带 fallback 到默认语言要么前端做空值处理别让 null 直接上屏。结语选型一句话语言≤5种用单表多列否则翻译子表。更多细节看官方文档 configuration.md 和 dynamic-sql.md。【免费下载链接】mybatis-3MyBatis SQL mapper framework for Java项目地址: https://gitcode.com/gh_mirrors/my/mybatis-3创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
企业数字化 ERP 产品动态
相关推荐
WuWa-Mod 完整指南:5 步装好鸣潮技能无冷却与无限体力模组 WuWa-Mod 完整指南:5 步装好鸣潮技能无冷却与无限体力模组 【免费下载链接】wuwa-mod Wuthering Waves pak mods 项目地址: https://gitcode.com/GitHub_Trending/wu/wuwa-mod
技能冷却让你反复干等、体力条总在跑图时见底?WuWa-Mod 是一套鸣潮&a… · 2026/11/19 5:58:28
如何完整备份QQ空间全部历史:GetQzonehistory QQ空间数据导出工具上手指南 如何完整备份QQ空间全部历史:GetQzonehistory QQ空间数据导出工具上手指南 【免费下载链接】GetQzonehistory 获取QQ空间发布的历史说说 项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
想把QQ空间里发过的每一条说说、收到的每一条留言… · 2026/11/11 8:55:46
HandBrake 色彩平滑滤镜:5 分钟调好参数,视频摩尔纹说消就消 HandBrake 色彩平滑滤镜:5 分钟调好参数,视频摩尔纹说消就消 【免费下载链接】HandBrake HandBrakes development repository 项目地址: https://gitcode.com/gh_mirrors/ha/HandBrake
用 HandBrake 做转码的人都知道它滤镜多,但真正… · 2026/11/7 17:59:49
台山电工证需要多少钱 郑州报考避坑指南 台山电工证需要多少钱 郑州报考避坑指南 你是不是也和我一样,刚进工地,手上啥证都没有,看着别人拿着电工证、焊工证在工地上干得风生水起,心里痒痒的?别急,这正是你行动的时候。 急需特种作业证才能上岗找工作… · 2026/11/19 5:58:22
西安那考电工证好些?考前押题攻略来了,上岗必备 西安那考电工证好些?考前押题攻略来了,上岗必备 你是不是正被“没有电工证,连面试资格都没有”的说法压得喘不过气?是不是为了找工作四处奔波,却发现“西安那考电工证好些”成了你最迫切的需求?别慌,这期内容直接给你讲明白电工证怎么考、怎么复习、怎… · 2026/11/19 5:58:22
上海电工证哪里复审,官方报名入口你知道怎么走吗? 上海电工证哪里复审,官方报名入口你知道怎么走吗? 之前考的证在外省能不能转过来?这几乎是所有外地电工证持有者最关心的问题。在上海工作、生活的人越来越多,但很多人考的电工证却是在其他省市,尤其是河南、山东、安徽等地, 复审 和 继续教育… · 2026/11/19 5:58:22
朱泾电工证审证地址在哪儿?含金量高的电工证怎么考 朱泾电工证审证地址在哪儿?含金量高的电工证怎么考 你是不是正愁不知道去哪儿报名电工证?怕被中介骗钱、怕走弯路、怕证书没含金量?别急,今天咱们就来聊聊【朱泾电工证审证地址】到底在哪儿,还有含金量高的电工证怎么考,怎么避坑。… · 2026/11/19 5:58:22
上海电工证哪里复审官方回应怎么找 上海电工证哪里复审官方回应怎么找 你是不是也在为【上海电工证哪里复审】发愁?不知道该去哪个机构报名、怕被中介坑、怕走弯路?别急,官方回应来了,今天我就来帮你把流程说清楚,避坑指南也给你安排上,看完你就能自己搞定。… · 2026/11/19 5:58:22
新乡电工证考试题在哪考?电工证实操考什么全解析 新乡电工证考试题在哪考?电工证实操考什么全解析 找工作前必须拿到电工证,否则连面试资格都没有。现在新乡电工证考试题在哪考成了很多人的头等大事,尤其是想进工地、工厂、电力公司等岗位的求职者。电工证不仅是从业门槛,更是职业发展的“敲门砖”。如果… · 2026/11/19 5:57:22
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/18 8:19:55
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/18 8:19:53
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/18 14:38:14
姑苏区哪里考电工证好考前押题怎么找 姑苏区哪里考电工证好考前押题怎么找 工地太忙根本没时间复习考试,电工证考前还总找不到靠谱的 考前押题 资源,真让人头疼。如果你也是在苏州姑苏区从事建筑或电力行业的,那这些建议你一定要看完。 为什么姑苏区考电工证的人这么多?… · 2026/11/19 0:00:12
罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 之前考的证在外省能不能转过来?这几乎是每个特种作业证书持有者都会遇到的问题,特别是像你这样已经在外地工作多年,想回老家罗定发展或者重新规划职业路径的人。别急,今天就给你一条清晰的路… · 2026/11/19 0:00:12
罗定能考电工证吗 电工证含金量到底有多少? 罗定能考电工证吗 电工证含金量到底有多少? 之前考的证在外省能不能转过来,这几乎是每个准备考电工证的朋友最先想到的问题。特别是在罗定这样的地方,很多人的电工证都是在外地考的,现在想在当地继续使用,但不知道怎么办。实际上,电工证的 含金量… · 2026/11/19 0:00:12
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/17 21:47:42
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/17 21:47:42
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38