Mybatis:配置解析

配置解析

　　  mybatis-config.xml(Mybatis核心配置文件）深深影响了Mybatis行为的设置和属性信息。

　　能配置的的内容

　　　

 　　当然，并不是所有都是我们经常使用到的，下面选择经常使用的配置元素介绍。

---

标签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(事务管理器）

　　　　

　　　　
　　　　现阶段使用默认模式就可以了。

• • 子元素结点：dataSource
• dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。
•  数据源是必须配置的。
• 有三种内建的数据源类型
• type="[UNPOOLED|POOLED|JNDI]"）
•  unpooled： 这个数据源的实现只是每次被请求时打开和关闭连接。
•  pooled： 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。
• jndi：这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。
• 数据源也有很多第三方的实现，比如dbcp，c3p0，druid等等....

---

mappers元素

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

• 引入资源方式

<!-- 使用相对于类路径的资源引用 -->
        <mappers>
          <mapper resource="org/mybatis/builder/PostMapper.xml"/>
        </mappers>
        
        
        <!-- 使用完全限定资源定位符（URL） -->
        <mappers>
          <mapper url="file:///var/mappers/AuthorMapper.xml"/>
        </mappers>
        
        
        <!-- 
        使用映射器接口实现类的完全限定类名
        需要配置文件名称和接口名称一致，并且位于同一目录下
        -->
        <mappers>
          <mapper class="org.mybatis.builder.AuthorMapper"/>
        </mappers>
        
        <!-- 
        将包内的映射器接口实现全部注册为映射器
        但是需要配置文件名称和接口名称一致，并且位于同一目录下
        -->
        <mappers>
          <package name="org.mybatis.builder"/>
        </mappers>

---

Mapper文件

<?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">
<mapper namespace="com.kuang.mapper.UserMapper">
    
</mapper>

namespace（命名空间）的作用：

• namespace与子元素id联合保证唯一，区别不用的mapper
• 与dao（mapper）接口绑定
  • 　　namespace必须与接口同名
  • 　　接口中方法必须与sql语句中的id一一对应
• namespace命名规则：包名+接口名（不加后缀）

---

Properties优化

数据库这些属性可以用过外部配置动态改变，既可以通过java属性文件配置，也可以通过properties元素的子元素来传递。具体如下：

•  在资源目录下新建一个db.properties

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
password=123456  

• 将属性文件导入：

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

　　即可。

---

typeAliases优化

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

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

　　设置了这个别名，你就可以在任何地方使用User代替com.ttt.pojo.User了。

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

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

每一个在包 com.ttt.pojo 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。

• 使用注解也可以设置别名

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

官方也设置一些默认别名，详情访问官方文档

---

设置（settings)

• 设置（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>

---

生命周期和作用域

理解我们目前已经讨论过的不同作用域和生命周期类是至关重要的，因为错误的使用会导致非常严重的并发问题。
我们可以先画一个流程图，分析一下Mybatis的执行过程！

作用域理解

• 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 的最佳的作用域是请求或方法作用域。