寫 Ext 表單時常會遇到這樣的需求:表單上有兩個 textfield,一個 name 為 company,另一個放姓名;使用者填完(例如第一格填 bill、第二格填 Microsoft)之後按下 submit,但你其實並不想真的把資料送到某個頁面,只想拿到一個物件變數,形如:
{name: "bill", company: "microsoft"}
翻了半天手冊,沒找到 formPanel 本身提供這樣的方法,於是有人直接在論壇上求助。
直覺的做法或許是為每個 textfield 設 id,再用 Ext.getCmp(id).getValue() 逐格取值。但實務上這個方案很醜:表單裡的 textfield 一多,重複程式碼就等比膨脹。而且如果頁面是動態載入、又沒有 iframe 隔離,能不設 id 就不設,免得和別人寫的部分撞名。
更麻煩的是,為了排版(例如 column 對齊),formPanel 裡往往套了好幾層 items,靠子項 index 取值既繁瑣又容易出錯。
比較務實的方向是改用表單本身的序列化能力,一次把整組欄位收成物件,而不是逐格取。Ext 的 BasicForm 提供了 getValues() 這類方法,可以直接取得以欄位 name 為索引的鍵值集合;需要字串時再用編碼工具轉成 JSON 字串傳到後端。這樣不必為每個欄位設 id,也不怕與其他開發者的命名衝突。
另一個 frequent visitor 是「某屬性序列化 JSON 時出錯」。原因通常是:Struts2 的 Action 在轉換成 JSON 時,會把所有提供了 getter 的屬性一律序列化輸出到客戶端。有些屬性並不需要這樣處理,例如用 Spring 注入的 recordService——它同時具備 getter 與 setter,卻完全不該出現在 JSON 裡。
解法是在該屬性的 getter 前面加上註解,明確排除序列化:
@JSON(serialize = false)
至於客戶端拿到 JSON 之後怎麼用,下面這段小程式示範了嵌套結構的存取與修改:
function showJSON() {
var user = {
"username": "andy",
"age": 20,
"info": { "tel": "123456", "cellphone": "98765" },
"address": [
{ "city": "beijing", "postcode": "222333" },
{ "city": "newyork", "postcode": "555666" }
]
};
alert(user.username);
alert(user.age);
alert(user.info.cellphone);
alert(user.address[0].city);
alert(user.address[0].postcode);
user.username = "Tom";
alert(user.username);
}
重點在於:JSON 一旦成為 JavaScript 物件,存取就只是普通的屬性與索引操作,不需要任何額外解析器。這正是它比 XML DOM 輕巧的地方。