面向?qū)ο蟮木幊谭绞綐O大地方便了程序員在管理數(shù)據(jù)上所花費(fèi)的精力。在基于Spring MVC的Web開發(fā)過程當(dāng)中,可以通過對(duì)象映射的方式來管理表單提交上來的數(shù)據(jù),而不用去一個(gè)一個(gè)地從request中提取出來。另外,這一功能還支持基本數(shù)據(jù)類型的映射。例如in、long、float等等。這樣我們就能從傳統(tǒng)單一的String類型中解脫出來。然而,應(yīng)用是靈活的。我們對(duì)數(shù)據(jù)的需求是千變?nèi)f化的。有些時(shí)候我們需要對(duì)表單的數(shù)據(jù)進(jìn)行兼容處理。
例如日期格式的兼容:
中國(guó)的日期標(biāo)注習(xí)慣采用yyyy-MM-dd格式,歐美習(xí)慣采用MM/dd/yyyy。雖然兩種格式都是日期的標(biāo)注方法,但是往往我們要想達(dá)到兼容的目的必須做繁瑣的轉(zhuǎn)換。
例如價(jià)格的兼容:
價(jià)格無非就是一串?dāng)?shù)字,我們經(jīng)常用的就是0.00這種表達(dá)形式,而對(duì)于金額較大的價(jià)格我們還習(xí)慣采用0,000.00這樣帶有逗號(hào)分隔的價(jià)格表述形式。
其實(shí)Spring MVC中已經(jīng)考慮到了這個(gè)問題,在Controller中可以在初始化綁定的時(shí)候注冊(cè)一個(gè)編輯器。當(dāng)表單提交過來的數(shù)據(jù)映射到某一特定類型(甚至是特定參數(shù))時(shí)可以按照自定義的方法進(jìn)行轉(zhuǎn)換。(除二進(jìn)制方式傳輸過來的數(shù)據(jù)以外,通常我們認(rèn)為所有傳過來的參數(shù)不論是什么內(nèi)容,一律認(rèn)為是字符串)
下面我虛構(gòu)了一個(gè)需求:
我有一個(gè)表單,里面需要填寫用戶名、生日和積分。這分別代表了String類型、Date類型和Long類型。下面是表單內(nèi)容:
<form action="getObj.do" method="post">
<table>
<tr>
<td>用戶名:</td>
<td><input type="text" name="userName" value="Name Test" /></td>
<td>*普通字符串</td>
</tr>
<tr>
<td>生日:</td>
<td><input type="text" name="birthday" value="2013-3-7" /></td>
<td>*支持格式: yyyy-MM-dd 或 MM/dd/yyyy</td>
</tr>
<tr>
<td>積分:</td>
<td><input type="text" name="score" value="1,000" /></td>
<td>*支持純數(shù)字或帶逗號(hào)分隔的數(shù)字</td>
</tr>
<tr>
<td colspan="3"><input type="submit" value="提交" /></td>
</tr>
</table>
</form>
這里根據(jù)表單,我們映射了如下的一個(gè)表單對(duì)象,這里對(duì)象的屬性名稱要和上面表單的字段name一致:
package blog.csdn.net.chaijunkun.formObjs;
import java.util.Date;
public class UserInfo {
private String userName;
private Date birthday;
private Long score;
//getters and setters...
}
那么我們想接收這樣一個(gè)表單數(shù)據(jù),可以寫一個(gè)對(duì)表單處理的方法:
package blog.csdn.net.chaijunkun.controller;
import java.util.Map;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.log4j.Logger;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import blog.csdn.net.chaijunkun.formObjs.UserInfo;
@Controller
public class ObjController {
private static Logger logger= Logger.getLogger(ObjController.class);
public ObjController(){
logger.info("對(duì)象映射控制器初始化");
}
@RequestMapping(value="/getObj.do")
public String modifyUser(HttpServletRequest request,
HttpServletResponse response,Map<String, Object> model,
UserInfo userInfo){
logger.info("收集對(duì)象信息");
model.put("userInfo", userInfo);
return "user";
}
}
如果僅僅是這么寫,當(dāng)然還不能做到多格式兼容。我們需要寫一個(gè)針對(duì)日期和Long型的格式兼容編輯器。編輯器需要至少繼承自類:java.beans.PropertyEditorSupport。當(dāng)然,也可以繼承Spring內(nèi)置的一些編輯器,例如:org.springframework.beans.propertyeditors.CustomNumberEditor,這個(gè)是專門用來處理數(shù)字轉(zhuǎn)換的。無論是繼承哪一個(gè),方法都是一樣的:
第一步:重寫公有的void setAsText(String text)方法;
第二步:將轉(zhuǎn)換好的數(shù)據(jù)調(diào)用setValue(Object obj)進(jìn)行寫入。
下面我們先實(shí)現(xiàn)一個(gè)日期兼容的編輯器:
package blog.csdn.net.chaijunkun.editors;
import java.beans.PropertyEditorSupport;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
public class MyDateEditor extends PropertyEditorSupport {
@Override
/**
* text是表單傳入的數(shù)據(jù)內(nèi)容
*/
public void setAsText(String text){
Date value= null;
SimpleDateFormat sdf= new SimpleDateFormat();
sdf.applyPattern("yyyy-MM-dd");
try{
value= sdf.parse(text);
}catch(ParseException e1){
sdf.applyPattern("MM/dd/yyyy");
try {
value= sdf.parse(text);
} catch (ParseException e2) {
value= null;
}
}
//這一步將轉(zhuǎn)換好的數(shù)據(jù)寫入到對(duì)象映射的屬性中
setValue(value);
}
}
然后我們?cè)賮韺懸粋€(gè)針對(duì)Long型的編輯器,可以支持帶逗號(hào)分隔和不帶逗號(hào)分隔的數(shù)值表達(dá)形式:
package blog.csdn.net.chaijunkun.editors;
import org.springframework.beans.propertyeditors.CustomNumberEditor;
public class MyLongEditor extends CustomNumberEditor {
public MyLongEditor(){
super(Long.class, true);
}
@Override
public void setAsText(String text){
if ((text== null) || text.trim().equals("")){
setValue(null);
}else{
Long value= null;
try{
//按照標(biāo)準(zhǔn)的數(shù)字格式嘗試轉(zhuǎn)換
value= Long.parseLong(text);
}catch(NumberFormatException e){
//嘗試去除逗號(hào) 然后再轉(zhuǎn)換
text= text.replace(",", "");
value= Long.parseLong(text);
}
//轉(zhuǎn)好之后將值返給被映射的屬性
setValue(value);
}
}
}
好了,這兩個(gè)編輯器寫好了,如何讓它們發(fā)揮作用呢?這需要在Controller內(nèi)加一個(gè)數(shù)據(jù)轉(zhuǎn)換時(shí)的綁定方法:
@InitBinder
public void initBinder(HttpServletRequest request, ServletRequestDataBinder binder){
binder.registerCustomEditor(Date.class, new MyDateEditor());
binder.registerCustomEditor(Long.class, new MyLongEditor());
}
上面的代碼作用就是:當(dāng)接收到表單數(shù)據(jù),Spring發(fā)現(xiàn)參數(shù)名能夠與對(duì)象屬性相對(duì)應(yīng),而轉(zhuǎn)換的類型恰好也是在上述代碼中注冊(cè)過的類似,則會(huì)將數(shù)據(jù)內(nèi)容按照指定的編輯器來做轉(zhuǎn)換。
我們來試一下:
如下圖所示:
同樣,數(shù)據(jù)被正確識(shí)別了。
通過以上方法,我們成功地兼容了多種數(shù)據(jù)格式。
寫在后面:
其實(shí)針對(duì)日期格式,我開始的時(shí)候想寫成下面代碼那樣來實(shí)現(xiàn)兼容:
@InitBinder
public void initBinder(HttpServletRequest request, ServletRequestDataBinder binder){
binder.registerCustomEditor(Date.class, new CustomDateEditor(new SimpleDateFormat("yyyy-MM-dd"), true));
binder.registerCustomEditor(Date.class, new CustomDateEditor(new SimpleDateFormat("MM/dd/yyyy"), true));
}
后來我發(fā)現(xiàn),這樣寫之后只支持MM/dd/yyyy格式的日期,提交yyyy-MM-dd格式的日期后會(huì)拋出異常。看來,對(duì)于同一類型,在一個(gè)控制器里只能注冊(cè)一個(gè)編輯器,而且是最后一個(gè)被注冊(cè)的才起作用。
另外,在文章剛開始的時(shí)候?qū)懙剑粌H可以按類型,甚至是某一類型的某個(gè)屬性都可以按照自己的要求定制編輯器,同時(shí)不影響其它同類型的屬性。這個(gè)很容易,在registerCustomEditor方法中還有一個(gè)重載的方法,第二個(gè)參數(shù)可以指定具體的屬性名稱。這樣就很容易控制細(xì)粒度了。