MyBatis的核心配置

---

源码：

一、MyBatis的核心对象

1.1 SqlSessionFactory

它是单个数据库映射关系经过编译后的内存镜像，其主要作用是创建SqlSession。可以通过SqlSessionFactoryBuilder读取xml来创建SqlSessionFactory。如：

InputStream inputStream = Resources.getResourceAsStream("配置文件位置");
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

SqlSessionFactory对象是线程安全的，它一旦被创建，在整个应用执行期间都会存在。

1.2 SqlSession

它是应用程序与持久层之间执行交互操作的一个单线程对象，其主要作用是执行持久化操作。使用完SqlSession对象后要及时关闭，通常可以将其放在finally块中关闭。如：

SqlSession sqlSession = sqlSessionFactory.openSession();
try {
       // 此处执行持久化操作
} finally {
      sqlSession.close();
}

由于每次执行数据库操作，都需要读取xml配置文件，生成SqlSessionFacotryBuilder创建SqlSessionFactory，然后创建SqlSession。这里会产生冗余代码，因此我们使用工具类。如：

public class MybatisUtils {
          private static SqlSessionFactory sqlSessionFactory = null;
          static {
              try {
	    Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
	    sqlSessionFactory =  new SqlSessionFactoryBuilder().build(reader);
              } catch (Exception e) {
	    e.printStackTrace();
              }
          }
          public static SqlSession getSession() {
               return sqlSessionFactory.openSession();
          }
    }

二、配置文件

参考 官方Mybatis文档
配置文件，通常就是Mybatis-config.xml，其完整结构如下：

注意：
cofiguration标签子元素必须按照由上到下的顺序进行配置，否则MyBatis在解析XML配置文件的时候会报错。

2.1 properties子元素

这个元素通常用来将内部的配置外在化，即通过外部的配置来动态的替换内部定义的属性。

• 编写db.properties

 jdbc.driver=com.mysql.jdbc.Driver
     jdbc.url=jdbc:mysql://localhost:3306/mybatis
     jdbc.username=root
     jdbc.password=root

• 在MyBatis 配置文件 mybatis-config .xml 中配置<properties… />属性

<properties resource="db.properties" />

• 修改配置文件中数据库连接的信息

<dataSource type="POOLED">
    <!-- 数据库驱动 -->
    <property name="driver" value="${jdbc.driver}" />
    <!-- 连接数据库的url -->
    <property name="url" value="${jdbc.url}" />
    <!-- 连接数据库的用户名 -->
    <property name="username" value="${jdbc.username}" />
    <!-- 连接数据库的密码 -->
    <property name="password" value="${jdbc.password}" />
</dataSource>

这样就为配置提供了诸多灵活的选择，比如加密数据库密码等。

2.2 setting子元素

该元素主要用于改变MyBatis运行时的行为，例如开启二级缓存、开启延迟加载等。不用配置这个元素，Mybatis也可以正常运行。

2.3 typeAliases

该元素用于为配置文件中的Java类型设置一个简短的名字，即设置别名。别名的设置与XML配置相关，其使用的意义在于减少全限定类名的冗余。如：

 <typeAliases>
             <typeAlias alias="user" type="com.itheima.po.User"/>
     </typeAliases>

也可以这样(这样的话，在domain.blog目录想的javaBean的别名为首字母小写的类名)

<typeAliases>
  <package name="domain.blog"/>
</typeAliases>

以上配置，可以让我们在映射文件中，简写parameterType、resultType。MyBatis 框架还默认为许多常见的 Java类型(如数值、字符串、曰期和集合等)提供了相应的类型别名。

2.4 typeHandler

typeHandler的作用就是将预处理语句中传入的参数从javaType（Java类型）转换为jdbcType（JDBC类型），或者从数据库取出结果时将jdbcType转换为javaType。 可以自定义typeHandler，然后有两种方式来在配置文件中注册自定义的typeHandler。

• 注册一个类的类型处理器

  <typeHandlers> 
          <typeHandler handler="com.itheima.type.CustomtypeHandler" />
     </typeHandlers>

• 注册一个包中所有的类型处理器

 <typeHandlers> 
          <package name="com.itheima.type" />
     </typeHandlers>

2.5 ObjectFactory

MyBatis中默认的ObjectFactory的作用是实例化目标类，它既可以通过默认构造方法实例化，也可以在参数映射存在的时候通过参数构造方法来实例化。通常使用默认的ObjectFactory即可。当然，也可以自定义ObjectFactory。

2.6 plugins

MyBatis 允许你在已映射语句执行过程中的某一点进行拦截调用。

2.7 environments

参考 官网
MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中， 现实情况下有多种理由需要这么做。例如，开发、测试和生产环境需要有不同的配置；或者共享相同 Schema 的多个生产数据库， 想使用相同的 SQL 映射。许多类似的用例。

2.8 databaseIdProvider

MyBatis 可以根据不同的数据库厂商执行不同的语句，这种多厂商的支持是基于映射语句中的 databaseId 属性。

2.9 mappers

该元素用于指定MyBatis映射文件的位置。有4种方式指定映射器文件的位置：

1. 使用类路径引入

<mappers>
    <mapper resource="com/itheima/mapper/UserMapper.xml"/>
</mappers>

2. 使用本地文件路径引入

<mappers>
    <mapper url="file:///D:/com/itheima/mapper/UserMapper.xml"/>
</mappers>

3. 使用接口类引入

<mappers>
    <mapper class="com.itheima.mapper.UserMapper"/>
</mappers>

4. 使用包名引入

<mappers>
    <package name="com.itheima.mapper"/>
</mappers>

三、映射文件

参考 官方文档

select、insert、update、delete 见官网

3.1 sql元素

这个元素可以被用来定义可重用的 SQL 代码段，可以包含在其他语句中。如，定义一个sql代码段：

<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password </sql>

这个 SQL 片段可以被包含在其他语句中，例如：

<select id="selectUsers" resultType="map">
  select
    <include refid="userColumns"><property name="alias" value="t1"/></include>,
    <include refid="userColumns"><property name="alias" value="t2"/></include>
  from some_table t1
    cross join some_table t2
</select>

3.2 resultMap元素

resultMap元素表示结果映射集，是MyBatis中最重要也是最强大的元素。它的主要作用是定义映射规则、级联的更新以及定义类型转化器等。