如何为Spring HttpInterface配置枚举类型转换器？

方案1：重写枚举的toString()方法（最简单） #

直接在IdType枚举中重写toString()方法，返回目标参数值：

public enum IdType {
    LOGIN_ID("loginId"),
    CONTACT_ID("contactId");
    
    String idType;
    
    IdType(String idType) { 
        this.idType = idType; 
    }

    @Override
    public String toString() {
        return this.idType;
    }
}

Spring处理@RequestParam参数时，默认会调用枚举的toString()生成参数值，调用helloClient.hello("xyz", IdType.LOGIN_ID)时，会自动拼接idType=loginId到请求URL中。

注意：若代码其他场景依赖枚举默认的toString()输出（如LOGIN_ID），该方案可能影响其他逻辑，需谨慎使用。

方案2：自定义Converter并注册到WebClient的ExchangeStrategies #

若不想修改枚举的toString()，可自定义转换规则并注册到WebClient的转换服务中：

步骤1：实现Converter #

public class IdTypeConverter implements Converter<IdType, String> {
    @Override
    public String convert(IdType source) {
        return source.idType;
    }
}

步骤2：配置WebClient并注册Converter #

在配置类中构建WebClient时，将自定义Converter注入到ExchangeStrategies的转换服务：

@Configuration
public class HttpInterfaceConfig {

    @Bean
    public HelloClient helloClient() {
        // 创建包含自定义Converter的转换服务
        DefaultConversionService conversionService = new DefaultConversionService();
        conversionService.addConverter(new IdTypeConverter());

        // 配置编码策略，替换表单编码器的转换服务
        ExchangeStrategies strategies = ExchangeStrategies.builder()
                .codecs(configurer -> {
                    FormHttpMessageConverter formEncoder = new FormHttpMessageConverter();
                    formEncoder.setConversionService(conversionService);
                    configurer.defaultCodecs().formEncoder(formEncoder);
                })
                .build();

        // 构建WebClient实例
        WebClient webClient = WebClient.builder()
                .baseUrl("http://你的服务基础地址")
                .exchangeStrategies(strategies)
                .build();

        // 创建HttpInterface代理对象
        return HttpServiceProxyFactory.builder(WebClientAdapter.forClient(webClient))
                .build()
                .createClient(HelloClient.class);
    }
}

配置完成后，WebClient处理HelloClient的@RequestParam参数时，会自动使用自定义Converter将IdType转换为对应字符串。

方案3：注册全局转换器（多接口复用场景） #

若多个HttpInterface都需要该转换规则，可通过配置类注册全局转换器：

@Configuration
public class GlobalConversionConfig implements WebMvcConfigurer {
    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addConverter(new IdTypeConverter());
    }
}

注意：该全局配置仅对Spring MVC控制器生效，HttpInterface（基于WebClient）仍需结合方案2的WebClient配置，确保转换服务被正确应用。

内容的提问来源于stack exchange，提问作者user4932655