萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

解讀 web.py application.py:WSGI 介面實現、URL 路由映射、處理器鏈、wsgifunc 入口

web.py 是極簡 Python Web 框架,其 application.py 實現了 WSGI 相容介面,連接應用與伺服器。本文深入分析 web.application 初始化、URL 路由編譯、處理器機制、wsgifunc() 產生 WSGI 呼叫式的完整流程。

兩種啟動模式

1. 內建伺服器(開發/測試)


import web
urls = ("/.*", "hello")
app = web.application(urls, globals())

class hello:
    def GET(self):
        return 'Hello, world!'

if __name__ == "__main__":
    app.run()

app.run() 內部:wsgi.runwsgi(app.wsgifunc(*middleware)),啟動 wsgiref.simple_server。

2. 對接 WSGI 伺服器(生產:uWSGI/Gunicorn)


import web
class hello:
    def GET(self):
        return 'Hello, world!'

urls = ("/.*", "hello")
app = web.application(urls, globals())
application = app.wsgifunc()  # 供 uWSGI/Gunicorn import

web.application 初始化


class application:
    def __init__(self, mapping=(), fvars={}, autoreload=None):
        if autoreload is None:
            autoreload = web.config.get('debug', False)
        self.init_mapping(mapping)
        self.fvars = fvars
        self.processors = []
        self.add_processor(loadhook(self._load))
        self.add_processor(unloadhook(self._unload))
        if autoreload: ...

URL 映射編譯 init_mapping


def init_mapping(self, mapping):
    self.mapping = list(utils.group(mapping, 2))
# 輸入 ("/","Index","/hello/(.*)","Hello") → [[ "/","Index"], ["/hello/(.*)","Hello"]]

處理器機制


self.add_processor(loadhook(self._load))
self.add_processor(unloadhook(self._unload))
  • loadhook:請求前執行(如注入 web.ctx.session)。
  • unloadhook:請求後執行(如提交事務、關閉連線)。
  • 處理器鏈:processors 列表,依序執行。

wsgifunc → WSGI 呼叫式


def wsgifunc(self, *middleware):
    def wsgi(env, start_resp):
        # 1. 清理執行緒區域儲存
        # 2. 解析 env → web.ctx
        # 3. 路由匹配 self.mapping
        # 4. 實例化 handler 類
        # 5. 執行處理器鏈 + handler 方法 (GET/POST...)
        # 6. 回傳可迭代 body 給 start_resp
        ...
    for m in middleware:
        wsgi = m(wsgi)  # 中間件包裝
    return wsgi

中間件模式

wsgifunc(*middleware) 接受可呼叫物,依序包裝 wsgi,形成洋蔥模型:


def logger_middleware(app):
    def wrapped(env, start_resp):
        print("Request:", env['PATH_INFO'])
        return app(env, start_resp)
    return wrapped

application = app.wsgifunc(logger_middleware)

核心設計亮點

  • 極簡 WSGI 適配:wsgifunc 只回傳一個 (env, start_resp) -> iterable 函式,零依賴。
  • URL 路由即資料:mapping 為列表,易動態修改、擴充。
  • 處理器鏈分離關注點:Session、DB、Template、Auth 皆可作為處理器插入。
  • fvars 捕獲全域命名空間:路由字串 "hello" 透過 globals() 解析為類物件。

現代視角

web.py 設計哲學影響了 Flask(app = Flask(__name__))、FastAPI(app = FastAPI())等後續框架。理解其 WSGI 適配層、路由編譯、中間件鏈,有助於深入掌握現代框架內核運作。

copyright © 萬盛學電腦網 all rights reserved