Main Content

matlab.net.http.CookieInfo 类

命名空间: matlab.net.http

HTTP Cookie 信息

描述

CookieInfo 类中包含 Cookie 对象以及有关 Cookie 的信息,您可以利用这些信息来管理 Cookie。要获得 CookieInfo 对象,请在响应消息中调用 SetCookieField 对象的 convert 方法。

与浏览器不同,MATLAB® 并没有提供自动 Cookie 存储。您必须亲自保存 Cookie,然后根据需要将它们发送回服务器。

类属性

Sealed
true

有关类属性的信息,请参阅类属性

创建对象

描述

obj = matlab.net.http.CookieInfo(Name,Value) 创建一个 CookieInfo 对象并由一个或多个名称-值对组参数指定其他属性。Name 是属性名称,Value 是对应的值。您可采用任意顺序指定多个名称-值对组参数,例如 Name1,Value1,...,NameN,ValueN。未指定的属性设置为默认值。

可以使用此构造函数进行测试。

属性

全部展开

Cookie,指定为 matlab.net.http.Cookie 对象。在请求消息的 CookieField 属性中插入 Cookie。

属性:

GetAccess
public
SetAccess
public

Cookie 到期时间,指定为 datetime 对象。如果标头字段中存在 Expires 特性,则会设置 Expires 属性。如果 Expires 特性无法解析,则 Expires 为 NaT。

属性:

GetAccess
public
SetAccess
public

数据类型: datetime

Cookie 持续时间,指定为整数或 NaN。如果标头字段中存在 Max-Age 特性,则会设置 MaxAge 属性。如果 Max-Age 特性无法解析,则 MaxAge 为 NaN。

属性:

GetAccess
public
SetAccess
public

Cookie 域,指定为字符串。如果 Set-Cookie 字段未指定 Domain 特性,则会将 Domain 属性设置为请求消息的 URI.Host 属性,并将 HostOnly 设置为 trueDomain 任何情况下都不会以句点开头,如 Internet Engineering Task Force (IETF®) 网站上的 RFC 6265 - HTTP State Management Mechanism, Section 5.2.3 中所述。

属性:

GetAccess
public
SetAccess
public

数据类型: string

Set-Cookie 字段中的 Path 特性,指定为字符串。Path 属性是 Set-Cookie 字段中的 Path 特性的值。如果该字段中不包含 Path 特性,将会根据请求消息的 URI.Path 属性,将 Path 属性设置为 default-path。有关 default-path 的说明,请参阅 RFC 6265 HTTP State Management Mechanism, Section 5.1.4。Paths and Path-Match。Path 始终以斜杠 (/) 字符开头。

属性:

GetAccess
public
SetAccess
public

数据类型: string

Secure 特性状态,其中 Secure 属性指定为 truefalseSecure 属性指示 Set-Cookie 字段中包含 Secure 特性。

属性:

GetAccess
public
SetAccess
public

数据类型: logical

HttpOnly 特性状态,其中 HttpOnly 属性指定为 truefalseHttpOnly 属性指示 Set-Cookie 字段中包含 HttpOnly 特性。

属性:

GetAccess
public
SetAccess
public

数据类型: logical

extension-av 特性的值,指定为字符串。整个特性是一个字符串,即使其语法采用 name=value 形式也不例外。

属性:

GetAccess
public
SetAccess
public

数据类型: string

Domain 特性状态,其中 HostOnly 属性指定为 truefalse。如果 Set-Cookie 字段中包含 Domain 特性,则 HostOnly 为 true。

属性:

GetAccess
public
SetAccess
public

数据类型: logical

Cookie 过期时间,指定为 datetime 对象。

  • 如果 Set-Cookie 字段中包含 ExpiresMax-Age 特性,则将 ExpirationTime 设置为该特性。

  • 如果两个特性都没有出现,则将 ExpirationTime 设置为 datetime('Inf'),并在当前会话结束之前保留 Cookie。

属性:

GetAccess
public
SetAccess
public

数据类型: datetime

创建 Cookie 的时间,指定为 datetime 对象。SetCookieField.convert 方法将 CreationTime 设置为当前时间。

如果有新的 CookieInfo 对象与现有对象匹配,则用新对象替换旧对象。但是,CreationTime 属性不会改变。此行为在 RFC 6265 HTTP State Management Mechanism 的 Section 5.3 Storage Model 的 step 11.3 中指定。当 Cookie.NameCookieInfo.DomainCookieInfo.Path(如果指定)属性相等时,则 CookieInfo 对象完全匹配。

属性:

GetAccess
public
SetAccess
public

数据类型: datetime

方法

全部展开

版本历史记录

在 R2016b 中推出