Error message here!

Hide Error message here!

忘记密码?

Error message here!

请输入正确邮箱

Hide Error message here!

密码丢失?请输入您的电子邮件地址。您将收到一个重设密码链接。

Error message here!

返回登录

Close

Mybatis中多个参数的问题&&动态SQL&&查询结果与类的对应

Top丶赵立全 2019-01-24 20:10:00 阅读数:460 评论数:0 点赞数:0 收藏数:0

### 1. 抽象方法中多个参数的问题

在使用MyBatis时,接口中的抽象方法只允许有1个参数,如果有多个参数,例如:

Integer updatePassword(
Integer id, String password);

在最终运行时,Java源代码会被编译成.class文件,就会丢失参数名称,所以,运行时会提示“找不到某参数”的错误:

Caused by: org.apache.ibatis.binding.BindingException: Parameter 'password' not found. Available parameters are [arg1, arg0, param1, param2]

解决方案就是“封装”,例如将以上2个参数id、password封装到1个User对象中,或将这2个参数封装到1个Map对象中……但是,无论哪种做法,都存在调用方法不便利的问题,MyBatis提供的解决方案就是添加注解:

 Integer updatePassword(
@Param("id") Integer id,
@Param("password") String password);

通过`@Param`注解,当执行时,MyBatis会将多个参数封装为1个Map对象来执行,就不需要开发人员自行封装!

也可以小结为:当抽象方法的参数超过1个时,必须添加`@Param`注解,并且,在XML配置中,使用`#{}`表示的变量的名称其实是`@Param`注解中的值!

### 2. 动态SQL

#### 2.1. 基本概念

在MyBatis中,在配置XML映射时,可以使用某些逻辑节点,实现逻辑判断或者循环等等,使得每次执行的SQL语句是可能随着参数发生变化的,即:参数不同,最终执行的SQL语句可能不同,所以,称之为“动态SQL”。

#### 2.2. <foreach>标签

例如存在以下需求:根据多个id同时删除多条数据。则抽象方法可以设计为:

Integer deleteByIds(Integer[] ids);

需要执行的SQL语句例如:

DELETE FROM t_user WHERE id IN (?,?,?);

但是,以上SQL语句中的问号所表示的值的数量是不确定的,将根据调用方法时的参数`Integer ids`来决定,所以,可以使用`<foreach>`来实现:

 <delete id="deleteByIds">
DELETE FROM
t_user
WHERE id IN (
<foreach collection="array"
item="id" separator=",">
#{id}
</foreach>
)
</delete>

在`<foreach>`的配置中,常用属性有:
- `collection`:如果映射的抽象方法只有1个参数时,如果遍历的数据类型是数组,则取值为`array`,如果遍历的数据类型是List集合,则取值为`list`;如果映射的抽象方法有多个参数,则取值为注解中的名称;
- `item`:遍历过程中元素的名称,相当于Java代码中`for (Integer id : ids)`中的`id`,在动态SQL中,也是`<foreach>`节点的子级中通过`#{}`表示的变量名
- `separator`:分隔符,例如在`IN`语句中应该是`id IN (6,8,9)`,各个值之间需要使用逗号进行分隔,所以,以上代码中取值为`,`
- `open`:整个遍历得到的SQL语句的部分的最左侧的字符,例如在SQL语句中不写括号时,该属性的值可以是`(`
- `close`:与`open`对应,是SQL语句的部分的最右侧的字符,例如`)`

#### 2.3. <if>标签

假设希望提供某个查询功能,尽量满足所有的查询需求,即:可以通过参数决定WHERE子句,决定ORDER BY子句,甚至决定LIMIT子句,则抽象方法可以设计为:

 List<User> find(
@Param("where") String where,
@Param("orderBy") String orderBy,
@Param("offset") Integer offset,
@Param("count") Integer count);

匹配的映射为:

 <select id="find"
resultType="cn.tedu.mybatis.entity.User">
SELECT
id, age,
password, username,
phone, email
FROM
t_user
<if test="where != null">
WHERE
${where}
</if>
<if test="orderBy != null">
ORDER BY
${orderBy}
</if>
<if test="offset != null">
LIMIT
#{offset},#{count}
</if>
</select>

可以看到,`<if>`用于进行逻辑判断,在标签内的`test`中,如果需要表示参数,是不需要添加`#{}`格式的,直接写参数名称即可(即使只有1个参数,也应该正确的填写参数名称)。

在以上映射的SQL中,有2种占位符,分别使用`#{}`和`${}`,前者,用于对值进行占位,可以替换在预编译的SQL语句中的`?`,在实际执行时,也是预编译的,所以,在使用`#{}`格式时,无须考虑参数的类型,后者,用于对非值的语句部分进行占位,在实际执行时,是直接拼接到SQL语句中的,并不具备预编译的效果。例如以上`String where`参数表示的是SQL语句中的WHERE子句,如果根据id查询数据,其值可以是`String where ="id=1";`,如果根据用户名查询数据,则值应该是`String where = "username='Jack'";`。

> 通常,并不建议使用某1个方法及其对应的映射来完成许多不同的操作,例如以上功能几乎可以完成所有的单表简单查询,但是,不应该这样使用,因为,为了实现更加通用的效果,可能需要很多`<if>`进行判断,执行时效率偏低,并且,不同的功能,对于查询的字段要求是不一样的,也许某个功能只需要查询20个字段中的2个而已,而通用的查询如果把20个字段全部查出来,内存开销也会有浪费!

### 3. 查询结果与类的对应

在某些字段的设计中,可能名称包含多个单词,数据库语句是不区分大小写的,所以,应该将字段名所有字母小写,各单词之间使用下划线(`_`)分隔,例如:

 is_delete 是否已删除:0-未删除,1-已删除
ALTER TABLE t_user ADD COLUMN is_delete INT DEFAULT 0;

如果数据表发现变化,则实体类也应该跟随调整,在实体类添加的属性就应该是`Integer isDelete;`。

查询时,MyBatis会将查询结果封装到对象中,其要求是查询结果中的列名(字段名)与实体类的属性名必须完全一致,而以上关于“是否已删除”的字段名是`is_delete`,而`User`类中对应的属性是`isDelete`,则查询时需要通过`AS`定义别名:

 <select id="findAll"
resultType="cn.tedu.mybatis.entity.User">
SELECT
id, age,
password, username,
phone, email,
is_delete AS isDelete
FROM
t_user
</select>

> 在定义别名时,AS关键字并不是必须的,直接通过空格分隔原名和别名即可。

#### 3.2. 使用VO类

创建部门信息表`t_department`,其中包括`id`, `name`

 CREATE TABLE t_department (
id INT AUTO_INCREMENT,
name VARCHAR(20) UNIQUE NOT NULL,
PRIMARY KEY(id)
) DEFAULT CHARSET=UTF8;
INSERT INTO t_department (name) VALUES
('UI'), ('RD'), ('TEST');

在用户信息表中添加`did`表示用户所属的部门的id

 ALTER TABLE t_user ADD COLUMN did INT;

如果尝试执行多表关联查询,必然没有匹配的实体类可以封装查询结果,则需要创建VO(Value Object)类,它不同于实体类,实体类是与某1张数据表完全对应的,而VO类是与实际应用需求相对应的!

假设要查询用户数据,且部门应该是显示部门的名称,则VO类应该是:

 package cn.tedu.mybatis.vo;
public class UserVO {
private Integer uid;
private String username;
private String password;
private Integer age;
private String phone;
private String email;
private Integer isDelete;
private Integer did;
private String name;
// SET/GET,toString(),Serializable
}

则设计的抽象方法的返回值就应该是List集合中存放VO类型的数据:

List<UserVO> findAll2();

需要注意的是,在查询的SQL语句中,需要自定义别名:

 SELECT
t_user.id AS uid,
username,
password,
age,
phone,
email,
is_delete AS isDelete,
did,
name
FROM
t_user
INNER JOIN
t_department
ON
t_user.did=t_department.id;

#### 3.3. resultMap

在查询时,`<select>`节点必须指定结果的类型,可以通过`resultType`属性来指定,也可以通过`resultMap`属性来指定。

当有直接对应的查询结果时,可以使用`resultType`,取值一般是实体类的类型,或VO类的类型。

某些查询可能需要将查询结果进行特殊的封装,例如查询时存在1对多、多对多、多对1等关系,则需要使用`resultMap`来配置封装的方式。

例如:根据id查询部门信息,且要求查询结果中包含该部门中所有用户。

设计的VO类应该是:

 public class DepartmentVO {
private Integer did;
private String name;
private List<User> users;
}

设计的接口和抽象方法应该是:

 public interface DepartmentMapper {
DepartmentVO findById(Integer id);
}

复制得到`DepartmentMapper.xml`,然后,需要执行的SQL语句应该是:

 SELECT
t_department.id AS did,
name,
t_user.id AS uid,
username,
password,
age,
phone,
email,
is_delete
FROM
t_department
INNER JOIN
t_user
ON
t_user.did=t_department.id
WHERE
t_department.id=2;

> 以上代码中,自定义别名是因为需要区分查询结果中的列的名称,并不是因为需要与数据类型中的属性对应,关于查询结果的列名与数据类型的属性名的对应,可以通过`<resultMap>`中的配置来完成!

所需要配置的`<resultMap>`为:

 <resultMap id="Department_VO_Map"
type="cn.tedu.mybatis.vo.DepartmentVO">
<!-- id节点:配置主键 -->
<!-- column:查询结果中的列名 -->
<!-- property:以上type属性对应的数据类型中的属性名 -->
<id column="did" property="did"/>
<!-- result节点:配置普通字段 -->
<result column="name" property="name"/>
<!-- collection节点:配置List集合类型的属性 -->
<!-- ofType:在List里放的是什么类型 -->
<collection property="users"
ofType="cn.tedu.mybatis.entity.User">
<id column="uid" property="id"/>
<result column="username" property="username"/>
<result column="password" property="password"/>
<result column="age" property="age"/>
<result column="phone" property="phone"/>
<result column="email" property="email"/>
<result column="is_delete" property="isDelete"/>
</collection>
</resultMap>

配置时,与其它文件的关系如图所示:

版权声明
本文为[Top丶赵立全]所创,转载请带上原文链接,感谢
https://www.cnblogs.com/topzhao/p/10316552.html

编程之旅,人生之路,不止于编程,还有诗和远方。
阅代码原理,看框架知识,学企业实践;
赏诗词,读日记,踏人生之路,观世界之行;

支付宝红包,每日可领