Spring @RequestParam 高级用法：自定义布尔类型参数转换

import org.springframework.beans.propertyeditors.CustomBooleanEditor;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.InitBinder;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ExampleController {

    /**
     * 为当前控制器的WebDataBinder注册自定义编辑器。
     * 当请求参数需要转换为Boolean类型时，将使用此编辑器。
     */
    @InitBinder
    protected void initBinder(WebDataBinder binder) {
        // 注册 CustomBooleanEditor，指定 "oui" 映射为 true，"non" 映射为 false。
        // 第三个参数 allowEmpty 设为 true，表示空字符串也允许（默认为 false，空字符串会抛异常）。
        binder.registerCustomEditor(Boolean.class, new CustomBooleanEditor("oui", "non", true));
    }

    /**
     * 处理GET请求，将自定义的布尔字符串参数转换为Boolean类型。
     * 注意：这里的参数类型是 Boolean 包装类。
     *
     * 测试URL:
     * - http://localhost:8080/e?flag=oui  -> 返回 true
     * - http://localhost:8080/e?flag=non  -> 返回 false
     * - http://localhost:8080/e?flag=true -> 返回 IllegalArgumentException (因为CustomBooleanEditor只识别oui/non)
     */
    @GetMapping("/e")
    public ResponseEntity<String> showRequestParam(@RequestParam(value = "flag") Boolean flag) {
        return new ResponseEntity<>(String.valueOf(flag), HttpStatus.OK);
    }
}

import org.springframework.format.Formatter;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.InitBinder;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import java.text.ParseException;
import java.util.Locale;

@RestController
public class DemoController {

    @InitBinder
    protected void initBinder(WebDataBinder binder) {
        binder.addCustomFormatter(new Formatter<Boolean>() {
            @Override
            public Boolean parse(String text, Locale locale) throws ParseException {
                if ("oui".equalsIgnoreCase(text)) return true;
                if ("non".equalsIgnoreCase(text)) return false;
                // 如果是其他值，抛出 ParseException，Spring 会转换为 HTTP 400
                throw new ParseException("无效的布尔参数值 '" + text + "'；请指定 'oui' 或 'non'", 0);
            }

            @Override
            public String print(Boolean object, Locale locale) {
                // 通常用于将Boolean值转换为字符串，例如在表单中显示
                return String.valueOf(object);
            }
        }, Boolean.class); // 指定此Formatter适用于Boolean类型
    }

    @GetMapping("/r")
    public ResponseEntity<String> showRequestParam(@RequestParam(value = "param") Boolean param) {
        // 注意：这里的参数类型是 Boolean 包装类。
        return new ResponseEntity<>(String.valueOf(param), HttpStatus.OK);
    }
}

import org.springframework.core.convert.converter.Converter;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.http.ResponseEntity;
import org.springframework.http.HttpStatus;

/**
 * 全局自定义布尔类型转换器。
 * 将 "oui" 转换为 true，"non" 转换为 false。
 * 通过 @Component 注解，Spring Boot 会自动将其注册到全局 ConversionService。
 */
@Component
public class CustomBooleanConverter implements Converter<String, Boolean> {

    @Override
    public Boolean convert(String source) {
        if (source == null) {
            return null; // 或者抛出异常，取决于业务需求
        }
        if ("oui".equalsIgnoreCase(source)) {
            return true;
        }
        if ("non".equalsIgnoreCase(source)) {
            return false;
        }
        // 如果是其他值，抛出 IllegalArgumentException，Spring 会将其转换为 HTTP 400
        throw new IllegalArgumentException("无效的布尔参数值 '" + source + "'；请指定 'oui' 或 'non'");
    }
}

@RestController
public class GlobalConverterController {

    /**
     * 处理GET请求，使用全局注册的 CustomBooleanConverter 进行参数转换。
     * 注意：这里的参数类型是 Boolean 包装类。
     *
     * 测试URL:
     * - http://localhost:8080/global?flag=oui  -> 返回 true
     * - http://localhost:8080/global?flag=non  -> 返回 false
     * - http://localhost:8080/global?flag=true -> 返回 IllegalArgumentException (因为CustomBooleanConverter只识别oui/non)
     */
    @GetMapping("/global")
    public ResponseEntity<String> showGlobalRequestParam(@RequestParam(value = "flag") Boolean flag) {
        return new ResponseEntity<>(String.valueOf(flag), HttpStatus.OK);
    }
}