🍃 GoRouter - 高性能HTTP请求路由和中间件支持插件库

GoRouter是一个Go语言服务器/API微框架，提供HTTP请求路由器、多路复用器和mux功能。

主要特性

• 路由系统
• 中间件系统
• 认证支持
• 快速HTTP处理
• 文件服务
• 多域名支持
• HTTP2支持
• 低内存占用

基准测试

➜  gorouter git:(master) ✗ go test -bench=. -cpu=4 -benchmem
test
goos: darwin
goarch: amd64
pkg: github.com/vardius/gorouter/v4
BenchmarkNetHTTP-4              65005786        17.9 ns/op       0 B/op       0 allocs/op
BenchmarkFastHTTP-4             69810878        16.5 ns/op       0 B/op       0 allocs/op
PASS
ok   github.com/vardius/gorouter/v4 3.808s

基本使用示例

net/http 示例

package main

import (
    "fmt"
    "net/http"

    "github.com/vardius/gorouter/v4"
)

func main() {
    // 创建路由器
    router := gorouter.New()
    
    // 添加路由
    router.GET("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprint(w, "Hello, World!")
    })
    
    // 添加带参数的路由
    router.GET("/users/{id:[0-9]+}", func(w http.ResponseWriter, r *http.Request) {
        params := gorouter.FromContext(r.Context())
        fmt.Fprintf(w, "User ID: %s", params.Value("id"))
    })
    
    // 添加中间件
    logger := func(next http.Handler) http.Handler {
        return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
            fmt.Printf("Request: %s %s\n", r.Method, r.URL.Path)
            next.ServeHTTP(w, r)
        })
    }
    
    // 使用中间件
    router.Use(logger)
    
    // 启动服务器
    http.ListenAndServe(":8080", router)
}

fasthttp 示例

package main

import (
    "fmt"

    "github.com/valyala/fasthttp"
    "github.com/vardius/gorouter/v4"
    "github.com/vardius/gorouter/v4/context"
)

func main() {
    // 创建路由器
    router := gorouter.NewFastHTTPRouter()
    
    // 添加路由
    router.GET("/", func(c *fasthttp.RequestCtx) {
        fmt.Fprint(c, "Hello, World!")
    })
    
    // 添加带参数的路由
    router.GET("/users/{id:[0-9]+}", func(c *fasthttp.RequestCtx) {
        params := context.Parameters(c)
        fmt.Fprintf(c, "User ID: %s", params.Value("id"))
    })
    
    // 添加中间件
    logger := func(next fasthttp.RequestHandler) fasthttp.RequestHandler {
        return func(c *fasthttp.RequestCtx) {
            fmt.Printf("Request: %s %s\n", c.Method(), c.Path())
            next(c)
        }
    }
    
    // 使用中间件
    router.Use(logger)
    
    // 启动服务器
    fasthttp.ListenAndServe(":8080", router.HandleFastHTTP)
}

文件服务示例

package main

import (
    "net/http"

    "github.com/vardius/gorouter/v4"
)

func main() {
    router := gorouter.New()
    
    // 提供静态文件服务
    router.GET("/static/{filepath:*}", func(w http.ResponseWriter, r *http.Request) {
        params := gorouter.FromContext(r.Context())
        http.ServeFile(w, r, "static/"+params.Value("filepath"))
    })
    
    http.ListenAndServe(":8080", router)
}

多域名支持

package main

import (
    "net/http"

    "github.com/vardius/gorouter/v4"
)

func main() {
    router := gorouter.New()
    
    // 主域名路由
    router.GET("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprint(w, "Main Domain")
    })
    
    // 子域名路由
    subdomain := router.Subdomain("api")
    subdomain.GET("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprint(w, "API Subdomain")
    })
    
    http.ListenAndServe(":8080", router)
}

认证中间件示例

package main

import (
    "net/http"

    "github.com/vardius/gorouter/v4"
)

func authMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        token := r.Header.Get("Authorization")
        if token != "valid-token" {
            http.Error(w, "Unauthorized", http.StatusUnauthorized)
            return
        }
        next.ServeHTTP(w, r)
    })
}

func main() {
    router := gorouter.New()
    
    // 受保护的路由
    protected := router.Group("/api")
    protected.Use(authMiddleware)
    protected.GET("/data", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprint(w, "Protected Data")
    })
    
    http.ListenAndServe(":8080", router)
}

路由组示例

package main

import (
    "fmt"
    "net/http"

    "github.com/vardius/gorouter/v4"
)

func main() {
    router := gorouter.New()
    
    // 创建API路由组
    api := router.Group("/api")
    api.GET("/users", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprint(w, "List Users")
    })
    api.POST("/users", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprint(w, "Create User")
    })
    
    // 创建管理员路由组
    admin := router.Group("/admin")
    admin.Use(authMiddleware)
    admin.GET("/dashboard", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprint(w, "Admin Dashboard")
    })
    
    http.ListenAndServe(":8080", router)
}

GoRouter是一个功能强大且高性能的HTTP路由库，支持多种功能和灵活的中间件系统，非常适合构建Web应用程序和API服务。