Acceder a datos de Salesforce mediante API de REST

Uso del publicador RestClient

Para acceder a datos de Salesforce, envía solicitudes de REST a Salesforce y recibe las respuestas en su aplicación. ¿Cómo codifica solicitudes de red, las envía y las procesa en sus respuestas?

Las aplicaciones de interfaz de usuario de Swift utilizan una arquitectura de vista y modelo. Una clase de vista define formatos de pantalla en SwiftUI y, en el tiempo de ejecución, llama a una clase de modelo asociada para los datos que completa sus interfaces. En el proyecto de plantilla Swift de Mobile SDK, las clases de modelos están en la carpeta del proyecto Modelos. Por ejemplo, el archivo ContactsForAccountModel.swift define el código que solicita una lista de contactos para una cuenta. Cuando llega la respuesta, la clase ContactsForAccountModel procesa los registros devueltos para enviar una lista de información de contacto a la clase ContactsForAccountListView. 

RestClient es su punto de entrada a todos los servicios REST. Las aplicaciones del Mobile SDK utilizan métodos RestClient para fabricar y enviar solicitudes de REST. Siempre accederá únicamente a esta clase a través de su instancia compartida:

RestClient.shared()

1. En Xcode, abra el archivo ContactsForAccountModel.swift.
2. Busque el método fetchContactsForAccount(_:). La implementación lee algo parecido a lo siguiente:

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

Puede ver la llamada al publicador en la línea que comienza con:

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

Es posible que reconozca la secuencia de llamadas que aparece a continuación como una cadena de llamadas, lo cual es una construcción común y útil para los publicadores de Swift Combine. Esta cadena de llamadas controla la respuesta de red asincrónica como un objeto Future que eventualmente termina o falla. En cada una de las cadenas de llamada, la acción se realiza en el objeto predeterminado actual. Este objeto puede restablecerse con el valor de retorno de la llamada anterior en la cadena. Si la llamada de red fracasa o Salesforce devuelve un error, el procesamiento se instruye al bloque .catch. 

Para tener una idea detallada de cómo funciona la cadena de llamadas, a continuación, encontrará una lista ampliamente comentada de la secuencia.

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