クライアントからサーバへのデータ転送

1.クエリー・パラメータによるデータ転送

GET

は主にソートフィルタ(クエリー)

である.

2.メッセージ本体によるデータ転送

POST, PUT, PATCH

会員に加入し、商品を注文し、資源を登録し、資源を変更する

例

静的データ・クエリー

画像、静的文書ドキュメント

クエリGET

を使用

静的データは、通常、クエリパラメータのないリソースパスを介して単純なクエリ

を行う.

動的データ・クエリー

検索範囲:

週、掲示板リストのソートフィルタ(検索語)

クエリー条件を減らすフィルタで、主にクエリー結果をソートするためのソート条件

が使用されます.

クエリGET

を使用

GETクエリーパラメータを使用してデータを渡す

HTML Formデータ転送

Form submitの場合、Webブラウザはフォームデータを読み込んでHTTPメッセージを生成します.

フォーム転送はGETのみ、POSTは

をサポートする.

コンテンツ-タイプ:アプリケーション/x-www-form-urlcodedの使用
formの内容をurl符号化し、メッセージ本体を介して送信(key=value、クエリーパラメータフォーマット)

Content-Type:multipart/form-data
ファイルアップロードなどのバイナリデータ転送に使用
異なるタイプのファイルとフォームの内容を同時に転送できます.

HTML APIデータ転送

サーバからサーバ、アプリケーションクライアント、Webクライアント

へ

HTMLフォームを使用しないほとんどの場合

POST、PUT、PATCH:メッセージ本体を介してデータを転送する

.

GET:クエリー・クエリー・パラメータ転送データ

コンテンツタイプ:主にアプリケーション/jsonを使用

HTTP設計例

HTTP API－集合

POSTに基づく登録

クライアントは登録するリソースのURIを知らない.

    회원 등록 /members -> POST
    POST /members

サーバは、新たに登録されたリソースURIを生成する.

    HTTP/1.1 201 Created
    Location: /members/100

コレクション
サーバ管理のリソースディレクトリ
サーバがリソースを作成し管理するURI

会員管理システムAPI
•メンバーリスト/member->GET
•会員登録/member->POST
•会員照会/members/{id}->GET
•メンバー/メンバー/{id}->PATCH、PUT、POSTの変更
•メンバー/members/{id}->DELETEの削除
ここで/membersは集合を表す.

HTTP API-ショップ

PUTベースの

登録

クライアントは、リソースURIを知るべきである.

    파일 등록 /files/{filename} -> PUT
    PUT /files/star.jpg

クライアントは、リソースURIを直接指定します.

ショップ
クライアント管理リポジトリ
クライアントはリソースのURIを知り、

を管理する.
ファイル管理システムAPI
•ファイルリスト/files->GET
•ファイルの表示/files/{filename}->GET
•ファイル登録/files/{filename}->PUT
•ファイルの削除/files/{filename}->DELETE
•ファイルの一括登録/files->POST
ここで/filesは集合を表します.
📢 多くの場合、POSTベースの新しいリソース登録が使用されます.

HTMP FORMの使用

GET、POSTのみ

をサポート

AJAXなどの技術で

を解決できる
•メンバーリスト/member->GET
•メンバー登録フォーム/メンバー/new->GET
•会員登録/会員/new、/member->POST
•会員照会/members/{id}->GET
•メンバー変更フォーム/メンバー/{id}/edit->GET
•メンバー/members/{id}/edit、/members/{id}->POSTの変更
•メンバー/メンバー/{id}/delete->POSTの削除

コントロールURIの使用
GET,POSTのみをサポートする制約を解決するために,動詞のリソースパスを用いた.上記の例では、POSTの/new、/edit、/deleteは、制御URIを表す.
HTTP法で解決するのはちょっと難しいです.

整理する

ドキュメント(ドキュメント)
•単一のコンセプト(ファイル、オブジェクトインスタンス、データベース行)
•例)/members/100、/files/star.jpg

コレクション
•サーバ管理のリソースディレクトリ
•サーバによるリソースのURIの作成と管理
•はい/メンバー

ショップ(ショップ)
•クライアントが管理するリポジトリ
•クライアントがリソースのURIを知って管理する
•はい/ファイル

コントローラ、制御URI
•ドキュメント、コレクション、ショップを使用して、他の困難なプロセスを実行
•動詞を直接使う
•例)/members/{id}/delete

インフラストラクチャベースの「すべての開発者向けHTTP Web基本知識」コースを作成します.