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的结构和配置文件记录。

posted @ 2019-11-22 14:13  Dcl_Snow  阅读(301)  评论(0编辑  收藏  举报