matlab.net.http.field.AcceptField 类

R2026b

命名空间: matlab.net.http.field
超类: matlab.net.http.HeaderField, matlab.net.http.field.MediaRangeField

HTTP Accept 标头字段

描述

AcceptField 对象是请求消息中的 HTTP 标头字段。此字段包含一个或多个媒体类型设定，用于指示客户端可接受的内容类型。有关此字段的描述，请参阅 RFC Editor 网站上的 RFC 7231 Semantics and Content, section 5.3.2 Accept。

类属性

Sealed true

有关类属性的信息，请参阅类属性。

创建对象

描述

obj = matlab.net.http.field.AcceptField(value) 创建一个 Accept 标头字段，并将 Value 属性设置为 value。

如果服务器可以返回不同的 MediaType 对象，而您只想接收某些类型，则可以使用 Accept 字段。如果您不指定 Accept 字段，服务器可能会假定您愿意接收任何类型。

示例

属性

全部展开

`Name` — 标头字段的名称
`'Accept'`

标头字段名称，指定为 'Accept'。

特性：

`GetAccess`	`public`
`SetAccess`	`public`

`Value` — 媒体类型
`matlab.net.http.MediaType` 对象的向量 | 字符串向量 | 字符向量元胞数组

媒体类型，指定为 matlab.net.http.MediaType 对象向量、字符串向量或字符向量元胞数组。所有字符串都必须可被 MediaType 构造函数接受。每个 Value 代表一种媒体类型，其中包含一个可选的质量 ('q') 参数。该字段的 Value 属性是包含转换为字符串的 MediaType 对象的以逗号分隔的列表。

示例: MediaType('application/json','q','.5')

特性：

`GetAccess`	`public`
`SetAccess`	`public`
`Dependent`	`true`

方法

全部展开

公共方法

`addFields`	向 HeaderField 数组中添加字段
`removeFields`	从标头字段数组中删除字段
`changeFields`	更改 HeaderField 数组中的现有值
`replaceFields`	更改 HeaderField 数组中的值或向其中添加字段
`getFields`	返回与名称或类匹配的标头字段
`eq`	比较两个 HeaderField 数组
`convertLike`	以与另一个标头字段类似的转换方式来转换标头字段的值
`parse`	解析标头字段值并返回为字符串
`displaySubclasses`	显示支持的 HeaderField 子类

专用于子类

convert

将 AcceptField 解析为以逗号分隔的值列表，并将每个 Value 属性转换为 MediaType 对象。每个值均为在 RFC 7231 Media Type, section 3.1.1.1 中定义的媒体类型表达式。

专用运算符和函数

这些方法将标准的 MATLAB^® 运算符和函数应用于此类中的对象。

`isequal`	如果两个标头字段数组大小相同且对应元素相等，则为 `true`，如 `eq` 方法所述。
`string`	以字符串形式返回标头字段数组，如其在消息中所示。字段之间会插入换行符，但并非所有字段末尾都会有换行符。
`char`	以字符向量形式返回标头字段数组，如 `string` 方法所述

示例

全部折叠

指定媒体内容类型

此示例说明客户端如何为读取图像指定媒体类型 image/jpeg。

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

httpUrl  = "https://example.org";
uri = URI(strcat(httpUrl,"exampleimage.jpg"));
headers = AcceptField(MediaType("image/jpeg")); 
req = RequestMessage('GET',headers);
[~, completedReq, ~] = req.send(uri);

版本历史记录

在 R2016b 中推出

另请参阅

MediaType | RequestMessage | ResponseMessage