Main Content

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

matlab.net.http.io.ImageConsumer クラス

パッケージ:matlab.net.http.io
スーパークラス:matlab.net.http.io.ContentConsumer

HTTP ペイロードのイメージ データのコンシューマー

説明

このコンシューマーは Web からイメージ データを読み取り、それを MATLAB®イメージ データに変換します。結果は、適用先のResponseMessageBodyプロパティに格納します。RequestMessage.sendでコンシューマーとして直接指定され、コンシューマーが指定されていないときに既定のsendメソッドによって提供される同じ機能をイメージ コンテンツ タイプに対して提供します。メッセージの Content-Type に基づいて、変換済みのイメージ、考えられるカラーマップおよびアルファ チャネルをBody.Dataに保存します。応答のイメージ データの変換の詳細については、HTTP データ型の変換image/*Content-Types の説明を参照してください。

このコンシューマーが受け入れるデータは,応答メッセージのヘッダーや,要求のURIに含まれるファイル名の拡張子 (存在する場合) に基づいて形式を特定できるデータのみです。想定される形式をFormatプロパティに指定することで、この動作をオーバーライドできます。

このコンシューマーは、データを関数imreadの戻り値に記述されている形式のいずれかの MATLAB イメージとして返します。元のデータを変換せずにファイルに格納するには、FileConsumerを使用します。

matlab.net.http.io.ImageConsumerクラスはhandleクラスです。

作成

説明

consumer = ImageConsumerは、HTTP イメージのコンシューマーを構築します。

consumer = ImageConsumer(fmt)は、特定の形式を使用してImageConsumerを構築します。

consumer = ImageConsumer(___,arg1,...,argn)は、応答データを変換するためにimreadによって使用される追加の引数を渡します。

入力引数

すべて展開する

イメージ形式。imreadで受け入れられる string または文字ベクトルとして指定します。この値はメッセージ ヘッダーのどの書式仕様よりも優先されます。このコンストラクターはFormatプロパティをfmtの値に設定します。

例:'png'

関数imreadへの1つ以上の入力引数。有効な引数の型として指定します。filename引数またはfmt引数を指定しないでください。

例:'PixelRegion',{[1 100],[4 500]}

プロパティ

すべて展開する

パブリック プロパティ

関数imfinfoに必要なイメージ情報。構造体として指定します。MATLAB は、変換の成功後にのみこのプロパティを設定します。この構造体のFilenameフィールドは空です。

属性:

GetAccess
public
SetAccess
private

部分イメージ データ。uint16として指定します。変換に失敗したり、転送が中断された場合、MATLAB ではPartialDataが、uint8ベクトルである受信した生データに設定されます。転送中または成功した場合、PartialDataにはデータが含まれない場合があります。

属性:

GetAccess
public
SetAccess
private

イメージ形式。string または文字ベクトルとして指定します。このコンシューマーは、関数imformatsの EXT 列で指定された形式のいずれでもないメッセージを拒否します。このプロパティの既定値は空であり、応答の Content-Type フィールドまたは Content-Disposition フィールドのファイル名の拡張子、または要求の URI から形式を派生させようとします。このコンシューマーに特定の形式を使用してデータを処理するよう強制する場合は、このコンシューマーをRequestMessage.sendメソッドに適用する前にこのプロパティを設定します。

サーバーによって形式が適切に示されていない場合は、このプロパティを正しい形式に設定します。

属性:

GetAccess
public
SetAccess
public

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

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

属性:

GetAccess
public
SetAccess
public

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

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

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

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

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

属性:

GetAccess
public
SetAccess
public

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

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

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

例:'application/octet-stream'

属性:

GetAccess
public
SetAccess
public

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

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

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

属性:

GetAccess
public
SetAccess
public

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

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

属性:

GetAccess
public
SetAccess
public

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

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

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

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

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

属性:

GetAccess
public
SetAccess
public
Dependent
true

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

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

属性:

GetAccess
public
SetAccess
public

保護プロパティ

データを追加するためにputDataメソッドで呼び出される関数。関数ハンドルとして指定されます。このクラスのputDataメソッドは、data引数で受け取ったデータを応答メッセージの既存のデータに追加するために関数AppendFcnを呼び出します。この関数のシグネチャは次のとおりでなければなりません。

AppendFcn(consumer,newdata)

newdataは、consumer.Response.Body.Dataの配列に追加されるデータです。このメソッドは、Dataの新しい長さに合わせてconsumer.CurrentLengthを更新する必要があります。newdataが空の場合はストリームの末尾を示し、関数によりResponse.Body.Dataが最終的な値に更新されます。

既定の動作では、このプロパティが空の場合、Dataを任意の値の配列として扱う、関数horzcatに対応した内部関数が使用されます。この関数では、スペースを事前に割り当てることで効率的にnewdataが追加され、格納されたデータの実際の長さがCurrentLengthに反映されます。メッセージの最後に、Response.Body.DataCurrentLengthの値までで切り捨てられます。

horzcatが追加処理に適さない場合は、このプロパティをサブクラスで変更できます。たとえば、StringConsumerでスカラー string を作成する場合は、string への追加に関数horzcatではなく関数plusを使用することがあります。

データを追加するContentConsumer.putDataを呼び出さない場合やデータを追加する際のhorzcatの動作に問題がない場合は、サブクラスでこのプロパティを無視することができます。

例:@customAppend@customAppendはコンシューマーによって定義されます。

属性:

GetAccess
protected
SetAccess
protected

このコンシューマーによるデリゲート先のContentConsumermatlab.net.http.io.ContentConsumerオブジェクトとして指定します。呼び出し元のコンシューマー (デリゲーター) のdelegateToメソッドによってCurrentDelegateプロパティが設定されます。現在のデリゲーションがない場合、値は[]です。

MATLAB はinitializeを呼び出す前にCurrentDelegate[]に設定します。

属性:

GetAccess
protected
SetAccess
protected

Response.Body.Dataプロパティの現在のデータの長さ。uint64として指定されます。

このプロパティは、Response.Body.Dataに事前に割り当てられたサイズが現在格納されている実際のデータの量よりも大きい場合に、格納されているデータの長さを示すために使用されます。このプロパティが空の場合は、すべてのResponse.Body.Dataにデータが格納されているか、ContentConsumerサブクラスでResponse.Body.Dataに格納する以外の何らかの方法でデータが破棄されていることを示します。

このプロパティは、この基底クラスのputDataメソッドで、AppendFcnプロパティが空の場合に使用および設定されます。putDataを呼び出すサブクラスで既に格納されているデータを確認したり、AppendFcnの任意の実装でResponse.Body.Dataに結果を反映したりするのに使用できます。

putDataを使用するサブクラスでは、このプロパティを変更してデータが格納されるバッファーの位置をリセットすることもできます。たとえば、既定の関数AppendFcnを使用している場合、putDataの呼び出しごとにすべてのResponse.Body.Dataを処理するサブクラスで元のデータが不要になったときは、CurrentLengthプロパティを 1 にリセットすることで次のputDataの呼び出し時に新しいデータでバッファーを上書きできます。新しいデータの末尾を越えてバッファーの要素をクリアする必要はありません。

putDataを呼び出さないサブクラスでは、このプロパティを独自のデータの追跡に使用できます。使用しない場合は未設定 (空) のままにしておいてかまいません。ここで設定できる値に関して、MATLAB にはいかなる制約もありません。また、この値は、既定のAppendFcnでデータの次のバッファーを格納する位置とメッセージの末尾のデータを切り捨てる位置を特定するためにのみ使用され、それ以外の目的には使用されません。データが切り捨てられないようにするには、putData(uint8.empty)の最後の呼び出しの前にこのプロパティを空に設定します。

このプロパティは、initializeの各呼び出しの前に MATLAB で空に設定されます。

属性:

GetAccess
protected
SetAccess
protected

このコンシューマーのデリゲート元のContentConsumermatlab.net.http.io.ContentConsumerオブジェクトとして指定されます。このコンシューマーがGenericConsumerMultipartConsumerなどの別のコンシューマーから呼び出されたデリゲートである場合、これは呼び出し側のコンシューマーを示します。sendの呼び出しで指定された最上位のコンシューマーの場合は空になります。

デリゲートは、このプロパティを使用してデリゲーターのプロパティにアクセスし、デリゲート元のコンシューマーなどを確認できます。

属性:

GetAccess
protected
SetAccess
protected

メソッド

すべて展開する

詳細

すべて展開する

R2018a で導入