一.初始化
所有Flask程序都必須創建一個程序實例。Web服務器使用一種名爲Web服務器網關接口的協議,把接收自客戶端的所有請求都轉交給這個對象處理。程序實例書Flask類的對象,創建代碼:
from flask import Flask app = Flask(__name__)
Flask類的構造函數只有一個必須指定的參數,即程序主模板或包的名字。在大多數程序中,python的__name__變量就是所需的值。
將構造函數的name參數傳給Flask程序,這一點可能會讓Flask開發新手心生迷惑。Flask用這個參數決定程序的根目錄,以便稍後能夠找到相對與程序個目錄的資源文件的位置。
二.路由和視圖函數
客戶端把請求發送給Web服務器,Web服務器再把請求發送給Flask程序實例。程序實例需要知道對每個URL請求運行哪些代碼,所以保存類一個URL到Python函數的映射關系。處理URL和函數之間關系的程序路由稱爲路由。
<客戶端----Web---Flask>
在Flask程序中定義路由的最簡便方式,是使用程序實例提供的app.route修飾器,把修飾的函數注冊爲路由。下面的例子說明了怎麼使用這個修飾器聲明路由:
@app.route('/')
def index():
return '<h1>hello,world<h1>'
修飾器書python語言的標準特性,可以使用不同的方式修改函數的行爲。通常用法是把函數注冊爲事件處理函數程序。
前例把index()函數注冊爲程序根地址的處理程序。如果部署程序的服務器域名爲www.example.com,在瀏覽器中訪問http://www.example.com後,會觸發服務器執行index()函數。這個函數的返回值稱爲響應,是客戶端收到的內容。如果客戶端書Web瀏覽器,響應就書顯示給用戶查看的文檔。
像index()這樣的函數稱爲視圖函數。視圖函數返回的響應可以是包含HTML的簡單字符,也可以是復雜的表單。
在python代碼中嵌入響應字符串會導致代碼難以維護,所以此處這麼做只是爲了介紹響應的概念。
如果你仔細觀察日常所用服務的某些URL格式,會發現很多地址中都包含可變部分。例如 http://www.example.com/user/<user-name>,Flask支持這種形式的URL,只需在route修飾器中使用特殊的語法即可。
@app.route('/user/<name>')
def hellouser(name):
return '<h1>hello,%s<h1>' %name
尖括號中的內容就是動態部分,任何能匹配靜態部分的URL都會映射到這個路由上。調用視圖函數時,Flask會將動態部分作爲參數傳入函數。在這個視圖函數中,參數用於生成針對個人的歡迎消息。路由中的動態部分默認使用字符串,不過也可以使用類型定義。例如,路由/user/<int:id>只會匹配動態片段id爲整數的URL。Flask支持在路由中使用int,float,path類型,path也是字符串,但不把斜線作爲分隔符,而是當作動態片段的一部分。
三.啓動服務器
程序實例用run方法啓動Flask集成的開發Web服務器(Flask有自己的集成開發服務器,而且調用也是其Web服務器):
if __name__=='__main__':
app.run()
__name=='__main__是python的常慣用法,在這裏確保直接執行這個腳本時才啓動開發Web服務器。如果這個腳本由其他腳本引入,程序假定父級腳本會啓動不同服務器,因此不會執行app.run()。
服務器啓動後,會進入輪詢,等待並處理請求。輪詢會一直運行,直到程序停止,比如按Cril-C鍵。
有一些選項參數可以被app.run()函數接受用於設置Web服務器的操作模式。在開發過程中啓用調試模式會帶來一些便利。
四.一個完整的程序
是時候開發一個程序了。整個hello.py程序腳本就書把前面三個部分合並到一個文件中。
from flask import Flask app = Flask(__name__) @app.route('/')
def index():
return '<h1>hello,world<h1>' @app.route('/user/<name>')
def hellouser(name):
return '<h1>hello,%s<h1>' %name if __name__=='__main__':
app.run()
運行後:
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
運行結果:
此時在瀏覽器中輸入 http://127.0.0.1:5000/
此時在瀏覽器中輸入 http://127.0.0.1:5000/user/master
此時命令行的數據: