1. raw クライアント

raw クライアント

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

raw クライアントは、SDK の他のアクションと同様に認証および偽装されたままでの Sitecore Content Hub へのカスタム HTTP 要求または HTTPS 要求を可能にします。カスタム HTTP クライアントや委任ハンドラーはすべて引き続き使用され、イベントは引き続き発生します。

組み込みの要求

クライアントは、次の要求をサポートします。

  • GET
  • PUT
  • POST
  • DELETE

次のスニペットでは、ID 1000 のエンティティをフェッチし、REST API のデータ モデルである EntityResource として直接読み取ります。

HttpResponseMessage response = await MClient.Raw.GetAsync("http://localhost:8080/api/entities/1000");
response.EnsureSuccessStatusCode();
HttpResponseMessage resource = await response.Content.ReadAsJsonAsync<EntityResource>();

ReadAsJsonAsync メソッドは、Stylelabs.M.Sdk.WebClient.Http からインポートできます。

カスタム ヘッダーは、2 番目の (オプションの) パラメーターとして渡すこともできます。

要求の完全制御

さらに、たとえば、組み込みではない動詞に対して、SendAsync メソッドを使用して要求を完全に制御することも可能です。このメソッドには、HttpRequestMessage を返すファクトリ関数が必要です。ファクトリ関数が必要なのは、失敗時にメッセージを再試行できるようにするためです。再試行には新しいメッセージ オブジェクトだからです。

注意

raw クライアントからの結果は処理されないことに注意してください。失敗したステータス コードが返された場合、例外はスローされません。これは手動で行う必要があります。HttpResponseMessage の有用なメンバーには、EnsureSuccessStatusCode メソッドや IsSuccessStatusCode プロパティがあります。

この記事を改善するための提案がある場合は、 お知らせください!