Linux入门
更多>>
首页
Go语言WEB框架(Gin)详解
在 Go语言开发的 Web 框架中，有两款著名 Web 框架分别是 Martini 和 Gin，两款 Web 框架相比较的话，Gin 自己说它比 Martini 要强很多。
Gin 是 Go语言写的一个 web 框架，它具有运行速度快，分组的路由器，良好的崩溃捕获和错误处理，非常好的支持中间件和 json。总之在 Go语言开发领域是一款值得好好研究的 Web 框架，开源网址：https://github.com/gin-gonic/gin
首先下载安装 gin 包：
go get -u github.com/gin-gonic/gin
一个简单的例子：
package main
import "github.com/gin-gonic/gin"
func main() {
//Default返回一个默认的路由引擎
r := gin.Default()
r.GET("/ping", func(c *gin.Context) {
//输出json结果给调用方
c.JSON(200, gin.H{
"message": "pong",
})
})
r.Run() // listen and serve on 0.0.0.0:8080
}
编译运行程序，打开浏览器，访问http://localhost:8080/ping页面显示：
{"message":"pong"}
gin 的功能不只是简单输出 Json 数据。它是一个轻量级的 WEB 框架，支持 RestFull 风格 API，支持 GET，POST，PUT，PATCH，DELETE，OPTIONS 等 http 方法，支持文件上传，分组路由，Multipart/Urlencoded FORM，以及支持 JsonP，参数处理等等功能，这些都和 WEB 紧密相关，通过提供这些功能，使开发人员更方便地处理 WEB 业务。
Gin 实际应用
接下来使用 Gin 作为框架来搭建一个拥有静态资源站点，动态 WEB 站点，以及 RESTFull API 接口站点（可专门作为手机 APP 应用提供服务使用）组成的，亦可根据情况分拆这套系统，每种功能独立出来单独提供服务。
下面按照一套系统但采用分站点来说明，首先是整个系统的目录结构，website 目录下面 static 是资源类文件，为静态资源站点专用；photo 目录是 UGC 上传图片目录，tpl 是动态站点的模板。
当然这个目录结构是一种约定，可以根据情况来修改。整个项目已经开源，可以访问来详细了解：https://github.com/ffhelicopter/tmm具体每个站点的功能怎么实现呢？请看下面有关每个功能的讲述：
静态资源站点
一般网站开发中，我们会考虑把 js，css，以及资源图片放在一起，作为静态站点部署在 CDN，提升响应速度。采用 Gin 实现起来非常简单，当然也可以使用 net/http 包轻松实现，但使用 Gin 会更方便。
不管怎么样，使用 Go 开发，我们可以不用花太多时间在 WEB 服务环境搭建上，程序启动就直接可以提供 WEB 服务了。
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
// 静态资源加载，本例为css,js以及资源图片
router.StaticFS("/public", http.Dir("D:/goproject/src/github.com/ffhelicopter/tmm/website/static"))
router.StaticFile("/favicon.ico", "./resources/favicon.ico")
// Listen and serve on 0.0.0.0:80
router.Run(":80")
}
首先需要是生成一个 Engine，这是 gin 的核心，默认带有 Logger 和 Recovery 两个中间件。
router := gin.Default()
StaticFile 是加载单个文件，而 StaticFS 是加载一个完整的目录资源：
func (group *RouterGroup) StaticFile(relativePath, filepath string) IRoutes
func (group *RouterGroup) StaticFS(relativePath string, fs http.FileSystem) IRoutes
这些目录下资源是可以随时更新，而不用重新启动程序。现在编译运行程序，静态站点就可以正常访问了。
网关=反向代理+负载均衡+各种策略，技术实现也有多种多样，有基于 nginx 使用 lua 的实现，比如 openresty、kong；也有基于 zuul 的通用网关；还有就是 golang 的网关，比如 tyk。
这篇文章主要是讲如何基于 golang 实现一个简单的网关。
转自： troy.wang/docs/golang/posts/golang-gateway/
整理：go语言钟文文档:www.topgoer.cn
启动两个后端 web 服务（代码）
这里使用命令行工具进行测试
具体代码
直接使用基础库 httputil 提供的NewSingleHostReverseProxy即可，返回的reverseProxy对象实现了serveHttp方法，因此可以直接作为 handler。
具体代码
director中定义回调函数，入参为*http.Request，决定如何构造向后端的请求，比如 host 是否向后传递，是否进行 url 重写，对于 header 的处理，后端 target 的选择等，都可以在这里完成。
director在这里具体做了：
modifyResponse中定义回调函数，入参为*http.Response，用于修改响应的信息，比如响应的 Body，响应的 Header 等信息。
最终依旧是返回一个ReverseProxy，然后将这个对象作为 handler 传入即可。
参考 2.2 中的NewSingleHostReverseProxy，只需要实现一个类似的、支持多 targets 的方法即可，具体实现见后面。
作为一个网关服务，在上面 2.3 的基础上，需要支持必要的负载均衡策略，比如：
随便 random 一个整数作为索引，然后取对应的地址即可，实现比较简单。
具体代码
使用curIndex进行累加计数，一旦超过 rss 数组的长度，则重置。
具体代码
轮询带权重，如果使用计数递减的方式，如果权重是5,1,1那么后端 rs 依次为a,a,a,a,a,b,c,a,a,a,a…，其中 a 后端会瞬间压力过大；参考 nginx 内部的加权轮询，或者应该称之为平滑加权轮询，思路是：
后端真实节点包含三个权重：
操作步骤：
具体代码
一致性 hash 算法，主要是用于分布式 cache 热点/命中问题；这里用于基于某 key 的 hash 值，路由到固定后端，但是只能是基本满足流量绑定，一旦后端目标节点故障，会自动平移到环上最近的那么个节点。
实现：
具体代码
每一种不同的负载均衡算法，只需要实现添加以及获取的接口即可。
然后使用工厂方法，根据传入的参数，决定使用哪种负载均衡策略。
具体代码
作为网关，中间件必不可少，这类包括请求响应的模式，一般称作洋葱模式，每一层都是中间件，一层层进去，然后一层层出来。
中间件的实现一般有两种，一种是使用数组，然后配合 index 计数；一种是链式调用。
具体代码
1、下载go的zip文件。并且一定要把文件解压到c:\go目录下。2、配置windows的高级环境变量。包括：GOROOT、GOOS、GOBIN、GOARCH。并且在path变量里面把c:\go\bin加入。以便可以在命令行直接运行go命令。
举例：我的机器：
GOPATH= c:\goc:\go\srcF:\workspace\goSample01
GOBIN=c:\go\binF:\workspace\goSample01\bin
其中，c:\go是go的安装路径；
F:\workspace\goSample01是我写的go语言项目的工程目录；
F:\workspace\goSample01\bin是go语言项目的工程目录下的可执行文件路径
3、在完成环境变量配置后，打开一个命令行窗口，直接输入go，然后回车，看看是否出现go的帮助信息。如果出现，那么go的基本环境就OK了。
注意：这个基本环境不包含开发工具，也不能直接编译带C代码的go程序。
4、
(可选)为了支持Import远程包，最好装个gomingw。下载地址：http://code.google.com/p/gomingw
/downloads/list。如果下的是压缩包，请把它解压到C盘。例如，C:\gowin-env。里面有个Console.bat是以后使用go
get的环境。举例：有个文件a.go,里面import(
"fmt"
"github.com/astaxie/beedb"
_ "github.com/ziutek/mymysql/godrv"
为了编译该a.go文件，需要启动Console.bat，然后在该命令行窗口，进入c:\go\src目录下，执行go getgithub.com/astaxie/beedb
Go get github.com/ziutek/mymysql/godrv .
Go会自动下载该远程包并编译和安装这些包。
配置goclipse（可选）
（如果不喜欢eclipse开发工具，请跳过这个配置。）
1、下载并安装goclipse插件。Goclipse是go语言for eclipse的插件，下载地址：http://code.google.com/p/goclipse/
2、启动eclipse并创建go项目。然后写个最简单的helloworld.go文件，并运行。代码如下：
packagemainimport"fmt"func main(){fmt.Printf("hello, world")}
配置gocode（可选）
如果不需要go语法辅助和eclipse里面的（按ALT+/）弹出go语言自动辅助功能，请跳过这个配置。
1、下载gocode的zip文件，解压后放在go的bin目录下。
2、下载并安装Git软件。并且在path里面配置git的执行路径。例如c:\git\bin
3、在命令行执行：go build .\gocode。如果一切正常，那么将会编译生成一个gocode.exe文件在go的bin目录下。如果编译失败，那么就转第4步。
4、如果第3步直接编译gocode源文件成功，那就直接到第5步。否则，就需要通过git下载gocode源文件，然后再编译。在命令行执行：go get -u github.com/nsf/gocode 。就会生成gocode.exe文件。
5、在goclipse插件里面指定gocode的路径。就可以在elcipse里面调用gocode来帮助写编码了。
从开发工具这块看，go语言还不够成熟，开发工具都还不完善，有待改进。
下载go-tour教程源代码（可选）
Google有个在线运行go语言的教程（http://tour.golang.org/#2），很不错。支持在web上直接运行大部分的go程序，想了解这个教程的源代码的朋友可以通过以下方式获取。如果没兴趣，可以跳过这个步骤。
1、下载安装Mercurial软件。
2、在命令行下输入：
hg clone
作为测试用的。如果把http改成https协议，下载就会失败。搞不懂。
编译带调用C代码的go文件（可选）
1、为了在windows下编译带C代码的go程序，你首先需要下载并安装MinGW或者Cygwin。
2、首选安装MinGW。在安装MinGW之后，记得要把MinGW安装目录\bin路径设置在path环境变量里面，以便能在dos窗口下直接调用gcc。
3、下载一个gowin-env。下载地址：gowin-env。下载后解压到某个目录下，例如：C:\gowin-env. 然后，编辑go-env.bat。配置相关的go参数。例如，我的配置是：
set GOARCH=386
set GOOS=windows
set GOROOT=c:\go
set GOBIN=%GOROOT%\bin
set GOPATH=%GOROOT%F:\workspace\goSample01
设置好go-env.bat后，就可以点击Console.bat来启动编译和运行窗口。
4、编写一个带C代码的go程序。例如，testc.go
5、编译
例如：
go build -compiler gccgo test_c.go
运行调用C代码的go文件（可选）
1、testc.go.
创建rand目录，然后在rand里面创建testc.go. 代码如下：
package rand
/*
//
#include <stdio.h>
*/
import "C"
func PrintHello() {
C.puts(C.CString("Hello, world\n"))
}
2、a.go
在rand下创建a.go.代码如下：
package rand
import "fmt"
func SayHello(name string){
fmt.Println(name)
}
3、test_import.go
在rand的上一级创建test_import.go。代码如下：
package main
import "./rand"
func main(){
rand.SayHello("tom")
rand.PrintHello()
}
4、运行test_import.go
go run test_import.go
在测试其它几个C代码的时候，发现windows版本的cgo还有些编译问题，同样的代码转移到苹果的XCODE下就没有问题。后来终于发现原因了，原来有些例子是unix平台下的，而在windows平台下，方法名和参数需要做调整。
例如：下面代码在windows下编译报一堆错误。
package rand
/*
#include <stdlib.h>
*/
import "C"
func Random() int {
return int(C.random())
}
func Seed(i int) {
C.srandom(C.uint(i))
}
这里需要把return int(C.random()) 修改为“return int(C.rand())”
C.srandom(C.uint(i))修改为“C.srand(C.uint(i))”编译就OK了。
