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

XML映射文件

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

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

cache – 对给定命名空间的缓存配置。

cache-ref – 对其他命名空间缓存配置的引用。

resultMap – 是最复杂也是最强大的元素，用来描述如何从数据库结果集中来加载对象。

parameterMap – 已被废弃！老式风格的参数映射。更好的办法是使用内联参数，此元素可能在将来被移除。文档中不会介绍此元素。

sql – 可被其他语句引用的可重用语句块。

insert – 映射插入语句

update – 映射更新语句

delete – 映射删除语句

select – 映射查询语句

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

 

 

 

 

 

select语句

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

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

#{id}

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

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

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

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个，我们来用一个精确的类型接收即可：

如果没有精确的条件：

select name from t_user

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

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

List<String>  selectNames();

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

 

 

 

 

 

示例2：返回对象

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

接口的定义为：

User  selectById(Integer id);

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

对应的接口：

List<User>  selectList();

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

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

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

select id,names as "name" from t_user

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

接口定义：

Integer  selectCountByUser(User user);

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

 

 

 

 

 

示例3：返回map

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

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

 

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