Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы CoreData ссылка класса NSMigrationManager

Опции
Развертывание Target:

На этой странице
Язык:

NSMigrationManager

Экземпляры NSMigrationManager выполните миграцию данных от одного персистентного хранилища до другого использования данного отображения модели.

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


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


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


Swift

import CoreData

Objective C

@import CoreData;

Доступность


Доступный в OS X v10.5 и позже.
  • Перемещает хранилища в данном источнике URL к хранилищу в данном целевом URL, выполняя все отображения, указанные в данном отображении модели.

    Объявление

    Swift

    func migrateStoreFromURL(_ sourceURL: NSURL, type sStoreType: String, options sOptions: [NSObject : AnyObject]?, withMappingModel mappings: NSMappingModel?, toDestinationURL dURL: NSURL, destinationType dStoreType: String, destinationOptions dOptions: [NSObject : AnyObject]?, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)migrateStoreFromURL:(NSURL *)sourceURL type:(NSString *)sStoreType options:(NSDictionary *)sOptions withMappingModel:(NSMappingModel *)mappings toDestinationURL:(NSURL *)dURL destinationType:(NSString *)dStoreType destinationOptions:(NSDictionary *)dOptions error:(NSError **)error

    Параметры

    sourceURL

    Расположение существующего персистентного хранилища. Хранилище должно существовать в этом URL.

    sStoreType

    Тип хранилища в sourceURL (см. NSPersistentStoreCoordinator для возможных значений).

    sOptions

    Словарь опций для источника (см. NSPersistentStoreCoordinator для возможных значений).

    mappings

    Отображающаяся модель для использования для осуществления миграции.

    dURL

    Расположение целевого хранилища.

    dStoreType

    Тип хранилища в dURL (см. NSPersistentStoreCoordinator для возможных значений).

    dOptions

    Словарь опций для места назначения (см. NSPersistentStoreCoordinator для возможных значений).

    error

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

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

    YEStrue если миграция продолжается без ошибок во время проверок совместимости или миграции, иначе NOfalse.

    Обсуждение

    Этот метод выполняет совместимость, проверяет исходные и целевые модели и отображающуюся модель.

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

    Если хранилище не существует в целевом URL (dURL), каждый создается; иначе, миграция добавляет к существующему хранилищу.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Сбрасывает таблицы ассоциации для миграции.

    Объявление

    Swift

    func reset()

    Objective C

    - (void)reset

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

    Этот метод не сбрасывает источник или целевые контексты.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Отменяет миграцию с данной ошибкой.

    Объявление

    Swift

    func cancelMigrationWithError(_ error: NSError)

    Objective C

    - (void)cancelMigrationWithError:(NSError *)error

    Параметры

    error

    Ошибочный объект, описывающий причину, почему отменяется миграция.

    Обсуждение

    Можно вызвать этот метод отовсюду в процессе миграции для прерывания миграции. Вызов этого метода причины migrateStoreFromURL:type:options:withMappingModel:toDestinationURL:destinationType:destinationOptions:error: прерывать миграцию и возврат error— необходимо обеспечить надлежащую ошибку указать причину отмены.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Число между 0 и 1 это указывает пропорцию полноты миграции. (только для чтения)

    Объявление

    Swift

    var migrationProgress: Float { get }

    Objective C

    @property(readonly) float migrationProgress

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

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

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Объект, отображающий в настоящее время быть обработанным. (только для чтения)

    Объявление

    Swift

    var currentEntityMapping: NSEntityMapping { get }

    Objective C

    @property(readonly, strong) NSEntityMapping *currentEntityMapping

    Обсуждение

    Каждый объект обрабатывается в общей сложности три раза — создание экземпляра, создание отношения и проверка.

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

    Можно наблюдать это значение с помощью наблюдения значения ключа.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Связывает приведенный исходный пример с массивом целевых экземпляров для данного отображения свойства.

    Объявление

    Swift

    func associateSourceInstance(_ sourceInstance: NSManagedObject, withDestinationInstance destinationInstance: NSManagedObject, forEntityMapping entityMapping: NSEntityMapping)

    Objective C

    - (void)associateSourceInstance:(NSManagedObject *)sourceInstance withDestinationInstance:(NSManagedObject *)destinationInstance forEntityMapping:(NSEntityMapping *)entityMapping

    Параметры

    sourceInstance

    Исходный управляемый объект.

    destinationInstance

    Место назначения управляет объектом для sourceInstance.

    entityMapping

    Объект, отображающийся для использования для партнера sourceInstance с объектом в destinationInstances.

    Обсуждение

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

    Этот метод вызывают в реализации по умолчанию NSEntityMigrationPolicy createDestinationInstancesForSourceInstance:entityMapping:manager:error: метод.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Возвращает экземпляры управляемого объекта, создаваемые в целевом хранилище для именованной сущности, отображающейся для данного массива исходных экземпляров.

    Объявление

    Swift

    func destinationInstancesForEntityMappingNamed(_ mappingName: String, sourceInstances sourceInstances: [AnyObject]?) -> [AnyObject]

    Objective C

    - (NSArray *)destinationInstancesForEntityMappingNamed:(NSString *)mappingName sourceInstances:(NSArray *)sourceInstances

    Параметры

    mappingName

    Имя объекта, отображающегося в использовании.

    sourceInstances

    Массив управляемых объектов в исходном хранилище.

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

    Называют массив, содержащий экземпляры управляемого объекта, создаваемые в целевом хранилище для отображения объекта mappingName для sourceInstances. Если sourceInstances nil, возвращаются все целевые экземпляры, создаваемые указанным отображением свойства.

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

    Этот метод бросает NSInvalidArgumentException исключение, если mappingName не допустимое имя отображения.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Возвращается экземпляры управляемого объекта в исходном хранилище раньше создавали приведенный целевой пример для данного отображения свойства.

    Объявление

    Swift

    func sourceInstancesForEntityMappingNamed(_ mappingName: String, destinationInstances destinationInstances: [AnyObject]?) -> [AnyObject]

    Objective C

    - (NSArray *)sourceInstancesForEntityMappingNamed:(NSString *)mappingName destinationInstances:(NSArray *)destinationInstances

    Параметры

    mappingName

    Имя объекта, отображающегося в использовании.

    destinationInstances

    Массив управляемых объектов в целевом хранилище.

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

    Массив, содержащий экземпляры управляемого объекта в исходном хранилище раньше, создавал destinationInstances использование отображения объекта называют mappingName. Если destinationInstances nil, все исходные экземпляры, используемые для создания целевого экземпляра для этого отображения свойства, возвращаются.

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

    Этот метод бросает NSInvalidArgumentException исключение, если mappingName не допустимое имя отображения.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • mappingModel mappingModel Свойство

    Отображающаяся модель для получателя. (только для чтения)

    Объявление

    Swift

    var mappingModel: NSMappingModel { get }

    Objective C

    @property(readonly, strong) NSMappingModel *mappingModel

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • sourceModel sourceModel Свойство

    Исходная модель для получателя. (только для чтения)

    Объявление

    Swift

    var sourceModel: NSManagedObjectModel { get }

    Objective C

    @property(readonly, strong) NSManagedObjectModel *sourceModel

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Целевая модель для получателя. (только для чтения)

    Объявление

    Swift

    var destinationModel: NSManagedObjectModel { get }

    Objective C

    @property(readonly, strong) NSManagedObjectModel *destinationModel

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Возвращает описание объекта для исходного объекта данного отображения объекта.

    Объявление

    Swift

    func sourceEntityForEntityMapping(_ mEntity: NSEntityMapping) -> NSEntityDescription?

    Objective C

    - (NSEntityDescription *)sourceEntityForEntityMapping:(NSEntityMapping *)mEntity

    Параметры

    mEntity

    Отображение объекта.

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

    Описание объекта для исходного объекта mEntity.

    Обсуждение

    Отображения объекта не хранят фактические объекты описания, а скорее имя и информацию о версии объекта.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • Возвращает описание объекта для целевого объекта данного отображения объекта.

    Объявление

    Swift

    func destinationEntityForEntityMapping(_ mEntity: NSEntityMapping) -> NSEntityDescription?

    Objective C

    - (NSEntityDescription *)destinationEntityForEntityMapping:(NSEntityMapping *)mEntity

    Параметры

    mEntity

    Отображение объекта.

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

    Описание объекта для целевого объекта mEntity.

    Обсуждение

    Отображения объекта не хранят фактические объекты описания, а скорее имя и информацию о версии объекта.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • sourceContext sourceContext Свойство

    Контекст управляемого объекта получатель использует для чтения источника персистентное хранилище. (только для чтения)

    Объявление

    Swift

    var sourceContext: NSManagedObjectContext { get }

    Objective C

    @property(readonly, strong) NSManagedObjectContext *sourceContext

    Обсуждение

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

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

    См. также

    – destinationContext

  • Контекст управляемого объекта получатель использует для записи целевого персистентного хранилища. (только для чтения)

    Объявление

    Swift

    var destinationContext: NSManagedObjectContext { get }

    Objective C

    @property(readonly, strong) NSManagedObjectContext *destinationContext

    Обсуждение

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

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

    См. также

    – sourceContext

  • userInfo userInfo Свойство

    Пользовательская информация для получателя.

    Объявление

    Swift

    var userInfo: [NSObject : AnyObject]?

    Objective C

    @property(nonatomic, strong) NSDictionary *userInfo

    Обсуждение

    Можно использовать пользовательский информационный словарь для помощи настройке процесса миграции.

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

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

    Объявление

    Swift

    var usesStoreSpecificMigrationManager: Bool

    Objective C

    @property BOOL usesStoreSpecificMigrationManager

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

    YEStrue если получатель использует специфичного для хранилища менеджера по миграции, иначе NOfalse.

    Обсуждение

    YEStrue если получатель использует специфичного для хранилища менеджера по миграции, иначе NOfalse. Значение по умолчанию YEStrue.

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

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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