Ändern der nativen Forcedroid-Anwendung

Wie bereits früher gezeigt, zeigt die native Android-Vorlagenanwendung eine Liste von Kontakten oder Accounts aus der Salesforce-Organisation des Benutzers an. Dabei handelt es sich derzeit um eine schreibgeschützte Liste, die über eine einfache SOQL SELECT-Abfrage erstellt wird, die durch die REST-Klassen des Mobile SDK verarbeitet wird. Durch geeignete Bearbeitung soll die Anwendung um eine Löschaktion für lange Fingerdrücke erweitert werden. Wenn der Benutzer längere Zeit mit dem Finger auf einen Kontaktnamen in der Listenansicht tippt, versucht die neue Löschaktion, den zugehörigen Salesforce-Datensatz zu löschen. Wenn dieser Versuch erfolgreich ist, wird die Zeile dauerhaft aus der Kontaktlistenansicht in der Anwendung entfernt. Wenn die Anforderung fehlschlägt, wird der Benutzer über die entsprechende Ursache informiert und die Zeile der Listenansicht wird wieder eingefügt.

Die Implementierung des LongClick-Listeners ist unkompliziert. Die Entscheidung, wie die LongClick-Listener-Klasse erstellt wird, ist jedoch etwas kniffliger. Wenn Sie die verschiedenen Codierungsoptionen untersuchen, stellen Sie zuerst fest, dass auf der Ebene der Listenansicht keine Klicks empfangen werden, sondern auf der Ebene der Listenelemente. Glücklicherweise ist die Listener-Implementierung für Listenelemente dank der OnItemLongClickListener-Schnittstelle von Android keine beschwerliche Aufgabe. Diese Schnittstelle definiert einen einzelnen Listener, der mit der Listenansicht verknüpft ist und auf lange Fingerdrücke auf Elemente in der Liste reagiert. Sie erstellen eine Instanz dieser Klasse, indem Sie in Ihrer Ansichtsklasse eine öffentliche Schnittstelle implementieren.

Die nächste Herausforderung besteht darin, festzustellen, welche Ansichtsklasse den LongClick-Listener implementiert. Mit ListView-Objekten stellen Sie ein Datenobjekt bereit, das die in der Liste angezeigten Informationen zur Verfügung stellt. Die Vorlagenanwendung des Mobile SDK erstellt zu diesem Zweck ein ArrayAdapter<Zeichenfolge>-Objekt, das anschließend mit dem ListView-Objekt verknüpft.

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

ArrayAdapter<Zeichenfolge> ist aber ein Datenobjekt und keine Ansicht. Richtig? Ja und darüber hinaus noch mehr. Der ArrayAdapter der Listenansicht für Kontakte erstellt für jedes Element im Datenset der Liste ein AdapterView-Objekt. Verwenden Sie die AdapterView-Klasse zum Implementieren von OnItemLongClickListener, da diese Adapteransichten die Objekte darstellen, die Sie interessieren. Anschließend verknüpfen Sie das Listener-Objekt mit dem ListView-Objekt, das alle Benachrichtigungen für die jeweiligen untergeordneten Objekte empfängt. Diese Verknüpfung beschränkt die Interaktion von OnItemLongClickListener auf die Elemente in der Listenansicht der Vorlagenanwendung. Schließlich implementieren Sie das Löschverhalten in dieser einzigen Schnittstellenmethode.

Ein letztes Detail, das es zu lösen gilt: Wo fügen Sie diesen LongClick-Listener-Code ein? Mobile SDK bietet Ihnen die folgenden Rückmeldungsmethoden für Einstiegspunkte:

public abstract void onResume(RestClient client);

@Override
protected void onCreate(Bundle savedInstanceState);

@Override 
public void onResume();

Davon kann eine entfernt werden: onCreate(Bundle savedInstanceState). Diese Methode konfiguriert die Aktivität und verarbeitet die Authentifizierungs-Flows, bevor die Ansichten instanziiert werden. Die Ansichten kommen erst in der onResume()-Methode zum Vorschein. Diese Methode scheint somit der wahrscheinlichste Kandidat zu sein. Die onResume(RestClient client)-Methode wird bei der Anmeldung von der Superklasse aufgerufen, um das authentifizierte RestClient-Objekt zu erfassen – dieses lassen wir allein stehen. So haben wir nun die Ergebnisse zusammen – fügen Sie Ihren LongClick-Listener-Code zu onResume() hinzu.

Wir sind schon fast startbereit, um Mobile SDK-Elemente hinzuzufügen. Um den Salesforce-Datensatz für die angetippte Zeile zu löschen, erstellen Sie in der onItemLongClick()-Methode eine REST-Anforderung. Diese Anforderung senden Sie dann an Salesforce. Bevor wir uns näher mit dem Code befassen, schauen Sie sich diese wichtigen Punkte in Ruhe an.

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

Ihre MainActivity-Klasse gibt zwei REST-Abfragen aus: eine für Kontakte, die andere für Accounts. Jede Abfrage enthält eine SOQL-Anweisung. Wir verwenden hier keine Accounts, sondern aktualisieren die Kontaktdatensatzabfrage, um ID-Werte zurückzugeben.

1. Öffnen Sie in Android Studio die Datei MainActivity.java.
2. Suchen Sie nach der Methode onFetchContactsClick().

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

3. Ändern Sie die SOQL-Abfrage, indem Sie die Felder Name und Id auswählen. Achten Sie auf die Camel-Case-Schreibweise des ID-Feldnamens. Bei Feldnamen wird die Groß-/Kleinschreibung berücksichtigt.

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

Da Sie nun gewappnet sind, um die ID-Werte in der REST-Antwort zu erhalten: Wo kann man diese am besten ablegen? Die Vorlagenanwendung kopiert den Name-Wert der einzelnen Datensätze lediglich in eine Listenansichtszeile - die betreffenden Werte werden nicht zwischengespeichert. Um Suchkomponenten in Ihrem LongClick-Handler zu aktivieren, müssen Sie die IDs im Klassenbereich speichern.

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

Anschließend wird das neue RestRequest-Objekt im client.sendAsync()-Aufruf an Salesforce gesendet.

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();
            }
        });
    }
});

Zusätzlich zum RestRequest-Objekt benötigt der sendAsync()-Aufruf eine Implementierung der Mobile SDK AsyncRequestCallback-Schnittstelle. Die onSuccess()-Methode dieser Oberfläche empfängt die REST-Antwort asynchron über eine Rückmeldung. Ihre standardmäßige AsyncRequestCallback-Implementierung verarbeitet nur die SOQL-Abfrage, die in Ihrer forcedroid-Anwendung definiert werden.

Sie können jetzt die onItemLongClick()-Methode fertigstellen. Der Basisalgorithmus lautet wie folgt:

1. Abrufen eines "Löschanforderungs"-Objekts durch Aufrufen einer entsprechenden Mobile SDK RestRequest-Factory-Methode. Alle RestRequest-Methoden lösen Ausnahmen aus. Sie müssen den Aufruf daher in einen try...catch-Block einschließen.
2. Senden des "Löschanforderungs"-Objekts an Salesforce unter Verwendung des generierten RestClient-Objekts.
3. Verarbeiten Sie das REST-Ergebnis in Rückmeldungsmethoden.

Eine abschließende Bereinigungsaufgabe besteht darin, die Schaltfläche Fetch Accounts zu entfernen. Da die Listenansicht von Fetch Contacts und Fetch Accounts gemeinsam genutzt wird, gilt der LongClick-Handler gleichermaßen für beide. Dieser Handler ist jedoch für Accounts nutzlos, weil die verwendete ID zum Löschen des Datensatzes nur für einen Kontakt gilt. Alternativ (als "Zusatzbonus") können Sie das Gelernte anwenden und den LongClick-Handler so anpassen, dass Kontakte und Accounts gelöscht werden. In diesem Lernprogramm entfernen wir jedoch nur den accountbezogenen Code.

Löschen Sie die folgenden Elemente auf den angegebenen Dateien:

So, nun ist Ihre Anwendung fertig und kann ausgeführt werden!

1. Klicken Sie in Android Studio auf Run | Run 'app'.
2. Wählen Sie einen Mobile SDK-kompatiblen Emulator oder ein verbundenes Gerät.
3. Wenn die Anwendung ausgeführt wird, melden Sie sich bei Ihrer Salesforce-Organisation an und klicken dann auf Fetch Contacts, um die Liste anzuzeigen. Tippen Sie solange auf ein Element in der Liste, bis eine Popupmeldung den langen Fingerdruck bestätigt.

Achten Sie darauf: Für jeden Standardkontakt in der Developer Edition-Datenbank, den Sie zu löschen versuchen, wird eine Fehlerantwort angezeigt. Diese Fehler treten auf, weil jeder Kontakt, der bereits in einer Developer Edition-Organisation vordefiniert ist, das übergeordnete Element anderer Datensätze ist. Zur Vorbereitung auf die Tests müssen Sie sich bei Ihrer Developer Edition-Organisation anmelden und einen oder mehrere Kontakte erstellen, die keine anderen Datensätze besitzen. Bei einem erfolgreichen Löschvorgang wird eine Meldung mit dem Hinweis angezeigt, dass der Datensatz gelöscht wurde.

• Verwenden von REST APIs
• RestClient Class
• RestRequest Class