构建和部署新 API（第 1 部分）

一分耕耘，一分收获！既然打开了这篇文章《构建和部署新 API（第 1 部分）》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

作为一名软件工程师，我热衷于持续学习和技能提升，探索各种软件解决方案。我决定整合以下工具来构建一个新的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://github.com/m-dango/demo-api/tree/1c86f975fc451e50c2bedbfeb6bc4317e6c7be21

好了，本文到此结束，带大家了解了《构建和部署新 API（第 1 部分）》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！