ORM鏈式操作的字段過濾&為什么GoFrame不支持migrate功能?
初學者必須搞懂:
在 Go 中,沒有null、none、NULL、None
任何類型在未初始化時都對應一個零值:布爾類型是 false ,整型是 0 ,字符串是 ""
而指針,函數(shù),interface,slice,channel和map的零值都是 nil
結(jié)合場景,平衡利弊,做出取舍
下圖是一位讀者問我的問題,我翻遍了文檔也沒找到相關(guān)的資料,猜測應該是不支持的。
于是問了goframe作者,被明確告知:goframe不支持,并且以后也不會支持。
作者也詳細解答了不支持的原因,goframe作者團隊的考慮是這樣的:
因為我做的項目比較多,在數(shù)據(jù)庫表結(jié)構(gòu)管理方面踩過坑。還是比較能接受goframe作者觀點的。
migrate這種功能確實能方便開發(fā)者,但是在企業(yè)級項目中,尤其是TOB的業(yè)務,穩(wěn)定是第一要務。migrate功能雖然方便,但是不夠嚴謹,如果沒有很強的規(guī)范去約束團隊成員的使用,很容易出問題,出了問題就不是小問題,所以不敢用。
這也讓我想起了另外一件事情:
前段時間在review代碼時,發(fā)現(xiàn)了一個“無條件”的刪除腳本在運行,心頭一驚啊!這要是把數(shù)據(jù)刪了可麻煩了。但是查詢DB發(fā)現(xiàn)沒有刪除數(shù)據(jù)。
我詳細查了官方文檔,沒有被刪數(shù)據(jù)的原因是這樣的:
goframe是一款用于企業(yè)生產(chǎn)級別的框架,各個模塊設(shè)計嚴謹,工程實踐的細節(jié)處理得比較好。為安全性保證、防止誤操作,Update及Delete方法必須帶有Where條件才能提交執(zhí)行,否則將會錯誤返回,錯誤信息如:there should be WHERE condition statement for XXX operation。
好吧,感謝,真是救我狗命了,哈哈。
也正是因為自己做了很多項目,踩了很多坑,碰到了不少這種細節(jié)問題。
目前才有了“從追求開發(fā)效率”到“追求項目穩(wěn)定性”的轉(zhuǎn)變。
在這里也回答一下最近大家私信我的問題吧:“為什么我使用goframe框架做這個電商實戰(zhàn)項目?”
原因很簡單,我結(jié)合自己的經(jīng)歷,覺得GoFrame是一個適合企業(yè)級項目比較嚴謹?shù)目蚣?,能少踩坑,避免一些麻煩。雖然入門門檻是有的,但是在“工程化開發(fā)設(shè)計”的規(guī)范下,后續(xù)的維護成本還是比較低的。所以才帶大家使用這個框架做電商項目的。
好了,不同的場景,不同的項目有不同的解決方案,不同的優(yōu)選框架。這個問題沒有標準答案,結(jié)合自己的需求去選擇合適的解決方案吧。
歡迎大家找我交流,多提像這位讀者一樣有價值的問題,一起進步!
Fields/FieldsEx字段過濾
Fields 用于指定需要操作的表字段,包括查詢字段、寫入字段、更新字段等過濾;
FieldsEx 用于例外的字段指定,可用于查詢字段、寫入字段、更新字段等過濾;
?Fields??示例
假如user?表有4個字段uid?, nickname?, passport?, password。
查詢字段過濾
寫入字段過濾
?FieldsEx??示例
1.假如user?表有4個字段uid?, nickname?, passport?, password。
2.查詢字段排除
3.寫入字段排除
OmitEmpty空值過濾
當 map/struct? 中存在空值如 nil,"",0? 時,默認情況下,gdb?將會將其當做正常的輸入?yún)?shù),因此這些參數(shù)也會被更新到數(shù)據(jù)表。OmitEmpty特性可以在將數(shù)據(jù)寫入到數(shù)據(jù)庫之前過濾空值數(shù)據(jù)的字段。
相關(guān)方法:
OmitEmpty?方法會同時過濾Where及Data?中的空值數(shù)據(jù),而通過OmitEmptyWhere/OmitEmptyData方法可以執(zhí)行特定的字段過濾。
寫入/更新操作
空值會影響于寫入/更新操作方法,如Insert?, Replace?, Update?, Save?操作。如以下操作(以map?為例,struct同理):
針對空值情況,我們可以通過OmitEmpty方法來過濾掉這些空值。例如,以上示例可以修改為:
對于struct數(shù)據(jù)參數(shù),我們也可以進行空值過濾。操作示例:
注意喲,批量寫入/更新操作中OmitEmpty方法將會失效,因為在批量操作中,必須保證每個寫入記錄的字段是統(tǒng)一的。
關(guān)于omitempty?標簽與OmitEmpty方法:
針對于struct?的空值過濾大家會想到omitempty?的標簽。該標簽常用于json?轉(zhuǎn)換的空值過濾,也在某一些第三方的ORM?庫中用作struct到數(shù)據(jù)表字段的空值過濾,即當屬性為空值時不做轉(zhuǎn)換。
omitempty?標簽與OmitEmpty?方法所達到的效果是一樣的。在ORM?操作中,我們不建議對struct?使用omitempty?的標簽來控制字段的空值過濾,而建議使用OmitEmpty?方法來做控制。因為該標簽一旦加上之后便綁定到了struct?上,沒有辦法做靈活控制;而通過OmitEmpty?方法使得開發(fā)者可以選擇性地、根據(jù)業(yè)務場景對struct做空值過濾,操作更加靈活。
數(shù)據(jù)查詢操作
空值也會影響數(shù)據(jù)查詢操作,主要是影響where?條件參數(shù)。我們可以通過OmitEmpty方法過濾條件參數(shù)中的空值。
使用示例:
OmitNil空值過濾
當 map/struct? 中存在空值如 nil?時,默認情況下,gdb?將會將其當做正常的輸入?yún)?shù),因此這些參數(shù)也會被更新到數(shù)據(jù)表。OmitNil?特性可以在將數(shù)據(jù)寫入到數(shù)據(jù)庫之前過濾空值數(shù)據(jù)的字段。與OmitEmpty?特性的區(qū)別在于,OmitNil?只會過濾值為nil?的空值字段,其他空值如"",0并不會被過濾。
相關(guān)方法:
OmitNil?方法會同時過濾Where及Data?中的空值數(shù)據(jù),而通過OmitNilWhere/OmitNilData方法可以執(zhí)行特定的字段過濾。
Filter字段過濾(已內(nèi)置)
gdb?可以自動同步數(shù)據(jù)表結(jié)構(gòu)到程序緩存中(緩存不過期,直至程序重啟/重新部署),并且可以過濾提交參數(shù)中不符合表結(jié)構(gòu)的數(shù)據(jù)項,該特性可以使用Filter?方法實現(xiàn)。常用于新增/刪除操作中輸入map/struct/[]map/[]string參數(shù)類型的場景。
使用示例,假如user?表有4個字段uid?, nickname?, passport?, password:
其中id為不存在的字段,在寫入數(shù)據(jù)時將會被過濾掉,不至于被構(gòu)造成寫入SQL中產(chǎn)生執(zhí)行錯誤。
數(shù)據(jù)庫沒有設(shè)計為Data?方法做自動過濾,而是需要開發(fā)者調(diào)用Filter方法來手動指定過濾,目的是友好地提醒開發(fā)者可能誤寫/傳遞錯誤了字段名稱。如果強制性的自動過濾可能會引起難以預料的業(yè)務邏輯異常,例如,由于字段名稱拼寫錯誤導致自動過濾了本來需要輸入的字段,導致寫入數(shù)據(jù)庫的數(shù)據(jù)不完整。
從GoFrame v1.15.7?版本開始,根據(jù)社區(qū)整體反饋,為提高組件易用性,filter?特性被設(shè)置為默認開啟,不再需要顯示調(diào)用,F(xiàn)ilter方法已被標記廢棄。
本文轉(zhuǎn)載自微信公眾號「 程序員升級打怪之旅」,作者「王中陽Go」,可以通過以下二維碼關(guān)注。
轉(zhuǎn)載本文請聯(lián)系「 程序員升級打怪之旅」公眾號。