0

0

Mybatis的XML文件怎么配置 Mybatis映射文件标签详解

煙雲

煙雲

发布时间:2026-01-08 11:55:10

|

600人浏览过

|

来源于php中文网

原创

MyBatis XML配置分为mybatis-config.xml(须严格按properties→settings→typeAliases→environments→mappers顺序)和Mapper XML(以namespace绑定接口,含select/insert/update/delete/resultMap等核心标签)。

mybatis的xml文件怎么配置 mybatis映射文件标签详解

MyBatis 的 XML 配置分两类:全局配置文件 mybatis-config.xml 和 SQL 映射文件(如 UserMapper.xml)。前者管连接、缓存、别名等基础设置;后者专注 SQL 编写与结果映射,两者配合才能让 DAO 接口正常工作。

mybatis-config.xml 必须遵守的结构顺序

这个文件是 MyBatis 启动时加载的根配置,所有标签必须严格按以下顺序书写,否则会解析失败:

  • properties:外部属性引入(如数据库配置),支持 resource(类路径)或 url(绝对路径),也支持内联
  • settings:全局开关控制,比如 lazyLoadingEnabled="true" 开启延迟加载cacheEnabled="true" 启用二级缓存
  • typeAliases:简化实体类引用,可用 ,更常用的是 批量注册
  • environments:定义数据源环境,default="dev" 指定默认激活环境,每个 内需包含
  • mappers:注册映射文件,支持 (要求 XML 与接口同包同名)

Mapper XML 文件的核心标签

每个映射文件以 开头,namespace 必须和对应接口全限定名一致,这是方法绑定的基础。

椒图AI
椒图AI

中文AI修图神器,一句话搞定复杂修图

下载
  • :执行查询,id 对应接口方法名,resultType 用于字段名与属性名完全匹配的简单映射;若不一致或需嵌套对象,改用 resultMap 引用外部定义
  • :插入语句,设 useGeneratedKeys="true" keyProperty="id" 可自动回填数据库自增主键到参数对象
  • :结构类似,只需写 SQL 和匹配 id,无返回值要求
  • :定义可复用的 SQL 片段,用 引入,避免重复写 WHERE 或字段列表
  • :复杂结果映射核心,支持 (主键)、(普通字段)、(一对一)、(一对多)

常见易错点和实用技巧

实际配置中几个关键细节容易被忽略,但直接影响运行效果:

  • XML 文件开头的 DTD 声明不能省略或写错,例如:
  • properties 中定义的变量,可在 environments 里用 ${username} 引用;若内外同名,外部文件优先
  • 使用 批量注册 mapper 时,确保 XML 文件放在 classpath 对应路径下,且文件名与接口名一致(如 UserMapper.javaUserMapper.xml
  • 动态 SQL 标签()只能出现在 / 等语句内部,不能直接放在

一个最小可用的 UserMapper.xml 示例

结合实际场景更易理解:




  
    
    
  

  

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

829

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

733

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

733

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

396

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16925

2023.08.03

Golang 分布式缓存与高可用架构
Golang 分布式缓存与高可用架构

本专题系统讲解 Golang 在分布式缓存与高可用系统中的应用,涵盖缓存设计原理、Redis/Etcd集成、数据一致性与过期策略、分布式锁、缓存穿透/雪崩/击穿解决方案,以及高可用架构设计。通过实战案例,帮助开发者掌握 如何使用 Go 构建稳定、高性能的分布式缓存系统,提升大型系统的响应速度与可靠性。

26

2026.01.09

热门下载

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

精品课程

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

共23课时 | 2.4万人学习

C# 教程
C# 教程

共94课时 | 6.3万人学习

Java 教程
Java 教程

共578课时 | 43.7万人学习

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

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