Java极客思维

  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

 

前言

手把手教你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极客思维

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

posted on 2020-11-21 23:34  Java极客思维  阅读(1655)  评论(8编辑  收藏  举报