Go 代码生成工具详解
分享两个常用的代码生成工具:
- gormgen
- handlergen
gormgen
基于MySQL数据表结构进行生成3个文件:
- 生成表的struct结构体
- 生成表的Markdown文档
- 生成表的CURD方法
场景
在进行业务需求开发时,创建完数据表后,执行代码生成工具,常用的CURD操作全部生成完毕,使用的时候只需要.后面的方法即可,这样大大提高了业务开发效率。
示例
表结构:
CREATE TABLE `user_demo` ( `id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键', `user_name` varchar(32) NOT NULL DEFAULT '' COMMENT '用户名', `nick_name` varchar(100) NOT NULL DEFAULT '' COMMENT '昵称', `mobile` varchar(20) NOT NULL DEFAULT '' COMMENT '手机号', `is_deleted` tinyint(1) NOT NULL DEFAULT '-1' COMMENT '是否删除 1:是 -1:否', `created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户Demo表';
1、在config中设置需要自动生成的表,参数为cmd.genTables,如果设置为空,表示生成当前数据库中的所有的表,如果设置多张表还可以用“,”分割。
[cmd] genTables='user_demo'
2、在根目录下执行脚本
./scripts/gormgen.sh
执行完毕后,会在/internal/api/repository/db_repo中生成user_demo_repo目录,同时也会生成3个文件:
- gen_model.go
- gen_table.md
- gen_user_demo.go
gen_model.go内容如下:
package user_demo_repo import "time" // 用户Demo表 //go:generate gormgen -structs UserDemo -input . type UserDemo struct { Id int32 // 主键 UserName string // 用户名 NickName string // 昵称 Mobile string // 手机号 IsDeleted int32 // 是否删除 1:是 -1:否 CreatedAt time.Time `gorm:"time"` // 创建时间 UpdatedAt time.Time `gorm:"time"` // 更新时间 }
gen_table.mdMarkdown内容如下:
gen_user_demo.go内容如下:
func NewModel() *UserDemo {...} func NewQueryBuilder() *userDemoRepoQueryBuilder {...} func (t *UserDemo) Create(db *gorm.DB) (id int32, err error) {...} func (t *UserDemo) Delete(db *gorm.DB) (err error) {...} func (t *UserDemo) Updates(db *gorm.DB, m map[string]interface{}) (err error) {...} type userDemoRepoQueryBuilder struct {...} func (qb *userDemoRepoQueryBuilder) buildQuery(db *gorm.DB) *gorm.DB {...} func (qb *userDemoRepoQueryBuilder) Count(db *gorm.DB) (int64, error) {...} func (qb *userDemoRepoQueryBuilder) First(db *gorm.DB) (*UserDemo, error) {...} func (qb *userDemoRepoQueryBuilder) QueryOne(db *gorm.DB) (*UserDemo, error) {...} func (qb *userDemoRepoQueryBuilder) QueryAll(db *gorm.DB) ([]*UserDemo, error) {...} func (qb *userDemoRepoQueryBuilder) Limit(limit int) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) Offset(offset int) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) WhereId(p db_repo.Predicate, value int32) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) OrderById(asc bool) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) WhereUserName(p db_repo.Predicate, value string) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) OrderByUserName(asc bool) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) WhereNickName(p db_repo.Predicate, value string) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) OrderByNickName(asc bool) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) WhereMobile(p db_repo.Predicate, value string) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) OrderByMobile(asc bool) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) WhereIsDeleted(p db_repo.Predicate, value int32) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) OrderByIsDeleted(asc bool) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) WhereCreatedAt(p db_repo.Predicate, value time.Time) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) OrderByCreatedAt(asc bool) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) WhereUpdatedAt(p db_repo.Predicate, value time.Time) *userDemoRepoQueryBuilder {...} func (qb *userDemoRepoQueryBuilder) OrderByUpdatedAt(asc bool) *userDemoRepoQueryBuilder {...}
使用
这样使用生成后的方法:
// 查询示例: user_demo_repo.NewQueryBuilder(). WhereUserName(db_repo.EqualPredicate, "tom"). OrderById(true). QueryOne(u.db.GetDbR().WithContext(ctx.RequestContext()))
handlergen
基于定义的Handler文件中typeinterface中接口方法,进行生成文件。
场景
本次需求的研发负责人通过定义typeinterface的方式,定义出需要开发的方法,执行代码生成工具,每个方法的空实现都会生成在一个单独的文件中,开发人员只需去实现各自方法即可,便于进行分工和代码管理。
示例
比如test_handler中定义的typeinterface如下:
var _ Handler = (*handler)(nil) type Handler interface { // i 为了避免被其他包实现 i() // Create 创建用户 Create() core.HandlerFunc // Update 编辑用户 Update() core.HandlerFunc // Delete 删除用户 Delete() core.HandlerFunc // Detail 用户详情 Detail() core.HandlerFunc } type handler struct { logger *zap.Logger cache cache.Repo userService user_service.UserService } func New(logger *zap.Logger, db db.Repo, cache cache.Repo) Handler { return &handler{ logger: logger, cache: cache, userService: user_service.NewUserService(db, cache), } } func (h *handler) i() {}
在根目录下执行脚本:
./scripts/handlergen.shtest_handler //test_handler为需要生成handler的包名
执行完毕后,会在/internal/api/controller/test_handler中生成4个文件:
- func_create.go
- func_update.go
- func_detail.go
- func_delete.go
func_create.go内容如下:
typecreateRequeststruct{} typecreateResponsestruct{} func(h*handler)Create()core.HandlerFunc{ returnfunc(ccore.Context){ } }
其中createRequest为入参结构体,createResponse为出参结构体。
func_update.go内容如下:
typeupdateRequeststruct{} typeupdateResponsestruct{} func(h*handler)Update()core.HandlerFunc{ returnfunc(ccore.Context){ } }
func_detail.go内容如下:
typedetailRequeststruct{} typedetailResponsestruct{} func(h*handler)Detail()core.HandlerFunc{ returnfunc(ccore.Context){ } }
func_delete.go内容如下:
typedeleteRequeststruct{} typedeleteResponsestruct{} func(h*handler)Delete()core.HandlerFunc{ returnfunc(ccore.Context){ } }
以上代码都在go-gin-api项目中,地址:https://github.com/xinliangnote/go-gin-api
到此这篇关于Go代码生成工具的文章就介绍到这了,更多相关Go代码生成工具内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票!
声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:czq8825#qq.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。