REST API による Salesforce データへのアクセス

RestClient パブリッシャーの使用

Salesforce データにアクセスするには、Salesforce に REST 要求を送信してアプリケーションで応答を受信します。ネットワーク要求をコーディングして送信し、応答を処理するにはどうすればよいのでしょうか?

Swift UI アプリケーションでは、ビュー-モデルアーキテクチャを使用します。ビュークラスは SwiftUI で画面のレイアウトを定義し、実行時に、インターフェースに入力するデータの関連付けられたモデルクラスをコールします。Mobile SDK Swift テンプレートプロジェクトで、モデルクラスは Models プロジェクトフォルダーに存在します。たとえば、ContactsForAccountModel.swift ファイルは、取引先の取引先責任者リストを要求するコードを定義します。応答が届くと、ContactsForAccountModel クラスが返されたレコードを処理して、取引先責任者情報のリストを ContactsForAccountListView クラスに送信します。 

RestClient は、すべての REST サービスへのエントリポイントです。Mobile SDK アプリケーションは、RestClient メソッドを使用して REST 要求を作成して送信します。このクラスには常に、次の共有インスタンス経由でアクセスします。

RestClient.shared()

1. Xcode で、ContactsForAccountModel.swift ファイルを開きます。
2. fetchContactsForAccount(_:) メソッドを検索します。実装は次のようになります。

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

パブリッシャーのコールは、次のコードで始まる行で確認できます。

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

コールチェーンとして続く一連のコールを見たことがあるかもしれません。SwiftCombine のパブリッシャーでこうしたコールは一般的な構造で役に立ちます。このコールチェーンは非同期ネットワーク応答を、最終的に終了または失敗のいずれかになる Future オブジェクトとして処理します。コールチェーンごとに、現在のデフォルトオブジェクトでアクションが実行されます。このオブジェクトは、チェーンの前のコールの戻り値でリセットできます。ネットワークコールに失敗した場合や Salesforce がエラーを返した場合は、処理が .catch ブロックにフォールスルーします。 

コールチェーンがどのように機能するのかを把握できるように、細かくコメントされたシーケンスのリストを以下に示します。

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