标签导航：

构建和部署新api (第一部分)

作为一名软件工程师，我热衷于持续学习和技能提升，探索各种软件解决方案。我决定整合以下工具来构建一个新的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的行为。由于数据库尚未连接，响应将是硬编码的结构，以确保测试通过。

后续工作

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