這篇文章主要介紹了深入解析Python中的WSGI接口,WSGI接口是Python中網絡框架連接服務器的必備工具,需要的朋友可以參考下
概述
WSGI接口包含兩方面:server/gateway 及 application/framework。
server調用由application提供的可調用對象。
另外在server和application之間還可能有一種稱作middleware的中間件。
可調用對象是指:函數、方法、類或者帶有callable方法的實例。
關於application
函數、方法、類及帶有callable方法的實例等可調用對象都可以作為the application object。
WSGI協議要求:
the application object接受兩個參數且可以被多次調用
這兩個參數分別為:
1.CGI式的字典;
2.回調函數:application用來向server傳遞http狀態碼/消息/http頭
另外協議要求可調用對象必須將響應體封裝成一個可迭代的strings返回。
?
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 # the application object. 可以使用其他名字, # 但是在使用mod_wsgi 時必須為 "application" def application( environ, start_response): # 函數接受兩個參數: # environ :包含有CGI 式環境變量的字典,由server負責提供內容 # start_response:由server提供的回調函數,其作用是將狀態碼和響應頭返回給server # 構造響應體,以可迭代字符串形式封裝 response_body = 'The request method was %s' % environ['REQUEST_METHOD'] # HTTP 響應碼及消息 status = '200 OK' # 提供給客戶端的響應頭. # 封裝成list of tuple pairs 的形式: # 格式要求:[(Header name, Header value)]. 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
從概述中可以知道,WSGI server必須要調用application,同時,從application的協議要求可知:
1. WSGI server必須向application提供環境參數,因此,自身也必須能夠獲取環境參數。
2. WSGI server接收application的返回值作為響應體。
最簡單的WSGI server為Python自帶的wsgiref.simple_server
示例如下:
?
1 2 3 from wsgiref.simple_server import make_server srv = make_server('localhost', 8080, hello_world) srv.serve_forever()關於middleware
middleware的概念沒有appllication和server那麼容易理解。
假設一個符合application標准的可調用對象,它接受可調用對象作為參數,返回一個可調用對象的對象。
那麼對於server來說,它是一個符合標准的可調用對象,因此是application。
而對於application來說,它可以調用application,因此是server。
這樣的可調用對象稱為middleware。
middleware的概念非常接近decorator。
以一個路由的例子示例:
?
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 import re # 這是一個標准的application object def index(environ, start_response): start_response('200 OK', [('Content-Type', 'text/html')]) return ['index page'] # 這是一個標准的application object def hello(environ, start_response): start_response('200 OK', [('Content-Type', 'text/html')]) return ['hello page'] # 這是一個標准的application object def not_found(environ, start_response): start_response('404 NOT FOUND', [('Content-Type', 'text/plain')]) return ['Not Found Page'] # map urls to functions urls = [ (r'^$', index), (r'hello/?$', hello) ] # 這是一個middleware # 根據不同的route返回不同的application object def application(environ, start_response): path = environ.get('PATH_INFO', '').lstrip('/') for regex, callback in urls: match = re.search(regex, path) if match is not None: