主要内容

このペ,ジの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

matlab.net.http.MessageBodyクラス

パッケ,ジ:matlab.net.http

HTTPメッセジの本文

説明

MessageBodyオブジェクトにはHTTPメッセ,ジの本文が含まれています。要求メッセ,ジでは,身体プロパティをデ,タ,またはデ,タを含むMessageBodyオブジェクトに設定します。応答メッセ,ジでは,このオブジェクトには受信したデータが含まれます。

メッセジデタは2のプロパティで表されます。有效载荷プロパティには,ネットワ,クで送受信した生のバ,トが含まれています。数据プロパティには,有效载荷がMATLAB®タ@ @プとして含まれています。これら2のプロパティのいずれかのみが設定されることがよくあります。

クラスの属性

密封
真正的

クラス属性の詳細にいては,クラスの属性を参照してください。

作成

MessageBodyオブジェクトにはHTTPメッセ,ジの本文が含まれています。要求メッセ,ジでは,身体プロパティをデ,タ,またはデ,タを含むMessageBodyオブジェクトに設定します。応答メッセ,ジでは,このオブジェクトには受信したデータが含まれます。

メッセジデタは2のプロパティで表されます。有效载荷プロパティには,ネットワ,クで送受信した生のバ,トが含まれています。数据プロパティには,有效载荷がmatlabタescプとして含まれています。これら2のプロパティのいずれかのみが設定されることがよくあります。

プロパティ

すべて展開する

メッセ,ジデ,タ。以下のmatlabデ,タ型のいずれかとして指定します。変換の詳細にいては,HTTPデタ型の変換を参照してください。

  • uint8ベクトル-変換されない数据

  • 文字配列またはスカラー字符串- - typeヘッダーのメディアタイプとその字符集属性に基づいて変換される数据

  • 構造体配列-webreadおよびwebwriteを使用してjson文字列から,またはjson文字列に変換される数据

  • @ @ @ @ @ @ @ @ @imreadおよびimwriteを使用してメジから,またはメジに変換される数据

  • XML dom -xmlreadおよびxmlwriteを使用して字符串から,または字符串に変換される数据

  • オディオデタ-audioreadおよびaudiowriteを使用して変換される数据

  • 表- - -xmlreadおよびxmlwriteを使用して変換される数据

  • 他のタesc escプの配列またはcell配列-jsonencodeおよびjsondecodeを使用してjsonから,またはjsonに変換される数据

要求メッセ,ジでは,数据プロパティはuint8ペロドに変換される前のmatlabデタです。デ,タ変換はRequestMessage发送メソッドまたは完整的メソッドを呼び出すと発生します。変換は,メッセ,ジで指定する内容类型と数据のタ@ @プによって異なります。内容类型を指定しない場合,发送メソッドおよび完整的メソッドはデータからタイプを推測し,適切なContentTypeFieldを要求メッセージに追加します。

応答メッセ,ジでは,数据はサバで指定された内容类型に基づいてMATLABタプに変換されたuint8ペ▪▪ロ▪▪ドを表します。変換に失敗した場合,数据は空のままで,生のデ,タが有效载荷プロパティに示されます。

応答有效载荷の自動変換を抑制するには,HTTPOptions。ConvertResponseプロパティをに設定します。その場合,数据には文字デタの字符串,またはバトのuint8ベクトルのいずれかが含まれます。

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

数据プロパティの内容类型。読み取り専用のmatlab.net.http.MediaTypeオブジェクトとして指定します。このプロパティは,数据プロパティのコンテンをペロドから,またはペロドに変換する方法を決定します。内容类型に字符集属性のあるMediaTypeが含まれる場合,字符集がエンコ,ドを決定します。

このプロパティの値は,通常,このMessageBodyを含むメッセ,ジの内容类型フィ,ルドで转换を呼び出した結果と同じです。

ContentTypeは要求メッセ,ジでは設定しません。MessageBodyオブジェクトを作成するとき,このプロパティは空になります。MessageBodyを要求メッセ,ジにコピ,すると,メッセ,ジにContentTypeFieldの値がある場合,ContentTypeはこれに設定されます。RequestMessage发送メソッドおよび完整的メソッドは,要求メッセ,ジの数据のタ@ @プとContentTypeFieldの値に基づいてContentTypeを設定します。

応答メッセ,ジでは,ContentTypeはメッセ,ジのContentTypeFieldに基づいています。

属性:

GetAccess
公共
SetAccess
公共
瞬态
真正的

このプロパティは,ResponseMessage有效载荷プロパティがエンコ,ドされていることを示すために設定されます。ContentCodingが設定されると,ペ数据プロパティは空になります。

Matlabは,ペ,ロ,ドがgzip缩小などのサポートする圧縮アルゴリズムを使ってエンコードされたメッセージを受信すると,他の変換を行う前にこのペイロードを自動的にデコードします。正常にデコドされると,オプションで,デコドされたペロドを有效载荷に,変換されたペ数据に格納します。その場合,このプロパティは空になり、有效载荷がエンコ,ドされていないことを示します。

エンコドされたペロドのデコドに失敗した場合,またはHTTPOptions。DecodePayloadプロパティをに設定してデコ,ドを抑制した場合,エンコ,ドされたままの未処理のペ,ロ,ドが有效载荷に返され,数据が空のままになり,ContentCodingは応答メッセージの内容编码ヘッダーフィールドの値を表す字符串のベクトルに設定されます。この場合,有效载荷をそのまま保存したり(たとえば,ファ),ContentCodingで指定された圧縮アルゴリズムに従って処理することができます。たとえば,値がgzipの場合,デ,タをファ,ルに書き込んでgunzipコマンドを使用してデ,タを処理できます。

属性:

GetAccess
公共
SetAccess
公共
瞬态
真正的

デ,タ型:字符串

メッセジで送信された生のバト。uint8ベクトル,スカラ,stringまたは文字ベクトルとして指定します。便宜上,要求メッセ,ジでは,有效载荷をスカラ,stringまたは文字ベクトルに設定できます。Matlabは値をuint8ベクトルに変換します。応答メッセ,ジでは,有效载荷は常にuint8ベクトルです。

要求メッセ,ジでは,次のようになります。

  • スカラ,stringまたは文字ベクトルは,ContentTypeプロパティで明示的または暗黙的に指定された字符集がある場合はこれを使用して,あるいは何も設定されなかった場合はutf - 8エンコ,ドを使用して変換されます。異なるエンコ,ドを使用する場合は,たとえば,関数unicode2nativeを使用して自分でエンコ,ドし,結果のuint8ベクトルを有效载荷に割り当てます。

  • バ电子邮箱ト配列での出力変換を行わない場合,数据プロパティではなく有效载荷を設定します。代わりに数据を設定すると,RequestMessage.sendに要求または履歴戻り引数を指定する場合はRequestMessage.completeの戻り値において,HTTPOptions。SavePayloadプロパティを設定する場合はResponseMessageにおいて,有效载荷が送信されたバ@ @トで埋められます。

  • 有效载荷を設定すると,数据がクリアされます。数据および有效载荷の両方が設定されたメッセ,ジを送信すると,有效载荷が送信され,数据は無視されます。发送メソッドまたは完整的メソッドで返された応答メッセージと要求メッセージのみが,両方のプロパティを同時に設定することができます。

応答メッセ,ジでは,有效载荷は次の場合に受信される生のバ@ @トです。

  • RequestMessage.sendメソッドで履歴戻り引数を指定する。

  • HTTPOptions。SavePayloadプロパティを真正的に設定する。

  • 有效载荷表明で示されるメッセ,ジに常に設定される。

  • ペロドからmatlabデタへの変換が失敗した場合。詳細にいては,textbox。历史プロパティをチェックしてください。

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

メソッド

すべて展開する

R2016bで導入