SpringBoot优雅定制接口参数格式转换

2024年 5月 29日 55.9k 0

环境:SpringBoot3.2.5

1. 简介

在Spring MVC中,数据类型的转换、自动绑定和格式化是一个非常强大的功能,Spring内置了非常多的数据类型转换器。如在一个HTTP请求中SpringMVC默认就具备将JSON个数的数据转换为Java对象,将一个字符串数字转换为Number类型等等。然而,Spring的默认数据绑定机制有时可能无法满足特定的业务需求,比如从特定格式的字符串中解析出自定义对象的实例。为了解决这个问题,Spring允许我们自定义注解和数据格式化器,以便在请求参数和Java对象之间进行自定义的转换。

本篇文章将结合如下需求讲解如何基于SpringBoot环境下自定义注解来实现数据的转换。

现有如下接口:

@GetMapping("/user")
public User getUser(User user) {
  return user ;
}

请求url如下:

http://localhost:9001/api/objects/user?user=666,中国

在默认情况下,Spring是无法将这里的user参数值正确的绑定到User对象。

2. 实战案例

2.1 实现目标

为了尽可能的简单,期望通过在接口请求参数上添加一个注解就能完成数据类型的转换及绑定。如下形式:

@GetMapping("/user")
public User getUser(@UserFormat User user)

Spring提供了一种基于注解驱动的格式化,也就是上面这里看到的通过注解标注一个参数(字段)来实现数据的格式化。

要实现基于注解驱动的格式化,需要我们自定义类实现AnnotationFormatterFactory接口。该接口定义如下:

// 这里的泛型是注解类型,也就是我们要使用什么注解来标记我们的参数(字段)
public interface AnnotationFormatterFactory {
  // 这个注解可以使用在什么字段上
  Set getPrinter(A annotation, Class fieldType);
  // 将字符串解析为对象
  Parser getParser(A annotation, Class fieldType);
}

该接口非常的简单,主要就是如何将对象转String,如何从String转对象。

2.2 自定义注解格式化工厂

public class StringToUserFormatter implements AnnotationFormatterFactory {
@Override
public Set

相关文章

JavaScript2024新功能:Object.groupBy、正则表达式v标志
PHP trim 函数对多字节字符的使用和限制
新函数 json_validate() 、randomizer 类扩展…20 个PHP 8.3 新特性全面解析
使用HTMX为WordPress增效:如何在不使用复杂框架的情况下增强平台功能
为React 19做准备:WordPress 6.6用户指南
如何删除WordPress中的所有评论

发布评论