Mybatis 的中高级特性使用

最新推荐文章于 2024-06-02 12:31:55 发布

一条柴_Alex

最新推荐文章于 2024-06-02 12:31:55 发布

阅读量1.2k

点赞数

分类专栏： # ORM 文章标签： mybatis java mysql

本文链接：https://blog.csdn.net/Alex_cf/article/details/128760753

版权

ORM 专栏收录该内容

6 篇文章 0 订阅

订阅专栏

简介：

MyBatis 的真正强大在于它的语句映射，这是它的魔力所在。由于它的异常强大，映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比，你会立即发现省掉了将近 95% 的代码。MyBatis 致力于减少使用成本，让用户能更专注于 SQL 代码。

SQL 映射文件只有很少的几个顶级元素（按照应被定义的顺序列出）：

关于每个顶级元素具体属性的详解，请移步官网： mybatis – MyBatis 3 | XML 映射器

本文只是针对新手开发中常见的几个问题，如何处理进行讲解：

1、自定义映射resultMap

1.1 resultMap处理字段和属性的映射关系

若字段名和实体类中的属性名不一致，则可以通过resultMap设置自定义映射

官方介绍中说，resultMap属性是对对外部 resultMap 的命名引用。结果映射是 MyBatis 最强大的特性，如果你对其理解透彻，许多复杂的映射问题都能迎刃而解。 resultType 和 resultMap 之间只能同时使用一个。

resultMap 是Select标签中一个重要的属性之一：如下图

<select
  id="selectPerson"
  parameterType="int"
  parameterMap="deprecated"
  resultType="hashmap"
  resultMap="personResultMap"
  flushCache="false"
  useCache="true"
  timeout="10"
  fetchSize="256"
  statementType="PREPARED"
  resultSetType="FORWARD_ONLY">

之前你已经见过简单映射语句的示例，它们没有显式指定 resultMap。比如：

<select id="selectUsers" resultType="map">
  select id, username, password
  from t_user
  where id = #{id}
</select>

或者，我们用一个实例对象来接收数据库的查询结果

<select id="selectUsers" resultType="User">
  select *
  from t_user
  where id = #{id}
</select>

但是，上述条件是数据库表的列名与实例对象的属性名是一致的情况。如果二者不一致呢？该如何去做？

我们面试的时候，经常会遇到有面试官会问，数据库表的字段名和实体对象的属性名不一致，我们如何操作，

其实解决这个问题有很多办法。

比如利用SQL语法里的 as

<select id="selectUsers" resultType="User">
  select
    user_id             as "id",
    user_name           as "userName",
    user_password       as "password"
  from some_table
  where id = #{id}
</select>

我们还可以显示的配置一个外部resultMap 这也是解决列名不匹配的另外一种方式。

<!--
resultMap：设置自定义映射
属性：
id：表示自定义映射的唯一标识
type：查询的数据要映射的实体类的类型
子标签：
id：设置主键的映射关系
result：设置普通字段的映射关系
association：设置多对一的映射关系
collection：设置一对多的映射关系
属性：
property：设置映射关系中实体类中的属性名
column：设置映射关系中表中的字段名
-->

    <resultMap id="userMap" type="user">
        <id property="id" column="id"></id>
        <result property="userName" column="username"></result>
        <result property="passWord" column="password"></result>
        <result property="age" column="age"></result>
        <result property="gender" column="gender"></result>
    </resultMap>

    <select id="getMohu" resultMap="userMap"  >
        <!-- select * from t_user where gender like '%${keyword}%'-->
        <!--select * from t_user where username like concat('%',#{keyword},'%')-->
        select * from t_user where email like "%"#{keyword}"%"
    </select>

若字段名和实体类中的属性名不一致，但是字段名符合数据库的规则（使用_），实体类中的属性名符合Java的规则（使用驼峰）

此时也可通过以下两种方式处理字段名和实体类中的属性的映射关系:

1、可以通过为字段起别名的方式，保证和实体类中的属性名保持一致

2、可以在MyBatis的核心配置文件中设置一个全局配置信息mapUnderscoreToCamelCase，可以在查询表中数据时，自动将_类型的字段名转换为驼峰

例如：字段名user_name，设置了mapUnderscoreToCamelCase，此时字段名就会转换为 userName

1.2、多对一映射处理

场景模拟：查询员工信息以及员工所对应的部门信息

1.2.1 级联方式处理映射信息

我们先看一下用原生Sql语句实现的效果：

SELECT emp.* ,dept.* FROM t_emp emp LEFT JOIN t_dept dept ON emp.`dept_id`=dept.`dept_id` WHERE emp.`emp_id`=1;

代码实现：


public class Emp{

    private Integer eid;
    private String ename;
    private Integer age;
    private String gender;
    private Dept dept;

    @Override
    public String toString() {
        return "Emp{" +
                "eid=" + eid +
                ", ename='" + ename + '\'' +
                ", age=" + age +
                ", dept=" + dept +
                ", gender='" + gender + '\'' +
                '}';
    }



    public Integer getEid() {
        return eid;
    }

    public void setEid(Integer eid) {
        this.eid = eid;
    }

    public String getEname() {
        return ename;
    }

    public void setEname(String ename) {
        this.ename = ename;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getGender() {
        return gender;
    }

    public void setGender(String gender) {
        this.gender = gender;
    }



}


public class Dept {
    private Integer did;
    private String dname;

    public String getDname() {
        return dname;
    }

    public void setDname(String dname) {
        this.dname = dname;
    }

    public Integer getDid() {
        return did;
    }

    public void setDid(Integer did) {
        this.did = did;
    }

    @Override
    public String toString() {
        return "dept{" +
                "did=" + did +
                ", dname='" + dname + '\'' +
                '}';
    }
}

接口添加方法：

  Emp getEmpAndDeptByEid(@Param("id")int id);

    <resultMap id="empDeptMap" type="Emp">
        <id column="emp_id" property="eid"></id>
        <result column="emp_name" property="ename"></result>
        <result column="age" property="age"></result>
        <result column="gender" property="gender"></result>
        <result column="dept_id" property="dept.did"></result>
        <result column="dept_name" property="dept.dname"></result>

    </resultMap>

<!--    getEmpAndDeptByEid-->

    <select id="getEmpAndDeptByEid" resultMap="empDeptMap">
        SELECT emp.* ,dept.* FROM t_emp emp LEFT JOIN t_dept dept ON emp.`dept_id`=dept.`dept_id` WHERE emp.`emp_id`=#{id}
    </select>

测试输出：

输出：

Emp{eid=1, ename='小黑', age=20, dept=dept{did=1, dname='A'}, gender='女'}

1.2.2、使用association处理映射关系

<resultMap id="empDeptMap" type="Emp">
        <id column="emp_id" property="eid"></id>
        <result column="emp_name" property="ename"></result>
        <result column="age" property="age"></result>
        <result column="gender" property="gender"></result>
      <association property="dept" javaType="Dept">
          <id column="dept_id" property="did"></id>
          <result column="dept_name" property="dname"></result>
      </association>
    </resultMap>

1.2.3 分步查询

建立两个实体 Emp 和 Dept 分别代表员工和部门。

建立对应的mapper接口。

创建对应的接口映射文件

此处我作为简化，把分步查询放在了同一个接口和映射文件中（EmpMapper.java 和 EmpMapper.xml）

①查询员工信息

public interface EmpMapper {

    /**
     * 通过分步查询查询员工信息
     *     分步查询:查询员工以及所在部门信息的第一步
     * @param eid
     * @return
     */
    Emp getEmpByStep1(@Param("eid") int eid);

    /**
     * 分步查询的第二步： 根据员工所对应的dept_id 查询部门信息
     * @param did
     * @return
     */
    Dept getEmpDeptByStep2(@Param("did") int did);


}

<resultMap id="empDeptStepMap" type="Emp">
    <id column="emp_id" property="eid"></id>
    <result column="emp_name" property="ename"></result>
    <result column="age" property="age"></result>
    <result column="gender" property="gender"></result>
    <!--
    select：设置分步查询，查询某个属性的值的sql的标识（namespace.sqlId）
    column：将sql以及查询结果中的某个字段设置为分步查询的条件
    -->
        <association property="dept" fetchType="eager"
                     select="com.alex.mybatis.mapper.EmpMapper.getEmpDeptByStep2" column="dept_id" ></association>
    </resultMap>

    <!--Emp getEmpByStep1(@Param("eid") int eid);-->
    <select id="getEmpByStep1" resultMap="empDeptStepMap">
        select * from t_emp where emp_id = #{eid}
    </select>

    <!--Dept getEmpDeptByStep2(@Param("did") int did);-->
    <resultMap id="deptMap" type="Dept">
        <id column="dept_id" property="did"></id>
        <result column="dept_name" property="dname"></result>
    </resultMap>
    <select id="getEmpDeptByStep2" resultMap="deptMap" >
        select * from t_dept where dept_id = #{did}
    </select>

可以这样理解：

t_emp和t_dept 是外键包含关系，传统意义上来说，我们查询的时候，要进行外连接。

我们现在如果想得到员工的个人信息，以及所在部门的个人信息（以实体对象的形式获得查询结果），可以分步进行。

1）我们根据 eid 获取从 t_emp 表中查询到的员工数据执行 step1方法，构建员工实体对象 emp

2) 由于Emp实体对象里，包含一个属性 Dept 类型的 dept对象，而表数据，只能给到我们具体的部门编号did。( did 是Dept对象的属性之一)

3）所以，我们要拿着这个did 去部门表t_dept 里查询部门信息。此时就利用了 association 标签里的 select 去执行 step2方法（column =dept_id 填写的是分步查询条件的数据库字段名，property 填写的是 Emp对象当前要被分步查询的属性名）

4）Emp实例对象构建完成，返回最终执行结果

Emp{eid=1, ename='小黑', age=20, dept=Dept{did=1, dname='A'}, gender='女'}

注意事项：一定要注意，对象属性名是否与表字段名一一对应，否则很有可能会报nullPoint 或查不到数据，

1.3 一对多映射处理

修改 Dept 如下



import java.util.List;

public class Dept {
    private Integer did;
    private String dname;

    private List<Emp> emps;  //多对一映射   一个部门可以有多个员工

    @Override
    public String toString() {
        return "Dept{" +
                "did=" + did +
                ", dname='" + dname + '\'' +
                ", emps=" + emps +
                '}';
    }

    public List<Emp> getEmps() {
        return emps;
    }

    public void setEmps(List<Emp> emps) {
        this.emps = emps;
    }



    public String getDname() {
        return dname;
    }

    public void setDname(String dname) {
        this.dname = dname;
    }

    public Integer getDid() {
        return did;
    }

    public void setDid(Integer did) {
        this.did = did;
    }

}

1.3.1、collection

public interface DeptMapper {

    /**
     *  根据部门id查新部门以及部门中的员工信息
     * * @param did
     * * @return
     */

    Dept getDeptEmpById(@Param("did") int did);
}

<?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.alex.mybatis.mapper.DeptMapper">


    <resultMap id="DeptMap" type="Dept">
        <id property="did" column="dept_id"></id>
        <result property="dname" column="dept_name"></result>
        <!--
        ofType：设置collection标签所处理的集合属性中存储数据的类型
        -->
        <collection property="emps" ofType="Emp">
            <id property="eid" column="emp_id"></id>
            <result property="ename" column="emp_name"></result>
            <result property="age" column="age"></result>
            <result property="gender" column="gender"></result>
<!--            <result property="dept.did" column="dept_id"></result>-->
<!--            <result property="dept.dname" column="dept_name"></result>-->
        </collection>
    </resultMap>

    <select id="getDeptEmpById" resultMap="DeptMap">
        select dept.*,emp.* from t_dept dept left join t_emp emp on dept.dept_id = emp.dept_id where dept.dept_id =#{did}
    </select>


</mapper>

输出结果

Dept{did=1, dname='A', emps=[Emp{eid=1, ename='小黑', age=20, dept=null, gender='女'}, Emp{eid=4, ename='赵六', age=26, dept=null, gender='男'}]}

1.3.2 分步查询

我们捋一捋思路：

现在两个关系中，谁是多，谁是1？

根据部门编号，查询该部门全部员工，显然部门是1，员工是多。

而且我们在Dept类中也表现出来了：

这种分步查询，其实效果类似子查询，更具体的说是一种相关子查询。

t_dept 的数据要代入到 t_emp中查询结果，所以 t_emp是被驱动表，t_dept 是驱动表。小表驱动大表

那么，我们分步查询的步骤就是这样：

1）先查询t_dept 的部门信息

2）再将dept_id的值带入 t_emp 查询员工信息。

DeptMapper 接口

/**
     * 分步查询1： 根据did 查询部门信息
     */

    Dept getDeptEmpStep1(@Param("did") int did);

EmpMapper 接口

 /**
     * 
     * 通过分步查询 部门的具体信息(该部门的所有信息包括员工信息)
     */
    Emp getDeptEmpStep2(@Param("did") int did);

DeptMapper.xml

!--    分步查询 查询部门全部信息-->
    <resultMap id="DeptEmpMap" type="Dept">
        <id property="did" column="dept_id"></id>
        <result property="dname" column="dept_name"></result>

        <collection property="emps" fetchType="eager"
                    select="com.alex.mybatis.mapper.EmpMapper.getDeptEmpStep2" column="dept_id"></collection>
    </resultMap>
    <select id="getDeptEmpStep1" resultMap="DeptEmpMap">
        select * from t_dept where dept_id =#{did}
    </select>

EmpMapper.xml

 <!-- 2分步查询 查询部门全部信息-->
    <resultMap id="empDeptMap" type="Emp">
        <id column="emp_id" property="eid"></id>
        <result column="emp_name" property="ename"></result>
        <result column="age" property="age"></result>
        <result column="gender" property="gender"></result>
        <association property="dept" javaType="Dept">
            <id column="dept_id" property="did"></id>
            <result column="dept_name" property="dname"></result>
        </association>
    </resultMap>
    <select id="getDeptEmpStep2" resultMap="empDeptMap">
        select * from t_emp where dept_id =#{did}
    </select>

测试输出：

Dept{did=1, dname='A',

emps=[Emp{eid=1, ename='小黑', age=20, dept=Dept{did=1, dname='null', emps=null}, gender='女'},

Emp{eid=4, ename='赵六', age=26, dept=Dept{did=1, dname='null', emps=null}, gender='男'}]}

代码仓库：https://github.com/Chai-Feng/git-demo01.git