在golang中要实现对数据库的操作, 一个比较好用的方式就是使用XORM,xorm是一个简单而强大的Go语言ORM库,通过它可以使数据库操作非常简便。 在xorm里面,可以同时存在多个ORM引擎,一个ORM引擎称为Engine,一个Engine一般只对应一个数据库。

golang的连接池配置

这里初始化一个全局的xorm.Engine对象, xorm.Engine通过调用xorm.NewEngine生成在很多其他的API都需要传入该对象作为参数。 这里需要理解这里设定的3个参数的意义:

  • SetMaxIdleConns()
    设置连接池中的保持连接的最大连接数。默认也是0,表示连接池不会保持释放会连接池中的连接的连接状态:即当连接释放回到连接池的时候,连接将会被关闭。这会导致连接再连接池中频繁的关闭和创建。
  • SetMaxOpenConns()
    设置打开数据库的最大连接数,包含正在使用的连接和连接池的连接。如果你的函数调用需要申请一个连接,并且连接池已经没有了连接或者连接数达到了最大连接数。此时的函数调用将会被block,直到有可用的连接才会返回。设置这个值可以避免并发太高导致连接mysql出现too many connections的错误。该函数的默认设置是0,表示无限制。
  • SetConnMaxLifetime
    设置连接可以被使用的最长有效时间,如果过期,连接将被拒绝。
import (
	    "github.com/go-xorm/xorm"
)
type DBClient struct {
	      Engine *xorm.Engine
}
func NewDbClient(dbUrl string, dbMaxConns int, dbMaxIdleConns int, dbMaxOpenConns int) *DBClient {
	    dbClient.Engine, err := xorm.NewEngine("mysql", dbUrl)
	   dbClient.Engine.SetMaxConns(dbMaxConns)
	   dbClient.Engine.SetMaxIdleConns(dbMaxIdleConns)
	   dbClient.Engine.SetMaxOpenConns(dbMaxOpenConns)
	   return dbClient
}

事务的使用

// 事务处理
      sess:= engine.NewSession()
      defer sess.Close()
      if err := sess.Begin() ; err != nil {
             return errors.New("Fail to session begin")
      }
      if _, err := sess.Id(id1).Cols("blance").Update(account_1) ; err != nil {
             sess.Rollback()
             return errors.New("fail to update 1")
      }
      return sess.Commit()

update操作更新为default值

更新数据使用Update方法,Update方法的第一个参数为需要更新的内容,可以为一个结构体指针或者一个Map[string]interface{}类型。当传入的为结构体指针时,只有非空和0的field才会被作为更新的字段。当传入的为Map类型时,key为数据库Column的名字,value为要更新的内容。

user := new(User)
user.Name = “myname”
 user.Age = 0
 affected, err := engine.Id(id).Update(user)

这里需要注意,Update会自动从user结构体中提取非0和非nil得值作为需要更新的内容,因此,这里只有Name被更新, Age字段是不会被更新的, 如果需要更新Age值为0,则此种方法将无法实现,因此有两种选择:

  • 通过添加Cols函数指定需要更新结构体中的哪些值,未指定的将不更新,指定了的即使为0也会更新。
affected, err := engine.Id(id).Cols("age").Update(&user)
  • 通过传入map[string]interface{}来进行更新,但这时需要额外指定更新到哪个表,因为通过map是无法自动检测更新哪个表的。
affected, err := engine.Table(new(User)).Id(id).Update(map[string]interface{}{"age":0})

参考资料

常用的操作:
https://github.com/lunny/xorm/blob/master/docs/QuickStartEn.md#6更新数据

文档链接:
http://xorm.io/docs/