從多個方面深入探討 Flask Request 對象

Flask 是一個非常流行的 Python Web 應用框架，它提供了完善的工具來快速開發 Web 應用。而在 Flask 應用中，request 對象是非常重要的一部分，它能夠讓我們方便地獲取到客戶端發送的 HTTP 請求的信息。本文將從多個方面深入探討 Flask Request 對象。

一、獲取請求方法

Flask Request 對象提供了方法來獲取客戶端發送的請求信息，其中最基本的就是請求方法。我們可以使用 Flask Request 對象的 method 屬性來獲取請求方法。下面是一個簡單的示例：

from flask import Flask, request

app = Flask(__name__)

@app.route('/')
def home():
    method = request.method

    return f'The request method is {method}'

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

在這個示例中，我們首先導入了 Flask 和 request 模塊。然後定義了一個路由函數 home，該函數返回 HTTP 請求的方法。在函數中，我們使用 request 對象的 method 屬性來獲取請求方法。最後，我們使用 Flask 的 run() 方法來啟動 Web 應用。

當我們在瀏覽器中訪問 http://localhost:5000/，我們會得到如下的結果：

The request method is GET

由此可見，我們成功地獲取到了客戶端發送的 HTTP 請求的方法。

二、獲取請求參數

除了請求方法，客戶端還可以向服務器傳遞一些參數。Flask Request 對象提供了多種方法來獲取這些參數，比如 args、form、json、data 等。下面是一些示例。

1. 獲取 GET 請求參數

在 GET 請求中，參數會跟在 URL 後面，我們可以使用 args 屬性來獲取這些參數。下面是一個簡單的示例：

from flask import Flask, request

app = Flask(__name__)

@app.route('/')
def home():
    args = request.args

    return f'The request args are {args}'

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

在這個示例中，我們使用 request 對象的 args 屬性來獲取 GET 請求參數。args 屬性返回一個字典，包含了所有的 GET 請求參數。最後，我們將這些參數返回給客戶端。

當我們在瀏覽器中訪問 http://localhost:5000/?name=Tom&age=20，我們會得到如下的結果：

The request args are ImmutableMultiDict([('name', 'Tom'), ('age', '20')])

由此可見，我們成功地獲取到了客戶端發送的 GET 請求參數。

2. 獲取 POST 請求參數

在 POST 請求中，參數可以包含在請求體中，我們可以使用 form 屬性來獲取這些參數。下面是一個簡單的示例：

from flask import Flask, request

app = Flask(__name__)

@app.route('/', methods=['POST'])
def home():
    form = request.form

    return f'The request form data is {form}'

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

在這個示例中，我們使用 request 對象的 form 屬性來獲取 POST 請求參數。form 屬性返回一個字典，包含了所有的 POST 請求參數。最後，我們將這些參數返回給客戶端。

當我們使用 POST 請求向 http://localhost:5000/ 發送參數 name=Tom&age=20，我們會得到如下的結果：

The request form data is ImmutableMultiDict([('name', 'Tom'), ('age', '20')])

由此可見，我們成功地獲取到了客戶端發送的 POST 請求參數。

三、獲取請求頭信息

在 HTTP 請求中，請求頭信息包含了客戶端的一些重要信息，比如 User-Agent、Accept、Referer 等。Flask Request 對象提供了 headers 屬性來獲取這些頭信息。下面是一個簡單的示例：

from flask import Flask, request

app = Flask(__name__)

@app.route('/')
def home():
    headers = request.headers

    return f'The request headers are {headers}'

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

在這個示例中，我們使用 request 對象的 headers 屬性來獲取請求頭信息。headers 屬性返回一個字典，包含了所有的請求頭信息。最後，我們將這些信息返回給客戶端。

當我們在瀏覽器中訪問 http://localhost:5000/，我們會得到如下的結果：

The request headers are Host: localhost:5000
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:88.0) Gecko/20100101 Firefox/88.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Upgrade-Insecure-Requests: 1

由此可見，我們成功地獲取到了客戶端發送的請求頭信息。

四、獲取請求文件

在某些情況下，客戶端可能會向服務器上傳文件。Flask Request 對象提供了 files 屬性來獲取上傳的文件。下面是一個簡單的示例：

from flask import Flask, request

app = Flask(__name__)

@app.route('/', methods=['POST'])
def home():
    file = request.files['file']

    return f'The uploaded file is {file.filename}'

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

在這個示例中，我們使用 request 對象的 files 屬性來獲取上傳的文件。files 屬性返回一個字典，包含了客戶端上傳的所有文件。我們可以通過訪問字典來獲取每個文件對象的詳細信息。在這個示例中，我們假設客戶端上傳了一個名為 file 的文件，我們使用 files[‘file’] 來獲取該文件對象，並返迴文件名給客戶端。

當我們使用 POST 請求上傳一個名為 file 的文件時，我們會得到如下的結果：

The uploaded file is example.txt

由此可見，我們成功地獲取到了客戶端上傳的文件。

總結

本文從多個方面深入探討了 Flask Request 對象，包括獲取請求方法、請求參數、請求頭信息以及上傳的文件。在實際開發中，我們很可能會用到這些方法來獲取客戶端發送的請求信息，從而實現對客戶端請求的處理。