Accès aux données Salesforce à l'aide des API REST

Utilisation de l’éditeur RestClient

Le processus d’accès aux données Salesforce implique que vous envoyiez des requêtes REST à Salesforce et receviez les réponses à celles-ci dans votre application. Alors, comment coder les requêtes réseau, les envoyer et traiter leurs réponses ?

Les applications SwiftUI utilisent une architecture de type modèle-vue. Une classe de vue définit les présentations d’écran dans SwiftUI et, au moment de l’exécution, appelle une classe de modèle associée correspondant aux données apparaissant dans leurs interfaces. Dans le projet modèle Swift du kit de développement mobile, les classes de modèle se trouvent dans le dossier de projet Modèles. Par exemple, le fichier ContactsForAccountModel.swift définit le code qui demande une liste de contacts pour un compte donné. Lorsque la réponse arrive, la classe ContactsForAccountModel traite les enregistrements renvoyés pour transmettre une liste d’informations de contact à la classe ContactsForAccountListView. 

RestClient constitue votre point d’entrée vers tous les services REST. Les applications issues du kit de développement mobile utilisent des méthodes RestClient pour élaborer et envoyer des demandes REST. Vous accédez toujours à cette classe uniquement via son instance partagée :

RestClient.shared()

1. Dans Xcode, ouvrez le fichier ContactsForAccountModel.swift.
2. Recherchez la méthode fetchContactsForAccount(_:). L’implémentation lit un code semblable à :

   class ContactsForAccountModel: ObservableObject {
       @Published var contacts: [Contact] = []
       var account: Account?
       private var contactsCancellable: AnyCancellable?
       func fetchContactsForAccount(){
           guard let acct = self.account else {return}
           let request = RestClient.shared.request(forQuery: 
               "SELECT id, firstName, lastName, phone, 
               email, mailingStreet, mailingCity, 
               mailingState, mailingPostalCode 
               FROM Contact 
               WHERE AccountID = '\(acct.id)'", apiVersion: nil)
           contactsCancellable = RestClient.shared.publisher(for: request)
               .receive(on: RunLoop.main)
               .tryMap({ (response) -> Data in
                   response.asData()
               })
               .decode(type: ContactResponse.self, decoder: JSONDecoder())
               .map({ (record) -> [Contact] in
                   record.records
               })
               .catch( { error in
                   Just([])
               })
               .assign(to: \.contacts, on:self)
           }
       }
   }

let request = RestClient.shared.request(forQuery:... 

L’appel de l’éditeur se trouve dans la ligne qui commence par :

contactsCancellable = RestClient.shared.publisher(for: request)

Vous reconnaîtrez peut-être que la séquence d’appels qui suit est une chaîne d’appels. Il s’agit d’une construction courante et utile pour les éditeurs Combine Swift. Cette chaîne d’appels traite la réponse réseau asynchrone comme un objet de type Future, qui aboutit ou échoue. Dans chacune des chaînes d’appels, l’action est exécutée sur l’objet par défaut actuel. Cet objet peut être réinitialisé par la valeur renvoyée par l’appel précédent dans la chaîne. Si l’appel réseau a échoué ou si Salesforce a renvoyé une erreur, le traitement s’arrête au bloc .catch. 

Pour mieux comprendre le fonctionnement de la chaîne d’appels, voici la séquence détaillée et commentée.

// Use the RestClient publisher to send the request and return the raw REST response
contactsCancellable = RestClient.shared.publisher(for: request)
    // Receive the raw REST response object
    .receive(on: RunLoop.main)
    // Try to convert the raw REST response to Data
    // Throw an error in the event of failure
    .tryMap({ (response) -> Data in
        // Return the response as a Data byte buffer
        response.asData()
    })
    // Decode the Data object as JSON to produce an array
    // of Contacts formatted as a ContactResponse object
    .decode(type: ContactResponse.self, decoder: JSONDecoder())
    // Map the JSON array of Contacts
    .map({ (record) -> [Contact] in
        // Copy the Contact array to the records
        // member of ContactResponse
        record.records
    })
    // If an error is thrown, publish an empty array
    .catch( { error in
        Just([]) // Combine publisher that rescues a failed publisher
    })
    // Store the array of contacts in the model’s published contacts
    // property for use by ContactsForAccountListView
    .assign(to: \.contacts, on:self)
}