Modificar la aplicación forcedroid nativa

Como ha visto anteriormente, la aplicación de plantilla Android nativa muestra una lista de contactos o cuentas de la organización de Salesforce del usuario. En la actualidad, es una lista de solo lectura creada a partir de una consulta SOQL SELECT sencilla que se procesa mediante clases de REST de Mobile SDK. Vamos a ampliar la capacidad de modificación mediante la adición de una acción de eliminación al gesto de pulsación prolongada. Cuando el usuario toca de forma continua un nombre de contacto en la vista de lista, la nueva acción de eliminación intenta eliminar el registro de Salesforce asociado. Si el intento tiene éxito, la aplicación elimina permanentemente la fila de la vista de lista de contactos en la aplicación. Si la solicitud genera un error, la aplicación indica al usuario el motivo del error y restablece la fila de la vista de lista.

La implementación del proceso de escucha de clic prolongado es sencilla. Sin embargo, decidir cómo crear la clase de proceso de escucha de clic prolongado, es algo un poco más difícil. Si analiza las distintas opciones de codificación, lo primero que descubre es que no se escuchan los clics en el nivel de vista de lista. En su lugar, se escuchan en el nivel de elemento de lista. Por suerte, la implementación de procesos de escucha no es una tarea compleja gracias a la interfaz OnItemLongClickListener de Android. Esta interfaz define un único proceso de escucha asociado a la vista de lista y que responde a las pulsaciones prolongadas de cualquier elemento de la lista. Cree una instancia de esta clase mediante la implementación de una interfaz pública en su clase de vista.

El siguiente reto es determinar qué clase de vista implementa el proceso de escucha de clic prolongado. En el caso de los objetos ListView, especifique un objeto de datos que proporcione la información mostrada en la lista. La aplicación de plantilla de Mobile SDK crea un objeto ArrayAdapter<Cadena> con este fin y, a continuación, lo asocia a ListView.

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

Sin embargo, ArrayAdapter<String> es un objeto de datos y no una vista, ¿verdad? Sí, y mucho más. ArrayAdapter crea en la vista de lista de contactos un objeto AdapterView para cada elemento del conjunto de datos de la lista. Dado que estas vistas de adaptador representan los objetos de interés, use la clase AdapterView para implementar OnItemLongClickListener. A continuación, asocie el objeto de proceso de escucha con el objeto ListView, el cual recibe todas las notificaciones de sus elementos secundarios. Esta asociación limita OnItemLongClickListener a la interacción solo con los elementos de la vista de lista de la aplicación de plantilla. Por último, implemente su comportamiento de eliminación en el método de interfaz única.

Un detalle final que solucionar: ¿Dónde se incluye este código de proceso de escucha de clic prolongado? Mobile SDK proporciona los siguientes métodos de devolución de llamada de punto de entrada:

public abstract void onResume(RestClient client);

@Override
protected void onCreate(Bundle savedInstanceState);

@Override 
public void onResume();

Podemos eliminar uno de ellos: onCreate(Bundle savedInstanceState). Este método configura la actividad y controla los flujos de autenticación antes de que se creen instancias de las vistas. Las vistas entran en escena en el método onResume(). Por lo tanto, este método parecer ser la opción más probable. La llamada al método onResume(RestClient client) se realiza mediante la superclase en el inicio de sesión para capturar el objeto RestClient, que vamos a dejar como está. Por lo tanto, ya tenemos los resultados. Agregue el código de proceso de escucha de clic prolongado a onResume().

Ya casi estamos listos para agregar elementos de Mobile SDK. En el método onItemLongClick(), cree una solicitud REST para eliminar el registro de Salesforce asociado a la fila tocada. A continuación, envíe la solicitud a Salesforce. Antes de profundizar en el código, revise estos aspectos importantes.

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

La clase MainActivity genera dos solicitudes REST: una para contactos y otra para cuentas. Cada solicitud contiene una declaración SOQL. Dado que no vamos a usar cuentas, vamos a actualizar la solicitud de registros de contacto para devolver valores de Id.

1. En Android Studio, abra el archivo MainActivity.java.
2. Busque el método onFetchContactsClick().

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

3. Cambie la consulta SOQL para seleccionar los campos Name e Id. Asegúrese de usar la ortografía con distinción entre mayúsculas y minúsculas del nombre de campo de Id. Los nombres de campo distinguen entre mayúsculas y minúsculas.

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

Ahora que está preparado para recibir los valores de Id. en la respuesta REST, ¿cuál es la mejor ubicación para almacenarlos? La aplicación de plantilla solo copia el valor de nombre para cada registro en una fila de la vista de lista, pero no almacena en caché los valores de Id. Para activar las búsquedas en el controlador de pulsación prolongada, debe almacenar los Id. en el ámbito de clase.

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

A continuación, envía el nuevo objeto RestRequest a Salesforce en la llamada 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();
            }
        });
    }
});

Además del objeto RestRequest, la llamada sendAsync() requiere una implementación de la interfaz AsyncRequestCallback de Mobile SDK. El método onSuccess() de esta interfaz recibe la respuesta REST de forma asíncrona mediante una devolución de llamada. La implementación AsyncRequestCallback predeterminada controla solo las consultas SOQL definidas en la aplicación forcedroid.

Ya está preparado para finalizar el método onItemLongClick(). El algoritmo básico es el siguiente:

1. Obtenga un objeto de “solicitud de eliminación” mediante la llamada a un método de generador RestRequest de Mobile SDK apropiado. Dado que todos los métodos RestRequest devuelven excepciones, asegúrese de incluir la llamada en un bloque try...catch.
2. Envíe el objeto de “solicitud de eliminación” a Salesforce mediante el objeto RestClient generado.
3. Controle el resultado de REST en métodos de devolución de llamada.

Parte de la limpieza final consiste en eliminar el botón Fetch Accounts (Obtener cuentas). Dado que la vista de lista se comparte entre Fetch Contacts (Obtener contactos) y Fetch Accounts (Obtener cuentas), el controlador de pulsación prolongada se aplica a ambos por igual. No obstante, este controlador no es válido para las cuentas, ya que el Id. usado para eliminar el registro solo se aplica a un contacto. De forma alternativa y como “ventaja adicional”, puede aplicar lo que ha aprendido y adaptar el controlador de pulsación prolongada para eliminar contactos y cuentas. Sin embargo, en este tutorial, vamos a eliminar el código relacionado con las cuentas.

Elimine los siguientes elementos de los archivos indicados:

Al fin, su aplicación está terminada y lista para su ejecución.

1. En Android Studio, haga clic en Run | Run ‘app’ (Ejecutar | Ejecutar ‘aplicación’).
2. Seleccione un emulador o dispositivo conectado compatible con Mobile SDK.
3. Cuando la aplicación se esté ejecutando, inicie sesión en su organización de Salesforce y, a continuación, haga clic en Fetch Contacts (Obtener contactos) para ver la lista. Toque cualquier elemento de la lista y mantenga la pulsación hasta que se muestre un mensaje emergente para confirmar la pulsación prolongada.

Observe que obtiene una respuesta de error al intentar eliminar cualquier contacto predeterminado de la base de datos de Developer Edition. Estos errores se producen porque cada contacto que viene empaquetado previamente de una organización de Developer Edition es el elemento principal de otros registros. Para prepararse para las pruebas, inicie sesión en su organización de Developer Edition y cree uno o varios contactos de prueba que no tengan otros registros en propiedad. Si la eliminación es correcta, se muestra un mensaje para indicar que el registro se ha eliminado.

• Uso de API de REST
• RestClient Class
• RestRequest Class