一、Mybatis配置详解

2023-08-09 22:11:04

Mybatis配置详解

XML配置文件层次结构

下图展示了mybatis-config.xml的全部配置元素

properties元素

properties是一个配置属性的元素，让我们能在配置文件的上下文中使用它，MyBatis提供3种配置方式。

property子元素。

<property name="driver" value="com.mysql.jdbc.Driver"/>

properties配置文件。

一般情况下，我们会使用一个单独的properties配置文件来配置属性值，以方便我们在多个配置文件中重复使用它们，也方便日后维护和随时修改。我们可以通过${key}的形式，取出在配置文件中配置的值。

<configuration>

    <!-- 引入配置文件 -->

    <properties resource="datasource.properties"/>

    <environments default="dev">

        <environment id="dev">

            <transactionManager type="JDBC"/>

            <dataSource type="POOLED">

                <!-- 使用配置文件中的属性 -->

                <property name="driver" value="${driver}"/>

                <property name="url" value="${url}"/>

                <property name="username" value="${username}"/>

            </dataSource>

        </environment>

    </environments>

</configuration>

SqlSessionFactoryBuilder使用Properties文件构建。

出于安全考虑，properties配置文件中的账号密码等元素可能是加密的，这个时候就需要对加密的元素进行处理。

public static void func() throws Exception {

    Properties properties = new Properties();

    properties.load(Resources.getResourceAsStream("datasource.properties"));

    // 对原账号密码解密

    properties.setProperty("username", decode(properties.getProperty("username")));

    properties.setProperty("password", decode(properties.getProperty("password")));

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

    // SqlSessionFactoryBuilder可以使用一个InputStream和一个Properties构建SqlSessionFactory

    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is, properties);

}

settings设置

settings（设置）在MyBatis中是最复杂的配置，它会改变 MyBatis 运行时的行为。

typeAliases别名

别名（typeAliases）是一个指代的名称。因为我们遇到的类全限定名过长，所以我们希望用一个简短的名称去指代它，而这个名称可以在MyBatis上下文中使用，在 MyBatis中别名是不分大小写的。一个 typeAliases的实例是在解析配置文件时生成的，然后长期保存在 Configuration对象中，这样就没有必要运行的时候再次生成它的实例了。

系统定义的别名

通过org.apache.ibatis.type.TypeAliasRegistry可以查看所有系统定义的别名，主要是基本数据类型、字符串、基本数据类型数组、日期、容器类。
通过XML自定义别名

在mybatis-config.xml中通过<typeAliases>元素可以自定义别名。
```
<typeAliases>

    <typeAlias type="com.zl.domain.UserDomain" alias="user"/>

</typeAliases>
```
通过注解的方式自定义别名

在mybatis-config.xml中添加package扫描包
```
<typeAliases>

    <package name="com.zl.domain"/>

</typeAliases>
```
```
@Alias("user")

public class UserDomain {

}
```
当配合上面的配置，MyBatis就会自动扫描包，将扫描到的类装载到上下文中。如果配置了包扫描的路径，而没有注解@Alias的类也会被MyBatis装载，MyBatis会自动把类名的第一个字母变为小写，作为MyBatis的别名。

typeHandler类型转换器

typeHandler为类型处理器。MyBatis在预处理语句（PreparedStatement）中设置一个参数或者从结果集（ResultSet）中取出一个值时，都会用注册了的typeHandler进行处理。typeHandler常用的配置为Java类型（javaType）、JDBC类型（jdbcType）。typeHandler的作用就是将参数从javaType转化为 jdbcType，或者从数据库取出结果时把jdbcType转化为javaType。

具体详见：Mybatis类型转换介绍 TypeHandler

objectFactory对象工厂

当MyBatis在构建一个结果返回的时候，都会使用ObjectFactory（对象工厂）去构建POJO，我们可以定制自己的对象工厂。MyBatis中默认的ObjectFactory是由DefaultObjectFactory来提供服务的。

environments环境变量

<environments default="dev">

    <environment id="dev">

        <transactionManager type="JDBC"/>

        <dataSource type="POOLED">

            <property name="driver" value="${driver}"/>

            <property name="url" value="${url}"/>

            <property name="username" value="${username}"/>

        </dataSource>

    </environment>

</environments>

default：表示默认使用哪个数据源
id：表示数据源的名称
transactionManager的事务类型type一共有三种：JDBC，采用JDBC方式管理事务，独立编码中我们常常使用；MANAGED，采用容器方式管理事务，在JNDI数据源中常用；自定义，由使用者自定义数据库事务管理办法，适用于特殊应用。
property元素配置数据源的各类属性
dataSource的type属性是提供我们对数据厍连接方式的配置：UNPOOLED（非连接池数据库）、POOLED（连接池数据库）、JNDI（JNDI数据源）、自定义数据源。

码农公寓