xorm根据数据库表生成对应的结构体

我会带着你远行 2022-06-03 05:28 285阅读 0赞

### 引入 ###

使用 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/][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  //安装mysql驱动
    //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 [可选your project model path]

这里输出目录参数省略，会在当前目录建立一个 `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 的时间，我愿意花一天的时间去找或者开发这个工具！
> 
>   
> 
> 
> 原文地址：https://www.cnblogs.com/artong0416/p/7456674.html

[http_www.xorm.io]: http://www.xorm.io/