SpringBoot统一功能处理(统一处理用户登陆权限验证、统一异常处理以及统一数据返回格式)

news/2024/11/14 16:24:38/

目录

1. SpringBoot统一功能处理简介

2. 统一处理用户登陆验证

2.1 原生SpringAOP实现统一登陆验证的问题

2.2 Spring拦截器实现用户统一登陆验证

2.3 扩展: 统一访问前缀添加

3. 统一异常处理 

4. 统一数据返回格式

4.1 统一数据返回格式的必要性

4.2 实现统一数据返回格式的功能

5. 总结


1.SpringBoot统一功能处理简介

我们在上篇博客中学习了AOP思想以及SpringAOP实现,但是在实际的业务开发中,使用原生的SpringAOP开发是很难满足我们真正的的业务需求的。我们在这里总结的SpringBoot统一功能处理就是对原生的SpringAOP操作的一种增强集合,为什么这么说呢,一起来向下看吧!

2.统一处理用户登陆验证

2.1 原生SpringAOP实现统一登陆验证的问题

在学习了SpringAOP的原生操作后,我就立即着手想着去写一个统一处理用户登陆权限验证的功能。可能大多数小伙伴的想法和我一致,直接使用SpringAOP的前置通知方法或者环绕通知方法来实现不就行了吗?但是在真正使用原生SpringAOP对该功能进行实现时,我遇到了以下几个问题:

  1. 首先是要验证用户的登陆状态,就要先获取到内存中的session对象,但是通过前置或者环绕通知的方式时很难拿到请求对象的,也就很难拿到session对象进行判断。
  2. 其次是与我们用户相关的控制器中并非所有方法都要进行拦截判断(像登录、注册方法),那这样就大大增加了通过原生SpringAOP的切点表达式配置拦截规则的难度

那该怎么解决上述的问题呢?——更好的解决办法就是使用Spring拦截器~

2.2 Spring拦截器实现用户统一登陆验证

使用Spring拦截器实现用户统一验证登录的步骤整体上分为以下几步:

  1. 创建一个自定义类实现HandlerInterceptor接口,并重写preHandler方法,在该方法中编写进行统一用户登陆验证的逻辑代码。
  2. 将1中创建的拦截器加入到系统配置中,并配置拦截器的拦截规则。本步骤其实就是通过创建一个自定义类实现WebMvcConfigurable接口,并标注@Configuration注解将该类交由Spring进行管理,同时重写接口的addInterceptors方法,在该方法中将创建的HandlerInterceptor接口子类传入,并配置拦截规则。

接下来我们在程序中实际定义一个用户登陆权限校验的拦截器来学习以下上边拦截器的具体实现过程及定义的相关注意事项:

0.准备工作。

1.首先创建自定义类LoginInterceptor拦截器类实现HandlerInterceptor接口,并重写preHandler方法,在其中编写我们进行用户统一登录的验证逻辑。


 2.创建自定义系统配置类实现WebMvcConfigurable接口,并重写addInterceptors方法,加上@Configuration将我们创建的拦截器类的实例对象加入到系统配置中并指定该拦截器的拦截规则。


3.到这里,我们自定义的拦截器就完成配置啦!接下来,我们启动程序来进行测试。

2.3 扩展: 统一访问前缀添加

在实际的业务场景中,一台服务器上时可能会有多个服务的。而这些服务通常也是通过同一端口来与外界进行通信的。那么,它们是怎么实现同一端口通信的呢?这个时候就需要用到统一前缀添加了。给同一台服务器上的不同服务加上不同的统一前缀,这样就能够让网关系统识别并匹配到对应的服务。那该怎么实现统一前缀添加呢?实现方式有以下两种:

  1. 在系统配置中配置
    在实现了WebMcvConfigurer的类中覆写接口中的configurePathMatch方法并指定统一前缀。

  2. 在SpringBoot的application配置文件中配置
# 在配置文件中配置,在所有的路由最前统一加上前缀/bai
server:servlet:context-path: /bai

通过了以上配置,我们再来请求原来的路由对应的接口,会发现页面信息不存在。这个时候就需要加上程序中添加的统一前缀了。之后服务器的网关才能够通过识别这个统一前缀将你的请求转发到指定的服务进行处理返回。

3. 统一异常处理 

为什么要进行统一异常处理呢?


这是因为如果我们不进行统一的异常处理,那么当后端程序抛出异常后程序不再往下运行,前端会在控制台报错,而用户发送请求后由于后端程序没有响应也就导致页面无响应,大大降低了客户的体验感。我们来模拟一下后端程序抛出异常时的场景:

接下来我们就来实现一下程序的统一异常处理功能,对比下统一异常处理后我们的后端程序的有哪些优点。


实现统一异常处理的步骤如下:

  1. 创建一个统一异常处理类,标注上@ControllerAdvice注解表示这是一个统一异常处理类,@ControllerAdvice注解中包含@Component注解,所以该类也会加入到Spring中随着框架的加载而加载。
  2. 再类中定义异常处理方法,标注上@ExceptionHandler异常管理器注解订阅异常,并在方法中将异常处理后的结果返回给前端。

接下来我们一起来实现以下统一异常处理的功能,学习一下实现的细节和注意事项:


通过上述的实现过程,我们可以总结出统一异常处理功能实现时要注意:

  1. 当有多个异常处理的通知方法时,程序抛出的异常对象是按照由子类到父类的顺序进行匹配的。
  2.  实现统一异常处理使用到注解@ControllerAdvice、@ResponseBody(选用,看你返回的是页面还是数据)以及@ExceptionHandler。

4. 统一数据返回格式

4.1 统一数据返回格式的必要性

要知道,实际的开发场景中,一个项目不可能是由我们一人独自完成的。如果这时候每个后端开发程序员返回给前端的数据以及数据格式各式各样,那前端程序员大概率要懵逼:“这个接口返回的数据是什么来着?这个接口返回的数据格式是什么来着?...晕😵”!当统一了数据的返回格式后,优点是十分显著的,例如:

  1. 方便了前端程序员更好的接收和解析不同后端接口返回的数据。能够有效地降低沟通带来的时间损耗,同东我们项目组的进展。
  2. 统一的数据格式有利于数据维护和修改的调试。

4.2 实现统一数据返回格式的功能

实现步骤可以分为以下两步:

  1. 自定义统一数据返回处理类,标注上@ControllerAdvice注解同时实现ResponseBodyAdvice接口。
  2. 实现接口中的supports方法和beforeBodyWrite方法并在该方法中进行统一数据格式的处理。

我们来实现通统一数据返回格式的功能,学习下其中的细节和注意事项:


通过上述的实现过程,我们可以总结出同意数据返回功能实现时要注意:

  1. 当Controllerapi返回的时String格式时,会发生类转换异常。原因及解决办法在上述图片中已经详细总结出来了。

5.总结

  1. 统一用户登陆权限校验
    创建自定义拦截器实现HandlerInterceptor接口并重写preHandler方法;创建自定义系统配置类实现WebMvcConfigurer接口,并标注@Configuration注解交由Spring进行管理,接着重写addInterceptors方法将自定义拦截器加入到系统配置中并配置拦截规则。
  2. 统一异常处理
    自定义统一异常处理类,并标注@ControllerAdvice注解。编写异常捕获处理方法,标注上@ExceptionHandler注解并指明要捕获的异常类型,在方法中编写统一异常处理逻辑代码。
  3. 统一数据返回格式
    自定义统一格式处理类实现ResponseBodyAdvice接口,标注上@ControllerAdvice注解,并重写接口中的supportsbeforeBodyWrite方法(注意返回类型是String的情况)。

http://www.ppmy.cn/news/110208.html

相关文章

「SQL面试题库」 No_83 每个帖子的评论数

🍅 1、专栏介绍 「SQL面试题库」是由 不是西红柿 发起,全员免费参与的SQL学习活动。我每天发布1道SQL面试真题,从简单到困难,涵盖所有SQL知识点,我敢保证只要做完这100道题,不仅能轻松搞定面试&#xff0…

第二章 部署DNS服务

♥️作者介绍:奇妙的大歪 ♥️个人名言:但行前路,不负韶华! ♥️个人简介:云计算网络运维专业人员 目录 一.DNS是什么? 1.DNS的工作原理 二.DNS内容 1.本章单词 2.域名空间结构: 3.顶级域…

jenkins —— pipeline基础语法与示例

一、Jenkins介绍 二、Jenkins Pipeline介绍 Jenkins Pipeline总体介绍 1.Pipeline 是Jenkins 2.X核心特性,帮助Jenkins实现从CI到CD与DevOps的转变 2.Pipeline 简而言之,就是一套运行于Jenkins上的工作流框架,将原本独立 运行于单个或者多个…

3-网络初识——协议

目录 1.概念 ①语法:即数据与控制信息的结构或格式。 ②语义:即需要发出何种控制信息,完成何种动作以及做出何种响应。 ③时序:即事件实现顺序的详细说明。 2.作用 3.知名协议的默认端口 4.协议分层 4.1.什么是协议分层 …

Jetpack Hilt 框架的基本使用

什么是 Hilt? Hilt 是一个功能强大、用法简单的依赖注入框架,于 2020 年加入到 Jetpack 家族中。它是 Android 团队联系了 Dagger2 团队,一起开发出来的一个专门面向 Android 的依赖注入框架。相比于 Dagger2,Hilt 最明显的特征就…

RabbittMQ快速实战和集群架构

介绍对比: Kafka:topic不能太多,一个缺点,影响Kafka的吞吐量 集群搭建:【单个也是一个集群(特殊)】 集群搭建:https://blog.csdn.net/p393975269/article/details/129830252 1:默认…

电源工程师必备技能汇总

一、掌握常用拓扑结构 1.反激 2.全桥/半桥 3.倍流 4.PFC电路 5.Flyback 6.LLC 7.Buck 8.维也纳整流 9.光伏逆变器 10.并网逆变器 11.两电平整流器 12.三电平整流器 二、掌握三款电力仿真软件--对于上述拓扑结构的仿真控制 1.PSIM 2.MATLAB 3.Plecs 三、熟练运用…

20230529_Hadoop_集群操作命令

HDFS_集群操作命令: 一、集群启停命令 # 启动Hadoop的HDFS进程start-dfs.sh# 关闭Hadoop的HDFS进程stop-dfs.sh# 单独关闭某一个进程hadoop-daemon.sh start[/stop] namenode[/datanode/secondarynamenode]二、HDFS文件系统的基本信息 数据的路径表达方式&#xff…