spring boot 集成 mybatis 全面讲解
mybatis 是一款优秀的持久层框架,与 spring boot 集成后可以大大简化开发流程。本文将全面讲解如何在 spring boot 中集成 mybatis,包括环境配置、基础操作、高级功能和最佳实践。
一、mybatis 简介
1. sqlsession
sqlsession
是 mybatis 的核心接口,负责执行 sql 语句、获取映射器实例以及管理事务。
1.1 sqlsession 的创建
sqlsession
通常通过 sqlsessionfactory
获取。以下是创建 sqlsessionfactory
的典型代码:
inputstream inputstream = resources.getresourceasstream("mybatis-config.xml"); sqlsessionfactory sqlsessionfactory = new sqlsessionfactorybuilder().build(inputstream); try (sqlsession session = sqlsessionfactory.opensession()) { // 使用 session 进行数据库操作 }
注意:在 spring 集成中,
sqlsessionfactory
和sqlsession
的创建由框架管理,我们只需要通过依赖注入获取即可。
1.2 sqlsession 的常用方法
sqlsession
提供了多种方法,用于执行数据库操作:
查询操作:
// 单条记录查询 user user = session.selectone("namespace.statementid", parameter); // 多条记录查询 list<user> users = session.selectlist("namespace.statementid", parameter);
插入操作:
int rows = session.insert("namespace.statementid", parameter);
更新操作:
int rows = session.update("namespace.statementid", parameter);
删除操作:
int rows = session.delete("namespace.statementid", parameter);
事务控制:
session.commit(); // 提交事务session.rollback(); // 回滚事务
2. mapper 映射器
mapper 映射器是 mybatis 的核心功能,用于实现 sql 和 java 方法之间的映射。它可以通过注解或 xml 配置。
2.1 基于注解的 mapper
注解方式直接将 sql 写在 mapper 接口中,简单高效,适合简单场景。
示例代码:
@mapper public interface usermapper { @select("select * from user where id = #{id}") user selectbyid(long id); @insert("insert into user (username, email) values (#{username}, #{email})") int insertuser(user user); @update("update user set email = #{email} where id = #{id}") int updateuser(user user); @delete("delete from user where id = #{id}") int deleteuser(long id); }
2.2 基于 xml 的 mapper
xml 配置更加灵活,适合复杂查询场景。mapper xml 文件通常位于 resources/mapper
目录。
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.mapper.usermapper"> <!-- 查询 --> <select id="selectbyid" parametertype="long" resulttype="com.example.entity.user"> select * from user where id = #{id} </select> <!-- 插入 --> <insert id="insertuser" parametertype="com.example.entity.user"> insert into user (username, email) values (#{username}, #{email}) </insert> <!-- 更新 --> <update id="updateuser" parametertype="com.example.entity.user"> update user set email = #{email} where id = #{id} </update> <!-- 删除 --> <delete id="deleteuser" parametertype="long"> delete from user where id = #{id} </delete> </mapper>
2.3 mapper 映射器的工作机制
mapper 接口的方法名和参数需要与 xml 中的 id
和 parametertype
对应。mybatis 会通过动态代理为 mapper 接口生成实现类,并调用对应的 sql。
3. 配置文件
mybatis 的配置文件包括全局配置文件(mybatis-config.xml
)和映射文件(mapper.xml
)。
3.1 全局配置文件
mybatis-config.xml
定义了数据库连接、日志设置、别名等全局配置。
典型配置示例:
<?xml version="1.0" encoding="utf-8" ?> <!doctype configuration public "-//mybatis.org//dtd config 3.0//en" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <!-- 环境配置 --> <environments default="development"> <environment id="development"> <transactionmanager type="jdbc"/> <datasource type="pooled"> <property name="driver" value="com.mysql.cj.jdbc.driver"/> <property name="url" value="jdbc:mysql://localhost:3306/mybatis_demo"/> <property name="username" value="root"/> <property name="password" value="root"/> </datasource> </environment> </environments> <!-- 别名配置 --> <typealiases> <typealias type="com.example.entity.user" alias="user"/> </typealiases> <!-- mapper 映射文件 --> <mappers> <mapper resource="mapper/usermapper.xml"/> </mappers> </configuration>
3.2 映射文件配置
映射文件定义了具体的 sql 和 java 对象之间的关系。以 usermapper.xml
为例:
<mapper namespace="com.example.mapper.usermapper"> <select id="selectall" resulttype="user"> select * from user </select> <resultmap id="userresultmap" type="user"> <id column="id" property="id"/> <result column="username" property="username"/> <result column="email" property="email"/> </resultmap> </mapper>
4. resultmap
resultmap
是 mybatis 的强大特性之一,用于处理复杂查询结果与 java 对象的映射关系。
4.1 什么是 resultmap?
resultmap
用于自定义数据库字段与 java 对象属性的映射。它支持嵌套映射、别名和字段处理,适合复杂的对象映射场景。
4.2 resultmap 配置示例
以下是一个带嵌套对象的 resultmap
配置:
数据库表:
create table user ( id bigint primary key, username varchar(50), email varchar(100) ); create table address ( id bigint primary key, user_id bigint, city varchar(50), foreign key (user_id) references user(id) );
java 对象:
@data public class user { private long id; private string username; private string email; private address address; } @data public class address { private long id; private string city; }
resultmap 配置:
<resultmap id="userwithaddress" type="user"> <id column="id" property="id"/> <result column="username" property="username"/> <result column="email" property="email"/> <association property="address" javatype="address"> <id column="address_id" property="id"/> <result column="city" property="city"/> </association> </resultmap>
查询语句:
<select id="getuserwithaddress" resultmap="userwithaddress"> select u.id, u.username, u.email, a.id as address_id, a.city from user u left join address a on u.id = a.user_id where u.id = #{id} </select>
4.3 嵌套集合映射
对于一对多的嵌套关系,可以使用 <collection>
:
<resultmap id="userwithposts" type="user"> <id column="id" property="id"/> <result column="username" property="username"/> <collection property="posts" oftype="post"> <id column="post_id" property="id"/> <result column="title" property="title"/> </collection> </resultmap>
总结
sqlsession
、mapper
、配置文件
和 resultmap
是 mybatis 的核心概念。通过灵活的配置和映射,mybatis 可以高效地处理各种复杂的数据库操作需求。熟练掌握这些特性可以让开发者在项目中更高效地处理数据访问逻辑。
三、spring boot 集成 mybatis
mybatis 是一种轻量级的持久层框架,与 spring boot 集成后可以极大地提升开发效率。以下是集成的完整步骤,包括项目配置、数据库设计和基本操作。
1. 创建 spring boot 项目
在创建项目时,可以使用 spring initializr 快速生成骨架项目。以下依赖是集成 mybatis 所必需的:
- spring web:用于创建 rest api。
- mybatis framework:mybatis 的核心依赖。
- mysql driver:连接 mysql 数据库。
- lombok:简化实体类的开发,减少样板代码。
2. 配置 pom.xml
以下是需要在 pom.xml
中添加的 maven 依赖:
<dependencies> <!-- spring boot starter --> <dependency> <groupid>org.springframework.boot</groupid> <artifactid>spring-boot-starter</artifactid> </dependency> <!-- mybatis starter --> <dependency> <groupid>org.mybatis.spring.boot</groupid> <artifactid>mybatis-spring-boot-starter</artifactid> <version>3.0.0</version> </dependency> <!-- mysql driver --> <dependency> <groupid>mysql</groupid> <artifactid>mysql-connector-j</artifactid> </dependency> <!-- lombok --> <dependency> <groupid>org.projectlombok</groupid> <artifactid>lombok</artifactid> </dependency> </dependencies>
这些依赖包括 spring boot 核心、mybatis 框架、mysql 数据库驱动和 lombok。版本号可以根据项目需求进行调整。
3. 配置数据库连接
在 src/main/resources
目录下创建 application.yml
文件,用于配置项目的数据库连接。
application.yml 示例
spring: datasource: url: jdbc:mysql://localhost:3306/mybatis_demo?usessl=false&servertimezone=utc username: root password: root driver-class-name: com.mysql.cj.jdbc.driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.demo.entity
说明:
url
:数据库连接地址。username
和password
:数据库的用户名和密码。mapper-locations
:指定 mybatis 的 xml 映射文件路径。type-aliases-package
:指定实体类所在的包,用于启用简化的类名映射。
4. 创建数据库表
使用以下 sql 语句创建一个简单的用户表:
sql 示例
create database if not exists mybatis_demo; use mybatis_demo; create table user ( id bigint primary key auto_increment, username varchar(50) not null, password varchar(50) not null, email varchar(100) not null, created_at timestamp default current_timestamp );
此 sql 创建了一个名为 user
的表,用于存储用户信息。字段包括用户 id、用户名、密码、电子邮件以及创建时间。
5. 编写实体类
创建与数据库表对应的 java 实体类。
user.java
package com.example.demo.entity; import lombok.data; import java.time.localdatetime; @data public class user { private long id; private string username; private string password; private string email; private localdatetime createdat; }
说明:
- 使用了 lombok 的
@data
注解,自动生成getter
、setter
、tostring
等方法。 - 字段名称与数据库表的列名保持一致,便于自动映射。
6. 创建 mapper 接口
mybatis 的 mapper 接口用于定义数据库操作。可以选择使用注解方式或者 xml 配置方式编写 sql。
注解方式 mapper
以下是一个基于注解的 mapper 接口示例:
package com.example.demo.mapper; import com.example.demo.entity.user; import org.apache.ibatis.annotations.*; import java.util.list; @mapper public interface usermapper { @insert("insert into user (username, password, email) values (#{username}, #{password}, #{email})") int insertuser(user user); @select("select * from user where id = #{id}") user selectbyid(long id); @select("select * from user") list<user> selectallusers(); @update("update user set username = #{username}, password = #{password}, email = #{email} where id = #{id}") int updateuser(user user); @delete("delete from user where id = #{id}") int deleteuser(long id); }
xml 配置方式 mapper
xml 配置方式更灵活,适合复杂查询场景。以下是对应的 xml 映射文件。
文件位置:src/main/resources/mapper/usermapper.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.usermapper"> <insert id="insertuser" parametertype="com.example.demo.entity.user"> insert into user (username, password, email) values (#{username}, #{password}, #{email}) </insert> <select id="selectbyid" parametertype="long" resulttype="com.example.demo.entity.user"> select * from user where id = #{id} </select> <select id="selectallusers" resulttype="com.example.demo.entity.user"> select * from user </select> <update id="updateuser" parametertype="com.example.demo.entity.user"> update user set username = #{username}, password = #{password}, email = #{email} where id = #{id} </update> <delete id="deleteuser" parametertype="long"> delete from user where id = #{id} </delete> </mapper>
在 spring boot 中,mybatis 会自动扫描 mapper
文件夹下的 xml 文件。
7. 创建 service 层
为了更好地分离业务逻辑,建议将 mapper 操作封装到 service 层中。
userservice.java
package com.example.demo.service; import com.example.demo.entity.user; import com.example.demo.mapper.usermapper; import org.springframework.stereotype.service; import java.util.list; @service public class userservice { private final usermapper usermapper; public userservice(usermapper usermapper) { this.usermapper = usermapper; } public int createuser(user user) { return usermapper.insertuser(user); } public user getuserbyid(long id) { return usermapper.selectbyid(id); } public list<user> getallusers() { return usermapper.selectallusers(); } public int updateuser(user user) { return usermapper.updateuser(user); } public int deleteuser(long id) { return usermapper.deleteuser(id); } }
8. 创建 controller 层
最后,为了提供对外接口,创建 controller。
usercontroller.java
package com.example.demo.controller; import com.example.demo.entity.user; import com.example.demo.service.userservice; import org.springframework.web.bind.annotation.*; import java.util.list; @restcontroller @requestmapping("/api/users") public class usercontroller { private final userservice userservice; public usercontroller(userservice userservice) { this.userservice = userservice; } @postmapping public string createuser(@requestbody user user) { userservice.createuser(user); return "user created successfully!"; } @getmapping("/{id}") public user getuserbyid(@pathvariable long id) { return userservice.getuserbyid(id); } @getmapping public list<user> getallusers() { return userservice.getallusers(); } @putmapping public string updateuser(@requestbody user user) { userservice.updateuser(user); return "user updated successfully!"; } @deletemapping("/{id}") public string deleteuser(@pathvariable long id) { userservice.deleteuser(id); return "user deleted successfully!"; } }
9. 启动应用
创建项目主类 mybatisdemoapplication.java
:
package com.example.demo; import org.springframework.boot.springapplication; import org.springframework.boot.autoconfigure.springbootapplication; @springbootapplication public class mybatisdemoapplication { public static void main(string[] args) { springapplication.run(mybatisdemoapplication.class, args); } }
启动项目,使用工具(如 postman 或 curl)测试接口。
四、mybatis 基础操作详解
以下将详细讲解 mybatis 的基础操作,包括如何创建实体类、mapper 接口、xml 映射文件,以及如何通过 service 和 controller 层完成基础的增删改查功能。
1. 创建实体类
实体类用于表示数据库中的表记录,在 mybatis 中,实体类字段与数据库表的列进行一一对应。
示例代码:user.java
package com.example.demo.entity; import lombok.data; import java.time.localdatetime; @data public class user { private long id; // 用户id private string username; // 用户名 private string password; // 密码 private string email; // 邮箱 private localdatetime createdat; // 创建时间 }
说明:
- 使用
@data
注解自动生成getter
、setter
、tostring
等方法。 - 字段名称与数据库表的列名保持一致,便于 mybatis 自动映射。
2. 创建 mapper 接口
mapper 接口定义了对数据库表的操作。mybatis 支持两种方式:基于注解和基于 xml 映射文件。
基于注解的 mapper 接口
以下是使用注解定义的基础增删改查操作:
package com.example.demo.mapper; import com.example.demo.entity.user; import org.apache.ibatis.annotations.*; import java.util.list; @mapper public interface usermapper { // 插入用户 @insert("insert into user (username, password, email) values (#{username}, #{password}, #{email})") int insertuser(user user); // 查询所有用户 @select("select * from user") list<user> getallusers(); // 根据 id 查询用户 @select("select * from user where id = #{id}") user getuserbyid(long id); // 更新用户 @update("update user set username = #{username}, password = #{password}, email = #{email} where id = #{id}") int updateuser(user user); // 删除用户 @delete("delete from user where id = #{id}") int deleteuser(long id); }
注意:
- 使用
@mapper
注解让 spring 容器自动扫描 mapper 接口。 - 注解方式适合简单的 sql 语句,对于复杂查询建议使用 xml。
3. 配置 xml 映射文件
在复杂查询场景中,xml 配置文件更加灵活。
文件位置
src/main/resources/mapper/usermapper.xml
usermapper.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.usermapper"> <!-- 定义字段与属性的映射 --> <resultmap id="userresultmap" type="com.example.demo.entity.user"> <id column="id" property="id" /> <result column="username" property="username" /> <result column="password" property="password" /> <result column="email" property="email" /> <result column="created_at" property="createdat" /> </resultmap> <!-- 查询所有用户 --> <select id="getallusers" resultmap="userresultmap"> select * from user </select> <!-- 插入用户 --> <insert id="insertuser" parametertype="com.example.demo.entity.user"> insert into user (username, password, email) values (#{username}, #{password}, #{email}) </insert> <!-- 更新用户 --> <update id="updateuser" parametertype="com.example.demo.entity.user"> update user set username = #{username}, password = #{password}, email = #{email} where id = #{id} </update> <!-- 删除用户 --> <delete id="deleteuser" parametertype="long"> delete from user where id = #{id} </delete> </mapper>
注意:
namespace
必须与 mapper 接口的全路径名称一致。<resultmap>
定义了表字段与实体类属性之间的映射关系。#{}
用于参数占位,mybatis 会根据参数类型自动替换。
4. 创建 service 层
为了实现业务逻辑与数据访问的分离,建议通过 service 层封装 mapper 的操作。
示例代码:userservice.java
package com.example.demo.service; import com.example.demo.entity.user; import com.example.demo.mapper.usermapper; import org.springframework.stereotype.service; import java.util.list; @service public class userservice { private final usermapper usermapper; public userservice(usermapper usermapper) { this.usermapper = usermapper; } // 添加用户 public int adduser(user user) { return usermapper.insertuser(user); } // 获取所有用户 public list<user> getallusers() { return usermapper.getallusers(); } // 根据 id 查询用户 public user getuserbyid(long id) { return usermapper.getuserbyid(id); } // 更新用户 public int updateuser(user user) { return usermapper.updateuser(user); } // 删除用户 public int deleteuser(long id) { return usermapper.deleteuser(id); } }
说明:
- 通过依赖注入的方式引入
usermapper
。 - 将所有的数据库操作封装为独立的方法,便于管理和复用。
5. 创建 controller 层
controller 层提供 restful api 接口,供外部访问 service 方法。 示例代码:usercontroller.java
package com.example.demo.controller; import com.example.demo.entity.user; import com.example.demo.service.userservice; import org.springframework.web.bind.annotation.*; import java.util.list; @restcontroller @requestmapping("/api/users") public class usercontroller { private final userservice userservice; public usercontroller(userservice userservice) { this.userservice = userservice; } // 创建用户 @postmapping public string createuser(@requestbody user user) { userservice.adduser(user); return "user created successfully!"; } // 获取所有用户 @getmapping public list<user> getallusers() { return userservice.getallusers(); } // 根据 id 获取用户 @getmapping("/{id}") public user getuserbyid(@pathvariable long id) { return userservice.getuserbyid(id); } // 更新用户 @putmapping public string updateuser(@requestbody user user) { userservice.updateuser(user); return "user updated successfully!"; } // 删除用户 @deletemapping("/{id}") public string deleteuser(@pathvariable long id) { userservice.deleteuser(id); return "user deleted successfully!"; } }
说明:
- 使用
@restcontroller
标注类,返回 json 数据。 - 通过
@requestbody
接收前端传递的 json 数据。 - 通过
@pathvariable
获取 url 中的动态参数。
五、高级功能
1. 动态 sql
动态 sql 是 mybatis 的强大功能之一,可以根据输入条件动态生成 sql 语句。相比手动拼接 sql,这种方式更加安全、高效且可维护。
1.1 动态 sql 标签
mybatis 提供了以下动态 sql 标签:
<if>
:用于条件判断。<choose>
:类似于 java 的switch-case
。<where>
:自动添加where
关键字并处理多个条件。<set>
:动态生成set
子句,常用于更新语句。<foreach>
:用于迭代生成 sql(如in
子句或批量插入)。<trim>
:自定义 sql 前后缀(如添加括号、处理多余逗号等)。
1.2 动态 sql 示例
(1)条件查询:根据用户输入动态生成查询条件
xml 配置文件:
<select id="searchusers" resultmap="userresultmap"> select * from user <where> <if test="username != null"> and username = #{username} </if> <if test="email != null"> and email = #{email} </if> </where> </select>
注意:
<where>
标签会自动处理条件的拼接,并在至少有一个条件成立时自动添加where
关键字。
java 调用代码:
map<string, object> params = new hashmap<>(); params.put("username", "john"); params.put("email", null); list<user> users = usermapper.searchusers(params);
(2)动态更新:根据非空字段更新用户信息
在实际场景中,往往需要对部分字段进行更新,mybatis 的动态 sql 可以轻松实现。
xml 配置文件:
<update id="updateuser" parametertype="user"> update user <set> <if test="username != null"> username = #{username}, </if> <if test="password != null"> password = #{password}, </if> <if test="email != null"> email = #{email}, </if> </set> where id = #{id} </update>
注意:
<set>
标签会自动处理逗号,确保生成的 sql 语句语法正确。null
值的字段会被忽略,避免误更新。
java 调用代码:
user user = new user(); user.setid(1l); user.setusername("newname"); int rows = usermapper.updateuser(user);
(3)批量查询:使用 <foreach>
生成 in
子句
xml 配置文件:
<select id="findusersbyids" resultmap="userresultmap"> select * from user where id in <foreach collection="idlist" item="id" open="(" separator="," close=")"> #{id} </foreach> </select>
说明:
collection
指定输入参数(一般为 list 或数组)。item
是每次迭代的变量。open
、separator
和close
分别定义 sql 子句的开头、分隔符和结尾。
java 调用代码:
list<long> idlist = arrays.aslist(1l, 2l, 3l); list<user> users = usermapper.findusersbyids(idlist);
生成的 sql:
select * from user where id in (1, 2, 3);
2. 分页查询
分页查询是 web 应用中最常见的功能之一。在 mybatis 中,可以借助 pagehelper
插件实现高效分页。
2.1 使用 pagehelper 插件
(1)引入依赖
在 pom.xml
中添加以下依赖:
<dependency> <groupid>com.github.pagehelper</groupid> <artifactid>pagehelper-spring-boot-starter</artifactid> <version>1.4.0</version> </dependency>
(2)分页查询示例
在 service 层调用分页方法:
import com.github.pagehelper.pagehelper; import com.github.pagehelper.pageinfo; public list<user> getusersbypage(int pagenum, int pagesize) { // 启用分页 pagehelper.startpage(pagenum, pagesize); list<user> users = usermapper.getallusers(); // 封装分页结果 return new pageinfo<>(users).getlist(); }
(3)自定义分页
如果不想引入插件,也可以通过手动拼接分页 sql:
xml 配置文件:
<select id="getusersbypage" resultmap="userresultmap"> select * from user limit #{offset}, #{pagesize} </select>
mapper 接口:
list<user> getusersbypage(@param("offset") int offset, @param("pagesize") int pagesize);
java 调用代码:
int offset = (pagenum - 1) * pagesize; list<user> users = usermapper.getusersbypage(offset, pagesize);
3. 复杂对象映射
3.1 一对多映射
场景:一个用户有多个订单。
数据库表设计:
create table orders ( id bigint primary key, user_id bigint, order_name varchar(255), foreign key (user_id) references user(id) );
xml 配置文件:
<resultmap id="userwithorders" type="user"> <id column="id" property="id"/> <result column="username" property="username"/> <collection property="orders" oftype="order"> <id column="order_id" property="id"/> <result column="order_name" property="ordername"/> </collection> </resultmap> <select id="getuserwithorders" resultmap="userwithorders"> select u.id, u.username, o.id as order_id, o.order_name from user u left join orders o on u.id = o.user_id where u.id = #{id} </select>
3.2 嵌套查询
对于复杂的多表查询,可以使用嵌套查询实现。
xml 配置:
<resultmap id="orderresultmap" type="order"> <id column="id" property="id"/> <result column="order_name" property="ordername"/> </resultmap> <resultmap id="userwithorders" type="user"> <id column="id" property="id"/> <result column="username" property="username"/> <collection property="orders" resultmap="orderresultmap" column="id"/> </resultmap> <select id="getuserwithorders" resultmap="userwithorders"> select * from user where id = #{id}; </select>
六、最佳实践
1. 分层设计
- controller 层:负责接收请求和返回响应。
- service 层:封装业务逻辑。
- mapper 层:专注于数据库交互。
2. 避免 n+1 查询
一对多、多对多场景中,优先使用联合查询或嵌套查询,避免多个 sql 执行。
3. 启用日志
在 application.yml
中启用 mybatis 日志:
mybatis: configuration: log-impl: org.apache.ibatis.logging.stdout.stdoutimpl
4. 动态 sql 使用
<foreach>
实现批量操作。- 使用
<if>
结合<set>
实现动态更新。
总结
mybatis 的高级功能如动态 sql、分页查询和复杂对象映射,为开发者提供了极大的灵活性。在项目中,结合实际场景选择合适的实现方式,可以显著提高开发效率并降低维护成本。如果有任何疑问,欢迎在评论区留言讨论!
到此这篇关于spring boot 集成 mybatis 全面讲解(最新推荐)的文章就介绍到这了,更多相关spring boot 集成 mybatis内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!
发表评论