Mybatis学习笔记（三）—— 参数传递

最新推荐文章于 2022-03-23 12:01:35 发布

AlphonesEric

最新推荐文章于 2022-03-23 12:01:35 发布

阅读量424

点赞数

分类专栏： java Mybatis

本文链接：https://blog.youkuaiyun.com/AlphonesEric/article/details/89023838

版权

java 同时被 2 个专栏收录

24 篇文章

订阅专栏

Mybatis

3 篇文章

订阅专栏

这篇博客详细介绍了Mybatis中参数传递的多种方式，包括单个参数、命名参数、POJO、Map、DTO以及如何获取参数值。通过示例和源码分析，解释了Mybatis如何处理多个参数和不同类型参数的封装，强调了使用#{}和${}的区别以及安全问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE mapper

PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"

"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<!--

1、单个参数

单个参数：mybatis不会做特殊处理，#{参数名/任意名}：取出参数值。多个参数：mybatis会做特殊处理。

多个参数会被封装成一个map，key：param1...paramN,或者参数的索引也可以value：传入的参数值

#{}就是从map中获取指定的key的值；

异常：

org.apache.ibatis.binding.BindingException:Parameter 'id' not found.Available parameters are [1, 0, param1, param2]

操作：

方法：public Employee getEmpByIdAndLastName(Integer id,String lastName);

取值：#{id},#{lastName}

2、命名参数

明确指定封装参数时map的key；@Param("id")多个参数会被封装成一个map，

key：使用@Param注解指定的值，

value：参数值#{指定的key}取出对应的参数值

public Employee getEmp(@Param("id")Integer id,String lastName);

取值：id==>#{id/param1} lastName==>#{param2}

3、POJO

如果多个参数正好是我们业务逻辑的数据模型，我们就可以直接传入pojo；

#{属性名}：取出传入的pojo的属性值

4、Map：

如果多个参数不是业务模型中的数据，没有对应的pojo，不经常使用，为了方便，我们也可以传入map

#{key}：取出map中对应的值

5、DTO：

如果多个参数不是业务模型中的数据，但是经常要使用，推荐来编写一个DTO（Dat Transfer Object）数据传输对象

Page{

int index;

int size;

}

========================思考================================

public Employee getEmp(@Param("id")Integer id,String lastName);

取值：id==>#{id或param1} lastName==>#{param2}

public Employee getEmp(Integer id,@Param("e")Employee emp);

取值：id==>#{param1} lastName===>#{param2.lastName或e.lastName}

##特别注意：如果是Collection（List、Set）类型或者是数组，

也会特殊处理。也是把传入的list或者数组封装在map中。

key：Collection（collection）,如果是List还可以使用这个key(list),数组(array)

public Employee getEmpById(List<Integer> ids);

取值：取出第一个id的值： #{list[0]}

========================结合源码，mybatis怎么处理参数==========================

总结：参数多时会封装map，为了不混乱，我们可以使用@Param来指定封装时使用的key；

#{key}就可以取出map中的值；

(@Param("id")Integer id,@Param("lastName")String lastName);

ParamNameResolver解析参数封装map的；

//1、names：{0=id, 1=lastName}；构造器的时候就确定好了

确定流程：

1.获取每个标了param注解的参数的@Param的值：id，lastName；赋值给name;

2.每次解析一个参数给map中保存信息：（key：参数索引，value：name的值）

name的值：

标注了param注解：注解的值

没有标注：

1.全局配置：useActualParamName（jdk1.8）：name=参数名

2.name=map.size()；相当于当前元素的索引

{0=id, 1=lastName,2=2}

args【1，"Tom",'hello'】:

public Object getNamedParams(Object[] args) {

final int paramCount = names.size();

//1、参数为null直接返回

if (args == null || paramCount == 0) {

return null;

//2、如果只有一个元素，并且没有Param注解；args[0]：单个参数直接返回

} else if (!hasParamAnnotation && paramCount == 1) {

return args[names.firstKey()];

//3、多个元素或者有Param标注

} else {

final Map<String, Object> param = new ParamMap<Object>();

int i = 0;

//4、遍历names集合；{0=id, 1=lastName,2=2}

for (Map.Entry<Integer, String> entry : names.entrySet()) {

//names集合的value作为key; names集合的key又作为取值的参考args[0]:args【1，"Tom"】:

//eg:{id=args[0]:1,lastName=args[1]:Tom,2=args[2]}

param.put(entry.getValue(), args[entry.getKey()]);

// add generic param names (param1, param2, ...)param

//额外的将每一个参数也保存到map中，使用新的key：param1...paramN

//效果：有Param注解可以#{指定的key}，或者#{param1}

final String genericParamName = GENERIC_NAME_PREFIX + String.valueOf(i + 1);

// ensure not to overwrite parameter named with @Param

if (!names.containsValue(genericParamName)) {

param.put(genericParamName, args[entry.getKey()]);

}

i++;

}

return param;

}

6、参数值的获取

#{}：可以获取map中的值或者pojo对象属性的值；

${}：可以获取map中的值或者pojo对象属性的值；

select * from tbl_employee where id=${id} and last_name=#{lastName}

Preparing: select * from tbl_employee where id=2 and last_name=?

区别：

#{}:是以预编译的形式，将参数设置到sql语句中；PreparedStatement；防止sql注入

${}:取出的值直接拼装在sql语句中；会有安全问题；

大多情况下，我们去参数的值都应该去使用#{}；

原生jdbc不支持占位符的地方我们就可以使用${}进行取值

比如分表、排序。。。；按照年份分表拆分

select * from ${year}_salary where xxx;

select * from tbl_employee order by ${f_name} ${order}

#{}:更丰富的用法：

规定参数的一些规则：

javaType、 jdbcType、 mode（存储过程）、 numericScale、

resultMap、 typeHandler、 jdbcTypeName、 expression（未来准备支持的功能）；

jdbcType通常需要在某种特定的条件下被设置：

在我们数据为null的时候，有些数据库可能不能识别mybatis对null的默认处理。比如Oracle（报错）；

JdbcType OTHER：无效的类型；因为mybatis对所有的null都映射的是原生Jdbc的OTHER类型，oracle不能正确处理;

由于全局配置中：jdbcTypeForNull=OTHER；oracle不支持；两种办法

1、#{email,jdbcType=OTHER};

2、jdbcTypeForNull=NULL

-->

<!--

namespace：名称空间或者是指定为接口的全类名

id:唯一表示标识

resultType:返回值类型 #{id}:从传递过来的参数中取出id值 -->

<!--

如果返回的Map并且key是value对象里面的一个属性，用哪个属性就用注解@MapKey('属性名'),

@MapKey("value") value是告诉mybatis返回的map用哪个属性做为这个map的key

-->

<!--

@MapKey("id")

getEmpByLastName(String lastName) //返回的map中key为id的值

-->

select * from tbl_employee where last_name like #{lastName}

</select>

<!--

如果返回的是map

-->

<!--

如果返回的是一个集合，要写集合中元素的类型

List<Employee> getEmpsByLastNameLike(String lastName);

-->

select *from tbl_employee where last_name like #{lastName}

</select>

select * from tbl_employee where id = #{id}

</select>

<!--

insert标签

parameterType:参数类型，可以省略

获取自增主键值：

msql支持自增主键，mybatis可以利用statement.getGenreatedKeys()获取

useGeneratedKeys="true":使用自增主键获取主键值策略

keyProperty：指定对应的主键属性，也就是mybatis获取到主键值以后，向这个值封装给javabean的某个属性

-->

<!--

Oracle不支持自增

每次插入的数据的主键是从序列中拿到的值

-->

<insert id="addEmp" parameterType="person.Alphones.mybatis.bean.Employee"

useGeneratedKeys="true" keyProperty="id">

INSERT INTO tbl_employee(last_name,email,gender)

VALUES(#{lastName},#{email},#{gender})

</insert>

UPDATE tbl_employee

SET last_name=#{lastName},email=#{email},gender=#{gender}

WHERE id=#{id}

</update>

DELETE FROM tbl_employee WHERE id=#{id}

</delete>

<!--

自定义某个javaBean的封装规则,一般用于级联或者联合查询，及查找某个类里面的一个类的属性

type:javaBean全类名

id:唯一标识

-->

<!--

id:指定主键的封装规则,id定义主键列会有底层优化

column：指定哪一列

property:指定对应的javaBean属性

-->

<!--

result:定义普通列封装规则

-->

<!-- association:分段查询，推荐使用

可以指定联合的javaBean对象

property:联合对象的属性名（如Department dept,property='dept'）

javaType:联合属性的全类名

-->

</association>

<!-- collection:定义关联的对象集合

property：指定要查询的对象里面的对象集合的属性名字

ofType:指定集合的对象全类名

-->

</collection>

</resultMap>

</mapper>