分享兩個(gè)常用的代碼生成工具:
gormgen
基于 MySQL
數(shù)據(jù)表結(jié)構(gòu)進(jìn)行生成 3 個(gè)文件:
- 生成表的
struct
結(jié)構(gòu)體
- 生成表的
Markdown
文檔
- 生成表的
CURD
方法
場景
在進(jìn)行業(yè)務(wù)需求開發(fā)時(shí),創(chuàng)建完數(shù)據(jù)表后,執(zhí)行代碼生成工具,常用的 CURD
操作全部生成完畢,使用的時(shí)候只需要 . 后面的方法即可,這樣大大提高了業(yè)務(wù)開發(fā)效率。
示例
表結(jié)構(gòu):
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 '手機(jī)號(hào)',
`is_deleted` tinyint(1) NOT NULL DEFAULT '-1' COMMENT '是否刪除 1:是 -1:否',
`created_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '創(chuàng)建時(shí)間',
`updated_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新時(shí)間',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用戶Demo表';
1、在 config
中設(shè)置需要自動(dòng)生成的表,參數(shù)為 cmd.genTables
,如果設(shè)置為空,表示生成當(dāng)前數(shù)據(jù)庫中的所有的表,如果設(shè)置多張表還可以用 “,” 分割。
[cmd]
genTables = 'user_demo'
2、在根目錄下執(zhí)行腳本
執(zhí)行完畢后,會(huì)在 /internal/api/repository/db_repo
中生成 user_demo_repo
目錄,同時(shí)也會(huì)生成 3 個(gè)文件:
- gen_model.go
- gen_table.md
- gen_user_demo.go
gen_model.go
內(nèi)容如下:
package user_demo_repo
import "time"
// 用戶Demo表
//go:generate gormgen -structs UserDemo -input .
type UserDemo struct {
Id int32 // 主鍵
UserName string // 用戶名
NickName string // 昵稱
Mobile string // 手機(jī)號(hào)
IsDeleted int32 // 是否刪除 1:是 -1:否
CreatedAt time.Time `gorm:"time"` // 創(chuàng)建時(shí)間
UpdatedAt time.Time `gorm:"time"` // 更新時(shí)間
}
gen_table.md
Markdown 內(nèi)容如下:
gen_user_demo.go
內(nèi)容如下:
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
文件中 type interface
中接口方法,進(jìn)行生成文件。
場景
本次需求的研發(fā)負(fù)責(zé)人通過定義 type interface
的方式,定義出需要開發(fā)的方法,執(zhí)行代碼生成工具,每個(gè)方法的空實(shí)現(xiàn)都會(huì)生成在一個(gè)單獨(dú)的文件中,開發(fā)人員只需去實(shí)現(xiàn)各自方法即可,便于進(jìn)行分工和代碼管理。
示例
比如 test_handler
中定義的 type interface
如下:
var _ Handler = (*handler)(nil)
type Handler interface {
// i 為了避免被其他包實(shí)現(xiàn)
i()
// Create 創(chuàng)建用戶
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() {}
在根目錄下執(zhí)行腳本:
./scripts/handlergen.sh test_handler
// test_handler 為需要生成 handler 的包名
執(zhí)行完畢后,會(huì)在 /internal/api/controller/test_handler
中生成 4 個(gè)文件:
- func_create.go
- func_update.go
- func_detail.go
- func_delete.go
func_create.go
內(nèi)容如下:
type createRequest struct{}
type createResponse struct{}
func (h *handler) Create() core.HandlerFunc {
return func(c core.Context) {
}
}
其中 createRequest
為入?yún)⒔Y(jié)構(gòu)體,createResponse
為出參結(jié)構(gòu)體。
func_update.go
內(nèi)容如下:
type updateRequest struct{}
type updateResponse struct{}
func (h *handler) Update() core.HandlerFunc {
return func(c core.Context) {
}
}
func_detail.go
內(nèi)容如下:
type detailRequest struct{}
type detailResponse struct{}
func (h *handler) Detail() core.HandlerFunc {
return func(c core.Context) {
}
}
func_delete.go
內(nèi)容如下:
type deleteRequest struct{}
type deleteResponse struct{}
func (h *handler) Delete() core.HandlerFunc {
return func(c core.Context) {
}
}
以上代碼都在 go-gin-api 項(xiàng)目中,地址:https://github.com/xinliangnote/go-gin-api
到此這篇關(guān)于Go 代碼生成工具的文章就介紹到這了,更多相關(guān)Go 代碼生成工具內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
您可能感興趣的文章:- 一文秒懂Go 編寫命令行工具的代碼
- JavaScript代碼壓縮工具UglifyJS和Google Closure Compiler的基本用法