application.py:WSGI 介面實現、URL 路由映射、處理器鏈、wsgifunc 入口web.py 是極簡 Python Web 框架,其 application.py 實現了 WSGI 相容介面,連接應用與伺服器。本文深入分析 web.application 初始化、URL 路由編譯、處理器機制、wsgifunc() 產生 WSGI 呼叫式的完整流程。
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。
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: ...
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)
wsgifunc 只回傳一個 (env, start_resp) -> iterable 函式,零依賴。mapping 為列表,易動態修改、擴充。fvars 捕獲全域命名空間:路由字串 "hello" 透過 globals() 解析為類物件。web.py 設計哲學影響了 Flask(app = Flask(__name__))、FastAPI(app = FastAPI())等後續框架。理解其 WSGI 適配層、路由編譯、中間件鏈,有助於深入掌握現代框架內核運作。