SpringBoot集成Mybatis
通过 SpringBoot +MyBatis 实现对数据库学生表的查询操作
一、实现步骤
新建一个 09-springboot-web-mybatis 项目,方式和之前一样,基于 springboot 的
1. 准备数据库
新建一个数据库 springboot,指定字符编码集 utf-8,并创建数据表
表名为:t_student,并插入几条数据
2. 在 pom.xml 中添加相关 jar 依赖
<!--Mybatis 整合 springboot 的起步依赖 -->
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.0.0</version>
</dependency>
<span class="hljs-comment"><!--MySQL 的驱动依赖,点击就可以查看,此时默认的是8.0的,
也可以根据自己使用的mysql版本号,来指定版本号
我使用的5.7
--></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>mysql<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>mysql-connector-java<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>5.1.9<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
3. 在 Springboot 的核心配置文件 application.properties 中配置数据源
注意 mysql 的版本差别
#配置内嵌 Tomcat 端口号
server.port=9090
#配置项目上下文根
server.servlet.context-path=/09-springboot-web-mybatis
#配置数据库的连接信息
#注意这里的驱动类有变化,这是 mysql8.0
#spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
#spring.datasource.url=jdbc:mysql://localhost:3306/springboot?useUnicode=true&characterEncoding=UTF-8&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8
#我用的 mysql5.7
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/springboot
spring.datasource.username=root
spring.datasource.password=123456
4. 开发代码
1. 使用 Mybatis 反向工程生成接口、映射文件以及实体 bean,具体看下面的介绍
2. 在 service 包下创建 service 接口并编写代码
package com.md.springboot.service;
import com.md.springboot.model.Student;
/**
-
@author MD
-
@create 2020-08-21 9:42
*/
public interface StudentService {
/**
- 根据学生 id 查询学生信息
- @param id
- @return
*/
Student queryStudentById(Integer id);
}
3. 在 service.impl 包下创建 service 接口并编写代码
package com.md.springboot.service.impl;
import com.md.springboot.mapper.StudentMapper;
import com.md.springboot.model.Student;
import com.md.springboot.service.StudentService;
/**
-
@author MD
-
@create 2020-08-21 9:43
*/
@Service
public class StudentServiceImpl implements StudentService {
@Autowired
private StudentMapper studentMapper;
@Override
public Student queryStudentById(Integer id) {
return studentMapper.selectByPrimaryKey(id);
}
}
4. 在 web 包下创建 StudentController 并编写代码
package com.md.springboot.web;
import com.md.springboot.model.Student;
import com.md.springboot.service.StudentService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
/**
-
@author MD
-
@create 2020-08-21 9:40
*/
@Controller
public class StudentController {
@Autowired
private StudentService studentService;
@RequestMapping(value = "/student")
@ResponseBody
public Object student(){
Student student = studentService.queryStudentById(3);
<span class="hljs-keyword">return</span> student;
}
}
5. 在 Mybatis 反向工程生成的 StudentMapper 接口上加一个 Mapper 注解
@Mapper 作用:mybatis 自动扫描数据持久层的映射文件及 DAO 接口的关系
// 扫描 dao 接口到 spring 容器
@Mapper
public interface StudentMapper {
int deleteByPrimaryKey(Integer id);
<span class="hljs-type">int</span> <span class="hljs-title function_">insert</span><span class="hljs-params">(Student record)</span>;
<span class="hljs-type">int</span> <span class="hljs-title function_">insertSelective</span><span class="hljs-params">(Student record)</span>;
Student <span class="hljs-title function_">selectByPrimaryKey</span><span class="hljs-params">(Integer id)</span>;
<span class="hljs-type">int</span> <span class="hljs-title function_">updateByPrimaryKeySelective</span><span class="hljs-params">(Student record)</span>;
<span class="hljs-type">int</span> <span class="hljs-title function_">updateByPrimaryKey</span><span class="hljs-params">(Student record)</span>;
}
6. 注意:默认情况下,Mybatis 的 xml 映射文件不会编译到 target 的 class 目录下,所
以我们需要在 pom.xml 文件中配置 resource
<!--Mybatis 的 xml 映射文件编译到 target 的 class 目录下 -->
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
</resource>
</resources>
5. 启动
二、DAO 其它开发方式
1. 在运行的主类上添加注解包扫描
@MapperScan("com.md.springboot.mapper")
此时就可以注释掉 StudentMapper 接口上的 @Mapper 注解
//@Mapper
public interface StudentMapper {
在运行主类 Application 上加 @MapperScan("com.md.springboot.mapper")
@SpringBootApplication
//Mybatis 提供的注解:扫描数据持久层的 mapper 映谢配置文件,DAO 接口上就不用加 @Mapper
@MapperScan("com.md.springboot.mapper")
public class Application {
2. 将接口和映射文件分开
因为 SpringBoot 不能自动编译接口映射的 xml 文件,还需要手动在 pom 文件中指定,
还可以直接将映射文件直接放到 resources 目录下,这样就不用手动在 pom 文件中指定了
在 resources 目录下新建目录 mapper 存放映射文件,将 StudentMapper.xml 文件移到 resources/mapper 目录下
在 application.properties 配置文件中指定映射文件的位置,这个配置只有接口和映射文件不在同一个包的情况下,才需要指定
# 指定 Mybatis 映射文件的路径
mybatis.mapper-locations=classpath:mapper/*.xml
三、Spring Boot 事务支持
Spring Boot 使用事务非常简单,底层依然采用的是 Spring 本身提供的事务管理
- 在入口类中使用注解 @EnableTransactionManagement 开启事务支持
- 在访问数据库的 Service 方法上添加注解 @Transactional 即可
1. 在 StudentService 接口中添加更新学生方法
/**
* 根据学生的 id 更新学生信息
* @param student
* @return
*/
int modifyStudentById(Student student);
2. 在 StudentServiceImpl 接口实现类
对更新学生方法进行实现,并构建一个异常,同时在该方法上加 @Transactional 注解
@Override
@Transactional // 添加这个注解说明该方法添加了事务管理
public int modifyStudentById(Student student) {
<span class="hljs-type">int</span> <span class="hljs-variable">updateCount</span> <span class="hljs-operator">=</span> studentMapper.updateByPrimaryKeySelective(student);
System.out.println(<span class="hljs-string">"更新结果:"</span>+updateCount);
// 用于测试事务是否有效
int a = 10 / 0;
<span class="hljs-keyword">return</span> updateCount;
}
3. 在 StudentController 中添加更新学生的方法
@RequestMapping(value = "/modify")
@ResponseBody
public Object modifyStudent(){
int count = 0;
<span class="hljs-keyword">try</span> {
<span class="hljs-type">Student</span> <span class="hljs-variable">student</span> <span class="hljs-operator">=</span> <span class="hljs-keyword">new</span> <span class="hljs-title class_">Student</span>();
student.setId(<span class="hljs-number">1</span>);
student.setName(<span class="hljs-string">"tim"</span>);
student.setAge(<span class="hljs-number">30</span>);
count = studentService.modifyStudentById(student);
} <span class="hljs-keyword">catch</span> (Exception e) {
e.printStackTrace();
<span class="hljs-keyword">return</span> <span class="hljs-string">"fail"</span>;
}
<span class="hljs-keyword">return</span> count;
}
4. 在 Application 类
@EnableTransactionManagement 可选,但是 业务方法上 必须添加 @Transactional 事务才生效
@SpringBootApplication
@MapperScan("com.md.springboot.mapper")
@EnableTransactionManagement // 开启事务支持 (可选项,但 @Transactional 必须添加)
public class Application {
5. 启动
此时就生效了,数据库没有任何改变
6. 去掉注解
注释掉 StudentServiceImpl 上的 @Transactional 测试
数据库的数据被更新
四、SpringBoot 工程下使用 Mybatis 反向工程
1. 拷贝 Mybatis 反向工程配置文件到项目的根目录下
2. 根据项目及表的情况,修改 GeneratorMapper.xml 配置
- 如果使用 高版本 , 驱动类变为:com.mysql.cj.jdbc.Driver
- url 后面应该加属性 nullCatalogMeansCurrent=true ,否则生成有问题
当前版本 MySQL 数据库为 5.7
主要根据注释来修改自己的内容
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration
<span class="hljs-keyword">PUBLIC</span> <span class="hljs-string">"-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"</span>
<span class="hljs-string">"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd"</span>></span>
<generatorConfiguration>
<!-- 指定连接数据库的 JDBC 驱动包所在位置,指定到你本机的完整路径 -->
<classPathEntry location="E:\Java\tool\maven_repository\mysql\mysql-connector-java\5.1.9\mysql-connector-java-5.1.9.jar"/>
<span class="hljs-comment"><!-- 配置 table 表信息内容体,targetRuntime 指定采用 MyBatis3 的版本 --></span>
<span class="hljs-tag"><<span class="hljs-name">context</span> <span class="hljs-attr">id</span>=<span class="hljs-string">"tables"</span> <span class="hljs-attr">targetRuntime</span>=<span class="hljs-string">"MyBatis3"</span>></span>
<span class="hljs-comment"><!-- 抑制生成注释,由于生成的注释都是英文的,可以不让它生成 --></span>
<span class="hljs-tag"><<span class="hljs-name">commentGenerator</span>></span>
<span class="hljs-tag"><<span class="hljs-name">property</span> <span class="hljs-attr">name</span>=<span class="hljs-string">"suppressAllComments"</span> <span class="hljs-attr">value</span>=<span class="hljs-string">"true"</span>/></span>
<span class="hljs-tag"></<span class="hljs-name">commentGenerator</span>></span>
<span class="hljs-comment"><!-- 配置数据库连接信息 --></span>
<span class="hljs-tag"><<span class="hljs-name">jdbcConnection</span> <span class="hljs-attr">driverClass</span>=<span class="hljs-string">"com.mysql.jdbc.Driver"</span>
<span class="hljs-attr">connectionURL</span>=<span class="hljs-string">"jdbc:mysql://localhost:3306/springboot"</span>
<span class="hljs-attr">userId</span>=<span class="hljs-string">"root"</span>
<span class="hljs-attr">password</span>=<span class="hljs-string">"123456"</span>></span>
<span class="hljs-tag"></<span class="hljs-name">jdbcConnection</span>></span>
<span class="hljs-comment"><!-- 生成 model 类,targetPackage 指定 model 类的包名, targetProject 指定
生成的 model 放在 IDEA 的哪个工程下面--></span>
<span class="hljs-tag"><<span class="hljs-name">javaModelGenerator</span> <span class="hljs-attr">targetPackage</span>=<span class="hljs-string">"com.md.springboot.model"</span>
<span class="hljs-attr">targetProject</span>=<span class="hljs-string">"src/main/java"</span>></span>
<span class="hljs-tag"><<span class="hljs-name">property</span> <span class="hljs-attr">name</span>=<span class="hljs-string">"enableSubPackages"</span> <span class="hljs-attr">value</span>=<span class="hljs-string">"false"</span>/></span>
<span class="hljs-tag"><<span class="hljs-name">property</span> <span class="hljs-attr">name</span>=<span class="hljs-string">"trimStrings"</span> <span class="hljs-attr">value</span>=<span class="hljs-string">"false"</span>/></span>
<span class="hljs-tag"></<span class="hljs-name">javaModelGenerator</span>></span>
<span class="hljs-comment"><!-- 生成 MyBatis 的 Mapper.xml 文件,targetPackage 指定 mapper.xml 文件的
包名, targetProject 指定生成的 mapper.xml 放在 IDEA 的哪个工程下面 --></span>
<span class="hljs-tag"><<span class="hljs-name">sqlMapGenerator</span> <span class="hljs-attr">targetPackage</span>=<span class="hljs-string">"com.md.springboot.mapper"</span>
<span class="hljs-attr">targetProject</span>=<span class="hljs-string">"src/main/java"</span>></span>
<span class="hljs-tag"><<span class="hljs-name">property</span> <span class="hljs-attr">name</span>=<span class="hljs-string">"enableSubPackages"</span> <span class="hljs-attr">value</span>=<span class="hljs-string">"false"</span>/></span>
<span class="hljs-tag"></<span class="hljs-name">sqlMapGenerator</span>></span>
<span class="hljs-comment"><!-- 生成 MyBatis 的 Mapper 接口类文件,targetPackage 指定 Mapper 接口类的包
名, targetProject 指定生成的 Mapper 接口放在 IDEA 的哪个工程下面 --></span>
<span class="hljs-tag"><<span class="hljs-name">javaClientGenerator</span> <span class="hljs-attr">type</span>=<span class="hljs-string">"XMLMAPPER"</span>
<span class="hljs-attr">targetPackage</span>=<span class="hljs-string">"com.md.springboot.mapper"</span> <span class="hljs-attr">targetProject</span>=<span class="hljs-string">"src/main/java"</span>></span>
<span class="hljs-tag"><<span class="hljs-name">property</span> <span class="hljs-attr">name</span>=<span class="hljs-string">"enableSubPackages"</span> <span class="hljs-attr">value</span>=<span class="hljs-string">"false"</span>/></span>
<span class="hljs-tag"></<span class="hljs-name">javaClientGenerator</span>></span>
<span class="hljs-comment"><!-- 数据库表名及对应的 Java 模型类名,有几个表写几个table --></span>
<span class="hljs-tag"><<span class="hljs-name">table</span> <span class="hljs-attr">tableName</span>=<span class="hljs-string">"t_student"</span> <span class="hljs-attr">domainObjectName</span>=<span class="hljs-string">"Student"</span>
<span class="hljs-attr">enableCountByExample</span>=<span class="hljs-string">"false"</span>
<span class="hljs-attr">enableUpdateByExample</span>=<span class="hljs-string">"false"</span>
<span class="hljs-attr">enableDeleteByExample</span>=<span class="hljs-string">"false"</span>
<span class="hljs-attr">enableSelectByExample</span>=<span class="hljs-string">"false"</span>
<span class="hljs-attr">selectByExampleQueryId</span>=<span class="hljs-string">"false"</span>/></span>
<span class="hljs-tag"></<span class="hljs-name">context</span>></span>
</generatorConfiguration>
此时会报错,如下
这个时候可以不用理会,项目也是会正常运行的,当然也可以这样
添加之后就不会报红了
3. 在 pom.xml 文件中添加 mysql 反向工程依赖
<build>
<plugins>
<!--mybatis 代码自动生成插件 -->
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.6</version>
<configuration>
<!-- 配置文件的位置 -->
<configurationFile>GeneratorMapper.xml</configurationFile>
<verbose>true</verbose>
<overwrite>true</overwrite>
</configuration>
</plugin>
</plugins>
<span class="hljs-tag"></<span class="hljs-name">build</span>></span>
4. 双击生成相关文件
5. 生成的文件
自动生成 model/Student、实体类
以及 StudentMapper,接口
StudentMapper.xml 具体对数据库的操作
这样方便我们使用,具体的下面详细介绍,注意看注释
Student
package com.md.springboot.model;
public class Student {
private Integer id;
<span class="hljs-keyword">private</span> String name;
<span class="hljs-keyword">private</span> Integer age;
<span class="hljs-keyword">public</span> Integer <span class="hljs-title function_">getId</span><span class="hljs-params">()</span> {
<span class="hljs-keyword">return</span> id;
}
<span class="hljs-keyword">public</span> <span class="hljs-keyword">void</span> <span class="hljs-title function_">setId</span><span class="hljs-params">(Integer id)</span> {
<span class="hljs-built_in">this</span>.id = id;
}
<span class="hljs-keyword">public</span> String <span class="hljs-title function_">getName</span><span class="hljs-params">()</span> {
<span class="hljs-keyword">return</span> name;
}
<span class="hljs-keyword">public</span> <span class="hljs-keyword">void</span> <span class="hljs-title function_">setName</span><span class="hljs-params">(String name)</span> {
<span class="hljs-built_in">this</span>.name = name;
}
<span class="hljs-keyword">public</span> Integer <span class="hljs-title function_">getAge</span><span class="hljs-params">()</span> {
<span class="hljs-keyword">return</span> age;
}
<span class="hljs-keyword">public</span> <span class="hljs-keyword">void</span> <span class="hljs-title function_">setAge</span><span class="hljs-params">(Integer age)</span> {
<span class="hljs-built_in">this</span>.age = age;
}
}
StudentMapper
package com.md.springboot.mapper;
import com.md.springboot.model.Student;
public interface StudentMapper {
int deleteByPrimaryKey(Integer id);
<span class="hljs-type">int</span> <span class="hljs-title function_">insert</span><span class="hljs-params">(Student record)</span>;
<span class="hljs-type">int</span> <span class="hljs-title function_">insertSelective</span><span class="hljs-params">(Student record)</span>;
Student <span class="hljs-title function_">selectByPrimaryKey</span><span class="hljs-params">(Integer id)</span>;
<span class="hljs-type">int</span> <span class="hljs-title function_">updateByPrimaryKeySelective</span><span class="hljs-params">(Student record)</span>;
<span class="hljs-type">int</span> <span class="hljs-title function_">updateByPrimaryKey</span><span class="hljs-params">(Student record)</span>;
}
StudentMapper.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.md.springboot.mapper.StudentMapper">
<!--
数据库字段名称 实体对象属性名称
user_name userName
user_age userAge
-->
<!--
如果数据表中的字段是多个单词构成的,通过 Mybatis 逆向工程生成的对象属性名称
会按照驼峰命名法的规则生成属性名称
自己设计数据表的时候,多个单词之前使用下划线分隔
-->
<!--
resultMap 的作用
1. 当数据库中的字段名称和实体类对象的属性名不一致,可以进行转换
2. 当前查询的结果对象没有对应一个表时,可以自定义一个结果集
-->
<resultMap id="BaseResultMap" type="com.md.springboot.model.Student">
<!--
id 标签只能修饰主键字段,result 标签修饰其他字段
column 数据库中的字段名称
property 映射对象的属性名称
jdbcType 对应的类型
-->
<id column="id" jdbcType="INTEGER" property="id" />
<result column="name" jdbcType="VARCHAR" property="name" />
<result column="age" jdbcType="INTEGER" property="age" />
</resultMap>
<!--sql 语句片段,将公共部分抽出 -->
<sql id="Base_Column_List">
id, name, age
</sql>
<select id="selectByPrimaryKey" parameterType="java.lang.Integer" resultMap="BaseResultMap">
select
<include refid="Base_Column_List" />
from t_student
where id = #{id,jdbcType=INTEGER}
</select>
<delete id="deleteByPrimaryKey" parameterType="java.lang.Integer">
delete from t_student
where id = #{id,jdbcType=INTEGER}
</delete>
<insert id="insert" parameterType="com.md.springboot.model.Student">
insert into t_student (id, name, age
)
values (#{id,jdbcType=INTEGER}, #{name,jdbcType=VARCHAR}, #{age,jdbcType=INTEGER}
)
</insert>
<!-- 动态 sql-->
<insert id="insertSelective" parameterType="com.md.springboot.model.Student">
insert into t_student
<trim prefix="(" suffix=")" suffixOverrides=",">
<if test="id != null">
id,
</if>
<if test="name != null">
name,
</if>
<if test="age != null">
age,
</if>
</trim>
<trim prefix="values (" suffix=")" suffixOverrides=",">
<if test="id != null">
#{id,jdbcType=INTEGER},
</if>
<if test="name != null">
#{name,jdbcType=VARCHAR},
</if>
<if test="age != null">
#{age,jdbcType=INTEGER},
</if>
</trim>
</insert>
<update id="updateByPrimaryKeySelective" parameterType="com.md.springboot.model.Student">
update t_student
<set>
<if test="name != null">
name = #{name,jdbcType=VARCHAR},
</if>
<if test="age != null">
age = #{age,jdbcType=INTEGER},
</if>
</set>
where id = #{id,jdbcType=INTEGER}
</update>
<update id="updateByPrimaryKey" parameterType="com.md.springboot.model.Student">
update t_student
set name = #{name,jdbcType=VARCHAR},
age = #{age,jdbcType=INTEGER}
where id = #{id,jdbcType=INTEGER}
</update>
</mapper>