FasthttpRouter - 高性能Golang HTTP路由库

FasthttpRouter是基于fasthttp的高性能HTTP请求路由器，它比标准库的net/http路由性能更高，内存分配更少。下面我将详细介绍它的使用方法和最佳实践。

基本特性

1. 高性能：基于fasthttp，比标准库快很多
2. 零内存分配：路由匹配过程几乎不分配内存
3. 支持路径参数：可以轻松提取URL中的参数
4. 轻量级：代码简洁，依赖少

安装

go get github.com/fasthttp/router
go get github.com/valyala/fasthttp

基本使用

package main

import (
	"fmt"
	"log"

	"github.com/fasthttp/router"
	"github.com/valyala/fasthttp"
)

func main() {
	r := router.New()

	// 注册路由
	r.GET("/", Index)
	r.GET("/hello/{name}", Hello)
	r.POST("/user", CreateUser)

	// 启动服务器
	log.Fatal(fasthttp.ListenAndServe(":8080", r.Handler))
}

func Index(ctx *fasthttp.RequestCtx) {
	fmt.Fprint(ctx, "Welcome!\n")
}

func Hello(ctx *fasthttp.RequestCtx) {
	name := ctx.UserValue("name").(string)
	fmt.Fprintf(ctx, "Hello, %s!\n", name)
}

func CreateUser(ctx *fasthttp.RequestCtx) {
	// 处理POST请求
	fmt.Fprint(ctx, "User created\n")
}

路由参数

FasthttpRouter支持多种参数匹配模式：

r := router.New()

// 命名参数
r.GET("/user/{id}", GetUser)

// 通配符参数
r.GET("/static/{filepath:*}", StaticFile)

// 可选参数
r.GET("/search/{query?}", Search)

路由分组

r := router.New()

// 用户相关路由
user := r.Group("/user")
user.GET("/", ListUsers)
user.POST("/", CreateUser)
user.GET("/{id}", GetUser)
user.PUT("/{id}", UpdateUser)
user.DELETE("/{id}", DeleteUser)

中间件支持

func Logger(next fasthttp.RequestHandler) fasthttp.RequestHandler {
	return func(ctx *fasthttp.RequestCtx) {
		start := time.Now()
		next(ctx)
		fmt.Printf("%s %s %s %v\n", 
			ctx.Method(), 
			ctx.Path(), 
			ctx.Response.StatusCode(), 
			time.Since(start))
	}
}

func main() {
	r := router.New()
	r.GET("/", Index)
	
	// 应用中间件
	wrappedHandler := Logger(r.Handler)
	
	fasthttp.ListenAndServe(":8080", wrappedHandler)
}

性能优化技巧

1. 复用RequestCtx对象：fasthttp会复用ctx对象，不要在handler间传递它
2. 避免频繁内存分配：使用ctx.PostBody()而不是ioutil.ReadAll
3. 使用sync.Pool：对于频繁创建的对象使用对象池

var bufferPool = sync.Pool{
	New: func() interface{} {
		return &bytes.Buffer{}
	},
}

func Handler(ctx *fasthttp.RequestCtx) {
	buf := bufferPool.Get().(*bytes.Buffer)
	defer bufferPool.Put(buf)
	
	buf.Reset()
	// 使用buf处理数据
}

错误处理

r := router.New()
r.NotFound = func(ctx *fasthttp.RequestCtx) {
	ctx.SetStatusCode(fasthttp.StatusNotFound)
	fmt.Fprint(ctx, "Custom 404 page")
}

r.MethodNotAllowed = func(ctx *fasthttp.RequestCtx) {
	ctx.SetStatusCode(fasthttp.StatusMethodNotAllowed)
	fmt.Fprint(ctx, "Method not allowed")
}

实际案例：REST API服务

package main

import (
	"encoding/json"
	"log"

	"github.com/fasthttp/router"
	"github.com/valyala/fasthttp"
)

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

var users = make(map[string]User)

func main() {
	r := router.New()

	// 用户路由
	r.GET("/users", listUsers)
	r.POST("/users", createUser)
	r.GET("/users/{id}", getUser)
	r.PUT("/users/{id}", updateUser)
	r.DELETE("/users/{id}", deleteUser)

	log.Fatal(fasthttp.ListenAndServe(":8080", r.Handler))
}

func listUsers(ctx *fasthttp.RequestCtx) {
	userList := make([]User, 0, len(users))
	for _, u := range users {
		userList = append(userList, u)
	}
	json.NewEncoder(ctx).Encode(userList)
}

func createUser(ctx *fasthttp.RequestCtx) {
	var user User
	if err := json.Unmarshal(ctx.PostBody(), &user); err != nil {
		ctx.Error(err.Error(), fasthttp.StatusBadRequest)
		return
	}
	users[user.ID] = user
	ctx.SetStatusCode(fasthttp.StatusCreated)
}

// 其他handler实现类似...

注意事项

1. Fasthttp与标准库不兼容，不能混用net/http的handler
2. RequestCtx的生命周期只在当前请求有效
3. 某些标准库的特性在fasthttp中可能不可用

FasthttpRouter非常适合需要高性能HTTP服务的场景，特别是高并发、低延迟要求的应用。根据基准测试，它比标准库的路由性能高出数倍，内存分配也少得多。