Zugriff auf Salesforce-Daten über REST-APIs

Verwenden des RestClient-Publishers

Um auf Salesforce-Daten zuzugreifen, senden Sie REST-Anforderungen an Salesforce und empfangen die Antworten in Ihrer Anwendung. Wie werden Netzwerkanforderungen programmiert, gesendet und ihre Antworten verarbeitet?

SwiftUI-Anwendungen verwenden eine View-Model-Architektur. Eine View-Klasse definiert Bildschirmlayouts in SwiftUI und ruft zur Laufzeit eine zugehörige Model-Klasse für die Daten auf, die ihre Schnittstellen auffüllen. Im Swift-Vorlagenprojekt im Mobile SDK befinden sich die Model-Klassen im Projektordner "Models". Die Datei "ContactsForAccountModel.swift" definiert beispielsweise den Code, der eine Liste der Kontakte für einen Account anfordert. Wenn die Antwort eingeht, verarbeitet die ContactsForAccountModel-Klasse die zurückgegebenen Datensätze, um eine Liste der Kontaktinformationen an die ContactsForAccountListView-Klasse zu senden. 

RestClient ist Ihr Einstiegspunkt in alle REST-Services. Mobile SDK-Anwendungen verwenden RestClient-Methoden zum Erstellen und Senden von REST-Anforderungen. Sie greifen stets nur über ihre gemeinsame Instanz auf diese Klasse zu:

RestClient.shared()

1. Öffnen Sie in Xcode die Datei "ContactsForAccountModel.swift".
2. Suchen Sie die fetchContactsForAccount(_:)-Methode. Die Implementierung sieht in etwa so aus:

   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:... 

Sie sehen den Aufruf des Publishers in der Zeile, die so beginnt:

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

Die nachfolgende Abfolge von Aufrufen erkennen Sie ggf. als Aufrufkette, die eine gängige und nützliche Konstruktion für Swift Combine-Publisher ist. Diese Aufrufkette behandelt die asynchrone Netzwerkantwort als Future-Objekt, das schließlich entweder beendet wird oder fehlschlägt. In jeder der Aufrufketten wird die Aktion auf das aktuelle Standardobjekt angewendet. Dieses Objekt kann durch den Rückgabewert des vorherigen Aufrufs in der Kette zurückgesetzt werden. Wenn der Netzwerkaufruf fehlgeschlagen ist oder Salesforce einen Fehler zurückgegeben hat, wird die Verarbeitung an den .catch-Block weitergegeben. 

Um einen detaillierten Eindruck davon zu bekommen, wie die Aufrufkette funktioniert, finden Sie hier eine großzügig kommentierte Auflistung der Sequenz.

// 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)
}