不太一样的Go Web框架—编程范式

项目地址：https://github.com/Codexiaoyi/linweb

这是一个系列文章：

• 不太一样的Go Web框架—总览
• 不太一样的Go Web框架—编程范式

前言

上文说过，linweb不追求性能，相比而言注重编程范式。本人也是dotneter，个人觉得.net那种注解定义路由的方式更为舒服，并且接口文件统一规定在Controller文件夹下，以 XxxController 命名。
当然，在Go中也是可以实现这样的方式，但是将用到大量反射，所以势必会降低性能，所以说"不太一样的Web框架"。

基本范式

所谓编程范式，也就是你的框架定义规范，使用用户按照你的规范写逻辑业务。

路由

路由解析是一个web框架不可避免的模块，我们看gin是如何定义路由的。

func main() { 	router := gin.Default()  	// Simple group: v1 	v1 := router.Group("/v1") 	{ 		v1.POST("/login", loginEndpoint) 		v1.POST("/submit", submitEndpoint) 		v1.POST("/read", readEndpoint) 	}  	// Simple group: v2 	v2 := router.Group("/v2") 	{ 		v2.POST("/login", loginEndpoint) 		v2.POST("/submit", submitEndpoint) 		v2.POST("/read", readEndpoint) 	}  	router.Run(":8080") }

在应用gin的时候，我们通常会将路由定义与接口方法对应写在一起，统一管理，这样管理方便，也是Go的web框架多数采用的方式。
相比之下，linweb更希望路由定义和方法放在一起，然后以定义Controller的方式，路由地址更加直观。

package controllers  import ( 	"github.com/Codexiaoyi/linweb/interfaces" )  type BlogController struct { }  //[GET("/blog/:id")] func (blog *BlogController) GetBlog(c interfaces.IContext) {  }

在根目录下创建一个 controllers 文件夹，所有的api都定义在controllers包中。根据不同的 controller 名称区分文件。

自定义插件

linweb中所有功能与主流程间的依赖都是解耦的，所有实现都面向接口，完全遵守依赖倒置原则。
要实现这样的方式也不难：

• 定义一套接口，使得实现相应接口的结构体都可以运行在linweb中。
• 完成默认实现，默认应用默认实现在linweb中。
• 开放传入自定义插件实现的方法。

代码实现

在Go语言框架中大量使用Option模式实现上述的需求（完整代码详见github）。
1.首先我们定义一个自定义插件类型，并写一个默认的插件函数。

//自定义插件类型，返回可以传入Linweb的函数 type CustomizePlugins func(lin *Linweb)  func defaultPlugins() CustomizePlugins { 	return func(lin *Linweb) { 		lin.markRouter = router.New() 		lin.markContext = &context.Context{} 		lin.markMiddleware = &middleware.Middleware{} 		lin.markInject = injector.Instance() 		lin.markCache = cache.Instance() 		lin.markModel = &model.Model{} 	} }

2.定义各个插件模块对应的快捷入口函数。

// Customize router plugin.这里参数传入自定义的Router实现 func RouterPlugin(router interfaces.IRouter) CustomizePlugins { 	return func(lin *Linweb) { 		lin.markRouter = router 	} }  // Customize context plugin. func ContextPlugin(context interfaces.IContext) CustomizePlugins { 	return func(lin *Linweb) { 		lin.markContext = context 	} }  ......

3.在linweb包的New初始化函数中，传入用户自定义的CustomizePlugins。

// Create a new Linweb. // Add customize plugins with method of plugins.go, otherwise use default plugins. func NewLinweb(plugins ...CustomizePlugins) *Linweb { 	lin := &Linweb{}     //应用默认插件 	defaultPlugins()(lin)     //根据传入的用户自定义插件覆盖默认插件 	for _, plugin := range plugins { 		plugin(lin) 	} 	pluginsModel = lin.markModel 	Cache = lin.markCache 	return lin }

如何应用

在linweb项目中的linweb_test.go中，用到了mock框架（后续测试部分会介绍）模拟接口实现：

	// Arrange:mock data 	ctrl := gomock.NewController(t) 	defer ctrl.Finish()  	// mock a new context instance 	mock_context := mocks.NewMockIContext(ctrl)  	//Act 	linweb := NewLinweb(ContextPlugin(mock_context))

如代码所见，我们调用linweb的ContextPlugin函数传入自定义插件，再将返回值传入NewLinweb初始化函数中。

总结

本文，介绍了linweb的基本的编程范式，也实现了自定义插件功能。
接下来，我们需要根据前文说的功能逐步添加到linweb中。