golang框架代码生成器在微服务架构中的运用

go get -u github.com/gin-gonic/gin

go get -u github.com/swaggo/swag

package main

import (
    "github.com/gin-gonic/gin"
    swaggerFiles "github.com/swaggo/files"
    ginSwagger "github.com/swaggo/gin-swagger"

    _ "example.com/docs/application" // swagger docs file
)

func main() {
    r := gin.Default()
    
    // 自动生成 RESTful API 路由
    ConfigureRouting(r)

    // 添加 Swagger 文档中间件
    url := ginSwagger.URL("/swagger/doc.json") // The url pointing to OpenAPI definition
    r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler, url))
    
    r.Run()
}

// swagger:route GET /products products listAllProducts
// List all products.
// responses:
//     200: productsResponse
func listProductsHandler(c *gin.Context) {}

// swagger:parameters updateProduct
type updateProductRequestParams struct {
    // The ID of the product to update.
    // in: path
    // required: true
    ID int `json:"id"`
    
    // The updated details of the product.
    // in: body
    // required: true
    Product product `json:"product"`
}

// swagger:route PUT /products/{id} products updateProduct
// Update product details
//
// Update the details of a specific product.
//
// responses:
//     200: updateProductResponse
func updateProductHandler(c *gin.Context) {}

// swagger:response updateProductResponse
type updateProductResponse struct {
    Ack JSONResult `json:"ack"`
}