在Spring Boot: 定制HTTP消息轉(zhuǎn)換器一文中我們學(xué)習(xí)了如何配置消息轉(zhuǎn)換器用于HTTP請(qǐng)求和響應(yīng)數(shù)據(jù)，實(shí)際上，在一次請(qǐng)求的完成過(guò)程中還發(fā)生了其他的轉(zhuǎn)換，我們這次關(guān)注將參數(shù)轉(zhuǎn)換成多種類型的對(duì)象，如：字符串轉(zhuǎn)換成Date對(duì)象或字符串轉(zhuǎn)換成Integer對(duì)象。

在編寫(xiě)控制器中的action方法時(shí)，Spring允許我們使用具體的數(shù)據(jù)類型定義函數(shù)簽名，這是通過(guò)PropertyEditor實(shí)現(xiàn)的。PropertyEditor本來(lái)是JDK提供的API，用于將文本值轉(zhuǎn)換成給定的類型，結(jié)果Spring的開(kāi)發(fā)人員發(fā)現(xiàn)它恰好滿足Spring的需求——將URL參數(shù)轉(zhuǎn)換成函數(shù)的參數(shù)類型。

針對(duì)常用的類型（Boolean、Currency和Class），Spring MVC已經(jīng)提供了很多PropertyEditor實(shí)現(xiàn)。假設(shè)我們需要?jiǎng)?chuàng)建一個(gè)Isbn類并用它作為函數(shù)中的參數(shù)。

實(shí)戰(zhàn)

考慮到PropertyEditor屬于工具范疇，選擇在項(xiàng)目根目錄下增加一個(gè)包——utils。在這個(gè)包下定義Isbn類和IsbnEditor類，各自代碼如下：

Isbn類：

package com.test.bookpub.utils;

public class Isbn {
  private String isbn;

  public Isbn(String isbn) {
    this.isbn = isbn;
  }
  public String getIsbn() {
    return isbn;
  }
}

IsbnEditor類，繼承PropertyEditorSupport類，setAsText完成字符串到具體對(duì)象類型的轉(zhuǎn)換，getAsText完成具體對(duì)象類型到字符串的轉(zhuǎn)換。

package com.test.bookpub.utils;
import org.springframework.util.StringUtils;
import java.beans.PropertyEditorSupport;

public class IsbnEditor extends PropertyEditorSupport {
  @Override
  public void setAsText(String text) throws IllegalArgumentException {
    if (StringUtils.hasText(text)) {
      setValue(new Isbn(text.trim()));
    } else {
      setValue(null);
    }
  }
  @Override  public String getAsText() {
    Isbn isbn = (Isbn) getValue();
    if (isbn != null) {
      return isbn.getIsbn();
    } else {
      return "";
    }
  }
}

在BookController中增加initBinder函數(shù)，通過(guò)@InitBinder注解修飾，則可以針對(duì)每個(gè)web請(qǐng)求創(chuàng)建一個(gè)editor實(shí)例。

@InitBinderpublic 
void initBinder(WebDataBinder binder) {
  binder.registerCustomEditor(Isbn.class, new IsbnEditor());
}

修改BookController中對(duì)應(yīng)的函數(shù)

@RequestMapping(value = "/{isbn}", method = RequestMethod.GET)
public Map<String, Object> getBook(@PathVariable Isbn isbn) {
  Book book = bookRepository.findBookByIsbn(isbn.getIsbn());
  Map<String, Object> response = new LinkedHashMap<>();
  response.put("message", "get book with isbn(" + isbn.getIsbn() +")");
  response.put("book", book);  return response;
}

運(yùn)行程序，通過(guò)Httpie訪問(wèn)http localhost:8080/books/9781-1234-1111，可以得到正常結(jié)果，跟之前用String表示isbn時(shí)沒(méi)什么不同，說(shuō)明我們編寫(xiě)的IsbnEditor已經(jīng)起作用了。

分析

Spring提供了很多默認(rèn)的editor，我們也可以通過(guò)繼承PropertyEditorSupport實(shí)現(xiàn)自己定制化的editor。

由于ProperteyEditor是非線程安全的。通過(guò)@InitBinder注解修飾的initBinder函數(shù)，會(huì)為每個(gè)web請(qǐng)求初始化一個(gè)editor實(shí)例，并通過(guò)WebDataBinder對(duì)象注冊(cè)。

最新評(píng)論