目录

Go 代码生成

项目中通常会统一错误码,为方便管理所以在一个统一的 errcode 包中定义错误码常量,以及其错误信息.

/img/errs.png

能不能只写一份注释,剩下的 msg 通过读取注释信息自动生成,从这些重复繁杂无意义的劳动中解放出来。

go generate

golang 在 1.4 版本中引入了 go generate 命令,常用于文件生成,例如在 Golang 官方博客[5]中介绍的 Stringer 可以为枚举自动实现 Stringer 的方法.

实现

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
package main

import (
	"bytes"
	"go/ast"
	"go/format"
	"go/parser"
	"go/token"
	"html/template"
	"os"
	"regexp"
	"strings"

	"github.com/pkg/errors"
)

const suffix = "_msg_gen.go"

type CommentBuilder struct {
	file string
}

type GenBuilder struct {
	err      error
	comments map[string]string
}

type FileBuilder struct {
	content []byte
	dst     string
	err     error
}

func main() {
	err := CommentBuilder{os.Getenv("GOFILE")}.
		GetComments().
		GenCode().
		SaveCode()
	checkErr(err)
}

func (c CommentBuilder) GetComments() GenBuilder {
	if c.file == "" {
		return GenBuilder{err: errors.New("file not specified")}
	}

	var comments = make(map[string]string)

	fset := token.NewFileSet()
	f, err := parser.ParseFile(fset, c.file, nil, parser.ParseComments)
	if err != nil {
		return GenBuilder{err: err}
	}

	cmap := ast.NewCommentMap(fset, f, f.Comments)
	for node := range cmap {
		if spec, ok := node.(*ast.ValueSpec); ok && len(spec.Names) == 1 {
			ident := spec.Names[0]
			if ident.Obj.Kind == ast.Con {
				comments[ident.Name] = parseComment(ident.Name, spec.Comment)
			}
		}
	}

	return GenBuilder{
		comments: comments,
	}
}

// gen 生成代码
func (g GenBuilder) GenCode() FileBuilder {
	if g.err != nil {
		return FileBuilder{err: g.err}
	}

	var buf = bytes.NewBufferString("")

	data := map[string]interface{}{
		"pkg":      os.Getenv("GOPACKAGE"),
		"comments": g.comments,
	}

	t, err := template.New("").Parse(tpl)
	if err != nil {
		return FileBuilder{
			err: errors.Wrapf(err, "template init err"),
		}
	}

	err = t.Execute(buf, data)
	if err != nil {
		return FileBuilder{
			err: errors.Wrapf(err, "template data err"),
		}
	}

	b, err := format.Source(buf.Bytes())

	return FileBuilder{
		dst:     os.Getenv("GOFILE"),
		content: b,
		err:     err,
	}
}

func (f FileBuilder) SaveCode() error {
	if f.err != nil {
		return f.err
	}

	dstFile, err := os.OpenFile(
		strings.ReplaceAll(f.dst, ".go", "")+suffix,
		os.O_TRUNC|os.O_WRONLY|os.O_CREATE,
		0644,
	)
	if err != nil {
		return err
	}
	defer dstFile.Close()

	_, err = dstFile.Write(f.content)
	return err
}

// parseComment 获取注释信息,来自AST标准库的summary方法
func parseComment(name string, group *ast.CommentGroup) string {
	if group == nil {
		return ""
	}

	var buf bytes.Buffer

	for _, comment := range group.List {
		text := regexp.MustCompile(`//\s*`).ReplaceAllString(comment.Text, "")
		buf.WriteString(text)
	}

	// replace any invisibles with blanks
	bytes := buf.Bytes()
	for i, b := range bytes {
		switch b {
		case '\t', '\n', '\r':
			bytes[i] = ' '
		}
	}

	return string(bytes)
}

func checkErr(err error) {
	if err != nil {
		panic(err)
	}
}

// tpl 生成代码需要用到模板
const tpl = `
// Code generated by github.com/rnben/gen-const-msg DO NOT EDIT

// {{.pkg}} 错误码信息
package {{.pkg}}

// noErrorMsg 未知错误
const noErrorMsg = "unknown error"

// messages 错误码对应描述信息
var messages = map[int]string{
	{{- range $key, $value := .comments}}
	{{$key}}: "{{$value}}",{{end}}
}

// GetMsg 返回错误码描述
func GetMsg(code int) string {
	var (
		msg string
		ok  bool
	)
	if msg, ok = messages[code]; !ok {
		msg = noErrorMsg
	}
	return msg
}
`

使用

1
2
3
4
5
6
7
//go:generate gen-const-msg
package errcode

const (
	ErrParams = 10400 // 参数错误
	ErrServer = 10500 // 服务内部错误
)