Навык

Core Data Model Expert агент

Предоставляет экспертные рекомендации по проектированию, реализации и оптимизации моделей Core Data для iOS приложений с учетом лучших практик и соображений производительности.

iOS Core Data Swift Data Modeling Mobile Development Xcode

автор: VibeBaza

Установка
Копируй и вставляй в терминал 
curl -fsSL https://vibebaza.com/i/core-data-model | bash

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

Основные принципы

Основы проектирования сущностей

  • Моделируйте сущности на основе требований к данным вашего приложения, а не структуры UI
  • Используйте подходящие типы данных для атрибутов (Integer 16/32/64, Float/Double, String, Boolean, Date, Binary Data)
  • Устанавливайте значения по умолчанию для атрибутов, когда это уместно, чтобы избежать проблем с обработкой null
  • Используйте опциональные атрибуты экономно - предпочитайте значения по умолчанию или обязательные атрибуты
  • Называйте сущности и атрибуты четко, используя последовательные соглашения об именовании

Лучшие практики для связей

  • Всегда определяйте обратные связи для поддержания ссылочной целостности
  • Выбирайте подходящие правила удаления: Nullify (по умолчанию), Cascade, Deny, No Action
  • Используйте связи "один-ко-многим" с упорядоченными множествами только когда порядок имеет значение
  • Рассмотрите использование fetched properties для сложных запросов, которые не подходят для стандартных связей

Конфигурация модели данных

Конфигурация атрибутов

// В вашем .xcdatamodeld файле правильно настройте атрибуты:
// Для String атрибутов:
// - Установите "Optional" соответственно
// - Рассмотрите "Default Value" для неопциональных строк
// - Используйте "Reg Ex" для валидации при необходимости

// Для числовых атрибутов:
// - Выберите наименьший подходящий размер integer (Int16, Int32, Int64)
// - Установите разумные значения по умолчанию
// - Используйте "Min Value" и "Max Value" для валидации

// Пример конфигурации сущности:
@objc(User)
public class User: NSManagedObject {
    // Используйте @NSManaged для свойств Core Data
    @NSManaged public var userID: Int64
    @NSManaged public var username: String
    @NSManaged public var email: String
    @NSManaged public var createdDate: Date
    @NSManaged public var isActive: Bool

    // Связи
    @NSManaged public var posts: NSSet?
    @NSManaged public var profile: UserProfile?
}

Конфигурация индексов

// Добавляйте индексы для часто запрашиваемых атрибутов
// В Data Model Inspector:
// 1. Выберите вашу сущность
// 2. Добавьте индексы для:
//    - Первичных ключей или уникальных идентификаторов
//    - Атрибутов внешних ключей
//    - Атрибутов, используемых в WHERE клаузулах
//    - Атрибутов, используемых для сортировки

// Пример: Добавьте составной индекс для эффективных запросов
// Создайте индексы на: ["userID"], ["email"], ["createdDate", "isActive"]

Паттерны связей

Связи "один-ко-многим"

// User -> Posts (Один-ко-многим)
// Сущность User:
@NSManaged public var posts: NSSet?

// Сущность Post:
@NSManaged public var author: User?

// Удобные акцессоры
extension User {
    @objc(addPostsObject:)
    @NSManaged public func addToPosts(_ value: Post)

    @objc(removePostsObject:)
    @NSManaged public func removeFromPosts(_ value: Post)

    @objc(addPosts:)
    @NSManaged public func addToPosts(_ values: NSSet)

    @objc(removePosts:)
    @NSManaged public func removeFromPosts(_ values: NSSet)
}

Связи "многие-ко-многим"

// Tag <-> Post (Многие-ко-многим)
// Сущность Post:
@NSManaged public var tags: NSSet?

// Сущность Tag:
@NSManaged public var posts: NSSet?

// Вспомогательные методы для многие-ко-многим
extension Post {
    var tagsArray: [Tag] {
        return tags?.allObjects as? [Tag] ?? []
    }

    func addTag(_ tag: Tag) {
        let mutableTags = mutableSetValue(forKey: "tags")
        mutableTags.add(tag)
    }
}

Продвинутые техники моделирования

Абстрактные сущности и наследование

// Создайте абстрактную базовую сущность для общих свойств
// BaseEntity (Abstract: YES)
@objc(BaseEntity)
public class BaseEntity: NSManagedObject {
    @NSManaged public var createdDate: Date
    @NSManaged public var updatedDate: Date
    @NSManaged public var uuid: String
}

// Конкретные сущности наследуются от BaseEntity
@objc(User)
public class User: BaseEntity {
    @NSManaged public var username: String
    @NSManaged public var email: String
}

@objc(Post)
public class Post: BaseEntity {
    @NSManaged public var title: String
    @NSManaged public var content: String
}

Transformable атрибуты

// Для сложных типов данных используйте Transformable атрибуты
@objc(CustomData)
public class CustomData: NSObject, NSSecureCoding {
    public static var supportsSecureCoding: Bool = true

    public let items: [String]
    public let metadata: [String: String]

    // Реализация NSSecureCoding...
}

// В вашей сущности:
@NSManaged public var customData: CustomData?

// Установите имя трансформера в Data Model Inspector:
// "NSSecureUnarchiveFromDataTransformer"

Оптимизация производительности

Оптимизация запросов

// Используйте размеры батчей для больших наборов данных
let fetchRequest: NSFetchRequest<User> = User.fetchRequest()
fetchRequest.fetchBatchSize = 20
fetchRequest.includesSubentities = false

// Используйте предикаты эффективно
fetchRequest.predicate = NSPredicate(format: "isActive == YES AND createdDate > %@", cutoffDate)

// Включайте только необходимые свойства
fetchRequest.propertiesToFetch = ["username", "email"]
fetchRequest.resultType = .dictionaryResultType

// Предзагружайте связи, чтобы избежать faulting
fetchRequest.relationshipKeyPathsForPrefetching = ["profile", "posts"]

Faulting и управление памятью

// Эффективная обработка батчей
func processBatchOfUsers() {
    let context = persistentContainer.viewContext
    let fetchRequest: NSFetchRequest<User> = User.fetchRequest()
    fetchRequest.fetchBatchSize = 100

    do {
        let users = try context.fetch(fetchRequest)

        for (index, user) in users.enumerated() {
            // Обрабатываем пользователя
            processUser(user)

            // Периодически обновляем для очистки faults
            if index % 50 == 0 {
                context.refreshAllObjects()
            }
        }
    } catch {
        print("Ошибка запроса: \(error)")
    }
}

Стратегии миграции

Настройка легковесной миграции

// Настройте persistent store для автоматических миграций
let storeDescription = NSPersistentStoreDescription(url: storeURL)
storeDescription.shouldMigrateStoreAutomatically = true
storeDescription.shouldInferMappingModelAutomatically = true
storeDescription.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)

Лучшие практики версионирования

  • Всегда создавайте новую версию модели перед внесением изменений в схему
  • Используйте "Add Model Version" в Xcode, не изменяйте существующие версии
  • Явно установите текущую версию в Data Model Inspector
  • Тщательно тестируйте миграции с реалистичными наборами данных
  • Рассмотрите тяжеловесные миграции для сложных изменений схемы
  • Документируйте все изменения схемы и требования к миграции

Валидация и целостность данных

// Кастомная валидация в подклассе NSManagedObject
override public func validateValue(_ value: AutoreleasingUnsafeMutablePointer<AnyObject?>, forKey key: String) throws {
    if key == "email" {
        guard let emailString = value.pointee as? String,
              emailString.contains("@") else {
            throw NSError(domain: "ValidationError", code: 1001, userInfo: [
                NSLocalizedDescriptionKey: "Неверный формат email"
            ])
        }
    }

    try super.validateValue(value, forKey: key)
}

// Валидация перед сохранением
override public func validateForInsert() throws {
    try super.validateForInsert()

    if username.isEmpty {
        throw NSError(domain: "ValidationError", code: 1002, userInfo: [
            NSLocalizedDescriptionKey: "Имя пользователя не может быть пустым"
        ])
    }
}

Советы и рекомендации

  • Используйте Core Data только когда вам нужны его продвинутые возможности (связи, запросы, миграции)
  • Проектируйте вашу модель заранее, но ожидайте ее доработки по мере развития приложения
  • Используйте понятные имена ограничений и правила валидации в визуальном редакторе
  • Всегда тестируйте с реалистичными объемами данных, а не только с тестовыми данными
  • Мониторьте производительность Core Data с помощью Instruments
  • Рассмотрите использование NSPersistentCloudKitContainer для синхронизации с CloudKit когда это уместно
  • Используйте фоновые контексты для массовых операций, чтобы не блокировать UI
  • Реализуйте правильную обработку ошибок для всех операций Core Data
  • Регулярные обзоры схемы помогают выявить возможности для оптимизации
Zambulay Спонсор

Карта для оплаты Claude, ChatGPT и других AI