Mybatis Mapper XML文件-查询(select)

MyBatis真正的力量在于映射语句(Mapped Statements)。这是魔力发生的地方。尽管拥有强大的功能,Mapper XML文件相对来说比较简单。如果将其与等效的JDBC代码进行比较,您会立即看到代码减少了95%。MyBatis专注于SQL的编写,并尽最大努力不干扰您的方式。

Mapper XML文件仅有几个一级元素(按照定义的顺序):

  • cache – 针对给定命名空间的缓存配置。
  • cache-ref – 从另一个命名空间引用缓存配置。
  • resultMap – 最复杂和强大的元素,描述如何从数据库结果集加载对象。
  • sql – 可以被其他语句引用的可重用SQL代码片段。
  • insert – 映射的INSERT语句。
  • update – 映射的UPDATE语句。
  • delete – 映射的DELETE语句。
  • select – 映射的SELECT语句。
 select

在MyBatis中,select语句是最常用的元素之一。将数据存入数据库并不是非常有价值,直到你将其取回才变得有意义,因此大多数应用程序进行的操作更多是查询而不是修改数据。对于每个插入、更新或删除操作,可能会有很多查询操作。这是MyBatis的一个基本原则,也是为什么在查询和结果映射方面付出了如此多的关注和努力的原因。对于简单的情况,select元素非常简单。例如:

<select id="selectPerson" parameterType="int" resultType="hashmap">
  SELECT * FROM PERSON WHERE ID = #{id}
</select>

 这个语句被称为selectPerson,接受一个类型为int(或Integer)的参数,并返回一个以列名为键,行值为值的HashMap。

请注意参数表示方式:

#{id}

这告诉MyBatis要创建一个PreparedStatement参数。在JDBC中,这样的参数会被一个“?”来表示,在传递给新的PreparedStatement的SQL中会是这样的形式:

// Similar JDBC code, NOT MyBatis…
String selectPerson = "SELECT * FROM PERSON WHERE ID=?";
PreparedStatement ps = conn.prepareStatement(selectPerson);
ps.setInt(1,id);

当然,仅使用JDBC需要更多的代码来提取结果并将其映射到对象的实例中,而这正是MyBatis帮助您避免做的。

select元素还有更多的属性,允许您配置每个语句的详细行为。

<select
  id="selectPerson"
  parameterType="int"
  parameterMap="deprecated"
  resultType="hashmap"
  resultMap="personResultMap"
  flushCache="false"
  useCache="true"
  timeout="10"
  fetchSize="256"
  statementType="PREPARED"
  resultSetType="FORWARD_ONLY">
Attribute(属性)Description(描述)
id在这个命名空间中的一个唯一标识符,可以用来引用这个语句。
parameterType完全限定的类名或参数的别名,将传递给这个语句。这个属性是可选的,因为MyBatis可以通过实际传递给语句的参数来计算要使用的TypeHandler。默认是未设置的。
parameterMap这是一种已过时的引用外部参数映射的方法。请使用内联参数映射和parameterType属性。
resultType这是期望从该语句返回的结果类型的完全限定类名或别名。请注意,在集合的情况下,应该是集合所包含的类型,而不是集合本身的类型。使用resultType或resultMap,而不要同时使用两者。
resultMap对外部resultMap的命名引用。结果映射是MyBatis最强大的特性,通过对其进行良好理解,可以解决许多复杂的映射情况。使用resultMap或resultType,而不要同时使用两者。
flushCache将此设置为true将导致在每次调用该语句时刷新本地缓存和二级缓存。对于select语句,默认值为false。
useCache将此设置为true将导致该语句的结果被缓存在二级缓存中。对于select语句,默认值为true。
timeout这个属性设置驱动程序在请求后等待数据库返回的时间,超过该时间将抛出异常。默认值是未设置的(依赖于驱动程序)。
fetchSize这是一个驱动程序提示,它会尝试使驱动程序以指定大小的行批量返回结果。默认值是未设置的(依赖于驱动程序)。
statementType可以选择其中的一个:STATEMENT、PREPARED或CALLABLE。这会让MyBatis分别使用Statement、PreparedStatement或CallableStatement。默认值为PREPARED。
resultSetType可以选择其中之一:FORWARD_ONLY、SCROLL_SENSITIVE、SCROLL_INSENSITIVE或DEFAULT(与未设置相同)。默认值为unset(依赖于驱动程序)。
databaseId如果配置了databaseIdProvider,MyBatis将加载所有没有databaseId属性或者其databaseId与当前数据库Id匹配的语句。如果发现相同的语句既有databaseId,又没有databaseId,后者将被丢弃。
resultOrdered这仅适用于嵌套的结果选择语句:如果设置为true,则假定嵌套结果被包含或分组在一起,以便当返回新的主结果行时,不会再出现对以前结果行的引用。这样可以使嵌套结果填充更加友好地使用内存。默认值为false。
resultSets这仅适用于多个结果集。它列出了语句将返回的结果集,并为每个结果集提供一个名称。名称之间用逗号分隔。
affectData当编写返回数据的INSERT、UPDATE或DELETE语句时,将其设置为true,以便正确控制事务。还可参见事务控制方法。默认值为false(自3.5.12版起)。

### MyBatis-Plus Mapper XML 文件配置及用法 #### 配置文件中的路径设置 为了使MyBatis-Plus能够找到并加载`Mapper.xml`文件,在Spring Boot项目的配置文件中需指定这些文件的位置。通常情况下,这通过调整`application.yml`或`application.properties`来实现。 对于位于资源目录下的XML映射器文件,可以采用通配符模式指明多个位置: ```yaml mybatis-plus: mapper-locations: classpath*:/com/example/zj/**/*Mapper.xml,classpath*:/com/example/check/**/*Mapper.xml ``` 上述配置会指示框架去特定包及其子包内寻找所有的`Mapper.xml`文档[^1]。 当XML文件放置于Java源码树之下而非默认的`resources`目录时,则应相应修改路径表达式以匹配实际存放地点: ```properties mybatis-plus.mapper-locations=classpath*:com/example/springbootmybatisplus/mapper/xml/*.xml ``` 这里的关键在于确保路径前缀包含了`:classpath*:`以便支持从类路径根部开始搜索,并且注意区分大小写以及斜杠的方向要保持一致[^2]。 #### 自定义SQL编写指南 在创建具体的`Mapper.xml`文件过程中,遵循标准命名约定有助于简化开发流程——即接口名称加上`.xml`作为扩展名。例如,针对名为`UserMapper.java`的数据访问层接口,对应的SQL语句应当保存在一个叫做`UserMapper.xml`的文件里。 每个SQL片段都封装在一个标签内部,比如<select>、<insert>等,它们对应着不同类型的数据库操作命令。下面给出一段简单的查询示例代码用于获取用户列表: ```xml <?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"> <mapper namespace="com.example.zj.UserMapper"> <!-- 查询所有用户的记录 --> <select id="selectAllUsers" resultType="com.example.model.User"> SELECT * FROM users; </select> </mapper> ``` 此段落展示了如何构建一个基本的选择语句,其中`namespace`属性关联到相应的DAO/Repository接口;而`id`参数用来唯一标识该方法签名内的每一个声明。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值