作成（ブループリント）
データベースに新しいレコードを作成します。
POST /:model
新しく作成されたインスタンスを表すJSON辞書を返します。検証エラーが発生した場合は、無効な属性と400ステータスコードを含むJSONレスポンスが代わりに返されます。
さらに、autoWatch設定がオンになっている場合（デフォルトでオンになっています）、このモデルを監視しているすべてのクライアントソケット（つまり、以前に「検索」ブループリントアクションへのリクエストを送信したクライアントソケット）に「作成」通知が公開されます。それらの同じソケットは、新しいレコードに対するその後の変更についても通知されるようにサブスクライブされます。
最後に、このブループリントアクションがソケットリクエストを介してトリガーされた場合、リクエスト元のソケットも新しく作成されたレコードにサブスクライブされます。言い換えると、ブループリントを使用してレコードがその後更新または削除された場合、変更を知らせるメッセージがそのクライアントソケットに送信されます。.subscribe()の詳細については、こちらを参照してください。
パラメータ
パラメータはリクエストボディで送信する必要があります。デフォルトでは、SailsはURLエンコーディング、フォームエンコーディング、JSONなど、ボディパラメータの最も一般的なエンコーディングタイプを理解しています。
| パラメータ | タイプ | 詳細 |
|---|---|---|
| モデル | 新しいレコードを作成するモデルのアイデンティティ。 例： 'purchase'（POST /purchaseの場合） |
|
| _*_ | 新しいレコードにそれらの値を設定するには、モデルで定義されている属性と同じ名前でボディパラメータを送信します。 これらの値は、モデルの.create()メソッドに渡された場合と同じように処理されます。 |
例
趣味が「pickin」で、購入番号13と25に関与している「Applejack」という名前の新しいユーザーを作成します。
POST /pony
{
"name": "Applejack",
"hobby": "pickin",
"involvedInPurchases": [13,25]
}
レスポンス例
{
"id": 47,
"name": "Applejack",
"hobby": "pickin",
"createdAt": 1485550575626,
"updatedAt": 1485550603847,
"involvedInPurchases": [
{
"id": 13,
"amount": 10000,
"createdAt": 1485550525451,
"updatedAt": 1485550544901
},
{
"id": 25,
"amount": 4.50,
"createdAt": 1485550561340,
"updatedAt": 1485550561340
}
]
}
ソケット通知
アプリケーションでWebSocketsを有効にしている場合、このモデルを「監視」している（モデルの"find where"ブループリントアクションにリクエストを送信した）すべてのソケットクライアントは、「作成」通知を受信します。イベント名はモデルのアイデンティティ（例：user）であり、メッセージは次の形式になります。
verb: 'created',
data: <a dictionary of the attribute values of the new record (without associations)>
id: <the new record primary key>,
たとえば、上記の例を続けると、Userモデルを監視しているすべてのクライアント（リクエストを行っているクライアントを除く）は、次のメッセージを受信します。
id: 47,
verb: 'created',
data: {
id: 47,
name: 'Applejack',
hobby: 'pickin',
createdAt: 1485550575626,
updatedAt: 1485550603847
}
新しく関連付けられた子レコードを購読しているクライアントも通知を受け取ります。
上記の例では、新しいレコードにinvolvedInPurchasesの初期値が含まれていたため、反対側のviaによって示される関連付けである場合、addedTo通知は、関係の反対側にあるそれらの関連付けられた子レコード（この場合は、購入13と25）を購読しているクライアントにも送信されます。これらの通知の構造については、ブループリント > 追加を参照してください。
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年にNode.jsプロジェクトを支援するためにSailsを作成し、オープンソース化しました。皆様のお役に立てれば幸いです！
© 2012-2024 The Sails Company.
Sailsフレームワークは、MITライセンスに基づいて無料でオープンソースとして提供されています。
イラストはEdamameによるものです。