Main Content

getFields

类: matlab.net.http.Message
包: matlab.net.http

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

说明

示例

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

输入参数

全部展开

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

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

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

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

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

  • 向量或以逗号分隔的 meta.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 = 
  DateField with properties:

     Name: "Date"
    Value: "Sat, 27 Aug 2022 05:15:58 GMT"

indices=1×2 cell array
    {0x0 double}    {[3]}

版本历史记录

在 R2016b 中推出