一、Golang环境安装及配置Go Module
https://go-zero.dev/cn/docs/prepare/golang-install
mac OS安装Go#
- 下载并安装Go for Mac
- 验证安装结果
$ go version
go version go1.15.1 darwin/amd64
linux 安装Go#
- 下载Go for Linux
- 解压压缩包至/usr/local
$ tar -C /usr/local -xzf go1.15.8.linux-amd64.tar.gz
- 添加/usr/local/go/bin到环境变量
$ $HOME/.profile
$ export PATH=$PATH:/usr/local/go/bin
$ source $HOME/.profile
- 验证安装结果
$ go version
go version go1.15.1 linux/amd64
Windows安装Go#
- 下载并安装Go for Windows
- 验证安装结果
$ go version
go version go1.15.1 windows/amd64
MODULE配置
Go Module是Golang管理依赖性的方式,像Java中的Maven,Android中的Gradle类似。
- 查看GO111MODULE开启情况
$ go env GO111MODULE
on
- 开启GO111MODULE,如果已开启(即执行go env GO111MODULE结果为on)请跳过。
$ go env -w GO111MODULE="on"
- 设置GOPROXY
$ go env -w GOPROXY=https://goproxy.cn
- 设置GOMODCACHE
查看GOMODCACHE
$ go env GOMODCACHE
- 如果目录不为空或者/dev/null,请跳过。
go env -w GOMODCACHE=$GOPATH/pkg/mod
二、Goctl 安装
Goctl在go-zero项目开发着有着很大的作用,其可以有效的帮助开发者大大提高开发效率,减少代码的出错率,缩短业务开发的工作量,更多的Goctl的介绍请阅读Goctl介绍
- 安装(mac&linux)
### Go 1.15 及之前版本
GO111MODULE=on GOPROXY=https://goproxy.cn/,direct go get -u github.com/zeromicro/go-zero/tools/goctl@latest
### Go 1.16 及以后版本
GOPROXY=https://goproxy.cn/,direct go install github.com/zeromicro/go-zero/tools/goctl@latest
- 安装(windows)
go install github.com/zeromicro/go-zero/tools/goctl@latest
- 环境变量检测(mac&linux)
go get 下载编译后的二进制文件位于 \$GOPATH/bin 目录下,要确保 $GOPATH/bin已经添加到环境变量。
sudo vim /etc/paths //添加环境变量
在最后一行添加如下内容 //$GOPATH 为你本机上的文件地址
$GOPATH/bin
- 安装结果验证
$ goctl -v
goctl version 1.1.4 darwin/amd64
二、初始化go-zero
goctl api new greet
cd greet
go mod init
go mod tidy
go run greet.go -f etc/greet-api.yaml
- 默认侦听在 8888 端口
侦听端口可以在greet-api.yaml
配置文件里修改,此时,可以通过 curl 请求,或者直接在浏览器中打开http://localhost:8888/from/you
$ curl -i http://localhost:8888/from/you
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Traceparent: 00-45fa9e7a7c505bad3a53a024e425ace9-eb5787234cf3e308-00
Date: Thu, 22 Oct 2020 14:03:18 GMT
Content-Length: 14
null
- greet服务的目录结构
$ tree greet
greet
├── etc
│ └── greet-api.yaml
├── greet.api
├── greet.go
└── internal
├── config
│ └── config.go
├── handler
│ ├── greethandler.go
│ └── routes.go
├── logic
│ └── greetlogic.go
├── svc
│ └── servicecontext.go
└── types
└── types.go
三、查看注册Handler路由流程
- greet.go
var configFile = flag.String("f", "etc/greet-api.yaml", "the config file")
func main() {
flag.Parse()
var c config.Config
conf.MustLoad(*configFile, &c)
server := rest.MustNewServer(c.RestConf)
defer server.Stop()
//上面的都是加载配置什么的
ctx := svc.NewServiceContext(c)
handler.RegisterHandlers(server, ctx) //此方法是注册路由和路由映射Handler,重点在这里
fmt.Printf("Starting server at %s:%d...\n", c.Host, c.Port)
server.Start()
}
- RegisterHandlers在
internal\handler\routes.go
中
func RegisterHandlers(server *rest.Server, serverCtx *svc.ServiceContext) {
server.AddRoutes( //往rest.Server中添加路由
[]rest.Route{ //路由数组
{
Method: http.MethodGet,
Path: "/from/:name", //路由
Handler: GreetHandler(serverCtx),//当前路由的处理Handler
},
},
)
}
- GreetHandler在
internal\handler\greethandler.go
中
func GreetHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(