gin

tao-gin

 _______             _____ _       
|__   __|           / ____(_)      
   | | __ _  ___   | |  __ _ _ __  
   | |/ _` |/ _ \  | | |_ | | '_ \ 
   | | (_| | (_) | | |__| | | | |
   |_|\__,_|\___/   \_____|_|_|_|

Tao Universe Gin Web 框架集成组件，提供 HTTP 服务能力，支持多实例工厂模式（可同时运行多个端口服务）。

安装

go get github.com/taouniverse/tao-gin

使用

导入

import _ "github.com/taouniverse/tao-gin"

配置

单实例模式：

gin:
  mode: debug              # gin mode: debug/release/test
  listen: 0.0.0.0         # listen address
  port: 8080              # listen port
  writer: zap             # logger writer name (must match a registered writer)
  trust_proxies:          # trusted proxy list
    - "192.168.1.0/24"
  html_pattern:           # HTML template glob pattern (optional)
  static_path:            # static file path (optional)
  pprof:                  # pprof configuration (optional)
    enable: false
    path: /debug/pprof
  run_after: []           # pre-task dependencies

多实例模式（同时监听多个端口）：

gin:
  default_instance: public
  public:
    mode: release
    listen: 0.0.0.0
    port: 8080
    writer: zap
    trust_proxies:
      - "192.168.1.0/24"
    pprof:
      enable: true
      prefix: /pprof
  admin:
    mode: debug
    listen: 127.0.0.1
    port: 8081
    writer: zap
    pprof:
      enable: true
      prefix: /admin/pprof
  internal:
    mode: release
    listen: 10.0.0.0
    port: 8082
    writer: zap

获取 Engine

// 获取默认实例
engine, err := gin.Engine()

// 获取指定名称的实例
publicEngine, err := gin.GetEngine("public")
adminEngine, err := gin.GetEngine("admin")

// 注册路由
engine.GET("/ping", func(c *gin.Context) {
    c.JSON(200, gin.H{"message": "pong"})
})

工厂模式

配置项说明

单元测试

运行单元测试

# 全部测试可直接运行
go test -v ./...

依赖

• Gin - HTTP Web 框架