Java技术栈程序员Java学习笔记

深入MyBatis配置文件

2018-01-14  本文已影响83人  程序员七哥

我们都知道MyBatis的持久化操作离不开SqlSessionFactory对象,这个对象是整个数据库映射关系经过编译后的内存镜像,该对象的openSession()方法可以打开SqlSession对象.该对象由由SqlSessionFactoryBuilder加载MyBatis的配置文件产生.

先贴一张MyBatis初始化的基本过程,如下图:


上图所示,MyBatis初始化要经过以下几步:

  1. 调用SqlSessionFactoryBuilder对象的build(inputStream)方法;
  2. SqlSessionFactoryBuilder会根据输入流inputStream等信息创建XMLConfigBuilder对象;
  3. SqlSessionFactoryBuilder调用XMLConfigBuilder对象的parse()方法;
  4. XMLConfiguBuilder对象解析XML配置文件返回Configuration对象;
  5. SqlSessionFactoryBuilder根据Configuration对象创建一个DefaultSessionFactory对象;
  6. SqlSessionFactoryBuilder返回DefaultSessionFactory对象给客户端,供客户端调用;

由此可见,SqlSessionFactory是根据MyBatis的配置文件mybatis-config.xml创建的,接下来我们就来重点研究下MyBatis配置文件中常用属性的意义.

MyBatis的配置文件结构

MyBatis的配置文件包含了影响MyBatis行为的信息,文档的结构如下:
顶层configuration配置

properties属性

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

可以再CLASSPATH中增加一个db.properties的Java属性文件.

driver=oracle.jdbc.driver.OracleDriver
ur=jdbc:oracle:thin:@127.0.0.1:1526:mybatis
username=root
password=root

在配置文件中配置<properties.../>属性:
<properties resource="db.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>

settings设置

一个配置完成的settings元素示例如下,具体含义这里不再列举,可以自行google.


typeAliases 类型命名

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

<typeAliases>
  <typeAlias alias="user" type="org.ccgogoing.domian.User"/>
</typeAliases>

当这样配置时,user可以用在任何使用org.ccgogoing.domain.User的地方.
也可以指定一个包名,MyBatis会在包名下面搜索需要的Java Bean

<typeAliases>
  <package name="org.ccgogoing.domian"/>
</typeAliases>

每一个在包org.ccgogoing.domain中的Java Bean,在没有注解的情况下,会使用Bean的首字母小写的非限定类名来作为它的别名.比如org.ccgogoing.domain.User的别名为user,若有注解,则别名为其注解值.

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

typeHandlers 类型处理器

无论是MyBatis在预处理语句(preparedStatement)中设置一个参数时,还是从结果集中取出一个值时,都会用类型处理器将获取的值以合适的方式转换成Java类型,下图描述了一些默认的类型处理器.

objectFactory 对象工厂

MyBatis每次创建结果对象的新实例时,它都会使用一个对象工厂(ObjectFactory)实例来完成.默认的对象工厂需要做的仅仅是实例化目标类,要么通过默认构造方法,要买在参数映射存在的时候通过参数构造方法来实例化.如果想覆盖对象工厂的默认行为,则可以通过创建自己的对象工厂来实现.

environments 配置环境

MyBatis的环境配置实际就是数据源的配置.MyBatis可以配置多种环境,这种机制使得MyBatis可以将SQL映射应用于多种数据库中.例如,开发,测试盒生产环境需要不同的配置;多个生产数据库想使用相同的sql映射,等等.

尽管可以配置多个环境,但是每个SqlSessionFactory实例只能选择一个环境,即每个数据库对应一个SqlSessionFactory实例.所以如果你想连接两个数据库,就需要创建两个SqlSessionFactory实例,每个数据库对应一个.

环境配置示例如下:

    <environments default="development">
        <environment id="development">
            <!--指定事务管理类型,type="JDBC"指直接简单使用了JDBC的提交和回滚事务-->
            <transactionManager type="JDBC"></transactionManager>
            <!-- dateSource指定数据源配置,POOLED是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>

默认的环境ID(default="development");
每个environment元素定义的环境ID(比如,id="development").
环境ID可以随意命名,建议简洁有意义,而默认环境一定要匹配定义的其中一个环境ID.
<transactionManager.../>表示事务管理配置,在MyBatis中有JDBC和MANAGED两中类型的事务管理器:

            <transactionManager type="MANAGED">
                <property name="closeConnection" value="false"/>
            </transactionManager>

提示: 如果开发使用Spring+MyBatis,则没有必要配置事务管理器,因为Spring模块会使用自带的管理器来覆盖前面的配置.

<dataSource.../>表示数据源配置,在MyBatis中有UNPOOLED、POOLED和JNDI三种数据源类型：

mapper 映射器

MyBatis需要开发者自己写sql语句,mapper映射器正是告诉MyBatis到哪里去找映射文件,进而找到这些sql语句.实际开发中可以使用相对于类路径的资源引用或完全限定资源定位符(包括file:///的URL),以及类名和包名等,例如:

    <!-- 使用类路径查找资源文件 -->
    <mappers>
        <mapper resource="com/ccgogoing/fileupload/mapper/sqlmap-mapping-user.xml"/>
    </mappers>
    <!-- 使用本地文件 -->
    <mappers>
        <mapper url="file:///C:/mapper/UserMapper.xml">
    </mappers>
    <!-- 使用接口类 -->
    <mappers>
        <mapper class="org.ccgogoing.mapper.UserMapper"
    </mappers>
    <!-- 使用包名 -->
    <mappers>
        <package name="org.ccgogoing.mapper"/>
    </mappers>

mapper映射器会告诉MyBatis去哪里找映射文件,剩下的细节就是每个SQL映射文件了,我会在接下来的文章中详细说明这部分知识.

上一篇 下一篇

猜你喜欢

热点阅读