更新 (ブループリント)
データベース内の既存のレコードを更新し、購読しているソケットにその変更を通知します。
PATCH /:model/:id
これは、id パラメータと一致するモデル内のレコードを更新し、新しく更新されたレコードをJSON辞書として返します。バリデーションエラーが発生した場合は、無効な属性と400ステータスコードを含むJSONレスポンスが代わりに返されます。指定されたidと一致するモデルインスタンスが存在しない場合は、404が返されます。
パラメータ
変更する属性は、フォームエンコード値またはJSONとしてHTTPボディに送信する必要があります。
| パラメータ | 型 | 詳細 |
|---|---|---|
| model | 包含モデルのidentity。 例: 'product' (PATCH /product/5内) |
|
| id | 更新するレコードの主キー値。 例: '5' (PATCH /product/5内) |
|
| * | PATCH (RESTful)リクエストの場合、モデルで定義されている属性と同じ名前のボディパラメータを渡して、目的のレコードにそれらの値を設定します。GET (ショートカット)リクエストの場合、パラメータをクエリ文字列に追加します。 |
例
Applejackの趣味を「kickin」に変更する
PATCH /user/47
{
"hobby": "kickin"
}
期待されるレスポンス
{
"hobby": "kickin",
"id": 47,
"name": "Applejack",
"createdAt": 1485462079725,
"updatedAt": 1485476060873
}
ソケット通知
アプリでWebSocketsを有効にしている場合、更新されたレコードを購読しているすべてのクライアントは、イベント名がモデルのidentity（例：user）であり、データ「ペイロード」が以下の形式である通知を受け取ります。
verb: 'updated',
id: <the record primary key>,
data: <a dictionary of changes made to the record>,
previous: <the record prior to the update>
例えば、上記の例を続けると、User #47を購読しているすべてのクライアント（リクエストを行っているクライアントを除く）は、以下のメッセージを受け取ります。
{
id: 47,
verb: 'updated',
data: {
id: 47,
hobby: 'kickin'
updatedAt: 1485476060873
},
previous: {
hobby: 'pickin',
id: 47,
name: 'Applejack',
createdAt: 1485462079725,
updatedAt: 1485462079725
}
}
更新によって他のレコードへのリンクが変更された場合、追加の通知がいくつかある可能性があります。
ユーザー#47をストア#25に再割り当てする場合、一対多の関連付けの「一」側を表すstoreを更新します。例えば
PATCH /user/47
{
"store": 25
}
新しいストア(25)を購読しているクライアントはaddedTo通知を受け取り、古いストアを購読しているクライアントにはremovedFrom通知が送信されます。これらの通知の詳細については、addブループリントリファレンスとremoveブループリントリファレンスを参照してください。
備考
- このアクションを使用して、コレクション関連付け全体を置き換えることができます（たとえば、ユーザーの友達リストを置き換えるなど）。これは
replaceブループリントアクションと同じ結果になります。コレクション内のアイテムを個別に変更するには、addまたはremoveアクションを使用します。- 以前のバージョンのSailsでは、このアクションは
PUT /:model/:idルートにバインドされていました。
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フレームワークは、貢献者の皆様のご協力の下、テキサス州オースティンにあるWeb＆モバイル開発会社によって開発されました。2012年にNode.jsプロジェクトを支援するためにSailsを作成し、オープンソース化しました。皆様のお役に立てれば幸いです！
© 2012-2024 The Sails Company。
Sailsフレームワークは、MITライセンスに基づくフリーでオープンソースのソフトウェアです。
イラストレーション：Edamame。