Mybatis笔记(三) Mybatis配置解析

Mybatis学习笔记来自B站狂神说Java Mybatis系列视频~
视频链接:https://www.bilibili.com/video/BV1NE411Q7Nx
纯个人手打,可能会有错误,欢迎指正交流探讨~
个人邮箱:460168087@qq.com

3、配置解析

1. 核心配置文件

  • mybatis-config.xml 核心配置文件

  • MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

  • 配置文档的顶层结构如下:

    configuration(配置)
        properties(属性)
        settings(设置)
        typeAliases(类型别名)
        typeHandlers(类型处理器)
        objectFactory(对象工厂)
        plugins(插件)
        environments(环境配置)
            environment(环境变量)
                transactionManager(事务管理器)
                dataSource(数据源)
        databaseIdProvider(数据库厂商标识)
        mappers(映射器)
    <!-- 注意元素节点的顺序!顺序不对会报错 -->
    

    可以通过阅读mybatis-config.xml 上面的dtd的头文件!

2. environments元素

<environments default="development">
  <environment id="development">
    <transactionManager type="JDBC">
      <property name="..." value="..."/>
    </transactionManager>
    <dataSource type="POOLED">
      <property name="driver" value="${driver}"/>
      <property name="url" value="${url}"/>
      <property name="username" value="${username}"/>
      <property name="password" value="${password}"/>
    </dataSource>
  </environment>
</environments>
  • 配置Mybatis的多套运行环境,将SQL映射到多个不同的数据库上,必须指定其中一个为默认运行环境(由default指定)
  • 子元素节点:environment
    • 具体的一套环境,通过设置id进行区别,id要确保唯一!
  • 子元素节点:transactionManager - [ 事务管理器 ]

    <!-- 语法 -->
    <transactionManager type="[ JDBC | MANAGED ]"/>
    
  • 子元素节点:数据源(dataSource)

    • dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

    • 数据源是必须配置的。

    • 有三种内建的数据源类型

      type="[UNPOOLED|POOLED|JNDI]"
    • unpooled: 这个数据源的实现只是每次被请求时打开和关闭连接。

    • pooled: 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。

    • jndi:这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。

    • 数据源也有很多第三方的实现,比如dbcp,c3p0,druid等等…

3. mappers元素

mapperregistry:注册绑定Mapper文件

  • 映射器:定义映射SQL语句文件

  • 既然 MyBatis 的行为其他元素已经配置完了,我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。 Java 在自动查找这方面没有提供一个很好的方法,所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。你可以使用相对于类路径的资源引用, 或完全限定资源定位符(包括 file:/// 的 URL),或类名和包名等。映射器是MyBatis中最核心的组件之一,在MyBatis 3之前,只支持xml映射器,即:所有的SQL语句都必须在xml文件中配置。而从MyBatis 3开始,还支持接口映射器,这种映射器方式允许以Java代码的方式注解定义SQL语句,非常简洁。

  • 引入资源方式:

    • 方式一:使用相对于类路径的资源引用 [推荐]

      <!-- 使用相对于类路径的资源引用 -->
      <mappers>
        <mapper resource="com/gang/dao/UserMapper.xml"/>
      </mappers>
      
    • 方式二:使用完全限定资源定位符(URL)[强烈不推荐]

      <!-- 使用完全限定资源定位符(URL) -->
      <mappers>
        <mapper url="file:///var/mappers/AuthorMapper.xml"/>
      </mappers>
      
    • 方式三:使用class文件注册绑定

      <!-- 
      注意:
          使用映射器接口实现类的完全限定类名
          需要配置文件名称和接口名称一致,并且位于同一目录下
      -->
      <mappers>
        <mapper class="com.gang.dao.UserMapper.xml/>
      </mappers>
      
    • 方式四:

      <!-- 
      注意:
          使用映射器接口实现类的完全限定类名
          需要配置文件名称和接口名称一致,并且位于同一目录下
      -->
      <mappers>
        <package name="com.gang.dao"/>
      </mappers>
      

Mapper文件

  • 实现SQL语句的xml配置文件

    <?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper
            PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
            "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    <!--namespace=绑定一个对应的DAO/Mapper 接口-->
    <mapper namespace="com.gang.dao.UserDao">
        <!--获得所有用户列表-->
        <select id="getUserList" resultType="com.gang.pojo.User">
            select * from mybatis.user;
        </select>
    </mapper>
    
    //对应的接口文件
    package com.gang.dao;
    import com.gang.pojo.User;
    import java.util.List;
    public interface UserDao {
        List<User> getUserList();
    }
    
    • namespace:命名空间
      • namespace和子元素的id联合保证唯一,区别不同的mapper
      • 绑定DAO接口
        • namespace的命名必须跟某个接口同名
        • 接口中的方法与映射文件中sql语句id应该一一对应
      • namespace命名规则 : 包名+类名

    MyBatis 的真正强大在于它的映射语句,这是它的魔力所在。由于它的异常强大,映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比,你会立即发现省掉了将近 95% 的代码。MyBatis 为聚焦于 SQL 而构建,以尽可能地为你减少麻烦。

4. Properties优化

  • 数据库这些属性都是可外部配置且可动态替换的,既可以在典型的 Java 属性文件中配置,亦可通过 properties 元素的子元素来传递。简单而言就是使用外部的properties配置文件来定义数据库driver,url,username,password, 而 并非像之前一样,在mybatis-config.xml中定义。

  • 具体的官方文档

  • 可以对section2中的入门程序进行优化

    • 第一步:在资源目录下resources新建一个dp.properties文件

      driver=com.mysql.jdbc.Driver
      url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8
      username=root
      password=123456
      
    • 第二步:在mybatis-config.xml导入properties 配置文件

      <configuration>
          <!--导入properties文件-->
          <properties resource="db.properties"/>
      
          <environments default="development">
              <environment id="development">
                  <transactionManager type="JDBC"/>
                  <dataSource type="POOLED">
                      <property name="driver" value="${driver}"/>
                      <property name="url" value="${url}"/>
                      <property name="username" value="${username}"/>
                      <property name="password" value="${password}"/>
                  </dataSource>
              </environment>
          </environments>
          <mappers>
              <mapper resource="mapper/UserMapper.xml"/>
          </mappers>
      </configuration>
      
  • 配置文件优先级:

    • 当外部properties和内部xml同时定义了数据库连接的相关相同信息时,外部properties优先级更高。

5. typeAliases起别名优化

​ 类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关,存在的意义仅在于用来减少类完全限定名的冗余。

<!--配置别名,注意顺序-->
<typeAliases>
    <typeAlias type="com.gang.pojo.User" alias="User"/>
</typeAliases>

​ 当这样配置时,User可以用在任何使用com.kuang.pojo.User的地方。

​ 也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:

<typeAliases>
    <package name="com.gang.pojo"/>
</typeAliases>

​ 每一个在包 com.kuang.pojo 中的 Java Bean,在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名。比如当想要使用com.kuang.pojo这个包下的User实体类时,默认别名就是user

​ 若有注解,则别名为其注解值。见下面的例子:

@Alias("user")
public class User {
    ...
}

【演示】去官网查看一下Mybatis默认的一些类型别名!

6. 设置

  • **设置(settings)**相关 => 查看帮助文档

    • 懒加载
    • 日志实现
    • 缓存开启关闭
  • 一个配置完整的settings元素示例如下:

    <settings>
      <setting name="cacheEnabled" value="true"/>
      <setting name="lazyLoadingEnabled" value="true"/>
      <setting name="multipleResultSetsEnabled" value="true"/>
      <setting name="useColumnLabel" value="true"/>
      <setting name="useGeneratedKeys" value="false"/>
      <setting name="autoMappingBehavior" value="PARTIAL"/>
      <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
      <setting name="defaultExecutorType" value="SIMPLE"/>
      <setting name="defaultStatementTimeout" value="25"/>
      <setting name="defaultFetchSize" value="100"/>
      <setting name="safeRowBoundsEnabled" value="false"/>
      <setting name="mapUnderscoreToCamelCase" value="false"/>
      <setting name="localCacheScope" value="SESSION"/>
      <setting name="jdbcTypeForNull" value="OTHER"/>
      <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
    </settings>
    

7. 生命周期和作用域

作用域(Scope)和生命周期

​ 理解我们目前已经讨论过的不同作用域和生命周期类是至关重要的,因为错误的使用会导致非常严重的并发问题。

作用域理解

  • SqlSessionFactoryBuilder 的作用在于创建 SqlSessionFactory,创建成功后,SqlSessionFactoryBuilder 就失去了作用,所以它只能存在于创建 SqlSessionFactory 的方法中,而不要让其长期存在。因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。
  • SqlSessionFactory 可以被认为是一个数据库连接池,它的作用是创建 SqlSession 接口对象。因为 MyBatis 的本质就是 Java 对数据库的操作,所以 SqlSessionFactory 的生命周期存在于整个 MyBatis 的应用之中,所以一旦创建了 SqlSessionFactory,就要长期保存它,直至不再使用 MyBatis 应用,所以可以认为 SqlSessionFactory 的生命周期就等同于 MyBatis 的应用周期。
  • 由于 SqlSessionFactory 是一个对数据库的连接池,所以它占据着数据库的连接资源。如果创建多个 SqlSessionFactory,那么就存在多个数据库连接池,这样不利于对数据库资源的控制,也会导致数据库连接资源被消耗光,出现系统宕机等情况,所以尽量避免发生这样的情况。
  • 因此在一般的应用中我们往往希望 SqlSessionFactory 作为一个单例,让它在应用中被共享。所以说 SqlSessionFactory 的最佳作用域是应用作用域。
  • 如果说 SqlSessionFactory 相当于数据库连接池,那么 SqlSession 就相当于一个数据库连接(Connection 对象),你可以在一个事务里面执行多条 SQL,然后通过它的 commit、rollback 等方法,提交或者回滚事务。所以它应该存活在一个业务请求中,处理完整个请求后,应该关闭这条连接,让它归还给 SqlSessionFactory,否则数据库资源就很快被耗费精光,系统就会瘫痪,所以用 try…catch…finally… 语句来保证其正确关闭。
  • 所以 SqlSession 的最佳的作用域是请求或方法作用域。
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值