【为什么要用 @param注解】

 关于@param

 这个注解在刚刚学习java的时候常会用到，但是为什么要用呢？

关于@param这个注解的作用：

有一种观点是使用@param可以和xml配置中的#{xxx} 对应，使用此注解后 ${}将无效，不过${}这种有sql注入的风险，现在用#{}才是主流（所以从这点上来看，所谓防sql注入并不是@param的功劳）；

另外一种观点就是对传入参数的申明（声明），比如接口传入2个参数，其命名与SQL语句中的#{xxx}不一致，那么参数的传递过程就会中断，因为不知道哪个参数是sql需要的。

可能这才是@param的主要作用，尤其是当你用注解代替xml配置时（见下图，用注解代替xml大概就是这样子）

 

 

眼见为实

　　测试工具 ：postman 本地测试：

　　@RequestMapping("public/v1/{organizationId}/users")

）

　　进行测试，大概三种情况：

控制层函数：

 

mapper.xml文件

 

① ：不使用@param注解，传参为name和userName：发现是可以成功查询的

 

 

② ：不使用@param，变更接口参数name为name2，会报错，发现获取不到name这个参数

 

 

③： 使用@param注解，接口参数依旧用②中的name2，发现可以正常查询到

 

总结：

　　总的来说，@param可以帮助接口传递参数给mapper文件，可以允许参数名有小小的不一致（但是我为什么要字段不一致来给自己找麻烦...）；

另外缺点也比较明显，参数多的时候就不太好一个个加注解了，又臭又长（bushi），可以根据需求考虑用dto，vo来传递多个参数。所以，@param似乎并不是很重要。。（如果有我理解错的地方也可以评论告诉我，毕竟某也只是个萌新）