介绍
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=?