SpringBoot整合Mybatis完整详细版

记得刚接触SpringBoot时，大吃一惊，世界上居然还有这么省事的框架，立马感叹：SpringBoot是世界上最好的框架。哈哈！

当初跟着教程练习搭建了一个框架，传送门：spring boot + jpa + bootstrap + thymeleaf 简单的增删改查Demo

后来进了新公司，用不到而且忙于任务，今天重温一遍居然有些忘了，看来真是好记性不如烂笔头。于是写下本篇SpringBoot整合Mybatis的文章，做个笔记。

本章节主要搭建框架，下章节实现登录注册以及拦截器的配置：SpringBoot整合Mybatis完整详细版二：注册、登录、拦截器配置

本章项目源码下载：springBoot整合mybatis完整详细版

github地址：https://github.com/wjup/springBoot_Mybatis

练习完此篇，可下载一小时快速撸出一个短网址生成项目源码来看（欢迎star），也是非常适合入门练手的。

天也不早了，言归正传，开始

---

IDE：idea、DB：mysql

• 新建一个Spring Initializr项目

• 创建项目的文件结构以及jdk的版本 

• 选择项目所需要的依赖

• 修改项目名，finish完成

• 来看下建好后的pom

1. <?xml version="1.0" encoding="UTF-8"?>

2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

4. <modelVersion>4.0.0</modelVersion>

5.  

6. <groupId>com.example</groupId>

7. <artifactId>demo</artifactId>

8. <version>0.0.1-SNAPSHOT</version>

9. <packaging>jar</packaging>

10.  

11. <name>demo</name>

12. <description>Demo project for Spring Boot</description>

13.  

14. <parent>

15. <groupId>org.springframework.boot</groupId>

16. <artifactId>spring-boot-starter-parent</artifactId>

17. <version>2.0.5.RELEASE</version>

18. <relativePath/> <!-- lookup parent from repository -->

19. </parent>

20.  

21. <properties>

22. <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

23. <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>

24. <java.version>1.8</java.version>

25. </properties>

26.  

27. <dependencies>

28. <dependency>

29. <groupId>org.springframework.boot</groupId>

30. <artifactId>spring-boot-starter-jdbc</artifactId>

31. </dependency>

32. <dependency>

33. <groupId>org.springframework.boot</groupId>

34. <artifactId>spring-boot-starter-web</artifactId>

35. </dependency>

36. <dependency>

37. <groupId>org.mybatis.spring.boot</groupId>

38. <artifactId>mybatis-spring-boot-starter</artifactId>

39. <version>1.3.2</version>

40. </dependency>

41.  

42. <dependency>

43. <groupId>mysql</groupId>

44. <artifactId>mysql-connector-java</artifactId>

45. <scope>runtime</scope>

46. </dependency>

47. <dependency>

48. <groupId>org.springframework.boot</groupId>

49. <artifactId>spring-boot-starter-test</artifactId>

50. <scope>test</scope>

51. </dependency>

52. </dependencies>

53.  

54. <build>

55. <plugins>

56. <plugin>

57. <groupId>org.springframework.boot</groupId>

58. <artifactId>spring-boot-maven-plugin</artifactId>

59. </plugin>

60. </plugins>

61. </build>

62.  
63.  

64. </project>

• 修改配置文件

本文不使用application.properties文件 而使用更加简洁的application.yml文件。将resource文件夹下原有的application.properties文件删除，创建application.yml配置文件（备注：其实SpringBoot底层会把application.yml文件解析为application.properties），本文创建了两个yml文件（application.yml和application-dev.yml），分别来看一下内容

application.yml

1. spring:

2. profiles:

3. active: dev

application-dev.yml

1. server:

2. port: 8080

3.  

4. spring:

5. datasource:

6. username: root

7. password: 1234

8. url: jdbc:mysql://localhost:3306/springboot?useUnicode=true&characterEncoding=utf-8&useSSL=true&serverTimezone=UTC

9. driver-class-name: com.mysql.jdbc.Driver

10.  

11. mybatis:

12. mapper-locations: classpath:mapping/*Mapper.xml

13. type-aliases-package: com.example.entity

14.  

15. #showSql

16. logging:

17. level:

18. com:

19. example:

20. mapper : debug

两个文件的意思是：

在项目中配置多套环境的配置方法。
因为现在一个项目有好多环境，开发环境，测试环境，准生产环境，生产环境，每个环境的参数不同，所以我们就可以把每个环境的参数配置到yml文件中，这样在想用哪个环境的时候只需要在主配置文件中将用的配置文件写上就行如application.yml

笔记：在Spring Boot中多环境配置文件名需要满足application-{profile}.yml的格式，其中{profile}对应你的环境标识，比如：

application-dev.yml：开发环境
application-test.yml：测试环境
application-prod.yml：生产环境
至于哪个具体的配置文件会被加载，需要在application.yml文件中通过spring.profiles.active属性来设置，其值对应{profile}值。

还有配置文件中最好不要有中文注释，会报错。

解决方法（未测试）：spring boot application.yml文件中文注释乱码

接下来把启动文件移到com.example下，而且springboot的启动类不能放在java目录下！！！必须要个包将它包进去

否则会报错误：

Your ApplicationContext is unlikely to start due to a @ComponentScan of the default package.

这个原因值得注意就是因为有时候很难在IDEA中的项目目录认出来这个错误并且还容易扫描不到一些类，传送门：SpringBoot扫描不到controller

                         

• 然后开始创建实体类实现业务流程

创建包controller、entity、mapper、service。resources下创建mapping文件夹，用于写sql语句，也可以用注解的方式直接写在mapper文件里。下面直接贴代码

数据库表结构（之前小项目的表，直接拿来用）

1. CREATE TABLE `user` (

2. `id` int(32) NOT NULL AUTO_INCREMENT,

3. `userName` varchar(32) NOT NULL,

4. `passWord` varchar(50) NOT NULL,

5. `realName` varchar(32) DEFAULT NULL,

6. PRIMARY KEY (`id`)

7. ) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;

entity.java

1. package com.example.entity;

2.  

3. /**

4. * @Author:wjup

5. * @Date: 2018/9/26 0026

6. * @Time: 14:39

7. */

8. public class User {

9. private Integer id;

10. private String userName;

11. private String passWord;

12. private String realName;

13.  

14. public Integer getId() {

15. return id;

16. }

17.  

18. public void setId(Integer id) {

19. this.id = id;

20. }

21.  

22. public String getUserName() {

23. return userName;

24. }

25.  

26. public void setUserName(String userName) {

27. this.userName = userName;

28. }

29.  

30. public String getPassWord() {

31. return passWord;

32. }

33.  

34. public void setPassWord(String passWord) {

35. this.passWord = passWord;

36. }

37.  

38. public String getRealName() {

39. return realName;

40. }

41.  

42. public void setRealName(String realName) {

43. this.realName = realName;

44. }

45.  

46. @Override

47. public String toString() {

48. return "User{" +

49. "id=" + id +

50. ", userName='" + userName + '\'' +

51. ", passWord='" + passWord + '\'' +

52. ", realName='" + realName + '\'' +

53. '}';

54. }

55. }

UserController.java

1. package com.example.controller;

2.  

3. import com.example.entity.User;

4. import com.example.service.UserService;

5. import org.springframework.beans.factory.annotation.Autowired;

6. import org.springframework.boot.autoconfigure.EnableAutoConfiguration;

7. import org.springframework.web.bind.annotation.PathVariable;

8. import org.springframework.web.bind.annotation.RequestMapping;

9. import org.springframework.web.bind.annotation.RestController;

10.  

11. /**

12. * @Author:wjup

13. * @Date: 2018/9/26 0026

14. * @Time: 14:42

15. */

16.  

17. @RestController

18. @RequestMapping("/testBoot")

19. public class UserController {

20.  

21. @Autowired

22. private UserService userService;

23.  

24. @RequestMapping("getUser/{id}")

25. public String GetUser(@PathVariable int id){

26. return userService.Sel(id).toString();

27. }

28. }

UserService.java

1. package com.example.service;

2.  

3. import com.example.entity.User;

4. import com.example.mapper.UserMapper;

5. import org.springframework.beans.factory.annotation.Autowired;

6. import org.springframework.stereotype.Service;

7.  

8. /**

9. * @Author:wjup

10. * @Date: 2018/9/26 0026

11. * @Time: 15:23

12. */

13. @Service

14. public class UserService {

15. @Autowired

16. UserMapper userMapper;

17. public User Sel(int id){

18. return userMapper.Sel(id);

19. }

20. }

UserMapper.java

1. package com.example.mapper;

2.  

3. import com.example.entity.User;

4. import org.apache.ibatis.annotations.Select;

5. import org.springframework.stereotype.Repository;

6.  

7. /**

8. * @Author:wjup

9. * @Date: 2018/9/26 0026

10. * @Time: 15:20

11. */

12. @Repository

13. public interface UserMapper {

14.  

15. User Sel(int id);

16. }

UserMapping.xml

1. <?xml version="1.0" encoding="UTF-8"?>

2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

3. <mapper namespace="com.example.mapper.UserMapper">

4.  

5. <resultMap id="BaseResultMap" type="com.example.entity.User">

6. <result column="id" jdbcType="INTEGER" property="id" />

7. <result column="userName" jdbcType="VARCHAR" property="userName" />

8. <result column="passWord" jdbcType="VARCHAR" property="passWord" />

9. <result column="realName" jdbcType="VARCHAR" property="realName" />

10. </resultMap>

11.  

12. <select id="Sel" resultType="com.example.entity.User">

13. select * from user where id = #{id}

14. </select>

15.  

16. </mapper>

• 最终框架结构

• 完成以上，下面在启动类里加上注解用于给出需要扫描的mapper文件路径@MapperScan("com.example.mapper") 

1. package com.example;

2.  

3. import org.mybatis.spring.annotation.MapperScan;

4. import org.springframework.boot.SpringApplication;

5. import org.springframework.boot.autoconfigure.SpringBootApplication;

6.  

7. @MapperScan("com.example.mapper") //扫描的mapper

8. @SpringBootApplication

9. public class DemoApplication {

10.  

11. public static void main(String[] args) {

12. SpringApplication.run(DemoApplication.class, args);

13. }

14. }

• 最后启动，浏览器输入地址看看吧：http://localhost:8080/testBoot/getUser/1

测试成功，就这样基本框架就搭建成功了

• 最后给个番外篇如何更改启动时显示的字符拼成的字母，就是更改下图标红框的地方

其实很好改，只需要在resources下新建一个txt文件就可以，命名为banner.txt，那这种字符该怎么拼出来呢，下面推荐一个网址，有这种工具，链接传送门：字母转字符。如下：

直接输入要生成的字母，系统会自动转换，然后复制下面转换好的字符到新建的banner.txt文件中，重新启动项目就可以了。