MyBatis的结构和配置

概述

MyBatis将用户从JDBC的访问中解放出来，用户只需要定义需要操作的SQL语句，无须关注底层的JDBC操作，就可以面向对象的方式进行持久层操作。底层数据库连接的获取、数据访问的实现、事务控制等都无须用户关心，从而将应用层从底层的JDBC API中抽取出来，通过配置文件管理JDBC的连接，使用MyBatis解决持久化访问的实现。

MyBatis的体系结构

MyBatis中常用的对象有SqlSessionFactory和SqlSession。

SqlSessionFactory

SqlSessionFactory是MyBatis的关键对象，是单个数据库映射关系经过编译后的内存镜像。该对象的实例通过SqlSessionFactoryBuilder对象来获得，而SqlSessionFactoryBuilder则可以从XML配置文件或一个预先定制的Configuration的实例构建出SqlSessionFactory的实例。每一个MyBatis的应用程序都以一个SqlSessionFactory对象的实例为核心。

它是线程安全的，SqlSessionFactory一旦被创建，应该在应用执行期间都存在。在应用运行期间不要重复创建，建议使用单例模式。SqlSessionFactory是SqlSession的工厂，使用SqlSessionFactory.openSession()方法创建SqlSession对象（前文连接：https://www.jianshu.com/p/063a5ca8874c）。

SqlSession

SqlSession是MyBatis的关键对象，是执行持久化操作的对象，类似于JDBC中的Connection。它是应用程序与持久存储层之间执行交互操作的一个单线程对象，也是MyBatis执行持久化操作的关键对象。

SqlSession对象完全包含以数据库为背景的所有执行SQL操作的方法，它的底层封装了JDBC连接，可以用SqlSession实例来直接执行已经映射的SQL语句。每个线程都应该有自己的SqlSession实例。

SqlSession实例不能被共享，也是线程不安全的，绝对不能将SqlSession实例的引用放在任何类型的管理范围中，应该确保使用完SqlSession之后将它关闭。

SqlSession的方法见如下源码程序：

  1 public interface SqlSession extends Closeable {
  2     <T> T selectOne(String var1);
  3
  4     <T> T selectOne(String var1, Object var2);
  5
  6     <E> List<E> selectList(String var1);
  7
  8     <E> List<E> selectList(String var1, Object var2);
  9
 10     <E> List<E> selectList(String var1, Object var2, RowBounds var3);
 11
 12     <K, V> Map<K, V> selectMap(String var1, String var2);
 13
 14     <K, V> Map<K, V> selectMap(String var1, Object var2, String var3);
 15
 16     <K, V> Map<K, V> selectMap(String var1, Object var2, String var3, RowBounds var4);
 17
 18     <T> Cursor<T> selectCursor(String var1);
 19
 20     <T> Cursor<T> selectCursor(String var1, Object var2);
 21
 22     <T> Cursor<T> selectCursor(String var1, Object var2, RowBounds var3);
 23
 24     void select(String var1, Object var2, ResultHandler var3);
 25
 26     void select(String var1, ResultHandler var2);
 27
 28     void select(String var1, Object var2, RowBounds var3, ResultHandler var4);
 29
 30     int insert(String var1);
 31
 32     int insert(String var1, Object var2);
 33
 34     int update(String var1);
 35
 36     int update(String var1, Object var2);
 37
 38     int delete(String var1);
 39
 40     int delete(String var1, Object var2);
 41
 42     void commit();
 43
 44     void commit(boolean var1);
 45
 46     void rollback();
 47
 48     void rollback(boolean var1);
 49
 50     List<BatchResult> flushStatements();
 51
 52     void close();
 53
 54     void clearCache();
 55
 56     Configuration getConfiguration();
 57
 58     <T> T getMapper(Class<T> var1);
 59
 60     Connection getConnection();
 61 }
 62 

具体解释，此处不做记录，使用时查询即可。

注意：

实际应用中很少直接使用DriverManager来获取数据库连接，通常使用DataSource来获取数据库连接，SqlSessionFactory底层封装了DataSource。

MyBatis的配置文件

此处回顾前文的test测试类文件代码：

  1 public class Test {
  2     public static void main(String[] args) throws IOException {
  3         InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
  4         SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
  5         SqlSession sqlSession = sqlSessionFactory.openSession();
  6         User user = new User("Snow","男",20);
  7         sqlSession.insert("com.snow.dcl.mapper.UserMapper.saveUser",user);
  8         sqlSession.commit();
  9         sqlSession.close();
 10     }
 11 }

首先，读取mybatis-config.xml配合文件：

  1 InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");

然后初始化mybatis，创建SqlSessionFactory的实例：

  1 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

最后获取SqlSession对象，执行SQL语句：

  1 SqlSession sqlSession = sqlSessionFactory.openSession();
  2 ...
  3 sqlSession.insert("com.snow.dcl.mapper.UserMapper.saveUser",user);

由此可见，MyBatis的初始化过程要经过以下步骤：

1.调用SqlSessionFactoryBuilder对象的build(inputStream)方法。

2.SqlSessionFactoryBuilder会根据输入流inputStream等信息创建XMLConfigBuilder对象。

3.SqlSessionFactoryBuilder调用XMLConfigBuilder对象的parse()方法。

4.XMLConfigBuilder对象解析XML配置文件返回Configuration对象。

5.SqlSessionFactoryBuilder根据Configuration对象创建一个DefaultSessionFactory对象。

6.SqlSessionFactoryBuilder返回DefaultSessionFactory对象给客户端，供客户端使用。

配置文件属性

MyBatis的配置文件包含了如下结构：

1.properties属性

properties中的属性都是可外部配置且可动态替换的，既可以在典型的Java属性文件中配置，也可以通过properties元素的子元素来传递。

2.settings设置

settings是MyBatis中非常重要的设置，会改变MyBatis的运行时行为，settings元素示例如下：

  1 <settings>
  2     <!--指定Mybatis所用日志的具体实现，开启日志-->
  3     <setting name="logImpl" value="Log4J"/>
  4     <!--开启二级缓存-->
  5     <setting name="cacheEnabled" value="true"/>
  6 </settings>

其他选项，开发项目时可以按需查询使用，下面列出部分参数：

参数	描述	有效值
cacheEnabled	该配置影响所有映射器缓存的全局开关	true/false
lazyLoadingEnabled	延迟加载的全局开关	true/false
useGenaratedKeys	允许JDBC支持自动生成主键	true/false
logImpl	指定MyBatis所用日志的具体实现，未指定时自动查找	SLF4J/LOG4J/LOG4J2

1.tpyeAliases类型命名

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

  1 <typeAliases>
  2     <typeAlias type="User" alias="com.snow.dcl.domain.User"/>
  3 </typeAliases>

这样配置时，User可以用在任何使用com.snow.dcl.domain.User的地方。

  1 <typeAliases>
  2     <package name="com.snow.dcl.domain"/>
  3 </typeAliases>

这样配置时，每一个在com.snow.dcl.domain包中的Java Bean，在没有注解的情况下，会使用Bean的首字母小写的非限定类名来作为别名，例如：com.snow.dcl.domain.User别名为user。

  1 @Alias("user")
  2 public class User {
  3     ...
  4 }

若有注解，则别名为注解值。

1.typeHandlers类型处理器

无论是MyBatis在预处理语句（PreparedStatement）中设置一个参数时，还是从结果集中取出一个值时，都会用类型处理器将获取的值以合适的方式转换成Java类型。

2.objectFactory对象工厂

MyBatis每次创建结果对象的新实例时，都会使用一个对象工厂实例来完成。

3.plugins插件

4.environments环境
   environment环境变量
   transactionManager事务管理器
   dataSource数据源

MyBatis的环境配置实际就是数据源的配置。MyBatis可以配置多种环境，这种机制使得MyBatis可以将SQL映射应用于多种数据库中。

注意：

尽管可以配置多个环境，但是每个SqlSessionFactory实例只能选择一个环境。所以若想连接两个数据库，需要创建两个SqlSessionFactory实例。

前文配置内容如下：

  1 <!--环境配置，连接的数据库-->
  2 <environments default="mysql">
  3     <environment id="mysql">
  4         <!--指定事务管理的类型，这里简单使用Java的JDBC的提交和回滚设置-->
  5         <transactionManager type="JDBC"></transactionManager>
  6         <!--dataSource 指连接源配置，POOLED是JDBC连接对象的数据源连接池的实现-->
  7         <dataSource type="POOLED">
  8             <property name="driver" value="com.mysql.jdbc.Driver"></property>
  9             <property name="url" value="jdbc:mysql://127.0.0.1:3306/mybatis?useUnicode=true&amp;characterEncoding=UTF-8"></property>
 10             <property name="username" value="root"></property>
 11             <property name="password" value="****"></property>
 12         </dataSource>
 13     </environment>
 14 </environments>

默认的环境ID（default="mysql"）。

每个environment元素定义的环境ID（id="mysql"）。

事务管理器配置（ type="JDBC"）。

数据源的配置（type="POOLED"）。

环境ID可以随意命名，默认环境ID一定要匹配定义的其中一个环境ID。

1.databaseIDProvider数据库厂商标识

2.mappers映射器

MyBatis开着需要自己写SQL语句，mapper映射器配置告诉MyBatis到哪里去找映射文件，进而找到这些SQL语句：

  1 <mappers>
  2     <!--告诉Mybatis持久化类的映射文件路径-->
  3     <mapper resource="mapping/UserMapper.xml"></mapper>
  4 </mappers>

以上就是对MyBatis的结构和配置文件记录。