构建和部署新 API（第 1 部分）-Golang-PHP中文网

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

心靈之曲

发布： 2025-01-08 12:30:37

原创

623人浏览过

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

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

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

API规范

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

<code class="yaml">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</code>

登录后复制

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

代码生成

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

<code class="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</code>

登录后复制

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

Akkio

Akkio 是一个无代码 AI 的全包平台，任何人都可以在几分钟内构建和部署AI

111

查看详情

编写和测试处理程序

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

<code class="go">var _ strictserverinterface = (*server)(nil)

type server struct{}

func newserver() server {
    return server{}
}</code>

登录后复制

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

<code class="go">func (*Server) PostUser(ctx context.Context, request PostUserRequestObject) (PostUserResponseObject, error) {
    return nil, nil
}</code>

登录后复制

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