Spring MVC 自定義類型轉換器實戰：從 Converter 到 FormattingConversionService 最佳實踐

Spring MVC 的類型轉換體系支援將請求參數 (String) 自動綁定為任意複雜對象。本文通過完整實例講解自定義 Converter 實作、註冊機制、與格式化註解的協作關係。

預設轉換能力回顧

啟用 <mvc:annotation-driven /> 或 @EnableWebMvc 後，Spring 自動註冊：

• 基本類型：String ↔ Integer、Long、Double、Boolean 等
• 日期時間：@DateTimeFormat 支援的模式
• 數字格式：@NumberFormat 支援的模式
• 集合/數組：逗號分隔字串 → List/Array

自定義 Converter 實作全流程

場景：字串 "1001-zhangsan-IT" → Employee 對象

1. 目標實體

@Data
@AllArgsConstructor
@NoArgsConstructor
public class Employee {
    private Long id;
    private String name;
    private String department;
}

2. 實作 Converter 介面

GET /api/employees/1001-zhangsan-IT
→ Employee(id=1001, name=zhangsan, department=IT)

POST /api/employees/query?employee=1002-lisi-HR
→ Employee(id=1002, name=lisi, department=HR)

<mvc:annotation-driven conversion-service="conversionService" />

<bean id="conversionService" 
      class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
    <property name="converters">
        <set>
            <bean class="com.example.converter.StringToEmployeeConverter" />
        </set>
    </property>
</bean>