データの変換に使用する文字セット。string として指定します。この値は最初は空です。空のままにすると、メッセージの受信時にメッセージの Content-Type フィールドで指定された charset または既定の charset に基づいて値が設定されます。変換に別の charset を使用する場合は、StringConsumerコンストラクターで charset を指定するか、このプロパティを直接設定します。このプロパティは、メッセージの途中も含め、サブクラスでいつでも設定できます。この値をputDataの呼び出し後に変更した場合、後続のputDataの呼び出しで新しい値が使用されます。Response.Body.Dataの既存の内容は変更されません。

このプロパティを空のままにした場合、応答の受信の開始時に、MATLAB で Content-Type に基づいて選択された charset に設定されます。このコンシューマーを別のメッセージに再利用する場合は、新しい charset を選択できます。このプロパティを空でない値に設定した場合、MATLAB で変更されることはありません。

属性:

返すデータの型。"string"または"char"として指定します。この値は 'TextType' パラメーターからコンストラクターに渡されます。既定の設定は "string" です。この値の変更時にデータが既にResponse.Body.Dataに格納されていた場合、そのデータは新しい型に変換されます。

属性:

推奨されるバッファー サイズ。uint64として指定されます。AllocationLengthは、MATLAB により、putDataに渡されるデータの予測されるバッファー サイズに設定されます。実際のサイズは、これよりも小さくなることも大きくなることもあります。パフォーマンスを向上させるために、この値を使用して、コンシューマーでデータを処理するためのスペースを事前に割り当てることができます。

このプロパティは、サブクラスで利用できるように、startメソッドを呼び出す前に MATLAB で設定されます。

属性:

想定されるペイロードの長さ。uint64として指定されます。このプロパティは通常、Headerプロパティにおけるmatlab.net.http.field.ContentLengthFieldのValueプロパティになります。

ContentLengthが空の場合、長さは不明です。ペイロードはputData(uint8.empty)が呼び出された時点で終了します。

このプロパティは、サブクラスでデータの長さを確認できるように、initializeを呼び出す前に MATLAB で設定されます。

このContentConsumerが最上位のコンシューマーのデリゲートである場合、ContentLengthの値が最上位のコンシューマーのContentLengthと異なる値になることがあります。

例:numel(someData)。ここで、someDataはuint8型です。

属性:

ペイロードのメディア タイプ。matlab.net.http.MediaTypeオブジェクトとして指定します。このプロパティは通常、Headerプロパティにおけるmatlab.net.http.field.ContentTypeFieldのValueプロパティになります。ContentTypeプロパティが空の場合、ContentTypeFieldは空または存在しません。

このプロパティは、サブクラスでMediaTypeを確認できるように、initializeを呼び出す前に MATLAB で設定されます。データから別のMediaTypeであることがわかった場合は、サブクラスでこのプロパティを設定できます。

この値は、転送の終了時に MATLAB によってResponse.Body.ContentTypeプロパティにコピーされます。

例:'application/octet-stream'

属性:

現在処理中のペイロードのヘッダー。matlab.net.http.HeaderFieldオブジェクトとして指定されます。

コンシューマーは、このヘッダーを使用して、送られてくるペイロードの処理方法を決定します。最上位のコンシューマーの場合、この値はResponse.Headerと同じになります。デリゲートの場合は値が異なることがあります。たとえば、MultipartConsumerで処理されるマルチパート メッセージの場合は、そのデリゲートで処理中のパートのヘッダーになります。デリゲートは引き続きResponse.Headerで元のメッセージのヘッダーを確認できます。

このプロパティは、サブクラスで利用できるように、initializeを呼び出す前に MATLAB で設定されます。

属性:

送信が完了したRequestMessage。matlab.net.http.RequestMessageオブジェクトとして指定します。これは、すべてのリダイレクトが完了した最終的なRequestMessageであり、sendメソッドからのcompletedrequest戻り値です。

このプロパティは、サブクラスで利用できるように、initializeを呼び出す前に MATLAB で設定されます。

属性:

処理中のResponseMessage。matlab.net.http.ResponseMessageオブジェクトとして指定します。

Responseプロパティは、initializeを呼び出す前に MATLAB で設定されます。この値は、ヘッダーの受信まで完了し、ペイロードを受信する前のResponseMessageになります。応答メッセージの処理の開始時 (マルチパート メッセージの場合はパートの開始時) に、ResponseMesssage.Bodyプロパティは、DataプロパティとPayloadプロパティが空のMessageBodyオブジェクトになります。受信したデータを格納するために、コンシューマーはデータ転送中にResponseプロパティとMessageBody.Dataプロパティを変更できます。通常、コンシューマーはデータセットResponse.Body.Dataを処理してから処理済みのペイロードに格納しますが、これは必須ではありません。転送が完了すると、このResponseが MATLAB からsendの呼び出し元に返されます。ResponseのHeaderやStatusLineなどの他のプロパティは、コンシューマーで変更しないでください。これらを変更した場合、その変更がsendの呼び出し元に返されます。

Response.Body.Payloadプロパティは転送中は空であり、コンシューマーで変更してはなりません。HTTPOptions.SavePayloadプロパティが設定されると、次に MATLAB は、メッセージまたはパートの転送終了時 (putData(uint8.empty)の呼び出し後)、または例外の発生時に、受信したペイロードにPayloadを設定します。

メッセージの処理中にコンシューマーで例外が発生した場合は、MATLAB からHTTPExceptionオブジェクトがスローされます。HistoryプロパティにはこのResponse値が含まれます。

コンシューマーがマルチパート メッセージのパートを処理するデリゲートの場合、Response.Headerにメッセージ全体のヘッダーが格納され、各パートのContentConsumerを呼び出す前にResponse.BodyのPayloadプロパティとDataプロパティがクリアされます。各パートの最後で、元の応答のBody.DataにあるResponseMessageオブジェクトの配列の末尾に、このオブジェクトのHeaderおよびこのプロパティのBodyを含む、新しいResponseMessageが追加されます。次のデリゲートでは、前のデリゲートのMessageBodyではなく空のMessageBodyを含む新規のResponseが確認されます。

属性:

処理中の要求の送信先。matlab.net.URIオブジェクトとして指定されます。この値は、sendで決定される元の送信先 URI の値になります。プロキシの URI やリダイレクト後の最終的な URI ではありません。

このプロパティは、サブクラスで利用できるように、initializeを呼び出す前に MATLAB で設定されます。

属性: