Don - 高性能简易Golang API开发框架

Don是一个轻量级、高性能的Golang API开发框架，专注于简单性和性能。下面我将介绍Don框架的核心特性以及如何使用它来开发API。

安装Don

go get github.com/abemedia/go-don

基本使用示例

package main

import (
	"github.com/abemedia/go-don"
	"github.com/abemedia/go-don/pkg/httputil"
	"net/http"
)

func main() {
	// 创建Don应用
	app := don.New(nil)

	// 添加路由
	app.Get("/", func(w http.ResponseWriter, r *http.Request) {
		httputil.JSON(w, http.StatusOK, map[string]string{"message": "Hello, Don!"})
	})

	// 启动服务器
	app.Listen(":8080")
}

核心特性

1. 路由系统

Don提供了简单直观的路由系统：

app.Get("/users", getUsers)
app.Post("/users", createUser)
app.Put("/users/:id", updateUser)
app.Delete("/users/:id", deleteUser)

2. 中间件支持

// 日志中间件
func logger(next http.Handler) http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		log.Println(r.Method, r.URL.Path)
		next.ServeHTTP(w, r)
	})
}

// 使用中间件
app.Use(logger)

3. 参数绑定

Don支持自动参数绑定：

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

app.Post("/users", func(w http.ResponseWriter, r *http.Request) {
	var user User
	if err := httputil.Bind(r, &user); err != nil {
		httputil.Error(w, err.Error(), http.StatusBadRequest)
		return
	}
	
	// 处理用户数据...
})

4. 高性能设计

Don通过以下方式实现高性能：

• 最小化内存分配
• 避免反射
• 优化的路由匹配算法

高级用法

1. 分组路由

api := app.Group("/api")
api.Get("/version", getVersion)

users := api.Group("/users")
users.Get("/", getUsers)
users.Post("/", createUser)

2. 自定义错误处理

app.ErrorHandler = func(w http.ResponseWriter, r *http.Request, err error) {
	status := http.StatusInternalServerError
	if e, ok := err.(*httputil.HTTPError); ok {
		status = e.Code
	}
	
	httputil.JSON(w, status, map[string]string{
		"error": err.Error(),
	})
}

3. 静态文件服务

app.Static("/static", "./public")

性能对比

Don在设计上比许多流行框架更轻量级：

最佳实践

1. 保持处理程序简洁：将业务逻辑移到单独的服务层
2. 使用中间件处理横切关注点：如日志、认证、限流等
3. 合理使用上下文：避免在请求间共享可变状态
4. 启用压缩：对于API响应可以显著减少带宽

app.Use(func(next http.Handler) http.Handler {
	return httputil.CompressHandler(next)
})

完整示例

package main

import (
	"github.com/abemedia/go-don"
	"github.com/abemedia/go-don/pkg/httputil"
	"net/http"
	"log"
)

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

var users = []User{
	{ID: "1", Name: "Alice", Email: "alice@example.com"},
	{ID: "2", Name: "Bob", Email: "bob@example.com"},
}

func main() {
	app := don.New(nil)
	
	// 中间件
	app.Use(logger)
	
	// 路由
	api := app.Group("/api")
	api.Get("/users", getUsers)
	api.Get("/users/:id", getUser)
	api.Post("/users", createUser)
	
	app.Listen(":8080")
}

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

func getUsers(w http.ResponseWriter, r *http.Request) {
	httputil.JSON(w, http.StatusOK, users)
}

func getUser(w http.ResponseWriter, r *http.Request) {
	id := httputil.Params(r).Get("id")
	for _, user := range users {
		if user.ID == id {
			httputil.JSON(w, http.StatusOK, user)
			return
		}
	}
	httputil.Error(w, "User not found", http.StatusNotFound)
}

func createUser(w http.ResponseWriter, r *http.Request) {
	var user User
	if err := httputil.Bind(r, &user); err != nil {
		httputil.Error(w, err.Error(), http.StatusBadRequest)
		return
	}
	
	users = append(users, user)
	httputil.JSON(w, http.StatusCreated, user)
}

Don框架以其简洁性和高性能成为开发轻量级API服务的优秀选择。它避免了过度设计，专注于提供构建现代API所需的核心功能，同时保持出色的性能表现。