Object 內置對象

對象HttpCookie

http Cookie 對象,用於添加和處理cookie

繼承關係

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<this>HttpCookie|new HttpCookie()|name;value;domain;path;expires;httpOnly;secure|parse();match()] [object] <:- [HttpCookie] HttpCookie new HttpCookie() name value domain path expires httpOnly secure parse() match() object toString() toJSON()

構造函數

HttpCookie

HttpCookie 構造函數,創建一個新的HttpCookie 對象

1
new HttpCookie(Object opts = {});

調用參數:

  • opts: Object, 指定創建的cookie 的屬性

opts 可以設置的選項如下:

1 2 3 4 5 6 7 8 9
{ "name": "", // 指定创建的 cookie 名称 "value": "", // 指定创建的 cookie 值 "expires": Date, // 指定创建的 cookie 过期时间 "domain": "", // 指定创建的 cookie 的域名范围 "path": "", // 指定创建的 cookie 的路径范围 "secure": false, // 指定创建的 cookie 是否仅通过 https 传递 "httpOnly": false, // 指定创建的 cookie 仅允许 http 请求 }

HttpCookie 構造函數,創建一個新的HttpCookie 對象

1 2 3
new HttpCookie(String name, String value, Object opts = {});

調用參數:

  • name: String, 指定創建的cookie 名稱
  • value: String, 指定創建的cookie 值
  • opts: Object, 指定創建的cookie 的其它屬性

opts 可以設置的選項如下:

1 2 3 4 5 6 7
{ "expires": Date, // 指定创建的 cookie 过期时间 "domain": "", // 指定创建的 cookie 的域名范围 "path": "", // 指定创建的 cookie 的路径范围 "secure": false, // 指定创建的 cookie 是否仅通过 https 传递 "httpOnly": false, // 指定创建的 cookie 仅允许 http 请求 }

成員屬性

name

String, 查詢和設置cookie 名稱

1
String HttpCookie.name;

value

String, 查詢和設置cookie 的值

1
String HttpCookie.value;

domain

String, 查詢和設置cookie 的域名範圍

1
String HttpCookie.domain;

path

String, 查詢和設置cookie 的路徑範圍

1
String HttpCookie.path;

expires

Date, 查詢和設置cookie 的過期時間

1
Date HttpCookie.expires;

httpOnly

Boolean, 查詢和設置cookie 是否僅允許 http 請求,缺省false

1
Boolean HttpCookie.httpOnly;

secure

Boolean, 查詢和設置cookie 是否僅通過https 傳遞,缺省false

1
Boolean HttpCookie.secure;

成員函數

parse

解析給定的字符串,填充cookie 對象

1
HttpCookie.parse(String header);

調用參數:

  • header: String, 指定需要解析的header 字符串

match

檢測給定的 url 是否匹配當前設置

1
Boolean HttpCookie.match(String url);

調用參數:

  • url: String, 指定測試的 url

返回結果:

  • Boolean, 匹配成功返回true

toString

返回對象的字符串表示,一般返回"[Native Object]",對象可以根據自己的特性重新實現

1
String HttpCookie.toString();

返回結果:

  • String, 返回對象的字符串表示

toJSON

返回對象的JSON 格式表示,一般返回對象定義的可讀屬性集合

1
Value HttpCookie.toJSON(String key = "");

調用參數:

  • key: String, 未使用

返回結果:

  • Value, 返回包含可JSON 序列化的值