一起学MyBatis之入门篇（2）

概述

本文主要讲解MyBatis中类型转换的功能，其实在MyBatis中，提供了默认的数据类型之间的转换，但只是基本数据类型的转换，如果跨类型进行转换，则需要自定义转换类，如java中是boolean类型，在数据库中则是int类型，则需要进行java类型到jdbc类型的转换，仅供学习分享使用，如有不足之处，还请指正。

转换方法

实现类型转换有两种方法，本文主要采用第2种方法。如下所示：

1. 实现TypeHandler 接口，但是比较麻烦。
2. 继承BaseTypeHandler<T>基类，实现抽象方法，其中T表示待转换类型，即Java中的源类型。

应用场景

说明：

1. 有一个Student类，属性stuSex性别是Boolean类型，true表示男，false表示女，
2. 在数据库中有一个Student表，stuSex字段，是int类型，1表示男，0表示女，
3. 则需要在java类型和jdbcType之间进行转换，才能正确显示。

类型转换实现步骤

1.新增BooleanAndIntConverter转换类，该类继承BaseTypeHandler<Boolean>基类，如下所示：

需要实现的抽象方法有4个【1个set方法（java-->jdbcType的转换），3个get方法（jdbcType-->java的转换）】，

package com.hex.converter;

import java.sql.CallableStatement;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;

import org.apache.ibatis.type.BaseTypeHandler;
import org.apache.ibatis.type.JdbcType;

/**
 * 类型转换器（java-jdbc之间的类型转换）
 * 方法：1.实现接口TypeHandler
 * 2.或者继承基类
 * @author Administrator
 * Boolean：表示待转换类型，即源类型
 */
public class BooleanAndIntConverter extends BaseTypeHandler<Boolean> {

    /**
     * 结果是可空的返回内容
     * rs:结果集
     * columeName：列名
     */
    @Override
    public Boolean getNullableResult(ResultSet rs, String columeName) throws SQLException {
        int num=rs.getInt(columeName);
        return num==1?true:false;
    }

    /***
     * 结果是可空的返回内容
     * rs:结果集
     * colomeIndex:列索引
     */
    @Override
    public Boolean getNullableResult(ResultSet rs, int columeIndex) throws SQLException {
        int num=rs.getInt(columeIndex);
        return num==1?true:false;
    }

    /**
     * 结果是可空的返回内容
     * cs:存储过程方式
     */
    @Override
    public Boolean getNullableResult(CallableStatement cs, int columeIndex) throws SQLException {
        int num=cs.getInt(columeIndex);
        return num==1?true:false;
    }

    /**
     * set表示 java--jdbc类型
     * ps:表示预编译的sql对象
     * i:表示修改的位置索引
     * parameter:表示参数的java类型
     * arg3:表示数据的类型
     */
    @Override
    public void setNonNullParameter(PreparedStatement ps, int i, Boolean parameter, JdbcType arg3) throws SQLException {
        // 如是true,则数据库类型为1，否则数据类型为false
        if(parameter){
            ps.setInt(i, 1);
        }else{
            ps.setInt(i, 0);
        }
    }
}

2. 在MyBatis的配置文件中，声明类型转换，和environments平级，如下所示：

jdbcType="INTEGER"是枚举类型，必须大写。

<typeHandlers>
    <typeHandler handler="com.hex.converter.BooleanAndIntConverter" javaType="Boolean" jdbcType="INTEGER" />
</typeHandlers>

3.定义一个Student类，该类有一个stuSex属性，是boolean类型

/**
* 性别
*/
private boolean stuSex;

public boolean isStuSex() {
    return stuSex;
}
public void setStuSex(boolean stuSex) {
    this.stuSex = stuSex;
}

4.查询时，需要在Mapper文件中进行配置类型转换，如下所示：

<resultMap type="Student" id="studentResult">
     <id property="stuId" column="stuId"/>
     <result property="stuName" column="stuName"/>
     <result property="stuAge" column="stuAge"/>
     <!-- 此处需要类型转换，需要说明一下:jdbcType的值必须大写，是枚举类型 -->
     <result property="stuSex" column="stuSex" javaType="boolean" jdbcType="INTEGER"/>
 </resultMap>
<select id="queryStudentById" resultMap="studentResult" parameterType="int">
    select * from Student where stuId = #{id}
</select>

注意：

如果jdbc类型和java的类型完全一致，则使用resultType，否则用resultMap
如果java中的字段名称和java中的字段名称一致，则用resultType，否则用resultMap

5. 增加StudentMapper接口，采用动态代理的方式进行调用

package com.hex.mybatis;

import java.util.List;

public interface StudentMapper {
    /**
     * 通过ID查询：动态代理 1. 函数名称和Mapper标签ID一致 2. 参数类型和parameterType对应的一致 3.
     * 返回值和resultType一致
     * 
     * @param pid
     * @return
     */
    Student queryStudentById(int pid);

    /**
     * 新增
     * 
     * @param student
     */
    void addStudent(Student student);

    
    /**
     * 通过地址查询学生
     * @param student
     * @return
     */
    List<Student> queryStudentByAddress(Student student);

}

6. 对于新增，则需要在语句中进行类型转换，如下所示：

如果需要类型转换，则需要如下写法：#{stuSex,javaType=boolean,jdbcType=INTEGER}，进行boolean和INTEGER类型的转换

<insert id="addStudent" parameterType="Student" >
    insert into Student(stuId,stuName,stuAge,stuSex)values(#{stuId},#{stuName},#{stuAge},#{stuSex,javaType=boolean,jdbcType=INTEGER})
</insert>

对于入参，即ParameterType，有以下几点，需要注意：

1. 如果是 简单类型（8个基本类型+String）：
   • 可以采用#{id}方式，其中id可以任意值，且会自动进行类型转换，给String类型加上单引号，可以防止SQL注入。
   • 可以采用${value}的方式写，必须是value，不可以写其他，且原样输出，不会给String加上单引号，不可以防止SQL注入。
2. 如果是复杂类型，则需要写属性名，两者都一样

级联属性

假如学生有两个属性：homeAddress（家庭地址），schoolAddress（学校地址），有一个Address地址类，包含这两个属性，如下所示：

public class Address {
    
    /**
     * 家庭住址
     */
    private String homeAddress;
    /**
     * 学校住址
     */
    private String schoolAddress;
    
    public String getHomeAddress() {
        return homeAddress;
    }
    public void setHomeAddress(String homeAddress) {
        this.homeAddress = homeAddress;
    }
    public String getSchoolAddress() {
        return schoolAddress;
    }
    public void setSchoolAddress(String schoolAddress) {
        this.schoolAddress = schoolAddress;
    }
}

而Student类中有一个地址属性，如下所示：

    /**
     * 地址
     */
    private Address address;
    
    public Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }

以下进行模糊查询，在Mapper文件中配置，如下所示：

<select id="queryStudentByAddress" resultMap="studentResult" parameterType="int">
    select * from Student where homeAddress like  '%${address.homeAddress}%' and schoolAddress like '%${address.schoolAddress}%'
</select>

此处采用${address.homeAddress}进行模糊查询，而不是#{xxxx}的方式，方便拼接。

采用动态代理的方式测试代码如下：

public static void main(String[] args) throws IOException {
    //以输入流的方式加载配置文件
    String resource = "mybatis-config.xml";
    InputStream inputStream = Resources.getResourceAsStream(resource);
    //创建SqlSessionFactory对象,build第二个参数指定environment的id，，如果不写，默认配置default.
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    //创建会话对象
    SqlSession session = sqlSessionFactory.openSession();

    StudentMapper mapper=session.getMapper(StudentMapper.class);
//    Student student =  mapper.queryStudentById(2);
//    System.out.println(student);
//    System.out.println("查询成功");
//    Student student2=new Student(2,"lili",true,20);
//    mapper.addStudent(student2);
//    session.commit();
//    System.out.println("新增成功");
    //关闭会话对象
    Student student =new Student();
    Address address=new Address("S","S");
    student.setAddress(address);
     List<Student> lstStudents =    mapper.queryStudentByAddress(student);
     for(Student s : lstStudents){
        System.out.println(s);
     }
     System.out.println("查询成功");
    session.close();
}
    

配置别名

因为本类中会频繁用到，所示配置了别名，方便使用，如下所示：

<!-- 设置别名，忽略大小写，当一个类频繁用到时，则可以定义别名 -->
<typeAliases>
    <!-- 每一个类，定义一个别名 -->
    <!-- <typeAlias type="com.hex.mybatis.Product" alias="product" /> -->
        
    <!-- 以下批量定义别名，所有包里面的类名，就是别名 -->
    <package name="com.hex.mybatis"/>
    <!-- 除了自定义别名，MyBatis还内置了需要别名 -->
</typeAliases>

备注

日出未必意味着光明，太阳也无非是一颗晨星；只有在我们醒着时，才是真正的破晓 ！！！