req.file()
建立並回傳 Skipper Upstream，代表從指定的 field 傳入的多部分檔案上傳。
req.file(field);
用法
| 參數 | 類型 | 詳細資訊 | |
|---|---|---|---|
| 1 | field |
要監聽上傳的檔案參數名稱；例如：avatar。 |
詳細資訊
req.file() 來自 Skipper，這是原始 Connect body parser 的意見導向變體。Skipper 讓您可以利用高效能、串流檔案上傳，而無需對您的應用程式邏輯進行任何重大變更。
這種簡化帶來了一個小小的注意事項：文字參數必須包含在請求 body 中的檔案之前。 通常，這些文字參數包含字串元數據，提供有關檔案上傳的額外資訊。
發送到 Sails 的多部分請求應先發送所有文字參數，然後再發送任何檔案參數。 例如，如果您正在構建與 Sails 通訊的 Web 前端，則應在任何表單上傳或 AJAX 檔案上傳請求中首先包含文字參數。「文字參數」一詞指的是您可能與檔案一起發送的元數據參數，以提供有關上傳的額外資訊。
運作方式
Skipper 將所有檔案上傳視為串流。 這允許使用者上傳龐大的檔案，而對效能的影響極小，且不佔用磁碟空間，同時保護您的應用程式免受涉及 TMP 檔案的惡意阻斷服務攻擊。
當多部分請求到達您的伺服器時，Skipper 不會將臨時檔案寫入磁碟，而是緩衝請求，時間足夠執行您的應用程式程式碼，讓您可以「插入」相容的 Blob 接收器。 如果您沒有「插入」來自特定欄位的資料，Upstream 將達到其「高水位線」，緩衝區將被清除，並且後續在該欄位上傳入的位元組將被忽略。
範例
在控制器動作或策略中
// See the Skipper README on GitHub for usage documentation for `.upload()`, including
// a complete list of options.
req.file('avatar').upload(function (err, uploadedFiles){
if (err) return res.serverError(err);
return res.json({
message: uploadedFiles.length + ' file(s) uploaded successfully!',
files: uploadedFiles
});
});
注意事項
- 請記住，用戶端請求的文字參數必須在檔案參數之前發送！
req.file()支援透過同一個欄位發送多個檔案，但重要的是要意識到，因此，它回傳的 Upstream 實際上是一個潛在二進制串流（檔案）的串流（緩衝事件發射器）。 具體來說，Upstream是一個 Node.js Readable stream，處於「物件模式」，其中每個物件本身都是一個傳入的多部分檔案上傳串流。- 如果您希望直接使用 Upstream 作為串流的串流，您可以省略
.upload()方法並綁定 "finish" 和 "error" 事件（或使用.pipe()）來替代。 在底層，.upload()所做的只是將 Upstream 導管到指定的接收器實例中，然後在 Upstream 發出finish或error事件時執行指定的回呼。
為了在 sailsjs.com 上獲得更好的體驗，更新您的瀏覽器。
參考
- 應用程式
- Blueprint API
- 命令行介面
-
設定
- sails.config.*
- sails.config.blueprints
- sails.config.bootstrap()
- sails.config.custom
- sails.config.datastores
- sails.config.globals
- sails.config.http
- sails.config.i18n
- sails.config.log
- sails.config.models
- sails.config.policies
- sails.config.routes
- sails.config.security
- sails.config.session
- sails.config.sockets
- sails.config.views
-
請求 (`req`)
- req._startTime
- req.body
- req.cookies
- req.fresh
- req.headers
- req.hostname
- req.ip
- req.ips
- req.isSocket
- req.method
- req.options
- req.originalUrl
- req.params
- req.path
- req.protocol
- req.query
- req.secure
- req.signedCookies
- req.socket
- req.subdomains
- req.url
- req.wantsJSON
- req.xhr
- req.accepts()
- req.acceptsCharsets()
- req.acceptsLanguages()
- req.allParams()
- req.file()
- req.get()
- req.is()
- req.param()
- req.setLocale()
- req.setTimeout()
- req.host
- 回應 (`res`)
- Waterline (ORM)
- WebSockets
參考
用愛打造
Sails 框架是由奧斯汀，德州的 web & mobile shop 建立，並在我們的貢獻者協助下完成。 我們在 2012 年創建 Sails，以協助我們進行 Node.js 專案。 自然地，我們將其開源。 我們希望它可以讓您的生活更輕鬆一點！
© 2012-2024 The Sails Company.
Sails 框架是免費的，並以 MIT 授權條款開源發布。
插圖繪製：Edamame。