getFields

类: matlab.net.http.Message
命名空间: matlab.net.http

返回与名称或类匹配的消息标头字段

全页展开

语法

[fields,indices] = getFields(messages,ids)

说明

[fields,indices] = getFields(messages,ids) 返回消息中与给定 ID 匹配的字段及其索引。

示例

输入参数

全部展开

消息，指定为由 matlab.net.http.Message 对象组成的向量。

示例: getFields([msg1,msg2],'Date')

要匹配的名称，指定为下列值之一。

  • 字符串向量、字符向量、字符向量元胞数组或以逗号分隔的字符串或字符向量列表，其中包含要返回的字段的名称。名称不区分大小写。

  • 向量或由一个或多个 matlab.net.http.HeaderField 对象组成的逗号分隔列表，这些对象的 Name 属性用于决定要返回的字段。名称不区分大小写。这些对象中的标头字段值将被忽略。

  • 向量或以逗号分隔的 matlab.metadata.Class 对象列表，这些对象是 HeaderField 的子类。

    getFields 方法将搜索与指定类支持的名称相匹配的名称，而不管是什么类。如果某个子类没有一组特定的受支持名称，将匹配该子类的所有标头字段，而不管其名称为何。调用 HeaderField.displaySubclasses 方法可查看支持的名称。

示例: getFields(response,'Date','Content-Type')

输出参量

全部展开

与输入匹配的字段，返回 matlab.net.http.HeaderField 对象数组。如果不存在匹配项，getFields 将返回空 HeaderField 数组。名称搜索不区分大小写。

字段的索引值，返回为整数数组，如果没有匹配项，则返回 []。

如果 messages 为向量，getFields 将返回与所有消息中的 ids 匹配的字段。indices 是一个向量元胞数组，其中 indices{i} 包含 messages{i} 中匹配字段的索引。

示例

全部展开

打开实时脚本

使用 RequestMessage.complete 方法，将缺失的 Date 标头字段添加到请求消息中。

创建一个请求消息，以便从 MathWorks® 网站获取文本。

uri = matlab.net.URI('https://www.mathworks.com');
req = matlab.net.http.RequestMessage;

验证该消息中包含 Date 字段。日期值反映您的系统信息。值 indices{1} = [] 指示 req 不包含 Date 字段。

request = complete(req,uri);
[fields,indices] = getFields([req,request],?matlab.net.http.field.HTTPDateField)
fields = 

  1×0 HeaderField array with properties:

    Name
    Value

indices=1×2 cell array
    {0×0 double}    {1×0 double}

版本历史记录

在 R2016b 中推出

另请参阅

|