1 go-zero入门–单体服务demo

参考1：go-zero入门–单体服务demo
推荐先阅读参考1。

1.1 单体服务【官方示例】

1.1.1 创建greet服务

goctl api new greet

1.1.2 目录结构

.
├── go.mod
├── go.sum
├── 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

1.1.3 编写逻辑

greet/internal/logic/greetlogic.go

func (l *GreetLogic) Greet(req *types.Request) (resp *types.Response, err error) {
	// todo: add your logic here and delete this line
	return &types.Response{
		Message: "Hello go-zero：" + req.Name,
	}, nil
}

1.1.4 启动并访问服务

启动：在greet目录下执行：

go run greet.go -f etc/greet-api.yaml

访问：http://localhost:8888/from/you

注意：

1. 端口的设置是在etc/greet-api.yaml中。
2. 访问地址中的最后资源只能是you或me，否则会报错，这个是在 greet.api 中配置的。

1.2 修改GET入参

1.2.1 去除options限制的入参值

1. 修改greet/greet.api文件

type Request {
	Name string `path:"name,options=you|me"`
}

改为：

type Request {
	Name string `path:"name"`
}

2. 重新生成代码

cd ~/go-zero-single_demo/greet
goctl api go -api greet.api -dir . -style gozero

注意：执行完goctl后会重新生成以下文件，如果没有新增的东西，可能会看不出来，具体可看执行日志。

1. types/types.go
2. handler/的文件
3. logic/的文件

1.2.2 重启并访问服务

重启：

go run greet.go -f etc/greet-api.yaml

访问：http://localhost:8888/from/哈哈

1.3 添加post请求【新增方法】

1.3.1 修改 greet/greet.api 文件

注意：service里的api必须是handler和访问接口一一对应，放在一起，否则会报错。可看 2 greet.api line 25:1 expecting 'http method', found input '@handler'

type Request {
	Name string `path:"name"`
}

type Response {
	Message string `json:"message"`
}

//1、post 方法的请求内容
type RequestJson {
    Name string `json:"name"`
}

service greet-api {
	@handler GreetHandler
	get /from/:name(Request) returns (Response)

    //2、post 方法的处理器
	@handler GreetPostHandler
	post /from/:name(RequestJson) returns (Response)
}

1.3.2 重新生成代码

cd ~/go-zero-single_demo/greet
goctl api go -api greet.api -dir . -style gozero

注意：执行完goctl后会重新生成以下文件。

1. types/types.go
2. handler/routes.go：增加了的访问接口的路由。

同时会新增以下文件：

1. handler/greetposthandler.go
2. logic/greetpostlogic.go

1.3.3 修改logic/greetpostlogic.go文件

func (l *GreetPostLogic) GreetPost(req *types.RequestJson) (resp *types.Response, err error) {
	// todo: add your logic here and delete this line
	return &types.Response{
		Message: "Hello go-zero name：" + req.Name,
	}, nil
}

1.3.4 重启并访问服务

重启：

cd ~/go-zero-single_demo/greet
go run greet.go -f etc/greet-api.yaml

POST方式访问：

POST http://127.0.0.1:8888/from/哈哈 HTTP/1.1
Content-Type: application/json
{
   "name":"post 哈哈"
}

返回结果：

{
    "message": "Hello go-zero name：post 哈哈"
}

2 go-zero入门–微服务demo

2.1 新建微服务

参考1：go-zero入门–微服务demo

2.2 API接口模块添加后端模块

API接口模块添加后端模块需要改动3个地方。

1. etc/xxx.yaml
   主要是配置后端模块的Etcd服务发现。
   示例：

Name: order
Host: 0.0.0.0
Port: 8889
UserRpc:
  Etcd:
    Hosts:
      - 192.168.13.3:2379
    Key: user.rpc

2. internal/config/config.go
   主要是配置后端调用的模块RPC。
   示例：

package config

import (
	"github.com/zeromicro/go-zero/rest"
	"github.com/zeromicro/go-zero/zrpc"
)

type Config struct {
	rest.RestConf
	UserRpc zrpc.RpcClientConf
}

3. internal/svc/servicecontext.go
   主要是将 2 配置的后端服务模块加入到 API接口模块的ServiceContext中。
   示例：

package svc

import (
	"github.com/zeromicro/go-zero/zrpc"
	"go-zero-micro-demo/mall/order/api/internal/config"
	"go-zero-micro-demo/mall/user/rpc/userclient"
)

type ServiceContext struct {
	Config  config.Config
	UserRpc userclient.User
}

func NewServiceContext(c config.Config) *ServiceContext {
	return &ServiceContext{
		Config:  c,
		UserRpc: userclient.NewUser(zrpc.MustNewClient(c.UserRpc)),
	}
}

3 go-zero 框架下swagger使用

参考1：goctl-swagger
看参考1 中README.md，里面有下载及使用的操作流程。

生成swagger.json文件的命令：

goctl api plugin -plugin goctl-swagger="swagger -filename user.json" -api user.api -dir .

4 goctl 相关命令整理

4.1 .api生成swagger的命令

示例：

goctl api plugin -plugin goctl-swagger="swagger -filename tracksourcetask.json" -api tracksourcetask.api -dir .

4.2 .api生成api模块的命令

示例：

goctl api go -api ./doc/admin.api -dir .

4.3 .proto生成rpc模块的命令

示例：

goctl rpc protoc tracksource.proto --go_out=./ --go-grpc_out=./ --zrpc_out=.

4.4 sql文件生成model的命令

goctl model mysql ddl -src="./rpc/doc/sql/appsystem/dsms*.sql" -dir="./rpc/model/appsystemodel"

4.5 docker启动swagger的命令

docker run -d -p 9981:8080 --name=swagger-tracksourcetask -v /root/doc:/tmp -e SWAGGER_FILE=/tmp/tracksourcetask-v2.json swaggerapi/swagger-editor

#####################################################

1 field name set

要修改设置结构体的变量，应该在greet.api中，然后再使用下面的命令生成对应的结构体和业务类。

goctl api go -api greet.api -dir . -style gozero

2 greet.api line 25:1 expecting ‘http method’, found input ‘@handler’

源码：

service greet-api {
	@handler GreetHandler
	@handler GreetCustomizedHandler
	get /from/:name/:age(Request) returns (Response)
	get /customized/:address/:phone(CustomizedRequest) returns (CustomizedResponse)
}

错误写法：一个@handler对应一个api，但是两者需要紧挨着。@handler和@handler放一块、api和api放一块的写法是错误的。

正确写法：

service greet-api {
	@handler GreetHandler
	get /from/:name/:age(Request) returns (Response)
	
	@handler GreetPostHandler
	post /from/:name(RequestJson) returns (Response)
}