Golang高性能HTTP请求路由处理插件库goroute的使用

主要特性

• 核心简洁
• 无外部运行时依赖。需要第三方依赖的自定义中间件被放在goroute组织的单独仓库中
• HTTP路由
• 支持中间件
• 全局错误处理

开始使用

前提条件

您需要在本地机器上安装至少Go 1.11版本。

安装

使用go get安装goroute包:

go get -u github.com/goroute/route

第一个服务器示例

创建main.go文件并添加以下内容:

package main

import (
    "net/http"
    "log"
    "github.com/goroute/route"
)

// 定义响应结构体
type helloResponse struct {
	Title string `json:"title"`
}

func main() {
	// 创建新的路由多路复用器
	mux := route.NewServeMux()
	
	// 添加中间件
	mux.Use(func(c route.Context, next route.HandlerFunc) error {
	    log.Println("Hello, Middleware!")
	    return next(c)
	})
	
	// 添加GET路由
	mux.GET("/", func(c route.Context) error {
	    // 返回JSON响应
	    return c.JSON(http.StatusOK, &helloResponse{Title:"Hello, JSON!"})
	})
	
	// 启动服务器
	log.Fatal(http.ListenAndServe(":9000", mux))
}

运行服务器:

go run main.go

更多示例

以下是一个更完整的示例，展示了goroute的更多功能:

package main

import (
	"net/http"
	"log"
	"github.com/goroute/route"
)

// 用户结构体
type User struct {
	ID   int    `json:"id"`
	Name string `json:"name"`
}

func main() {
	r := route.NewServeMux()

	// 日志中间件
	r.Use(func(c route.Context, next route.HandlerFunc) error {
		log.Printf("Request: %s %s", c.Request().Method, c.Request().URL.Path)
		return next(c)
	})

	// 路由分组
	api := r.Group("/api")
	
	// 用户路由
	api.GET("/users", getUsers)
	api.GET("/users/:id", getUser)
	api.POST("/users", createUser)
	api.PUT("/users/:id", updateUser)
	api.DELETE("/users/:id", deleteUser)

	// 静态文件服务
	r.Static("/static", "./public")

	// 自定义404处理
	r.NotFound(func(c route.Context) error {
		return c.JSON(http.StatusNotFound, map[string]string{
			"message": "Not Found",
		})
	})

	// 启动服务器
	log.Println("Server started at :8080")
	log.Fatal(http.ListenAndServe(":8080", r))
}

// 获取用户列表
func getUsers(c route.Context) error {
	users := []User{
		{ID: 1, Name: "John"},
		{ID: 2, Name: "Jane"},
	}
	return c.JSON(http.StatusOK, users)
}

// 获取单个用户
func getUser(c route.Context) error {
	id := c.Param("id") // 获取路由参数
	return c.JSON(http.StatusOK, User{
		ID:   1,
		Name: "User " + id,
	})
}

// 创建用户
func createUser(c route.Context) error {
	var user User
	if err := c.Bind(&user); err != nil { // 绑定请求体
		return c.JSON(http.StatusBadRequest, map[string]string{
			"error": err.Error(),
		})
	}
	// 在这里保存用户...
	return c.JSON(http.StatusCreated, user)
}

// 更新用户
func updateUser(c route.Context) error {
	id := c.Param("id")
	var user User
	if err := c.Bind(&user); err != nil {
		return err
	}
	// 在这里更新用户...
	return c.JSON(http.StatusOK, map[string]string{
		"message": "User " + id + " updated",
	})
}

// 删除用户
func deleteUser(c route.Context) error {
	id := c.Param("id")
	// 在这里删除用户...
	return c.JSON(http.StatusOK, map[string]string{
		"message": "User " + id + " deleted",
	})
}

这个示例展示了:

• 路由分组
• 各种HTTP方法的路由
• 参数获取
• 请求体绑定
• 静态文件服务
• 自定义404处理
• JSON响应

goroute是一个高性能、轻量级的HTTP路由库，非常适合构建RESTful API和服务。