在 MyBatis 中,一共有四个操作数据库的标签,分别为insert、update、delete、select
,其中:
示例:
<select id="selectAllUser" resultType="User" parameterType="string">
SELECT id,NAME FROM dq_User WHERE NAME LIKE CONCAT ('%',#{name},'%')
</select>
以上是一个 name 为 selectAllUser的映射语句,参数类型为 string,返回结果类型为 User。
执行 SQL 语句时可以定义参数,参数可以是一个简单的参数类型,例如 int、float、String;也可以是一个复杂的参数类型,例如 JavaBean、Map 等。MyBatis 提供了强大的映射规则,执行 SQL 后,MyBatis 会将结果集自动映射到 JavaBean 中。
参数的传递使用#{参数名},相当于告诉 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 ('%','参数值','%')"
使用 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>
使用 Map 传递参数虽然简单易用,但是由于这样设置参数需要键值对应,业务关联性不强,开发人员需要深入到程序中看代码,造成可读性下降。
使用 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>
当我们把参数传递给后台时,MyBatis 通过 @Param 提供的名称就会知道 #{name} 代表 name 参数,提高了参数可读性。但是如果这条 SQL 拥有 10 个参数的查询,就会造成可读性下降,增强了代码复杂性。
在参数过多的情况下,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>
这就是通过 JavaBean 传递多个参数的方式,适用于参数较多的情况下。
- 使用 Map 传递参数会导致业务可读性的丧失,继而导致后续扩展和维护的困难,所以在实际应用中我们应该果断废弃该方式。
- 使用 @Param 注解传递参数会受到参数个数的影响。当 n≤5 时,它是最佳的传参方式,因为它更加直观;当 n>5 时,多个参数将给调用带来困难。
- 当参数个数大于 5 个时,建议使用 JavaBean 方式。
MyBatis insert 标签用来定义插入语句,执行插入操作。当 MyBatis 执行完一条插入语句后,就会返回其影响数据库的行数。
// mapper.java文件中
public int addUser(String name);
<insert id="addUser" parameterType="string">
insert into website (name)
values(#{name})
</insert>
返回值为 int 类型,执行这条 SQL 后,返回操作的条数(行数)。
注意:insert 标签中没有 resultType 属性,只有查询操作才需要对返回结果类型进行相应的指定
。
具体实现和select标签一样,就不写了
我们知道,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>
注:useGeneratedKeys 设置为true表示允许回传自增主键,keyProperty 表示回传到bean的哪个属性上
MyBatis update 标签用于定义更新语句,执行更新操作。当 MyBatis 执行完一条更新语句后,会返回一个整数,表示受影响的数据库记录的行数。
//mapper.java中
int updateUser(String name);
<!--update 标签-->
<update id="updateUser" parameterType="string">
update User set name = #{name}
</update>
返回值为 int 类型,表示执行 sql 语句后受影响的记录的行数。
注意:update 标签中没有 resultType 属性,只有查询操作才需要对返回结果类型进行相应的指定。
具体实现和select标签一样,就不写了
用于删除表数据,最简单操作的标签,下面是简单的例子
delete from User where id='1'
返回值为 int 类型,表示执行 sql 语句后受影响的记录的行数。