Tsing

Tsing是一个Go语言的HTTP API框架，具有以下功能特性：

• 高性能，零内存分配
• 微核心，仅包含路由和会话管理两大模块
• 轻量，无第三方包依赖，兼容net/http标准包
• 可自动处理路由处理器中的Panic错误，防止进程退出
• 使用回调函数代替传统的内置Logger机掉，异常处理更灵活
• 支持后置回调处理器AfterHandler（仅在路由命中时有效）

Tsing是汉字【青】以及同音字做为名词时的英文，例如：清华大学(Tsinghua University)、青岛(Tsing Tao)。

已经在多个项目中稳定运行。

执行流程

1. 根据URI查找路由
2. 执行Use()方法注册的中间件
3. 执行GET()等方法注册的路由处理器
4. 执行AfterHandler后置处理器，无视之前处理器的执行结果

• 如果任意环节的处理器出现了以下情况，会中止执行后面的处理器
  • 处理器返回了error
  • 处理器中执行了Context.Break()
  • 处理器执行时触发了panic
• 如果路由未命中，只会执行ErrorHandler错误回调处理器，不会触发中间件和后置处理器

安装

要求：Go 1.18+

github.com/dxvgef/tsing/v2

示例

请参考/example_test.go文件

基准测试

测试代码：github.com/dxvgef/tsing-benchmark

Benchmark_TsingV2-8                        50865             23725 ns/op               0 B/op          0 allocs/op
Benchmark_TsingV2_Recover-8                48708             24582 ns/op               0 B/op          0 allocs/op
Benchmark_TsingV1-8                        48664             24875 ns/op               0 B/op          0 allocs/op
Benchmark_TsingV1_Recover-8                45986             26267 ns/op               0 B/op          0 allocs/op
Benchmark_Gin-8                            47978             24542 ns/op               0 B/op          0 allocs/op
Benchmark_Gin_Recover-8                    43753             27390 ns/op               0 B/op          0 allocs/op
Benchmark_Httprouter-8                     46738             25555 ns/op           13792 B/op        167 allocs/op
Benchmark_Httprouter_Recover-8             44786             26703 ns/op           13792 B/op        167 allocs/op
Benchmark_Echo-8                           38401             31216 ns/op               0 B/op          0 allocs/op
Benchmark_Echo_Recover-8                   28674             41750 ns/op            9748 B/op        203 allocs/op
Benchmark_HTTPTreemux-8                    15448             77755 ns/op           65857 B/op        671 allocs/op

相关资源

• dxvgef/tsing-demo Tsing整合常见功能的示例项目，可以做为新项目初始化使用
• dxvgef/filter 参数值过滤包，由数据输入、格式化、校验、输出几个部份组成
• Tsing Gateway 跨平台、去中心化集群、动态配置的API网关
• Tsing Center 跨平台、去中心化集群、动态配置的服务中心

用户案例

如果你在使用本项目，请通过Issues告知我们项目的简介

帮助反馈

本项目已在多个项目的生产环境中稳定运行。如有问题可在Issues里提出。

诚邀更多的开发者参与到本项目维护中，帮助这个开源项目更好的发展。