Modification de l’application native Forcedroid

Comme vu précédemment, l’application modèle Android native affiche une liste de contacts et de comptes depuis l’organisation Salesforce de l’utilisateur. Actuellement, cette liste en lecture seule est générée à partir d’une simple requête SOQL SELECT traitée par les classes REST du kit de développement Mobile SDK. Ajoutons quelques capacités de modification en associant une action de suppression en cas de pression longue. Lorsque l’utilisateur touche et maintient un nom de contact dans la vue de liste, votre nouvelle action de suppression tente de supprimer l’enregistrement Salesforce associé. Si cette tentative réussit, votre application supprime définitivement la ligne de la vue de liste Contacts dans l'application. Si la requête échoue, votre application indique à l'utilisateur les raisons de cet échec et rétablit la ligne de la vue de liste.

L’implémentation de ce module est simple. Mais décider comment créer une classe pour le module d'écoute du clic prolongé est un peu plus délicat. Si vous explorez les différentes options de codage, la première chose que vous découvrirez, c'est que vous ne prêtez pas attention aux clics au niveau de la vue de liste. Vous le faites au niveau des éléments de la liste. Par chance, implémenter des modules d'écoute pour les éléments de la liste n'est pas une tâche difficile, grâce à l'interface Android OnItemLongClickListener. Cette interface définit un seul module d'écoute associé à la vue de liste et répond aux pressions longues sur un élément de la liste. Vous créez une instance de cette classe en implémentant une interface publique au sein de votre classe de vue.

Le prochain défi est de déterminer la classe de vue qui implémente le module d'écoute du clic prolongé. Grâce aux objets ListView, vous fournissez un objet de données qui donne les informations qui s'affichent dans la liste. L’application modèle du kit de développement Mobile SDK crée, dans cette optique, un objet ArrayAdapter<String>, puis le rattache à ListView.

listAdapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, new 
ArrayList<String>());
((ListView) findViewById(R.id.contacts_list)).setAdapter(listAdapter);

Mais ArrayAdapter<String> est un objet de données, pas une vue, exact ? Oui, mais pas seulement. Dans la vue de liste Contacts, ArrayAdapter crée un objet AdapterView pour chaque élément de l'ensemble des données de la liste. Les vues de cet adaptateur représentant les objets qui vous intéressent. Par conséquent, utilisez la classe AdapterView pour implémenter OnItemLongClickListener. Vous associez ensuite l'objet du module d'écoute à l'objet ListView, qui reçoit toutes les notifications pour ses enfants. Cette association limite votre OnItemLongClickListener pour qu'il interagisse uniquement avec les éléments de la vue de liste de l'application modèle. Enfin, vous exécutez votre comportement de suppression dans la seule méthode d'interface.

Un dernier détail à résoudre : où placez-vous ce code pour le module d'écoute du clic prolongé ? Le kit de développement Mobile SDK vous propose les méthodes de rappel de point d’entrée suivantes :

public abstract void onResume(RestClient client);

@Override
protected void onCreate(Bundle savedInstanceState);

@Override 
public void onResume();

Nous pouvons en éliminer une : onCreate (Bundle savedInstanceState). Cette méthode configure l'activité et gère les flux d'authentification avant l’instanciation des vues. Les vues entrent en action dans la méthode onResume(). Cette méthode semble donc être la plus probable. La méthode onResume(RestClient client) est appelée par la super-classe lors de la connexion pour capturer l’objet RestClient authentifié, que nous allons laisser de côté ici. Par conséquent, les résultats sont arrivés. Ajoutez votre code d’écoute du clic prolongé à onResume().

Vous allez bientôt pouvoir ajouter des éléments du kit de développement Mobile SDK. Dans la méthode onItemLongClick(), vous créez une requête REST pour supprimer l’enregistrement Salesforce associé à la ligne touchée. Vous envoyez ensuite cette requête à Salesforce. Avant d’explorer le code, examinons quelques points importants.

public static RestRequest getRequestForDelete(String apiVersion, String objectType, String objectId);

Votre classe MainActivity émet deux requêtes REST : une pour les contacts et une autre pour les comptes. Chaque requête contient une instruction SOQL. Nous allons utiliser des comptes. Par conséquent, mettez à jour la requête des enregistrements Contact pour renvoyer les valeurs d’ID.

1. Dans Android Studio, ouvrez le fichier MainActivity.java.
2. Recherchez la méthode onFetchContactsClick().

   public void onFetchContactsClick(View v) throws UnsupportedEncodingException
   {
      sendRequest("SELECT Name FROM Contact");
   }
   

3. Changez la requête SOQL pour sélectionner les champs Name et Id. Assurez-vous de respecter la casse mixte du nom de champ de l'ID. Les noms de champs sont sensibles à la casse.

   public void onFetchContactsClick(View v) throws UnsupportedEncodingException
   {
      sendRequest("SELECT Name, Id FROM Contact");
   }

Vous êtes prêt à recevoir les valeurs d’ID dans la réponse REST. Quel est le meilleur emplacement pour les stocker ? L'application modèle copie simplement la valeur Nom de chaque enregistrement dans une ligne de la vue de liste, elle ne met en cache les valeurs d’ID. Pour activer les références dans votre gestionnaire, vous devez stocker les ID dans une portée de classe.

RestRequest restRequest = RestRequest.getRequestForQuery(
    ApiVersionStrings.getVersionNumber(this), soql);

Elle envoie ensuite le nouvel objet RestRequest à Salesforce dans l’appel client.sendAsync().

client.sendAsync(restRequest, new AsyncRequestCallback() {
    @Override
    public void onSuccess(RestRequest request, final RestResponse result) {
        result.consumeQuietly(); // consume before going back to main thread
        runOnUiThread(new Runnable() {
            @Override
            public void run() {
                try {
                    listAdapter.clear();
                    JSONArray records = result.asJSONObject().getJSONArray("records");
                    for (int i = 0; i < records.length(); i++) {
                        listAdapter.add(records.getJSONObject(i).getString("Name"));
                    }
                } catch (Exception e) {
                    onError(e);
                }
            }
        });
    }
 
    @Override
    public void onError(final Exception exception) {
        runOnUiThread(new Runnable() {
        @Override
            public void run() {
                Toast.makeText(MainActivity.this,
                    MainActivity.this.getString(
                        R.string.sf__generic_error, 
                        exception.toString()),
                    Toast.LENGTH_LONG).show();
            }
        });
    }
});

En plus de l’objet RestRequest, l’appel sendAsync() nécessite d’implémenter l’interface AsyncRequestCallback du kit de développement Mobile SDK. La méthode onSuccess() de cette interface reçoit la réponse REST de façon asynchrone via un rappel. Votre implémentation par défaut AsyncRequestCallback traite uniquement les requêtes SOQL définies dans votre application forcedroid.

Voici l'épilogue de la méthode onItemLongClick(). L’algorithme de base est le suivant :

1. Obtenir un objet de « demande de suppression » en appelant une méthode de factory appropriée du kit de développement Mobile SDK, RestRequest. Toutes les méthodes RestRequest renvoient des exceptions, assurez-vous donc de placer l'appel dans un bloc try...catch.
2. Envoyer l’objet de « demande de suppression » à Salesforce à l’aide de l’objet généré RestClient.
3. Traiter le résultat REST dans les méthodes de rappel.

Le bouton Extraire les comptes est supprimé lors d'un léger nettoyage final. L'affichage de la liste étant partagé entre Extraire les contacts et Extraire les comptes, votre gestionnaire de pression longue s'applique également aux deux. Cependant, ce gestionnaire est inutile pour les comptes, car l'ID que vous utilisez pour supprimer l'enregistrement s'applique uniquement à un contact. En tant que « crédit supplémentaire », vous pouvez également appliquer ce que vous avez appris et adapter le gestionnaire de pression longue pour supprimer à la fois les contacts et les comptes. Cependant, pour ce didacticiel, supprimons le code associé aux comptes.

Supprimez les éléments suivants des fichiers indiqués :

Enfin, votre application est terminée et prête à fonctionner !

1. Dans Android Studio, cliquez sur Run | Run ‘app’.
2. Sélectionnez un appareil connecté ou un émulateur compatible avec le kit de développement Mobile SDK.
3. Lorsque l’application est exécutée, connectez-vous à votre organisation Salesforce, puis cliquez sur Fetch Contacts pour afficher la liste. Touchez et maintenez un élément de la liste jusqu'à ce que vous voyiez un message toast qui confirme la pression longue.

Notez que vous recevez une réponse d’erreur lorsque vous essayez de supprimer un contact par défaut dans la base de données Developer Edition. Ces erreurs se produisent car chaque contact pré-empaqueté dans une organisation Developer Edition est le parent d’autres enregistrements. Pour préparer le test, connectez-vous à votre organisation Developer Edition, puis créez un ou plusieurs contacts test qui n’ont pas d’autres enregistrements. Si la suppression est réussie, un message apparaît indiquant que l'enregistrement a été supprimé.

• Utilisation des API REST
• RestClient Class
• RestRequest Class