MyBatis-详细映射器配置参考

最新推荐文章于 2022-01-26 17:57:38 发布
原创 最新推荐文章于 2022-01-26 17:57:38 发布 · 589 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY 版权协议，转载请附上原文出处链接和本声明。

本文详细解析了MyBatis框架中Mapper文件的结构与标签使用，包括缓存、结果映射、参数映射等核心功能，以及增删改查标签的属性与用法，帮助开发者深入了解MyBatis的配置机制。

mapper文件标签元素概览

常用一级二级标签概览

<mapper>
	<cache /> 缓存
	<cache-ref /> 缓存引用
	<resultMap /> 结果映射
	<parameterMap /> 参数映射
	<sql /> 可重用sql语句
	<insert /> 映射插入语句
	<update /> 映射更新语句
	<delete /> 映射删除语句
	<select /> 映射查询语句
</mapper>

mybatis.org/dtd/mybatis-3-mapper.dtd参考文档部分截取

<!ELEMENT mapper (cache-ref | cache | resultMap* | parameterMap* | sql* | insert* | update* | delete* | select* )+>
<!ATTLIST mapper
namespace CDATA #IMPLIED
>

增删改查标签介绍参考

DTD文档中的参考

  • select标签可选的属性参考
    <!ELEMENT select (#PCDATA | include | trim | where | set | foreach | choose | if | bind)*>  
<!ATTLIST select                                                                            
id CDATA #REQUIRED                                                                          
parameterMap CDATA #IMPLIED                                                                 
parameterType CDATA #IMPLIED                                                                
resultMap CDATA #IMPLIED                                                                    
resultType CDATA #IMPLIED                                                                   
resultSetType (FORWARD_ONLY | SCROLL_INSENSITIVE | SCROLL_SENSITIVE | DEFAULT) #IMPLIED     
statementType (STATEMENT|PREPARED|CALLABLE) #IMPLIED                                        
fetchSize CDATA #IMPLIED                                                                    
timeout CDATA #IMPLIED                                                                      
flushCache (true|false) #IMPLIED                                                            
useCache (true|false) #IMPLIED                                                              
databaseId CDATA #IMPLIED                                                                   
lang CDATA #IMPLIED                                                                         
resultOrdered (true|false) #IMPLIED                                                         
resultSets CDATA #IMPLIED                                                                   
>
  • insert标签可选的属性参考
    <!ELEMENT insert (#PCDATA | selectKey | include | trim | where | set | foreach | choose | if | bind)*>
<!ATTLIST insert                                                                                      
id CDATA #REQUIRED                                                                                    
parameterMap CDATA #IMPLIED                                                                           
parameterType CDATA #IMPLIED                                                                          
timeout CDATA #IMPLIED                                                                                
flushCache (true|false) #IMPLIED                                                                      
statementType (STATEMENT|PREPARED|CALLABLE) #IMPLIED                                                  
keyProperty CDATA #IMPLIED                                                                            
useGeneratedKeys (true|false) #IMPLIED                                                                
keyColumn CDATA #IMPLIED                                                                              
databaseId CDATA #IMPLIED                                                                             
lang CDATA #IMPLIED                                                                                   
>
  • update标签可选的属性参考
    <!ELEMENT update (#PCDATA | selectKey | include | trim | where | set | foreach | choose | if | bind)*> 
<!ATTLIST update                                                                                       
id CDATA #REQUIRED                                                                                     
parameterMap CDATA #IMPLIED                                                                            
parameterType CDATA #IMPLIED                                                                           
timeout CDATA #IMPLIED                                                                                 
flushCache (true|false) #IMPLIED                                                                       
statementType (STATEMENT|PREPARED|CALLABLE) #IMPLIED                                                   
keyProperty CDATA #IMPLIED                                                                             
useGeneratedKeys (true|false) #IMPLIED                                                                 
keyColumn CDATA #IMPLIED                                                                               
databaseId CDATA #IMPLIED                                                                              
lang CDATA #IMPLIED                                                                                    
>
  • delete标签可选属性参考
    <!ELEMENT delete (#PCDATA | include | trim | where | set | foreach | choose | if | bind)*> 
<!ATTLIST delete                                                                           
id CDATA #REQUIRED                                                                         
parameterMap CDATA #IMPLIED                                                                
parameterType CDATA #IMPLIED                                                               
timeout CDATA #IMPLIED                                                                     
flushCache (true|false) #IMPLIED                                                           
statementType (STATEMENT|PREPARED|CALLABLE) #IMPLIED                                       
databaseId CDATA #IMPLIED                                                                  
lang CDATA #IMPLIED                                                                        
>

增删改查中可选属性整合介绍参考

  • 全局id
    • id
      全局唯一标识符
      • 全局的含义,即在mapper文件的配置范围中.
  • 主键配置
    • keyProperty
      指定POJO中哪个属性是主键
      • 不能和标签属性keyColumn同时使用
    • keyColumn
      指定映射表中那个列作为主键
      • 不能和keyProperty同时使用
      • 只接受整型参数
    • useGeneratedKeys
      是否使用数据库内部生成的主键
      • 内部使用JDBC的getGeneratedKeys方法来获取
      • 默认值是false
      • 只针对insert和update语句有效
      • 一般配合keyProperty或keyColumn使用
  • 执行参数配置
    • parameterMap
      参数映射
      • 目前已废弃,不建议使用
    • parameterType
      标明参数类型
      • 可以是完全限定名也可以是别名
      • 可省略设置,容器会根据TypeHandler进行判断
  • 返回结果配置
    • resultMap
      返回结果类型映射
      • ibatis中功能最为强大的结果映射标签,使用率较高
      • 属性值即是外部标签resultMap规定的id值
      • resultType和resultMap不能同时使用
    • resultType
      标明返回结果类型
      • 可以是完全限定名,也可以是别名
      • 需要考虑返回结果类型有集合的情况
      • resultType和resultMap属性不能同时使用
    • resultSetType
      针对JDBC的ResultSet接口而言
      • 候选值FORWARD_ONLY,SCROLL_SENSITIVE,SCROLL_INSENSITIVE
      • 默认值unset
      • 实际场景,是由具体的数据库驱动厂商提供的
      • 仅作了解
    • resultSets
      是否列出多结果集的名称
      • 主要针对的是多结果集的情况
      • 若设置为true,则使用逗号分割列出多个结果集
      • 默认值设置为false
    • resultOrdered
      是否处理嵌套结果集
      • 针对的select语句
      • 默认值是false
    • fetchSize
      设置返回结果集的行数
      • 仅是尝试操作设置
      • 真实效用,依赖不同的驱动性能
  • 缓存配置
    • flushCache
      清空本地的所有缓存
      • 包含一级缓存和二级缓存
      • 默认值为false
    • useCache
      是否使用二级缓存
      • 针对的是sql语句的执行结果
      • 在select标签中,默认设置为true
  • 其他选项配置
    • timeout
      等待返回执行结果的时间
      • 具体情况效用,依赖具体的驱动
      • 默认值是unset
    • statementType
      指定使用JBDC的哪个Statement执行sql语句
      • 属性候选值有STATEMENT,PREPARED,CALLABLE
      • 对应的类对象是Statement,PreparedStatement,CallableStatement
      • 默认值是PREPARED
    • databaseId
      与全局配置中标签databaseIdProvider呼应
      • 单个数据库场景不建议配置使用
    • lang
      自定义语言
      • 可使用第三方语言
      • 使用率较少,一般不推荐使用

其他标签介绍参考

sql标签参考

  • sql标签的效用
    定义可重用的sql语句
    • 可以在任意地方引用
    • 可以是部分sql语句,也可以是全部
    • 减少映射配置的工作量,和代码的冗余度
  • DTD文档中sql规定参考
    <!ELEMENT sql (#PCDATA | include | trim | where | set | foreach | choose | if | bind)*>
<!ATTLIST sql
id CDATA #REQUIRED
lang CDATA #IMPLIED
databaseId CDATA #IMPLIED
>
  • sql标签部分说明
    • 可选属性参考
      • id
        全局唯一标识id
        • 所谓的全局,针对的是mapper文件的作用范围
      • lang
        自定义语言
        • 可使用第三方语言
        • 使用率较少,一般不推荐使用
      • databaseId
        与全局配置中标签databaseIdProvider呼应
        • 单个数据库场景不建议配置使用

parameterMap标签参考

此标签已废弃,将来可能会被移除,不建议使用和了解.

resultMap标签参考

  • resultMap标签说明
    • ibatis中功能最为强大的标签
    • 可以处理任意复杂的返回结果映射
    • 可轻松处理一对多,多对一,多对多复杂结果映射
    • 是ibatis中半自动化ORM最为核心的功能体现
  • DTD文档中resultMap规定参考
    <!ELEMENT resultMap (constructor?,id*,result*,association*,collection*, discriminator?)>
<!ATTLIST resultMap
id CDATA #REQUIRED
type CDATA #REQUIRED
extends CDATA #IMPLIED
autoMapping (true|false) #IMPLIED
>
  • resultMap标签部分说明
    • 可选属性参考
      • id
        全局唯一标识id
        • 主要为了标识区别resultMap
      • type
        指定返回结果的映射包装类型
        • 可以是完全限定名,也可以是别名
      • extend
        此结果映射继承全局存在的其他结果映射配置
      • autowiredMapping
        是否开启自动映射
        • 表示ibatis会覆盖全局配置属性autoMappingBehavior
        • 效用主要是针对此标签的resultMap
        • 默认值为unset
    • 可选子标签参考
      • constructor
        用来手动配置构造方法,来实例化一个POJO类对象
        • 应用场景为,映射结果的POJO类对象不存在无参的构造器
      • id
        用来标记映射结果中的主键,配对属性和列名
      • result
        用来标记映射结果中非主键,配对属性和列名
      • association
        处理一对一级联关系映射
      • collection
        处理一对多级联关系映射
      • discriminator
        鉴别器
        • 决定返回结果使用哪个resultMap

cache标签参考

  • DTD文档中规定参考
    <!ELEMENT cache (property*)>
<!ATTLIST cache
type CDATA #IMPLIED
eviction CDATA #IMPLIED
flushInterval CDATA #IMPLIED
size CDATA #IMPLIED
readOnly CDATA #IMPLIED
blocking CDATA #IMPLIED
>
  • cache标签部分说明
    • 可选属性参考
      • type
        指定自定义缓存配置的类对象的完全限定名
      • eviction : 英 /ɪ'vɪkʃ(ə)n/
        配置缓存收回策略
        默认值是LRU
        候选收回策略有:
        • LRU : 最近最少使用的:移除最长时间不被使用的对象
        • FIFO : 先进先出:按对象进入缓存的顺序来移除它们
        • SOFT : 软引用:移除基于垃圾回收器状态和软引用规则的对象
        • WEAK : 弱引用:更积极地移除基于垃圾收集器状态和弱引用规则的对象
      • flushInterval
        定期刷新缓存的时间
        • 默认是不设置的
        • 设置的单位是毫秒/ms
        • 合法的属性值是任意正整数
      • size
        缓存中,设置引用对象的数目
        • 注意应用内存中可存储的资源对象数目,设置值不应大于其值
        • 默认值是1024
      • readOnly
        设置缓存是否只读
        • 默认值是false

cache-ref标签参考

  • cache-ref标签说明
    引用其他mapper文件中的缓存配置
  • DTD文档中规定参考
    <!ELEMENT cache-ref EMPTY>
<!ATTLIST cache-ref
namespace CDATA #REQUIRED
>
  • 可选属性参考
    • namespace
      其他mapper文件的命名空间值
Mybatis-Plus代码生成器配置
fanjunf的博客
03-04 951
Mybatis-Plus代码生成器
Mybatis框架——使用案例详细教程(mybatis-spring-boot-starter依赖)
weixin_44814196的博客
08-14 2073
Mybatis框架使用案例详细教程, 利用 mybatis-spring-boot-starter 依赖来查询数据库
MyBatis配置之映射器
你今天真好看呀
10-17 451
文章目录方式1【推荐使用】方式2方式3 方式1【推荐使用】 <!--每一个Mapper.xml都需要在MyBatis核心配置文件中注册--> <mappers> <mapper resource="com/kuang/dao/UserMapper.xml"/> </mappers> 方式2 使用class文件绑定注册： <mappers...
Mybatis学习-映射器配置
theLuckyLong的博客
01-10 290
在Mybatis中，Dao层又被叫做Mapper层，当我们编写Dao层的接口时，会同时编写一个同名的.xml配置文件，举个例子： 首先编写一个UserMapper接口 package com.yyl.dao; import com.yyl.pojo.User; import java.util.List; import java.util.Map; /** * @Author: LongLongA * @Description: * @Date: Created in 16:13 2020/
MyBatis注解配置映射器：动态SQL的实现
08-22
java工程，练习通过MyBatis注解的方式配置SQL映射器，实现动态SQL.
MyBatis 映射器
mySoul
04-17 808
ps 一个用于生成MyBatis配置文件的插件 mybatis-generator 使用方法呢, 是加入maven插件中 然后执行相关命令可以实现自动生成MyBatis配置文件 自动映射 首先编写无参的javabean package com.ming.MyBatis.POJO; /** * @author ming */ public class Role { private ...
Java Persistence with MyBatis 3(中文版) 第三章 使用XML配置SQL映射器
yunzhonmghe的博客
09-24 500
关系型数据库和SQL是经受时间考验和验证的数据存储机制。和其他的ORM 框架如Hibernate不同，MyBatis鼓励开发者可以直接使用数据库，而不是将其对开发者隐藏，因为这样可以充分发挥数据库服务器所提供的SQL语句的巨大威力。与此同时，MyBaits消除了书写大量冗余代码的痛苦，它使使用SQL更容易。     在代码里直接嵌套SQL语句是很差的编码实践，并且维护起来困难。MyBaits
基于MyBatis-Plus的Java MyBatis-Plus Samples设计源码
09-25
XML配置文件则用于配置MyBatis的映射关系；YAML文件多用于配置Spring Boot应用的一些启动参数；属性文件一般存放项目的基础配置信息；Markdown文件可用来编写项目的文档说明；Git忽略文件则用于指定在使用Git版本...
MyBatis-Plus使用
最新发布
07-10
MyBatis-Plus 的使用涉及到多个层面，从基本配置到进阶功能，每一步都有详细的文档和指南可供参考。它不仅提供了丰富的官方文档，还有活跃的社区支持和丰富的插件生态。开发者在使用 MyBatis-Plus 进行项目开发时，...
mybatis-3.4.1-all & mybatis-spring-1.3.0
10-27
对于开发者来说，这是一份非常重要的参考资料，可以帮助理解和掌握 MyBatis 的各种功能和配置。 至于"mybatis-3.4.1"这个文件，可能是其他相关资源，比如示例代码、配置文件或者测试数据。这些内容可能帮助开发者...
深入浅出MyBatis：「映射器」全了解
weixin_34204057的博客
03-27 205
本篇文章是「深入浅出MyBatis：技术原理与实践」书籍的总结笔记。 上一篇总结了MyBatis的配置，详细说明了各个配置项，其中提到了映射器，它是MyBatis最强大的工具，也是使用最多的工具。 通过映射器，可以很容易的进行数据的增删改查操作，我们抽象下进行这些操作的关键点：传递查询参数、组装各种场景下的查询条件、关联查询、将查询结果映射为Java Bean对象或集合等。另外，可以通过延迟加...
Mybatis配置中映射器
m0_46569959的博客
01-26 292
Mybatis映射器 mappers 方式一：resource <!-- 配置文件的注册--> <mappers> <mapper resource="cn/momo/dao/UserDaoMapper.xml"/> </mappers> 注意： 名称是一个路径，因为不在包里，所以 不能使用 点。 举例：<mapper resource="cn.momo.dao.UserDaoMapper.xml"/>
mybatis映射器文件配置
荒野孤鹰
12-03 746
所谓的映射器可以理解为前面配置的mapper.xml文件,在这个文件中我们通过namespace将配置和指定的Dao层接口关联起来,准确的来说是为每个Dao层接口中的方法配置具体的sql语句;另外mapper文件中还可以为查询语句灵活的配置返回结果对象(javaBean),根据需要构建动态sql等功能。在映射器中可以定义的元素有select insert delete update等代表具体sql操
MyBatis学习笔记：映射器简述和配置
sinat_38393872的博客
10-23 328
这片文章是对自己学习的总结，学习材料是Java EE互联网轻量级框架整合开发 SSM框架（Spring MVC + Spring + Mybatis）和Redis实现。作者是杨开振，周吉文，梁华辉和谭茂华。电子工业出版社出版。 映射器简述 传统web开发是先定一个持久层的接口，比如 public interface UserDao{...} 然后用一个类去实现它 public ...
SSM-Mybatis-映射器-参数
weixin_43958223的博客
03-02 173
SSM-Mybatis-映射器-参数 概述 ​ 在一些数据库字段返回为null，而Mybatis系统又检测不到使用哪种jdbcType进行处理时，会发生异常的情况，这时候执行对应的typeHandler进行处理： insert into t_role(id,role_name,note) values(#{id},#{roleName,typeHandler=org.apache.ibatis.type.StringTypeHandler},#{note}) ​ 实际情况下不需要这样写，Mybatis会根
mybatis 映射器
baidu_38558076的博客
04-11 318
mybatis 提供4种方式的映射器，如下图 <!-- 使用相对于类路径的资源引用 --> <mappers> <mapper resource="org/mybatis/builder/AuthorMapper.xml"/> <mapper resource="org/mybatis/builder/BlogMapper.xml"/> ...
mybatis映射器
u010321349的博客
07-09 410
Mybatis支持自动绑定JavaBean,只要让SQL返回的字段名和JavaBean的属性名保持一致(或者采用驼峰式命名),便可以省掉这些繁琐的映射配置.4.2 select元素 4.2.3自动映射          autoMappingBehavior属性: NULL:取消自动映射  PARTIAL:只会自动映射,没有定义嵌套结果集映射的结果集.                 FULL:会...
MyBatis(3) 映射器的简单使用
郑清
12-13 563
Mybatis映射器 :(作用：可以不用再写dao层实现类) 注意：之前的IUserDao --> 现在改名为UserMapper名哦~ 名称统一以Mapper结尾 bean类： public class User { private Long id; private String username; private String password;...
Mybatis（二）mapper映射文件之标签
fox_bert的博客
05-28 1162
一、基本介绍 mapper.xml文件是mybatis中的主要模块，它可以灵活的配置你需要执行的sql 我们先来看一下一些常见的配置规则 映射文件是以<mapper>作为根节点：<mapper namespace=" ">：一个namespace作用于一个dao文件 在根节点中支持9个元素，分别为：insert、update、delete、select（增删改查）;...
Mybatis-Generator模板增强与Mybatis-Paginator集成指南
MyBatis Generator 是一个用于快速生成 MyBatis 的 Mapper、XML、Java Model 的代码生成器。它能根据数据库表结构自动创建相应的 Java 实体类、Mapper 接口以及 XML 映射文件。开发者通过简单的配置即可实现高效的...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值