python 內置庫wsgiref的使用（WSGI基礎入門）

更新時間：2021年06月07日 11:34:22 作者：山上下了雪-bky

WSGI（web服務器網(wǎng)關接口）主要規(guī)定了服務器端和應用程序之間的接口，即規(guī)定了請求的URL到后臺處理函數(shù)之間的映射該如何實現(xiàn)。wsgiref是一個幫助開發(fā)者開發(fā)測試的Python內置庫，程序員可以通過這個庫了解WSGI的基本運行原理，但是不能把它用在生產(chǎn)環(huán)境上。

WSGI基本原理

1. WSGI處理過程

瀏覽器到WSGI Server：瀏覽器發(fā)送的請求會先到WSGI Server。
environ：WSGI Server會將HTTP請求中的參數(shù)等信息封裝到environ（一個字典）中。
WSGI Server到WSGI App：App就是我們自己編寫的后臺程序，每個URL會映射到對應的入口處理函數(shù)(或其他可調用對象），WSGI Server調用后臺App時，會將environ和WSGI Server中自己的一個start_response函數(shù)注入到后臺App中。
邏輯處理：后臺函數(shù)（或其他可調用對象）需要接收environ和start_response，進行邏輯處理后返回一個可迭代對象，可迭代對象中的元素為HTTP正文。
WSGI App到WSGI Server：后臺函數(shù)處理完后，會先調用start_response函數(shù)將HTTP狀態(tài)碼、報文頭等信息（響應頭）返回給WSGI Server，然后再將函數(shù)的返回值作為HTTP正文（響應body）返回給WSGI Server。
WSGI Server到瀏覽器：WSGI Server將從App中得到的所有信息封裝為一個response返回給瀏覽器。

2. WSGI示例

wsgiref簡單示例

運行以下示例程序后，在瀏覽器中輸入以http://127.0.0.1:9999/開頭的隨意一個url都可以看到返回結果。實例程序中所有url都會以同一個App進行處理，實際生產(chǎn)環(huán)境中不同的url肯定是需要映射到不同的App上的，但這部分本文不作講解。

# wsgiref是Python自帶的內置庫，它用來開發(fā)者對wsgi進行測試用的，不可以用在生產(chǎn)環(huán)境中
from wsgiref.simple_server import make_server, demo_app

# wsgi也是基于socket server編寫
# 默認情況下會將所有url都傳入demo_app進行處理，具體可參考demo_app源碼
# app參數(shù)可以是任何可調用對象，但是內部處理需要參考demo_app源碼，即environ處理、start_response調用、返回值類型
ws = make_server('127.0.0.1', 9999, demo_app)
# 啟動服務
ws.serve_forever()

demo_app源碼

def demo_app(environ,start_response):
    from io import StringIO
    stdout = StringIO()
    print("Hello world!", file=stdout)
    print(file=stdout)
    # environ是一個字典，包含了所有請求信息
    h = sorted(environ.items())
    for k,v in h:
        print(k,'=',repr(v), file=stdout)
    # return之前需要調用start_response設置響應頭信息
    start_response("200 OK", [('Content-Type','text/plain; charset=utf-8')])
    return [stdout.getvalue().encode("utf-8")]  # 一個可迭代對象，元素為byte類型，元素內容依據(jù)start_response中指定的Content-Type來指定

demo_app類定義的兩種方式

# 第一種方式：定義類的__init__和__iter__方法，前者用來接收和處理environ和start_response，后者生成一個可迭代對象
# make_server中app參數(shù)只需傳入類名即可
class ApplicationClass:
    def __init__(self, environ, start_response):
        self.e = environ
        self.sr = start_response
        
    def __iter__(self):
        from io import StringIO
        stdout = StringIO()
        print("Hello world!", file=stdout)
        print(file=stdout)
        h = sorted(self.e.items())
        for k, v in h:
            print(k, '=', repr(v), file=stdout)
        self.sr("200 OK", [('Content-Type', 'text/plain; charset=utf-8')])
        yield from [stdout.getvalue().encode("utf-8")]
        
        
# 第二種方式：定義__call__方法，接收和處理environ和start_response，并返回一個可迭代對象
# make_server中app參數(shù)需要傳入類的實例
class ApplicationInstance:
    def __call__(self, environ, start_response):
        from io import StringIO
        stdout = StringIO()
        print("Hello world!", file=stdout)
        print(file=stdout)
        h = sorted(environ.items())
        for k, v in h:
            print(k, '=', repr(v), file=stdout)
        start_response("200 OK", [('Content-Type', 'text/plain; charset=utf-8')])
        return [stdout.getvalue().encode("utf-8")]