Modificar o aplicativo nativo forcedroid

Como visto anteriormente, o aplicativo modelo Android nativo mostra uma lista de contatos ou contas da organização Salesforce do usuário. Ela é atualmente uma lista somente leitura criada com uma simples consulta SELECT SOQL processada pelas classes REST do Mobile SDK. Vamos adicionar capacidade de edição anexando uma ação de exclusão ao gesto de pressionamento longo. Quando o usuário toca e mantém o nome do contato pressionado no modo de exibição de lista, sua nova ação de exclusão tenta excluir o registro do Salesforce associado. Se a tentativa for bem-sucedida, seu aplicativo removerá permanentemente a linha do modo de exibição de lista de Contatos do aplicativo. Se a solicitação falhar, seu aplicativo indicará o motivo da falha ao usuário e restabelecerá a linha no modo de exibição de lista.

A implantação de um ouvinte de clique longo é simples. A escolha de como criar uma classe de ouvinte de clique longo, no entanto, é mais complicada. Se você explorar as várias opções de codificação, a primeira coisa a saber é que não se ouve cliques no nível do modo de exibição de lista. Em vez disso, você ouve no nível do item da lista. Por sorte, a implantação de ouvintes de itens de lista não é uma tarefa cansativa graças à interface OnItemLongClickListener do Android. Essa interface define um único ouvinte que é anexado ao modo de exibição de lista e responde a uma pressão de longa duração em um item da lista. Crie uma instância dessa classe implantando uma interface pública na sua classe de modo de exibição.

O desafio seguinte é descobrir qual classe de modo de exibição implanta o ouvinte de clique longo. Com objetos ListView, é possível fornecer um objeto de dados que oferece as informações exibidas na lista. O aplicativo modelo do Mobile SDK cria um objeto ArrayAdapter<String> para esse fim e o anexa 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);

Mas ArrayAdapter<String> é um objeto de dados, não um modo de exibição, certo? Sim, e mais. O ArrayAdapter no modo de exibição de lista de contatos cria um objeto AdapterView para cada item no conjunto de dados da lista. Como esses modos de exibição de adaptador representam os objetos de interesse, use a classe AdapterView para implantar OnItemLongClickListener. Em seguida, associe o objeto ouvinte ao objeto ListView, que recebe todas as notificações para seus filhos. Essa associação limita o OnItemLongClickListener para interagir somente com os itens no modo de exibição de lista do aplicativo de exemplo. Por fim, implante o comportamento de exclusão no método de interface único.

Um último detalhe: onde você coloca esse código do ouvinte de clique longo? O Mobile SDK dá os seguintes métodos de retorno de chamada de ponto de entrada:

public abstract void onResume(RestClient client);

@Override
protected void onCreate(Bundle savedInstanceState);

@Override 
public void onResume();

Podemos eliminar um: OnCreate (Bundle savedInstanceState). Esse método configura a atividade e trata os fluxos de autenticação antes da criação de uma instância dos modos de exibição. Os modos de exibição entram em cena no método onResume(). Esse método parece ser o mais indicado. O método onResume(RestClient client) é chamado pela superclasse no login para capturar o objeto RestClient autenticado. Vamos ignorá-lo. Assim, os resultados chegaram. Adicione seu código de ouvinte de clique longo a onResume().

Agora, já estamos quase prontos para adicionar elementos do Mobile SDK. No método onItemLongClick(), crie uma solicitação REST para excluir o registro do Salesforce associado à linha que foi tocada. Envie essa solicitação ao Salesforce. Antes de se aprofundar no código, examine estes pontos importantes.

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

Sua classe MainActivity emite duas solicitações REST: uma para contatos e outra para contas. Cada solicitação contém uma instrução SOQL. Não vamos usar contas. Vamos atualizar a solicitação de registro de Contatos para retornar valores de ID.

1. No Android Studio, abra o arquivo MainActivity.java.
2. Encontre o método onFetchContactsClick().

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

3. Altere a consulta SOQL para selecionar os campos Name e Id. Use a grafia em letras concatenadas (Camel case) do nome do campo da ID. Os nomes de campo diferenciam maiúsculas de minúsculas.

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

Agora que você está preparado para receber valores de ID na resposta REST, onde é o melhor lugar para guardá-los? O aplicativo modelo simplesmente copia o valor Name de cada registro em uma linha do modo de exibição de lista; ele não armazena os valores de ID em cache. Para permitir pesquisa em seu manipulador de pressionamento longo, armazene as IDs no escopo da classe.

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

Em seguida, ele envia o novo objeto RestRequest para o Salesforce na chamada 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();
            }
        });
    }
});

Além do objeto RestRequest, a chamada sendAsync() exige uma implantação da interface AsyncRequestCallback do Mobile SDK. O método onSuccess() dessa interface recebe a resposta REST de forma assíncrona por um retorno de chamada. Sua implantação de AsyncRequestCallback padrão trata somente as consultas SOQL definidas no aplicativo forcedroid.

Agora, você está pronto para concluir o método onItemLongClick(). O algoritmo base é o seguinte:

1. Obtenha um objeto “solicitar exclusão” chamando um método de fábrica Mobile SDK RestRequest apropriado. Todos os métodos RestRequest criam exceções e, portanto, coloque a chamada em um bloco try...catch.
2. Envie o objeto “solicitar exclusão” para o Salesforce usando o objeto RestClient gerado.
3. Trate do resultado REST nos métodos de retorno de chamada.

Uma parte da limpeza final é a remoção do botão Fetch Accounts (Buscar contas). Como o modo de exibição de lista é compartilhado entre Fetch Contacts (Buscar contatos) e Fetch Accounts (Buscar contas), o manipulador de pressionamento longo se aplica igualmente a ambos. No entanto, esse manipulador é inútil para contas porque a ID usada para excluir o registro só se aplica a um contato. Como alternativa – e “ponto extra” – você pode aplicar o que aprendeu e adaptar o manipulador de pressionamento longo para excluir tanto contatos quanto contas. Para este tutorial, no entanto, vamos remover o código relativo a contas.

Exclua os seguintes itens dos arquivos indicados:

Finalmente, seu aplicativo foi concluído e está pronto para ser executado!

1. No Android Studio, clique em Run (Executar) | Run ‘app’ (Executar ‘aplicativo’).
2. Selecione um emulador ou dispositivo conectado compatível com Mobile SDK.
3. Quando o aplicativo estiver em execução, entre na sua organização do Salesforce e clique em Fetch Contacts (Buscar contatos) para ver a lista. Mantenha um item pressionado na lista até ver uma notificação confirmando o pressionamento longo.

Observe que você recebe uma resposta de erro quando tenta excluir um contato padrão no banco de dados da Developer Edition. Esses erros ocorrem porque cada contato que vem pré-empacotado em uma organização Developer Edition é pai de outros registros. Para se preparar para o teste, faça login na sua organização Developer Edition e crie um ou mais contatos de teste que não tenham outros registros. Se a exclusão for bem-sucedida, uma mensagem aparecerá para indicar que o registro foi excluído.

• Como usar APIs REST
• RestClient Class
• RestRequest Class