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

Posted on by

WSGI基本原理

1. WSGI處理過程

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

2. WSGI示例

wsgiref簡單示例

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

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

# wsgi也是基於socket server編寫
# 默認情況下會將所有url都傳入demo_app進行處理，具體可參考demo_app源碼
# app參數可以是任何可調用對象，但是內部處理需要參考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類型，元素內容依據start_response中指定的Content-Type來指定

demo_app類定義的兩種方式

# 第一種方式：定義類的__init__和__iter__方法，前者用來接收和處理environ和start_response，後者生成一個可迭代對象
# make_server中app參數隻需傳入類名即可
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參數需要傳入類的實例
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")]

3. WSGI web服務器和應用程序

WSGI web服務器

  • 本質上是一個TCP服務器，監聽在特定的端口上。
  • 支持HTTP協議，能夠解析HTTP請求報文，能夠按HTTP協議將響應數據封裝為報文並返回給瀏覽器。
  • 實現瞭WSGI協議，該協議約定瞭和應用程序之間的接口，即url到app之間的映射。

WSGI應用程序

  • 遵從WSGI協議。
  • 本身是一個可調用對象。
  • 調用start_response，返回響應頭部。
  • 返回包含正文的可迭代對象。

以上就是python 內置庫wsgiref的使用（WSGI基礎入門）的詳細內容，更多關於python wsgiref的使用的資料請關註WalkonNet其它相關文章！

推薦閱讀：