【MyBatis】MyBatis主配置文件解析（笔记四）

【MyBatis】MyBatis主配置文件解析

• MyBatis配置文件分为以下两类：
  • mybatis主配置文件：提供mybatis全局设置，包含日志、数据源、mapper文件位置等。
  • mapper文件：用于防止SQL语句。一个表/接口对应一个mapper文件。

1、settings

• settings是mybatis的全局设置，影响整个mybatis的运行，这个设置一般使用默认值即可。

  <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>
  

2、typeAliase（别名）

• 设置别名

      <!-- 设置别名 -->
      <typeAliases>
          <!--
              第一种语法格式
                  type：java类型的全限定名称（自定义类型）
                  alias：自定义别名
                  优点：别名可以自定义
                  缺点：每个类型必须单独定义
          -->
  	<typeAlias type="com.Etui.entity.Student" alias="stu"/>
  
          <!--
              第二种语法格式
              name: 包名， mybatis会把这个包中所有类作为别名，且不区分大小写
              优点：使用方便，一次给多个类定义名称
              缺点：别名不能自定义，必须是类名，且多个包中若存在相同类，会出现别名冲突
          -->
          <package name="com.Etui.entity" />
      </typeAliases>
  

3、environments（配置环境）

• environments：环境标签，在他里面可以配置多个environment
• environment：表示一个数据库的连接信息
  • 属性：id 自定义的环境的标识，唯一值
• transactionManager：事务管理器
  • 属性：type 表示事务管理器的类型
  • 属性值：
    • 1）JDBC，使用Conection对象，有mybatis自己完成事务的处理。
    • 2）MANAGED，管理，表示把事务的处理交给容器实现（由其他软件完成事务的提交、回滚）。
• dataSource：数据源，创建的Connection对象，连接数据库。
  • 属性： type 数据源的类型
  • 属性值：
    • 1）POOLED，mybatis会在内存中创建PooledDataSource类，管理多个Connection连接对象，使用的连接池。
    • 2）UNPOOLED，不适用连接池，mybatis创建一个UnPooledDataSource这个类，每次执行SQL语句先创建Connection对象，再执行SQL语句，最后关闭Connection。
    • 3）JNDI，java的命名和目录服务。

<!-- 项目上线使用的数据库 -->
<environments default="online">
    <environment id="online">

        <transactionManager type="JDBC"/>
        <dataSource type="POOLED">
            <property name="driver" value="${jdbc.driver}"/>
            <property name="url" value="${jdbc.url}"/>
            <property name="username" value="${jdbc.username}"/>
            <property name="password" value="${jdbc.password}"/>
        </dataSource>

    </environment>

    <!-- 开发时使用的数据库 -->
    <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/springdb?userUnicode=true&amp;characterEncoding=utf-8&amp;serverTimezone=UTC"/>
            <property name="username" value="root"/>
            <property name="password" value="Hzz15385252813"/>
        </dataSource>
    </environment>
</environments>

4、properties（使用数据库属性配置文件）

• 将数据库的配置信息放入单独的properties文件中，独立管理。文件扩展名为properties，改类文件使用自定义的key=value的格式表示数据。

• 使用步骤：

  • 1）在resources目录中，创建xxx.properties配置文件。
  • 2）在文件中，使用key=value的格式定义数据。
  • 3）在mybatis主配置文件，使用property标签引用外部的属性配置文件。
  • 4）在使用值的位置，使用${key}获取key对应的value。

• 案例：

  • resources目录下的jdbc.properties

    jdbc.username=root
    jdbc.password=abc123
    jdbc.url=jdbc:mysql://localhost:3306/springdb?userUnicode=true&characterEncoding=utf-8&serverTimezone=UTC
    jdbc.driver=com.mysql.cj.jdbc.Driver
    

  • mybatis主配置文件中

    <!-- 引用外部文件 -->
    <properties resource="jdbc.properties" />
    …………
    …………
    <environments default="online">
        <environment id="online">
    
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <!-- 使用外部配置文件的内容 -->
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
    
        </environment>
    </environments>     
    

5、mapper标签

• mapper标签常用的两种方式：

  • (1) mapper标签resources="mapper文件路径"格式
    • 优点：文件清晰，加载的文件是明确的，文件的位置比较灵活。
    • 缺点：文件比较多时，代码量会较大，管理难度大。
  • (2) 使用package标签name="包名"格式
    • 特点：将包中所有mapper文件，一次性加载。
    • 使用要求：mapper文件和dao接口必须在同一目录，且mapper文件和dao接口名称完全一样。

• 案例：

      <mappers>
          <!-- 通过mapper标签引用 -->
  <!--        <mapper resource="com/Etui/dao/StudentDao.xml"/>-->
          <!-- 通过package标签引用 -->
          <package name="com.Etui.dao" />
      </mappers>
  

6、pageHelper插件（分页插件）

• 在pom中引用pagehelper依赖

  <!-- 分页插件 -->
  <!-- https://mvnrepository.com/artifact/com.github.pagehelper/pagehelper -->
  <dependency>
    <groupId>com.github.pagehelper</groupId>
    <artifactId>pagehelper</artifactId>
    <version>5.2.0</version>
  </dependency>
  

• 在mybatis主配置文件中添加pagehelper插件

  <!-- 分页插件 -->
  <plugins>
      <plugin interceptor="com.github.pagehelper.PageInterceptor" />
  </plugins>
  

• 测试使用

  // 使用分页插件查询
  @Test
  public void testSelectWhere2() {
      SqlSession session = MyBatisUtil.getSqlSession();
      StudentDao dao = session.getMapper(StudentDao.class);
      
      // 每页3条数据，查询第二页
      PageHelper.startPage(2, 3); 
      
      Student student = new Student();
      student.setAge(100);
      List<Student> students = dao.selectWhere(student);
      students.forEach(System.out::println);
      session.close();
  }
  

Over！