什么是wsgi?
wsgi是一个web组件的接口防范,wsgi将web组件分为三类:web服务器,web中间件,web应用程序
wsgi基本处理模式为:wsgi Server -> wsgi middleware -> wsgi application
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 #!/usr/bin/python 2 #encoding=utf-8 3 4 #利用wsgiref 作为wsgi server 5 from wsgiref.simple_server import make_server 6 """ 7 def simple_app(environ, start_response): 8 status = '200 ok' 9 response_headers = [('Content-type', 'text/plain')] #设置http头10 start_response(status, response_headers)11 return [u"test wsgi app".encode('utf-8')]12 13 class AppClass(object):14 def __call__(self, environ, start_response):15 status = "200 ok"16 response_headers = [('Content-type', 'text/plain')]17 start_response(status, response_headers)18 return [u"class AppClass".encode('utf-8')]19 """20 21 #wsgi app只要是一个callable对象即可,不一定要是函数22 #一个实现了__call__方法示例也ok的23 24 #httpd = make_server('', 8080, simple_app)25 """26 app = AppClass()27 httpd = make_server('', 8080, app)28 httpd.serve_forever()29 """30 URL_PATTERNS = (31 ('AA/', 'AA_app'),32 ('BB/', 'BB_app'),33 )34 35 class Dispatcher(object):36 #实现路由功能:37 def _match(self, path):38 path = path.split('/')[1]39 for url, app in URL_PATTERNS:40 if path in url:41 return app42 43 def __call__(self, environ, start_response):44 path = environ.get('PATH_INFO', '/')45 app = self._match(path)46 if app:47 app = globals()[app]48 return app(environ, start_response)49 else:50 start_response("404 NOT FOUND",[('Content-type', 'text/plain')])51 return ["page dose not exists"]52 53 def AA_app(environ, start_response):54 start_response("200 OK",[('Content-type', 'text/html')])55 return ["AA page"]56 57 def BB_app(environ, start_response):58 start_response("200 OK",[('Content-type', 'text/html')])59 return ["BB page"]60 61 app = Dispatcher()62 httpd = make_server('', 8090, app)63 httpd.serve_forever()64 65 测试结果:66 server端:67 root@u163:~/cp163/python# python wsgi_app.py 68 192.168.2.162 - - [04/Nov/2015 18:44:06] "GET /AA HTTP/1.1" 200 769 192.168.2.162 - - [04/Nov/2015 18:44:22] "GET /BB HTTP/1.1" 200 770 71 client端:72 root@u162:~# curl http://192.168.2.163:8090/AA73 AA page74 root@u162:~# curl http://192.168.2.163:8090/BB75 BB page76 root@u162:~#
上述示例是wsgi application的一个简单模型;
openstack中的wsgi application会涉及到几个比较重要的python 库
- eventlet.wsgi
- paste.deploy
- routes
- webob
- wsgiref.simple_server
开发一个OpenStack 风格的WSGI APP原型需要完成的几方面的工作:
从配置文件中找到WSGI APP程序启动的入口,例如nova的api-paste.ini文件。 在/etc/nova/api-paste.ini
定义好APP需要操作的资源,这儿我们主要是app的版本资源。
完成好url到资源的映射。