【SpringBoot】Spring 一站式解决方案：融合统一返回结果、异常处理与适配器模式

前言

???本期讲解关于统一功能处理的详细介绍~~~

??感兴趣的小伙伴看一看小编主页：-CSDN博客

?? 你的点赞就是小编不断更新的最大动力

??那么废话不多说直接开整吧~~

目录

???1.适配器模式?

??1.1适配器模式定义

?编辑

??1.2适配器模式角色

??1.3适配器模式实现

???2.统一数据返回格式

??2.1快速入门

??2.2存在问题

1.作用路径

2.异常情况

??2.3统一返回格式优点

???3.统一异常处理

??3.1快速入门

??3.2多种异常

??3.3统一异常处理优点

???4.总结

**??**1.适配器模式

??1.1适配器模式定义

适配器模式, 也叫包装器模式. 将个类的接，转换成客期望的另个接, 适配器让原本接不兼容的类可以合作间.

简单来说就是标类不能直接使, 通过个新类进包装下, 适配调使. 把两个不兼容的接通过定的式使之兼容.

如下两个接, 本是不兼容的(参数类型不样, 参数个数不样等等)

但是此时我们可以通过适配器进行两者的兼容，具体的图示如下所示：

??1.2适配器模式角色

Target: 标接 (可以是抽象类或接), 客希望直接的接

Adaptee: 适配者, 但是与Target不兼容

Adapter: 适配器类, 此模式的核. 通过继承或者引适配者的对象, 把适配者转为标接

client: 需要使适配器的对象

大致就是：两个不相容的接口，通过适配器进行了连接，使得使用适配器的对象能够操作目标接口；

??1.3适配器模式实现

slf4j 就使了适配器模式，slf4j底层调用了这里的log4j，我们作为调用者，只需要调用slf4j的api就可以了

具体的代码如下所示：

第一步：创建slf4j的api接口

interface Slf4jApi{void log(String message);
}

第二步：创建一个log4j，实现打印的功能

class Log4j{void log4jLog(String message){System.out.println("Log4j打印:"+message);}
}

此时可以看到，这两个类并没有关联，那么此时我们就要进行两个接口的连接了

第三步：创建适配器，进行两个接口的连接

class Slf4jLog4JAdapter implements Slf4jApi{private Log4j log4j;public Slf4jLog4JAdapter(Log4j log4j) {this.log4j = log4j;}@Overridepublic void log(String message) {log4j.log4jLog(message);}
}

此时就是进行方法的重写，这里重写的方法调用我们目标打印的类里的方法，此时就将两个不相关的接口进行连接；

第四步：调用api实现打印

public class Slf4jDemo {public static void main(String[] args) {Slf4jApi slf4jApi = new Slf4jLog4JAdapter(new Log4j());slf4jApi.log("使?slf4j打印?志");}
}

所以可以发现，作为调用者，真正使用的就是适配器帮我们进行操作，不需要改变log4j的api,只需要通过适配器转换下, 就可以更换志框架, 保障系统的平稳运

适配器使用场景：

般来说，适配器模式可以看作种"补偿模式"，来补救设计上的缺陷. 应这种模式算是"奈之举", 如果在设计初期，我们就能协调规避接不兼容的问题, 就不需要使适配器模式了

**??**2.统一数据返回格式

??2.1快速入门

统的数据返回格式使 @ControllerAdvice 和 ResponseBodyAdvice 的式实现
@ControllerAdvice 表控制器通知类
添加类 ResponseAdvice , 实现 ResponseBodyAdvice 接, 并在类上添加
@ControllerAdvice 注解

代码如下所示：

@ControllerAdvice
public class ResponseAdvice implements ResponseBodyAdvice {   @Overridepublic boolean supports(MethodParameter returnType, Class converterType) {return true;}@Overridepublic Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) {return null}
}

解释：

supports法: 判断是否要执beforeBodyWrite法. true为执, false不执. 通过该法可以
选择哪些类或哪些法的response要进处理, 其他的不进处理

下面的方法就是表示同意返回的格式是什么，默认重写的就是null；

??2.2存在问题

1.作用路径

假如我们需要作用指定的类上，那么代码如下所示：

@Override
public boolean supports(MethodParameter returnType, Class converterType) {// 假设你想针对某个具体业务的返回值类型进行处理，这里以 com.example.demo.entity.User 为例return returnType.getParameterType().getName().equals("com.example.demo.entity.User");
}

解释：

过获取MethodParameter中的返回值类型的全限定名，并与指定的类全限定名（这里是com.example.demo.entity.User）进行比较，如果相等，就表明当前处理的方法返回值类型正是我们期望操作的那个类，supports方法就返回true

2.异常情况

这里在对于返回类型为string类型的数据会发生，数据不匹配的原因，这里涉及到原码的问题了，出现问题如下所示：

@Controller
@RequestMapping("/test")
public class TestController {@RequestMapping("t1")public String t1(){return "t1";}
}

首先我们先创建一个string类，通过运行代码，然后进行同意结果的访问，那么出现的结果如下所示：

主要还是应为原码的问题：

所以此时，我们规定的返回格式不符合这里的string类型，所以发生类型不匹配的问题，那么此时我们就需要进行操作修改；

代码如下：

@Autowiredprivate ObjectMapper mapper;@Overridepublic boolean supports(MethodParameter returnType, Class converterType) {return true;}@SneakyThrows@Overridepublic Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) {//如果返回的值本来就是result类型，那么就不必再次进行包装了if(body instanceof String){return mapper.writeValueAsString(Result.success(body));}return Result.success(body);}

解释：

这里就是判断类型是否是一个string类型，如果是string类型，在包装后我们要进行转化为string类，那么这里的objectmapping的使用是什么呢？

ObjectMapper是 Jackson 库（一个常用的 Java 处理 JSON 数据的库）中的一个核心类，主要用于在 Java 对象和 JSON 格式数据之间进行相互转换，在这里主要用于将对象转换为json格式的字符串；

??2.3统一返回格式优点

1. 便前端程序员更好的接收和解析后端数据接返回的数据
2. 降低前端程序员和后端程序员的沟通成本, 按照某个格式实现就可以了, 因为所有接都是这样返回的.
3. 有利于项统数据的维护和修改.
4. 有利于后端技术部的统规范的标准制定, 不会出现稀奇古怪的返回内容

**??**3.统一异常处理

??3.1快速入门

统异常处理使的是 @ControllerAdvice + @ExceptionHandler 来实现的,@ControllerAdvice 表控制器通知类， @ExceptionHandler 是异常处理器，两个结合表当出现异常的时候执某个通知，也就是执某个法事件

代码如下所示：

@Slf4j
@ResponseBody
@ControllerAdvice
public class ExceptionAdvice {@ExceptionHandlerpublic Result handlerException(Exception e){log.error("发生不知名异常, e: {}", e);return Result.fail("内部错误");}

注意：小编这里使用统一返回类型来进行演示的，这里添加了@slf4j来进行错误日志的打印；此时我们自己手动构造一个错误；

@Controller
@RequestMapping("/test")
public class TestController {@RequestMapping("t1")public String t1(){int a=10/0;return "t1";}
}

很明显这是一种算数异常的出现，那么此时我们进行运行后，在postman中可以看到此时的情况是如何的；

可以看到这里就是出现了内部错误；

??3.2多种异常

代码如下：

 @ExceptionHandlerpublic Result handlerException(Exception e){log.error("发生不知名异常, e: {}", e);return Result.fail("内部错误");}@ExceptionHandlerpublic Result handlerException(NullPointerException e){log.error("发生空指针异常, e: {}", e);return Result.fail("发生空指针异常");}@ExceptionHandlerpublic Result handlerException(ArithmeticException e){log.error("发生算数异常, e: {}", e);return Result.fail("发生算数异常");}

那么此时可以看到，我们列举了不止一种异常，一个父类异常，两个子类异常，那么此时我们再次进行运行，并试一下controller中的算数异常；

可以看到此时得到的就是算数异常；

总结：

在出现一个父类异常时，和出现一个对应的子类异常时，优先就是使用子类异常处理，若没有对应的子类异常，那么就是使用父类的异常处理；这里涉及到原码小编就不再过多赘述了；

??3.3统一异常处理优点

1.保障代码质量：确保异常处理方式统一规范，避免因开发人员差异导致的不一致，使代码遵循相同规则，增强可读性与可维护性。
2.强化系统性能：全面捕获各类异常，采取诸如重试、降级等应对策略，有效防止系统因异常而崩溃，维持稳定运行，提升健壮性。
3.助力问题排查：详细记录异常信息，包括类型、发生位置及堆栈详情，方便开发人员依据日志迅速追溯根源，实现高效调试。
4.优化用户感受：向客户端反馈简洁友好的错误消息，屏蔽复杂技术细节，使用户能直观了解问题，提升交互体验。

**??**4.总结

本期接着上回，讲解了关于适配器模式，以及Spring统一功能处理的统一返回格式，以及统一异常处理，当然这里涉及原码，大家可以去看看，翻一翻；

???~~~~最后希望与诸君共勉，共同进步！！！

---

???以上就是本期内容了， 感兴趣的话，就关注小编吧。

???期待你的关注~~~