matlab.net.http.field.CookieField 类

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

HTTP Cookie 标头字段

描述

如果 Set-Cookie 字段中存在 Cookie，则您可以通过在请求消息中包含一个 CookieField 对象，将这些 Cookie 发送给服务器。有关详细信息，请参阅 Internet Engineering Task Force (IETF^®) 网站上的 RFC 6265 HTTP State Management Mechanism。

类属性

Sealed true

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

创建对象

描述

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

示例

属性

全部展开

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

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

属性：

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

`Value` — Cookie
字符串

Cookie，指定为字符串。

属性：

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

方法

全部展开

公共方法

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

专用于子类

convert

由 CookieField 中的 Cookie 对象组成的向量

专用运算符和函数

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

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

示例

全部折叠

将收到的所有 HTTP Cookie 发送回服务器

打开脚本

此示例将所有 Cookie 发送给服务器。在实际操作中，只能发送未过期的 Cookie。

如果初始交换涉及多个有关身份验证和重定向的消息，您可能希望从包含所有这些消息的历史记录中获取 CookieInfo 对象。有关详细信息，请参阅CookieInfo.collectFromLog。

r = matlab.net.http.RequestMessage;
resp = send(r,'https://www.mathworks.com');
setCookieFields = resp.getFields('Set-Cookie');
if ~isempty(setCookieFields)
   % fetch all CookieInfos from Set-Cookie fields and add to request
   cookieInfos = setCookieFields.convert;
   r = r.addFields(matlab.net.http.field.CookieField([cookieInfos.Cookie]));
end
resp = r.send('https://www.mathworks.com');