### 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>
配置时,与其它文件的关系如图所示: