Core Data & SwiftUI

Module 10 Notes de cours · Persistance des données avec Core Data

01 Introduction

Dans presque toutes les applications iOS, on a besoin de sauvegarder des données pour qu'elles survivent à la fermeture de l'app. Par exemple : une liste de tâches, un carnet de contacts, un historique d'achats.

Une première approche consiste à utiliser directement SQLite, la base de données embarquée sur iOS. Ça fonctionne, mais ça oblige à écrire du SQL un langage qui n'est pas orienté objet et qui ajoute de la complexité.

Core Data est un framework d'Apple qui sert d'intermédiaire entre votre code Swift et la base de données. Il vous permet de travailler avec vos données comme des objets Swift normaux sans écrire une seule ligne de SQL.

02 La Stack Core Data

Core Data n'est pas un composant unique c'est un ensemble de couches qui travaillent ensemble. On appelle cet ensemble la Core Data Stack. Votre code n'interagit qu'avec la couche du haut ; les couches inférieures fonctionnent de façon transparente.

03 Cycle de vie des données

Comprendre le cycle de vie des données est essentiel pour ne pas se perdre. Voici les quatre étapes que suit chaque donnée :

04 Modèle d'entités (.xcdatamodeld)

Le fichier .xcdatamodeld est l'éditeur visuel où vous définissez la structure de vos données. Xcode le génère automatiquement si vous cochez l'option Core Data à la création du projet, mais on peut aussi le créer manuellement (ce qu'on fait dans le laboratoire).

Définir une entité

Une entité dans Core Data est l'équivalent d'une classe en Swift ou d'une table dans une base de données. Xcode génère automatiquement la classe Swift correspondante.

1. Ouvrez le fichier .xcdatamodeld
2. Cliquez sur Add Entity en bas du panneau
3. Double-cliquez sur le nom pour le changer (ex. : Product)
4. Ajoutez des attributs en cliquant sur + dans la section Attributes
5. Choisissez le type de chaque attribut dans le menu déroulant

Types d'attributs disponibles

Relations entre entités

Les relations permettent de lier deux entités entre elles, comme des clés étrangères en SQL. Il existe trois types de relations :

05 Utilisation en Swift

Voici les trois éléments Swift que vous utiliserez le plus souvent avec Core Data.

1 Initialiser la Stack : PersistenceController

On crée une structure PersistenceController (généralement dans un fichier Persistence.swift) qui initialise le NSPersistentContainer et expose le viewContext au reste de l'application.

import CoreData

struct PersistenceController {

    // Singleton : une seule instance dans toute l'app
    static let shared = PersistenceController()

    let container: NSPersistentContainer

    init() {
        // Nom du fichier .xcdatamodeld (sans l'extension)
        container = NSPersistentContainer(name: "Products")

        container.loadPersistentStores { _, error in
            if let error { fatalError("Erreur : \(error)") }
        }

        // Synchronise le contexte si des données changent en arrière-plan
        container.viewContext.automaticallyMergesChangesFromParent = true
    }
}

// Dans l'App : on injecte le viewContext dans l'environnement SwiftUI
// → Toutes les vues peuvent y accéder via @Environment(\.managedObjectContext)

2 Lire des données : @FetchRequest

@FetchRequest est un property wrapper SwiftUI qui lit automatiquement les données depuis Core Data et met à jour la vue dès qu'un changement est détecté. Pas besoin de recharger manuellement.

// Récupère tous les produits, sans tri
@FetchRequest(sortDescriptors: [])
private var products: FetchedResults<Product>

// Récupère tous les produits, triés alphabétiquement par nom
//  SortDescriptor(\.name) est vérifié à la compilation (plus sûr que "name" en String)
@FetchRequest(sortDescriptors: [SortDescriptor(\.name)])
private var products: FetchedResults<Product>

// Récupère les produits par quantité, ordre décroissant
@FetchRequest(sortDescriptors: [SortDescriptor(\.quantity, order: .reverse)])
private var products: FetchedResults<Product>

3 Filtrer les données : NSPredicate

Un NSPredicate définit des critères de filtrage l'équivalent de la clause WHERE en SQL. On peut l'utiliser avec @FetchRequest ou dans une requête ponctuelle.

// Égalité exacte produits dont le nom est exactement "Pomme"
NSPredicate(format: "name == %@", "Pomme")

// Contient (insensible à la casse et aux accents grâce à [cd])
NSPredicate(format: "name CONTAINS[cd] %@", searchText)

// Commence par
NSPredicate(format: "name BEGINSWITH[cd] %@", "A")

// Comparaison numérique quantité supérieure à 10
NSPredicate(format: "quantity > %d", 10)

// Combinaison de critères avec AND / OR
NSPredicate(format: "name CONTAINS[cd] %@ AND quantity > %d", searchText, 5)

@Environment(\.managedObjectContext) private var viewContext
@State private var results: [Product] = []

// Exécutée une seule fois à l'apparition de la vue
.task {
    let request: NSFetchRequest<Product> = Product.fetchRequest()
    request.predicate = NSPredicate(
        format: "name CONTAINS[cd] %@", searchText
    )
    request.sortDescriptors = [NSSortDescriptor(key: "name", ascending: true)]
    results = (try? viewContext.fetch(request)) ?? []
}