如何使用ORM鏈?zhǔn)讲僮?如何優(yōu)雅的實現(xiàn)軟刪除？

作者：王中陽Go 2022-11-15 07:50:47

在執(zhí)行Insert/InsertIgnore/BatchInsert/BatchInsertIgnore?方法時自動寫入該時間，在執(zhí)行Save/Update?時更新該時間（注意當(dāng)寫入數(shù)據(jù)存在時會更新updated_at?時間，不會更新created_at時間）。

?ORM鏈?zhǔn)讲僮?時間維護(hù)

需要注意，該特性僅對鏈?zhǔn)讲僮饔行А?/p>

gdb模塊支持對數(shù)據(jù)記錄的寫入、更新、刪除時間自動填充，提高開發(fā)維護(hù)效率。為了便于時間字段名稱、類型的統(tǒng)一維護(hù)，如果使用該特性，我們約定：

字段應(yīng)當(dāng)設(shè)置允許值為null。
字段的類型必須為時間類型，如:date?, datetime?, timestamp?。不支持?jǐn)?shù)字類型字段，如int。
字段的名稱不支持自定義設(shè)置，并且固定名稱約定為：

created_at用于保存記錄的創(chuàng)建時間，僅會寫入一次。

updated_at用于保存記錄的修改時間，每次記錄變更時更新。

deleted_at用于保存記錄的軟刪除特性，只有當(dāng)記錄刪除時會寫入一次。

字段名稱其實不區(qū)分大小寫，也會忽略特殊字符，例如CreatedAt?, UpdatedAt?, DeletedAt?也是支持的。此外，時間字段名稱可以通過配置文件進(jìn)行自定義修改，并可使用TimeMaintainDisabled配置完整關(guān)閉該特性，具體請參考 ORM使用配置章節(jié)。

對時間類型的固定其實是為了形成一種規(guī)范。

特性的啟用

當(dāng)數(shù)據(jù)表包含created_at、updated_at、deleted_at任意一個或多個字段時，該特性自動啟用。

以下的示例中，我們默認(rèn)示例中的數(shù)據(jù)表均包含了這3個字段。

?created_at??寫入時間

在執(zhí)行Insert/InsertIgnore/BatchInsert/BatchInsertIgnore方法時自動寫入該時間，隨后保持不變。

// INSERT INTO `user`(`name`,`created_at`,`updated_at`) VALUES('john', `2020-06-06 21:00:00`, `2020-06-06 21:00:00`)
g.Model("user").Data(g.Map{"name": "john"}).Insert()

// INSERT IGNORE INTO `user`(`uid`,`name`,`created_at`,`updated_at`) VALUES(10000,'john', `2020-06-06 21:00:00`, `2020-06-06 21:00:00`)
g.Model("user").Data(g.Map{"uid": 10000, "name": "john"}).InsertIgnore()

// REPLACE INTO `user`(`uid`,`name`,`created_at`,`updated_at`) VALUES(10000,'john', `2020-06-06 21:00:00`, `2020-06-06 21:00:00`)
g.Model("user").Data(g.Map{"uid": 10000, "name": "john"}).Replace()

// INSERT INTO `user`(`uid`,`name`,`created_at`,`updated_at`) VALUES(10001,'john', `2020-06-06 21:00:00`, `2020-06-06 21:00:00`) ON DUPLICATE KEY UPDATE `uid`=VALUES(`uid`),`name`=VALUES(`name`),`updated_at`=VALUES(`updated_at`)
g.Model("user").Data(g.Map{"uid": 10001, "name": "john"}).Save()

需要注意的是Replace方法也會更新該字段，因為該操作相當(dāng)于刪除已存在的舊數(shù)據(jù)并重新寫一條數(shù)據(jù)。

?updated_at??更新時間

// UPDATE `user` SET `name`='john guo',`updated_at`='2020-06-06 21:00:00' WHERE name='john'
g.Model("user").Data(g.Map{"name" : "john guo"}).Where("name", "john").Update()

// UPDATE `user` SET `status`=1,`updated_at`='2020-06-06 21:00:00' ORDER BY `login_time` asc LIMIT 10
g.Model("user").Data("status", 1).Order("login_time asc").Limit(10).Update()

// INSERT INTO `user`(`id`,`name`,`update_at`) VALUES(1,'john guo','2020-12-29 20:16:14') ON DUPLICATE KEY UPDATE `id`=VALUES(`id`),`name`=VALUES(`name`),`update_at`=VALUES(`update_at`)
g.Model("user").Data(g.Map{"id": 1, "name": "john guo"}).Save()

需要注意的是Replace方法也會更新該字段，因為該操作相當(dāng)于刪除已存在的舊數(shù)據(jù)并重新寫一條數(shù)據(jù)。

?deleted_at??數(shù)據(jù)軟刪除

軟刪除會稍微比較復(fù)雜一些，當(dāng)軟刪除存在時，所有的查詢語句都將會自動加上deleted_at的條件。

// UPDATE `user` SET `deleted_at`='2020-06-06 21:00:00' WHERE uid=10
g.Model("user").Where("uid", 10).Delete()

查詢的時候會發(fā)生一些變化，例如：

// SELECT * FROM `user` WHERE uid>1 AND `deleted_at` IS NULL
g.Model("user").Where("uid>?", 1).All()

可以看到當(dāng)數(shù)據(jù)表中存在deleted_at?字段時，所有涉及到該表的查詢操作都將自動加上deleted_at IS NULL的條件

聯(lián)表查詢的場景

如果關(guān)聯(lián)查詢的幾個表都啟用了軟刪除特性時，會發(fā)生以下這種情況，即條件語句中會增加所有相關(guān)表的軟刪除時間判斷。

// SELECT * FROM `user` AS `u` LEFT JOIN `user_detail` AS `ud` ON (ud.uid=u.uid) WHERE u.uid=10 AND `u`.`deleted_at` IS NULL AND `ud`.`deleteat` IS NULL LIMIT 1
g.Model("user", "u").LeftJoin("user_detail", "ud", "ud.uid=u.uid").Where("u.uid", 10).One()

Unscoped忽略時間特性

Unscoped?用于在鏈?zhǔn)讲僮髦泻雎宰詣訒r間更新特性，例如上面的示例，加上Unscoped方法后：

// SELECT * FROM `user` WHERE uid>1
g.Model("user").Unscoped().Where("uid>?", 1).All()

// SELECT * FROM `user` AS `u` LEFT JOIN `user_detail` AS `ud` ON (ud.uid=u.uid) WHERE u.uid=10 LIMIT 1
g.Model("user", "u").LeftJoin("user_detail", "ud", "ud.uid=u.uid").Where("u.uid", 10).Unscoped().One()

以上內(nèi)容來源自官方文檔：https://goframe.org/pages/viewpage.action?pageId=1114139

軟刪除和物理刪除的區(qū)別

軟刪除也叫標(biāo)記刪除，通過字段標(biāo)記DB中的紀(jì)錄是否被刪除：

比如通過is_delete字段標(biāo)記，默認(rèn)為0，刪除時設(shè)置為1

或者和視頻內(nèi)容一樣，使用deleted_at字段標(biāo)記刪除的時間，默認(rèn)為null

物理刪除，就是直接將DB中的記錄刪掉

如何優(yōu)雅的實現(xiàn)軟刪除

如果你詳細(xì)看完了ORM鏈?zhǔn)讲僮?時間維護(hù)這部分內(nèi)容，想必心中一定有了答案。

結(jié)合商業(yè)項目需求，有哪些容易踩的坑？

一定要結(jié)合實際情況決定使用物理刪除還是軟刪除，下面的例子拋轉(zhuǎn)引玉：

1. 比如管理后臺刪除輪播圖這種操作建議使用軟刪除。因為可能出現(xiàn)誤操作的情況，軟刪除可以及時找回；而且輪播圖的數(shù)據(jù)往往不多，冗余保存也是沒有問題的。

2. 再比如用戶移除收藏文章的記錄，建議物理刪除。原因是收藏文章，取消收藏這類操作比較隨意，沒有任何風(fēng)險。再者這類數(shù)據(jù)量比較龐大，軟刪除沒有意義，反而會增加收藏操作的邏輯壓力和DB壓力。

本文轉(zhuǎn)載自微信公眾號「程序員升級打怪之旅」，作者「王中陽Go」，可以通過以下二維碼關(guān)注。

轉(zhuǎn)載本文請聯(lián)系「程序員升級打怪之旅」公眾號。

責(zé)任編輯：武曉燕來源：程序員升級打怪之旅

ORM 鏈?zhǔn)讲僮?/a>刪除

相似話題

前端
 29988內(nèi)容

開發(fā)工具
 7539內(nèi)容

測試
 549內(nèi)容

游戲開發(fā)
653內(nèi)容
全部話題

相關(guān)專題更多

戴爾在線研討會：從“模型驅(qū)動”到“數(shù)據(jù)驅(qū)動”的智算架構(gòu)創(chuàng)新

看懂惠普 ZBookX 移動工作站的設(shè)計美學(xué)與效能突破

2025-10-11 13:42:35

技術(shù)薈萃 | 親身體驗 | 交流盛宴

2025-04-23 08:49:09

我收藏的內(nèi)容

微博

QQ

微信

復(fù)制鏈接

微信掃碼分享