为了让大家更好的对python中WSGI有更好的理解,我们先从最简单的认识WSGI着手,然后介绍一下WSGI几个经常使用到的接口,了解基本的用法和功能,最后,我们通过实例了解一下WSGI在实际项目中如何使用。
WSGI是什么?
wsgi是一个web组件的接口防范,wsgi将web组件分为三类:web服务器,web中间件,web应用程序
wsgi基本处理模式为:wsgi Server -> wsgi middleware -> wsgi application
WSGI,全称 Web Server Gateway Interface,或者 Python Web Server Gateway Interface ,是为 Python 语言定义的 Web 服务器和 Web 应用程序或框架之间的一种简单而通用的接口。自从 WSGI 被开发出来以后,许多其它语言中也出现了类似接口。
WSGI 的官方定义是,the Python Web Server Gateway Interface。从名字就可以看出来,这东西是一个Gateway,也就是网关。网关的作用就是在协议之间进行转换。
WSGI 是作为 Web 服务器与 Web 应用程序或应用框架之间的一种低级别的接口,以提升可移植 Web 应用开发的共同点。WSGI 是基于现存的 CGI 标准而设计的。
很多框架都自带了 WSGI server ,比如 Flask,webpy,Django、CherryPy等等。当然性能都不好,自带的 web server 更多的是测试用途,发布时则使用生产环境的 WSGI server或者是联合 nginx 做 uwsgi 。
也就是说,WSGI就像是一座桥梁,一边连着web服务器,另一边连着用户的应用。但是呢,这个桥的功能很弱,有时候还需要别的桥来帮忙才能进行处理。
WSGI的作用
WSGI有两方:“服务器”或“网关”一方,以及“应用程序”或“应用框架”一方。服务方调用应用方,提供环境信息,以及一个回调函数(提供给应用程序用来将消息头传递给服务器方),并接收Web内容作为返回值。
所谓的 WSGI中间件同时实现了API的两方,因此可以在WSGI服务和WSGI应用之间起调解作用:从WSGI服务器的角度来说,中间件扮演应用程序,而从应用程序的角度来说,中间件扮演服务器。“中间件”组件可以执行以下功能:
重写环境变量后,根据目标URL,将请求消息路由到不同的应用对象。
允许在一个进程中同时运行多个应用程序或应用框架。
负载均衡和远程处理,通过在网络上转发请求和响应消息。
进行内容后处理,例如应用XSLT样式表。
wsgi server:
理解为一个符合wsgi规范的web server,接收request请求,封装一系列环境变量,按照wsgi规范调用注册的wsgi app,最后将response返回给客户端。
工作流程:
1、服务器创建socket,监听port,等待client 连接
2、当请求过来时,server解析client msg放到环境变量environ中,并调用绑定的handler来处理
3、handler解析这个http请求,将请求消息例如method、path等放到environ中
4、wsgi handler再将一些server端消息也放到environ中,最后server msg,client msg,以及本次请求msg 全部都保存到了环境变量envrion中;
5、wsgi handler调用注册的wsgi app,并将envrion和回调函数传给wsgi app
6、wsgi app将reponse header/status/body回传给wsgi handler
7、handler 通过socket将response msg返回到client
WSGI Application
wsgi application就是一个普通的callable对象,当有请求到来时,wsgi server会调用这个wsgi app。这个对象接收两个参数,通常为environ,start_response。environ就像前面介绍的,可以理解为环境变量,
跟一次请求相关的所有信息都保存在了这个环境变量中,包括服务器信息,客户端信息,请求信息。start_response是一个callback函数,wsgi application通过调用start_response,将response headers/status 返回给wsgi server。此外这个wsgi app会return 一个iterator对象 ,这个iterator就是response body。
Dispatcher Middleware,用来实现URL 路由:(代码说明)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
#!/usr/bin/python #encoding=utf-8 #利用wsgiref 作为wsgi server from wsgiref.simple_server import make_server """ def simple_app(environ, start_response): status = '200 ok' response_headers = [('Content-type', 'text/plain')] #设置http头 start_response(status, response_headers) return [u"test wsgi app".encode('utf-8')] class AppClass(object): def __call__(self, environ, start_response): status = "200 ok" response_headers = [('Content-type', 'text/plain')] start_response(status, response_headers) return [u"class AppClass".encode('utf-8')] """ #wsgi app只要是一个callable对象即可,不一定要是函数 #一个实现了__call__方法示例也ok的 #httpd = make_server('', 8080, simple_app) """ app = AppClass() httpd = make_server('', 8080, app) httpd.serve_forever() """ URL_PATTERNS = ( ('AA/', 'AA_app'), ('BB/', 'BB_app'), ) class Dispatcher(object): #实现路由功能: def _match(self, path): path = path.split('/')[1] for url, app in URL_PATTERNS: if path in url: return app def __call__(self, environ, start_response): path = environ.get('PATH_INFO', '/') app = self._match(path) if app: app = globals()[app] return app(environ, start_response) else: start_response("404 NOT FOUND",[('Content-type', 'text/plain')]) return ["page dose not exists"] def AA_app(environ, start_response): start_response("200 OK",[('Content-type', 'text/html')]) return ["AA page"] def BB_app(environ, start_response): start_response("200 OK",[('Content-type', 'text/html')]) return ["BB page"] app = Dispatcher() httpd = make_server('', 8090, app) httpd.serve_forever() 测试结果: server端: root@u163:~/cp163/python# python wsgi_app.py 192.168.2.162 - - [04/Nov/2015 18:44:06] "GET /AA HTTP/1.1" 200 7 192.168.2.162 - - [04/Nov/2015 18:44:22] "GET /BB HTTP/1.1" 200 7 client端: root@u162:~# curl http://192.168.2.163:8090/AA AA page root@u162:~# curl http://192.168.2.163:8090/BB BB page root@u162:~# |
下面在给大家推荐一篇关机接口的详细介绍文章:深入解析Python中的WSGI接口