中文 (opens new window) / English (opens new window)

YoyoGo 简单、轻量、快速、基于依赖注入的微服务框架

  • 文档: http://dev.yoyogo.run

Release Go GoVersion Report (opens new window) Documentation (opens new window) Contributors License (opens new window)

# YoyoGo 特色

  • 漂亮又快速的路由器 & MVC 模式 .
  • 丰富的中间件支持 (handler func & custom middleware) .
  • 微服务框架抽象了分层,在一个框架体系兼容各种server实现,如 rest,grpc等 .
  • 充分运用依赖注入DI,管理运行时生命周期,为框架提供了强大的扩展性 .
  • 功能强大的微服务集成能力 (Nacos, Eureka, Consul, ETCD) .
  • 受到许多出色的 Go Web 框架的启发,并实现了多种 server : fasthttpnet.httpgrpc .

framework desgin

QQ交流群: 780385870 (opens new window) (Go浪文学院) , 在这里感谢贾国锦帮忙设计的logo很漂亮。

也可以加入我的公众号,通过公众号入群菜单进入微信群,主要还是在微信上活动啦。

# 框架安装

go get github.com/yoyofx/yoyogo

# 安装依赖 (由于某些原因国内下载不了依赖)

# go version < 1.13

window 下在 cmd 中执行:
set GO111MODULE=on
set GOPROXY=https://goproxy.cn,direct
linux  下执行:
export GO111MODULE=on
export GOPROXY=https://goproxy.cn,direct

# go version >= 1.13

go env -w GOPROXY=https://goproxy.cn,direct

# vendor

go mod vendor       // 将依赖包拷贝到项目目录中去

# 简单的例子

package main
import ...

func main() {
	WebApplication.CreateDefaultBuilder(func(rb router.IRouterBuilder) {
        rb.GET("/info",func (ctx *context.HttpContext) {    // 支持Group方式
            ctx.JSON(200, context.H{"info": "ok"})
        })
    }).Build().Run()       //默认端口号 :8080
}

# 实现进度

# 标准功能

  • [X] 打印Logo和日志(YoyoGo)
  • [X] 统一程序输入参数和环境变量 (YoyoGo)
  • [X] 简单路由器绑定句柄功能
  • [X] HttpContext 上下文封装(请求,响应)
  • [X] 静态文件端点(静态文件服务器)
  • [X] JSON 序列化结构(Context.H)
  • [X] 获取请求文件并保存
  • [X] 获取请求数据(form-data,x-www-form-urlencoded,Json ,XML,Protobuf 等)
  • [X] Http 请求的绑定模型(Url, From,JSON,XML,Protobuf)

# 响应渲染功能

  • [X] Render Interface
  • [X] JSON Render
  • [X] JSONP Render
  • [X] Indented Json Render
  • [X] Secure Json Render
  • [X] Ascii Json Render
  • [X] Pure Json Render
  • [X] Binary Data Render
  • [X] TEXT
  • [X] Protobuf
  • [X] MessagePack
  • [X] XML
  • [X] YAML
  • [X] File
  • [X] Image
  • [X] Template
  • [X] Auto formater Render

# 中间件

  • [X] Logger
  • [X] StaticFile
  • [X] Router Middleware
  • [X] CORS
  • [X] Binding
  • [X] JWT
  • [X] RequestId And Tracker for SkyWorking

# 路由

  • [x] GET,POST,HEAD,PUT,DELETE 方法支持
  • [x] 路由解析树与表达式支持
  • [x] RouteData路由数据 (/api/:version/) 与 Binding的集成
  • [x] 路由组功能
  • [x] MVC默认模板功能
  • [x] 路由过滤器 Filter

# MVC

  • [x] 路由请求触发Controller&Action
  • [x] Action方法参数绑定
  • [x] 内部对象的DI化
  • [x] 关键对象的参数传递

# Dependency injection

  • [X] 抽象集成第三方DI框架
  • [X] MVC模式集成
  • [X] 框架级的DI支持功能

# 扩展

  • [X] 配置
  • [X] WebSocket
  • [X] JWT
  • [ ] swagger
  • [X] GRpc
  • [X] Prometheus