新增 (藍圖)
將外部記錄 (例如：留言) 新增至此記錄的其中一個集合 (例如："comments")。
PUT /:model/:id/:association/:fk
此動作會將對其他記錄 ("外部" 或 "子" 記錄) 的參考新增到此記錄 ("主要" 或 "父" 記錄) 的特定集合中。
- 如果指定的
:id與資料庫中存在的主要記錄不符，則會使用res.notFound()回應。 - 如果指定的
:fk與資料庫中存在的外部記錄不符，則會使用res.notFound()回應。 - 如果主要記錄已與此外部記錄關聯，則此動作不會修改任何記錄。(請注意，目前在多對多關聯的情況下，它將會新增重複的連接記錄！若要解決此問題，請在資料庫層新增多欄索引 (如果可能)。我們目前正在為 MongoDB、sails-disk 和其他 NoSQL 資料庫的使用者開發更友善的解決方案/預設值。)
- 請注意，如果關聯是「雙向的」(表示它具有
via)，則該via指向的外部鍵或集合也將在外部記錄上更新。
參數
| 參數 | 類型 | 詳細資訊 |
|---|---|---|
| 模型 | 父記錄所屬模型的 識別名稱 (identity)。 例如： 'employee' (在 /employee/7/involvedinPurchases/47 中) |
|
| id | 所需父記錄的主鍵值。 例如： '7' (在 /employee/7/involvedInPurchases/47 中) |
|
| 關聯 | 集合屬性的名稱。 例如： 'involvedInPurchases' |
|
| fk | 要新增到此集合的子記錄的主鍵值 (通常是 id)。 例如： '47' |
範例
將採購單 #47 新增至 Dolly (員工 #7) 參與的採購清單
PUT /employee/7/involvedInPurchases/47
預期回應
這會傳回父記錄「Dolly」。請注意，她現在參與了採購單 #47
{
"id": 7,
"name": "Dolly",
"createdAt": 1485462079725,
"updatedAt": 1485476060873,
"involvedInPurchases": [
{
"amount": 10000,
"createdAt": 1485476060873,
"updatedAt": 1485476060873,
"id": 47,
"cashier": 7
}
]
}
使用 jQuery
$.put('/employee/7/involvedInPurchases/47', function (purchases) {
console.log(purchases);
});
使用 Angular
$http.put('/employee/7/involvedInPurchases/47')
.then(function (purchases) {
console.log(purchases);
});
使用 sails.io.js
io.socket.put('/employee/7/involvedInPurchases/47', function (purchases) {
console.log(purchases);
});
使用 cURL
curl https://127.0.0.1:1337/employee/7/involvedInPurchases/47 -X "PUT"
Socket 通知
如果您的應用程式已啟用 WebSockets，則每個訂閱主要記錄的用戶端都會收到通知，其中通知事件名稱是主要模型識別名稱 (例如：'employee')，且訊息具有以下格式
id: <the parent record primary key value>,
verb: 'addedTo',
attribute: <the parent record collection attribute name>,
addedIds: <the now-added child records' primary key values>
例如，繼續上面的範例，所有訂閱 Dolly (又名員工 #7) 的用戶端 (除了發出請求的用戶端) 都會收到以下訊息
{
id: 7,
verb: 'addedTo',
attribute: 'involvedInPurchases',
addedIds: [ 47 ]
}
訂閱子記錄的用戶端會收到額外通知
假設 involvedInPurchases 具有 via，則 updated 或 addedTo 通知也將發送給任何訂閱採購單 #47 (我們剛新增的子記錄) 的用戶端。
如果另一側的
via連結屬性也是複數 (例如：cashiers)，則會發送另一個addedTo通知。否則，如果via指向單數屬性 (例如：cashier)，則會發送updated通知。
最後，可能會發送第三個通知
如果將此採購單新增到 Dolly 的集合會從另一個員工的 involvedInPurchases 中「竊取」它，則任何訂閱該其他被竊取員工記錄 (例如：Motoki，員工 #12) 的用戶端都會收到 removedFrom 通知 (請參閱藍圖 > 從...移除)。
注意事項
- 如果您想花更多時間了解 Dolly，可以在這裡取得與上述範例相關的更詳細逐步解說。
- 此動作適用於處理複數 (「集合」) 屬性。如果您想設定或取消設定單數 (「模型」) 屬性，只需使用 update 並將外部鍵設定為新外部記錄的 id (或
null以清除關聯)。如果您想完全取代集合中的記錄集，請使用 replace 藍圖。上面的範例假設已啟用「rest」藍圖，且您的專案至少包含一個 'Employee' 模型，其屬性為：
involvedInPurchases: {collection: 'Purchase', via: 'cashier'}，以及一個Purchase模型，其屬性為：cashier: {model: 'Employee'}。您可以透過執行以下命令快速實現此目的$ sails new foo $ cd foo $ sails generate model purchase $ sails generate model employee...然後編輯
api/models/Purchase.js和api/models/Employee.js。
為了在 sailsjs.com 上獲得更好的體驗，請更新您的瀏覽器。
參考
- 應用程式
- 藍圖 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 框架由位於德州奧斯汀的 網頁和行動商店 建立，並在我們的貢獻者的幫助下完成。我們在 2012 年創建 Sails，以協助我們進行 Node.js 專案。自然而然地，我們將其開源。我們希望它能讓您的生活更輕鬆一點！
© 2012-2024 The Sails Company.
Sails 框架是免費且開源的，遵循 MIT 授權條款.
插圖由 Edamame 提供。