天网安防>> elton>> 返回
项目作者： vicanso

项目描述 ：
High performance, simple Go web framework
高级语言： Go
项目地址: git://github.com/vicanso/elton.git
创建时间： 2018-11-30T13:10:48Z
项目社区：https://github.com/vicanso/elton
开源协议：MIT License
下载


Elton

license
Build Status

Alt

Elton的实现参考了koa以及echo，中间件的调用为洋葱模型：请求由外至内，响应由内至外。主要特性如下：

  • 处理函数（中间件）均以返回error的形式响应出错，方便使用统一的出错处理中间件将出错统一转换为对应的输出（JSON），并根据出错的类型等生成各类统计分析
  • 成功响应数据直接赋值至Context.Body（interface{})，由统一的响应中间件将其转换为对应的输出（JSON，XML）
  • 支持不同种类的事件，如OnBefore、OnDone、OnError等，方便添加各类统计行为

如何使用elton开发WEB后端程序，可以参考一步一步学习如何使用elton

Hello, World!

下面我们来演示如何使用elton返回Hello, World!，并且添加了一些常用的中间件。

  1. package main
  3. import (
  4.     "github.com/vicanso/elton"
  5.     "github.com/vicanso/elton/middleware"
  6. )
  8. func main() {
  9.     e := elton.New()
  11.     // panic处理
  12.     e.Use(middleware.NewRecover())
  14.     // 出错处理
  15.     e.Use(middleware.NewDefaultError())
  17.     // 默认的请求数据解析
  18.     e.Use(middleware.NewDefaultBodyParser())
  20.     // not modified 304的处理
  21.     e.Use(middleware.NewDefaultFresh())
  22.     e.Use(middleware.NewDefaultETag())
  24.     // 响应数据转换为json
  25.     e.Use(middleware.NewDefaultResponder())
  27.     e.GET("/", func(c *elton.Context) error {
  28.         c.Body = &struct {
  29.             Message string `json:"message,omitempty"`
  30.         }{
  31.             "Hello, World!",
  32.         }
  33.         return nil
  34.     })
  36.     e.GET("/books/{id}", func(c *elton.Context) error {
  37.         c.Body = &struct {
  38.             ID string `json:"id,omitempty"`
  39.         }{
  40.             c.Param("id"),
  41.         }
  42.         return nil
  43.     })
  45.     e.POST("/login", func(c *elton.Context) error {
  46.         c.SetContentTypeByExt(".json")
  47.         c.Body = c.RequestBody
  48.         return nil
  49.     })
  51.     err := e.ListenAndServe(":3000")
  52.     if err != nil {
  53.         panic(err)
  54.     }
  55. }
  1. go run main.go

之后在浏览器中打开http://localhost:3000/则能看到返回的Hello, World!。

路由

elton每个路由可以添加多个中间件处理函数，根据路由与及HTTP请求方法指定不同的路由处理函数。而全局的中间件则可通过Use方法来添加。

  1. e.Use(...func(*elton.Context) error)
  2. e.Method(path string, ...func(*elton.Context) error)
  • e 为elton实例化对象
  • Method 为HTTP的请求方法，如：GET, PUT, POST等等
  • path 为HTTP路由路径
  • func(*elton.Context) error 为路由处理函数（中间件），当匹配的路由被请求时，对应的处理函数则会被调用

路由示例

elton的路由使用chi的路由简化而来，下面是两个简单的示例。

  1. // 带参数路由
  2. e.GET("/users/{type}", func(c *elton.Context) error {
  3.     c.BodyBuffer = bytes.NewBufferString(c.Param("type"))
  4.     return nil
  5. })
  7. // 复合参数
  8. e.GET("/books/{category:[a-z-]+}-{type}", func(c *elton.Context) error {
  9.     c.BodyBuffer = bytes.NewBufferString(c.Param("category") + c.Param("type"))
  10.     return nil
  11. })
  13. // 带中间件的路由配置
  14. e.GET("/users/me", func(c *elton.Context) error {
  15.     c.Set("account", "tree.xie")
  16.     return c.Next()
  17. }, func(c *elton.Context) error {
  18.     c.BodyBuffer = bytes.NewBufferString(c.GetString("account"))
  19.     return nil
  20. })

中间件

简单方便的中间件机制，依赖各类定制的中间件，通过各类中间件的组合，方便快捷实现各类HTTP服务，简单介绍数据响应与出错处理的中间件。需要注意，elton中默认不会执行所有的中间件，每个中间件决定是否需要执行后续处理，如果需要则调用Next()函数，与gin不一样(gin默认为执行所有，若不希望执行后续的中间件，则调用Abort)。

responder

HTTP请求响应数据时，需要将数据转换为Buffer返回，而在应用时响应数据一般为各类的struct或map等结构化数据，因此elton提供了Body(interface{})字段来保存这些数据，再使用自定义的中间件将数据转换为对应的字节数据，elton-responder提供了将struct(map)转换为json字节并设置对应的Content-Type，对于string([]byte)则直接输出。

  1. package main
  3. import (
  4.     "github.com/vicanso/elton"
  5.     "github.com/vicanso/elton/middleware"
  6. )
  8. func main() {
  10.     e := elton.New()
  11.     // 对响应数据 c.Body 转换为相应的json响应
  12.     e.Use(middleware.NewDefaultResponder())
  14.     getSession := func(c *elton.Context) error {
  15.         c.Set("account", "tree.xie")
  16.         return c.Next()
  17.     }
  18.     e.GET("/users/me", getSession, func(c *elton.Context) (err error) {
  19.         c.Body = &struct {
  20.             Name string `json:"name"`
  21.             Type string `json:"type"`
  22.         }{
  23.             c.GetString("account"),
  24.             "vip",
  25.         }
  26.         return
  27.     })
  29.     err := e.ListenAndServe(":3000")
  30.     if err != nil {
  31.         panic(err)
  32.     }
  33. }

error

当请求处理失败时，直接返回error则可，elton从error中获取出错信息并输出。默认的出错处理并不适合实际应用场景，建议使用自定义出错类配合中间件，便于统一的错误处理，程序监控，下面是引入错误中间件将出错转换为json形式的响应。

  1. package main
  3. import (
  4.     "github.com/vicanso/elton"
  5.     "github.com/vicanso/elton/middleware"
  6.     "github.com/vicanso/hes"
  7. )
  9. func main() {
  11.     e := elton.New()
  12.     // 指定出错以json的形式返回
  13.     e.Use(middleware.NewError(middleware.ErrorConfig{
  14.         ResponseType: "json",
  15.     }))
  17.     e.GET("/", func(c *elton.Context) (err error) {
  18.         err = &hes.Error{
  19.             StatusCode: 400,
  20.             Category:   "users",
  21.             Message:    "出错啦",
  22.         }
  23.         return
  24.     })
  26.     err := e.ListenAndServe(":3000")
  27.     if err != nil {
  28.         panic(err)
  29.     }
  30. }

更多的中间件可以参考middlewares

bench

  1. goos: darwin
  2. goarch: amd64
  3. pkg: github.com/vicanso/elton
  4. BenchmarkRoutes-8                        6925746               169.4 ns/op           120 B/op          2 allocs/op
  5. BenchmarkGetFunctionName-8              136577900                9.265 ns/op           0 B/op          0 allocs/op
  6. BenchmarkContextGet-8                   15311328                78.11 ns/op           16 B/op          1 allocs/op
  7. BenchmarkContextNewMap-8                187684261                6.276 ns/op           0 B/op          0 allocs/op
  8. BenchmarkConvertServerTiming-8           1484379               835.8 ns/op           360 B/op         11 allocs/op
  9. BenchmarkGetStatus-8                    1000000000               0.2817 ns/op          0 B/op          0 allocs/op
  10. BenchmarkFresh-8                          955664              1233 ns/op             416 B/op         10 allocs/op
  11. BenchmarkStatic-8                          25128             46709 ns/op           20794 B/op        471 allocs/op
  12. BenchmarkGitHubAPI-8                       14724             76190 ns/op           27175 B/op        609 allocs/op
  13. BenchmarkGplusAPI-8                       326769              3659 ns/op            1717 B/op         39 allocs/op
  14. BenchmarkParseAPI-8                       162340              6989 ns/op            3435 B/op         78 allocs/op
  15. BenchmarkRWMutexSignedKeys-8            71757390                17.51 ns/op            0 B/op          0 allocs/op
  16. BenchmarkAtomicSignedKeys-8             923771157                1.297 ns/op           0 B/op          0 allocs/op
  17. PASS
  18. ok      github.com/vicanso/elton        20.225s
  19. goos: darwin
  20. goarch: amd64
  21. pkg: github.com/vicanso/elton/middleware
  22. BenchmarkGenETag-8                        230718              4409 ns/op             160 B/op          6 allocs/op
  23. BenchmarkMd5-8                            200134              5958 ns/op             120 B/op          6 allocs/op
  24. BenchmarkNewShortHTTPHeader-8           10220961               116.4 ns/op            80 B/op          2 allocs/op
  25. BenchmarkNewHTTPHeader-8                 4368654               277.1 ns/op            88 B/op          3 allocs/op
  26. BenchmarkNewHTTPHeaders-8                 384062              2822 ns/op            1182 B/op         23 allocs/op
  27. BenchmarkHTTPHeaderMarshal-8              225123              4664 ns/op            1344 B/op         21 allocs/op
  28. BenchmarkToHTTPHeader-8                   296210              3834 ns/op            1272 B/op         34 allocs/op
  29. BenchmarkHTTPHeaderUnmarshal-8            120136             10108 ns/op            1888 B/op         50 allocs/op
  30. BenchmarkProxy-8                           13393             85170 ns/op           16031 B/op        104 allocs/op
  31. PASS
  32. ok      github.com/vicanso/elton/middleware     14.007s