matlab.net.http.field.ContentLengthField クラス

名前空間: matlab.net.http.field
スーパークラス: matlab.net.http.HeaderField, matlab.net.http.field.IntegerField

HTTP Content-Length フィールド

説明

ContentLengthField オブジェクトは、ペイロードの長さをバイト数で指定する、要求メッセージまたは応答メッセージの HTTP ヘッダーフィールドです。

MATLAB^® では、ペイロードのあるすべての送信メッセージに Content-Length フィールドが含まれている必要があります。メッセージの本文が空でない場合、MATLAB はデータの長さに基づいて Content-Length フィールドを作成します。ただし、チャンク化されたデータ転送の場合は、いずれのフィールドも追加されません。詳細については、RFC 7231、セクション 3.3.2. の Content-Length (Internet Engineering Task Force (IETF^®) の Web サイト上) を参照してください。

応答メッセージにはこのフィールドが含まれる場合と含まれない場合があります。

クラスの属性

Sealed

true

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

作成

説明

obj = matlab.net.http.field.ContentLengthField(value) は Value プロパティを value に設定して、Content-Length ヘッダー フィールドを作成します。

プロパティ

Name — ヘッダー フィールド名

'Content-Length'

ヘッダー フィールド名。'Content-Length' として指定します。

属性:

GetAccess	public
SetAccess	public

Value — ペイロードの長さ

非負の整数 | string

ペイロードの長さ (バイト数)。非負の整数、または非負の整数と評価される string として指定します。

属性:

GetAccess	public
SetAccess	public
Dependent	true

メソッド

パブリック メソッド

addFields	HeaderField 配列へのフィールドの追加
removeFields	ヘッダー フィールド配列からフィールドを削除
changeFields	HeaderField 配列内の既存値を変更
replaceFields	HeaderFields の配列の値を変更またはフィールドを追加
getFields	名前またはクラスが一致するヘッダー フィールドを返す
eq	2 つの HeaderField 配列の比較
convertLike	ヘッダー フィールド値を別のヘッダー フィールドと同様に変換
parse	ヘッダー フィールド値を解析して string として返す
displaySubclasses	サポートされる HeaderField サブクラスの表示

サブクラスに特化

convert

double 型の整数として ContentLengthField の Value プロパティを返す

特殊な演算子と関数

次のメソッドは、MATLAB の標準の演算子および関数を、このクラスのオブジェクト用に特殊化したものです。

isequal	eq メソッドで示されているように、2 つのヘッダー フィールド配列が同じサイズで、対応する要素が等しい場合は true
string	string としてのヘッダー フィールドの配列。メッセージに表示されます。フィールド間に改行文字を挿入しますが、すべてのフィールドの最後には挿入しません。
char	string メソッドで示されているように、文字ベクトルとしてのヘッダー フィールドの配列

例

メッセージ ペイロードの長さの表示

この例では、メッセージの Content-Length フィールドを読み取る方法を示します。

import matlab.net.*;
import matlab.net.http.*;

httpsUrl = 'https://requestserver.mathworks.com';
uri = URI(strcat(httpsUrl, '/assets/computerVision.jpg'));
req = RequestMessage('GET');
response = req.send(uri);
contentLengthField = response.getFields("Content-Length");
disp(contentLengthField)

  ContentLengthField with properties:

     Name: "Content-Length"
    Value: "102297"

バージョン履歴

R2016b で導入