尝试地写了第一篇自己学习Go Web框架的感受和入门的文章,发现反响还不错,大家也提出了很多的问题来一起交流。近期也渐渐地出现了很多有关go语言开发的相关文章,包括有在蚂蚁金服的大牛的分享,我也一直有在看博客园和学习,这里越来越多人的去学习和使用Go,感觉也是非常好的趋势。希望和大家一起来继续学习。
Gin路由
本章概要
- 路由(Router)介绍
- Handler(处理器)介绍
2.1 路由(Router)介绍
路由是一个非常重要的概念,所有的接口都要有路由来进行管理。虽然传统的J2EE(通过Spring框架)和.Net(ABP框架)通过注解已经将这个概念给弱化了,但是无论是Python(Django)和PHP(Laravel)都还是非常强调路由的重要性的。所有的接口都必须通过路由来指向,现在包括很多的前端框架如React和Vue也都已经添加这个路由的方式。Gin的路由是基于httprouter进行开发,有非常好的性能和表现力。
2.1.1 使用路由的示例
Gin的路由支持GET , POST , PUT , DELETE , PATCH , HEAD , OPTIONS 请求,同时还有一个 Any 函数,可以同时支持以上的所有请求。(分别对应SpringMvc框架中的@GetMapping, @PostMapping, @PutMapping, @DeleteMapping,@PatchMapping,无,无和@RequestMapping注解),其使用方式大同小异,我们可以通过以下代码添加对应的路由:
// 添加 Get 请求路由 engine.GET("/", func(context *gin.Context) { context.String(http.StatusOK, "hello gin get method") }) // 添加 Post 请求路由 engine.POST("/", func(context *gin.Context) { context.String(http.StatusOK, "hello gin post method") }) // 添加 Put 请求路由 engine.PUT("/", func(context *gin.Context) { context.String(http.StatusOK, "hello gin put method") }) // 添加 Delete 请求路由 engine.DELETE("/", func(context *gin.Context) { context.String(http.StatusOK, "hello gin delete method") }) // 添加 Patch 请求路由 engine.PATCH("/", func(context *gin.Context) { context.String(http.StatusOK, "hello gin patch method") }) // 添加 Head 请求路由 engine.HEAD("/", func(context *gin.Context) { context.String(http.StatusOK, "hello gin head method") }) // 添加 Options 请求路由 engine.OPTIONS("/", func(context *gin.Context) { context.String(http.StatusOK, "hello gin options method") }) // 添加处理任意方法的请求路由 engine.Any("/hello", func(context *gin.Context) { context.String(http.StatusOK, "hello gin any method") }) // 使用Handle方法添加 Get 请求路由 engine.Handle("GET", "/ping", func(context *gin.Context) { context.String(http.StatusOK, "hello gin handle get method") })
以上接口大家启动应用后可以在浏览器和Postman等工具进行尝试。
2.1.2 获取各种参数
1. 获取Query参数(url参数)
Gin中使用Query方法获取url参数:
engine.GET("/user", func(context *gin.Context) { name := context.Query("name") context.String(http.StatusOK, "hello " + name) })
运行后在浏览器中访问 “http://localhost:8080/user?name=itachizhu" 就可以看到相关的结果了。
2. 获取Form表单参数
Gin中使用PostForm获取表单参数(Content-Type=application/x-www-form-urlencoded),使用FormFile获取表单提交的文件参数(Content-Type=multipart/form-data)
engine.POST("/user", func(context *gin.Context) { name := context.PostForm("name") context.String(http.StatusOK, "hello " + name) })
运行后在Postman工具中访问相关的接口后可以看到相关的结果。
3. 获取请求Body中json串
Gin中使用BindJSON方法可以将请求中的json数据反序列化为对象或者map和slice(Content-Type=application/json)
engine.PUT("/user", func(context *gin.Context) { var m map[string]string if err := context.BindJSON(&m); err != nil { context.String(http.StatusInternalServerError, "error data!") return } context.String(http.StatusOK, "hello " + m["name"]) })
运行后在Postman工具中访问相关的接口后可以看到相关的结果。
4. 获取路劲参数
Gin中使用Param方法获取路径参数:
engine.GET("/user/:name", func(context *gin.Context) { name := context.Param("name") context.String(http.StatusOK, "hello " + name) })
运行后在浏览器中访问 “http://localhost:8080/user/itachizhu" 就可以看到相关的结果了。
2.1.3 路由分组
Gin可以将请求路径前面相同归并为组的概念(就和在SpringMVC的Controller类中注解@RequestMapping中添加公共路径是一样的)
admin := engine.Group("/admin") { admin.Any("/hello", func(context *gin.Context) { context.String(http.StatusOK, "hello we are admin group!") }) }
2.2 Handler(处理器)介绍
经过上面简单的例子的演示和操作,现在我们大概可以了解到路由需要传入两个参数,一个为路径,另一个为路由执行的方法,我们叫做它处理器 Handler(在J2EE中我们通过叫它Action或者Controller),而且,该参数是可变长参数。也就是说,可以传入多个 handler,形成一条 handler chain 。同时对 handler 该函数有着一些要求,该函数需要传入一个 Gin.Context 指针,同时要通过该指针进行值得处理。Handler 函数可以对前端返回 字符串,Json,Html 等多种格式或形式文件,之后我们会慢慢逐一介绍。
因为Go本身支持函数式编程,所以很多就直接用匿名函数方式直接作为参数传入方法中去了。在真正的编程中,我们也通常会将它抽象成mvc模式,由另外的包方法中进行承载。
下面我们就用已学到知识,先将Gin进行Router(路由)和Controller(控制器)的抽象,渐渐形成和其他语言框架那样的MVC模式。
项目结构入如图2-1所示:
图2-1
2.3 小结
本章主要向读者介绍了Gin的路由和处理器,通过简单的路由的使用,基本明白了路由在 Gin 中的地位,也对一些常见的使用方式有了一些直观的认识。并且能够使用面向对象的思维将路由和处理器抽象成MVC模式。第3章将向读者介绍使用模板整合视图层的技术。
原文地址:https://www.cnblogs.com/itachizhu/p/11371626.html