xorm
xorm是一个简单而强大的Go语言ORM库. 通过它可以使数据库操作非常简便。这个库是国人开发的,是基于原版 xorm:https://github.com/go-xorm/xorm 的定制增强版本。安装该orm的话,直接通过go get -u github.com/xormplus/xorm即可
当然orm并不能直接操作数据库,还是要借助第三方驱动的,目前支持的驱动如下
Mysql: https://github.com/go-sql-driver/mysql
MyMysql: https://github.com/ziutek/mymysql
Postgres: https://github.com/lib/pq
Tidb: https://github.com/pingcap/tidb
SQLite: https://github.com/mattn/go-sqlite3
MsSql: https://github.com/denisenkom/go-mssqldb
Oracle: https://github.com/mattn/go-oci8 (试验性支持)
创建引擎
引擎使用来执行我们所写的sql语句的
package main
import (
"fmt"
_ "github.com/lib/pq" // 引用驱动,python中,是不需要显示引用的,但是golang需要引用执行以下内部的Init函数,我这里是postgresql,其他数据库就换成其他的驱动
"github.com/xormplus/core"
"github.com/xormplus/xorm"
)
func main() {
engine, err := xorm.NewPostgreSQL("postgresql://postgres:zgghyys123@localhost:5432/postgres?sslmode=disable")
// 引擎这里结尾要加上一个sslmode=disable,不然会报出:pq: SSL is not enabled on the server
if err != nil {
fmt.Println(err)
} else {
//调用engine.Ping可以查看是否建立成功
_ = engine.Ping() // [xorm] [info] 2019/08/25 21:14:49.581814 PING DATABASE postgres
}
//此外还可以设置日志,通过设置日志,可以显示sql、警告和错误信息等等,默认的显示级别为info
engine.ShowSQL(true) // 则会在控制台打印出生成的SQL语句
engine.Logger().SetLevel(core.LOG_DEBUG) //则会在控制台打印info及以上的信息
/*
如果希望将信息不仅打印到控制台,而是保存为文件,那么可以通过类似如下的代码实现,NewSimpleLogger(w io.Writer)接收一个io.Writer接口来将数据写入到对应的设施中。
f, err := os.Create("sql.log")
if err != nil {
println(err.Error())
return
}
engine.SetLogger(xorm.NewSimpleLogger(f))
*/
//此外还可以设置连接池
/*
如果需要设置连接池的空闲数大小,可以使用engine.SetMaxIdleConns(n)来实现
如果需要设置最大打开连接数,则可以使用engine.SetMaxOpenConns(n)来实现。
*/
}
获取表信息
package main
import (
"fmt"
_ "github.com/lib/pq" // 引用驱动,python中,是不需要显示引用的,但是golang需要引用执行以下内部的Init函数,我这里是postgresql,其他数据库就换成其他的驱动
"github.com/xormplus/xorm"
)
func main() {
engine, err := xorm.NewPostgreSQL("postgresql://postgres:zgghyys123@localhost:5432/postgres?sslmode=disable")
if err != nil {
fmt.Println(err)
} else {
// info是一个切片,存储的数据类型为*core.Table,*core.Table是一个结构体指针,我们来看看都有哪些属性
/*
type Table struct {
Name string
Type reflect.Type
columnsSeq []string
columnsMap map[string][]*Column
columns []*Column
Indexes map[string]*Index
PrimaryKeys []string
AutoIncrement string
Created map[string]bool
Updated string
Deleted string
Version string
Cacher Cacher
StoreEngine string
Charset string
Comment string
}
*/
info, err := engine.DBMetas()
if err != nil {
fmt.Println(err)
}else {
for _, v := range info{
fmt.Println(fmt.Sprintf("表名:%s", v.Name))
/*
表名:alembic_version
表名:user1
表名:heroes
*/
}
}
}
}
此外还可以判断表是否存在,表是否为空,以及删除表
package main
import (
"fmt"
_ "github.com/lib/pq" // 引用驱动,python中,是不需要显示引用的,但是golang需要引用执行以下内部的Init函数,我这里是postgresql,其他数据库就换成其他的驱动
"github.com/xormplus/xorm"
)
func main() {
engine, err := xorm.NewPostgreSQL("postgresql://postgres:zgghyys123@localhost:5432/postgres?sslmode=disable")
if err != nil {
fmt.Println(err)
} else {
//判断user1是否存在
flag, _ := engine.IsTableExist("user1")
fmt.Println(flag) // true
//判断user1内容是否为空
flag, _ = engine.IsTableEmpty("user1")
fmt.Println(flag) // false
//删除user1,DropTables可以接收多个参数
_ = engine.DropTables("user1")
//再来查看user1是否存在
flag, _ = engine.IsTableExist("user")
fmt.Println(flag) // false
}
}
创建表
首先可以原生建表
package main
import (
"fmt"
_ "github.com/lib/pq" // 引用驱动,python中,是不需要显示引用的,但是golang需要引用执行以下内部的Init函数,我这里是postgresql,其他数据库就换成其他的驱动
"github.com/xormplus/xorm"
)
func main() {
engine, err := xorm.NewPostgreSQL("postgresql://postgres:zgghyys123@localhost:5432/postgres?sslmode=disable")
if err != nil {
fmt.Println(err)
} else {
create_table_sql := `
create table girls(
id int primary key,
name varchar(255) not null,
age int not null,
gender varchar(1)
)
`
//调用engine.Exec可以执行原生sql语句
res, err := engine.Exec(create_table_sql)
if err != nil {
fmt.Println(err)
}else {
//res是一个sql.Result类型
/*
type Result interface {
LastInsertId() (int64, error)
RowsAffected() (int64, error)
}
*/
//这两行打印的无所谓,只要上面的err为nil即可,我们看看数据库里面有没有表
fmt.Println(res.LastInsertId()) // 0 LastInsertId is not supported by this driver
fmt.Println(res.RowsAffected()) // 0 <nil>
}
}
}
创建成功了的
orm形式建表
在golang中,使用结构体映射为数据库中的字段
package main
import (
"fmt"
_ "github.com/lib/pq" // 引用驱动,python中,是不需要显示引用的,但是golang需要引用执行以下内部的Init函数,我这里是postgresql,其他数据库就换成其他的驱动
"github.com/xormplus/xorm"
)
func main() {
engine, err := xorm.NewPostgreSQL("postgresql://postgres:zgghyys123@localhost:5432/postgres?sslmode=disable")
if err != nil {
fmt.Println(err)
} else {
type boy struct {
// 字段名 类型 tag
//golang的orm中的约束使用tag来体现,多个约束使用空格分割
/*
pk表示主键 autoincr 自增
如果Field名就叫做Id,并且类型为int64,如果不加tag,会自动被xorm视为主键,并且自增。
如果想用Id以外、或者非int64类型作为主键,必须要显示的在tag中指定,`xorm:"pk autoincr"`
*/
Id int `xorm:"pk autoincr"`
/*
'姓名'是映射到数据库的字段名,如果不指定则是当前结构体字段(Field)的名称
建议使用单引号括起来放到最后
*/
Name string `xorm:"varchar(255) not null '姓名'"`
/*
default,默认值
*/
Age int `xorm:"not null default 16 '年龄'"`
/*
default,默认值,如果是varchar则需要加上单引号
*/
Gender int `xorm:"varchar(1) not null default '女' '性别'"`
}
//可以指定schema,对于postgresql来说,很多时候还是要指定schema的
engine.SetSchema("anime") //设置schema为anime
//使用engine.Sync(new(boy)),完成映射
err := engine.Sync(new(boy))
if err != nil {
fmt.Println(err)
}
}
}
也是创建成功了的
插入数据
orm形式插入数据
package main
import (
"fmt"
"github.com/xormplus/xorm"
)
import _"github.com/lib/pq"
func main() {
engine, _ := xorm.NewPostgreSQL("postgres://postgres:zgghyys123@localhost:5432/postgres?sslmode=disable")
type girl struct {
Id int `xorm:"pk autoincr"`
Name string `xorm:"varchar(255) not null"`
Age int `xorm:"not null"`
//CreatedAt time.Time `xorm:"created"` 会自动加上当前的创建时间
}
engine.SetSchema("anime")
_ = engine.Sync(new(girl))
g := &girl{Name:"satori", Age:16}
//插入数据可以使用Insert方法,对象可以是一个struct对象指针,插入一条数据,或者多个struct指针组成的切片所对应的指针,插入多条数据
//注意到这里没有传入Id,因为Id在数据库中是自增的。如果给Id赋值了,那么该字段会作为非自增字段插入
affected, err:= engine.Insert(g) // 返回两个结果,受影响的行数和err
if err != nil {
fmt.Println(err)
} else {
fmt.Println("受影响的行数", affected)
}
//插入多条数据
rows := []*girl{
{Name:"koishi", Age:16},
{Name:"frandlescarlet", Age:400},
{Name:"mashiro", Age:16},
}
affected, err = engine.Insert(&rows) // 对的,这里切片也要传递指针
if err!=nil{
fmt.Println(err)
}else{
fmt.Println("受影响的行数", affected)
}
/*
受影响的行数 1
受影响的行数 3
*/
}
原生形式插入数据
package main
import (
"github.com/xormplus/xorm"
)
import _"github.com/lib/pq"
func main() {
engine, _ := xorm.NewPostgreSQL("postgres://postgres:zgghyys123@localhost:5432/postgres?sslmode=disable")
// 第一种方式
sql_1 := "insert into anime.girl(name, age) values('kurisu', 18)"
_, _ = engine.Exec(sql_1)
// 第二种方式
sql_2 := "insert into anime.girl(name, age) values(?, ?)"
_, _ = engine.Exec(sql_2, "nagisa", 20)
// 第三种方式
sql_3 := "insert into anime.girl(name, age) values(?, ?)"
_, _ = engine.SQL(sql_3, "tomoyo", 18).Execute()
}
查询和统计数据
支持执行SQL与ORM两种方式查询数据
orm方式查询和统计数据
package main
import (
"fmt"
"github.com/xormplus/xorm"
)
import _"github.com/lib/pq"
//字段名大写,和数据库的表的字段名保持一致即可
//结构体的名字和表名一致即可,这里可以大写可以小写
type Girl struct {
Id int64
Name string
Age int
}
func main(){
engine, err := xorm.NewPostgreSQL("postgresql://postgres:zgghyys123@localhost:5432/postgres?sslmode=disable")
if err != nil {
fmt.Println(err)
}
//指定schema
engine.SetSchema("anime")
//创建一个结构体指针
g1 := new(Girl)
//使用engine.Get方法,传入相应的指针
//返回两个参数,第一个参数表示记录是否存在,第二个表示是否有错
has, err := engine.Get(g1)
if err!= nil {
fmt.Println(err)
}else {
fmt.Println(has) // true
}
//正确执行engine.Get之后,记录会存到g1里面
//注意Get方法只会获取一条记录,那么默认是符合条件的第一条
fmt.Println(g1) // &{1 satori 16}
/*
Find:Get是查询一条数据,Find查询多条
那么此时Find里面接收的则是一个切片对应的指针,切片的类型是相应结构体类型
*/
girl1 := make([]Girl, 0)
if err := engine.Find(&girl1); err!=nil{
fmt.Println(err)
}else{
//这样就全部获取出来了
fmt.Println(girl1) // [{1 satori 16} {2 koishi 16} {3 frandlescarlet 400} {4 mashiro 16} {5 kurisu 18} {6 nagisa 20} {7 tomoyo 18}]
}
/*
where:查询
*/
girl2 := make([]Girl, 0)
if err = engine.Where("name = ?", "koishi").Find(&girl2);err!=nil{
fmt.Println(nil)
}else{
fmt.Println(girl2) // [{2 koishi 16}]
}
girl3 := make([]Girl, 0)
if err = engine.Where("name = ? and age = ?", "koishi", 16).Find(&girl3);err!=nil{
fmt.Println(err)
}else{
fmt.Println(girl3) // [{2 koishi 16}]
}
girl4 := make([]Girl, 0)
//where语句可以重复嵌套
if err = engine.Where("name = ?", "koishi").Where("age = ?", 16).Find(&girl4);err!=nil{
fmt.Println(err)
}else{
fmt.Println(girl4) // [{2 koishi 16}]
}
/*
And:和where基本相同
*/
girl5 := make([]Girl, 0)
if err = engine.Where("name = ?", "mashiro").And("age = ?", 16).Find(&girl5);err!=nil{
fmt.Println(err)
}else{
fmt.Println(girl5) // [{4 mashiro 16}]
}
/*
Or:
*/
girl6 := make([]Girl, 0)
if err = engine.Where("name = ?", "mashiro").Or("age = ?", 16).Find(&girl6);err!=nil{
fmt.Println(err)
}else{
fmt.Println(girl6) // [{1 satori 16} {2 koishi 16} {4 mashiro 16}]
}
girl7 := make([]Girl, 0)
if err = engine.Where("name = ? or age = ?", "mashiro", 16).Find(&girl7);err!=nil{
fmt.Println(err)
}else{
fmt.Println(girl7) // [{1 satori 16} {2 koishi 16} {4 mashiro 16}]
}
/*
Asc:正序排序
*/
girl8 := make([]Girl, 0)
if err = engine.Asc("name").Find(&girl8);err!=nil{
fmt.Println(err)
}else {
fmt.Println(girl8) // [{3 frandlescarlet 400} {2 koishi 16} {5 kurisu 18} {4 mashiro 16} {6 nagisa 20} {1 satori 16} {7 tomoyo 18}]
}
/*
Desc:正序排序
*/
girl9 := make([]Girl, 0)
if err = engine.Desc("name").Find(&girl9);err!=nil{
fmt.Println(err)
}else {
fmt.Println(girl9) // [{7 tomoyo 18} {1 satori 16} {6 nagisa 20} {4 mashiro 16} {5 kurisu 18} {2 koishi 16} {3 frandlescarlet 400}]
}
/*
OrderBy:按照指定的顺序排序,和Asc类似
*/
girl10 := make([]Girl, 0)
if err = engine.OrderBy("name").Find(&girl10);err!=nil{
fmt.Println(err)
}else{
fmt.Println(girl10) // [{3 frandlescarlet 400} {2 koishi 16} {5 kurisu 18} {4 mashiro 16} {6 nagisa 20} {1 satori 16} {7 tomoyo 18}]
}
/*
Select:选择想要的字段
*/
girl11 := make([]Girl, 0)
if err = engine.Select("id,name").Find(&girl11);err!=nil{
fmt.Println(err)
}else{
//只选择id和name,可以看到age全是零值
fmt.Println(girl11) //[{1 satori 0} {2 koishi 0} {3 frandlescarlet 0} {4 mashiro 0} {5 kurisu 0} {6 nagisa 0} {7 tomoyo 0}]
}
/*
In
*/
girl12 := make([]Girl, 0)
if err = engine.In("id", []int{1, 2,5}).Find(&girl12);err!=nil{
fmt.Println(err)
}else{
fmt.Println(girl12) // [{1 satori 16} {2 koishi 16} {5 kurisu 18}]
}
/*
Distinct
*/
girl13 := make([]Girl, 0)
if err = engine.Distinct("age").Find(&girl13);err!=nil{
fmt.Println(err)
}else {
fmt.Println(girl13) // [{0 16} {0 400} {0 20} {0 18}]
}
/*
Limit:
*/
girl14 := make([]Girl, 0)
//Limit(2, 3):取两条,从第三条开始
if err = engine.Limit(2, 3).Find(&girl14);err!=nil{
fmt.Println(err)
}else{
fmt.Println(girl14) //[{4 mashiro 16} {5 kurisu 18}]
}
}
不想写了,可以查看https://www.kancloud.cn/xormplus/xorm/167094