先談表單資料的收集。用 jQuery 取值確實簡單,$("#xxx").val() 就搞定了。但如果一張表單有幾十個欄位,而且這種表單又有好幾張,一個一個寫簡直是惡夢,還很容易看錯、填錯 id。
比較好的做法是訂一套收集規則:在需要回傳給伺服器的控制項上打個標記,取值時把有標記的一起跑。
以最簡單的文字輸入為例:
<input type="text" id="txtcode" name="txtcode" datafield="Code" style="width: 200px" />
這裡多加了一個 datafield 屬性,值就是對應伺服器類別的屬性名稱。有了這個標記,前端取值就好辦了。
getFormData: function (formid) {
var data = {};
$("#" + formid + " input[type=text]").each(function (i, o) {
var jo = $(o);
if (jo.attr("datafield")) {
var str = jo.val();
str = str.replace(" ", "");
if (str !== "") {
data[jo.attr("datafield")] = jo.val();
}
}
});
return data;
}
這段做的事很單純:把表單內所有 text 類型、且有 datafield 標記的欄位收集到一個物件裡。其他控制項(select、checkbox、radio)的原理相同,只是取值方式要換成 val()、prop("checked") 等。
var save = function (sender) {
$(sender).prop("disabled", true); // 禁用按鈕,避免重複送出
var data = getFormData("form1");
var jsonobj = { jsondata: data };
var textdata = JSON.stringify(jsonobj);
$.ajax({
type: "POST",
contentType: "application/json; charset=utf-8",
url: "xxxxx.aspx/Save",
dataType: "json",
data: textdata,
success: function (msg) {
if (msg.d == "1") {
document.form1.reset();
alert("保存成功!");
} else if (msg.d == "0") {
alert("保存失敗!");
}
},
complete: function (jqXHR, textStatus) {
$(sender).prop("disabled", false); // 還原按鈕
}
});
};
xxxxx.aspx/Save 就是處理的端點,背後是一個 WebMethod。這裡順手做了防連點:請求期間禁用按鈕,在 complete 中復原——因為 complete 不論成功失敗都會執行,比寫在 success 裡更周全。
用 JSON.stringify() 統一把物件轉成 JSON 字串的好處是:不必自己操心 JSON 的格式細節(引號、逗號、轉义),乾淨又不容易出錯。
前端送來的 key 不可能涵蓋某個資料類別的所有屬性,而且類別有很多個——到底該對應哪一類,只有後端知道。所以需要一個通用的轉換輔助類。
但問題來了:難道要為每一個類別各寫一個方法?那維護起來是場災難。與其如此,不如分析資料的本質。
前端傳來的是一組鍵值對、key 不會重複——這在 C# 裡就等同於 IDictionary<string, string>。而這個字典的 key 可以看做目標類別「屬性集合的子集」,value 則是各屬性 ToString() 後的子集。至於目標類別究竟是什麼、有哪些屬性?到具體的處理方法裡才知道。那就用泛型解決。
屬性集合怎麼取?反射。
/// <summary>
/// 依字典內容更新/建立物件
/// </summary>
public static T1 UpdateObjectByDic<T1>(T1 scrobj, IDictionary<string, string> sourceobject,
bool ignoreCase) where T1 : new()
{
T1 result = scrobj;
PropertyInfo[] pifresults = typeof(T1).GetProperties();
foreach (var dic in sourceobject)
{
foreach (PropertyInfo pifresult in pifresults)
{
if (string.Compare(dic.Key, pifresult.Name, ignoreCase) == 0)
{
pifresult.SetValue(result, ChangeType(dic.Value, pifresult.PropertyType), null);
break;
}
}
}
return result;
}
/// <summary>
/// 型別轉換,额外處理 Nullable
/// </summary>
public static Object ChangeType(object value, Type targetType)
{
Type convertType = targetType;
if (targetType.IsGenericType
&& targetType.GetGenericTypeDefinition().Equals(typeof(Nullable<>)))
{
NullableConverter nullableConverter = new NullableConverter(targetType);
convertType = nullableConverter.UnderlyingType;
}
return Convert.ChangeType(value, convertType);
}
這裡的 T1 scrobj 把「新增」與「更新」合在一起處理:新增時傳一個 new 出來的空物件,更新時把原資料傳進來。
ChangeType() 是順手處理的補充:資料類別裡有些屬性是 nullable 的(int?、DateTime? 等),直接用 Convert.ChangeType 會拋出例外,所以先用 NullableConverter 取出底層型別再轉。
ignoreCase 則決定屬性名稱比對是否忽略大小寫。一般來說應該忽略,否則前端 datafield 大小寫稍有出入就會靜默失敗。
[WebMethod(EnableSession = true)]
public static string Save(Dictionary<string, string> jsondata)
{
string result = "0";
Model.Project pro = ConvertHandle.UpdateObjectByDic<Model.Project>(
jsondata, new Model.Project(), true);
pro.CreatorID = BLL.Sys_User.GetCurUser().ID.ToString();
pro.CreatorName = BLL.Sys_User.GetCurUser().Name;
prohandle.Insert(pro);
result = "1";
return result;
}
prohandle.Insert(pro) 把物件存進資料庫;CreatorID 與 CreatorName 是伺服器端從 session 補上的資訊,不該由前端決定——這點很重要,建立者身分若讓前端傳入,等於讓使用者可以偽造。
用反射加泛型做通用映射,確實省下了為每個類別各寫一套方法的工作,在內部管理後台這類欄位多、變動频繁的場景相當實用。
但它有兩個必須留意的代價。
效能。反射比直接屬性赋值慢,且每次呼叫都要走一輪 GetProperties()。實務上可以把 PropertyInfo[] 依型別快取起來重複使用,或改用 Expression Tree 編譯成委派。對內部後台的低頻操作而言這通常不是問題,但在高頻路徑上要留意。
安全性——這點更關鍵。「把前端傳來的字典自動映射到物件的所有同名屬性」意味著批量赋值漏洞(Mass Assignment)。如果 Model.Project 裡有 IsAdmin、Status、Balance 這類不該由使用者決定的欄位,而表單上又剛好有同名的 datafield,攻擊者只要自行加入這個欄位並送出,就能改動它。
防禦方式是在映射時加上白名單:只允許出現在明確清單中的屬性被赋值,其餘一律忽略。實作上可以為屬性加上自訂的 [Editable] 標記,映射時檢查該標記是否存在。
另外,型別轉換失敗時 Convert.ChangeType 會拋出例外,目前沒有捕捉。使用者輸入非數字到數字欄位就會導致整批儲存失敗,實務上應逐欄收集錯誤訊息並回傳給前端。
這裡講的只是一個簡單思路。前端收集這件事,各家 js 框架早已內建更完善的機制;後端的物件映射,AutoMapper、Mapperly 等套件也有完整體系,還能解決效能與白名單問題。
強烈建議不要重複發明輪子。但更重要的是:要明白輪子的核心作用和原理。知道表單收集本質上是「把 DOM 狀態映射成資料結構」、物件映射本質上是「用中繼資料把一份鍵值對貼到另一個結構上」,你就能判斷什麼時候該用現成套件、什麼時候簡單幾行就夠,以及最重要的——套件的預設行為會不會替你把不該開的門打開。