NSHTTPCookieStorage
NSHTTPCookieStorage
реализует одноэлементный объект (совместно использованный экземпляр), который управляет хранением cookie. Каждый cookie представлен экземпляром NSHTTPCookie
класс. Как правило cookie совместно используются среди всех приложений и сохранены в синхронизации через границы процесса. Cookie сеанса (где объект cookie isSessionOnly
возвраты метода YES
true
) локальны для единственного процесса и не совместно используются.
Оператор импорта
Swift
import Foundation
Objective C
@import Foundation;
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
-
initWithStorageLocation: - initWithStorageLocation:
Доступный в OS X v10.6 через OS X v10.6Возвращает инициализированный
NSHTTPCookieStorage
объект с данным местоположением файловой системы, чтобы хранить информацию cookie на диске.Объявление
Objective C
- (id)initWithStorageLocation:(NSURL *)
storageFileURL
Параметры
storageFileURL
A
file://
URL, указывающий файл для использования для хранения cookie.Возвращаемое значение
Инициализированный
NSHTTPCookieStorage
объект, хранящий его информацию cookie вstorageFileURL
.Оператор импорта
Objective C
@import Foundation;
Доступность
Доступный в OS X v10.6 через OS X v10.6.
-
Возвращает совместно используемый экземпляр ресурса хранения cookie.
Объявление
Swift
class func sharedHTTPCookieStorage() -> NSHTTPCookieStorage
Objective C
+ (NSHTTPCookieStorage *)sharedHTTPCookieStorage
Возвращаемое значение
Совместно используемый экземпляр ресурса хранения cookie.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
-
cookieAcceptPolicy cookieAcceptPolicy
СвойствоCookie хранения cookie принимает политику.
Объявление
Swift
var cookieAcceptPolicy: NSHTTPCookieAcceptPolicy
Objective C
@property NSHTTPCookieAcceptPolicy cookieAcceptPolicy
Обсуждение
Cookie по умолчанию признает, что политика
NSHTTPCookieAcceptPolicyAlways
. Изменение политики cookie влияет на все в настоящее время запущенные приложения с помощью хранения cookie.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
-
Удаляет указанный cookie из хранения cookie.
Объявление
Swift
func deleteCookie(_
aCookie
: NSHTTPCookie)Objective C
- (void)deleteCookie:(NSHTTPCookie *)
aCookie
Параметры
aCookie
Cookie для удаления.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
-
Если cookie принимает разрешения на политику, хранит указанный cookie в хранении cookie.
Объявление
Swift
func setCookie(_
aCookie
: NSHTTPCookie)Objective C
- (void)setCookie:(NSHTTPCookie *)
aCookie
Параметры
aCookie
Cookie для хранения.
Обсуждение
Cookie заменяет существующий cookie тем же именем, доменом и путем, если Вы существуете в хранении cookie. Этот метод принимает cookie, только если cookie получателя признает, что политика
NSHTTPCookieAcceptPolicyAlways
илиNSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain
. Cookie проигнорирован, если cookie получателя признает, что политикаNSHTTPCookieAcceptPolicyNever
.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
-
Если политика принятия cookie получателя разрешает, добавляет массив cookie к получателю.
Объявление
Параметры
cookies
Cookie для добавления.
theURL
URL связался с добавленными cookie.
mainDocumentURL
URL основного документа HTML для кадра верхнего уровня, если известный. Может быть
nil
. Этот URL используется, чтобы определить, должен ли cookie быть принят, если cookie признает, что политикаNSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain
.Обсуждение
Cookie заменят существующие cookie тем же именем, доменом и путем, если Вы будете существовать в хранении cookie. Cookie будет проигнорирован, если cookie получателя признает, что политика
NSHTTPCookieAcceptPolicyNever
.Для хранения cookie от ряда заголовков ответа приложение может использовать
cookiesWithResponseHeaderFields:forURL:
передача полевого словаря заголовка и затем использует этот метод для хранения получающихся cookie в соответствии с политикой принятия cookie получателя.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
-
Cookie хранения cookie. (только для чтения)
Объявление
Swift
var cookies: [AnyObject]? { get }
Objective C
@property(readonly, copy) NSArray *cookies
Обсуждение
Если Вы хотите сортировать cookie хранения cookie, необходимо использовать
sortedCookiesUsingDescriptors:
метод вместо того, чтобы сортировать результат этого метода.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
См. также
-
Возвраты все cookie хранения cookie, отправляющиеся в указанный URL.
Объявление
Swift
func cookiesForURL(_
theURL
: NSURL) -> [AnyObject]?Параметры
theURL
URL для фильтрации на.
Возвращаемое значение
Массив cookie, URL которых соответствует предоставленный URL.
Обсуждение
Приложение может использовать
NSHTTPCookie
методrequestHeaderFieldsWithCookies:
превратить этот массив в ряд полей заголовка для добавления кNSMutableURLRequest
объект.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
См. также
-
Возвраты все cookie хранения cookie, сортированные согласно данному набору дескрипторов вида.
Объявление
Swift
func sortedCookiesUsingDescriptors(_
sortOrder
: [AnyObject]) -> [AnyObject]Параметры
sortOrder
Дескрипторы вида для использования для сортировки, как массив
NSSortDescriptor
объекты.Возвращаемое значение
Cookie хранения cookie, сортированные согласно
sortOrder
, как массивNSHTTPCookie
объекты.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.7 и позже.
Типы данных
-
NSHTTPCookieAcceptPolicy
указывает политику принятия cookie, проводившуюNSHTTPCookieStorage
класс.Объявление
Swift
enum NSHTTPCookieAcceptPolicy : UInt { case Always case Never case OnlyFromMainDocumentDomain }
Objective C
typedef enum { NSHTTPCookieAcceptPolicyAlways, NSHTTPCookieAcceptPolicyNever, NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain } NSHTTPCookieAcceptPolicy;
Константы
-
Always
NSHTTPCookieAcceptPolicyAlways
Примите все cookie. Это - cookie по умолчанию, принимают политику.
Доступный в OS X v10.2 и позже.
-
Never
NSHTTPCookieAcceptPolicyNever
Отклоните все cookie.
Доступный в OS X v10.2 и позже.
-
OnlyFromMainDocumentDomain
NSHTTPCookieAcceptPolicyOnlyFromMainDocumentDomain
Примите cookie только от основного домена документа.
Доступный в OS X v10.2 и позже.
Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
-
-
Когда cookie сохранили в, это уведомление отправляется
NSHTTPCookieStorage
экземпляр изменился.В OS X cookie совместно используются среди приложений, означая, что это уведомление может быть отправлено в ответ на действия другого приложения. Cookie не совместно используются среди приложений в iOS.
Объект уведомления
NSHTTPCookieStorage
экземпляр. Это уведомление не содержит auserInfo
словарь.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.
-
NSHTTPCookieManagerAcceptPolicyChangedNotification NSHTTPCookieManagerAcceptPolicyChangedNotification
Это уведомление отправляется когда политика принятия
NSHTTPCookieStorage
экземпляр изменился.В OS X cookie совместно используются среди приложений, означая, что это уведомление может быть отправлено в ответ на действия другого приложения. Cookie не совместно используются среди приложений в iOS.
Объект уведомления
NSHTTPCookieStorage
экземпляр. Это уведомление не содержит auserInfo
словарь.Оператор импорта
Objective C
@import Foundation;
Swift
import Foundation
Доступность
Доступный в OS X v10.2 с установленным Safari 1.0.
Доступный в OS X v10.2.7 и позже.