Goji - Golang轻量级HTTP请求多路复用器

Goji是一个轻量级、快速的HTTP请求多路复用器（router），适用于构建高性能的Go Web应用程序。它设计简洁，API直观，同时提供了足够的功能来满足大多数Web开发需求。

主要特点

1. 轻量级：核心代码精简，性能高效
2. 支持中间件：易于扩展功能
3. 路径匹配：支持参数化路径
4. 兼容标准库：可与net/http无缝集成
5. 上下文支持：内置请求上下文管理

安装

go get goji.io

基本使用示例

package main

import (
	"fmt"
	"net/http"
	
	"goji.io"
	"goji.io/pat"
)

func main() {
	// 创建新的Goji多路复用器
	mux := goji.NewMux()
	
	// 添加路由
	mux.HandleFunc(pat.Get("/"), func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintf(w, "欢迎访问首页!")
	})
	
	mux.HandleFunc(pat.Get("/hello/:name"), func(w http.ResponseWriter, r *http.Request) {
		name := pat.Param(r, "name")
		fmt.Fprintf(w, "你好, %s!", name)
	})
	
	// 启动服务器
	http.ListenAndServe(":8080", mux)
}

路由参数

Goji支持路径参数，使用:前缀定义：

mux.HandleFunc(pat.Get("/user/:id"), func(w http.ResponseWriter, r *http.Request) {
    id := pat.Param(r, "id")
    fmt.Fprintf(w, "用户ID: %s", id)
})

中间件使用

Goji的中间件系统非常灵活，可以轻松添加全局或特定路由的中间件：

func logger(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        fmt.Printf("%s %s\n", r.Method, r.URL.Path)
        next.ServeHTTP(w, r)
    })
}

func main() {
    mux := goji.NewMux()
    mux.Use(logger)
    
    // ... 路由定义
}

子路由

可以创建子路由来处理特定路径前缀下的请求：

func main() {
    mux := goji.NewMux()
    
    // 创建API子路由
    apiMux := goji.SubMux()
    mux.Handle(pat.New("/api/*"), apiMux)
    
    // 在API子路由上添加处理器
    apiMux.HandleFunc(pat.Get("/users"), listUsers)
    apiMux.HandleFunc(pat.Post("/users"), createUser)
}

实际项目示例

下面是一个更完整的示例，展示如何在实际项目中使用Goji：

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"time"
	
	"goji.io"
	"goji.io/pat"
)

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

var users = map[string]User{
	"1": {ID: "1", Name: "张三"},
	"2": {ID: "2", Name: "李四"},
}

func main() {
	mux := goji.NewMux()
	
	// 添加全局中间件
	mux.Use(loggingMiddleware)
	
	// 路由定义
	mux.HandleFunc(pat.Get("/"), homeHandler)
	mux.HandleFunc(pat.Get("/users"), listUsersHandler)
	mux.HandleFunc(pat.Get("/users/:id"), getUserHandler)
	mux.HandleFunc(pat.Post("/users"), createUserHandler)
	
	// 启动服务器
	fmt.Println("服务器启动在 :8080")
	log.Fatal(http.ListenAndServe(":8080", mux))
}

func loggingMiddleware(next http.Handler) http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		start := time.Now()
		next.ServeHTTP(w, r)
		log.Printf("%s %s %v", r.Method, r.URL.Path, time.Since(start))
	})
}

func homeHandler(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "欢迎使用用户管理系统")
}

func listUsersHandler(w http.ResponseWriter, r *http.Request) {
	json.NewEncoder(w).Encode(users)
}

func getUserHandler(w http.ResponseWriter, r *http.Request) {
	id := pat.Param(r, "id")
	user, exists := users[id]
	if !exists {
		http.NotFound(w, r)
		return
	}
	json.NewEncoder(w).Encode(user)
}

func createUserHandler(w http.ResponseWriter, r *http.Request) {
	var user User
	if err := json.NewDecoder(r.Body).Decode(&user); err != nil {
		http.Error(w, err.Error(), http.StatusBadRequest)
		return
	}
	
	users[user.ID] = user
	w.WriteHeader(http.StatusCreated)
	json.NewEncoder(w).Encode(user)
}

与标准库对比

相比标准库的http.ServeMux，Goji提供了：

• 更灵活的路由匹配（支持参数）
• 内置中间件支持
• 更好的路径处理
• 请求上下文管理

性能考虑

Goji在性能上做了优化：

1. 快速路由匹配
2. 最小化内存分配
3. 避免不必要的处理

总结

Goji是一个非常适合中小型项目的轻量级路由器，它提供了足够的功能而不引入过多复杂性。如果你需要一个比标准库更强大但比大型框架更轻量的解决方案，Goji是一个很好的选择。

对于更复杂的项目，你可能需要考虑更全功能的框架如Gin或Echo，但对于大多数用例，Goji提供了完美的平衡。