一、文件结构
● 命名规则:数据库表对应的类名+Mapper.xml
● 一个映射文件对应一个实体类,对应一个表中的操作
● 映射文件主要用于编写SQL、访问以及操作表中的数据
● 映射文件存放位置是maven工程下的src/main/resources/mappers目录下
映射配置文件要保证两个一致:
● mapper接口的全类名和映射文件的命名空间namespace保持一致
● mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致映射文件的简易结
如下文件结构:
<?xml version="1.0" encoding="UTF-8" ?> <!--DTD约束--> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="Mapper接口全类名"> <!--映射语句--> <insert id="Mapper接口方法名"> SQL语句 </insert> </mapper>
二、映射配置文件标签详解
<insert>标签
用于书写插入数据的SQL语句
id属性指定对应mapper接口的方法名
范例:
<insert id="insertUser"> SQL语句 </insert>
<delete>标签
用于删除表中的数据
id属性指定对应mapper接口的方法名
范例:
<delete id="deleteUser"> SQL语句 </delete>
<update>标签
用于更新表中数据
id属性指定对应mapper接口中的方法名
范例:
<update id="updateUser"> SQL语句 </update>
<select>标签
用于查询表中的数据
id属性指定mapper接口中对应的方法名
resultType属性表示自动映射,用于属性名和表中字段名一致的情况
resultMap属性表示自定义映射,用于一对多或多对一或字段名和属性名不一致的情况
范例
查询一条数据:
<select id="getUserById" resultType="com.lxq.pojo.User"> SQL语句 </select>
查询多条数据到List集合:
<select id="getUserList" resultType="com.lxq.pojo.User"> SQL语句 </select>
三、SQL语句中参数的获取
获取方式:
MyBatis获取参数值的两种方式:${}和#{}
${}的本质是字符串拼接,#{}的本质是占位符赋值
${}方式会将参数原原本本拼接入SQL语句中,如果参数是字符串类型的需要手动加上引号
${参数}
#{}的方式会自动加上引号,如果是字符串类型的参数无需手动加上引号
#{参数}
参数类型:
单个字面量类型的参数
字面量是指基本数据类型以及包装类还有自定义类等
获取方式:
<select id="getUserByUsername" resultType="User"> select * from t_user where username=#{username} </select>
此时获取参数时花括号里边的参数名不做要求,可以是随意的名称,如果使用${}的方式记得加引号
多个字面量类型的参数
● 若mapper接口中的方法参数为多个时,MyBatis会自动将这些参数放在一个map集合中,此时参数名不能是随意的名称
● 这个map集合存放参数的形式是 arg0,arg1... 为map中的键,参数值为map中的值;还有param1,param2... 为map中的键,参数值为map值的值
● arg和param是同时存在于同一个map中的,在SQL语句获取参数时只需指定这些键的名称即可
● 获取方式:
<!--arg的方式--> <select id="checkLogin" resultType="User"> select * from t_user where username = #{arg0} and password = # {arg1} </select> <!--param的方式--> <select id="checkLogin" resultType="User"> select * from t_user where username = #{param1} and password = #{param2} </select>
● 如果使用${}的方式记得加引号
map集合类型的参数
● 为了在SQL语句中指定一些有意义的参数名,我们可以自己提供一个map集合,自定义一些键的名称即可
● 通过自定义键的名称,我们在SQL语句里就可以使用自定义的参数名了
● 比如,这个自定义的map集合可以是 {("username","参数值"),("password","参数值")}
● 获取方式:
<select id="checkLoginByMap" resultType="User"> select * from t_user where username = #{username} and password = #{password} </select>
● 如果使用${}的方式记得加引号
使用@Param注解标识的参数
● 如果每次使用多个参数时都要自定义map集合就太麻烦了,所以可以通过使用@Param注解在映射方法的形参中指定好参数名
● 比如,这个映射方法可以是
User getUserByParam(@Param("username") String username,@Param("password") String password);
● 获取方式:
<select id="checkLoginByParam" resultType="User"> select * from t_user where username = #{username} and password = #{password} </select>
● 使用这种注解就可以方便获取参数了,如果使用${}的方式记得加引号
实体类型的参数
如果映射方法的形参是一个实体类型时,可以通过访问实体类对象中的属性名获取属性值
比如,这个实体类可以是
public class User { private Integer id; private String username; private String password; private Integer age; private String gender; private String email; //省略有参、无参构造方法以及toString()方法 public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getUsername() { return username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return password; } public void setPassword(String password) { this.password = password; } 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 String getEmail() { return email; } public void setEmail(String email) { this.email = email; } }
获取方式:
<insert id="insertUser"> insert into t_user value(null,#{username},#{password},#{age},# {gender},#{email}) </insert>
如果使用${}的方式记得加引号
总结:
上面所说的五种参数类型实际上可以分成两种类型,一种是使用@Param注解一种是使用实体类
就是说不论单个参数或者多个参数,都用注解的方式,如果是实体类那就用实体类属性的方式。