YoyoGo
YoyoGo 是一個用 Go 編寫的簡單，輕便，快速的 微服務框架，目前已實現了Web框架的能力，但是底層設計已支持多種服務架構。
Github
https://github.com/yoyofx/yoyogo
特色
- 漂亮又快速的路由器
- 中間件支持 (handler func & custom middleware)
- 對 REST API 友好
- 支持 MVC 模式
- 受到許多出色的 Go Web 框架的啟發
框架安裝
go get github.com/yoyofx/yoyogo
安裝依賴 (由於某些原因國內下載不了依賴)
go version < 1.13
window 下在 cmd 中執行：
set GO111MODULE=on
set GOPROXY=https://goproxy.cn
linux 下執行：
export GO111MODULE=on
export GOPROXY=https://goproxy.cn
go version >= 1.13
go env -w GOPROXY=https://goproxy.cn,direct
簡單的例子
package main
import ...
func main() {
YoyoGo.CreateDefaultBuilder(func(router Router.IRouterBuilder) {
router.GET("/info",func (ctx *Context.HttpContext) { // 支持Group方式
ctx.JSON(200, Context.M{"info": "ok"})
})
}).Build().Run() //默認端口號 :8080
}
實現進度
標準功能
- [X] 打印Logo和日誌（YoyoGo）
- [X] 統一程序輸入參數和環境變量 (YoyoGo)
- [X] 簡單路由器綁定句柄功能
- [X] HttpContext 上下文封裝(請求，響應)
- [X] 靜態文件端點（靜態文件服務器）
- [X] JSON 序列化結構（Context.M）
- [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
- [ ] Session
- [ ] CORS
- [ ] GZip
- [X] Binding
- [ ] Binding Valateion
路由
- [x] GET，POST，HEAD，PUT，DELETE 方法支持
- [x] 路由解析樹與表達式支持
- [x] RouteData路由數據 (/api/:version/) 與 Binding的集成
- [x] 路由組功能
- [ ] MVC默認模板功能
- [ ] 路由過濾器 Filter
MVC
- [x] 路由請求觸發Controller&Action
- [X] Action方法參數綁定
- [ ] 內部對象的DI化
- [ ] 關鍵對象的參數傳遞
Dependency injection
- [X] 抽象集成第三方DI框架
- [X] MVC模式集成
- [X] 框架級的DI支持功能
擴展
- [ ] 配置
- [ ] WebSocket
- [ ] JWT
- [ ] swagger
- [ ] GRpc
- [ ] OAuth2
- [ ] Prometheus
- [ ] 安全
進階範例
package main
import ...
func main() {
webHost := CreateCustomWebHostBuilder().Build()
webHost.Run()
}
// 自定義HostBuilder並支持 MVC 和 自動參數綁定功能，簡單情況也可以直接使用CreateDefaultBuilder 。
func CreateCustomBuilder() *Abstractions.HostBuilder {
return YoyoGo.NewWebHostBuilder().
SetEnvironment(Context.Prod).
UseFastHttp().
//UseServer(YoyoGo.DefaultHttps(":8080", "./Certificate/server.pem", "./Certificate/server.key")).
Configure(func(app *YoyoGo.WebApplicationBuilder) {
app.UseStatic("Static")
app.UseEndpoints(registerEndpointRouterConfig)
app.UseMvc(func(builder *Mvc.ControllerBuilder) {
builder.AddController(contollers.NewUserController)
})
}).
ConfigureServices(func(serviceCollection *DependencyInjection.ServiceCollection) {
serviceCollection.AddTransientByImplements(models.NewUserAction, new(models.IUserAction))
}).
OnApplicationLifeEvent(getApplicationLifeEvent)
}
//region endpoint 路由綁定函數
func registerEndpoints(router Router.IRouterBuilder) {
router.GET("/error", func(ctx *Context.HttpContext) {
panic("http get error")
})
//POST 請求: /info/:id ?q1=abc&username=123
router.POST("/info/:id", func (ctx *Context.HttpContext) {
qs_q1 := ctx.Query("q1")
pd_name := ctx.Param("username")
userInfo := &UserInfo{}
_ = ctx.Bind(userInfo) // 手動綁定請求對象
strResult := fmt.Sprintf("Name:%s , Q1:%s , bind: %s", pd_name, qs_q1, userInfo)
ctx.JSON(200, Std.M{"info": "hello world", "result": strResult})
})
// 路由組功能實現綁定 GET 請求: /v1/api/info
router.Group("/v1/api", func(router *Router.RouterGroup) {
router.GET("/info", func (ctx *Context.HttpContext) {
ctx.JSON(200, Std.M{"info": "ok"})
})
})
// GET 請求: HttpContext.RequiredServices獲取IOC對象
router.GET("/ioc", func (ctx *Context.HttpContext) {
var userAction models.IUserAction
_ = ctx.RequiredServices.GetService(&userAction)
ctx.JSON(200, Std.M{"info": "ok " + userAction.Login("zhang")})
})
}
//endregion
//region 請求對象
type UserInfo struct {
UserName string `param:"username"`
Number string `param:"q1"`
Id string `param:"id"`
}
// ----------------------------------------- MVC 定義 ------------------------------------------------------
// 定義Controller
type UserController struct {
*Controller.ApiController
userAction models.IUserAction // IOC 對象參數
}
// 構造器依賴注入
func NewUserController(userAction models.IUserAction) *UserController {
return &UserController{userAction: userAction}
}
// 請求對象的參數化綁定
type RegiserRequest struct {
Controller.RequestParam
UserName string `param:"username"`
Password string `param:"password"`
}
// Register函數自動綁定參數
func (this *UserController) Register(ctx *Context.HttpContext, request *RegiserRequest) ActionResult.IActionResult {
result := Controller.ApiResult{Success: true, Message: "ok", Data: request}
return ActionResult.Json{Data: result}
}
// use userAction interface by ioc
func (this *UserController) GetInfo() Controller.ApiResult {
return this.OK(this.userAction.Login("zhang"))
}
// Web程序的開始與停止事件
func fireApplicationLifeEvent(life *YoyoGo.ApplicationLife) {
printDataEvent := func(event YoyoGo.ApplicationEvent) {
fmt.Printf("[yoyogo] Topic: %s; Event: %v\n", event.Topic, event.Data)
}
for {
select {
case ev := <-life.ApplicationStarted:
go printDataEvent(ev)
case ev := <-life.ApplicationStopped:
go printDataEvent(ev)
break
}
}
}
本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】
※為什麼 USB CONNECTOR 是電子產業重要的元件?
※網頁設計一頭霧水??該從何著手呢? 找到專業技術的網頁設計公司，幫您輕鬆架站!
※想要讓你的商品成為最夯、最多人討論的話題?網頁設計公司讓你強力曝光
※想知道最厲害的台北網頁設計公司推薦、台中網頁設計公司推薦專業設計師”嚨底家”!!
※新北清潔公司,居家、辦公、裝潢細清專業服務
