快捷導(dǎo)航

Go使用XORM操作MySQL的陷阱盤點(diǎn)分析

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

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

使用 XORM 操作 MySQL 的陷阱

雖然使用 ORM 操作 MySQL 比直接使用標(biāo)準(zhǔn)庫(kù) `sql`[1] 和三方 MySQL 數(shù)據(jù)庫(kù)驅(qū)動(dòng)包[2]操作 MySQL 更加方便，但是也會(huì)遇到一些陷阱。

類型零值

在 Golang 中，每個(gè)數(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，因?yàn)?nbsp;0 是 int 的類型零值，XORM 的 Update 方法會(huì)自動(dòng)忽略類型零值，所以該數(shù)據(jù) view 字段的值沒有更改。

但是，在實(shí)際項(xiàng)目開發(fā)中，我們可能需要將某個(gè)字段的值更新為該字段類型的類型零值，此時(shí)我們?cè)撛趺床僮髂兀?/p>

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

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

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

自增 id

在插入數(shù)據(jù)時(shí)，我們可能需要返回自增 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ù)，返回結(jié)果是影響行數(shù)和錯(cuò)誤信息，而不是直接返回該條數(shù)據(jù)的自增 id。

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

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

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

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

更新 created 字段

我們?cè)诮Y(jié)構(gòu)體中，使用標(biāo)簽 xorm:created 和 xorm:updated 即可自動(dòng)插入當(dāng)前時(shí)間。

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

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

// 更改數(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 標(biāo)簽的字段的值被更改，而使用 xorm:created 標(biāo)簽的字段的值沒被更改。

我們換一種更新數(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 可以滿足我們的需求。