raw クライアント

Version:

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

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

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

組み込みの要求

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

GET
PUT
POST
DELETE

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

import { ResponseMessage } from "@sitecore/sc-contenthub-webclient-sdk/dist/clients/response-message";

var response: ResponseMessage = await client.raw.getAsync("http://localhost:8080/api/entities/1000");
if (response.isSuccessStatusCode) {
//custom code around response.content
}

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

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

要求の完全制御

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

注意

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

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