SpringBoot接口请求入参和出参增强的五种方法
在Spring Boot , Spring Cloud中，对接口的请求入参和出参进行自定义的序列化和反序列化增强，通常有以下几种方法：
1. 使用@JsonSerialize和@JsonDeserialize注解
可以在实体类的字段上使用这两个注解来指定自定义的序列化器和反序列化器。
使用场景：
- 当需要对某个特定字段进行自定义的序列化和反序列化时。
- 当实体类中的某些字段类型不是标准的JSON类型，需要转换成JSON能识别的格式时。
- 需要在序列化和反序列化过程中添加自定义逻辑，如加密、解密、格式转换等。
首先，定义自定义的序列化器和反序列化器：
public class CustomLocalDateTimeSerializer extends JsonSerializer<LocalDateTime> {
@Override
public void serialize(LocalDateTime value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
gen.writeString(value.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
}
}
public class CustomLocalDateTimeDeserializer extends JsonDeserializer<LocalDateTime> {
@Override
public LocalDateTime deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
return LocalDateTime.parse(p.getValueAsString(), DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
}
}
然后，在实体类中使用这些注解：
public class MyEntity {
@JsonSerialize(using = CustomLocalDateTimeSerializer.class)
@JsonDeserialize(using = CustomLocalDateTimeDeserializer.class)
private LocalDateTime dateTime;
// getters and setters
}
2. 全局配置Jackson的ObjectMapper
通过配置ObjectMapper来全局地改变序列化和反序列化的行为,可以添加自定义的模块或配置属性。
使用场景：
- 当项目中多个实体类需要应用相同的序列化和反序列化规则时。
- 需要在全局范围内统一处理日期、时间、枚举等类型的序列化和反序列化。
- 需要对
ObjectMapper进行全局的配置，如设置默认的时区、日期格式等。
创建一个自定义模块，并注册序列化器和反序列化器：
public class CustomJacksonModule extends SimpleModule {
public CustomJacksonModule() {
addSerializer(LocalDateTime.class, new CustomLocalDateTimeSerializer());
addDeserializer(LocalDateTime.class, new CustomLocalDateTimeDeserializer());
}
}
然后，配置ObjectMapper：
@Bean
public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer() {
return builder -> {
builder.modules(new CustomJacksonModule());
};
}
3. 使用@ControllerAdvice配合@InitBinder
要对Spring MVC的控制器进行全局的配置，可以使用@ControllerAdvice注解。然后，在这个类中使用@InitBinder注解的方法来注册自定义的属性编辑器。
注意：@InitBinder主要用于处理表单数据的绑定，对于JSON数据的序列化和反序列化，它并不是最直接的方法。但如果是处理非JSON格式的请求体（如表单数据），则可以使用此方法。
使用场景（对于JSON数据，更偏向于使用其他方法；对于表单数据）：
- 当需要对表单数据的绑定进行自定义处理时。
- 当需要在多个控制器中复用相同的表单数据绑定逻辑时。
创建一个自定义的属性编辑器：
public class CustomLocalDateTimeEditor extends PropertyEditorSupport {
@Override
public void setAsText(String text) throws IllegalArgumentException {
setValue(LocalDateTime.parse(text, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
}
@Override
public String getAsText() {
LocalDateTime value = (LocalDateTime) getValue();
return value.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
}
}
然后，在@ControllerAdvice类中注册这个属性编辑器：
@ControllerAdvice
public class CustomControllerAdvice {
@InitBinder
public void initBinder(WebDataBinder binder) {
binder.registerCustomEditor(LocalDateTime.class, new CustomLocalDateTimeEditor());
}
}
4. 自定义HttpMessageConverter
可以编写自定义的HttpMessageConverter来处理特定的媒体类型，并在其中实现自定义的序列化和反序列化逻辑。然后，将其注册到Spring MVC的配置中。
使用场景：
- 当Spring Boot默认的HttpMessageConverter无法满足自定义的序列化和反序列化需求时。
- 当需要处理非标准的媒体类型时，如自定义的二进制格式或文本格式。
- 当需要在序列化和反序列化过程中应用复杂的业务逻辑时。
创建一个自定义的HttpMessageConverter：
public class CustomLocalDateTimeConverter extends MappingJackson2HttpMessageConverter {
public CustomLocalDateTimeConverter() {
super();
ObjectMapper customObjectMapper = new ObjectMapper();
customObjectMapper.registerModule(new CustomJacksonModule());
setObjectMapper(customObjectMapper);
}
}
然后，在配置类中注册这个转换器：
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
converters.add(0, new CustomLocalDateTimeConverter());
}
}
5. 使用AOP进行切面编程
可以使用Spring AOP来对控制器的方法进行切面，从而在方法执行前后进行自定义的序列化和反序列化操作。
使用场景：
- 当需要在不修改原有业务代码的情况下，对方法入参和出参进行额外的处理时。
- 当需要对多个控制器或方法中的入参和出参应用统一的处理逻辑时。
- 当处理逻辑与业务逻辑相对独立，且需要保持代码结构清晰时。
首先，定义一个切面：
@Aspect
@Component
public class CustomSerializationAspect {
@Before("execution(* com.example.controller..*.*(..)) && args(..,@RequestParam(..),@RequestBody(..))")
public void beforeControllerMethod(JoinPoint joinPoint) {
// 在这里可以修改入参，但通常不建议这么做，因为这会改变方法的签名
// 更常见的是在处理响应后进行修改
}
@AfterReturning(pointcut = "execution(* com.example.controller..*.*(..)) && @annotation(org.springframework.web.bind.annotation.RequestMapping)", returning = "result")
public void afterControllerMethod(JoinPoint joinPoint, Object result) {
// 在这里可以修改出参，例如将LocalDateTime转换为特定格式的字符串
if (result instanceof MyEntity) {
MyEntity entity = (MyEntity) result;
// 假设你想在这里修改entity的dateTime字段
}
}
}
注意：AOP通常用于横切关注点的处理，如日志、事务管理等，而不是用于修改方法的入参和出参。如果你需要修改入参和出参，通常建议使用其他方法，如自定义的HttpMessageConverter或@ControllerAdvice。在上面的AOP示例中看到了如何捕获方法的执行，但实际上修改入参是不推荐的，而出参的修改也通常不是AOP的最佳用途。如果确实需要在AOP中修改出参，你可能需要考虑使用@AfterReturning注解，并检查返回值的类型，然后进行相应的处理。然而，更常见做法是使用Jackson的序列化特性或@ControllerAdvice来全局处理响应体的格式。
结语
Spring Boot, Spring Cloud 中要增强请求出入参的方式中, 通常，对于简单的自定义需求，使用@JsonSerialize和@JsonDeserialize注解是最直接和简单的方式。而对于更复杂的全局配置或跨多个控制器的需求，则可能需要使用ObjectMapper的配置或@ControllerAdvice。
以上就是SpringBoot接口请求入参和出参增强的五种方法的详细内容，更多关于SpringBoot接口出入参增强的资料请关注脚本之家其它相关文章！
相关文章
这篇文章主要介绍了从字节码角度解析synchronized和反射的实现原理，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2023-08-08
验证码可以有效防止其他人对某一个特定的注册用户用特定的程序,破解方式进行不断的登录尝试,我们其实很经常看到,登录一些网站其实是需要验证码的,所以本文给大家分享了SpringBoot实现验证码的案例,需要的朋友可以参考下2024-11-11
这篇文章主要介绍了Idea中导入新模块无法被识别的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教2023-11-11
SpringBoot升级3.2报错Invalid value type for
这篇文章给大家介绍了SpringBoot升级3.2报错Invalid value type for attribute ‘factoryBeanObjectType‘: java.lang.String的解决方案,文中有详细的原因分析,需要的朋友可以参考下2023-12-12
开发过程中,后台的参数校验是必不可少的,下面这篇文章主要给大家介绍了关于SpringBoot参数校验的最佳实战,文中通过示例代码介绍的非常详细,需要的朋友可以参考下2021-08-08
最近工作中遇到了一个需求，需要利用java获取字符串中的数字，尝试几种方法后发现利用正则表达式实现最为方法，下面这篇文章就主要介绍了Java通过正则表达式获取字符串中数字的方法，文中给出了详细的示例代码，需要的朋友可以参考下。2017-03-03
POM是用于描述Maven项目的配置文件，它包含了项目构建、依赖管理和其他相关配置的信息，这篇文章主要介绍了Maven-POM文件,需要的朋友可以参考下2023-06-06
这篇文章主要介绍了Java编程实现基于图的深度优先搜索和广度优先搜索完整代码，具有一定借鉴价值，需要的朋友可以了解下。2017-12-12
这篇文章主要给大家介绍了关于springboot实现登录功能的完整步骤,在web应用程序中,用户登录权限验证是非常重要的一个步骤,文中通过代码以及图文介绍的非常详细,需要的朋友可以参考下2023-09-09
这篇文章主要为大家详细介绍了Java后台实现浏览器一键导出下载zip压缩包，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2018-07-07
最新评论