网站生成自助,做网站不用服务器吗,企业名录2020企业黄页,被称为网站开发神器目录 一、前言
二、动态修改接口返回结果实现方案总结
2.1 使用反射动态修改返回结果参数
2.1.1 认识反射
2.1.2 反射的作用
2.1.3 反射相关的类
2.1.4 反射实现接口参数动态修改实现思路
2.2 使用ControllerAdvice 注解动态修改返回结果参数
2.2.1 注解…目录 一、前言
二、动态修改接口返回结果实现方案总结
2.1 使用反射动态修改返回结果参数
2.1.1 认识反射
2.1.2 反射的作用
2.1.3 反射相关的类
2.1.4 反射实现接口参数动态修改实现思路
2.2 使用ControllerAdvice 注解动态修改返回结果参数
2.2.1 注解作用
2.2.2 实现思路
2.3 使用AOP动态修改返回结果参数
三、动态修改接口返回结果操作实践
3.1 前置准备
3.2 使用反射实现结果集参数动态修改
3.2.1 自定义反射工具类
3.2.2 测试接口继承工具类
3.3 使用ControllerAdvice实现结果集参数动态修改
3.3.1 ControllerAdvice 简单介绍
3.3.2 ControllerAdvice 主要作用
3.3.3 ControllerAdvice 用法
3.3.4 ControllerAdvice实现结果集参数动态修改
3.4 使用自定义注解AOP实现接口参数动态修改
3.4.1 实现思路
3.4.2 自定义注解
3.4.3 自定义AOP类
3.4.4 测试接口一
3.4.5 测试接口二
四、插件化封装
4.1 操作过程
4.1.1 创建maven工程
4.1.2 导入依赖
4.1.3 代码迁移
4.1.4 配置自动装配文件
4.1.5 使用maven命令安装jar包
4.2 功能测试
4.2.1 导入上一步的依赖
4.2.2 接口改造
4.2.3 接口测试
五、写在文末 一、前言
在日常项目开发中涉及到很多需要动态修改rest接口返回参数的场景比如对接口中的字段统一脱敏对接口中的某些字段进行二次加密处理或者对某些特别的字段根据安全审计要求进行二次处理甚至需要动态的在接口中增加额外的参数等诸如此类的场景不胜枚举本篇将介绍如何在springboot项目对接口返回结果进行动态修改。 二、动态修改接口返回结果实现方案总结
在springboot框架下基于框架现有提供的技术组件有很多种实现方式下面分别展开来说。 2.1 使用反射动态修改返回结果参数
2.1.1 认识反射
Java的反射机制是在运行状态中对于任意一个类都能够获得这个类的所有属性和方法对于任意一个对象都能够调用它的任何方法和属性。这种动态获取类的信息以及动态调用方法的功能称为Java语言的反射(reflection)机制。 2.1.2 反射的作用
通过反射机制就能在程序运行时发现该对象和类的真实信息利用这个机制可以动态修改类对象中的参数信息比如运行过程中对象参数的值。 2.1.3 反射相关的类
反射中常会涉及到下面几个概念 Class类 代表类的实体在运行的Java应用程序中表示类和接口 Field类 代表类的成员变量/字段 Method类 代表类的方法 Constructor类 代表类的构造方法 2.1.4 反射实现接口参数动态修改实现思路
完整的实现思路如下 获取接口返回值 拿到上一步返回值中的结果集对象 拆解结果集通过反射获取结果集中的对象实例解析其中的字段 获取字段的名称字段的返回值 根据业务需求对指定的字段结果进行修改 伪代码如下
public void modifyResult(ListT result,String... params){1、解析结果集2、反射获取结果集实例3、获取并解析结果集实例中的字段信息4、结合入参动态修改字段值并重新设置到实例对象中
}
2.2 使用ControllerAdvice 注解动态修改返回结果参数 2.2.1 注解作用
ControllerAdvice 是 Spring Framework 提供的一个注解它用于定义一个全局的异常处理器或跨切面行为cross-cutting concern。这个注解可以用来集中处理控制器中的一些公共关注点如全局异常处理、数据绑定初始化等。主要作用如下 全局异常处理 ControllerAdvice 可以用来定义一个全局的异常处理器。当你在控制器中抛出了一个未被捕获的异常时你可以定义一个带有 ExceptionHandler 注解的方法来处理这个异常。这样可以避免在每个控制器或方法中重复定义相同的异常处理逻辑。 统一数据绑定初始化 除了异常处理外ControllerAdvice 还可以用来初始化数据绑定这可以通过使用 ModelAttribute 注解来实现。这种方法常用于在所有控制器方法调用前预先设置一些模型属性。 统一前置或后置处理 ControllerAdvice 结合 InitBinder 注解还可以用来定义全局的绑定初始化器和数据格式化器。此外还可以使用 ModelAttribute 注解来定义在所有控制器方法之前执行的前置处理方法或者使用 ModelAttribute 注解的方法来填充模型属性。 2.2.2 实现思路
使用ControllerAdvice 注解实现接口返回值参数动态修改的思路如下 解析返回结果 反射获取结果中的对象实例 修改对象参数 补充说明 如果仅仅是为了在返回的结果集增加参数或者对某些固定参数进行处理可以忽略反射这一步的操作 2.3 使用AOP动态修改返回结果参数
aop是一种很好的解决公共业务场景下通用问题的实现思路像本次的需求修改接口参数一般并不局限于某个具体接口而是在很多场景下都可能用到因此使用AOP来解决也是一种很好切入点具体来说主要实现思路如下 自定义注解 注解中的参数可根据实际需要添加比如可以添加需要修改的参数名称修改后的类型等 为需要修改结果集参数的接口添加上一步的自定义注解 自定义AOP实现类解析接口的参数解析返回结果利用反射技术将结果集中需要修改的参数重新赋值 三、动态修改接口返回结果操作实践
基于上面探讨的几种实现方案接下来通过实战案例代码分别演示说明。 3.1 前置准备
创建一个springboot工程并导入如下必要的依赖 dependencygroupIdcom.alibaba/groupIdartifactIdfastjson/artifactIdversion1.2.44/version/dependencydependencygroupIdcommons-io/groupIdartifactIdcommons-io/artifactIdversion2.3/version/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-aop/artifactId/dependency 3.2 使用反射实现结果集参数动态修改
参考下面的操作步骤。 3.2.1 自定义反射工具类
完整的代码如下实现思路 方法接收一个泛型的对象T和一组待修改的参数 使用反射技术实例化对象T拿到实例对象的字段信息 循环遍历字段Field对象列表然后进行参数值的重新赋值
import lombok.extern.slf4j.Slf4j;import java.lang.reflect.Field;
import java.util.Arrays;
import java.util.List;
import java.util.Objects;
import java.util.stream.Collectors;Slf4j
public class ResultHandler {public T void setUserInfo(T t, String... params) {if (Objects.isNull(t)) {log.error(t 参数为空);return;}ListString modifyParams Arrays.stream(params).toList();Class? extends Object tClass t.getClass();Field[] fields tClass.getDeclaredFields();Arrays.stream(fields).filter(item -modifyParams.contains(item.getName())).collect(Collectors.toList()).forEach(field - {field.setAccessible(true);String fieldName field.getName();Object value null;try {value field.get(t);field.set(t, value _change);} catch (IllegalAccessException e) {throw new RuntimeException(e);}});}} 3.2.2 测试接口继承工具类
如果你的接口需要动态修改返回值参数可以继承上述工具类如下
RestController
public class AviatorController extends ResultHandler{//localhost:8081/aop/post/testPostMapping(/aop/post/test)public UserRequest testPost(RequestBody(required false) UserRequest userRequest) {System.out.println(进入接口);setUserInfo(userRequest,name);return new UserRequest(userRequest.getName(),userRequest.getAddress());}}
在上面的接口中在最终返回数据之前调用工具类中的方法传入返回值吗剩下的交给工具类中的方法处理即可启动工程之后测试一下接口可以看到返回值中的name参数就被修改了 3.3 使用ControllerAdvice实现结果集参数动态修改 3.3.1 ControllerAdvice 简单介绍
ControllerAdvice 是 Spring Framework 提供的一个注解用于定义一个全局异常处理器或者跨切面的增强功能。它是一个特殊的切面AOP Aspect可以用于处理控制器Controller 或 RestController中的异常、数据绑定错误、模型属性预填充以及其他跨切面的关注点。ControllerAdvice 注解通常用在需要对多个控制器进行统一处理的场景中比如全局异常处理、数据验证失败处理、模型属性预填充等。 3.3.2 ControllerAdvice 主要作用
ControllerAdvice 主要有如下作用 全局异常处理 可以捕获所有控制器中抛出的异常并提供统一的处理逻辑。 使开发者能够集中处理异常而不是在每个控制器中重复编写相同的异常处理代码。 数据绑定错误处理 当数据绑定失败时可以捕获 BindException 或 MethodArgumentNotValidException 等异常并进行统一处理。 便于对前端传来的数据进行统一的校验和错误提示。 模型属性预填充 可以在请求处理之前预先填充模型属性比如当前时间、用户信息等。 使得控制器方法更加简洁减少重复代码。 跨切面关注点 可以用来处理一些横切关注点比如日志记录、安全检查等。 通过 ModelAttribute 或者自定义注解来实现。 3.3.3 ControllerAdvice 用法
全局异常处理
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;ControllerAdvice
public class GlobalExceptionHandler {ExceptionHandler(value {NullPointerException.class})public ResponseEntityObject handleNullPointerException(NullPointerException ex) {// 处理空指针异常return ResponseEntity.status(400).body(Null pointer exception occurred: ex.getMessage());}ExceptionHandler(value {IllegalArgumentException.class})public ResponseEntityObject handleIllegalArgumentException(IllegalArgumentException ex) {// 处理非法参数异常return ResponseEntity.status(400).body(Illegal argument exception occurred: ex.getMessage());}
}
数据绑定错误处理
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;import java.util.HashMap;
import java.util.Map;ControllerAdvice
public class DataBindingExceptionHandler {ExceptionHandler(MethodArgumentNotValidException.class)public ResponseEntityObject handleValidationExceptions(MethodArgumentNotValidException ex) {BindingResult result ex.getBindingResult();MapString, String errors new HashMap();result.getAllErrors().forEach((error) - {String fieldName ((FieldError) error).getField();String errorMessage error.getDefaultMessage();errors.put(fieldName, errorMessage);});return ResponseEntity.badRequest().body(errors);}
}
模型属性预填充
import org.springframework.security.core.Authentication;
import org.springframework.security.core.context.SecurityContextHolder;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ModelAttribute;ControllerAdvice
public class ModelAttributePrePopulator {ModelAttribute(currentUser)public String getCurrentUser() {Authentication authentication SecurityContextHolder.getContext().getAuthentication();return authentication.getName();}
}
3.3.4 ControllerAdvice实现结果集参数动态修改
自定义一个类实现ResponseBodyAdvice接口如下
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.springframework.core.MethodParameter;
import org.springframework.http.MediaType;
import org.springframework.http.server.ServerHttpRequest;
import org.springframework.http.server.ServerHttpResponse;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.servlet.mvc.method.annotation.ResponseBodyAdvice;import java.util.HashMap;
import java.util.Map;ControllerAdvice
public class DataChangeAdvice implements ResponseBodyAdvice {static ObjectMapper objectMapper new ObjectMapper();Overridepublic Object beforeBodyWrite(Object body, MethodParameter returnType,MediaType selectedContentType, Class selectedConverterType,ServerHttpRequest request, ServerHttpResponse response) {Map res new HashMap();res.put(code,200);//如果返回值是String直接放到Result里if (body instanceof String) {res.put(data,(String) body);return res;}//如果返回值是标准返回格式就不需要再次封装了//如果不加这个判断异常的结果会被封装两次else if (body instanceof Map) {return body;}String dataStr null;try {dataStr objectMapper.writeValueAsString(body);res.put(data,dataStr);} catch (JsonProcessingException e) {e.printStackTrace();}return res;}Overridepublic boolean supports(MethodParameter returnType, Class converterType) {return true;}
}
运行工程之后测试一下上面的接口可以看到原本的接口返回值根据业务的需要重新做了修改 基于上述的改造还可以继续扩展比如通过自定义注解在接口上面添加自定义注解然后再在返回值中解析自定义注解并根据实际的需要重新对注解中的参数进行修改。 3.4 使用自定义注解AOP实现接口参数动态修改
在之前分享的一篇文章中我们使用AOP自定义注解的方式实现了请求参数的动态修改使用这个方式是否也可以对接口返回的参数进行修改呢 3.4.1 实现思路
参考下面的实现思路进行实现 自定义注解 属性主要包括待修改的结果参数名称修改的格式等 自定义AOP类对于那些标注了上述自定义注解的接口进行拦截 使用环绕通知的方式 在AOP执行方法中调用point.proceed()获取目标方法的执行结果 在结果中使用反射结合解析到的自定义注解从而动态修改接口的参数值 3.4.2 自定义注解
自定义一个注解用于接口中待修改的参数进行标注
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;Target(ElementType.METHOD)
Retention(RetentionPolicy.RUNTIME)
public interface ModifyResponseParams {Param[] value() default {};String dataFormat() default ;Retention(RetentionPolicy.RUNTIME)Target({})public static interface Param {String name();String value() default ;}} 3.4.3 自定义AOP类
aop中的业务逻辑即可结合上面的实现思路进行理解参考如下完整的示例代码实现逻辑也是按照上述的实现思路进行构建
package com.congge.aop;import com.congge.controller.R;
import lombok.extern.slf4j.Slf4j;
import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.core.annotation.Order;
import org.springframework.stereotype.Component;import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;Aspect
Component
Order(1)
Slf4j
public class ResponseParamModifierAspect {Around(annotation(modifyResponseParams))public Object modifyRequestParams(ProceedingJoinPoint point, ModifyResponseParams modifyResponseParams) throws Throwable {ListString modifyParams new ArrayList();for (ModifyResponseParams.Param param : modifyResponseParams.value()) {modifyParams.add(param.name());}Object t point.proceed();if (Objects.isNull(t)) {log.error(接口返回结果为空);return t;}//获取返回结果集并解析R? r (R?) t;Object data r.getData();if (data instanceof List?) {List? list (List?) data;list.forEach(item -{Class? tClass item.getClass();Field[] fields tClass.getDeclaredFields();for (Field field : fields) {field.setAccessible(true);String fieldName field.getName();if(modifyParams.contains(fieldName)){try {Object value field.get(item);field.set(item, value _change);} catch (IllegalAccessException e) {throw new RuntimeException(e);}}}});}else {Object t1 data;Class? extends Object tClass t1.getClass();Field[] fields tClass.getDeclaredFields();for (Field field : fields) {field.setAccessible(true);String fieldName field.getName();if(modifyParams.contains(fieldName)){try {Object value field.get(t1);field.set(t1, value _change);} catch (IllegalAccessException e) {throw new RuntimeException(e);}}}}return t;}} 3.4.4 测试接口一
在测试接口上面添加上述自定义注解对需要修改的参数在注解中进行标注 ModifyResponseParams(value {ModifyResponseParams.Param(name address),ModifyResponseParams.Param(name name)})PostMapping(/aop/modify/v1)public R testModifyV1(RequestBody(required false) UserRequest userRequest) {System.out.println(进入接口);return R.ok(new UserRequest(userRequest.getName(),userRequest.getAddress()));}
使用接口工具调用一下可以看到接口返回值中的两个参数被修改了 3.4.5 测试接口二
这一次返回一个集合 ModifyResponseParams(value {ModifyResponseParams.Param(name address),ModifyResponseParams.Param(name name)})PostMapping(/aop/modify/v2)public R testModifyV2(RequestBody(required false) UserRequest userRequest) {System.out.println(进入接口);ListUserRequest userRequests Arrays.asList(new UserRequest(userRequest.getName(), userRequest.getAddress()));return R.ok(userRequests);}
使用接口工具调用一下可以看到接口返回值中的两个参数被修改了 四、插件化封装
有了上面的实践之后为了减少后续遇到类似的场景时的多次重复编码可以考虑将上述AOP的实现方案使用springboot的starter机制进行插件化封装参考如下操作步骤。 4.1 操作过程 4.1.1 创建maven工程
工程目录结构如下 4.1.2 导入依赖
主要包括下面几个核心依赖 dependencies!-- Spring框架基本的核心工具 --dependencygroupIdorg.springframework/groupIdartifactIdspring-context-support/artifactId/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-autoconfigure/artifactId/dependency!--阿里 FastJson依赖--dependencygroupIdcom.alibaba/groupIdartifactIdfastjson/artifactIdversion1.2.44/version/dependencydependencygroupIdcommons-io/groupIdartifactIdcommons-io/artifactIdversion2.3/version/dependencydependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-aop/artifactId/dependency/dependencies
4.1.3 代码迁移
将上一小节中的几个核心实现类拷贝过来到aop包下略 4.1.4 配置自动装配文件
在resources目录下参考工程结构创建配置文件 spring.factories 将AOP的完整类路径名称配置进去
org.springframework.boot.autoconfigure.EnableAutoConfiguration\com.congge.aop.ResponseParamModifierAspect
4.1.5 使用maven命令安装jar包
执行mvn install 命令将工程的jar安装到本地仓库中 4.2 功能测试 4.2.1 导入上一步的依赖 在需要的工程pom中导入上一步的依赖jar的maven坐标 dependencygroupIdcom.congge/groupIdartifactIdaop_com/artifactIdversion1.0-SNAPSHOT/version/dependency
4.2.2 接口改造
原本的接口代码逻辑保持不变只需要将自定义注解改为上一步的注解即可 4.2.3 接口测试
启动工程之后再次调用上述接口接口返回值参数被修改了说明插件包中的逻辑正常生效了 五、写在文末
本文通过案例和操作详细介绍了如何在微服务项目中实现对接口返回值的参数修改在实际应用中可以结合案例中的思路以及自身的需求场景进行深度的拓展希望对看到的同学有用本篇到此结束感谢观看。
