深入解析Python中的WSGI接口
概述
WSGI接口包含两方面:server/gateway及application/framework。
server调用由application提供的可调用对象。
另外在server和application之间还可能有一种称作middleware的中间件。
可调用对象是指:函数、方法、类或者带有callable方法的实例。
关于application
函数、方法、类及带有callable方法的实例等可调用对象都可以作为theapplicationobject。
WSGI协议要求:
theapplicationobject接受两个参数且可以被多次调用
这两个参数分别为:
1.CGI式的字典;
2.回调函数:application用来向server传递http状态码/消息/http头
另外协议要求可调用对象必须将响应体封装成一个可迭代的strings返回。
#theapplicationobject.可以使用其他名字,
#但是在使用mod_wsgi时必须为"application"
defapplication(environ,start_response):
#函数接受两个参数:
#environ:包含有CGI式环境变量的字典,由server负责提供内容
#start_response:由server提供的回调函数,其作用是将状态码和响应头返回给server
#构造响应体,以可迭代字符串形式封装
response_body='Therequestmethodwas%s'%environ['REQUEST_METHOD']
#HTTP响应码及消息
status='200OK'
#提供给客户端的响应头.
#封装成listoftuplepairs的形式:
#格式要求:[(Headername,Headervalue)].
response_headers=[('Content-Type','text/plain'),
('Content-Length',str(len(response_body)))]
#将响应码/消息及响应头通过传入的start_reponse回调函数返回给server
start_response(status,response_headers)
#响应体作为返回值返回
#注意这里被封装到了list中.
return[response_body]
关于server
从概述中可以知道,WSGIserver必须要调用application,同时,从application的协议要求可知:
1.WSGIserver必须向application提供环境参数,因此,自身也必须能够获取环境参数。
2.WSGIserver接收application的返回值作为响应体。
最简单的WSGIserver为Python自带的wsgiref.simple_server
示例如下:
fromwsgiref.simple_serverimportmake_server
srv=make_server('localhost',8080,hello_world)
srv.serve_forever()
关于middleware
middleware的概念没有appllication和server那么容易理解。
假设一个符合application标准的可调用对象,它接受可调用对象作为参数,返回一个可调用对象的对象。
那么对于server来说,它是一个符合标准的可调用对象,因此是application。
而对于application来说,它可以调用application,因此是server。
这样的可调用对象称为middleware。
middleware的概念非常接近decorator。
以一个路由的例子示例:
importre
#这是一个标准的applicationobject
defindex(environ,start_response):
start_response('200OK',[('Content-Type','text/html')])
return['indexpage']
#这是一个标准的applicationobject
defhello(environ,start_response):
start_response('200OK',[('Content-Type','text/html')])
return['hellopage']
#这是一个标准的applicationobject
defnot_found(environ,start_response):
start_response('404NOTFOUND',[('Content-Type','text/plain')])
return['NotFoundPage']
#mapurlstofunctions
urls=[
(r'^$',index),
(r'hello/?$',hello)
]
#这是一个middleware
#根据不同的route返回不同的applicationobject
defapplication(environ,start_response):
path=environ.get('PATH_INFO','').lstrip('/')
forregex,callbackinurls:
match=re.search(regex,path)
ifmatchisnotNone: