NSPersistentStore

Этот класс является абстрактным базовым классом для всех Базовых Данных персистентные хранилища.

Базовые Данные обеспечивают четыре типа хранилища — SQLite, Двоичный файл, XML, и В памяти (хранилище XML не доступно на iOS); они описаны в Персистентных Функциях Хранилища. Базовые Данные также обеспечивают подклассы NSPersistentStore то, что можно использовать для определения собственных типов хранилища: NSAtomicStore и NSIncrementalStore. Двоичный файл и хранилища XML являются примерами атомарных хранилищ, наследовавших функциональность от NSAtomicStore.

Разделение на подклассы примечаний

Вы не должны разделять на подклассы NSPersistentStore непосредственно. Базовые Данные только поддерживают разделение на подклассы NSAtomicStore и NSIncrementalStore.

Определяемый инициализатор initWithPersistentStoreCoordinator:configurationName:URL:options:. При реализации инициализатора необходимо гарантировать, чтобы Вы загрузили метаданные во время инициализации и установили его использование metadata.

Необходимо переопределить эти методы:

ввести
метаданные
metadataForPersistentStoreWithURL:error:
setMetadata:forPersistentStoreWithURL:error:

Наследование

NSObject
NSPersistentStore
NSAtomicStore
NSIncrementalStore

NSObject
NSPersistentStore
NSAtomicStore
NSIncrementalStore

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

Оператор импорта

Swift

import CoreData

Objective C

@import CoreData;

Доступность

Доступный в OS X v10.5 и позже.

Инициализация персистентного хранилища


    
    init (persistentStoreCoordinator:configurationName:URL:options:)
    - initWithPersistentStoreCoordinator:configurationName:URL:options:

Определяемый инициализатор

Возвращает хранилище, инициализированное с данными параметрами.

Объявление

Swift

init(persistentStoreCoordinator coordinator: NSPersistentStoreCoordinator, configurationName configurationName: String?, URL url: NSURL, options options: [NSObject : AnyObject]?)

Objective C

- (instancetype)initWithPersistentStoreCoordinator:(NSPersistentStoreCoordinator *)coordinator configurationName:(NSString *)configurationName URL:(NSURL *)url options:(NSDictionary *)options

Параметры

`coordinator`	Персистентный координатор хранилища.
`configurationName`	Имя конфигурации модели управляемого объекта для использования. Передача `nil` если Вы не хотите указывать конфигурацию.
`url`	URL хранилища для загрузки.
`options`	Словарь, содержащий параметры конфигурации. Посмотрите `NSPersistentStoreCoordinator` для списка ключевых имен для опций в этом словаре.

Возвращаемое значение

Новый объект хранилища, связанный с coordinator, это представляет персистентное хранилище в URL с помощью опций в options и — если это не nil— конфигурация модели управляемого объекта configurationName.

Обсуждение

Необходимо гарантировать, чтобы Вы загрузили метаданные во время инициализации и установили его использование metadata.

Специальные замечания

Это - определяемый инициализатор для персистентных хранилищ.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.

См. также

метаданные

Работа с информацией состояния

ввести ввести Свойство

Строка типа получателя. (только для чтения)

Объявление

Swift

var type: String { get }

Objective C

@property(readonly, copy) NSString *type

Обсуждение

Эта строка используется при указании типа хранилища, чтобы добавить к персистентному координатору хранилища.

Специальные замечания

Подклассы должны переопределить этот метод для обеспечения уникального типа.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.
persistentStoreCoordinator persistentStoreCoordinator Свойство

Персистентный координатор хранилища, загрузивший получатель. (только для чтения)

Объявление

Swift

weak var persistentStoreCoordinator: NSPersistentStoreCoordinator? { get }

Objective C

@property(nonatomic, readonly, weak) NSPersistentStoreCoordinator *persistentStoreCoordinator

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.
configurationName configurationName Свойство

Имя конфигурации модели управляемого объекта раньше создавало получатель. (только для чтения)

Объявление

Swift

var configurationName: String { get }

Objective C

@property(readonly, copy) NSString *configurationName

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.
опции опции Свойство

Опции хранилище были инициализированы с. (только для чтения)

Объявление

Swift

var options: [NSObject : AnyObject]? { get }

Objective C

@property(readonly, strong) NSDictionary *options

Обсуждение

Посмотрите NSPersistentStoreCoordinator для списка ключевых имен для опций в этом словаре.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.
URL URL Свойство

URL для получателя.

Объявление

Swift

var URL: NSURL?

Objective C

@property(strong) NSURL *URL

Обсуждение

Для изменения расположения хранилища отправьте персистентного координатора хранилища a setURL:forPersistentStore: сообщение.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.
идентификатор идентификатор Свойство

Уникальный идентификатор для получателя.

Объявление

Swift

var identifier: String!

Objective C

@property(copy) NSString *identifier

Обсуждение

Идентификатор используется в качестве части управляемого объекта IDs для каждого объекта в хранилище.

Специальные замечания

NSPersistentStore обеспечивает реализацию по умолчанию для обеспечения глобально уникального идентификатора для экземпляра хранилища.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.

См. также

метаданные
только для чтения только для чтения Свойство

Булево значение, указывающее, только ли получатель для чтения.

Объявление

Swift

var readOnly: Bool

Objective C

@property(getter=isReadOnly) BOOL readOnly

Обсуждение

YEStrue если получатель только для чтения, иначе NOfalse.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.10 и позже.

Управление метаданными


    
    metadataForPersistentStoreWithURL (_: ошибка:)
    + metadataForPersistentStoreWithURL:error:

Возвращает метаданные из персистентного хранилища в данном URL.

Объявление

Swift

class func metadataForPersistentStoreWithURL(_ url: NSURL, error error: NSErrorPointer) -> [NSObject : AnyObject]?

Objective C

+ (NSDictionary *)metadataForPersistentStoreWithURL:(NSURL *)url error:(NSError **)error

Параметры

`url`	Расположение хранилища.
`error`	Если ошибка происходит, по возврату содержит `NSError` объект, описывающий проблему.

Возвращаемое значение

Метаданные от персистентного хранилища в url. Возвраты nil если существует ошибка.

Специальные замечания

Подклассы должны переопределить этот метод.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.


    
    setMetadata (_: forPersistentStoreWithURL:error:)
    + setMetadata:forPersistentStoreWithURL:error:

Устанавливает метаданные для хранилища в данном URL.

Объявление

Swift

class func setMetadata(_ metadata: [NSObject : AnyObject]?, forPersistentStoreWithURL url: NSURL, error error: NSErrorPointer) -> Bool

Objective C

+ (BOOL)setMetadata:(NSDictionary *)metadata forPersistentStoreWithURL:(NSURL *)url error:(NSError **)error

Параметры

`metadata`	Метаданные для хранилища в `url`.
`url`	Расположение хранилища.
`error`	Если ошибка происходит, по возврату содержит `NSError` объект, описывающий проблему.

Возвращаемое значение

YEStrue если метаданные были записаны правильно, иначе NOfalse.

Специальные замечания

Подклассы должны переопределить этот метод для установки метаданных соответственно.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.

метаданные метаданные Свойство

Метаданные для получателя.

Объявление

Swift

var metadata: [NSObject : AnyObject]!

Objective C

@property(nonatomic, strong) NSDictionary *metadata

Обсуждение

Словарь должен включать тип хранилища (NSStoreTypeKey) и UUID (NSStoreUUIDKey).

Специальные замечания

Подклассы должны переопределить это свойство для обеспечения хранения и персистентности для метаданных хранилища.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.


    
    loadMetadata (_:)
    - loadMetadata:

Дает получателю команду загружать свои метаданные.

Объявление

Swift

func loadMetadata(_ error: NSErrorPointer) -> Bool

Objective C

- (BOOL)loadMetadata:(NSError **)error

Параметры


      error

Если ошибка происходит, по возврату содержит NSError объект, описывающий проблему.

Возвращаемое значение

YEStrue если метаданные были загружены правильно, иначе NOfalse.

Специальные замечания

Если хранилище недопустимо, нет никакого способа возвратить ошибку.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.6 и позже.

Установка и разрушение


    
    didAddToPersistentStoreCoordinator (_:)
    - didAddToPersistentStoreCoordinator:

Вызванный после того, как получатель был добавлен к персистентному координатору хранилища.

Объявление

Swift

func didAddToPersistentStoreCoordinator(_ coordinator: NSPersistentStoreCoordinator)

Objective C

- (void)didAddToPersistentStoreCoordinator:(NSPersistentStoreCoordinator *)coordinator

Параметры


      coordinator

Персистентный координатор хранилища, к которому был добавлен получатель.

Обсуждение

Реализация по умолчанию ничего не делает. Можно переопределить этот метод в подклассе для выполнения любого вида установки, необходимой, прежде чем будет вызван метод загрузки.

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.


    
    willRemoveFromPersistentStoreCoordinator (_:)
    - willRemoveFromPersistentStoreCoordinator:

Вызванный, прежде чем получатель демонтирован от персистентного координатора хранилища.

Объявление

Swift

func willRemoveFromPersistentStoreCoordinator(_ coordinator: NSPersistentStoreCoordinator)

Objective C

- (void)willRemoveFromPersistentStoreCoordinator:(NSPersistentStoreCoordinator *)coordinator

Параметры


      coordinator

Персистентный координатор хранилища, из которого был удален получатель.

Обсуждение

Реализация по умолчанию ничего не делает. Можно переопределить этот метод в подклассе для выполнения любой очистки, прежде чем хранилище будет удалено от координатора (и освобождено).

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.5 и позже.

Поддержка миграции

migrationManagerClass () + migrationManagerClass

Возвраты NSMigrationManager класс для этого класса хранилища.

Объявление

Swift

class func migrationManagerClass() -> AnyClass

Objective C

+ (Class)migrationManagerClass

Возвращаемое значение

NSMigrationManager класс для этого класса хранилища

Обсуждение

В подклассе NSPersistentStore, можно переопределить это, чтобы предоставить пользовательскому менеджеру по миграции подкласс (например, использовать в своих интересах специфичную для хранилища функциональность для улучшения производительности миграции).

Оператор импорта

Objective C

@import CoreData;

Swift

import CoreData

Доступность

Доступный в OS X v10.6 и позже.