作为一名软件工程师，我热衷于持续学习和，探索各种软件解决方案。我决定整合以下工具来构建一个新的API：

• OpenAPI：用于API规范定义。
• oapi-codegen：根据OpenAPI规范生成服务器代码。
• Testify：用于编写简洁的测试用例。
• Codecov：用于代码覆盖率分析。
• Docker：用于容器化部署。
• PostgreSQL：作为数据库后端。
• GORM：ORM框架（出于学习和探索的目的）。
• Flyway：用于数据库迁移管理。
• Kubernetes：用于容器编排。
• Terraform：用于基础设施即代码。
• Caddy（可能）：作为反向代理。

API规范

我从一个简单的用户模型开始，定义了OpenAPI规范：

components:   schemas:     user:       type: object       properties:         id:           type: string           example: 123           readonly: true         email:           type: string           example: me@example.com           writeonly: true         name:            type: string           example: alice

这个规范用于/users POST请求，返回201 (Created)状态码，并使用自定义JSON对象描述400 (Bad Request)错误。

代码生成

我利用oapi-codegen工具，创建了tools.go文件（类似于项目仓库中的示例）。同时创建了internal/handlers/server.go文件：

//go:generate go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen --config=server.config.yaml ../../openapi.yaml //go:generate go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen --config=types.config.yaml ../../openapi.yaml package handlers

server.config.yaml用于配置严格的net/http服务器，types.config.yaml用于生成模型代码。执行go mod init，go mod tidy和go generate ./…后，生成了大部分API启动所需的文件。

编写和测试处理程序

接下来，在server.go中添加以下代码，创建一个实现生成接口的服务器结构：

var _ strictserverinterface = (*server)(nil)  type server struct{}  func newserver() server {     return server{} }

然后，在user.go中创建POST /users请求的处理程序：

func (*Server) PostUser(ctx context.Context, request PostUserRequestObject) (PostUserResponseObject, error) {     return nil, nil }

目前返回nil，因为我正在开发user_test.go文件，使用Testify编写测试用例，并定义POST /users的行为。由于数据库尚未连接，响应将是硬编码的结构，以确保测试通过。

后续工作

在接下来的博客文章中，我将继续构建mn.go和Dockerfile来启动服务器，并集成Codecov到代码仓库中。 完整的代码可在以下仓库中找到：

以上就是构建和部署新 API（第 1 部分）的详细内容，更多请关注php中文网其它相关文章！