MyBatis快速入门（11）XML映射文件-select

心已赠人 2022-12-08 15:30 205阅读 0赞

# XML映射文件 #

MyBatis 的真正强大在于它的映射语句，这是它的魔力所在。由于它的异常强大，映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比，你会立即发现省掉了将近 95% 的代码。MyBatis 为聚焦于 SQL 而构建，以尽可能地为你减少麻烦。

SQL 映射文件只有很少的几个顶级元素，也就是mapper中的标签（按照应被定义的顺序列出）：

> cache – 对给定命名空间的缓存配置。
> 
> cache-ref – 对其他命名空间缓存配置的引用。
> 
> resultMap – 是最复杂也是最强大的元素，用来描述如何从数据库结果集中来加载对象。
> 
> parameterMap – 已被废弃！老式风格的参数映射。更好的办法是使用内联参数，此元素可能在将来被移除。文档中不会介绍此元素。
> 
> sql – 可被其他语句引用的可重用语句块。
> 
> insert – 映射插入语句
> 
> update – 映射更新语句
> 
> delete – 映射删除语句
> 
> select – 映射查询语句

下面将对这些标签元素逐步介绍，首先是select。

# select语句 #

查询语句是 MyBatis 中最常用的元素之一，光能把数据存到数据库中价值并不大，只有还能重新取出来才有用，多数应用也都是查询比修改要频繁。对每个插入、更新或删除操作，通常间隔多个查询操作。这是 MyBatis 的基本原则之一，也是将焦点和努力放在查询和结果映射的原因。简单查询的 select 元素是非常简单的。比如：

![4b2dfcca5d9710dd7f3b741285697d1f.png][]

查询语句在select标签中，标签常用的属性有id，入参类型，回参类型等，注意参数的传递方式：

> \#\{id\}

这就告诉 MyBatis 创建一个预处理语句（PreparedStatement）参数，在 JDBC 中，这样的一个参数在 SQL 中会由一个“?”来标识，并被传递到一个新的预处理语句中，就像这样：

![2127c7920b7b1e0fa06e5ce265c8991b.png][]

上面是我们非常熟悉的JDBC代码，当然，使用 JDBC 意味着需要更多的代码来提取结果并将它们映射到对象实例中，而这就是 MyBatis 节省你时间的地方，在mybatis中这些都是封装好的，不需要我们来处理。

select标签除了id、parameterType、resultType三个属性之外，还有一些其它的属性，我们前面也接触过databaseId，表示的是数据库类型的简称，除了这些之外还有一些其它的属性，

![dd2162f856e7c3a78a7049e4640f093f.png][]

> parameterMap已经废弃，大家不用再关注。
> 
> resultMap也是用来接收返回结果的，后面会重点介绍。
> 
> flushCache和useCache会在讨论mybatis缓存的时候重点介绍。
> 
> statementType属性表示设置statement的类型，在JDBC中，statement表示编译，这里需要选择设置编译类型STATEMENT，PREPARED 或 CALLABLE 中的一个，这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。

其它的说明可以参考上面图片的描述。

# 示例1：单字段查询 #

单独查询一个字段可以说是select语句最简单的查询业务了，比如：

> select name from t\_user where id=\#\{id\}

这种情况属于精确查询，返回的数据数量小于等于1个，我们来用一个精确的类型接收即可：

![67e6d83c18efa7a554f676bdbac054cb.png][]

如果没有精确的条件：

> select name from t\_user

那么返回的结果就可能是零到多个，必须用一个列表来接收：

![0fea799029494e46444c3317ee2ffa80.png][]

上面的语句没有传入的参数，所以入参不用写了，回参用列表接收，接口的定义也要用对应的类型：

> List<String>  selectNames();

这样就能接收多个结果集。

# 示例2：返回对象 #

有时候我们查询的内容是多个字段，而这多个字段包含在一个实体类的当中，这时候就可以用实体类直接接收：

![7527d9371249baedafa9a47e8fd67590.png][]

接口的定义为：

> User  selectById(Integer id);

mybatis会自动将查询的字段值封装到对应的对象当中，同样的道理，如果结果有多个，也需要用列表接收：

![e6422070246987269736ab72c968de7f.png][]

对应的接口：

> List<User>  selectList();

从上面两个例子可以看出，结果有一个还是多个，不影响resultType的写法，只是接口结果类型有影响。这里还要注意，不一定查询的字段与实体类中的字段完全吻合才能用实体类接收，只是其中的一部分也可以，比如：

![68f9c9120b20a790641411d2568cda2d.png][]

但是要注意，查询的字段如果有的不包含在实体类当中，就不能用实体类接收！

同时还要注意，查询出来的字段的名字要与实体类的名字对应，如果数据库中是id，names，而实体类中是id，name，那么查询的时候最好改成一样的：

> select id,names as "name" from t\_user

回参可以是一个自定义类型，同理，入参也可以是我们传入的如果是多个参数，又恰好在一个类当中，就可以用类型作为入参：

![e2b6098f21eae983a4adc71c4754dfb3.png][]

接口定义：

> Integer  selectCountByUser(User user);

注意，如果回参类型是基础类型，比如int，long等等，最好写成包装类，Integer，Long等。如果是基础类型，容易受到默认值影响。

# 示例3：返回map #

某些情况下我们查询的结构是多个表组合在一起的结果，而我们写的实体类基本上和数据库表是一一对应的。这时候有两种办法，一种是专门针对这种情况创建一个实体类，用来接收这类SQL的结果，这种情况与上面的类似，不再讨论。另一种简单一些，直接使用map类型接收。

![5511a93f343995dc0c721f3141903d19.png][]

另外要注意，使用map接收最好给每个字段用 as 取个别名，否则像oracle之类的数据库可能出现大小写问题。

代码地址：[https://gitee.com/blueses/mybatis-demo][https_gitee.com_blueses_mybatis-demo]  04

[4b2dfcca5d9710dd7f3b741285697d1f.png]: /images/20221123/7b4386d4fd234e979d9447c5139d56d2.png
[2127c7920b7b1e0fa06e5ce265c8991b.png]: /images/20221123/e01accf7d7d74a97a1d11cefbfcfb020.png
[dd2162f856e7c3a78a7049e4640f093f.png]: /images/20221123/edbbed8d435849499e3e99afcd467d32.png
[67e6d83c18efa7a554f676bdbac054cb.png]: /images/20221123/ee8ee5a3345b43ce940061d01cbab7d0.png
[0fea799029494e46444c3317ee2ffa80.png]: /images/20221123/b58d7d4aa31b4bfaae7dd9acaecd5f91.png
[7527d9371249baedafa9a47e8fd67590.png]: /images/20221123/ac94c6c8b6bc4ea9a6d822dc0fe0fa29.png
[e6422070246987269736ab72c968de7f.png]: /images/20221123/9b10fbe7dfc84396a475a99270b3f6f8.png
[68f9c9120b20a790641411d2568cda2d.png]: /images/20221123/33e3e3bdf04b481f8f3761a64e5237ed.png
[e2b6098f21eae983a4adc71c4754dfb3.png]: /images/20221123/b6ce2096848a45f0b91adeab88d5e7a3.png
[5511a93f343995dc0c721f3141903d19.png]: /images/20221123/983f087a05d1401eadb400ebd5c3f7f1.png
[https_gitee.com_blueses_mybatis-demo]: https://gitee.com/blueses/mybatis-demo