1.1文件作用:MyBatis里面的sql语句既可以在xxxMapper.xm文件里面定义,也可以通过注解方式定义。
1.2编写数量:mapper包里面的每个接口对应一个Mapper映射文件,也就是一个数据库里面的每张数据表对应一个Mapper映射文件。
1.3命名规范:Mapper映射文件的命名是把XxxMapper接口的后缀名改为是".xml",比如:BookMapper接口对应的映射文件名是:BookMapper.xml。
1.4文件内容介绍:
1.4.1头部:主要是通过dtd定义和限制当前文件中可以使用的标签和属性,以及标签出现的次数及顺序。
1.4.2SQL定义部分:
一对<mapper>标签:根标签,使用insert、update、delete、select标签编写 XxxMapper接口方法里面对应的sql语句。
namespace属性:
命名空间,非常重要。值是当前XxxMapper.xml映射文件对应的XxxMapper接口的全限定名称,且是唯一的。
作用:参与识别sql语句。在mybatis中,映射文件中的namespace是用于绑定mapper接口,即面向接口编程。
当你的namespace绑定接口后,你可以不用写接口实现类,
mybatis会通过该绑定自动、帮你找到对应要执行的SQL语句。
2.MyBatis之mapper接口传参
2.1增删改查标签属性-id¶meterType&resultType介绍.
2.1.1属性-id:id属性的值是xxxMapper接口里面的方法名。
2.1.2属性-parameterType:parameterType属性表示Mapper接口方法所带参数的类型,可以使用数据类型的完全限定名或者别名(系统指定好的)。这个属性是可省略的,因为 MyBatis 可以推断出具体传入sql语句的参数的数据类型。
MyBatis默认支持的别名如下所示(部分):
Double --> double; Float --> float;
Boolean --> boolean; Date --> date;
String --> string;
boolean --> _boolean; byte --> _byte;
long --> _long; int --> _int;
float --> _float ......
2.1.3属性-resultType:resultType属性表示Mapper接口方法的返回值类型,使用返回值类型的完全限定名。
2.2Mapper接口带参案例演示.
2.2.1带一个简单类型参数:通过id查询书本。
简单类型指的是:java 八大基本类型和String类型;
xxxMapper.xml文件的sql语句中,通过占位符 #{任意字符 }(自定义任意字符,和接口方法的参数名可以不同)获取接口方法里面传入的参数值。
2.2.2带多个简单类型参数-使用@Param注解: 查询id或者名字查询书本
@Param注解是MyBatis提供的。
当Mapper 接口中的方法带多个参数的时候要通过@Param注解给参数取别名(必须,而且别名可以和形参名保持一致),在xxxMapper.xml文件的sql语句中需要通过参数别名使用参数。
2.2.3带多个简单类型参数-使用Java对象.
当Mapper接口里面的方法带的参数过多的时候,
用@Param注解取别名的方式就会显的有点繁琐,
所以我们推荐使用Java对象传参。
使用java 对象传递参数,java 的属性值就是 sql 需要的参数值,每一个属性就是一个参数。
在XxxMapper.xml里面通过 #{} 获取的参数名必须和实体类的属性名保持一致(底层是通过调用属性的get方法获取属性值)。
【了解】2.2.4带多个参数-按位置获取.通过书本id或者名称查询书本。
根据Mapper接口中方法的形参列表,从左往右,参数位置分别是:0,1,2,3....
mybatis-3.3 版本和之前的版本使用#{0},#{1}方式, 从mybatis3.4 开始使用#{arg0}方式。所以在使用该方式传参的时候注意选择MyBatis的版本。
在xxxMapper.xml文件中引用参数语法:#{ arg参数位置},如:第一个参数是#{arg0}, 第二个是#{arg1}。如:
select .... where id = #{arg1} or name = #{arg0};
2.2.5带多个参数-使用Map[万能&推荐]:把Map集合当做Mapper接口中方法的参数,也就是首先把所有参数放到Map集合里面,然后再把Map集合当做参数传入Mapper接口的方法中;
接口:List<Book> query2(Map<String,Object> map);
映射文件:select ... where id=#{key1} or sname=#{key2}
测试:
Map<String,Object> map = new HashMap<>();
map.put("sid",1);
map.put("name","测试");
bookService.query2(map);
3.MyBatis之动态SQL.
3.1MyBatis动态SQL概述.
1).动态SQL,通过MyBatis 提供的各种标签对条件作出判断以实现动态拼接SQL 语句,
主要是where部分有变化。
2).常用的动态SQL 标签有<if>、<where>、<sql/>、<foreach>等。
3).MyBatis 的动态SQL 语句,与JSTL标签中的语句非常相似。
4).动态 SQL应用场景:
主要用于解决查询条件不确定的情况。
在程序运行期间,根据用户提交的查询条件进行查询。
提交的查询条件不同,执行的 SQL 语句不同。
若将每种可能的情况都由程序员逐一列出,
对所有条件进行排列组合,将会出现大量的SQL 语句。
此时,可使用动态 SQL 来解决这样的问题。
5).注意,动态sql的sql语句部分可以使用 ">"和">=",但是不能使用 "<"和"<=",要使用 "<" 表示 "<","<="表示 "<="(验证:查询指定价格范围内的数据)。> >
3.2动态SQL之<if>+<where>.
3.3动态sql之trim:
属性:
prefix:要添加的前缀;prefixOverrides:要删除的前缀。
suffix:要添加的后缀;suffixOverrides:要删除的后缀。
insert方法分析。
3.4动态SQL之<foreach>:
属性–collection:表示要遍历的类型是数组还是List集合。
如果Mapper接口方法里面的形参是数组,
那么collection="array";
如果Mapper接口方法里面的形参是List集合,
那么collection="List";
属性–open、close、separator:对遍历list集合的内容进行拼接,如:
collection里面的数组或者集合其实就是sql条件查询里面条件的取值范围,
比如:where sid in(1,2,3,4,5),那么collection里面的数组或者集合表示的就是 "1 2 3 4 5",
注意值和值之间是没有符合隔开的,而且开始和末尾也没有小括号包裹。
在sql语句执行的时候这些取值要用括号括起来,而且值和值之间一般要用逗号隔开。
open、close、separator这三个属性就是完成这些工作的,比如:sql语句where sid in(1,2,3,4,5),
那么:open="(",separator=",",close=")"。
属性–item:表示要遍历的list集合里面的每条数据,在当前案例里面list集合里面存放的是学号,那么item表示的就是每个学号。
语法:
<foreach collection="集合类型" open="开始的字符" close="结束的字符" item="集合里面的元素" separator="集合元素之间的分隔符">
#{取item里面的值}
</foreach>
测试:给定一个存储书本编号的List集合,查询出书本编号在这个List集合范围的所有书本。
3.5动态SQL之<sql>.
3.5.1<sql>介绍.
<sql/>标签是用来定义SQL片段,其实就是一段sql代码,可以是表名,几个字段,where条件都可以。
可以在其他地方引用sql标签的内容,当引用sql片断时,需要通过<include/>子标签指定要引用的sql片段的id进行引用。
<sql/>标签可以定义在sql语句中的任何合理位置,所以<include/>子标签可以放在动态sql的任何位置。