mybatis学习笔记(2):conf文件配置项

素颜马尾好姑娘i 2022-05-21 04:55 163阅读 0赞

在配置文件中配置项必须按一定的顺序配置，否则会报错，顺序如下:

*  properties
 *  settings
 *  typeAliases
 *  typeHandlers
 *  objectFactory
 *  objectWrapperFactory
 *  plugins
 *  environments
 *  databaseIdProvider
 *  mappers

--------------------

## properties ##

`<properties>`元素是最先被解析的，设置的属性值将会被其他元素所使用。所以需要在配置文件中的最前面配置。  
我们可以在这个标签下直接定义一些属性供下面配置项使用，也可以引入外部属性文件，下面介绍引入外部属性文件的方式：

<properties resource="db.properties"></properties>
        
        <environments default="dev">
            
            <environment id="dev">
                
                <transactionManager type="JDBC" />
                <dataSource type="POOLED">
                    <property name="driver" value="${dev_driver}" />
                    <property name="url" value="${dev_url}" />
                    <property name="username" value="${dev_username}" />
                    <property name="password" value="${dev_password}" />
                </dataSource>
            </environment>
        </environments>

外部属性文件db.properties：  
![这里写图片描述][70]

--------------------

## settings ##

settings是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。比较常用的如设置驼峰命名规则（camel case）映射:

设置为true即可以将数据库列名 A\_COLUMN 映射为 Java 属性名 aColumn 。  
下面是所有的settings：

--------------------

## typeAliases ##

这个元素主要是用于对类型进行别名控制，可以给Mapper XML文件中使用的实体类取个别名，以达到简化操作的目的。  
看看之前配置的Mapper XML的配置：

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    
    <mapper namespace="com.mybatis.mapper.EmployeeMapper">
        
        <select id="getEmpById" resultType="com.mybatis.domian.Employee">
            select * from tbl_employee where id = #{id}
        </select>
    
        <insert id="addEmp" parameterType="com.mybatis.domian.Employee">
            insert into tbl_employee(last_name,gender,email) values(#{lastName},#{gender},#{email})
        </insert>
    
        <update id="updateEmp" parameterType="com.mybatis.domian.Employee">
            update tbl_employee set last_name = #{lastName} where id=#{id}
        </update>
    
        <delete id="deleteEmp" parameterType="Integer">
            delete from tbl_employee where id=#{id}
        </delete>
        
        <select id="getAll" resultType="com.mybatis.domian.Employee">
            select * from tbl_employee
        </select>
    </mapper>

可以看到里面使用的parameterType和resultType使用的Employee类用的都是全类名，如果要改这个类名的话，我们需要在多个地方进行修改，感觉很繁琐。很明显，这样配置的话很容易造成修改上的遗漏，同时也书写上也比较麻烦。因此，MyBatis为我们提供了一个简单方便的配置方法，那就是使用`<typeAliases>`标签元素，给实体类设置一个别名。

这样在Mapper XML文件中就可以使用 emp代替Employee全类名，方便统一管理。  
备注：这里需要注意的是，typeAliases配置需要放置在settings之后，否则会出异常！

<?xml version="1.0" encoding="UTF-8" ?>
    <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
    
    <mapper namespace="com.mybatis.mapper.EmployeeMapper">
        
        <select id="getEmpById" resultType="emp">
            select * from tbl_employee where id = #{id}
        </select>
    
        <insert id="addEmp" parameterType="emp">
            insert into tbl_employee(last_name,gender,email) values(#{lastName},#{gender},#{email})
        </insert>
    
        <update id="updateEmp" parameterType="emp">
            update tbl_employee set last_name = #{lastName} where id=#{id}
        </update>
    
        <delete id="deleteEmp" parameterType="Integer">
            delete from tbl_employee where id=#{id}
        </delete>
        
        <select id="getAll" resultType="emp">
            select * from tbl_employee
        </select>
    </mapper>

然而如果实体类比较多，还是要配置很多实体类和别名，还是会很繁琐。所以上面这种方式在实际应用中并常用，下面介绍一个常用的方式:

这种方式可以扫描指定的包内的所有类，并为之创建别名。默认别名为类名首字母小写，如com.mybatis.domain.Employee会自动取别名为employee.  
这种方式可以配合@Alias注解使用：  
@Alias注解在实体类上可以为之指定别名，配合包扫描的方式使用起来更灵活。如：

@Alias("emp") //指定别名为emp
    public class Employee {
    ...
    }

上面指定Employee 类别名为emp，这样在Mapper XML文件中就可以使用这个别名代替Employee 全类名。

--------------------

[70]: /images/20220521/683a4298a6764cc49e6c44f4baf7c7d1.png