引入
使用 golang 操作数据库的同学都会遇到一个问题 —— 根据数据表结构创建对应的 struct 模型。因为 golang 的使用首字母控制可见范围，我们经常要设计 struct 字段名和数据库字段名的对应关系。久而久之，这是一个非常繁琐的过程。事情变得繁琐了，我们都会想，有没有好的办法自动生成 model 呢？今天，记录一种自动生成代码的方法 —— xorm 工具。
关于 xorm
xorm是一个简单而强大的Go语言ORM库. 通过它可以使数据库操作非常简便。我在项目中经常使用，它的特性如下：
支持Struct和数据库表之间的灵活映射，并支持自动同步表结构
事务支持
支持原始SQL语句和ORM操作的混合执行
使用连写来简化调用
支持使用Id, In, Where, Limit, Join, Having, Table, Sql, Cols等函数和结构体等方式作为条件
支持级联加载Struct
支持LRU缓存(支持memory, memcache, leveldb, redis缓存Store) 和 Redis缓存
支持反转，即根据数据库自动生成xorm的结构体
支持事件
支持created, updated, deleted和version记录版本（即乐观锁）
想了解更多请移步：http://www.xorm.io/
xorm 工具
xorm 是一组数据库操作命令的工具，包含如下命令：
reverse 反转一个数据库结构，生成代码
shell 通用的数据库操作客户端，可对数据库结构和数据操作
dump Dump数据库中所有结构和数据到标准输出
source 从标注输入中执行SQL文件
driver 列出所有支持的数据库驱动
那我们该如何使用 reverse 命令根据数据表结构生成 go 代码呢？
首先我们要下载该工具 ：
go get github.com/go-xorm/cmd/xorm
同时需要安装对应的 driver :
go get github.com/go-sql-driver/mysql //MyMysql
go get github.com/ziutek/mymysql/godrv //MyMysql
go get github.com/lib/pq //Postgres
go get github.com/mattn/go-sqlite3 //SQLite
还需要下载 xorm ：
go get github.com/go-xorm/xorm
编译 cmd/xorm 会生成 xorm 工具， 假如环境变量。
这时候，执行 xorm help reverse 能获取帮助信息如下：
usage: xorm reverse [-s] driverName datasourceName tmplPath [generatedPath] [tableFilterReg]
according database's tables and columns to generate codes for Go, C++ and etc.
-s Generated one go file for every table
driverName Database driver name, now supported four: mysql mymysql sqlite3 postgres
datasourceName Database connection uri, for detail infomation please visit driver's project page
tmplPath Template dir for generated. the default templates dir has provide 1 template
generatedPath This parameter is optional, if blank, the default value is model, then will
generated all codes in model dir
tableFilterReg Table name filter regexp
可以知道，执行参数 -s 表示为每张表创建一个单独文件。接下来的参数依次是：驱动，数据源，模板目录（在源码的 /cmd/xorm/templates/goxorm 可根据需求定制），生成目录，表格过滤条件。
接下来我们以 Mysql 为例介绍使用方法。
xorm reverse mysql name:password@(ip:port)/xxx?charset=utf8 /cmd/xorm/templates/goxorm
这里输出目录参数省略，会在当前目录建立一个 model 目录，该目录下就是自动生成的 go 代码,， 驼峰命名方式。具体内容如下：
package model
type TestModel struct {
Id int `json:"id" xorm:"not null pk autoincr INT(11)"`
VpsName string `json:"vps_name" xorm:"VARCHAR(30)"`
VpsIp string `json:"vps_ip" xorm:"CHAR(15)"`
VpsPrivateIp string `json:"vps_private_ip" xorm:"CHAR(50)"`
VpsCpu int `json:"vps_cpu" xorm:"INT(11)"`
VpsMem int `json:"vps_mem" xorm:"INT(11)"`
VpsDisk int `json:"vps_disk" xorm:"INT(11)"`
VpsStatus string `json:"vps_status" xorm:"VARCHAR(255)"`
LastHeartTime int `json:"last_heart_time" xorm:"INT(11)"`
CreateTime int `json:"create_time" xorm:"INT(11)"` LastTime int `json:"last_time" xorm:"INT(11)"`
}
到这里，就生成了我们想要的 model , 免去了手写的繁琐过程。
总结
照例总结一波，引用看到过一句话：
如果一个工具能让我节省 1s 的时间，我愿意花一天的时间去找或者开发这个工具！
网友评论