NSHTTPCookieStorage

从NSObject继承符合NSObject的（NSObject的）框架/系统/资源库/框架/ Foundation.framework可用性，可在Mac OS X V10.2安装使用Safari 1.0。 在Mac OS X v10.2.7和更高的市场。 在NSHTTPCookieStorage.h宣布伴侣指南URL加载系统

概述

NSHTTPCookieStorage实现管理共享的cookie存储一个singleton对象（共享实例）。 这些cookies是所有的应用程序之间的共享和跨进程同步保存。

注：变更的cookie接受的政策会影响使用cookie存储所有当前正在运行的应用程序。

获取共享的cookie存储对象的任务

* + sharedHTTPCookieStorage

获取和设置cookie的接受政策

* - cookieAcceptPolicy * - setCookieAcceptPolicy：

 

添加和删​​除Cookies

   * – cookies 

 * – cookiesForURL: 

 * – deleteCookie: 

 * – setCookie: * 

– setCookies:forURL:mainDocumentURL:

类方法sharedHTTPCookieStorage

返回共享的cookie存储实例。

+（NSHTTPCookieStorage *）sharedHTTPCookieStorage

返回值

共享的cookie存储实例。

 可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

宣布NSHTTPCookieStorage.h实例方法cookieAcceptPolicy

返回接收器的cookie接受的政策。

- （NSHTTPCookieAcceptPolicy）cookieAcceptPolicy

返回值

接收器的cookie接受的政策。 接受默认的cookie政策是NSHTTPCookieAcceptPolicyAlways。 

可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

另请参见

* - setCookieAcceptPolicy：

宣布NSHTTPCookieStorage.h cookies

返回接收器的cookies。

- （NSArray的*）cookie的

返回值

一个数组，包含所有接收器的cookies。 

可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

另请参见

* - cookiesForURL：

宣布NSHTTPCookieStorage.h cookiesForURL：

返回接收的所有的cookie将被发送到一个指定的URL。

- （NSArray的*）cookiesForURL：（NSURL *）theURL

参数

theURL

的URL过滤。

返回值

Cookie的数组，其URL匹配所提供的URL。 讨论

应用程序可以使用NSHTTPCookie的requestHeaderFieldsWithCookies：变成一个头字段设置阵列添加到一个NSMutableURLRequest对象的方法。 

可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

另请参见

* - cookies

宣布NSHTTPCookieStorage.h deleteCookie：

从接收器中删除指定的cookie。

- （无效）deleteCookie：（NSHTTPCookie *）aCookie参数

aCookie

cookie来删除。

可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

宣布NSHTTPCookieStorage.h setCookie：

存储在接收指定的cookie，如果接收器的cookie接受政策允许。

- （void）setCookie：（NSHTTPCookie *）aCookie

参数

aCookie

cookie来存储。

讨论

cookie将取代现有的Cookie具有相同的名称，域和路径，如果在cookie中存储存在。 此方法将接受cookie，如果接收器的cookie接受的政策是NSHTTPCookieAcceptPolicyAlways或NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain。 如果接收器的cookie接受的政策是NSHTTPCookieAcceptPolicyNever cookie将被忽略。 

可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

宣布NSHTTPCookieStorage.h setCookieAcceptPolicy：

设置cookie接受接收的政策

- （void）setCookieAcceptPolicy：（NSHTTPCookieAcceptPolicy）aPolicy

参数

aPolicy

新的cookie接受的政策。

讨论

接受默认的cookie政策是NSHTTPCookieAcceptPolicyAlways。 更改cookie的政策将影响所有当前运行的应用程序使用cookie存储。

 可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

另请参见

* - cookieAcceptPolicy

NSHTTPCookieStorage.h setCookies宣布：forURL：mainDocumentURL：

将Cookie的数组，如果接收器的cookie验收政策允许接收。

- (void)setCookies:(NSArray *)cookies forURL:(NSURL *)theURL mainDocumentURL:(NSURL *)mainDocumentURL Parameters

cookies来添加。

theURL

网址相关联的补充cookie。

mainDocumentURL

主体中的顶级帧的HTML文件的URL，如果知道的话。 可以是nil。 这个URL是用来确定如果cookie应该被接受，如果接受cookie的政策是NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain的。

讨论

cookie将取代现有的Cookie具有相同的名称，域，和路径，如果在cookie中存储存在。 如果接收器的cookie接受的政策是NSHTTPCookieAcceptPolicyNever cookie将被忽略。

为了响应头的cookie存储，应用程序可以使用cookiesWithResponseHeaderFields：forURL：传递一个头域字典，然后使用此方法产生的cookie存储在按照接收器的cookie接受政策。

 可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

宣布NSHTTPCookieAcceptPolicy NSHTTPCookieStorage.h常量

NSHTTPCookieAcceptPolicy指定cookie的验收政策的NSHTTPCookieStorage类实施。

的typedef枚举{

NSHTTPCookieAcceptPolicyAlways， NSHTTPCookieAcceptPolicyNever， NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain

} NSHTTPCookieAcceptPolicy;

常量

NSHTTPCookieAcceptPolicyAlways

接受所有的cookies。 这是默认的cookie接受的政策。

在iPhone OS 2.0及更高版本。

声明中NSHTTPCookieStorage.h。

NSHTTPCookieAcceptPolicyNever

拒绝所有的cookies。

在iPhone OS 2.0及更高版本。

声明中NSHTTPCookieStorage.h。

NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain

只接受从主文档中域的cookie。

在iPhone OS 2.0及更高版本。

声明中NSHTTPCookieStorage.h。

可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

宣布NSHTTPCookieStorage.h通知NSHTTPCookieManagerCookiesChangedNotification

本通知发布时，在NSHTTPCookieStorage实例中存储的cookie已经改变。 由于Cookies是应用程序之间共享，此通知可以被发送到另一个应用程序的行为。

该通知的对象是NSHTTPCookieStorage实例。 此通知不包含一个userinfo的字典。 可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

宣布NSHTTPCookieStorage.h NSHTTPCookieManagerAcceptPolicyChangedNotification

本通知发布时接受的NSHTTPCookieStorage实例政策发生了变化。 由于Cookies是应用程序之间共享，此通知可以被发送到另一个应用程序的行为。

该通知的对象是NSHTTPCookieStorage实例。 此通知不包含一个userinfo的字典。 可用性

*使用Safari 1.0在Mac OS X V10.2安装。 *可在Mac OS X v10.2.7及更高版本。

声明在NSHTTPCookieStorage.h