快捷導(dǎo)航

深入解析Python中的WSGI接口

更新時(shí)間：2015年05月11日 12:10:19 作者：_Zhao

這篇文章主要介紹了深入解析Python中的WSGI接口,WSGI接口是Python中網(wǎng)絡(luò)框架連接服務(wù)器的必備工具,需要的朋友可以參考下

概述

WSGI接口包含兩方面：server/gateway 及 application/framework。
server調(diào)用由application提供的可調(diào)用對(duì)象。
另外在server和application之間還可能有一種稱作middleware的中間件。
可調(diào)用對(duì)象是指：函數(shù)、方法、類或者帶有callable方法的實(shí)例。
關(guān)于application

函數(shù)、方法、類及帶有callable方法的實(shí)例等可調(diào)用對(duì)象都可以作為the application object。
WSGI協(xié)議要求：
the application object接受兩個(gè)參數(shù)且可以被多次調(diào)用

這兩個(gè)參數(shù)分別為：
1.CGI式的字典；
2.回調(diào)函數(shù)：application用來向server傳遞http狀態(tài)碼/消息/http頭

另外協(xié)議要求可調(diào)用對(duì)象必須將響應(yīng)體封裝成一個(gè)可迭代的strings返回。

# the application object. 可以使用其他名字,
# 但是在使用mod_wsgi 時(shí)必須為 "application"
def application( environ, start_response):
# 函數(shù)接受兩個(gè)參數(shù):
# environ ：包含有CGI 式環(huán)境變量的字典，由server負(fù)責(zé)提供內(nèi)容
# start_response：由server提供的回調(diào)函數(shù)，其作用是將狀態(tài)碼和響應(yīng)頭返回給server

# 構(gòu)造響應(yīng)體，以可迭代字符串形式封裝
  response_body = 'The request method was %s' % environ['REQUEST_METHOD']

# HTTP 響應(yīng)碼及消息
  status = '200 OK'

# 提供給客戶端的響應(yīng)頭.
# 封裝成list of tuple pairs 的形式:
# 格式要求：[(Header name, Header value)].
  response_headers = [('Content-Type', 'text/plain'),
            ('Content-Length', str(len(response_body)))]

# 將響應(yīng)碼/消息及響應(yīng)頭通過傳入的start_reponse回調(diào)函數(shù)返回給server
  start_response(status, response_headers)

# 響應(yīng)體作為返回值返回
# 注意這里被封裝到了list中.
  return [response_body]

關(guān)于server

從概述中可以知道，WSGI server必須要調(diào)用application，同時(shí)，從application的協(xié)議要求可知：
1. WSGI server必須向application提供環(huán)境參數(shù)，因此，自身也必須能夠獲取環(huán)境參數(shù)。
2. WSGI server接收application的返回值作為響應(yīng)體。
最簡單的WSGI server為Python自帶的wsgiref.simple_server
示例如下：

from wsgiref.simple_server import make_server
srv = make_server('localhost', 8080, hello_world)
srv.serve_forever()

關(guān)于middleware

middleware的概念沒有appllication和server那么容易理解。
假設(shè)一個(gè)符合application標(biāo)準(zhǔn)的可調(diào)用對(duì)象，它接受可調(diào)用對(duì)象作為參數(shù)，返回一個(gè)可調(diào)用對(duì)象的對(duì)象。
那么對(duì)于server來說，它是一個(gè)符合標(biāo)準(zhǔn)的可調(diào)用對(duì)象，因此是application。
而對(duì)于application來說，它可以調(diào)用application，因此是server。
這樣的可調(diào)用對(duì)象稱為middleware。

middleware的概念非常接近decorator。

以一個(gè)路由的例子示例：

import re

# 這是一個(gè)標(biāo)準(zhǔn)的application object
def index(environ, start_response):
  start_response('200 OK', [('Content-Type', 'text/html')])
  return ['index page']

# 這是一個(gè)標(biāo)準(zhǔn)的application object
def hello(environ, start_response):
  start_response('200 OK', [('Content-Type', 'text/html')])
  return ['hello page']

# 這是一個(gè)標(biāo)準(zhǔn)的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)
]
# 這是一個(gè)middleware
# 根據(jù)不同的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:

您可能感興趣的文章: