接口定义
- 定义 API 接口文件
接口文件 add.api 的内容如下:
syntax = "v1"info (title: "API 接口文件示例"desc: "演示如何编写 API 接口文件"author: "一见"date: "2023年12月07日"version: "v1"
)type AddReq {A int `path:"a"`B int `path:"b"`
}type AddReply {Sum int `json:"sum"`
}service Adder {@handler addget /add/:a/:b(AddReq) returns(AddReply)
}上述go-zero的api文件定义语法正确吗?
- 编译 API 接口文件
在 add.api 文件所在目录下,使用 go-zero 的脚手架工具 goctl 编译 add.api 文件:
# goctl api go -api add.api -dir .
Done.
编译成功后的目录结构:
.
├── add.api
├── adder.go # 服务端 main 函数所在文件
├── etc
│ └── adder.yaml # 配置文件
└── internal├── config│ └── config.go # 和配置对应的数据结构├── handler # HTTP 部分代码│ ├── addhandler.go│ └── routes.go├── logic│ └── addlogic.go # 需要实现的业务逻辑代码├── svc│ └── servicecontext.go # 上下文└── types└── types.go # 对应 API 中定义的数据结构
在进一步之前,还需执行“go mod tidy”整理依赖。
目录 etc 下的配置文件 adder.yaml 定义的 API 网关服务的服务端口等:
# cat etc/adder.yaml
Name: Adder
Host: 0.0.0.0
Port: 8888
如上所示,go-zero 脚手架 goctl 设置的监听端口为 8888 。
- 编译生成可执行程序文件
go mod tidy
go build -o add_http_server adder.go
- 启动服务:
# ./add_http_server
Starting server at 0.0.0.0:8888...
- 测试服务是否可用:
# curl -i "http://localhost:8888/add"
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Traceparent: 00-97de89193a15ff3704beeab6ab01cbc5-448ad910b934da13-00
Date: Thu, 07 Dec 2023 07:09:36 GMT
Content-Length: 4null
接口实现
go-zero 的脚手架 goctl 生成的是一个空服务,除了返回 null,啥也没干。在函数 Add 中增加实现:
# cat internal/logic/addlogic.go
package logicimport ("context""api/internal/svc""api/internal/types""github.com/zeromicro/go-zero/core/logx"
)type AddLogic struct {logx.Loggerctx context.ContextsvcCtx *svc.ServiceContext
}func NewAddLogic(ctx context.Context, svcCtx *svc.ServiceContext) *AddLogic {return &AddLogic{Logger: logx.WithContext(ctx),ctx: ctx,svcCtx: svcCtx,}
}func (l *AddLogic) Add(req *types.AddReq) (resp *types.AddReply, err error) {// todo: add your logic here and delete this lines := req.A + req.B // 新增代码return &types.AddReply{ s }, nil // 新增代码return
}
重新编译执行:
# curl -i "http://localhost:8888/add?a=1&b=3"
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Traceparent: 00-33930e740d4d642dd8a16667af5f6a60-cb450c0bdbb9f6fc-00
Date: Fri, 08 Dec 2023 02:58:48 GMT
Content-Length: 9{"sum":4}