MyBatis XML配置

Mybatis的配置文件会深深影响MyBatis的行为设置和属性信息

配置层次结构如下:

<configuration>
  <properties/>
  <settings/>
  <typeAliases/>
  <typeHandlers/>
  <objectFactory/>
  <plugins/>
  <environments/>
  <databaseIdProvider/>
  <mappers/>
</configuration>

配置参数必须按照上述顺序进行配置

properties

可以由外部配置动态替换,也可以通过 properties 元素的子元素来传递。

<properties resource="config.properties">
    <propertie name="username" value="dankun"/>
</properties>

可以用来替换配置文件需要动态配置的属性值

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

settings

这是MyBatis中极为重要的调整，它们会改变Mybatis的行为

typeAliases

typeAliases是为Java类型设置一个短的名字。只和XML配置有关，存在意义用来减少类完全限定名的冗余。

<typeAliases>
  <typeAlias alias="Author" type="domain.blog.Author"/>
</typeAliases>

同时也指定一个包名。Mybatis会在包名下面搜索需要的JavaBean

<typeAliases>
  <package name="domain.blog"/>
</typeAliases>

同时可以使用注解值作为别名

@Alias("author")
public class Author {}

typeHandlers

我们知道Java有自己的数据类型,数据库有自己的数据类型。我们往数据库中插入数据时候如何把Java类型当成数据库类型插入数据库，又是如何把数据库类型当成Java类型处理呢?通过TypeHandler类型处理器，可以实现Java类型和数据库类型互相转换。

TypeHandler接口
需要自定义自己的TypeHandler就需要实现TypeHandler接口

public interface TypeHandler<T> {  
// 用于定义Mybatis设置参数时如何把Java对象转换为对应的数据库类型
void setParameter(PreparedStatement ps, int i, T parameter,  
           JdbcType jdbcType) throws SQLException; 
}

// 用于在Mybatis获取数据结果集时如何把数据库类型转换为对应的Java类型 
T getResult(ResultSet rs, String columnName) throws SQLException;  

// 用于在Mybatis通过字段位置获取字段数据时把数据库类型转换为对应的Java类型 
T getResult(ResultSet rs, int columnIndex) throws SQLException;  

// 用于Mybatis在调用存储过程后把数据库类型的数据转换为对应的Java类型
T getResult(CallableStatement cs, int columnIndex) throws SQLException;

实例演示
假设我们有一个需求,在数据库存储是Varchar类型格式为[Music,Movie,NBA]。在JavaBean 中存储类型为String[]。
javaBean 文件

@Data
@NoArgsConstructor
public class Student {
    private int id;
    private int studentID;
    private String[] name;

    public Student(int id, int studentID, String[] name) {
        this.id = id;
        this.studentID = studentID;
        this.name = name;
    }
}

首先我们自定义一个TypeHandler

public class StringArratTypeHandler implements TypeHandler<String[]> {
    @Override
    public void setParameter(PreparedStatement preparedStatement, int i, String[] parameter, JdbcType jdbcType) throws SQLException {
        if(parameter == null) {
            preparedStatement.setNull(i, Types.VARCHAR);
        } else {
            StringBuffer result = new StringBuffer();
            for (String value: parameter) {
                result.append(value).append(",");
            }
            result.deleteCharAt(result.length() -1);
            preparedStatement.setString(i, result.toString());
        }
    }

    @Override
    public String[] getResult(ResultSet resultSet, String s) throws SQLException {
        String columeValue = resultSet.getString(s);
        return this.getStringArray(columeValue);
    }

    @Override
    public String[] getResult(ResultSet resultSet, int i) throws SQLException {
        String columeValue = resultSet.getString(i);
        return this.getStringArray(columeValue);
    }

    @Override
    public String[] getResult(CallableStatement callableStatement, int i) throws SQLException {
        String columeValue = callableStatement.getString(i);
        return this.getStringArray(columeValue);
    }

    private String[] getStringArray(String columnValue) {
        if (columnValue == null) {
            return null;
        }
        return columnValue.split(",");
    }
}

在mybatis配置文件中配置

<typeHandlers>
        <typeHandler handler="com.demo.StringArratTypeHandler" javaType="[Ljava.lang.String;" jdbcType="VARCHAR"/>
</typeHandlers>

定义mapper.xml文件

<resultMap id="StudentHandler" type="Student">
        <id column="id" property="id"></id>
        <result column="name" property="name" javaType="[Ljava.lang.String;" jdbcType="VARCHAR"/>
    </resultMap>

    <select id="findHandlerById" parameterType="int" resultMap="StudentHandler">
        select * from student where id= #{id}
    </select>

测试文件

@Test
    public void testFindHandlerById() {
        Student student = session.selectOne("com.dankun.findHandlerById",5);
        System.out.println(student);
        
    }

自动获取TypeHandler

我们定义了对应name的映射关系，并且定义了javaType为[Ljava.lang.String;jdbcType为VARCHAR，这时候Mybatis就会到已注册的TypeHandler中寻找到能处理javaType和jdbcType对应的类型转换的TypeHandler来进行处理。这里我们寻找StringArrayTypeHandler。
我们可以在mapper.xml文件中不指定javaType和jdbcType，但是通过typeHandler属性指定将以StringArrayTypeHandler来进行类型转换。

<result column="name" property="name" typeHandler="com.demo.StringArratTypeHandler"/>