// Controller 方法
@RequestMapping("/getDate")
public ResponseEntity<String> getDate(
        // 前端傳參：?date=2026-02-11
        @DateTimeFormat(pattern = "yyyy-MM-dd") Date date) {
    return ResponseEntity.ok("轉(zhuǎn)換后的日期：" + date);
}

// 實(shí)體類
public class UserForm {
    // 前端表單提交：date=2026-02-11
    @DateTimeFormat(pattern = "yyyy-MM-dd")
    private Date birthday;
    
    // 其他屬性 + getter/setter
}

// Controller 方法
@RequestMapping("/submitForm")
public ResponseEntity<String> submitForm(UserForm userForm) {
    Date birthday = userForm.getBirthday();
    return ResponseEntity.ok("轉(zhuǎn)換后的生日：" + birthday);
}

// 表單實(shí)體類（接收POST表單/GET參數(shù)）
public class ProductForm {
    // 前端傳參：num=1,000（千分位字符串）
    @NumberFormat(pattern = "#,###")
    private Integer num;
    
    // 前端傳參：rate=50%（百分比字符串）
    @NumberFormat(pattern = "0.00%")
    private Double rate;
    
    // getter/setter 方法
    public Integer getNum() { return num; }
    public void setNum(Integer num) { this.num = num; }
    public Double getRate() { return rate; }
    public void setRate(Double rate) { this.rate = rate; }
}

// Controller 方法
@RequestMapping("/product")
public ResponseEntity<Map<String, Object>> getProduct(ProductForm form) {
    Map<String, Object> result = new HashMap<>();
    result.put("轉(zhuǎn)換后數(shù)量", form.getNum()); // 1000（Integer類型）
    result.put("轉(zhuǎn)換后比例", form.getRate()); // 0.5（Double類型）
    return ResponseEntity.ok(result);
}

// 自定義日期轉(zhuǎn)換注解（核心：定義支持的多格式）
@Target({ElementType.FIELD, ElementType.PARAMETER}) // 可用于實(shí)體屬性和方法參數(shù)
@Retention(RetentionPolicy.RUNTIME)
public @interface CustomDateTimeFormat {
    // 默認(rèn)支持兩種格式，可根據(jù)需求自定義修改
    String[] patterns() default {"yyyy-MM-dd", "yyyy/MM/dd"};
}

// 核心類：關(guān)聯(lián)自定義注解 + 實(shí)現(xiàn)轉(zhuǎn)換邏輯，無(wú)需依賴Formatter接口
public class CustomDateTimeFormatAnnotationFormatterFactory 
        implements AnnotationFormatterFactory<CustomDateTimeFormat> {

    // 第一步：指定該工廠支持轉(zhuǎn)換的目標(biāo)類型（此處僅支持Date類型）
    @Override
    public Set<Class<?>> getFieldTypes() {
        Set<Class<?>> fieldTypes = new HashSet<>();
        fieldTypes.add(Date.class); // 明確適配Date類型，避免無(wú)效轉(zhuǎn)換
        return fieldTypes;
    }

    // 第二步：實(shí)現(xiàn)“格式化輸出”邏輯（可選，根據(jù)業(yè)務(wù)需求實(shí)現(xiàn)）
    @Override
    public Printer<Date> getPrinter(CustomDateTimeFormat annotation, Class<?> fieldType) {
        return (date, locale) -> {
            if (date == null) {
                return "";
            }
            // 使用注解中配置的第一個(gè)格式作為輸出格式
            SimpleDateFormat sdf = new SimpleDateFormat(annotation.patterns()[0]);
            return sdf.format(date);
        };
    }

    // 第三步：核心實(shí)現(xiàn)“入?yún)⒔馕觥边壿嫞ㄇ岸俗址?→ 后端Date）
    @Override
    public Parser<Date> getParser(CustomDateTimeFormat annotation, Class<?> fieldType) {
        return (text, locale) -> {
            if (text == null || text.trim().isEmpty()) {
                return null; // 空值處理，避免空指針
            }
            String[] supportPatterns = annotation.patterns();
            // 遍歷注解中支持的所有格式，嘗試解析前端傳參
            for (String pattern : supportPatterns) {
                try {
                    SimpleDateFormat sdf = new SimpleDateFormat(pattern);
                    sdf.setLenient(false); // 嚴(yán)格校驗(yàn)格式，避免非法日期（如2026-02-30）
                    return sdf.parse(text.trim());
                } catch (ParseException e) {
                    continue; // 一種格式失敗，嘗試下一種
                }
            }
            // 所有格式均解析失敗，拋出明確異常，便于排查問題
            throw new ParseException(
                "日期格式錯(cuò)誤，支持的格式：" + Arrays.toString(supportPatterns), 
                text.length()
            );
        };
    }
}

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addFormatters(FormatterRegistry registry) {
        // 注冊(cè)自定義注解工廠，替代傳統(tǒng)的Formatter注冊(cè)，全局生效
        registry.addFormatterForFieldAnnotation(new CustomDateTimeFormatAnnotationFormatterFactory());
    }
}

// 用法1：Controller方法參數(shù)（GET請(qǐng)求，前端傳參：?date=2026/02/11 或 ?date=2026-02-11）
@RequestMapping("/customDate")
public ResponseEntity<String> customDate(
        @CustomDateTimeFormat(patterns = {"yyyy-MM-dd", "yyyy/MM/dd"}) Date date) {
    return ResponseEntity.ok("轉(zhuǎn)換成功：" + date);
}

// 用法2：實(shí)體類屬性（POST表單提交，前端傳參：birthday=2026-02-11）
public class UserForm {
    // 無(wú)需額外配置，注解貼哪里，轉(zhuǎn)換就生效哪里
    @CustomDateTimeFormat
    private Date birthday;
    
    // getter/setter 方法（必須提供，Spring需通過反射獲取/設(shè)置屬性值）
    public Date getBirthday() { return birthday; }
    public void setBirthday(Date birthday) { this.birthday = birthday; }
}

// 實(shí)現(xiàn)Formatter接口，指定轉(zhuǎn)換類型為Integer（前端千分位字符串 → 后端Integer）
public class IntegerFormatter implements Formatter<Integer> {

    @Override
    public Integer parse(String text, Locale locale) throws ParseException {
        if (text == null || text.trim().isEmpty()) {
            return null;
        }
        // 處理前端千分位字符串（如"1,000" → 1000）
        try {
            // 去除千分位逗號(hào)，轉(zhuǎn)換為Integer
            String numStr = text.replace(",", "");
            return Integer.parseInt(numStr);
        } catch (NumberFormatException e) {
            throw new ParseException("數(shù)字格式錯(cuò)誤，支持格式：帶千分位或普通數(shù)字（如1,000、1000）", 0);
        }
    }

    @Override
    public String print(Integer object, Locale locale) {
        // 格式化輸出（可選，用于后端向前端返回時(shí)的格式處理）
        if (object == null) {
            return "";
        }
        // 后端返回時(shí)，自動(dòng)格式化為千分位字符串
        return String.format("%,d", object);
    }
}

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addFormatters(FormatterRegistry registry) {
        // 注冊(cè)自定義IntegerFormatter，全局所有Integer類型表單入?yún)⒆詣?dòng)適配
        registry.addFormatter(new IntegerFormatter());
        // 可同時(shí)注冊(cè)多個(gè)Formatter，適配不同類型（如Date、Double等）
    }
}

// Controller方法（無(wú)需任何轉(zhuǎn)換注解）
@RequestMapping("/formatterNum")
public ResponseEntity<String> formatterNum(Integer num) {
    // 前端傳"1,000"，自動(dòng)轉(zhuǎn)換為1000（Integer類型）
    return ResponseEntity.ok("Formatter轉(zhuǎn)換后：" + num);
}

// 實(shí)體類屬性（無(wú)需注解，同樣自動(dòng)轉(zhuǎn)換）
public class OrderForm {
    // 前端傳num=3,500，自動(dòng)轉(zhuǎn)換為3500
    private Integer num;
    
    // getter/setter方法
    public Integer getNum() { return num; }
    public void setNum(Integer num) { this.num = num; }
}

@Controller
@RequestMapping("/old")
public class OldConverterController {

    // 每個(gè)Controller都要寫一遍，繁瑣！
    @InitBinder
    public void initBinder(WebDataBinder binder) {
        // 注冊(cè)日期轉(zhuǎn)換器，指定格式
        SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
        // 嚴(yán)格校驗(yàn)格式，不匹配則報(bào)錯(cuò)
        dateFormat.setLenient(false);
        // 綁定到PropertyEditor
        binder.registerCustomEditor(Date.class, new CustomDateEditor(dateFormat, true));
    }

    // 前端傳參：?date=2026-02-11
    @RequestMapping("/date")
    public ResponseEntity<String> getDate(Date date) {
        return ResponseEntity.ok("轉(zhuǎn)換后的日期：" + date);
    }
}

// 自定義Converter：String（2026|02|11）→ Date
public class StringToDateConverter implements Converter<String, Date> {

    @Override
    public Date convert(String source) {
        if (source == null || source.isEmpty()) {
            return null;
        }
        try {
            // 適配前端特殊格式：2026|02|11
            SimpleDateFormat sdf = new SimpleDateFormat("yyyy|MM|dd");
            return sdf.parse(source);
        } catch (ParseException e) {
            throw new IllegalArgumentException("日期格式錯(cuò)誤，正確格式：yyyy|MM|dd");
        }
    }
}

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addFormatters(FormatterRegistry registry) {
        // 注冊(cè)自定義Converter
        registry.addConverter(new StringToDateConverter());
    }
}

// 前端傳參：?date=2026|02|11
@RequestMapping("/converterDate")
public ResponseEntity<String> converterDate(Date date) {
    // 無(wú)需加任何注解，Spring自動(dòng)調(diào)用Converter轉(zhuǎn)換
    return ResponseEntity.ok("Converter轉(zhuǎn)換成功：" + date);
}