このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
matlab.net.http.io.StringConsumer クラス
名前空間: matlab.net.http.io
スーパークラス: matlab.net.http.io.ContentConsumer
HTTP ペイロードの文字列コンシューマー
説明
StringConsumer
は、応答メッセージの文字データを Content-Type に基づく charset に従ってデコードして応答の本文に格納します。このコンシューマーを RequestMessage
の送信時に直接指定して、特定のパラメーターのデータに対する文字列変換を指定できます。
このコンシューマーのサブクラス化の例については、Figure ウィンドウでのストリームデータの表示の PricesStreamer
クラスを参照してください。
matlab.net.http.io.StringConsumer
クラスは handle
クラスです。
作成
説明
consumer = StringConsumer
は、メッセージの Content-Type で指定された文字セットを使用して入力をスカラー string に変換するコンシューマーを構築します。
consumer = StringConsumer(
は、1 つ以上の Name,Value
)Name,Value
のペアの引数で指定されたオプションを使用してコンシューマーを構築します。Name
はプロパティ名の Charset
または TextType
で、Value
は対応する値です。Name1,Value1,Name2,Value2
のように、名前と値のペアの引数を任意の順番で指定できます。
Charset
プロパティを指定しない場合、このコンシューマーでは、Response
の Content-Type フィールドに基づいて MATLAB® で設定される ContentType
プロパティからの charset の派生が試行されます。StringConsumer
では、ContentType
で charset パラメーターが明示的に指定されている場合、あるいはそのタイプの既定の charset が MATLAB で認識されている場合に charset が特定されます。
"text/*"
- サブタイプに応じて US-ASCII または UTF-8 のいずれか。"application/*"
- サブタイプの UTF-8 (json、xml、javascript、css、x-www-form-urlencoded)、それ以外は不明。
このコンシューマーでメッセージの ContentType
から charset を特定できない場合、メッセージは拒否されて変換されません。その場合、ResponseMessage.Body
には uint8 ペイロードのみが格納されます。charset が不明なメッセージを変換する場合は、メッセージに適用する前 (サブクラスを作成している場合は initialize
メソッドを呼び出す前) にこのコンシューマーで Charset
を設定します。US-ASCII および他のいくつかの charset のスーパーセットである UTF-8 を使用することを推奨します。
プロパティ
メソッド
詳細
バージョン履歴
R2018a で導入