Spring强大的数据格式化处理功能,你必须得知道

2023年 9月 21日 40.7k 0

环境:Springboot2.6.12

通常,当需要实现通用类型转换逻辑时,可以使用转换器SPI 例如,用于在java.util.Date和Long之间转换。当你在客户端环境(如web应用程序)中工作并且需要解析和打印本地化字段值时,可以使用格式化程序SPI。ConversionService为两个SPI提供统一的类型转换API。

在Springboot环境下如何自定义数据类型的转换?

Formatter SPI

Formatter SPI 实现字段格式化逻辑非常简单,而且是强类型的。以下列表显示格式化程序接口定义:

package org.springframework.format;
public interface Formatter extends Printer, Parser {
}

Formatter 从Printer和Parser构建块接口扩展而来。以下列表显示了这两个接口的定义:

public interface Printer {
  String print(T fieldValue, Locale locale);
}
import java.text.ParseException;


public interface Parser {
  T parse(String clientValue, Locale locale) throws ParseException;
}

要创建自己的Formatter格式化程序,只需要实现上面的Formatter接口。将泛型T替换为需要格式化的对象类型 — 例如,java.util.Date。实现print()操作以打印T的实例以在客户端区域中显示。实现parse()操作,从客户端语言环境返回的格式化表示中解析T的实例。如果解析尝试失败,格式化程序应该抛出ParseException或IllegalArgumentException。注意确保格式化程序实现是线程安全的。

自定义Formatter程序

根据用户输入的信息,每个字段信息通过逗号分割,通过Formatter程序将其转换为Users对象。如输入:张三,30;将信息解析为Users对象姓名为张三,年龄为30。

public class Users {
  private String name ;
  private Integer age ;
}

格式化程序:

public class UsersFormatter implements Formatter {
  @Override
  public String print(Users object, Locale locale) {
    if (Objects.isNull(object)) {
      return "" ;
    }
    return "【name = " + object.getName() + ", age = " + object.getAge() + "】" ;
  }
  @Override
  public Users parse(String text, Locale locale) throws ParseException {
    if (text == null || text.trim().length() == 0) {
      return null ;
    }
    Users user = new Users() ;
    // 下面做简单处理,不做校验
    String[] values = text.split(",") ;
    user.setName(values[0]) ;
    user.setAge(Integer.parseInt(values[1]));
    return user ;
  }


}

格式化程序定义完后,需要注册到系统中让系统能够知道如何进行转换。

@Configuration
public class WebConfig implements WebMvcConfigurer {


  @Override
  public void addFormatters(FormatterRegistry registry) {
    registry.addFormatter(new UsersFormatter()) ;
  }
  
}

测试接口:

@GetMapping("/save")
public Object save(Users users) {
  return users ;
}

输出:

图片图片

基于注解的Formatter

可以按字段类型或注解配置字段格式。要将注解绑定到格式化程序,需要实现AnnotationFormatterFactory。以下显示了AnnotationFormatterFactory接口的定义:

package org.springframework.format;


public interface AnnotationFormatterFactory {


  Set getPrinter(A annotation, Class fieldType);


  Parser getParser(A annotation, Class fieldType);
}

要创建实现,请执行以下操作:

参数化要与格式逻辑关联的字段annotationType — 例如org.springframework.format.annoation.DateTimeFormat。

  • getFieldTypes()返回可以使用注释的字段类型。
  • getPrinter()返回Printer以打印带注释字段的值。
  • getParser()返回一个Parser来解析带注释字段的值。

自定义注解格式化程序

自定义注解类,用来需要格式化的字段。

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER, ElementType.ANNOTATION_TYPE})
public @interface AgeFormat {
}

自定义注解格式化程序。

public final class AgeFormatAnnotationFormatterFactory
        implements AnnotationFormatterFactory {
  public Set> types = new HashSet> getFieldTypes() {
    Set>() ;
    types.add(Users.class) ;
    return types;
  }


  @Override
  public Printer getPrinter(UsersFormat annotation, Class fieldType) {
    return new UsersFormatter();
  }


  @Override
  public Parser getParser(UsersFormat annotation, Class fieldType) {
    return new UsersFormatter() ;
  }


}

接口:

@GetMapping("/save3")
public Object save3(@UsersFormat Users users) {
  return users ;
}

完毕!!!

相关文章

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

发布评论