ページの編集
.replaceCollection()
指定されたコレクションのすべてのメンバーを置換します（例：BlogPost #4 の comments）。
await Something.replaceCollection(parentId, association)
.members(childIds);
使用法
| 引数 | 型 | 詳細 | |
|---|---|---|---|
| 1 | parentId | 親レコードの主キー値（つまり、ID）。 数値または文字列である必要があります（例： '507f191e810c19729de860ea' または 49）。または、数値または文字列の配列を指定できます（例： ['507f191e810c19729de860ea', '14832ace0c179de897'] または [49, 32, 37]）。この場合、子レコードは各親レコードで置換されます。 |
|
| 2 | association | 複数形（「コレクション」）の関連の名前（例：「pets」） | |
| 3 | childIds | 関連の新しいメンバーとなる子レコードの主キー値（つまり、ID）。これはこれらのレコードを作成したり、古いレコードを破棄したりするのではなく、指定された親にレコードをアタッチ/デタッチするだけであることに注意してください。 |
エラー
| 名前 | 型 | いつ？ |
|---|---|---|
| UsageError | 無効なものが渡された場合にスローされます。 | |
| AdapterError | データベースアダプターで問題が発生した場合にスローされます。 | |
| Error | 予期しないことが発生した場合にスローされます。 |
SailsとWaterlineでのエラー処理の例については、コンセプト > モデルとORM > エラーを参照してください。
例
ユーザー3の場合、「pets」コレクション内のすべてのペットをペット99と98に置き換えます
await User.replaceCollection(3, 'pets')
.members([99,98]);
エッジケース
- 親IDが実際に存在する永続化されたレコードに対応しない場合、これは何も行いません。
- 子IDの1つが実際に存在する永続化されたレコードに対応しない場合、その子IDは無視され、提供された他の子IDに対応するメンバーのみが置換コレクションに含まれます。
- 子IDの空の配列が提供された場合、または提供された子IDのいずれも既存のレコードに対応しない場合、これは親からすべての子レコードをデタッチします。
注
- このメソッドは、
await、プロミスチェーン、または従来のNodeコールバックで使用できます。- 関連が「双方向」（つまり、
viaを持っている）の場合、子レコードはそれに応じて変更されます。反対側の属性が単数形の場合、新しくリンクされた、またはリンク解除された各子レコードの外部キーが変更されます。複数形の場合、各子レコードのコレクションはそれに応じて変更されます。- さらに、
viaが反対側の単数形（「モデル」）属性を指している場合、.addToCollection()は必要に応じてこれらの子レコードを「奪い」ます。たとえば、次の複数形（「コレクション」）属性を持つEmployeeモデルがあるとします。involvedInPurchases: { collection: 'Purchase', via: 'cashier' }。この購入を従業員#7（Dolly）に割り当てるためにEmployee.addToCollection(7, 'involvedInPurchases', [47])を実行したが、購入#47がすでに別の従業員（例：#12、Motoki）に関連付けられていた場合、これはMotokiから購入を「奪い」、Dollyに与えます。言い換えれば、Employee.find([7, 12]).populate('involvedInPurchases')を実行した場合、DollyのinvolvedInPurchases配列には購入#47が含まれ、Motokiの配列には含まれません。
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)
- WebSocket
リファレンス
愛を込めて作成
Sailsフレームワークは、テキサス州オースティンのウェブ＆モバイルショップによって、コントリビューターの協力を得て構築されています。私たちはNode.jsプロジェクトを支援するために2012年にSailsを作成しました。当然ながら、オープンソース化しました。皆様の生活が少しでも楽になれば幸いです！
© 2012-2024 The Sails Company.
Sailsフレームワークは、MITライセンスの下で無料かつオープンソースです。
イラストはEdamameによるものです。