Mybatis的特性详解——四大操作标签

---

前言

在 MyBatis 中，一共有四个操作数据库的标签，分别为insert、update、delete、select ，其中:

• select 标签是最常用也是功能最强大的 SQL 语言，用于执行查询操作;
• insert 标签用来定义插入语句，执行插入操作。当 MyBatis 执行完一条插入语句后，就会返回其影响数据库的行数;
• update 标签用于定义更新语句，执行更新操作。当 MyBatis 执行完一条更新语句后，会返回一个整数，表示受影响的数据库记录的行数;
• delete用于删除表数据;
  下面是对四大操作标签的详解。

一、select标签

示例：

<select id="selectAllUser" resultType="User" parameterType="string">
    SELECT id,NAME FROM dq_User WHERE NAME LIKE CONCAT ('%',#{name},'%')
</select>
1
2
3

以上是一个 name 为 selectAllUser的映射语句，参数类型为 string，返回结果类型为 User。
执行 SQL 语句时可以定义参数，参数可以是一个简单的参数类型，例如 int、float、String；也可以是一个复杂的参数类型，例如 JavaBean、Map 等。MyBatis 提供了强大的映射规则，执行 SQL 后，MyBatis 会将结果集自动映射到 JavaBean 中。

• 为了使数据库的查询结果和返回值类型中的属性能够自动匹配，通常会对 MySQL 数据库和 JavaBean 采用同一套命名规则，即 Java 命名驼峰规则，这样就不需要再做映射了（数据库表字段名和属性名不一致时需要手动映射）。

---

参数的传递使用#{参数名}，相当于告诉 MyBatis 生成 PreparedStatement 参数。对于 JDBC，该参数会被标识为“?”，${参数名}也可以实现参数的传递，但是会出现sql注入风险，慎用，以上 SQL 语句在程序中会被识别为以下代码。

-- #{参数名}
"SELECT id,NAME FROM dq_User WHERE NAME LIKE CONCAT ('%',?,'%')"
-- ${参数名}
"SELECT id,NAME FROM dq_User WHERE NAME LIKE CONCAT ('%','参数值','%')"
1
2
3
4

select标签常用属性

传递多个参数的方法

• 使用Map传递参数
• 使用注解传递参数
• 使用JavaBean传递参数

---

1.使用Map传递参数

使用 MyBatis 提供的 Map 接口作为参数实现

<!-- 根据name和id模糊查询信息 -->

// 逻辑代码片段中
Map<String,String> paramsMap = new HashMap<String,String>();
paramsMap.put("name","杨");
paramsMap.put("id","1");
UserMapper.selectUserByMap(paramsMap);

// mapper.java文件中
public List<User> selectUserByMap(Map<String, String> params);

// mapper.xml文件中
<select id="selectUserByMap" resultType="User" parameterType="map">
    SELECT id,NAME FROM website
    WHERE name LIKE CONCAT ('%',#{name},'%')
    AND id LIKE CONCAT ('%',#{id},'%')
</select>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

使用 Map 传递参数虽然简单易用，但是由于这样设置参数需要键值对应，业务关联性不强，开发人员需要深入到程序中看代码，造成可读性下降。

2.使用注解传递参数

使用 MyBatis 的注解 @Param() 传递参数

<!-- 根据name和id模糊查询信息 -->
// mapper.java文件中
public List<User> selectUserByParam(@Param("name") String name, @Param("id") String id);

// mapper.xml文件中
<select id="selectUserByParam" resultType="User">
    SELECT id,NAME FROM User
    WHERE name LIKE CONCAT ('%',#{name},'%')
    AND idLIKE CONCAT ('%',#{id},'%')
</select>
1
2
3
4
5
6
7
8
9
10

当我们把参数传递给后台时，MyBatis 通过 @Param 提供的名称就会知道 #{name} 代表 name 参数，提高了参数可读性。但是如果这条 SQL 拥有 10 个参数的查询，就会造成可读性下降，增强了代码复杂性。

3.使用JavaBean传递参数

在参数过多的情况下，MyBatis 允许组织一个 JavaBean，通过简单的 setter 和 getter 方法设置参数，提高可读性

<!-- 根据name和id模糊查询信息 -->
// mapper.java文件中
public List<User> selectUserByEntity(User user);

// mapper.xml文件中
<select id="selectUserByEntity" resultType="User">
    SELECT id,NAME FROM User
    WHERE name LIKE CONCAT ('%',#{name},'%')
    AND id LIKE CONCAT ('%',#{id},'%')
</select>
1
2
3
4
5
6
7
8
9
10

这就是通过 JavaBean 传递多个参数的方式,适用于参数较多的情况下。

它们的区别

• 使用 Map 传递参数会导致业务可读性的丧失，继而导致后续扩展和维护的困难，所以在实际应用中我们应该果断废弃该方式。
• 使用 @Param 注解传递参数会受到参数个数的影响。当 n≤5 时，它是最佳的传参方式，因为它更加直观；当 n>5 时，多个参数将给调用带来困难。
• 当参数个数大于 5 个时，建议使用 JavaBean 方式。

二.insert标签

MyBatis insert 标签用来定义插入语句，执行插入操作。当 MyBatis 执行完一条插入语句后，就会返回其影响数据库的行数。

// mapper.java文件中
public int addUser(String name);

<insert id="addUser" parameterType="string">
    insert into website (name)
    values(#{name})
</insert>
1
2
3
4
5
6
7

返回值为 int 类型，执行这条 SQL 后，返回操作的条数（行数）。

1.insert 标签常用属性

注意：insert 标签中没有 resultType 属性，只有查询操作才需要对返回结果类型进行相应的指定。

2.传递多个参数

具体实现和select标签一样，就不写了

3.主键（自动递增）回填

我们知道，MySQL、SQL Server 等数据库表可以采用自动递增的字段作为其主键，当向这样的数据库表插入数据时，即使不指定自增主键的值，数据库也会根据自增规则自动生成主键并插入到表中。
一些特殊情况下，我们可能需要将这个刚刚生成的主键回填到请求对象（原本不包含主键信息的请求对象）中，供其他业务使用。此时，我们就可以通过在 insert 标签中添加 keyProperty 和 useGeneratedKeys 属性，来实现该功能。

//逻辑代码中
User user= new User ();
//插入的对象中不包含主键 id 
user.setName("编程帮");
user.setAge(18);
//执行插入
int num = userMapper.addUser(user);
System.out.println("添加了 " + num + " 条记录");
//获取回填的主键
System.out.println("添加记录的主键是:" + user.getId());


//xml中
<insert id="addUser" parameterType="User" keyProperty="id" useGeneratedKeys="true">
    insert into User (name,age) values(#{name},#{age})
</insert>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

注：useGeneratedKeys 设置为true表示允许回传自增主键，keyProperty 表示回传到bean的哪个属性上

三.update标签

MyBatis update 标签用于定义更新语句，执行更新操作。当 MyBatis 执行完一条更新语句后，会返回一个整数，表示受影响的数据库记录的行数。

//mapper.java中
int updateUser(String name);

<!--update 标签-->
<update id="updateUser" parameterType="string">
    update User set name = #{name}
</update>
1
2
3
4
5
6
7

返回值为 int 类型，表示执行 sql 语句后受影响的记录的行数。

1.update常用属性

注意：update 标签中没有 resultType 属性，只有查询操作才需要对返回结果类型进行相应的指定。

2.传递多个参数

具体实现和select标签一样，就不写了

四. delete标签

用于删除表数据，最简单操作的标签，下面是简单的例子

delete from User where id='1'
1

返回值为 int 类型，表示执行 sql 语句后受影响的记录的行数。

仰天大笑出门去，我辈岂是蓬蒿人