跳轉到

指令碼開發 / 響應檔案 DFF.RESP_FILE

返回資源目錄中已經存在的檔案時,使用 DFF.RESP_FILE(...)。file_path 直接填寫資源相對路徑,無需先呼叫 DFF.RSRC(...)。

引數

引數 型別 必須 / 預設值 說明
file_path str 必須 資源目錄相對路徑
status_code int 200 HTTP 狀態碼
headers dict None 額外響應頭
allow_304 bool False 是否允許瀏覽器使用 304 快取
auto_delete bool False 響應傳送後是否自動刪除磁碟檔案
download bool / str True True 使用原檔名下載;False 嘗試在瀏覽器內開啟;字串指定下載名

系統會根據副檔名自動填充 Content-Type。

示例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
def download_pdf():
    return DFF.RESP_FILE('user-guide.pdf')

def open_pdf_in_browser():
    return DFF.RESP_FILE('user-guide.pdf', download=False)

def download_report():
    return DFF.RESP_FILE('report.xlsx', download='report.xlsx')

def download_temporary_export():
    return DFF.RESP_FILE('tmp/export.csv', auto_delete=True)

構造 DFF.RESP_FILE(...) 時,檔案必須已經存在,且解析後的路徑必須位於配置的資源根目錄內。auto_delete=True 會在響應傳送後刪除檔案,共享或需要重複使用的檔案不得啟用此選項。

執行時生成的大檔案應先寫入資源目錄,再透過本方法返回;臨時檔案可以使用 auto_delete=True。二進位制輸出必須寫入二進位制檔案,不要將二進位制位元組傳給 DFF.RESP(...) 或 DFF.RESP_LARGE_DATA(...)。