matlab.net.http.CookieInfo 类
命名空间: matlab.net.http
HTTP Cookie 信息
描述
CookieInfo
类中包含 Cookie
对象以及有关 Cookie 的信息,您可以利用这些信息来管理 Cookie。要获得 CookieInfo
对象,请在响应消息中调用 SetCookieField
对象的 convert
方法。
与浏览器不同,MATLAB® 并没有提供自动 Cookie 存储。您必须亲自保存 Cookie,然后根据需要将它们发送回服务器。
创建对象
描述
obj = matlab.net.http.CookieInfo(Name,Value)
创建一个 CookieInfo
对象并由一个或多个名称-值对组参数指定其他属性。Name
是属性名称,Value
是对应的值。您可采用任意顺序指定多个名称-值对组参数,例如 Name1,Value1,...,NameN,ValueN
。未指定的属性设置为默认值。
可以使用此构造函数进行测试。
属性
Cookie
— Cookie
matlab.net.http.Cookie
对象
Cookie,指定为 matlab.net.http.Cookie
对象。在请求消息的 CookieField
属性中插入 Cookie。
属性:
GetAccess | public |
SetAccess | public |
Expires
— Cookie 到期时间
datetime
| NaT
Cookie 到期时间,指定为 datetime
对象。如果标头字段中存在 Expires
特性,则会设置 Expires
属性。如果 Expires
特性无法解析,则 Expires
为 NaT。
属性:
GetAccess | public |
SetAccess | public |
数据类型: datetime
MaxAge
— Cookie 持续时间
整数 | NaN
Cookie 持续时间,指定为整数或 NaN。如果标头字段中存在 Max-Age
特性,则会设置 MaxAge
属性。如果 Max-Age
特性无法解析,则 MaxAge
为 NaN。
属性:
GetAccess | public |
SetAccess | public |
Domain
— Cookie 域
字符串
Cookie 域,指定为字符串。如果 Set-Cookie 字段未指定 Domain
特性,则会将 Domain
属性设置为请求消息的 URI.Host
属性,并将 HostOnly
设置为 true
。Domain
任何情况下都不会以句点开头,如 Internet Engineering Task Force (IETF®) 网站上的 RFC 6265 - HTTP State Management Mechanism, Section 5.2.3 中所述。
属性:
GetAccess | public |
SetAccess | public |
数据类型: string
Path
— Set-Cookie 字段中的 Path 特性
字符串
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
特性状态
false
(默认) | true
Secure
特性状态,其中 Secure
属性指定为 true
或 false
。Secure
属性指示 Set-Cookie 字段中包含 Secure
特性。
属性:
GetAccess | public |
SetAccess | public |
数据类型: logical
HttpOnly
— HttpOnly
特性状态
false
(默认) | true
HttpOnly
特性状态,其中 HttpOnly
属性指定为 true
或 false
。HttpOnly
属性指示 Set-Cookie 字段中包含 HttpOnly
特性。
属性:
GetAccess | public |
SetAccess | public |
数据类型: logical
Extensions
— extension-av
特性的值
字符串
extension-av
特性的值,指定为字符串。整个特性是一个字符串,即使其语法采用 name=value
形式也不例外。
属性:
GetAccess | public |
SetAccess | public |
数据类型: string
HostOnly
— Domain
特性状态
true
(默认) | false
Domain
特性状态,其中 HostOnly
属性指定为 true
或 false
。如果 Set-Cookie 字段中包含 Domain
特性,则 HostOnly
为 true。
属性:
GetAccess | public |
SetAccess | public |
数据类型: logical
ExpirationTime
— Cookie 过期时间
datetime
Cookie 过期时间,指定为 datetime
对象。
如果 Set-Cookie 字段中包含
Expires
或Max-Age
特性,则将ExpirationTime
设置为该特性。如果两个特性都没有出现,则将
ExpirationTime
设置为datetime('Inf')
,并在当前会话结束之前保留 Cookie。
属性:
GetAccess | public |
SetAccess | public |
数据类型: datetime
CreationTime
— 创建 Cookie 的时间
datetime
创建 Cookie 的时间,指定为 datetime
对象。SetCookieField.convert
方法将 CreationTime
设置为当前时间。
如果有新的 CookieInfo
对象与现有对象匹配,则用新对象替换旧对象。但是,CreationTime
属性不会改变。此行为在 RFC 6265 HTTP State Management Mechanism 的 Section 5.3 Storage Model 的 step 11.3 中指定。当 Cookie.Name
、CookieInfo.Domain
和 CookieInfo.Path
(如果指定)属性相等时,则 CookieInfo
对象完全匹配。
属性:
GetAccess | public |
SetAccess | public |
数据类型: datetime
方法
公共方法
matlab.net.http.CookieInfo.collectFromLog | HTTP 响应消息历史记录中的最新 CookieInfo 对象 |
专用运算符和函数
这些方法将标准的 MATLAB 运算符和函数应用于此类中的对象。
string | 以字符串形式返回 Cookie 信息,如其在 |
char | 以字符向量形式返回 Cookie 信息 |
版本历史记录
在 R2016b 中推出
另请参阅
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)