api 语法
1.概述
api 是 go-zero 自研的领域特性语言(下文称 api 语言 或 api 描述语言),旨在实现人性化的基础描述语言,作为生成 HTTP 服务最基本的描述语言。
api 领域特性语言包含语法版本,info 块,结构体声明,服务描述等几大块语法组成,其中结构体和 Golang 结构体语法几乎一样,只是移出了 struct 关键字。
在完成goctl 安装后,可以通过 goctl 创建一个最小化的 HTTP 服务来了解 goctl 的 go-zero api 服务的概况。
2.创建一个api服务
goctl api new api_demo
执行完指令后,会在当前目录下生成一个 demo 目录,该目录下包含了一个最小化的 HTTP 服务,服务的目录结构如下:
在完成上述代码生成后,可以找到 ~/internal/logic/apidemologic.go 文件,编辑该文件:
完成上述编写之后,运行代码:
整理依赖文件
go mod tidy
启动 go 程序
go run demo.go
在浏览器输入:http://127.0.0.1:8888/from/me
之所以http://127.0.0.1:8888/from/me,是因为定义路由如下:
参考:
https://go-zero.dev/docs/tasks/cli/api-demo
https://www.fengfengzhidao.com/article/MNnccYsBEG4v2tWkfm29