Acessar dados do Salesforce por APIs REST

Como usar o editor do RestClient

Para acessar dados do Salesforce, envie solicitações REST para o Salesforce e receba as respostas no aplicativo. Como você codifica solicitações de rede, envia-as e processa suas respostas?

Os aplicativos da interface do usuário do Swift usam a arquitetura de modelos de exibição. Uma classe de visualização define layouts de tela em SwiftUI e, no tempo de execução, chama uma classe de modelo associada para os dados que preenchem suas interfaces. No projeto de modelo do Swift do Mobile SDK, as classes de modelo estão na pasta de projeto Modelos. Por exemplo, o arquivo ContactsForAccountModel.swift define o código que solicita uma lista de contatos para uma conta. Quando a resposta chega, a classe ContactsForAccountModel processa os registros retornados para enviar uma lista de informações de contatos para a classe ContactsForAccountListView. 

RestClient é seu ponto de entrada para todos os serviços REST. Os aplicativos Mobile SDK usam métodos RestClient para criar e enviar solicitações REST. Você acessa essa classe sempre por meio de sua instância compartilhada:

RestClient.shared()

1. No Xcode, abra o arquivo ContactsForAccountModel.swift.
2. Procure o método fetchContactsForAccount(_:). A implantação é exibida da seguinte forma:

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

Você pode ver a chamada do editor na linha que inicia:

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

Você pode reconhecer a sequência de chamadas que se segue como uma cadeia de chamadas, que é uma construção comum e útil para editores do Swift Combine. Essa cadeia de chamadas trata da resposta assíncrona da rede como um objeto Future que eventualmente termina ou falha. Em cada uma das cadeias de chamadas, a ação é realizada no objeto padrão atual. Esse objeto pode ser redefinido pelo valor de retorno da chamada anterior na cadeia. Se a chamada de rede falhar ou o Salesforce retornar um erro, o processamento cairá para o bloco .catch. 

Para ter uma noção detalhada de como a cadeia de chamadas funciona, veja a seguir uma lista muito bem comentada da sequência.

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