Go语言经典库使用分析(五)| Negroni 中间件(一)

Go语言经典库使用分析,未完待续,欢迎扫码关注公众号flysnow_org或者网站http://www.flysnow.org/,第一时间看后续系列。觉得有帮助的话,顺手分享到朋友圈吧,感谢支持。

上一篇介绍的Gorilla Handlers中间件,严格来说不能称之为一个库或者框架,他只是一系列包装http.Handler的中间件函数,并且他们之间没有任何关系,也没有定义一种规则如何让我们基于它来开发我们自己的中间件,总之它是孤立的,中间件之间没有关系的。

我们这篇文章介绍的Negroni中间件库,是一个非常经典的库,非常小,但是功能强大,因为他定义了中间件的框架和风格,让我们可以基于它开发出我们自己的中间件,并且可以集成到Negroni中。

Negroni还兼容原生的http.Handler,你完全可以把自己的http.Handler加入到Negroni的中间件链中,Negroni会自动调用他们处理我们的HTTP Request的。

入门介绍

Negroni托管在Github上,你完全可以通过以下方式获得它,然后在你的项目中使用。

go get -u github.com/urfave/negroni

然后我们看个例子,还是基于Gorilla Handler的例子吧,便于理解。

//Blog:www.flysnow.org
//Wechat:flysnow_org
func main() {
	n := negroni.Classic()
	n.UseHandler(handler())
	n.Run(":1234")
}


func handler() http.Handler{
	return http.HandlerFunc(myHandler)
}

func myHandler(rw http.ResponseWriter, r *http.Request) {
	rw.Header().Set("Content-Type", "text/plain")
	io.WriteString(rw,"Hello World")
}

negroni.Classic()返回一个Negroni实例,然后通过这个实例,我们就可以添加一些中间件了。因为Negroni完全兼容http.Handler,所以我们自己对于HTTP Request的真实业务处理也可以作为Negroni的一个中间件。

通过Negroni的Run方法,就可以启动一个服务了,这个Run方法和http.ListenAndServe是等价的,只不过做了一些处理,比如会从环境变量PORT里获取服务监听的端口。

运行,然后访问http://localhost:1234,会看到如下输出:

[negroni] 2017-08-20T18:09:47+08:00 | 200 | 	 591.81µs | localhost:1234 | GET / 
[negroni] 2017-08-20T18:09:47+08:00 | 200 | 	 29.677µs | localhost:1234 | GET /favicon.ico 

这个为什么呢?哦,原来是我们的negroni.Classic()初始化Negroni实例的方式,这种方式会默认添加3个中间件。

func Classic() *Negroni {
	return New(NewRecovery(), NewLogger(), NewStatic(http.Dir("public")))
}

一个是Panic Recovery,一个是Log,一个是静态文件服务器。如果你不想使用他们,或者你有自己定义好的可以替代他们的中间件,可以使用New方法。

func New(handlers ...Handler) *Negroni {
	return &Negroni{
		handlers:   handlers,
		middleware: build(handlers),
	}
}

参数是一个可变的中间件处理参数,是否传入一些处理中间件,由你来决定。

Negroni配合路由

Negroni是一个让你更容易的使用中间件的微型库,至于具体的业务处理Handler,需要我们自己来写,不过Negroni强大之处在于,我们可以把我们自己的业务处理Hanlder当做Negroni的中间件,当然路由也不例外,go http mux路由本身就是一种Handler。

//Blog:www.flysnow.org
//Wechat:flysnow_org
func main() {
	n := negroni.Classic()

	mux := http.NewServeMux()
	mux.Handle("/",handler())
	mux.HandleFunc("/flysnow", func(rw http.ResponseWriter, r *http.Request) {
		io.WriteString(rw,"Blog:www.flysnow.org\n")
		io.WriteString(rw,"Wechat:flysnow_org")
	})

	n.UseHandler(mux)
	n.Run(":1234")
}


func handler() http.Handler{
	return http.HandlerFunc(myHandler)
}

func myHandler(rw http.ResponseWriter, r *http.Request) {
	rw.Header().Set("Content-Type", "text/plain")
	io.WriteString(rw,"Hello World")
}

对比前面的示例,稍稍改动了下,通过一个路由处理不同的URL,然后把这个路由作为Negroni中间件的一部分。一般来说,路由器作为Negroni的最后一个路由被添加。

当然路由框架有很多个,如果你不是使用的默认的,你也可以选择其他的,比如Gorilla Mux,那么我们示例可以这么改写。

//Blog:www.flysnow.org
//Wechat:flysnow_org
func main() {
	n := negroni.Classic()

	router:=mux.NewRouter()
	router.Handle("/",handler())
	router.HandleFunc("/flysnow", func(rw http.ResponseWriter, r *http.Request) {
		io.WriteString(rw,"Blog:www.flysnow.org\n")
		io.WriteString(rw,"Wechat:flysnow_org")
	})

	n.UseHandler(router)
	n.Run(":1234")
}

从这里可以又可以看到Negroni的灵活性,完全兼容net/http,无缝融合,所以我们也鼓励使用原生的net/http处理库。

动态新增中间件

在创建了一个Negroni实例后,我们可以为它添加中间件,这些被添加的中间件组成一个中间件链,先添加的会被先执行。

中间件的添加,得益于几个Negroni的Use函数,这些函数的功能是一样的,抽象出来的几个Use函数便于我们添加不同类型的中间件。

//Blog:www.flysnow.org
//Wechat:flysnow_org

Use(handler Handler)
UseFunc(handlerFunc func(rw http.ResponseWriter, r *http.Request, next http.HandlerFunc))
UseHandler(handler http.Handler)
UseHandlerFunc(handlerFunc func(rw http.ResponseWriter, r *http.Request))

除了第1个Use函数,其他三个函数最终都会调用Use函数,把中间件添加到中间件的处理链中。

func (n *Negroni) Use(handler Handler) {
	if handler == nil {
		panic("handler cannot be nil")
	}

	n.handlers = append(n.handlers, handler)
	n.middleware = build(n.handlers)
}

从上面的Use函数的实现可以看出,Negroni有两个字段,其中handler是一个切片,用于存储所有的Handler;一个是middleware,用于存储基于Handher构建而成的中间件链。

每次调用Use函数添加中间件,都会重新构建赋值给这两个字段,这样就完成了中间件的添加。

小结

这一篇主要介绍下Negroni的使用,以及路由的配置和中间件的添加,对Negroni有一些大概的了解,下一篇会继续介绍Negroni的处理器Handler,Handler和HandlerFunc之间的转换,如何构建中间件链等。

Go语言经典库使用分析,未完待续,欢迎扫码关注公众号flysnow_org或者网站http://www.flysnow.org/,第一时间看后续系列。觉得有帮助的话,顺手分享到朋友圈吧,感谢支持。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Seebug漏洞平台

使用 XML 内部实体绕过 Chrome 和 IE 的 XSS 过滤器

来源:BypassingXSSFiltersusingXMLInternalEntities 原作者:DavidLitchfield (david@davidl...

435100
来自专栏别先生

一脸懵逼学习Nginx及其安装,Tomcat的安装

1:Nginx的相关概念知识:   1.1:反向代理:     反向代理(Reverse Proxy)方式是指以代理服务器来接受internet上的连接请求,然...

278100
来自专栏野路子程序员

【Laravel5】Auth组件重写密码认证方式为MD5加密

1.4K60
来自专栏草根专栏

使用Identity Server 4建立Authorization Server (6) - js(angular5) 客户端

由于手头目前用项目, 所以与前几篇文章不同, 这次要讲的js客户端这部分是通过我刚刚开发的真是项目的代码来讲解的. 这是后端的代码: https://githu...

64150
来自专栏一个会写诗的程序员的博客

Node.js 中使用 ES6 中的 import / export 的方法大全

Node.js 中使用 ES6 中的 import / export 的方法大全

53420
来自专栏Felix的技术分享

《一个操作系统的实现》笔记(2)--保护模式

42180
来自专栏cnblogs

karma与webpack结合

一、必备插件 1.babel:es6的语法支持 2.karma:测试框架 3.jasmine:断言框架 4.webpack:打包工具 5.karma-webpa...

22770
来自专栏乐沙弥的世界

配置共享服务器模式

两者完成相同的任务,即处理所有指定的SQL操作。假定从客户端提交一个任意查询(DQL)到数据库服务器不论是专用模式还是共享

30830
来自专栏散尽浮华

Linux下DNS服务(Bind9)之Web管理利器-NamedManager部署说明

NamedManager 是一个基于Web的DNS管理系统,可用来添加、调整和删除DNS的zones/records数据。它使用Bind作为底层DNS服务,提供...

1.4K80
来自专栏大魏分享(微信公众号:david-share)

用Ansible自动供应vmware虚拟机--构建数据中心一体化运维平台第二篇

1.1 简述 一直以来,打开邮箱被ticket糊一脸的事情时有发生。我一直在想,能不能以一种简单的方案(不花老板的钱)来供应(provisioning)虚拟机呢...

76620

扫码关注云+社区

领取腾讯云代金券