介绍

worm是一款不便易用的Go语言ORM库,worm具备应用简略,运行性能高,功能强大的特点。具体特色如下:

  • 通过Struct的Tag与数据库字段进行映射,让您免于常常拼写SQL的麻烦。
  • 反对Struct映射、原生SQL以及SQLBuilder三种模式来操作数据库,并且Struct映射、原生SQL以及SQLBuilder可混合应用。
  • Struct映射、SQL builder反对链式API,可应用Where, And, Or, ID, In, Limit, GroupBy, OrderBy, Having等函数结构查问条件。
  • 可通过Join、LeftJoin、RightJoin来进行数据库表之间的关联查问。
  • 反对事务反对,可在会话中开启事务,在事务中能够混用Struct映射、原生SQL以及SQL builder来操作数据库。
  • 反对预编译模式拜访数据库,会话开启预编译模式后,任何SQL都会应用缓存的Statement,能够晋升数据库拜访效率。
  • 反对应用数据库的读写拆散模式来拜访一组数据库。
  • 反对在Insert,Update,Delete,Get, Find操作中应用钩子办法。
  • 反对SQL日志的输入,并且可通过日志钩子自定义SQL日志的输入,日志钩子反对Context。
  • 可依据数据库主动生成库表对应的Model构造体。

目前worm反对的数据库有:mysql、postgres、sqlite、sqlserver。

代码获取

go get github.com/haming123/wego/worm

应用select办法指定字段

应用worm.Model().Update()办法来更新数据库时,则worm缺省会更新实体类对应的全副字段。若只心愿更新指定的字段,能够应用若Select办法指定须要更新的字段:

func demoModelUpdate() {    var user = User{Name:"name1", Age: 21, Created: time.Now()}    _, err := worm.Model(&user).Select("name", "age").ID(1).Update()    if err != nil{        log.Println(err)        return    }}//update users set name=?,age=? where id=?

基于编辑状态来更新数据库

Select办法尽管可能做到按需更新,然而若库表的字段比拟多,这种办法应用起来则比拟麻烦,也容易引起谬误(更新了不该更新的字段)。worm提供了一种基于编辑状态来更新数据库的办法:

  • 首先创立实体类
  • 接着Model对象,并将实体类指针传递给Model
  • 而后应用SetValue办法一一给字段赋值
  • 最初调用Update()办法更新数据库

    func demoModelUpdateX() {  var user = User{}  md := worm.Model(&user)  md.SetValue(&user.Name, "name2")  md.SetValue(&user.Age, 22)  _, err := md.ID(1).Update()  if err != nil{      log.Println(err)      return  }}//update users set name=?,age=? where id=?

    阐明:

  • 应用SetValue办法, 第一个参数必须是实体对象的字段的指针, 第二个对象的类型须要与字段类型统一。

通过Vo对象拜访数据库

更加无效的办法是通过Vo对象来拜访数据库。Vo对象只蕴含了须要应用的数据库字段,因而应用Vo对象来拜访数据库能够缩小数据库拜访的负载,并可能缩小数据更新时的谬误(只更新必要字段)。 例如:

type UserVo struct {    Id          int64           Name        string          Age         int64       }

阐明:

  • 通常Vo构造提的字段与Model构造体的字段保持一致,并且不须要字段标签(tag:db)
  • 若Vo构造提的字段与Model构造体的字段不统一, 须要实现:VoLoader接口或VoSaver接口

应用Vo增加数据库记录

有了Vo对象,您能够这样来查询数据库:

func insertUserVo() {    var vo = UserVo{Age: 33, Name: "demo3"}    id, err := worm.Model(&User{}).Insert(&vo)    if err != nil{        log.Error(err)        return    }    log.Debug(id)}//insert into user set name=?,age=?

应用Vo更新数据库记录

func insertUserVo() {    vo = UserVo{Age: 32, Name: "NameVo2"}    _, err := worm.Model(&User{}).Update(&vo)    if err != nil{        log.Error(err)        return    }}//update user set name=?,age=? where id=?

应用查问单条记录到Vo

func demoGetVo() {    var vo UserVo    _, err := dbs.Model(&User{}).Where("id=?", 1).Get(&vo)    if err != nil{        log.Error(err)        return    }}//select id,name,age from user where id=1 limit 1

应用查问多条记录到Vo数组

func demoFindUserVo() {    var arrvo []UserVo    err := worm.Model(&User{}).WhereIn("id>?", 0).Find(&arrvo)    if err != nil{        log.Error(err)        return    }}//select id,name,age from user where id>?

应用VoLoader接口定义Vo数据查问逻辑

worm通过字段的名称+字段的类型把Vo对象与Model对象进行映射来抉择Model的字段。若Vo对象与Model对象的字段名称不雷同,您可为Vo对象实现VoLoader接口,VoLoader接口用于定义Vo如何从Model对象获取数据。

type VoLoader interface {    LoadFromModel(md *DbModel, mo interface{})()}

一个应用VoLoader接口的例子:

type UserVo struct {    Id          int64    UserName       string    UserAge        int}func (vo *UserVo) LoadFromModel(md *worm.DbModel, mo_ptr interface{}) {    if mo, ok := mo_ptr.(*User); ok {        vo.Id = worm.GetInt64(md, &mo.Id)        vo.UserName = worm.GetString(md, &mo.Name)        vo.UserAge = worm.GetInt(md, &mo.Age)    }}//应用UserVo查询数据库var arr []UserVoerr := worm.Model(&User{}).Where("id>?", 0).Find(&arr)//select id,name,age from user where id>?

应用VoSaver接口定义Vo数据存储逻辑

同样,您可为Vo对象实现VoSaver接口,VoSaver接口用于定义如何将Vo的值赋值给Model对象,并通过Model对象更新数据库。

type VoSaver interface {    SaveToModel(md *DbModel, mo interface{})()}

一个应用VoSaver接口的例子:

func (vo *UserVo) SaveToModel(md *worm.DbModel, mo_ptr interface{}) {    if mo, ok := mo_ptr.(*User); ok {        worm.SetValue(md, &mo.DB_id, vo.DB_id)        worm.SetValue(md, &mo.DB_name, vo.DB_name)        worm.SetValue(md, &mo.Age, vo.Age)    }}//插入记录vo := UserVo{UserAge: 31, UserName: "NameVo"}id, err := worm.Model(&User{}).Insert(&vo)//insert into user set name=?,age=?//更新记录vo = UserVo{UserAge: 32, UserName: "NameVo2"}_, err = worm.Model(&User{}).ID(id).Update(&vo)//update user set name=?,age=? where id=?