Analyse des Types de Données avec ParseSwift sur iOS

16min
Analyser les types de données sur Swift
Introduction
Lors de l'enregistrement de données sur une base de données Back4App, chaque entité est stockée sous forme de paires clé-valeur. Le type de données pour le champ valeur va des fondamentaux (tels que String, Int, Double, Float, et Bool) à des structures plus complexes. La principale exigence pour stocker des données sur une base de données Back4App est que l'entité doit se conformer au ParseSwift protocole. À son tour, ce protocole fournit un ensemble de méthodes pour stocker, mettre à jour et supprimer toute instance d'une entité.
Dans ce guide, vous apprendrez comment créer et configurer une entité pour l'enregistrer sur votre base de données Back4App. Dans l'exemple de projet, l'entité que nous stockons contient des informations sur une recette.
Ce tutoriel utilise une application de base créée dans Xcode 12 et iOS 14.
À tout moment, vous pouvez accéder au projet complet via nos dépôts GitHub.
﻿Dépôt d'exemple iOS﻿
Objectif
Pour comprendre comment les objets sont analysés et stockés dans une base de données Back4App.
Prérequis
Pour compléter ce guide rapide, vous avez besoin de :
Xcode.
Une application créée sur Back4App.
Suivez le tutoriel de nouvelle application Parse pour apprendre à créer une application Parse sur Back4App.
Remarque : Suivez le tutoriel d'installation du SDK Parse (Swift) pour créer un projet Xcode connecté à Back4App.
Comprendre notre application de recettes
La fonctionnalité de l'application est basée sur un formulaire où l'on peut entrer des informations sur une recette. En fonction des informations, le type de données peut varier. Dans notre exemple, la recette a les caractéristiques suivantes :
Champ
Type de données
Description
Nom
Chaîne
Nom de la recette
Portions
Int
Nombre de portions
Disponible
Bool
Détermine si la recette est disponible ou non
Catégorie
Catégorie
Une énumération personnalisée qui classe une recette en trois catégories : Petit-déjeuner, Déjeuner et Dîner
Ingrédients
[Ingrédients]
L'ensemble des ingrédients contenus dans une structure customIngredient** **
Options latérales
[Chaîne]
Noms des options supplémentaires avec lesquelles la recette est fournie
Informations nutritionnelles
[Chaîne:Chaîne]
Un dictionnaire contenant des informations sur le contenu nutritionnel de la recette
Date de sortie
Date
Une date indiquant quand la recette était disponible
De plus, il existe d'autres types de données qui sont utilisés pour implémenter des fonctionnalités de base de données comme la relation entre les objets. Ces types de données ne sont pas couverts dans ce tutoriel.
Référence rapide des commandes que nous allons utiliser
Étant donné un objet, disons Recette, si vous souhaitez l'enregistrer dans une base de données Back4App, vous devez d'abord faire en sorte que cet objet soit conforme au protocole ParseSwift (disponible via le SDK ParseSwift).
Swift
 import Foundation
 import ParseSwift
3
 struct Recipe: ParseObject {
     /// Enumeration for the recipe category
     enum Category: Int, CaseIterable, Codable {
         case breakfast = 0, lunch = 1, dinner = 2
      
         var title: String {
            switch self {
            case .breakfast: return "Breakfast"
            case .lunch: return "Lunch"
            case .dinner: return "Dinner"
            }
        }
    }
17
    ...
19
    /// A *String* type property
    var name: String?
  
    /// An *Integer* type property
    var servings: Int?
  
    /// A *Double* (or *Float*) type property
    var price: Double?
  
    /// A *Boolean* type property
    var isAvailable: Bool?
  
    /// An *Enumeration* type property
    var category: Category?
  
    /// An array of *structs*
    var ingredients: [Ingredient]
  
    /// An array of *Strings*
    var sideOptions: [String]
  
    /// A dictionary property
    var nutritionalInfo: [String: String]
  
    /// A *Date* type property
    var releaseDate: Date?
}
 import Foundation
 import ParseSwift
3
 struct Recipe: ParseObject {
     /// Enumeration for the recipe category
     enum Category: Int, CaseIterable, Codable {
         case breakfast = 0, lunch = 1, dinner = 2
      
         var title: String {
            switch self {
            case .breakfast: return "Breakfast"
            case .lunch: return "Lunch"
            case .dinner: return "Dinner"
            }
        }
    }
17
    ...
19
    /// A *String* type property
    var name: String?
  
    /// An *Integer* type property
    var servings: Int?
  
    /// A *Double* (or *Float*) type property
    var price: Double?
  
    /// A *Boolean* type property
    var isAvailable: Bool?
  
    /// An *Enumeration* type property
    var category: Category?
  
    /// An array of *structs*
    var ingredients: [Ingredient]
  
    /// An array of *Strings*
    var sideOptions: [String]
  
    /// A dictionary property
    var nutritionalInfo: [String: String]
  
    /// A *Date* type property
    var releaseDate: Date?
}
﻿
Avant de stocker des instances de cet objet dans une base de données Back4App, toutes ses propriétés doivent être conformes aux protocoles Codable et Hashable.
Nous utilisons les méthodes suivantes pour gérer ces objets sur la base de données Back4App :
Create
Update
Read
Delete
//The procedure for reading and updating a Recipe object is similar since they rely on the save() method. How a Recipe is instantiated determines if we are creating or updating the object on the Back4App Database. When creating a new instance we use
 var newRecipe: Recipe
2
 // Setup newRecipe's properties
 newRecipe.name = "My recipe's name"
 newRecipe.servings = 4
 newRecipe.price = 3.99
 newRecipe.isAvailable = false
 newRecipe.category = .breakfast
 newRecipe.sideOptions = ["Juice"]
newRecipe.releaseDate = Date()
...
12
// Saves newRecipe on your Back4App Database synchronously and returns the new saved Item. It throws and error if something went wrong.
let savedRecipe = try? savedRecipe.save()
15
// Saves savedRecipe on your Back4App Database asynchronously, and passes a Result<ToDoListItem, ParseError> object to the completion block to handle the save proccess.
savedRecipe.save { result in
    // Handle the result to check the save was successfull or not
}
//The procedure for reading and updating a Recipe object is similar since they rely on the save() method. How a Recipe is instantiated determines if we are creating or updating the object on the Back4App Database. When creating a new instance we use
 var newRecipe: Recipe
2
 // Setup newRecipe's properties
 newRecipe.name = "My recipe's name"
 newRecipe.servings = 4
 newRecipe.price = 3.99
 newRecipe.isAvailable = false
 newRecipe.category = .breakfast
 newRecipe.sideOptions = ["Juice"]
newRecipe.releaseDate = Date()
...
12
// Saves newRecipe on your Back4App Database synchronously and returns the new saved Item. It throws and error if something went wrong.
let savedRecipe = try? savedRecipe.save()
15
// Saves savedRecipe on your Back4App Database asynchronously, and passes a Result<ToDoListItem, ParseError> object to the completion block to handle the save proccess.
savedRecipe.save { result in
    // Handle the result to check the save was successfull or not
}
﻿
- Créer le modèle d'application Recipe
Nous commençons par créer un nouveau projet XCode. Dans ce tutoriel, le projet devrait ressembler à ceci
﻿
À tout moment, vous pouvez accéder au projet complet via nos dépôts GitHub.
﻿Dépôt d'exemple iOS﻿
Allez dans Xcode et trouvez le fichier SceneDelegate.swift. Afin d'ajouter une barre de navigation en haut de l'application, nous configurons un UINavigationController comme contrôleur de vue racine de la manière suivante.
Swift
 class SceneDelegate: UIResponder, UIWindowSceneDelegate {
2
     var window: UIWindow?
4
     func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
         guard let scene = (scene as? UIWindowScene) else { return }
      
         window = .init(windowScene: scene)
         window?.rootViewController = UINavigationController(rootViewController: RecipesController())
        window?.makeKeyAndVisible()
11
        // Additional logic
    }
14
    ...
}
 class SceneDelegate: UIResponder, UIWindowSceneDelegate {
2
     var window: UIWindow?
4
     func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
         guard let scene = (scene as? UIWindowScene) else { return }
      
         window = .init(windowScene: scene)
         window?.rootViewController = UINavigationController(rootViewController: RecipesController())
        window?.makeKeyAndVisible()
11
        // Additional logic
    }
14
    ...
}
﻿
La classe du contrôleur de vue racine (RecipesController) pour le contrôleur de navigation est une sous-classe de UIViewController dans laquelle nous allons disposer un formulaire pour créer et mettre à jour des objets Recipe dans la base de données Back4App.
- Configurer l'objet Recipe
Les objets que vous souhaitez enregistrer dans votre base de données Back4App doivent se conformer au protocole ParseObject. Dans notre application Recipes, cet objet est Recipe. Par conséquent, vous devez d'abord créer cet objet. Créez un nouveau fichier Recipe.swift et ajoutez ce qui suit.
Swift
 import Foundation
 import ParseSwift
3
 struct Recipe: ParseObject {
     /// Enumeration for the recipe category
     enum Category: Int, CaseIterable, Codable {
         case breakfast = 0, lunch = 1, dinner = 2
      
         var title: String {
            switch self {
            case .breakfast: return "Breakfast"
            case .lunch: return "Lunch"
            case .dinner: return "Dinner"
            }
        }
    }
  
    // Required properties from ParseObject protocol
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
  
    /// A *String* type property
    var name: String?
  
    /// An *Integer* type property
    var servings: Int?
  
    /// A *Double* (or *Float*) type property
    var price: Double?
  
    /// A *Boolean* type property
    var isAvailable: Bool?
  
    /// An *Enumeration* type property
    var category: Category?
  
    /// An array of *structs*
    var ingredients: [Ingredient]
  
    /// An array of *Strings*
    var sideOptions: [String]
44
    /// A dictionary property
    var nutritionalInfo: [String: String]
      
    /// A *Date* type property
    var releaseDate: Date?
  
    /// Maps the nutritionalInfo property into an array of tuples
    func nutritionalInfoArray() -> [(name: String, value: String)] {
        return nutritionalInfo.map { ($0.key, $0.value) }
    }
}
 import Foundation
 import ParseSwift
3
 struct Recipe: ParseObject {
     /// Enumeration for the recipe category
     enum Category: Int, CaseIterable, Codable {
         case breakfast = 0, lunch = 1, dinner = 2
      
         var title: String {
            switch self {
            case .breakfast: return "Breakfast"
            case .lunch: return "Lunch"
            case .dinner: return "Dinner"
            }
        }
    }
  
    // Required properties from ParseObject protocol
    var objectId: String?
    var createdAt: Date?
    var updatedAt: Date?
    var ACL: ParseACL?
  
    /// A *String* type property
    var name: String?
  
    /// An *Integer* type property
    var servings: Int?
  
    /// A *Double* (or *Float*) type property
    var price: Double?
  
    /// A *Boolean* type property
    var isAvailable: Bool?
  
    /// An *Enumeration* type property
    var category: Category?
  
    /// An array of *structs*
    var ingredients: [Ingredient]
  
    /// An array of *Strings*
    var sideOptions: [String]
44
    /// A dictionary property
    var nutritionalInfo: [String: String]
      
    /// A *Date* type property
    var releaseDate: Date?
  
    /// Maps the nutritionalInfo property into an array of tuples
    func nutritionalInfoArray() -> [(name: String, value: String)] {
        return nutritionalInfo.map { ($0.key, $0.value) }
    }
}
﻿
où nous avons déjà ajouté toutes les propriétés nécessaires à Recipe selon le tableau des caractéristiques des recettes.
Le type de données Ingredient est une structure contenant la quantité et la description de l'ingrédient. Comme mentionné précédemment, ce type de données doit se conformer aux protocoles Codable et Hashable pour faire partie des propriétés de la recette.
Swift
 import Foundation
2
 struct Ingredient: Hashable, Codable {
     var quantity: Float
     var description: String
 }
 import Foundation
2
 struct Ingredient: Hashable, Codable {
     var quantity: Float
     var description: String
 }
﻿
De plus, la propriété category dans Recipe a une énumération (Category) comme type de données qui se conforme également aux protocoles correspondants.
Swift
 struct Recipe: ParseObject {
     /// Enumeration for the recipe category
     enum Category: Int, CaseIterable, Codable {
         case breakfast = 0, lunch = 1, dinner = 2
      
         ...
     }
     ...   
 }
 struct Recipe: ParseObject {
     /// Enumeration for the recipe category
     enum Category: Int, CaseIterable, Codable {
         case breakfast = 0, lunch = 1, dinner = 2
      
         ...
     }
     ...   
 }
﻿
- Configuration de RecipesController
Dans RecipesController, nous devrions mettre en œuvre toute la configuration nécessaire pour la navigationBar et le formulaire utilisé pour capturer toutes les propriétés de la recette. Ce tutoriel ne couvre pas comment mettre en œuvre la mise en page du formulaire. Nous nous concentrons ensuite sur la logique liée à la gestion des types de données en utilisant le SDK ParseSwift. Ci-dessous, nous soulignons les points clés dans RecipesController qui nous permettent de comprendre comment nous mettons en œuvre la connexion entre l'interface utilisateur et les données provenant de votre base de données Back4App.
Swift
 class RecipesController: UIViewController {
     enum PreviousNext: Int { case previous = 0, next = 1 }
  
     ...
  
     var recipes: [Recipe] = [] // 1: An array of recipes fetched from your Back4App Database
  
     // Section header labels
     private let recipeLabel: UILabel = .titleLabel(title: "Recipe overview")
    private let ingredientsLabel: UILabel = .titleLabel(title: "Ingredients")
    private let nutritionalInfoLabel: UILabel = .titleLabel(title: "Nutritional information")
  
    // 2: A custom view containing input fields to enter the recipe's information (except nutritional info. and ingredients)
    let recipeOverviewView: RecipeInfoView
  
    // 3: A  stack view containig the fields to enter the recipe's ingredients
    let ingredientsStackView: UIStackView
   
    // 4: A  stack view containig the fields to enter the nutritional information
    let nutritionalInfoStackView: UIStackView
  
    // 5: Buttons to handle the CRUD logic for the Recipe object currently displayed
    private var saveButton: UIButton = UIButton(title: "Save")
    private var updateButton: UIButton = UIButton(title: "Update")
    private var reloadButton: UIButton = UIButton(title: "Reload")
  
    var currentRecipeIndex: Int? // 6: An integer containing the index of the current recipe presenten from the recipes property
  
    override func viewDidLoad() {
        super.viewDidLoad()
        setupNavigationBar()
        setupViews()
    }
  
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        handleReloadRecipes()
    }
  
    private func setupNavigationBar() {
        navigationController?.navigationBar.barTintColor = .primary
        navigationController?.navigationBar.titleTextAttributes = [.foregroundColor: UIColor.white]
        navigationController?.navigationBar.isTranslucent = false
        navigationController?.navigationBar.barStyle = .black
        navigationItem.title = "Parse data types".uppercased()
    }
  
    private func setupViews() {
        ... // See the project example for more details
50
        saveButton.addTarget(self, action: #selector(handleSaveRecipe), for: .touchUpInside)
        updateButton.addTarget(self, action: #selector(handleUpdateRecipe), for: .touchUpInside)
        reloadButton.addTarget(self, action: #selector(handleReloadRecipes), for: .touchUpInside)
    }
  
    ...
}
 class RecipesController: UIViewController {
     enum PreviousNext: Int { case previous = 0, next = 1 }
  
     ...
  
     var recipes: [Recipe] = [] // 1: An array of recipes fetched from your Back4App Database
  
     // Section header labels
     private let recipeLabel: UILabel = .titleLabel(title: "Recipe overview")
    private let ingredientsLabel: UILabel = .titleLabel(title: "Ingredients")
    private let nutritionalInfoLabel: UILabel = .titleLabel(title: "Nutritional information")
  
    // 2: A custom view containing input fields to enter the recipe's information (except nutritional info. and ingredients)
    let recipeOverviewView: RecipeInfoView
  
    // 3: A  stack view containig the fields to enter the recipe's ingredients
    let ingredientsStackView: UIStackView
   
    // 4: A  stack view containig the fields to enter the nutritional information
    let nutritionalInfoStackView: UIStackView
  
    // 5: Buttons to handle the CRUD logic for the Recipe object currently displayed
    private var saveButton: UIButton = UIButton(title: "Save")
    private var updateButton: UIButton = UIButton(title: "Update")
    private var reloadButton: UIButton = UIButton(title: "Reload")
  
    var currentRecipeIndex: Int? // 6: An integer containing the index of the current recipe presenten from the recipes property
  
    override func viewDidLoad() {
        super.viewDidLoad()
        setupNavigationBar()
        setupViews()
    }
  
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        handleReloadRecipes()
    }
  
    private func setupNavigationBar() {
        navigationController?.navigationBar.barTintColor = .primary
        navigationController?.navigationBar.titleTextAttributes = [.foregroundColor: UIColor.white]
        navigationController?.navigationBar.isTranslucent = false
        navigationController?.navigationBar.barStyle = .black
        navigationItem.title = "Parse data types".uppercased()
    }
  
    private func setupViews() {
        ... // See the project example for more details
50
        saveButton.addTarget(self, action: #selector(handleSaveRecipe), for: .touchUpInside)
        updateButton.addTarget(self, action: #selector(handleUpdateRecipe), for: .touchUpInside)
        reloadButton.addTarget(self, action: #selector(handleReloadRecipes), for: .touchUpInside)
    }
  
    ...
}
﻿
- Gestion de l'entrée utilisateur et analyse d'un objet Recette
Dans un fichier séparé (appelé RecipesController+ParseSwiftLogic.swift), en utilisant une extension, nous implémentons maintenant les méthodes handleSaveRecipe(), handleUpdateRecipe() et handleUpdateRecipe() pour gérer les données d'entrée.
Swift
 import UIKit
 import ParseSwift
3
 extension RecipesController {
     /// Retrieves all the recipes stored on your Back4App Database
     @objc func handleReloadRecipes() {
         view.endEditing(true)
         let query = Recipe.query()
         query.find { [weak self] result in // Retrieves all the recipes stored on your Back4App Database and refreshes the UI acordingly
            guard let self = self else { return }
            switch result {
            case .success(let recipes):
                self.recipes = recipes
                self.currentRecipeIndex = recipes.isEmpty ? nil : 0
                self.setupRecipeNavigation()
              
                DispatchQueue.main.async { self.presentCurrentRecipe() }
            case .failure(let error):
                DispatchQueue.main.async { self.showAlert(title: "Error", message: error.message) }
            }
        }
    }
  
    /// Called when the user wants to update the information of the currently displayed recipe
    @objc func handleUpdateRecipe() {
        view.endEditing(true)
        guard let recipe = prepareRecipeMetadata(), recipe.objectId != nil else { // Prepares the Recipe object for updating
            return showAlert(title: "Error", message: "Recipe not found.")
        }
      
        recipe.save { [weak self] result in
            switch result {
            case .success(let newRecipe):
                self?.recipes.append(newRecipe)
                self?.showAlert(title: "Success", message: "Recipe saved on your Back4App Database! (objectId: \(newRecipe.id)")
            case .failure(let error):
                self?.showAlert(title: "Error", message: "Failedto save recipe: \(error.message)")
            }
        }
    }
  
    /// Saves the currently displayed recipe on your Back4App Database
    @objc func handleSaveRecipe() {
        view.endEditing(true)
        guard var recipe = prepareRecipeMetadata() else { // Prepares the Recipe object for storing
            return showAlert(title: "Error", message: "Failed to retrieve all the recipe fields.")
        }
      
        recipe.objectId = nil // When saving a Recipe object, we ensure it will be a new instance of it.
        recipe.save { [weak self] result in
            switch result {
            case .success(let newRecipe):
                if let index = self?.currentRecipeIndex { self?.recipes[index] = newRecipe }
                self?.showAlert(title: "Success", message: "Recipe saved on your Back4App Database! (objectId: \(newRecipe.id))")
            case .failure(let error):
                self?.showAlert(title: "Error", message: "Failed to save recipe: \(error.message)")
            }
        }
    }
  
    /// When called it refreshes the UI according to the content of *recipes* and *currentRecipeIndex* properties
    private func presentCurrentRecipe() {
        ...
    }
  
    /// Adds the 'Next recipe' and 'Previous recipe' button on the navigation bar. These are used to iterate over all the recipes retreived from your Back4App Database
    private func setupRecipeNavigation() {
        ...
    }
  
    /// Reads the information the user entered via the form and returns it as a *Recipe* object
    private func prepareRecipeMetadata() -> Recipe? {
        let ingredientsCount = ingredientsStackView.arrangedSubviews.count
        let nutritionalInfoCount = nutritionalInfoStackView.arrangedSubviews.count
      
        let ingredients: [Ingredient] = (0..<ingredientsCount).compactMap { row in
            guard let textFields = ingredientsStackView.arrangedSubviews[row] as? DoubleTextField,
                  let quantityString = textFields.primaryText,
                  let quantity = Float(quantityString),
                  let description = textFields.secondaryText
            else {
                return nil
            }
            return Ingredient(quantity: quantity, description: description)
        }
      
        var nutritionalInfo: [String: String] = [:]
        
        (0..<nutritionalInfoCount).forEach { row in
            guard let textFields = nutritionalInfoStackView.arrangedSubviews[row] as? DoubleTextField,
                  let content = textFields.primaryText, !content.isEmpty,
                  let value = textFields.secondaryText, !value.isEmpty
            else {
                return
            }
            nutritionalInfo[content] = value
        }
       
        let recipeInfo = recipeOverviewView.parseInputToRecipe() // Reads all the remaining fields from the form (name, category, price, serving, etc) and returns them as a tuple

       // we collect all the information the user entered and create an instance of Recipe.
       // The recipeInfo.objectId will be nil if the currently displayed information does not correspond to a recipe already saved on your Back4App Database
       let newRecipe: Recipe = Recipe(
           objectId: recipeInfo.objectId,
           name: recipeInfo.name,
           servings: recipeInfo.servings,
           price: recipeInfo.price,
           isAvailable: recipeInfo.isAvailable,
           category: recipeInfo.category,
           ingredients: ingredients,
           sideOptions: recipeInfo.sideOptions,
           nutritionalInfo: nutritionalInfo,
           releaseDate: recipeInfo.releaseDate
       )
      
       return newRecipe
   }
  
   /// Called when the user presses the 'Previous recipe' or 'Next recipe' button
   @objc private func handleSwitchRecipe(button: UIBarButtonItem) {
       ...
   }
}
 import UIKit
 import ParseSwift
3
 extension RecipesController {
     /// Retrieves all the recipes stored on your Back4App Database
     @objc func handleReloadRecipes() {
         view.endEditing(true)
         let query = Recipe.query()
         query.find { [weak self] result in // Retrieves all the recipes stored on your Back4App Database and refreshes the UI acordingly
            guard let self = self else { return }
            switch result {
            case .success(let recipes):
                self.recipes = recipes
                self.currentRecipeIndex = recipes.isEmpty ? nil : 0
                self.setupRecipeNavigation()
              
                DispatchQueue.main.async { self.presentCurrentRecipe() }
            case .failure(let error):
                DispatchQueue.main.async { self.showAlert(title: "Error", message: error.message) }
            }
        }
    }
  
    /// Called when the user wants to update the information of the currently displayed recipe
    @objc func handleUpdateRecipe() {
        view.endEditing(true)
        guard let recipe = prepareRecipeMetadata(), recipe.objectId != nil else { // Prepares the Recipe object for updating
            return showAlert(title: "Error", message: "Recipe not found.")
        }
      
        recipe.save { [weak self] result in
            switch result {
            case .success(let newRecipe):
                self?.recipes.append(newRecipe)
                self?.showAlert(title: "Success", message: "Recipe saved on your Back4App Database! (objectId: \(newRecipe.id)")
            case .failure(let error):
                self?.showAlert(title: "Error", message: "Failedto save recipe: \(error.message)")
            }
        }
    }
  
    /// Saves the currently displayed recipe on your Back4App Database
    @objc func handleSaveRecipe() {
        view.endEditing(true)
        guard var recipe = prepareRecipeMetadata() else { // Prepares the Recipe object for storing
            return showAlert(title: "Error", message: "Failed to retrieve all the recipe fields.")
        }
      
        recipe.objectId = nil // When saving a Recipe object, we ensure it will be a new instance of it.
        recipe.save { [weak self] result in
            switch result {
            case .success(let newRecipe):
                if let index = self?.currentRecipeIndex { self?.recipes[index] = newRecipe }
                self?.showAlert(title: "Success", message: "Recipe saved on your Back4App Database! (objectId: \(newRecipe.id))")
            case .failure(let error):
                self?.showAlert(title: "Error", message: "Failed to save recipe: \(error.message)")
            }
        }
    }
  
    /// When called it refreshes the UI according to the content of *recipes* and *currentRecipeIndex* properties
    private func presentCurrentRecipe() {
        ...
    }
  
    /// Adds the 'Next recipe' and 'Previous recipe' button on the navigation bar. These are used to iterate over all the recipes retreived from your Back4App Database
    private func setupRecipeNavigation() {
        ...
    }
  
    /// Reads the information the user entered via the form and returns it as a *Recipe* object
    private func prepareRecipeMetadata() -> Recipe? {
        let ingredientsCount = ingredientsStackView.arrangedSubviews.count
        let nutritionalInfoCount = nutritionalInfoStackView.arrangedSubviews.count
      
        let ingredients: [Ingredient] = (0..<ingredientsCount).compactMap { row in
            guard let textFields = ingredientsStackView.arrangedSubviews[row] as? DoubleTextField,
                  let quantityString = textFields.primaryText,
                  let quantity = Float(quantityString),
                  let description = textFields.secondaryText
            else {
                return nil
            }
            return Ingredient(quantity: quantity, description: description)
        }
      
        var nutritionalInfo: [String: String] = [:]
        
        (0..<nutritionalInfoCount).forEach { row in
            guard let textFields = nutritionalInfoStackView.arrangedSubviews[row] as? DoubleTextField,
                  let content = textFields.primaryText, !content.isEmpty,
                  let value = textFields.secondaryText, !value.isEmpty
            else {
                return
            }
            nutritionalInfo[content] = value
        }
       
        let recipeInfo = recipeOverviewView.parseInputToRecipe() // Reads all the remaining fields from the form (name, category, price, serving, etc) and returns them as a tuple

       // we collect all the information the user entered and create an instance of Recipe.
       // The recipeInfo.objectId will be nil if the currently displayed information does not correspond to a recipe already saved on your Back4App Database
       let newRecipe: Recipe = Recipe(
           objectId: recipeInfo.objectId,
           name: recipeInfo.name,
           servings: recipeInfo.servings,
           price: recipeInfo.price,
           isAvailable: recipeInfo.isAvailable,
           category: recipeInfo.category,
           ingredients: ingredients,
           sideOptions: recipeInfo.sideOptions,
           nutritionalInfo: nutritionalInfo,
           releaseDate: recipeInfo.releaseDate
       )
      
       return newRecipe
   }
  
   /// Called when the user presses the 'Previous recipe' or 'Next recipe' button
   @objc private func handleSwitchRecipe(button: UIBarButtonItem) {
       ...
   }
}
﻿
- Exécutez l'application !
Avant d'appuyer sur le bouton exécuter dans XCode, n'oubliez pas de configurer votre application Back4App dans la classe AppDelegate !
La première fois que vous exécutez le projet, vous devriez voir quelque chose comme ça dans le simulateur (avec tous les champs vides)
﻿
Maintenant, vous pouvez commencer à entrer une recette pour ensuite l'enregistrer dans votre base de données Back4App. Une fois que vous avez enregistré une recette, allez sur votre tableau de bord Back4App et allez dans votre application, dans la section Base de données, vous trouverez la classe Recette où toutes les recettes créées par l'application iOS.
En particulier, il convient de noter comment des types de données non fondamentaux comme Ingrédient, Recette.Catégorie ou les dictionnaires sont stockés. Si vous naviguez à travers les données enregistrées sous la classe Recette, vous constaterez que
Le dictionnaire nutritionalInformation est stocké en tant qu'objet JSON.
Le tableau [Ingrédients] est stocké en tant que tableau d'objets JSON.
L'énumération Recette.Catégorie, puisqu'elle a un type de données entier comme RawValue, est transformée en un type de valeur Numérique.
La propriété releaseDate, une valeur de type Date en Swift, est également stockée en tant que valeur de type Date.
Pour conclure, lors de la récupération des données de votre base de données Back4App, vous n'avez pas besoin de décoder tous ces champs manuellement, le SDK ParseSwift les décode automatiquement. Cela signifie que, lors de la création d'une requête (Query<Recette> dans ce cas) pour récupérer des données, la méthode query.find() analysera tous les types de données et objets JSON pour renvoyer un tableau de Recettes, il n'y a pas de procédure d'analyse supplémentaire à mettre en œuvre.
Champ	Type de données	Description
Nom	Chaîne	Nom de la recette
Portions	Int	Nombre de portions
Disponible	Bool	Détermine si la recette est disponible ou non
Catégorie	Catégorie	Une énumération personnalisée qui classe une recette en trois catégories : Petit-déjeuner, Déjeuner et Dîner
Ingrédients	[Ingrédients]	L'ensemble des ingrédients contenus dans une structure customIngredient
Options latérales	[Chaîne]	Noms des options supplémentaires avec lesquelles la recette est fournie
Informations nutritionnelles	[Chaîne:Chaîne]	Un dictionnaire contenant des informations sur le contenu nutritionnel de la recette
Date de sortie	Date	Une date indiquant quand la recette était disponible
Mis à jour 27 Jan 2025
Cette page vous a-t-elle aidée?
Implémentation CRUD avec ParseSwift SDK pour iOS
Implémentation de relations avec Parse Swift SDK sur iOS
Analyse des Types de Données avec ParseSwift sur iOS

Analyser les types de données sur Swift

Introduction

Objectif

Prérequis

Comprendre notre application de recettes

Référence rapide des commandes que nous allons utiliser

1 - Créer le modèle d'application Recipe

2 - Configurer l'objet Recipe

3 - Configuration de RecipesController

3 - Gestion de l'entrée utilisateur et analyse d'un objet Recette

4 - Exécutez l'application !
