环境：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> getFieldTypes();


  Printer 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> getFieldTypes() {
    Set> types = new HashSet>() ;
    types.add(Integer.class) ;
    return types;
  }


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


  @Override
  public Parser getParser(AgeFormat annotation, Class fieldType) {
    return new AgeFormatter() ;
  }
  
  private class AgeFormatter implements Formatter {
    @Override
    public String print(Integer object, Locale locale) {
      if (object == null) {
        return "" ;
      }
      return object.toString() ;
    }
    
    @Override
    public Integer parse(String text, Locale locale) throws ParseException {
      if (text == null || text.trim().length() == 0) {
        return -1 ;
      }
      return Integer.parseInt(text.substring(1)) ;
    }
  }


}

注册格式化程序。

@Configuration
public class WebConfig implements WebMvcConfigurer {
  @Override
  public void addFormatters(FormatterRegistry registry) {
    registry.addFormatterForFieldAnnotation(new AgeFormatAnnotationFormatterFactory()) ;
  }
}

Users.age字段添加注解。

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

测试接口。

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

注意这里的年龄前面加了一个‘s’字符。

注解添加到参数上

格式化程序：

public final class UsersFormatAnnotationFormatterFactory implements AnnotationFormatterFactory {
  public Set> getFieldTypes() {
    Set> types = new HashSet>() ;
    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 ;
}

完毕！！！