使用XML配置文件实现数据库操作(一)
1.SQL映射文件
SQL映射文件就是我们通常说的mapper.xml配置文件,主要实现SQL语句的配置和映射,同时实现Java的POJO对象与数据库中的表和字段进行映射关联的功能。
1.1 mapper.xml的结构
下面就来详细介绍mapper.xml文件的结构。首先看一个完整的mapper.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.demo.Mapper.StudentMapper"><select id="selectAll" resultMap="BaseResultMap">SELECT*FROM student</select><resultMap id="BaseResultMap" type="com.example.demo.model.Student"><id column="id" property="id" jdbcType="BIGINT" /><result column="name" property="name" jdbcType="VARCHAR" /><result column="sex" property="sex" javaType="INTEGER" /><result column="age" property="age" jdbcType="INTEGER" /></resultMap>
</mapper>
如上述示例所示,一般mapper.xml主要分为4部分:
1)mapper.xml的语法声明,声明MyBatis语法。
2)通过namespace指明mapper.xml文件对应的Mapper接口。
3)通过XML标签定义接口方法对应的SQL语句,id属性对应Mapper接口中的方法,resultMap属性为返回值类型。
4)<resultMap>
标签定义返回的结果类型与数据库表结构的对应关系,上面映射的是Student实体类对象。
1.2 mapper.xml的标签
mapper.xml映射文件提供了一些非常实用的标签,其中比较常用的有resultMap、sql、insert、update、delete、select等标签。熟练掌握标签的使用,这样使用MyBatis才能如鱼得水。MyBatis标签和功能说明如表所示。
2.定义SQL语句
MyBatis提供了insert、update、delete和delete四个标签来定义SQL语句。接下来就从SQL语句开始介绍每个标签的用法。
2.1 select
select是MyBatis常用的元素之一,MyBatis在查询和结果映射中做了相当多的改进。一个简单查询的select元素是非常简单的,比如:
<select id="selectOne" resultType="hashmap" parameterType="Long">SELECT name,age FROM student WHERE id = #{id}
</select>
在上面的示例中,通过id查询学生的姓名和年龄。定义方法名为selectOne,接收一个Long类型的参数,并返回一个HashMap类型的对象。HashMap的键是列名,值是结果集中的对应值。#{id}为传入的参数符号。
select标签允许配置很多属性来配置每条语句的行为细节,比如参数类型、返回值类型等,包含的属性如表所示。
属性 | 说明 |
---|---|
id | 命名空间中唯一的标识符,被用来引用这条语句 |
parameterType | 将传入语句的参数的数据类型,可选。因为 MyBatis 可以通过类型处理程序(TypeHandler)推断出传入语句的参数的数据类型,默认值为未设置 (unset) |
resultType | 返回结果的数据类型。注意,如果返回的是集合,那么应该设置为集合包含的类型,而不是集合本身的类型。resultType 和 resultMap 之间只能使用一个 |
resultMap | 结果映射, resultMap 是 MyBatis 的强大特性之一, resultType 和resultMap 之间只能使用一个 |
flushCache | 是否清空缓存,Select 语句默认值为 false,如果设置为 true,只要语句被调用,将清空本地缓存和二级缓存 |
useCache | 是否使用缓存,默认值为 tue,缓存本条语句的查询结果 |
timeout | 超时时间,等待数据库返回请求结果的时间。默认值为未设置 (unset) |
fetchSize | 设置返回的结果行数。默认值为未设置 (unset) |
statementType | 使用 Statement、PreparedStatement或CallableStatement执行SQL 语句,默认值为PREPARED |
resultSetType | FORWARD_ONLY、SCROLL_SENSITIVE、SCROLL_INSENSITIVE 或 DEFAULT (等价于unset),默认值为DEFAULT |
databaseId | 数据库厂商标识 (databaseldProvider),如果配置了此属性,MyBatis 会加载所有不带databaseId 或匹配当前 databaseId 的语句 |
resultOrdered | 针对嵌套结果 select 语句,默认值为 false,如果为 true,将会假设包含嵌套结果集或分组,当返回一个主结果行时,不会产生对前面结果集的引用 |
resultSets | 仅适用于多结果集的情况。将列出语句执行后返回的结果集并赋予每个结果集一个名称,多个名称之间以逗号分隔 |
select标签虽然有很多属性,但是常用的是id、parameterType、resultType、resultMap这4个属性。需要注意的是,resultMap是MyBatis的强大特性之一,如果对其理解透彻,许多复杂的映射问题都能迎刃而解。
2.2 insert
insert标签主要用于定义插入数据的SQL语句,例如:
<insert id="insert" parameterType="com.example.demo.Mapper.Student">INSERT INTOstudent(id, name, sex, age)VALUES(#{id}, #{name}, #{sex}, #{age})
</insert>
在上面的示例中,插入语句的配置规则更加复杂,同时提供了额外的属性和子元素用来处理主键的生成方式。
如果数据库包含自动生成主键的字段,那么可以设置useGeneratedKeys=“true”,然后把keyProperty设置为目标属性。比如,上面的Student表已经在id列上使用了自动生成主键,那么语句可以修改为:
<insert id="insert" useGeneratedKeys="true" keyProperty="id" parameterType="com.example.demo.model.Student">INSERT INTOstudent(name, sex, age)VALUES(#{name}, #{sex}, #{age})
</insert>
在上面的示例中,设置useGeneratedKeys=“true”,然后设置keyProperty="id"对应的主键字段。
insert标签包含的属性如表所示。
属性 | 说明 |
---|---|
id | 命名空间中唯一的标识符,被用来引用这条语句 |
parameterType | 将传入语句的参数的数据类型,可选。MyBatis 可以通过类型处理程序 (TypeHandler)推断出传入语句的参数的数据类型,默认值为未设置 (unset) |
flushCache | 是否清空缓存,默认值为 true,只要语句被调用,就清空本地缓存和二级缓存 |
timeout | 超时时间,即等待数据库返回请求结果的时间。默认值为未设置 (unset) |
statementType | 使用 Statement、PreparedStatement 或 CallableStatement 执行 SQL 语句,默认值为PREPARED |
useGeneratedKeys | 自动生成主键,默认值为 false,设置为 true 时,根据规则自动生成主键 |
keyProperty | 指定能够唯一识别对象的属性 |
keyColumn | 指定数据库表的主键列名 |
databaseld | 数据库厂商标识 (databaseIdProvider),如果配置了此属性,MyBatis 会加载所有不带databaseId 或匹配当前 databaseId 的语句 |
常用的属性有id、parameterType、useGeneratedKeys、keyProperty等,部分属性和select标签是一致的。
2.3 update
update标签和insert标签类似,主要用来映射更新语句,示例代码如下:
<update id="update" parameterType="com.example.demo.model.Student">UPDATEstudentSETname = #{name},sex = #{sex},age = #{age}WHEREid = #{iid
</update>
如果需要根据传入的参数来动态判断是否进行修改,可以使用if标签动态生成SQL语句,示例代码如下:
<update id="update" parameterType="com.example.demo.model.Student">UPDATEstudentSET<if test="name != null">name = #{name},</if><if test="sex != null">sex = #{sex},</if>age = #{age}WHEREid = #{iid
</update>
在上面的示例中,通过if标签判断传入的name参数是否为空,实现根据参数动态生成SQL语句。
update标签包含的属性和insert标签基本一致。
2.4 delete
delete标签用来映射删除语句。
<delete id="delete" parameterType="Long">DELETE FROMstudentWHEREid = #{id}
</delete>
delete标签包含的属性如表所示。
delete标签除了少了useGeneratedKeys、keyProperty和keyColumn三个属性之外,其余的和insert、update标签一样。
3.结果映射
结果映射是MyBatis重要的功能之一。对于简单的SQL查询,使用resultType属性自动将结果转换成Java数据类型。不过,如果是复杂的语句,则使用resultMap映射将查询结果转换为数据实体关系。
3.1 resultType
前面介绍select标签的时候提到,select标签的返回结果可以使用resultMap和resultType两个属性指定映射结构。下面就来演示resultType的用法。
<select id="selectOne" resultType="com.example.demo.model.Student">select *from studentwhere id =#{id}
</select>
通过设置resultType属性,MyBatis会自动把查询结果集转换为Student实体对象。当然,如果只查询部分字段,则可以返回HashMap,比如:
<select id="selectOne" parameterType="Long" resultType="hashmap">select name,age from student where id = #{id}
</select>
上述语句,Mybatis会自动将所有的列映射成HashMap对象
3.2 resultMap
在日常开发过程中,在大部分情况下resultType就能满足。但是使用resultType需要数据库字段和属性字段名称一致,否则就得使用别名,这样就使得SQL语句变得复杂。
所以MyBatis提供了resultMap标签定义SQL查询结果字段与实体属性的映射关系。下面演示resultMap的使用。
首先,定义resultMap:
<resultMap id="BaseResultMap" type="com.example.demo.model.Student"><id column="id" property="id" jdbcType="BIGINT" /><result column="name" property="name" jdbcType="VARCHAR" /><result column="sex" property="sex" javaType="INTEGER" /><result column="age" property="age" jdbcType="INTEGER" />
</resultMap>
在上面的示例中,我们使用resultMap标签定义了BaseResultMap映射关系,将数据库中的字段映射为Student实体对象。
然后,在SQL语句中使用自定义的BaseResultMap映射关系,设置select标签的resultMap=“BaseResultMap”,示例代码如下:
<select id="selectOne" parameterType="Long" resultMap="BaseResultMap">SELECT*FROM studentWHERE id =#{id}
</select>
3.3 resultMap的结构
resultMap标签的结构比较复杂,包含很多子属性和子标签。resultMap标签包含id和type属性:
- id定义该resultMap的唯一标识。
- type为返回值的类名。
同样,resultMap还可以包含多个子标签,包括:
1)id标签用于设置主键字段与领域模型属性的映射关系,此处主键为id,对应数据库字段中的主键ID。
2)result标签用于设置普通字段与领域模型的属性映射关系。
3)association标签用于配置一对一结果映射,可以关联resultMap中的定义,或者对其他结果映射的引用。
4)collection标签用于配置一对多结果映射,可以关联resultMap中的定义,或者对其他结果映射的引用。
下面是完整的resultMap元素的结构:
<resultMap id="BaseResultMap" type="com.example.demo.model.Student"><id column="id" property="id" jdbcType="BIGINT" /><result column="name" property="name" jdbcType="VARCHAR" /><result column="sex" property="sex" javaType="INTEGER" /><result column="age" property="age" jdbcType="INTEGER" /><association property="classes" javaType="com.example.demo.model.Classes"><id column="id" property="id"/><result column="class_name" property="name" jdbcType="VARCHAR"/><result column="memo" property="memo" jdbcType="VARCHAR"/></association>
</resultMap>