parameterType(输入类型)

传递简单类型

使用#{}占位符，或者${}进行sql拼接

传递pojo对象

Mybatis使用ognl表达式解析对象字段的值，#{}或者${}括号中的值为pojo属性名称

传递pojo包装对象

开发中通过可以使用pojo传递查询条件

查询条件可能是综合的查询条件，不仅包括用户查询条件还包括其它的查询条件（比如查询用户信息的时候，将用户购买商品信息也作为查询条件），这时可以使用包装对象传递输入参数

包装对象：Pojo类中的一个属性是另外一个pojo

需求：根据用户名模糊查询用户信息，查询条件放到QueryVo的user属性中

• 编写QueryVo

package com.cuzz.pojo;

public class QueryVo {

    // 包含其他pojo
    
    public User user;
    
    public User getUser() {
        return user;
    }
    
    public void setUser(User user) {
        this.user = user;
    }
}

• sql语句
  SELECT * FROM user WHERE username LIKE '%张%'
• Mapper.xml文件

    <!-- 根据用户的名模糊查询 -->
    <select id="queryUserByQueryVo" parameterType="QueryVo" resultType="com.cuzz.pojo.User">
    SELECT * FROM `user` WHERE username LIKE "%"#{user.username}"%"
    </select>

• Mapper接口
  在UserMapper接口中添加方法

    // 根据包装类查询用户
    List<User> queryUserByQueryVo(QueryVo queryVo);

• 测试方法

@Test
public void testQueryUserByQueryVo() {
    // mybatis和spring整合，整合之后，交给spring管理
    SqlSession sqlSession = this.sqlSessionFactory.openSession();
    // 创建Mapper接口的动态代理对象，整合之后，交给spring管理
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

    // 使用userMapper执行查询，使用包装对象
    QueryVo queryVo = new QueryVo();
    // 设置user条件
    User user = new User();
    user.setUsername("张");
    // 设置到包装对象中
    queryVo.setUser(user);

    // 执行查询
    List<User> list = userMapper.queryUserByQueryVo(queryVo);
    for (User u : list) {
        System.out.println(u);
    }

    // mybatis和spring整合，整合之后，交给spring管理
    sqlSession.close();
}

resultType(输出类型)

输出简单类型

• 需求：查询用户表数据条数
• Sql
  SELECT count(*) FROM `user`
• Mapper.xml文件

    <!-- 查询用户的条数 -->
    <select id="queryUserCount" resultType="int">
        SELECT count(*) FROM `user`
    </select>

• Mapper接口
  int queryUserCount();

输出pojo对象

输出pojo列表

resultMap(输出类型)

resultType可以指定将查询结果映射为pojo，但需要pojo的属性名和sql查询的列名一致方可映射成功。

如果sql查询字段名和pojo的属性名不一致，可以通过resultMap将字段名和属性名作一个对应关系 ，resultMap实质上还需要将查询结果映射到pojo对象中。

resultMap可以实现将查询结果映射为复杂类型的pojo，比如在查询结果映射对象中包括pojo和list实现一对一查询和一对多查询。

• 需求：查询订单表order的所有数据
• Sql
  SELECT id, user_id, number, createtime, note FROM `order`

• 数据表

  
  
  image.png
• order对象

public class Order {
    // 订单id
    private int id;
    // 用户id
    private Integer userId;
    // 订单号
    private String number;
    // 订单创建时间
    private Date createtime;
    // 备注
    private String note;
}

• 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">
<!-- namespace：命名空间，用于隔离sql，还有一个很重要的作用，Mapper动态代理开发的时候使用，需要指定Mapper的类路径 -->
<mapper namespace="com.cuzz.mapper.OrderMapper">
    <!-- 查询所有的订单数据 -->
    <select id="queryOrderAll" resultType="order">
        SELECT id, user_id,
        number,
        createtime, note FROM `order`
    </select>
</mapper>

• Mapper接口

public interface OrderMapper {
    
    //  查询所有订单
    List<Order> queryOrderAll();
}

• 发现userId为null
• 使用resultMap
  由于上边的mapper.xml中sql查询列(user_id)和Order类属性(userId)不一致，所以查询结果不能映射到pojo中。
  需要定义resultMap，把orderResultMap将sql查询列(user_id)和Order类属性(userId)对应起来

<?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">
<!-- namespace：命名空间，用于隔离sql，还有一个很重要的作用，Mapper动态代理开发的时候使用，需要指定Mapper的类路径 -->
<mapper namespace="com.cuzz.mapper.OrderMapper">

    <!-- resultMap最终还是要将结果映射到pojo上，type就是指定映射到哪一个pojo -->
    <!-- id：设置ResultMap的id -->
    <resultMap type="order" id="orderResultMap">
        <!-- 定义主键 ,非常重要。如果是多个字段,则定义多个id -->
        <!-- property：主键在pojo中的属性名 -->
        <!-- column：主键在数据库中的列名 -->
        <id property="id" column="id" />

        <!-- 定义普通属性 -->
        <result property="userId" column="user_id" />
        <result property="number" column="number" />
        <result property="createtime" column="createtime" />
        <result property="note" column="note" />
    </resultMap>

    <!-- 查询所有的订单数据 -->
    <select id="queryOrderAll" resultMap="orderResultMap">
        SELECT id, user_id,
        number,
        createtime, note FROM `order`
    </select>

</mapper>

动态SQL

通过mybatis提供的各种标签方法实现动态拼接sql。

if 标签

• 需求：根据性别和名字查询用户
• 查询sql：
  SELECT id, username, birthday, sex, address FROM `user` WHERE sex = 1 AND username LIKE '%张%'
• Mapper.xml

<!-- 根据条件查询用户 -->
<select id="queryUserByWhere" parameterType="user" resultType="user">
    SELECT id, username, birthday, sex, address FROM `user`
    WHERE sex = #{sex} AND username LIKE
    '%${username}%'
</select>

• Mapper接口
  List<User> queryUserByWhere(User user);
• 这样很不合理，查询条件越多我们就编写越多的sql
• 使用if标签
  修改Mapper.xml文件

<!-- 根据条件查询用户 -->
<select id="queryUserByWhere" parameterType="user" resultType="user">
    SELECT id, username, birthday, sex, address FROM `user`
    WHERE 1=1
    <if test="sex != null and sex != ''">
        AND sex = #{sex}
    </if>
    <if test="username != null and username != ''">
        AND username LIKE
        '%${username}%'
    </if>
</select>

注意字符串类型的数据需要要做不等于空字符串校验。

where标签

上面的sql还有where 1=1 这样的语句，很麻烦
可以使用where标签进行改造

• 修改Mapper.xml

<!-- 根据条件查询用户 -->
<select id="queryUserByWhere" parameterType="user" resultType="user">
    SELECT id, username, birthday, sex, address FROM `user`
<!-- where标签可以自动添加where，同时处理sql语句中第一个and关键字 -->
    <where>
        <if test="sex != null">
            AND sex = #{sex}
        </if>
        <if test="username != null and username != ''">
            AND username LIKE
            '%${username}%'
        </if>
    </where>
</select>

SQL片段

• Sql中可将重复的sql提取出来，使用时用include引用即可，最终达到sql重用的目的。

= 把上面例子中的id, username, birthday, sex, address提取出来，作为sql片段，如下：

<!-- 根据条件查询用户 -->
<select id="queryUserByWhere" parameterType="user" resultType="user">
    <!-- SELECT id, username, birthday, sex, address FROM `user` -->
    <!-- 使用include标签加载sql片段；refid是sql片段id -->
    SELECT <include refid="userFields" /> FROM `user`
    <!-- where标签可以自动添加where关键字，同时处理sql语句中第一个and关键字 -->
    <where>
        <if test="sex != null">
            AND sex = #{sex}
        </if>
        <if test="username != null and username != ''">
            AND username LIKE
            '%${username}%'
        </if>
    </where>
</select>

<!-- 声明sql片段 -->
<sql id="userFields">
    id, username, birthday, sex, address
</sql>

• 如果要使用别的Mapper.xml配置的sql片段，可以在refid前面加上对应的Mapper.xml的namespace

foreach 标签

• 向sql传递数组或List，mybatis使用foreach解析，如下：
• 需求：根据多个id查询用户信息
• 查询Sql：
  SELECT * FROM user WHERE id IN (1,10,24)
• 改造QueryVo
  在pojo中定义list属性ids储存多个用户的id

public class QueryVo {

    // 包含其他pojo
    private User user;
    
    private List<Integer> ids;
    
    getter/setter
}

• Mapper.xml

<!-- 根据ids查询用户 -->
<select id="queryUserByIds" parameterType="queryVo" resultType="user">
    SELECT * FROM `user`
    <where>
        <!-- foreach标签，进行遍历 -->
        <!-- collection：遍历的集合，这里是QueryVo的ids属性 -->
        <!-- item：遍历的项目，可以随便写，，但是和后面的#{}里面要一致 -->
        <!-- open：在前面添加的sql片段 -->
        <!-- close：在结尾处添加的sql片段 -->
        <!-- separator：指定遍历的元素之间使用的分隔符 -->
        <foreach collection="ids" item="item" open="id IN (" close=")"
            separator=",">
            #{item}
        </foreach>
    </where>
</select>

关联查询

商品订单数据模型

• 订单表：order
  记录了用户创建的订单
  创建用户:user_id(外键)
  订单号
  创建时间
  订单状态
• 用户表：user
  记录了购买商品的用户信息
  Id：唯一标识一个用户
• 一对一：一个订单只能由一个用户创建
• 一对多：一个用户可以创建多个订单

一对一查询

• 需求：查询所有订单信息，关联查询下单用户信息。
• 注意：因为一个订单信息只会是一个人下的订单，所以从查询订单信息出发关联查询用户信息为一对一查询。如果从用户信息出发查询用户下的订单信息则为一对多查询，因为一个用户可以下多个订单。
• Sql语句：

SELECT
    o.id,
    o.user_id userId,
    o.number,
    o.createtime,
    o.note,
    u.username,
    u.address
FROM
    `order` o
LEFT JOIN `user` u ON o.user_id = u.id

使用resultType

使用resultType，改造订单pojo类，此pojo类中包括了订单信息和用户信息
这样返回对象的时候，mybatis自动把用户信息也注入进来了

• 改造pojo类
  OrderUser类继承Order类后OrderUser类包括了Order类的所有字段，只需要定义用户的信息字段即可

package com.cuzz.pojo;

public class OrderUser extends Order{
    private String username;
    private String address;
}

• Mapper.xml

在UserMapper.xml添加sql，如下
<!-- 查询订单，同时包含用户数据 -->
<select id="queryOrderUser" resultType="orderUser">
    SELECT
    o.id,
    o.user_id
    userId,
    o.number,
    o.createtime,
    o.note,
    u.username,
    u.address
    FROM
    `order` o
    LEFT JOIN `user` u ON o.user_id = u.id
</select>

• Mapper接口
  List<OrderUser> queryOrderUser();
• 小结
  定义专门的pojo类作为输出类型，其中定义了sql查询结果集所有的字段。此方法较为简单，企业中使用普遍。

使用resultMap

• 使用resultMap，定义专门的resultMap用于映射一对一查询结果。
• 改造pojo类
  在Order类中加入User属性，user属性中用于存储关联查询的用户信息，因为订单关联查询用户是一对一关系，所以这里使用单个User对象存储关联查询的用户信息

package com.cuzz.pojo;

public class Order {
     // 订单
    private Integer id;
    // 用户id
    private Integer userId;
    // 订单号
    private String number;
    // 备注
    private String note;
    
    // 用户
    private User user;

}

• Mapper.xml
  这里resultMap指定orderUserResultMap，如下：

<resultMap type="order" id="orderUserResultMap">
    <id property="id" column="id" />
    <result property="userId" column="user_id" />
    <result property="number" column="number" />
    <result property="createtime" column="createtime" />
    <result property="note" column="note" />

    <!-- association ：配置一对一属性 -->
    <!-- property:order里面的User属性名 -->
    <!-- javaType:属性类型 -->
    <association property="user" javaType="user">
        <!-- id:声明主键，表示user_id是关联查询对象的唯一标识-->
        <id property="id" column="user_id" />
        <result property="username" column="username" />
        <result property="address" column="address" />
    </association>

</resultMap>

<!-- 一对一关联，查询订单，订单内部包含用户属性 -->
<select id="queryOrderUserResultMap" resultMap="orderUserResultMap">
    SELECT
    o.id,
    o.user_id,
    o.number,
    o.createtime,
    o.note,
    u.username,
    u.address
    FROM
    `order` o
    LEFT JOIN `user` u ON o.user_id = u.id
</select>

一对多查询

• 案例：查询所有用户信息及用户关联的订单信息。
  用户信息和订单信息为一对多关系。
• Sql语句：

SELECT
    u.id,
    u.username,
    u.birthday,
    u.sex,
    u.address,
    o.id oid,
    o.number,
    o.createtime,
    o.note
FROM
    `user` u
LEFT JOIN `order` o ON u.id = o.user_id

• 修改pojo类
  在User类中加入List<Order> orders属性,如下图：

public class User {
    private int id;
    private String username;
    private String sex;
    private Date birthday;
    private String address;
    private List<Order> orders;
}

• Mapper.xml

<resultMap type="user" id="userOrderResultMap">
    <id property="id" column="id" />
    <result property="username" column="username" />
    <result property="birthday" column="birthday" />
    <result property="sex" column="sex" />
    <result property="address" column="address" />

    <!-- 配置一对多的关系 -->
    <collection property="orders" javaType="list" ofType="order">
        <!-- 配置主键，是关联Order的唯一标识 -->
        <id property="id" column="oid" />
        <result property="number" column="number" />
        <result property="createtime" column="createtime" />
        <result property="note" column="note" />
    </collection>
</resultMap>

<!-- 一对多关联，查询订单同时查询该用户下的订单 -->
<select id="queryUserOrder" resultMap="userOrderResultMap">
    SELECT
    u.id,
    u.username,
    u.birthday,
    u.sex,
    u.address,
    o.id oid,
    o.number,
    o.createtime,
    o.note
    FROM
    `user` u
    LEFT JOIN `order` o ON u.id = o.user_id
</select>

逆向工程

略