詳解Python程序與服務(wù)器連接的WSGI接口
了解了HTTP協(xié)議和HTML文檔,我們其實就明白了一個Web應(yīng)用的本質(zhì)就是:
- 瀏覽器發(fā)送一個HTTP請求;
- 服務(wù)器收到請求,生成一個HTML文檔;
- 服務(wù)器把HTML文檔作為HTTP響應(yīng)的Body發(fā)送給瀏覽器;
- 瀏覽器收到HTTP響應(yīng),從HTTP Body取出HTML文檔并顯示。
所以,最簡單的Web應(yīng)用就是先把HTML用文件保存好,用一個現(xiàn)成的HTTP服務(wù)器軟件,接收用戶請求,從文件中讀取HTML,返回。Apache、Nginx、Lighttpd等這些常見的靜態(tài)服務(wù)器就是干這件事情的。
如果要動態(tài)生成HTML,就需要把上述步驟自己來實現(xiàn)。不過,接受HTTP請求、解析HTTP請求、發(fā)送HTTP響應(yīng)都是苦力活,如果我們自己來寫這些底層代碼,還沒開始寫動態(tài)HTML呢,就得花個把月去讀HTTP規(guī)范。
正確的做法是底層代碼由專門的服務(wù)器軟件實現(xiàn),我們用Python專注于生成HTML文檔。因為我們不希望接觸到TCP連接、HTTP原始請求和響應(yīng)格式,所以,需要一個統(tǒng)一的接口,讓我們專心用Python編寫Web業(yè)務(wù)。
這個接口就是WSGI:Web Server Gateway Interface。
WSGI接口定義非常簡單,它只要求Web開發(fā)者實現(xiàn)一個函數(shù),就可以響應(yīng)HTTP請求。我們來看一個最簡單的Web版本的“Hello, web!”:
def application(environ, start_response): start_response('200 OK', [('Content-Type', 'text/html')]) return '<h1>Hello, web!</h1>'
上面的application()函數(shù)就是符合WSGI標準的一個HTTP處理函數(shù),它接收兩個參數(shù):
- environ:一個包含所有HTTP請求信息的dict對象;
- start_response:一個發(fā)送HTTP響應(yīng)的函數(shù)。
在application()函數(shù)中,調(diào)用:
start_response('200 OK', [('Content-Type', 'text/html')])
就發(fā)送了HTTP響應(yīng)的Header,注意Header只能發(fā)送一次,也就是只能調(diào)用一次start_response()函數(shù)。start_response()函數(shù)接收兩個參數(shù),一個是HTTP響應(yīng)碼,一個是一組list表示的HTTP Header,每個Header用一個包含兩個str的tuple表示。
通常情況下,都應(yīng)該把Content-Type頭發(fā)送給瀏覽器。其他很多常用的HTTP Header也應(yīng)該發(fā)送。
然后,函數(shù)的返回值'<h1>Hello, web!</h1>'將作為HTTP響應(yīng)的Body發(fā)送給瀏覽器。
有了WSGI,我們關(guān)心的就是如何從environ這個dict對象拿到HTTP請求信息,然后構(gòu)造HTML,通過start_response()發(fā)送Header,最后返回Body。
整個application()函數(shù)本身沒有涉及到任何解析HTTP的部分,也就是說,底層代碼不需要我們自己編寫,我們只負責在更高層次上考慮如何響應(yīng)請求就可以了。
不過,等等,這個application()函數(shù)怎么調(diào)用?如果我們自己調(diào)用,兩個參數(shù)environ和start_response我們沒法提供,返回的str也沒法發(fā)給瀏覽器。
所以application()函數(shù)必須由WSGI服務(wù)器來調(diào)用。有很多符合WSGI規(guī)范的服務(wù)器,我們可以挑選一個來用。但是現(xiàn)在,我們只想盡快測試一下我們編寫的application()函數(shù)真的可以把HTML輸出到瀏覽器,所以,要趕緊找一個最簡單的WSGI服務(wù)器,把我們的Web應(yīng)用程序跑起來。
好消息是Python內(nèi)置了一個WSGI服務(wù)器,這個模塊叫wsgiref,它是用純Python編寫的WSGI服務(wù)器的參考實現(xiàn)。所謂“參考實現(xiàn)”是指該實現(xiàn)完全符合WSGI標準,但是不考慮任何運行效率,僅供開發(fā)和測試使用。
運行WSGI服務(wù)
我們先編寫hello.py,實現(xiàn)Web應(yīng)用程序的WSGI處理函數(shù):
# hello.py def application(environ, start_response): start_response('200 OK', [('Content-Type', 'text/html')]) return '<h1>Hello, web!</h1>'
然后,再編寫一個server.py,負責啟動WSGI服務(wù)器,加載application()函數(shù):
# server.py # 從wsgiref模塊導(dǎo)入: from wsgiref.simple_server import make_server # 導(dǎo)入我們自己編寫的application函數(shù): from hello import application # 創(chuàng)建一個服務(wù)器,IP地址為空,端口是8000,處理函數(shù)是application: httpd = make_server('', 8000, application) print "Serving HTTP on port 8000..." # 開始監(jiān)聽HTTP請求: httpd.serve_forever() Try
確保以上兩個文件在同一個目錄下,然后在命令行輸入python server.py來啟動WSGI服務(wù)器:
注意:如果8000端口已被其他程序占用,啟動將失敗,請修改成其他端口。
啟動成功后,打開瀏覽器,輸入http://localhost:8000/,就可以看到結(jié)果了:
在命令行可以看到wsgiref打印的log信息:
按Ctrl+C終止服務(wù)器。
如果你覺得這個Web應(yīng)用太簡單了,可以稍微改造一下,從environ里讀取PATH_INFO,這樣可以顯示更加動態(tài)的內(nèi)容:
# hello.py def application(environ, start_response): start_response('200 OK', [('Content-Type', 'text/html')]) return '<h1>Hello, %s!</h1>' % (environ['PATH_INFO'][1:] or 'web')
你可以在地址欄輸入用戶名作為URL的一部分,將返回Hello, xxx!:
是不是有點Web App的感覺了?
小結(jié)
無論多么復(fù)雜的Web應(yīng)用程序,入口都是一個WSGI處理函數(shù)。HTTP請求的所有輸入信息都可以通過environ獲得,HTTP響應(yīng)的輸出都可以通過start_response()加上函數(shù)返回值作為Body。
復(fù)雜的Web應(yīng)用程序,光靠一個WSGI函數(shù)來處理還是太底層了,我們需要在WSGI之上再抽象出Web框架,進一步簡化Web開發(fā)。
相關(guān)文章
Python數(shù)據(jù)可視化之使用matplotlib繪制簡單圖表
這篇文章主要為大家詳細介紹了使用matplotlib繪制簡單圖表的方法,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下,希望能夠給你帶來幫助2022-03-03django做form表單的數(shù)據(jù)驗證過程詳解
這篇文章主要介紹了django做form表單的數(shù)據(jù)驗證過程詳解,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2019-07-07Python批量上傳文件信息到服務(wù)器的實現(xiàn)示例
在進行軟件測試的過程中,經(jīng)常會需要準備一批數(shù)據(jù),本文主要介紹了Python批量上傳文件信息到服務(wù)器的實現(xiàn)示例,具有一定的參考價值,感興趣的可以了解一下2023-12-12TensorFlow入門使用 tf.train.Saver()保存模型
這篇文章主要介紹了TensorFlow入門使用 tf.train.Saver()保存模型,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2018-04-04