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

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

Разработчик

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

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

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

NSMigrationManager

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

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

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

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

Swift

import CoreData

Objective C

@import CoreData;

Доступность

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

Инициализация менеджера

Выполнение операций миграции
  • migrateStoreFromURL (_: type:options:withMappingModel:toDestinationURL:destinationType:destinationOptions:error:) - migrateStoreFromURL:type:options:withMappingModel:toDestinationURL:destinationType:destinationOptions:error:

    Перемещает хранилища в данном источнике 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 и позже.

    См. также

    – cancelMigrationWithError:

  • сброс () - сброс

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

    Объявление

    Swift

    func reset()

    Objective C

    - (void)reset

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

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

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

  • cancelMigrationWithError (_:) - cancelMigrationWithError:

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

    Объявление

    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 и позже.

Контроль динамики миграции
  • migrationProgress migrationProgress Свойство

    Число между 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 и позже.

  • currentEntityMapping currentEntityMapping Свойство

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

    Объявление

    Swift

    var currentEntityMapping: NSEntityMapping { get }

    Objective C

    @property(readonly, strong) NSEntityMapping *currentEntityMapping

    Обсуждение

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

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

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

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

Работа с источником и целевыми экземплярами
  • associateSourceInstance (_: withDestinationInstance:forEntityMapping:) - associateSourceInstance:withDestinationInstance:forEntityMapping:

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

    Объявление

    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 и позже.

    См. также

    – sourceInstancesForEntityMappingNamed:destinationInstances:
    – destinationInstancesForEntityMappingNamed:sourceInstances:

  • destinationInstancesForEntityMappingNamed (_: sourceInstances:) - destinationInstancesForEntityMappingNamed:sourceInstances:

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

    Объявление

    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 и позже.

    См. также

    – sourceInstancesForEntityMappingNamed:destinationInstances:

  • sourceInstancesForEntityMappingNamed (_: destinationInstances:) - sourceInstancesForEntityMappingNamed:destinationInstances:

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

    Объявление

    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 и позже.

    См. также

    – destinationInstancesForEntityMappingNamed:sourceInstances:

Получение информации о менеджере по миграции
  • 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
    – destinationModel
    – migrateStoreFromURL:type:options:withMappingModel:toDestinationURL:destinationType:destinationOptions:error:

  • 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 и позже.

    См. также

    – mappingModel
    – destinationModel
    – initWithSourceModel:destinationModel:

  • destinationModel destinationModel Свойство

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

    Объявление

    Swift

    var destinationModel: NSManagedObjectModel { get }

    Objective C

    @property(readonly, strong) NSManagedObjectModel *destinationModel

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

    Objective C

    @import CoreData;

    Swift

    import CoreData

    Доступность

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

    См. также

    – mappingModel
    – sourceModel
    – initWithSourceModel:destinationModel:

  • sourceEntityForEntityMapping (_:) - sourceEntityForEntityMapping:

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

    Объявление

    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 и позже.

    См. также

    – destinationEntityForEntityMapping:

  • destinationEntityForEntityMapping (_:) - destinationEntityForEntityMapping:

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

    Объявление

    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 и позже.

    См. также

    – sourceEntityForEntityMapping:

  • 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

  • destinationContext 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 и позже.

Используя специфичных для хранилища менеджеров по миграции
  • usesStoreSpecificMigrationManager usesStoreSpecificMigrationManager Свойство

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

    Объявление

    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 и позже.