SpringBoot自定义转换器应用实例讲解-Java开发

SpringBoot在响应客户端请求时,将提交的数据封装成对象时,使用了内置的转换器,SpringBoot也支持自定义转换器,这个内置转换器在debug的时候,可以看到,提供了124个内置转换器

1.基本介绍

SpringBoot 在响应客户端请求时，将提交的数据封装成对象时，使用了内置的转换器

SpringBoot 也支持自定义转换器, 这个内置转换器在 debug 的时候, 可以看到, 提供了 124 个内置转换器. 看下源码 GenericConverter-ConvertiblePair

2.自定义类型转换器应用实例

1.需求说明

演示自定义转换器使用

2.代码实现

1.修改src\main\resources\static\save.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>添加妖怪</title></head>
<body><h1>添加妖怪-坐骑[测试封装 POJO；]</h1>
<form action="/savemonster" method="post">
    编号： <input name="id" value="100"><br/>
    姓名： <input name="name" value="牛魔王"/><br/>
    年龄： <input name="age" value="120"/> <br/>
    婚否： <input name="isMarried" value="true"/> <br/>
    生日： <input name="birth" value="2000/11/11"/> <br/>
    <!-- 使用自定义转换器关联car, 字符串整体提交, 使用,号间隔  -->
    坐骑：<input name="car" value="避水金晶兽,666.6"><br/>
    <input type="submit" value="保存"/>
</form>
</body>
</html>

2.修改src\main\java\com\llp\springboot\controller\ParameterController.java

@PostMapping("/savemonster")
public String saveMonster(Monster monster) {
    //monster= Monster(id=100, name=牛魔王, age=120, isMarried=true, birth=Sat Nov 11 00:00:00 CST 2000, car=Car(name=避水金晶兽, price=666.6))
    System.out.println("monster= " + monster);
    return "success";
}

3.自定义一个类型转换器src\main\java\com\llp\springboot\config\WebConfig.java

/**
 * 开启lite模式,通过容器获取bean时将是多例的
 */
@Configuration(proxyBeanMethods = false)
public class WebConfig {
    @Bean
    public WebMvcConfigurer webMvcConfigurer() {
        return new WebMvcConfigurer() {
            @Override
            public void addFormatters(FormatterRegistry registry) {
                /**
                 * 1. 在addFormatters 方法中,增加一个自定义的转换器
                 * 2. 增加自定义转换器 String -> Car
                 * 3. 增加的自定义转换器会注册到 converters 容器中
                 * 4. converters 底层结构是 ConcurrentHashMap 内置有124转换器
                 */
                registry.addConverter(new Converter<String, Car>() {
                    @Override
                    public Car convert(String content) {
                        if (!ObjectUtils.isEmpty(content)) {
                            //避水金晶兽,666.6
                            String[] split = content.split(",");
                            String name = split[0];
                            double price = Double.parseDouble(split[1]);
                            return new Car(name, price);
                        }
                        return null;
                    }
                });
            }
        };
    }
}

3.注意事项及使用细节

1.我们可以定义多个自定义转换器

/**
 * 开启lite模式,通过容器获取bean时将是多例的
 */
@Configuration(proxyBeanMethods = false)
public class WebConfig {
    @Bean
    public WebMvcConfigurer webMvcConfigurer() {
        return new WebMvcConfigurer() {
            @Override
            public void addFormatters(FormatterRegistry registry) {
                Converter<String, Car> carConverter1 = new Converter<String, Car>() {
                    @Override
                    public Car convert(String content) {
                        if (!ObjectUtils.isEmpty(content)) {
                            //避水金晶兽,666.6
                            String[] split = content.split(",");
                            String name = split[0];
                            double price = Double.parseDouble(split[1]);
                            return new Car(name, price);
                        }
                        return null;
                    }
                };
                Converter<String, Monster> monsterConverter = new Converter<String, Monster>() {
                    @Override
                    public Monster convert(String s) {
                        return null;
                    }
                };
                Converter<String, Car> carConverter2 = new Converter<String, Car>() {
                    @Override
                    public Car convert(String s) {
                        System.out.println(s);
                        return null;
                    }
                };
                registry.addConverter(carConverter1);
                //carConverter1、carConverter2的key均为 java.lang.String->com.llp.springboot.bean.Car组成
                //因此carConverter2会覆盖掉carConverter1
                registry.addConverter(carConverter2);
                registry.addConverter(monsterConverter);
            }
        };
    }
}

2.底层在定义了一变量名为convertes的ConCurrentHashMap用于存储所有的类型转换器，而key是由“原类型->目标类型”构成的，因此当自定义的key相同时会覆盖调之前的类型转换器，这里我们定义了三个自定义转换器但其中两个时相同的key因此只会保留最后一次添加的类型转换器