我們通過Http請求提交的引數都以字串的形式呈現，但最終在springMVC的方法入參中，我們卻能得到各種型別的資料，包括Number、Boolean、複雜物件型別、集合型別、Map型別等，這些都是springMVC內建的資料型別轉換器幫我們完成的。springMVC的將請求資料繫結到方法入參的流程如下所示：

在本文裡，我們通過屬性編輯器來理解springMVC的資料轉換、繫結過程。

PropertyEditorRegistrySupport

而對於常見的資料型別，Spring在PropertyEditorRegistrySupport中提供了預設的屬性編輯器，這些常見的資料型別如下圖所示：

在PropertyEditorRegistrySupport中，有兩個重要的Map型別成員變數：
1. private Map<Class<?>, PropertyEditor> defaultEditors

在PropertyEditorRegistrySupport中，有一個重要的成員方法：createDefaultEditors()來建立預設的屬性編輯器，它的定義如下所示：

/**
 * Actually register the default editors for this registry instance.
 */
 

private void createDefaultEditors() {
    //建立一個HashMap儲存預設的屬性編輯器
    this.defaultEditors = new HashMap<Class<?>, PropertyEditor>(64);

    // 簡單的屬性編輯器，沒有引數化功能，在JDK中沒有包含下列任意目標型別的編輯器
    //這裡和我們上表的資源類相對應
    this.defaultEditors.put(Charset.class, new CharsetEditor());
    this.defaultEditors.put(Class.class, new ClassEditor());
    this.defaultEditors.put(Class[].class, new ClassArrayEditor());
    this.defaultEditors.put(Currency.class, new CurrencyEditor());
    this.defaultEditors.put(File.class, new FileEditor());
    this.defaultEditors.put(InputStream.class, new InputStreamEditor());
    this.defaultEditors.put(InputSource.class, new InputSourceEditor());
    this.defaultEditors.put(Locale.class, new LocaleEditor());
    this.defaultEditors.put(Pattern.class, new PatternEditor());
    this.defaultEditors.put(Properties.class, new PropertiesEditor());
    this.defaultEditors.put(Resource[].class, new ResourceArrayPropertyEditor());
    this.defaultEditors.put(TimeZone.class, new TimeZoneEditor());
    this.defaultEditors.put(URI.class, new URIEditor());
    this.defaultEditors.put(URL.class, new URLEditor());
    this.defaultEditors.put(UUID.class, new UUIDEditor());
    if (zoneIdClass != null) {
        this.defaultEditors.put(zoneIdClass, new ZoneIdEditor());
    }

    // 預設的集合類編輯器例項，這裡和我們上表的集合類相對應
    // 我們能夠通過註冊自定義的相同型別屬性編輯器來重寫下面的預設屬性編輯器
    this.defaultEditors.put(Collection.class, new CustomCollectionEditor(Collection.class));
    this.defaultEditors.put(Set.class, new CustomCollectionEditor(Set.class));
    this.defaultEditors.put(SortedSet.class, new CustomCollectionEditor(SortedSet.class));
    this.defaultEditors.put(List.class, new CustomCollectionEditor(List.class));
    this.defaultEditors.put(SortedMap.class, new CustomMapEditor(SortedMap.class));

    // 基本資料的陣列型別的預設編輯器
    this.defaultEditors.put(byte[].class, new ByteArrayPropertyEditor());
    this.defaultEditors.put(char[].class, new CharArrayPropertyEditor());

    this.defaultEditors.put(char.class, new CharacterEditor(false));
    this.defaultEditors.put(Character.class, new CharacterEditor(true));

    this.defaultEditors.put(boolean.class, new CustomBooleanEditor(false));
    this.defaultEditors.put(Boolean.class, new CustomBooleanEditor(true));

    // JDK中沒有Number包裝類的相關屬性編輯器
    // 通過自定義我們的CustomNumberEditor來重寫JDK預設的屬性編輯器
    this.defaultEditors.put(byte.class, new CustomNumberEditor(Byte.class, false));
    this.defaultEditors.put(Byte.class, new CustomNumberEditor(Byte.class, true));
    this.defaultEditors.put(short.class, new CustomNumberEditor(Short.class, false));
    this.defaultEditors.put(Short.class, new CustomNumberEditor(Short.class, true));
    this.defaultEditors.put(int.class, new CustomNumberEditor(Integer.class, false));
    this.defaultEditors.put(Integer.class, new CustomNumberEditor(Integer.class, true));
    this.defaultEditors.put(long.class, new CustomNumberEditor(Long.class, false));
    this.defaultEditors.put(Long.class, new CustomNumberEditor(Long.class, true));
    this.defaultEditors.put(float.class, new CustomNumberEditor(Float.class, false));
    this.defaultEditors.put(Float.class, new CustomNumberEditor(Float.class, true));
    this.defaultEditors.put(double.class, new CustomNumberEditor(Double.class, false));
    this.defaultEditors.put(Double.class, new CustomNumberEditor(Double.class, true));
    this.defaultEditors.put(BigDecimal.class, new CustomNumberEditor(BigDecimal.class, true));
    this.defaultEditors.put(BigInteger.class, new CustomNumberEditor(BigInteger.class, true));

    // 只有我們顯式將configValueEditorsActive設為true,才會註冊下面型別的編輯器
    if (this.configValueEditorsActive) {
        StringArrayPropertyEditor sae = new StringArrayPropertyEditor();
        this.defaultEditors.put(String[].class, sae);
        this.defaultEditors.put(short[].class, sae);
        this.defaultEditors.put(int[].class, sae);
        this.defaultEditors.put(long[].class, sae);
    }
}

PropertyEditor

PropertyEditor是Java原生的屬性編輯器介面，它的核心功能是將一個字串轉換為一個java物件。
它的定義和常用方法如下所示：

public interface PropertyEditor {

    //設定屬性的值，基本屬性型別要以包裝類傳入
    void setValue(Object value);

    //返回屬性的值，基本資料型別會被封裝成相應的包裝類
    Object getValue();

    //為屬性提供一個表示初始值的字串，屬性編輯器以此值作為屬性的預設值
    String getJavaInitializationString();

    //將屬性物件用一個字串表示，一遍外部的屬性編輯器能以視覺化的方式顯示。
    //預設返回null,表示改屬性不能以字串形式表示
    String getAsText();

    //利用所給字串text更新屬性內部的值
    void setAsText(String text) throws java.lang.IllegalArgumentException;

}

例項解析自定義屬性編輯器

1. 自定義編輯器類

它的一個核心實現類是PropertyEditorSupport，如果我們要編寫自定義的屬性編輯器，只需要繼承這個類，然後重寫setAsText方法即可。下面我們來看一個自定義屬性編輯器的例項：嘗試將字串“myName,1995-01-01,15k”轉換為Person POJO物件，Person物件的定義如下：

package com.mvc.model;

import java.util.Date;

import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.format.annotation.NumberFormat;

public class Person {
    private String name;
    private Date birthday;
    private Long salary;

    //ignore getter and setter 

    @Override
    public String toString() {
        return "Person [name=" + name + ", birthday=" + birthday + ", salary="
                + salary + "]";
    }

}

下面是我們自定義的屬性編輯器：

public class MyEditor extends PropertyEditorSupport {
    @Override
    public void setAsText(String text) throws IllegalArgumentException {
        String[] values = text.split(",");
        Person person = new Person();
        person.setName(values[0]);
        try {
            person.setBirthday(new SimpleDateFormat("yyyy-MM-dd").parse(values[1]));//格式化字串並解析成日期型別
        } catch (ParseException e) {
            e.printStackTrace();
        }
        person.setSalary(Long.valueOf(values[2].replace("k", "000")));//轉換為工資格式
        setValue(person);//呼叫setValue來將我們的Person物件設定為編輯器的屬性值
        super.setAsText(text);
    }
}

2. 註冊編輯器

自定義完屬性編輯器後，我們需要將其註冊才能生效，SpringMVC中使用自定義的屬性編輯器有3種方法：

1. Controller方法中新增@InitBinder註解的方法

例項：

@InitBinder
public void initBinder(WebDataBinder binder) { 
  binder.registerCustomEditor(Person.class, new MyEditor());  
}

2. 實現 WebBindingInitializer介面

方法1是針對特定的控制器的，如果我們需要對全域性控制器生效，可以編寫自己的WebBindingInitializer，然後在spring容器中註冊，如下所示：

public class MyWebBindingInitializer implements WebBindingInitializer {

  @Override
  public void initBinder(WebDataBinder binder, WebRequest request) { 
    binder.registerCustomEditor(Dept.class, new CustomDeptEditor());  
  }
}

在容器中註冊：

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="webBindingInitializer">
        <bean class="com.mvc.editor.MyWebBindingInitializer" />
    </property>
</bean>

3. @ControllerAdvice註解

我們可以通過此註解配置一個控制器增強，

@ControllerAdvice
public class InitBinderControllerAdvice {

  @InitBinder
  public void initBinder(WebDataBinder binder) { 
    binder.registerCustomEditor(Dept.class, new CustomDeptEditor());  
  }

}

我們需要將其納入<context:component-scan>的掃描路徑中才能生效。

從上面的分析我們能看到，springMVC註冊了大量的資料型別編輯器，恰是通過這些屬性編輯器，springMVC幫助我們完成了請求引數字串到入引數據的繫結。在一篇文章裡，我們會談到SpringMVC對新的轉換器框架的支援。