gowww/router - 极速HTTP路由器完全兼容net/http.Handler接口

特性

• 极高性能：在大多数情况下可实现亚微秒级路由
• 完全兼容标准库的http.Handler接口
• 通用性：没有魔法方法，使用你自己的处理器
• 支持路径参数、正则表达式和通配符
• 智能优先级路由
• 服务时零内存分配（参数除外）
• 遵循最小意外原则
• 经过测试并用于生产环境

安装

1. 获取包：

go get -u github.com/gowww/router

1. 导入到你的代码中：

import "github.com/gowww/router"

使用示例

基本使用

package main

import (
	"fmt"
	"net/http"
	"github.com/gowww/router"
)

func main() {
	// 1. 创建新路由器
	r := router.New()

	// 2. 添加路由
	r.Handle("GET", "/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprint(w, "Hello, World!")
	}))

	// 3. 启动服务器
	http.ListenAndServe(":8080", r)
}

命名参数

// 添加带命名参数的路由
r.Get("/users/:id", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
	id := router.Parameter(r, "id")
	fmt.Fprintf(w, "User ID: %s", id)
}))

正则表达式参数

// 只匹配数字ID
r.Get(`/users/:id:^\d+$`, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
	id := router.Parameter(r, "id")
	fmt.Fprintf(w, "Numeric User ID: %s", id)
}))

// 不需要获取参数值，只使用正则表达式
r.Get(`/shows/::^prison-break-s06-.+`, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
	fmt.Fprint(w, "Prison Break S06 — Coming soon...")
}))

通配符路由

// 匹配/files/后面的任何路径
r.Get("/files/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
	filepath := router.Parameter(r, "*")
	fmt.Fprintf(w, "Requested file: %s", filepath)
}))

静态文件服务

// 使用标准库的FileServer提供静态文件
r.Get("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("static"))))

自定义404处理器

// 设置自定义的NotFound处理器
r.NotFoundHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
	w.WriteHeader(http.StatusNotFound)
	fmt.Fprint(w, "Custom 404 Page - Not Found")
})

完整示例

package main

import (
	"fmt"
	"net/http"
	"github.com/gowww/router"
)

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

	// 首页
	r.Get("/", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprint(w, "Welcome to the Home Page")
	}))

	// 用户页面
	r.Get("/users/:id", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		id := router.Parameter(r, "id")
		fmt.Fprintf(w, "User Profile Page - ID: %s", id)
	}))

	// 产品页面 - 只匹配数字ID
	r.Get(`/products/:id:^\d+$`, http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		id := router.Parameter(r, "id")
		fmt.Fprintf(w, "Product Details - ID: %s", id)
	}))

	// 静态文件服务
	r.Get("/assets/", http.StripPrefix("/assets/", http.FileServer(http.Dir("public"))))

	// 自定义404
	r.NotFoundHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.WriteHeader(http.StatusNotFound)
		fmt.Fprint(w, "404 - Page Not Found")
	})

	// 启动服务器
	fmt.Println("Server running on :8080")
	http.ListenAndServe(":8080", r)
}

gowww/router是一个高性能、完全兼容标准库的HTTP路由器，提供了简洁的API和强大的路由功能，适合构建各种Web应用和服务。