REST 複合/複合/ネストされたリソース [closed] 質問する

Question

@ray、素晴らしい議論ですね

@jgerman、REST だからといって、リソースを POST から固定しなければならないわけではないことを忘れないでください。

リソースの特定の表現に何を含めるかは、あなた次第です。

カバーを個別に参照するケースは、親リソース (コミックブック) を作成し、その子リソース (カバー) を相互参照するだけです。たとえば、著者、出版社、キャラクター、またはカテゴリへの参照を個別に提供することもできます。これらのリソースを個別に作成するか、子リソースとして参照するコミックブックの前に作成することをお勧めします。または、親リソースの作成時に新しい子リソースを作成することもできます。

カバーの具体的なケースは、カバーには実際にコミック本が必要であり、その逆もまた同様であるという点で、少し複雑です。

ただし、電子メールメッセージをリソース、送信元アドレスを子リソースと見なすと、送信元アドレスを個別に参照できることは明らかです。たとえば、すべての送信元アドレスを取得します。または、以前の送信元アドレスを使用して新しいメッセージを作成します。電子メールが REST であれば、/received-messages、/draft-messages、/from-addresses、/to-addresses、/addresses、/subjects、/attachments、/folders、/tags、/categories、/labels など、多くの相互参照リソースが利用可能になることが容易にわかります。

このチュートリアルでは、相互参照されたリソースの優れた例を示します。http://www.peej.co.uk/articles/restfully-delicious.html

これは、自動生成されたデータの最も一般的なパターンです。たとえば、新しいリソースの URI、ID、または作成日はサーバーによって生成されるため、投稿する必要はありません。ただし、新しいリソースが返されたときに、URI、ID、または作成日を取得できます。

バイナリデータの場合の例。たとえば、バイナリデータを子リソースとして投稿するとします。親リソースを取得すると、それらの子リソースを同じバイナリデータとして、またはバイナリデータを表す URI として表すことができます。

フォームとパラメータは、リソースの HTML 表現とは既に異なります。URL となるバイナリ/ファイルパラメータを投稿することは、難しいことではありません。

新しいリソースのフォーム (/comic-books/new) を取得する場合、またはリソースを編集するためのフォーム (/comic-books/0/edit) を取得する場合は、リソースのフォーム固有の表現を要求しています。コンテンツタイプ "application/x-www-form-urlencoded" または "multipart/form-data" でリソースコレクションに投稿すると、そのタイプの表現を保存するようにサーバーに要求しています。サーバーは、保存された HTML 表現などで応答できます。

API などの目的で、HTML、XML、または JSON 表現をリソースコレクションに投稿できるようにすることもできます。

コミック本の後に投稿される表紙を考慮し、コミック本に表紙があることを条件として、リソースとワークフローを説明したとおりに表現することも可能です。例は次のとおりです。

遅延カバー作成が可能
必要な表紙付きのコミックブックの作成が可能
カバーの相互参照が可能
複数のカバーが可能
漫画本の原稿を作成する
漫画本の表紙の下書きを作成する
漫画本の原稿を公開する

GET /comic-books
=> 200 OK、すべてのコミックブックを取得します。

GET /comic-books/0
=> 200 OK、表紙 (/covers/1、/covers/2) 付きのコミックブック (id: 0) を取得します。

GET /comic-books/0/covers
=> 200 OK、コミックブック (id: 0) のカバーを取得します。

GET /covers
=> 200 OK、すべてのカバーを取得します。

GET /covers/1
=> 200 OK、コミックブック (/comic-books/0) のカバー (id: 1) を取得します。

GET /comic-books/new
=> 200 OK、コミックブックを作成するためのフォームを取得します (フォーム: POST /draft-comic-books)。

POST /draft-comic-books
title=foo
author=boo
published
=2011-01-01
=> 302 見つかりました。場所: /draft-comic-books/3、表紙付きのドラフトコミックブック (id: 3) にリダイレクトします (バイナリ)。

GET /draft-comic-books/3
=> 200 OK、表紙付きのドラフトコミックブック (id: 3) を取得します。

GET /draft-comic-books/3/covers
=> 200 OK、ドラフトコミックブック (/draft-comic-book/3) のカバーを取得します。

GET /draft-comic-books/3/covers/new
=> 200 OK、ドラフトコミックブック (/draft-comic-book/3) のカバーを作成するためのフォームを取得します (フォーム: POST /draft-comic-books/3/covers)。

POST /draft-comic-books/3/covers
cover_type=front
cover_data=(binary)
=> 302 見つかりました。場所: /draft-comic-books/3/covers、ドラフトコミックブックの新しいカバー (/draft-comic-book/3/covers/1) にリダイレクトします。

GET /draft-comic-books/3/publish
=> 200 OK、ドラフトコミックブック（ID: 3）を公開するためのフォームを取得します（フォーム: POST /published-comic-books）。

POST /published-comic-books
title=foo
author=boo
published
=2011-01-01
cover_type=front
cover_data=(binary)
=> 302 見つかりました。場所: /comic-books/3、カバー付きの公開済みコミックブック (id: 3) にリダイレクトします。

Answer 1