详细学习Mybatis（2）

一、Mybatis核心配置文件详细解释

1.1 environment（环境）

• 一般一个数据库对应一个SqlSessionFactory对象
• 一个环境enviroment对应一个SqlSessionFactory对象

为了指定创建哪种环境，只要将它作为可选的参数传递给 SqlSessionFactoryBuilder 即可。可以接受环境配置的两个方法签名是：

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment);
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, environment, properties);

如果忽略了环境参数，那么将会加载默认环境，如下所示：

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader);
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(reader, properties);

environments 元素定义了如何配置环境。

<!-- default:表示默认的环境，在没有指定环境的状况下就执行该下环境-->
<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>

1.2 事务管理器（transactionManager）

• 作用:配置事务管理器。指定mybatis具体使用什么方式去管理事务。

• type属性有两个值：
  JDBC: 使用原生JDBC代码来管理事务
  MANAGED： mybatis不再负责事务的管理，将事务管理交给其他的JavaEE容器
  不用区分大小写，但是只有这两个值选择

• 当事务管理器是：JDBC
  采用JDBC的原生事务机制：
  开启事务：conn.setAutoCommit(false);
  处理业务…
  提交事务：conn.commit();

• 当事务管理器是：MANAGED

交给容器去管理事务，但目前使用的是本地程序，没有容器的支持，当mybatis找不到容器的支持时：没有事务。也就是说只要执行一条DML语句，则提交一次。

1.3、dataSource（数据源）

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

• 有三种内建的数据源类型（也就是 type=“[UNPOOLED|POOLED|JNDI]”）：

1. UNPOOLED
   这个表示在每次访问的时候都会打开或关闭连接，虽然有点慢，但是对于数据库的可用性要求不高

2. POOLED（MyBatis自己实现的数据库连接池）
   这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来，避免了创建新的连接实例时所必需的初始化和认证时间。 这种处理方式很流行，能使并发 Web 应用快速响应请求。

• 当中还存在着许多的type
  poolMaximumActiveConnections – 在任意时间可存在的活动（正在使用）连接数量，默认值：10
  poolMaximumIdleConnections – 任意时间可能存在的空闲连接数。
  poolMaximumCheckoutTime – 在被强制返回之前，池中连接被检出（checked out）时间，默认值：20000 毫秒（即 20 秒）
  poolTimeToWait – 这是一个底层设置，如果获取连接花费了相当长的时间，连接池会打印状态日志并重新尝试获取一个连接（避免在误配置的情况下一直失败且不打印日志），默认值：20000 毫秒（即 20 秒）。
  poolMaximumLocalBadConnectionTolerance – 这是一个关于坏连接容忍度的底层设置， 作用于每一个尝试从缓存池获取连接的线程。 如果这个线程获取到的是一个坏的连接，那么这个数据源允许这个线程尝试重新获取一个新的连接，但是这个重新尝试的次数不应该超过 poolMaximumIdleConnections 与 poolMaximumLocalBadConnectionTolerance 之和。 默认值：3（新增于 3.4.5）

3. JNDI:(:集成其它第三方的数据库连接池。)
   是一套规范。谁实现了这套规范呢?大部分的web容器都实现了JNDI规范:
   例如: Tomcat、Jetty、WebLogic、WebSphere，这些服务器(容器)都实现了JNDI规范。
   JNDI是: java命名目录接口。Tomcat服务器实现了这个规范。

• 不同配置下的属性不同，通过参考官方手册进行编辑配置
• 提醒:正常使用连接池的话，池中有很多参数是需要设置的。设置好参数，可以让连接池发挥的更好。事半功倍的效果。
• 具体连接池当中的参数如何配置呢?需要反复的根据当前业务情况进行测试。

属性	作用
poolMaximumActiveConnections	最大的活动的连接数量。默认值10
poolMaximumIdleConnections	最大的空闲连接数量。默认值5
poolMaximumCheckoutTime	强行回归池的时间。默认值20秒
poolTimeToWait	当无法获取到空闲连接时，每隔20秒打印一次日志，避免因代码配置有误，导致傻等。（时长是可以配置的）

1.4、properties

• 这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。

<properties resource="org/mybatis/example/config.properties">
  <property name="username" value="dev_user"/>
  <property name="password" value="F2Fa3!33TYyg"/>
</properties>

• 设置好的属性可以在整个配置文件中用来替换需要动态配置的属性值

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

properties两个属性：

resource：这个属性从类的根路径下开始加载。【常用的。】
url：从指定的url加载，假设文件放在d:/jdbc.properties，这个url可以写成：file:///d:/jdbc.properties。注意是三个斜杠哦。

注意：如果不知道mybatis-config.xml文件中标签的编写顺序的话，可以有两种方式知道它的顺序：

第一种方式：查看dtd约束文件。
第二种方式：通过idea的报错提示信息。【一般采用这种方式】

1.5、mapper

mapper标签用来指定SQL映射文件的路径，包含多种指定方式，这里先主要看其中两种：
第一种：resource，从类的根路径下开始加载【比url常用】

<mappers>
  <mapper resource="CarMapper.xml"/>
</mappers>

如果是这样写的话，必须保证类的根下有CarMapper.xml文件。
如果类的根路径下有一个包叫做test，CarMapper.xml如果放在test包下的话，这个配置应该是这样写：

<mappers>
  <mapper resource="test/CarMapper.xml"/>
</mappers>

第二种：url，从指定的url位置加载
假设CarMapper.xml文件放在d盘的根下，这个配置就需要这样写：

<mappers>
  <mapper url="file:///d:/CarMapper.xml"/>
</mappers>

建议不用写成这样，因为兼容性太差

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
<!-- 使用完全限定资源定位符（URL） -->
<mappers>
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
  <mapper url="file:///var/mappers/BlogMapper.xml"/>
  <mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMapper"/>
  <mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
<!-- 将包内的映射器接口全部注册为映射器 -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>