腳本開發 / 響應數據 DFF.RESP

普通 JSON 或文本響應可以直接 return。需要控制 HTTP 狀態碼、Header、下載文件名或內容類型時，使用 DFF.RESP(...)。

磁盤文件應使用 DFF.RESP_FILE(...)，MB 級數據應使用 DFF.RESP_LARGE_DATA(...)。

參數

參數	類型	必須 / 默認值	説明
data	任意 JSON 可序列化值	必須	響應體
status_code	int	200	HTTP 狀態碼
content_type	str	None	響應體類型，如 json、text、html
headers	dict	None	額外響應頭，無需包含 Content-Type
allow_304	bool	False	是否允許瀏覽器使用 304 緩存
download	bool / str	False	True 生成默認文件名，字符串指定文件名；啓用後 content_type 不再生效

def html_response():
    return DFF.RESP('<h1>Hello</h1>', content_type='html')

def json_response():
    return DFF.RESP('{"hello": "world"}', content_type='json')

def download_response():
    return DFF.RESP('Some text', download='article.txt')

def header_response():
    return DFF.RESP('ok', headers={'X-Author': 'Tom'})

def not_found_response():
    return DFF.RESP({'error': 'not found'}, status_code=404)

構造響應時會驗證 data 能否序列化。序列化失敗，或同時使用 download 與 data=None，都會使 Func 響應失敗。

必須直接返回 DFF.RESP(...) 創建的響應對象；將它嵌入其他字典或列表不會應用狀態碼、Header 或內容類型。

Warning

allow_304=True 可能讓客户端取得緩存內容，數據頻繁變化時不應開啓。自定義響應 Header 中不得包含密鑰或其他敏感信息。