Mybatis

miku · 发表于 2025-3-21 02:09:38

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要登录才可以下载或查看，没有账号？立即注册

x

Mybatis官方地址以及相关文件

Mybatis下载地址https://github.com/mybatis/mybatis-3

Mybatis文档地址https://mybatis.org/mybatis-3/

Maven(依赖)

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.10</version>
</dependency>

mybatis-config.xml文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
  <!-- 配置连接数据库的环境 -->
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/tbatis"/>
        <property name="username" value="root"/>
        <property name="password" value="xxxxxx"/>
      </dataSource>
    </environment>
  </environments>
  <!-- 引入映射配置文件 -->
  <mappers>
    <!-- 此处注意IDEA创建Resources目录下的文件夹要以com/wcmr/...的方式 -->
    <!-- com.wcmr....的方式只是一个目录不是多个目录。所以会造成找不到问题 -->
    <mapper resource="mapper/UserMapper.xml"/>
  </mappers>
</configuration>

UserMapper.java文件

public interface UserMapper {
    // 根据id查询用户所有信息
    User selectUserById(int id);
}

Mybatis面向接口编程

映射文件的namespace要和mapper接口的全类名保持一致
映射文件中SQL语句的id(select id="")要和mapper接口中的方法名保持一致

返回结果Result类型

ResultType：设置默认的映射关系
ResultMap：设置自定义的映射关系

public class BaseTest {
 @Test
public void testTbatis() throws IOException {
    // 加载核心配置文件
    InputStream inputStream = getResourceAsStream("mybatis-config.xml");
    // 获取SqlSessionFactoryBuilder
    SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
    // 获取SqlSessionFactory
    SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
    // 获取SqlSession
    SqlSession sqlSession = sqlSessionFactory.openSession();
    // 获取mapper接口对象
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    // 调用UserMapper的实现方法
    User user = mapper.selectById(1);
    // 打印查询内容
    System.out.println(user.toString());
    }
}

SqlSession：代表Java程序和数据库之间的会话(HttpSession是Java程序和浏览器之间的会话)
SqlSessionFactory：是"生产"SqlSession的"工厂"
SqlSession默认不提交事务(openSession(false))

Mybatis核心配置文件中,标签的顺序

<configuration>:
  <!--标签顺序为: -->
  <properties>
  <settings>
  <typeAliases>
  <typeHandlers>
  <objectFactory>
  <objectWrapperFactory>
  <reflectorFactory>
  <plugins>
  <environments>
  <databaseIdProvider>
  <mappers>

Mybatis-config.xml标签解释

configuration:
  # <configuration>
  properties:
    # <properties/> 引入properties文件
    # resource: 配置文件路径
  settings:
    # <settings>
    setting:
      # <setting/>
      # name
      # value
  typeAliases:
    # <typeAliases> 设置类型别名
    typeAlias:
      # <typeAlias /> 设置某个类型的别名
      # type：设置需要设置别名的类型
      # alias: 设置某个类型的别名,若不设施该属性,那么该类型拥有默认的别名,即类名且不区分大小写
    package:
      # <package/> 以包为单位,将包下所有的类型设置默认的类型别名,即类名且不区分大小写
      # name: 包路径
  environments:
    environment:
      # <environment> 配置某个具体的环境
      # id: 表示连接数据库的环境的唯一标识.不能重复
      transationManager:
        # <transactionManager> 设置事务管理方式
        # type: "JDBC/MANAGED"
        # JDBC 标识当前环境中,操作SQL时,使用的是JDBC中原生的事务管理方式,事务的提交和回滚需要手动处理
        # MANAGED 被管理,例如Spring
        dataSource:
          # <dataSource> 配置数据源
          # type: 设置数据源类型
          # type: "POOLED/UNPOOLED/JNDI"
          # POOLED 表示使用数据库连接池缓存数据库连接
          # UNPOOLED 表示不使用数据库连接池
          # JNDI 表示使用上下文的数据源
          property:
            # <property/> 设置属性
            # name: "driver"  # 设置连接数据库的驱动
            # name: "url"  # 设置连接数据库的连接地址
            # name: "username"  # 设置连接数据库的用户名
            # name: "password"  #设置连接数据库的密码
  mappers:
    # <mappers> 引入映射文件
    mapper:
      # 具体引入某个类型的映射文件
      # resource: 文件路径
    package:
      # 以包为单位引入映射文件
      # name: 包路径
      ### 以包为单位引入的映射文件
      # mapper接口所在的包要和映射文件所在的包一致
      # mapper接口要和映射文件的名字一致

Mybatis获取参数值的两种方式

${}：本质字符串拼接(遇到数据库里需要引号时，需自行加引号)
{}：本质占位符赋值

方式1.单参数方式
getUser(String username);
可以通过${}和#{}以任意的名称获取参数值
示例:
  select * from t_user username = '${username|xxx}'
  select * from t_user username = #{username|xxx}

方式2.多参数方式
getUser(String username, String password, ..);
mybatis-3.x:
  mybatis会将这些参数放到一个map集合中,以两种方式进行存储:
    以arg0, arg1,...为键,以参数为值
    以param1,param2,...为键,以参数为值
示例:
  select * from t_user username = '${arg0|param1}' and password = '${arg1|param2}'
  select * from t_user username = #{arg0|param1} and password = #{arg1|param2}

### 验证未通过
# mybatis-3.5.9: 可以使用参数名为键,以参数为值
# 示例:
  # select * from t_user username = '${username}' and password = '${password}'
  # select * from t_user username = #{username} and password = #{password}

方式3.Map方式
getUser(Map<String, Object> map);
当mapper接口方法有多个时,可以手动将这些参数放到map中存储,参数名为键,以参数为值

方式4.以属性的方式
getUser(User user)
可以通过${}和#{}以属性的的方式(getter)访问属性的方式访问属性值

方式5.@Param注解方式
getUser(@Param("username") String username,@Param("password") String password);
mybatis会将这些参数放到一个map集合中,以两种方式进行存储:
  以@Param的值为键,以参数为值
  以param1,param2,...为键,以参数为值
示例:
  select * from t_user username = '${username|param1}' and password = '${password|param2}'
  select * from t_user username = #{username|param1} and password = #{password|param2}

Mybatis返回结果接收

resultType：设置了默认的类型别名，采取类型别名的返回值结果类型也可以 resultType="_int" ---> int、resultType="integer" ----> Integer 类型别名可以参考官方手册https://mybatis.org/mybatis-3/configuration.html#typeAliases
resultMap：设置自定义映射属性

<resultMap id="AuthMenuResultMap" type="">
    <id column="id" property="id"/>
    <id column="age" property="age"/>
    <association property="" javaType="com.wcmr.domain.auth.AuthMenu">
        <id column="name" property="name"/>
        <id column="code" property="code"/>
    </association>
</resultMap>

<select id="" resultMap="AuthMenuResultMap" parameterType="">
   <foreach collection="" item="" index="" open="" separator="" close=""></foreach>
</select>

只返回一条数据可以通过实体类对象接收可以通过List集合接收可以通过Map集合接收.
查询返回多条数据可以通过List集合接收可以通过Map(List<Map<String, Object>>)集合接收可以在mapper接口的方法上添加@MapKey("")注解，此时就可以将每条数据转换的Map集合作为值，以某个字段的值作为键，放在同一个Map集合中注意：此时不能通过实体类对象接收否则会抛TooManyResultExceeption异常.

解决字段名和属性名不一致的情况

为字段起别名, 保持和属性名的一致

<!-- 配置Mapper.xml -->

<!-- List<Emp> selectAllEmp(); -->
<!-- e_name 设置别名为eName -->
<select id="selectAllEmp" resultType="Emp">
    select eid, e_name eName, age, sex, dbmail from t_emp
</select>

设置全局配置，将_自动映射为驼峰

<!-- 配置mybatis-config.xml -->

<!-- 驼峰命名转换,将_映射为驼峰 -->
<settings>
    <setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

resultMap配置自定义映射关系

<!-- 配置Mapper.xml -->

<resultMap id="empResultMap" type="Emp">
    <id property="eid" column="eid"></id>
    <result property="eName" column="e_name"></result>
    <result property="age" column="age"></result>
    <result property="sex" column="sex"></result>
    <result property="dbmail" column="dbmail"></result>
</resultMap>
<!-- List<Emp> selectAllEmp(); -->
<select id="selectAllEmp" resultMap="empResultMap">
    select eid, e_name, age, sex, dbmail from t_emp
</select>

处理多对一映射关系(级联属性赋值)

<resultMap id="empDeptResult" type="Emp">
    <id property="eid" column="eid"></id>
    <result property="eName" column="e_name"></result>
    <result property="age" column="age"></result>
    <result property="sex" column="sex"></result>
    <result property="dbmail" column="dbmail"></result>
    <result property="dept.did" column="did"></result>
    <result property="dept.dName" column="d_name"></result>
</resultMap>

<!-- List<Emp> selectEmpDept(@Param("eid") Integer eid); -->
<select id="selectEmpDept" resultMap="empDeptResult">
    select * from t_emp left join t_dept on t_emp.did = t_dept.did where t_emp.eid = #{eid}
</select>

处理多对一映射关系(association)

<resultMap id="empDeptResultAss" type="Emp">
    <id property="eid" column="eid"></id>
    <result property="eName" column="e_name"></result>
    <result property="age" column="age"></result>
    <result property="sex" column="sex"></result>
    <result property="dbmail" column="dbmail"></result>
    <association property="dept" javaType="Dept">
        <id property="did" column="did"></id>
        <result property="dName" column="d_name"></result>
    </association>
</resultMap>

<!-- association 处理多对一映射关系 -->
<!-- property: 需要处理多对的映射关系属性名 -->
<!-- javaTpye: 该属性的类型 -->
<!-- List<Emp> selectEmpDeptAss(@Param("eid") Integer eid); -->
<select id="selectEmpDeptAss" resultMap="empDeptResultAss">
    select * from t_emp left join t_dept on t_emp.did = t_dept.did where t_emp.eid = #{eid}
</select>

处理一对多映射关系

<resultMap id="deptEmpResultMap" type="Dept">
    <id property="did" column="did"></id>
    <result property="dName" column="d_name"></result>
    <collection property="emps" ofType="Emp">
        <id property="eid" column="eid"></id>
        <result property="eName" column="e_name"></result>
        <result property="age" column="age"></result>
        <result property="sex" column="sex"></result>
        <result property="dbmail" column="dbmail"></result>
    </collection>
</resultMap>
<!-- Dept selectDeptEmp(@Param("did") Integer did); -->
<select id="selectDeptEmp" resultMap="deptEmpResultMap">
    select * from t_dept left join t_emp on t_dept.did = t_emp.did where t_dept.did = #{did}
</select>

<!-- Dept dept = mapper.selectDeptEmp(1); -->

处理一对多映射关系(分步查询)

<!-- DeptMapper.xml -->
<resultMap id="deptEmpResultStepOne" type="Dept">
    <id property="did" column="did"></id>
    <result property="dName" column="d_name"></result>
    <collection property="emps"
                select="com.wcmr.tbatis.mapper.EmpMapper.selectDeptAndEmpTwo"
                column="did">
    </collection>
</resultMap>
<!-- Dept selectDeptEmpStepOne(@Param("did") Integer did); -->
<select id="selectDeptAndEmpStepOne" resultMap="deptEmpResultStepOne">
    select * from t_dept where did = #{did}
</select>

<!-- EmpMapper.xml -->
<!-- List<Emp> selectDeptAndEmpTwo(@Param("did") Integer did); -->
<select id="selectDeptAndEmpTwo" resultType="Emp">
    select * from t_emp where did = #{did}
</select>

<!-- Dept dept = mapper.selectDeptAndEmpStepOne(1); -->

Mybatis缓存技术

Mybatis一级缓存(默认开启)

二级缓存是SqlSessionFactory级别，通过同一个SqlSessionFactory创建的SqlSession查询的结果会被缓存；此后若再次执行相同的查询语句，结果就会从缓存中获取

二级缓存开启的条件：

在核心配置文件中，设置全局配置属性cacheEnable="true"，默认为true，不需要设置
在映射文件中设置标签
二级缓存必须在SqlSession关闭或提交之后有效
查询的所有数据所转换的实体类类型必须时下按序列化的接口使二级缓存失效的情况

两次查询直接执行任意增删改，会使一级缓存和二级缓存同时失效

Mybatis缓存查询的顺序

先查询二级缓存，因为二级缓存中可能会有其他程序已经查出来的数据，可以拿来直接用
如果二级缓存没有命中，再查询一级缓存
如果一级缓存也没有命中，则直接查询数据库
SqlSession关闭后，一级缓存中的数据会写入二级缓存

Mapper.xml标签解释

mapper:
  # <mapper> 映射文件
  # namespace: 要和mapper接口的全类名保持一致
  cache:
  # <cache /> 开启二级缓存(前提是全局配置中开启了)
  # eviction: LRU|FIFO|SOFT|WEAK;缓存回收策略.
  # eviction: LRU: 最近最少使用的,移除最长时间不被使用的对象(默认)
  # eviction: FIFO: 先进先出;按对象进入缓存的顺序来移除它们
  # eviction: SOFT: 软引用;移除基于垃圾回收器状态和软引用规则的对象
  # eviction: WEAK: 弱引用;更积极地移除基于垃圾收集器状态和弱引用规则的对象
  # flushInterval: 刷新间隔, 单位毫秒(默认不设置.没有刷新间隔,缓存仅仅调用语句时刷新)
  # size: 引用数目, 正整数
  # readOnly: true|fase;只读.
  # readOnly: true:只读缓存;会给所有调用者返回缓存对象的相同实例,因此这些对象不能被修改.这提供了很重要的性能优势
  # readOnly: false:读写缓存;会返回缓存对象的拷贝(通过序列化).慢,但安全(默认)
  resultMap:
    # <resultMap> 设置自定义映射关系
    # id: 唯一标识，不能重复
    # type: 设置映射关系中的实体类类型
    id:
      # <id> 设置主键的映射关系
      # property: 设置映射关系的属性名,必须是type属性所设置的实体类类型中的属性名
      # column: 设置映射关系中的字段名,必须是sql语句查询出的字段名
    result:
      # <result> 设置普通字段的映射关系
      # property: 设置映射关系的属性名,必须是type属性所设置的实体类类型中的属性名
      # column: 设置映射关系中的字段名,必须是sql语句查询出的字段名
    association:
      # <association> 处理多对一映射关系
      # property: 需要处理多对的映射关系属性名
      # javaTpye: 该属性的类型
      # select: 设置分步查询的sql的唯一标识(namespace.SQLId或者mapper接口的全类名.方法名)
      # column: 设置分步查询的条件
      # fetchType: 当开启了全局的延迟加载后,可通过此属性手动控制延迟加载的效果
      # fetchType: lazy | eager lazy:延迟加载 eager: 立即加载
      id:
        # <id> 设置主键的映射关系
        # property: 设置映射关系的属性名,必须是type属性所设置的实体类类型中的属性名
        # column: 设置映射关系中的字段名,必须是sql语句查询出的字段名
      result:
        # <result> 设置自定义映射关系
        # property: 设置映射关系的属性名,必须是type属性所设置的实体类类型中的属性名
        # column: 设置映射关系中的字段名,必须是sql语句查询出的字段名
    collection:
      # <collection> 处理一对多映射关系
      # ofType: 表示该属性所对应的集合中存储数据的类型
  sql:
    # <sql> 设置sql片段
    # id: sql片段id名称,方便后续中对sql片段的引用
  select:
    # <select> 查询
    # id: 唯一标识,要和mapper接口中的方法名保持一致
    # resultType: 返回结果类型
    # resultMap: 自定义返回值结果映射
    if:
      # <if> 动态SQL,根据标签中test属性所对应的表达式决定标签中的内容是否需要拼接到SQL中
      # test: 判断条件
    where:
      # <shere> 当where标签有内容时,会自动生成where关键字,并且将内容前多余的and 或or去掉
      # <shere> 当where标签没有内容时,此时where没有任何效果
      if:
        # <if> 动态SQL,根据标签中test属性所对应的表达式决定标签中的内容是否需要拼接到SQL中
        # test: 判断条件
    trim:
      # <trim> 有内容时根据属性添加或去除内容前面或后面的指定内容,当标签中没有内容,trim也没有任何效果
      # prefix: 将trim标签中内容前面添加指定内容
      # suffix: 将trim标签中内容后面添加指定内容
      # prefixOverrides: 将trim标签中内容前面去除指定内容
      # suffixOverrides: 将trim标签中内容后面去除指定内容
    choose:
      # <choose> 配合when和otherwise相当于java中的if...else if...else
      when:
        # <when> 相当于if,至少有一个
      otherwise:
        # <otherwise> 相当于else,最多只有一个
    include:
      # <include> 引用sql
      # refid: 引用的id
  insert:
    # <insert> 修改
    # id: 唯一标识,要和mapper接口中的方法名保持一致
    # resultType: 返回结果类型
    # resultMap: 自定义返回值结果映射
    # useGeneratedKeys: 设置当前标签中的sql使用了自增的主键
    # keyProperty: 将自增的主键的值赋值给传输到映射文件参数的某个属性
    foreach:
      # <foreach> 类似for循环
      # collection: 设置需要循环的数组或集合
      # item: 表示数组和集合中的每一个数据
      # separator: 循环体之间的分隔符
      # open: foreach标签所循环的所有内容的开始符
      # close: foreach标签所循环的所有内容的结束符
  delete:
    # 删除标签
    foreach:
      # <foreach> 类似for循环
      # collection: 设置需要循环的数组或集合
      # item: 表示数组和集合中的每一个数据
      # separator: 循环体之间的分隔符
      # open: foreach标签所循环的所有内容的开始符
      # close: foreach标签所循环的所有内容的结束符

版权声明

1、转载或引用本网站内容(Mybatis)须注明原网址及作者(miku)，并标明本网站网址(https://www.pixtech.cc/)。

2、对于不当转载或引用本网站内容而引起的民事纷争、行政处理或其他损失，本网站不承担责任。

3、对不遵守本声明或其他违法、恶意使用本网站内容者，本网站保留追究其法律责任的权利。

本文地址: https://www.pixtech.cc/thread-660-1-1.html

	通知：音游曲Top开始！	06-02 13:26
	通知：白金月票礼包调整	05-31 17:11

公告