go-mir v2.8.0 发布了,支持多个web框架，自带mirc脚手架，零基础开发web应用，方便快捷。
新增特性：
- 支持把一个方法注册到多个HTTP METHOD，eg:
type Site struct {
Assets mir.Any `mir:"/assets" method:"Head,Get"`
Others mirAny `mir:"/others"`
Status mir.Any `mir:"/Status" method:"Get,Post,Head"`
}
最近疫情原因，呆家出不去，所以...没啥事，就是发个版本打发一下无聊时间～～
这个库其实本质上是一个代码生成器，当初开发这个库就是奔着写代码偷懒去的，本着能自动生成就绝不Ctr-C/Ctr-V的心思，业余时间捣腾几下，还别说，至少在我的项目中，还是蛮省心的，有兴趣的朋友可以尝试一下，万一就对了你的心呢！！！
go-mir v2的架构如下：
![go-mir-v2-arc]()
v2版本升级采用代码生成的方式生成接口代码，同样也是采用golang内置的struct tag定义路由信息，但不同于v1版本在引擎启动时解析后注册路由信息到web引擎，这里参考grpc的接口生成方式，生成接口定义文件，业务逻辑只要实现了接口，注册接口实现的对象到相应的web引擎，启动后就可以对外通过RESTfull接口获取服务。
go-mir v2 功能特性：
go-mir v2 代码示例：(eg: gin style)
% go get github.com/alimy/mir/mirc/v2@latest
% mirc new -d mir-examples
% tree mir-examples
mir-examples
├── Makefile
├── README.md
├── go.mod
├── main.go
└── mirc
├── main.go
└── routes
├── site.go
├── v1
│ └── site.go
└── v2
└── site.go
% cd mir-examples
% make generate
// file: mirc/routes/v1/site.go
package v1
import (
"github.com/alimy/mir/v2"
"github.com/alimy/mir/v2/engine"
)
func init() {
engine.AddEntry(new(Site))
}
// Site mir's struct tag define
type Site struct {
Chain mir.Chain `mir:"-"`
Group mir.Group `mir:"v1"`
Index mir.Get `mir:"/index/"`
Articles mir.Get `mir:"/articles/:category/"`
}
// file: mirc/main.go
package main
import (
"log"
"github.com/alimy/mir/v2/core"
"github.com/alimy/mir/v2/engine"
_ "github.com/alimy/mir/v2/examples/mirc/routes"
_ "github.com/alimy/mir/v2/examples/mirc/routes/v1"
_ "github.com/alimy/mir/v2/examples/mirc/routes/v2"
)
//go:generate go run main.go
func main() {
log.Println("generate code start")
opts := core.Options{
core.RunMode(core.InSerialDebugMode),
core.GeneratorName(core.GeneratorGin),
core.SinkPath("./gen"),
}
if err := engine.Generate(opts); err != nil {
log.Fatal(err)
}
log.Println("generate code finish")
}
- 自动生成接口，基于上面的定义，生成器将自动生成接口定义文件，如下：
% make generate
% cat mirc/gen/api/v1/site.go
// Code generated by go-mir. DO NOT EDIT.
package v1
import (
"github.com/gin-gonic/gin"
)
type Site interface {
// Chain provide handlers chain for gin
Chain() gin.HandlersChain
Index(*gin.Context)
Articles(*gin.Context)
}
// RegisterSiteServant register Site servant to gin
func RegisterSiteServant(e *gin.Engine, s Site) {
router := e.Group("v1")
// use chain for router
middlewares := s.Chain()
router.Use(middlewares...)
// register routes info to router
router.Handle("GET", "/index/", s.Index)
router.Handle("GET", "/articles/:category/", s.Articles)
}
// file: servants/site_v1.go
package servants
import (
"net/http"
"github.com/gin-gonic/gin"
api "github.com/alimy/mir/v2/examples/mirc/gen/api/v1"
)
var _ api.Site = EmptySiteV1{}
// EmptySiteV1 implement api.Site interface
type EmptySiteV1 struct{}
func (EmptySiteV1) Chain() gin.HandlersChain {
return gin.HandlersChain{gin.Logger()}
}
func (EmptySiteV1) Index(c *gin.Context) {
c.String(http.StatusOK, "get index data (v1)")
}
func (EmptySiteV1) Articles(c *gin.Context) {
c.String(http.StatusOK, "get articles data (v1)")
}
package main
import (
"log"
"github.com/gin-gonic/gin"
"github.com/alimy/mir/v2/examples/mirc/gen/api"
"github.com/alimy/mir/v2/examples/mirc/gen/api/v1"
"github.com/alimy/mir/v2/examples/mirc/gen/api/v2"
"github.com/alimy/mir/v2/examples/servants"
)
func main() {
e := gin.New()
// register servants to engine
registerServants(e)
// start servant service
if err := e.Run(); err != nil {
log.Fatal(err)
}
}
func registerServants(e *gin.Engine) {
// register default group routes
api.RegisterSiteServant(e, servants.EmptySiteWithNoGroup{})
// register routes for group v1
v1.RegisterSiteServant(e, servants.EmptySiteV1{})
// register routes for group v2
v2.RegisterSiteServant(e, servants.EmptySiteV2{})
}
% make run
演示项目：
examples：一个简单的快速了解如何使用mir的演示项目；
Mirage-幻影: 简单的Docker图形化管理，示范如何使用 go-mir构建web应用程序.
mir-covid19: 新冠疫情统计TH_COVID19_International的Golang版本，完整的演示了如何使用mir快速开发一个web应用。
