Springboot 完整搭建快速入门，必看！

前言

手把手教你Springboot微服务项目搭建快速入门，通过本文学习Springboot的搭建快速入门，掌握微服务大致的配置服务，后续将会继续将核心组件引入到项目中，欢迎关注，点赞，转发。

Springboot项目搭建将会从以下几个方面进行项目搭建快速入门

一、项目创建

新建Maven项目

根据上面操作即可完成项目搭建

二、pom.xml依赖添加

接下来在pom.xml引入springboot相关依赖

引入Springboot相关依赖，完成对项目的依赖配置。

三、新建数据库表

首先建一张User数据库表

1. 这里用navicat数据库链接工具

2. 新建一个springboot数据库（可自行定义）

3. 创建建表语句：

四、新建App.java项目启动类

五、新建Controller

行App，在浏览器输入：localhost:8080/hello，发现“hello spring-boot”说明第一步部署成功。

六、集成MyBatis

1. 在pom.xml文件中引入mybatis 和 数据库（这里用mysql）的依赖

生成mapper

1. 在resources目录下，新建一个application.properties（这里用properties，有兴趣小伙伴可以使用yml文件，这里名字只用application.properties，不要用其他，否则识别不出），增加如下内容：

2. 创建好对应的model、dao、mapping文件夹，准备MyBatis的生成文件generatorConfig.xml

3. 在pom.xml文件里面引入generator的plugins

4. 运行generatorConfig.xml文件，生成对应的model、dao、mapping文件，运行方式如下：

（用这种方式是避免开发人员找不到运行的方式）

5. 运行后，可以得到下图结果

七、UserMapper.java文件中新增登陆方法：

1. 新增登陆方法

2. 对应UserMapping.xml文件

八、 新建service实现方法

1. IUserService.java 接口

2. UserServiceImpl.java实现类

3. UserController.java类中增加login和register方法

启动App.java，并运行：

在浏览器上输入：localhost:8080/register?username=deer&password=123，显示“注册成功”

在浏览器上输入：localhost:8080/login?username=deer&password=123，    显示“登陆成功”

以上就完成了后台的Controller、Service、Dao之间的交互

九、实现事务支持

修改IUserService接口，增加一个新增batchAdd方法，在UserServiceImpl增加相应实现类，在实现类中故意产生一个被0整除得异常

1. IUserService.java接口中增加batchAdd抽象方法

2. UserService.java类中实现batchAdd()方法

3. 重新运行App.java，在浏览器输入：

localhost:8080/batchAdd?username=enjoy&password=123

可以发现在浏览器上出现

然后检查数据库，发现表里面已经产生了一个错误的数据，产生了事务不一致问题。

4. 添加事务支持：

在batchAdd方法上增加@Transactional注解

重启服务后，在浏览器上输入：localhost:8080/batchAdd?username=enjoy&password=123

浏览器还会继续报错，但检查数据库，并没有新增数据，由此可知事务问题已经得到了解决

十、全局异常

通过上面步骤，虽然已经解决了事务问题，但界面上出现这500错误，这对用户来说还是不友好。

一般在企业里面对这些异常一般都会统一捕获，由一个专门的异常处理类来统一处理。

1. 异常捕获

新建全局异常处理类GlobalExceptionHandler.java类

重启服务后，在浏览器上输入会出现异常的服务

localhost:8080/batchAdd?username=enjoy&passwd=123

界面返回：

2. 404页面处理

在浏览器上故意输错地址

localhost:8080/batchAddx?username=enjoy&passwd=123，后端并没有这服务，虽然已经做了相关的异常捕获，但浏览器还是显示了：

这个时候返回页面非常的不友好，要做404异常处理（其他异常代码一样）。

在配置这样错误页面的时候，以前是在WEB.XML中进行配置，而在这里，需要有个WebServerFactoryCustomizer的实例进行配置

3. 在前面建立的GlobalExceptionHandler，新建一个方法

4. 新建BaseController.java类

重启服务，在浏览器上输入

localhost:8080/batchAddx?username=enjoy&passwd=123

此时，页面返回“404，没有找到页面！”

十一、静态资源访问

静态资源：js, css, html, 图片，音视频等

静态资源路径：是指系统可以直接访问的路径，且路径下的所有文件均可被用户直接读取。

Spring Boot默认提供静态资源目录位置需置于classpath下，目录名需符合如下规则：

/static

/public

/resources

/META-INF/resources

1. 在resources目录下面建立static文件夹，在文件夹里面任意放张图片。

在地址栏上输入localhost:8080/enjoy.jpg，可以看到图片

十二、前端页面

1. 引擎模板

SpringBoot 推荐使用模板引擎来渲染html，如果你不是历史遗留项目，一定不要使用JSP，常用的模板引擎很多，有freemark,thymeleaf等，其实都大同小异

其中springboot 强烈推荐的是用thymeleaf

pom文件种添加thymeleaf的支持：

2. 新建Controller

Springboot默认的模板配置路径为：src/main/resources/templates

在resources目录里面新建一个templates目录，在目录里面新建testThymeleaf.html文件

在浏览器上输入：localhost:8080/tpl/themeleaf，可以看到页面。

十三、集成Swagger2 构建API文档

1. Swagger2 的作用

①. 随项目自动生成强大RESTful API文档，减少工作量

②. API文档与代码整合在一起，便于同步更新API说明

③. 页面测试功能来调试每个RESTful API

修改pom文件，添加swagger2的相关依赖

2. 新建一个swagger的配置类SwaggerConfig.java

3. 新建Controller用于显示相关接口

访问：http://localhost:8080/swagger-ui.html

如何使用呢？

以上就是swagger2的配置和使用。

十四、日志集成

在springboot中默认使用的日志工具是logback,不过在提及具体的日志工具之前要提一个名词，这个名词就是slf4j(Simple Logging Facade For Java)

百度百科解释

https://baike.baidu.com/item/slf4j/6408868

slf4j不是具体的日志解决方案，它有点类似于jdbc,使用了门面模式，是一个针对各类日志的抽象实现，既然是抽象的日志实现，在springboot中肯定不需要额外导入。

注意：spring-boot-starter中就提供了对spring-boot-starter-logging的依赖

在spring-boot-starter-logging中可以看到以及集成了slf4j与具体实现logback的默认支持

1. 修改UserController

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

private final Logger logger = LoggerFactory.getLogger(UserController.class);

在浏览器上输入：localhost:8080/hello，可以看控制台日志的输出

2. 日志级别

修改controller 把日志的输出改成

logger.debug("这个一个hello日志");

这个时候重启，再调用，发现后台并不会有任何输出，这原因是日志级别在作祟

默认情况下，Spring Boot 配置的是INFO 日志级别，也就是会输出INFO级别以上的日志(ERROR, WARN, INFO)。

如果需要 Debug 级别的日志。在 src/main/resources/application.properties 中配置。

debug=true

此外，配置 logging.level.* 来具体输出哪些包的日志级别。

例如

logging.level.root=INFO

logging.level.org.springframework.web=DEBUG

logging.level.cn.cansluck.controller=DEBUG

这个时候，包括springframework.web以及cn.cansluck.controller的debug日志都可以输出来了

3. 日志文件

一般情况下，springboot日志只会输出到控制台，并不会写入到日志文件，但是，在一些正式环境的应用中，我们需要通过在 application.properites 文件中配置 logging.file 文件名称和 logging.path 文件路径，将日志输出到日志文件中。

logging.path = /var/tmp

logging.file = xxx.log

logging.level.root = info

注意：

如果只配置 logging.path，在 /var/tmp文件夹生成一个日志文件为 spring.log。如果只配置 logging.file，会在项目的当前路径下生成一个 xxx.log 日志文件。

这里有一个坑，logging.path 和logging.file都配置了，只会有logging.file生效，所以，如果要指定日志生成的具体位置使用logging.file 配置就好

在application.properties中配置

logging.file =D:\\log\\enjoy.log

这样在F盘的相应位置出现日志文件

3. log4j2

在spring-boot-dependencies POMs中搜索spring-boot-starter-log4j2

发现Spring boot父Pom中自己提供了这个依赖，于是我们加入如下jar依赖：

修改pom.xml文件

注意: 由于默认使用logback在扩展log4j2之前先要把logback移除

日志使用跟上面logback一样。

十五、使用AOP统一日志处理

为了防止在工作中经常在代码中加入大量的日志处理代码，在实际项目开发中，一般使用AOP统一完成日志处理工作

1. 修改pom文件，引入springboot对aop的支持

2. 新增AOP日志处理类

通过访问Controller可以从日志看到，AOP切面方法已经生效

总结
    本文通过图文形式，学习Springboot快速入门，包括项目创建、Springmvc集成、MyBatis集成配置、事务集成配置、全局异常配置、Swagger2集成配置、AOP统一日志处理，将整个流程大概介绍了一遍，让想了解和学习Springboot的小伙伴能够对整体流程有个大概了解，也希望能够利用自己空闲时间按照上面流程完整操作一遍，可以加深自己的理解和印象。如有疑问欢迎评论留言，小编会及时回复哦~喜欢的小伙伴动动手指点个赞、收藏吧！

更多精彩敬请关注公众号

Java极客思维

微信扫一扫，关注公众号​