主要内容

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

matlab.net.http.RequestMessageクラス

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

HTTP要求メッセージ

説明

RequestMessageクラスは,サーバーに送信して処理されるHTTP要求メッセージを書式設定するために使用します。メッセージを送信するには发送メソッドを使用します。また,メッセージを送信する前に検証するには完整的メソッドを使用します。これらのメソッドでは,必要なヘッダーフィールドおよび他のメッセージプロパティが埋められます。

クラスの属性

密封
真正的

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

作成

説明

obj = matlab.net.http.RequestMessageは既定値で要求メッセージを作成します。メッセージを送信または完了するとき,既定の方法プロパティはRequestMethod。得到です。

obj = matlab.net.http.RequestMessage(方法、头、身体)は1つ以上のオプションのメッセージプロパティを指定します。後続の引数を省略し,[]を使って任意のプレースホルダーを指定できます。

obj = matlab.net.http.RequestMessage (requestLine,头,身体)RequestLineプロパティをrequestLineに設定します。要求行の内容を制御する必要がある場合は、この構文を使用します。たとえば、メッセージを明示的にプロキシに送信するにはRequestLine。RequestTargetプロパティを完全なURIに設定します。それ以外の場合,MATLABはユーザーのプロキシの設定に基づいてプロキシを選択し、发送メソッドでRequestTargetをURIの路径プロパティに設定します。

obj = matlab.net.http.RequestMessage (requestLine头,提供者)matlab.net.http.io.ContentProviderからメッセージ本文のデータを取得します。

プロパティ

すべて展開する

要求行。matlab.net.http.RequestLineオブジェクト,またはメソッド,ターゲットおよびプロトコルのバージョンを含む字符串または文字ベクトルとして指定します。この行は,メッセージを送信するときに,指定したメソッドとURIに基づいて自動的に作成されます。このプロパティを明示的に設定すると,その内容が要求行として使用されます。値は,RequestLineオブジェクト,または解析されてRequestLineオブジェクトに変換される字符串に設定されることがあります。

例:“得到HTTP / 1.1”

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

要求メソッド。matlab.net.http.RequestMethod列挙型,要求メソッドを表す字符串または文字ベクトルとして指定します。メッセージを送信するには,RequestMessage。方法プロパティまたはRequestLine。方法プロパティを設定します。

例:“得到”

属性:

GetAccess
公共
SetAccess
公共
依赖
真正的

メッセージヘッダー。matlab.net.http.HeaderFieldオブジェクトまたはHeaderFieldオブジェクトのベクトルとして指定します。プロパティを設定すると,MATLAB®はヘッダーのフィールドをチェックしてメッセージタイプに対して適切であることを確認します。RequestMessage发送メソッドおよび完整的メソッドは,正しい形式の要求になるように必要なヘッダーフィールドを埋めます。

属性:

GetAccess
公共
SetAccess
公共

メッセージ本文。matlab.net.http.MessageBodyオブジェクト,matlab.net.http.io.ContentProvider,またはMessageBodyコンストラクターで受け入れ可能なデータとして指定します。既定では,身体は空です([]に設定されます)。身体プロパティを含む要求メッセージは通常,“把”または“职位”などのメソッドを使用し,既定値“得到”は使用しませんが,この表記は強制されません。

完了したメッセージまたは受信したメッセージで,メッセージにContentTypeFieldヘッダーフィールドがある場合,MessageBody。ContentTypeプロパティはその値に設定されます。それ以外の場合,ContentTypeは変更されないか空になります。

属性:

GetAccess
公共
SetAccess
公共

メッセージが完了しているかどうか。真正的またはとして指定します。真正的値はメッセージが完了していることを意味します。

メッセージを検証するメソッド(RequestMessage.sendRequestMessage.complete)は次を行った後に完成プロパティを真正的に設定します。

  • メッセージが有効であることを判別する。

  • 必要なヘッダーフィールドの追加やデータの変換などの処理を完了する。

このプロパティが真正の場合,これらのメソッドはメッセージを変更せず,发送メソッドはメッセージの有効性をチェックせずにメッセージを送信します。その後にこのメッセージに変更を加えると,完成プロパティがに戻されます。

任意のヘッダーとデータを要求メッセージで送信するには,完成真正的に設定して发送メソッドでメッセージが変更されないようにします。引き続き完整的メソッドを使用してメッセージを検証できますが,メッセージが有効かどうかにかかわらず发送メソッドはメッセージを送信します。

要求メッセージにデータが含まれている(的身体。数据プロパティが空でない)場合,完成的身体。有效载荷に生のデータが含まれている場合にのみ,真正的に設定されます。応答メッセージでは,HTTPOptions。SavePayloadプロパティを指定した場合にのみ,ペイロードが設定されます。

属性:

GetAccess
公共
SetAccess
公共
瞬态
真正的

データ型:逻辑

メッセージの開始行。matlab.net.http.StartLineオブジェクトとして指定します。

属性:

GetAccess
公共
SetAccess
公共

メソッド

すべて展開する

すべて折りたたむ

テキストをWebサイトに追加するようにサーバーに要求するHTTPメッセージを構成します。この例では,メッセージの書式設定のみを行い,データの送信はしません。

メッセージ本文に内容を追加します。

data =“发送数据”;身体= matlab.net.http.MessageBody(数据);body.show
数据发送

本文のデータ型を表す- typeヘッダーフィールドを作成します。

contentTypeField = matlab.net.http.field.ContentTypeField (“文本/普通”);

応答メッセージ内で許容されるデータ型を指定する接受ヘッダーフィールドを作成します。

类型1 = matlab.net.http.MediaType (“文本/ *”);类型2 = matlab.net.http.MediaType (“application / json”,“问”,“5”);= matlab.net.http.field.AcceptField([type1 type2]);

2つのヘッダーフィールドを含む要求ヘッダーを作成します。

header = [acceptField contentTypeField];

このメッセージが把要求であることを指定します。

方法= matlab.net.http.RequestMethod.PUT;

要求メッセージを作成し,その内容を表示します。

请求= matlab.net.http.RequestMessage(方法、头、身体);(请求)
Accept: text/*, application/json;q = 5Content-Type:文本/明文发送的数据
R2016bで導入