🚀 ThinkGin 2.0 框架文档

# 1. 克隆项目
git clone https://github.com/your-repo/thinkgin.git
cd thinkgin

# 2. 安装依赖
go mod tidy

# 3. 运行项目
go run main.go

# 4. 访问应用
curl http://localhost:8000/

thinkgin/
├── 📁 app/                  # 应用层
│   ├── 📁 index/            # 业务模块
│   │   ├── 📁 controller/   # 控制器
│   │   ├── 📁 model/        # 数据模型
│   │   └── 📁 view/         # 视图模板
│   └── 📄 config.go         # 配置管理
├── 📁 config/               # 配置文件
│   ├── 📄 app.yaml          # 应用配置
│   ├── 📄 server.yaml       # 服务器配置
│   └── 📄 database.yaml     # 数据库配置
├── 📁 route/                # 路由定义
├── 📁 extend/               # 扩展组件
├── 📁 public/               # 静态资源
└── 📄 main.go               # 程序入口

# config/app.yaml
app:
  name: "ThinkGin"
  version: "2.0.1"
  debug: true
  timezone: "Asia/Shanghai"

# config/server.yaml
server:
  mode: "debug"
  http:
    host: "0.0.0.0"
    port: 8000
    read_timeout: 60
    write_timeout: 60

// route/router.go
func InitRouter() *gin.Engine {
    r := gin.Default()

    // 基础路由
    r.GET("/", controller.Index)
    r.GET("/hello", controller.Hello)

    // 路由组
    api := r.Group("/api/v1")
    {
        api.GET("/users", controller.GetUsers)
        api.POST("/users", controller.CreateUser)
        api.PUT("/users/:id", controller.UpdateUser)
        api.DELETE("/users/:id", controller.DeleteUser)
    }

    return r
}

// 路径参数
r.GET("/user/:id", func(c *gin.Context) {
    id := c.Param("id")
    c.JSON(200, gin.H{"user_id": id})
})

// 查询参数
r.GET("/search", func(c *gin.Context) {
    keyword := c.Query("q")
    page := c.DefaultQuery("page", "1")
    c.JSON(200, gin.H{"keyword": keyword, "page": page})
})

// extend/middleware/auth.go
func JWTAuth() gin.HandlerFunc {
    return func(c *gin.Context) {
        token := c.GetHeader("Authorization")
        if token == "" {
            c.JSON(401, gin.H{"error": "未授权访问"})
            c.Abort()
            return
        }

        // 验证 JWT token
        if !validateToken(token) {
            c.JSON(401, gin.H{"error": "token 无效"})
            c.Abort()
            return
        }

        c.Next()
    }
}

# config/database.yaml
database:
  mysql:
    host: "localhost"
    port: 3306
    username: "root"
    password: "password"
    database: "thinkgin"
    charset: "utf8mb4"
    max_open_conns: 100
    max_idle_conns: 10

  redis:
    host: "localhost"
    port: 6379
    password: ""
    db: 0
    pool_size: 10

// app/user/controller/user.go
package controller

import (
    "net/http"
    "github.com/gin-gonic/gin"
)

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
    Email string `json:"email"`
}

func GetUsers(c *gin.Context) {
    users := []User{
        {ID: 1, Name: "张三", Email: "zhangsan@example.com"},
        {ID: 2, Name: "李四", Email: "lisi@example.com"},
    }

    c.JSON(http.StatusOK, gin.H{
        "code": 200,
        "message": "success",
        "data": users,
    })
}

func CreateUser(c *gin.Context) {
    var user User
    if err := c.ShouldBindJSON(&user); err != nil {
        c.JSON(http.StatusBadRequest, gin.H{
            "code": 400,
            "message": err.Error(),
        })
        return
    }

    // 保存到数据库
    // db.Create(&user)

    c.JSON(http.StatusCreated, gin.H{
        "code": 201,
        "message": "用户创建成功",
        "data": user,
    })
}

// 在路由中使用中间件
api := r.Group("/api/v1")
api.Use(middleware.JWTAuth()) // 使用 JWT 认证
api.Use(middleware.CORS())    // 使用 CORS 中间件
{
    api.GET("/protected", controller.ProtectedHandler)
    api.POST("/upload", controller.UploadHandler)
}