Go使用XORM操作MySQL的陷阱盤點分析

更新時間：2023年11月30日 11:26:58 作者：frank

在?Go?語言開發(fā)中,大家為了方便,通常會選擇使用?ORM?操作數(shù)據(jù)庫,比如使用?XORM?或?GORM?操作?MySQL,本文我們來介紹一下使用?XORM[3]?操作?MySQL?可能會遇到的陷阱

使用 XORM 操作 MySQL 的陷阱

雖然使用 ORM 操作 MySQL 比直接使用標準庫 `sql`[1] 和三方 MySQL 數(shù)據(jù)庫驅動包[2]操作 MySQL 更加方便，但是也會遇到一些陷阱。

類型零值

在 Golang 中，每個數(shù)據(jù)類型都有各自的類型零值，比如 int 的零值是 0，string 的零值是 ''等。

示例代碼：

package main
import (
 "fmt"
 _ "github.com/go-sql-driver/mysql"
 "xorm.io/xorm"
)
func main() {
 // 創(chuàng)建 Engine
 engine, err := xorm.NewEngine("mysql", "root:root@/example?charset=utf8")
 defer func() {
  err = engine.Close()
  if err != nil {
   fmt.Printf("engine close err=%v\n", err)
   return
  }
 }()
 if err != nil {
  fmt.Printf("init xorm engine fail, err=%v\n", err)
  return
 }
 // 更新數(shù)據(jù)
 example := &Example{
  Title: "go",
  View:  0,
 }
 condi := &Example{
  Id: 2,
 }
 affected, err := engine.Update(example, condi)
 if err != nil {
  fmt.Printf("Update err=%v\n", err)
  return
 }
 fmt.Printf("affected=%d\n", affected)
}
type Example struct {
 Id      int    `json:"id" form:"id"`
 Title   string `json:"title" form:"title"`
 View    int    `json:"view" form:"view"`
 Created int    `json:"created" form:"created" xorm:"created"`
 Updated int    `json:"updated" form:"updated" xorm:"updated"`
}

閱讀上面這段代碼，我們可以發(fā)現(xiàn)示例代碼中將 id=2 的數(shù)據(jù) view 字段更新為 0，因為 0 是 int 的類型零值，XORM 的 Update 方法會自動忽略類型零值，所以該數(shù)據(jù) view 字段的值沒有更改。

但是，在實際項目開發(fā)中，我們可能需要將某個字段的值更新為該字段類型的類型零值，此時我們該怎么操作呢？

affected, err := engine.Cols("title", "view").Update(example, condi)

我們可以使用 Cols() 方法，指定需要更新的字段，這樣即便需要更新字段的值是該字段類型的類型零值，也可以正常更改。

提示：建議在設計數(shù)據(jù)庫表時，字段的值盡量使用非類型零值。

自增 id

在插入數(shù)據(jù)時，我們可能需要返回自增 id，我們先看一段代碼：

// 插入數(shù)據(jù)
example := &Example{
  Title: "PHP",
  View:  90,
}
affected, err := engine.Insert(example)
if err != nil {
  fmt.Printf("Insert err=%v\n", err)
  return
}
fmt.Printf("affected=%v\n", affected)

閱讀上面這段代碼，我們插入一條數(shù)據(jù)，返回結果是影響行數(shù)和錯誤信息，而不是直接返回該條數(shù)據(jù)的自增 id。

可能有些讀者朋友們會接著使用查詢方法，查詢最新一條數(shù)據(jù)的 id，在并發(fā)請求數(shù)低的場景中，該方法是可以查到新插入數(shù)據(jù)的自增 id。

但是在并發(fā)請求數(shù)高的場景中，該方法查到的最新一條數(shù)據(jù)的 id，未必是我們剛插入的數(shù)據(jù)的自增 id。

id := example.Id
fmt.Printf("affected=%v || id=%d\n", affected, id)

閱讀上面這段代碼，我們想要獲取新插入數(shù)據(jù)的自增 id，直接 example.Id 即可獲取，但是前提條件是結構體中，id 字段使用 xorm:"autoincr" 標簽。

更新 created 字段

我們在結構體中，使用標簽 xorm:created 和 xorm:updated 即可自動插入當前時間。

但是，使用 xorm:created 標簽的字段，只有在第一次插入數(shù)據(jù)時寫入當前時間，此后將不再會更改；使用 xorm:updated 標簽的字段，在第一次插入數(shù)據(jù)時寫入當前時間，此后每次 Update 操作，時間都會更改。

如果我們的業(yè)務需求是需要更改使用 xorm:created 標簽的字段，可以做到嗎？

// 更改數(shù)據(jù)
example := &Example{
  Title: "JavaScript",
  View:  98,
}
condi := &Example{
  Id: 2,
}
affected, err := engine.Update(example, condi)
if err != nil {
  fmt.Printf("Update err=%v\n", err)
  return
}
fmt.Printf("affected=%d\n", affected)

閱讀上面這段代碼，我們發(fā)現(xiàn)執(zhí)行 Update 方法之后，使用 xorm:updated 標簽的字段的值被更改，而使用 xorm:created 標簽的字段的值沒被更改。

我們換一種更新數(shù)據(jù)的方式，代碼如下：

// 更改數(shù)據(jù)
sql := "UPDATE example SET title=?, view=?, created=? WHERE id=?"
res, err := engine.Exec(sql, "Python", 60, time.Now().Unix(), 2)
if err != nil {
  fmt.Printf("Update err=%v\n", err)
  return
}
affected, err := res.RowsAffected()
if err != nil {
  fmt.Printf("RowsAffected err=%v\n", err)
  return
}
fmt.Printf("affected=%d\n", affected)

閱讀上面這段代碼，我們可以發(fā)現(xiàn)使用 Exec 方法執(zhí)行原生 SQL 可以滿足我們的需求。