Atenção, esta resposta é indicada para programadores que tenham pelo menos um conhecimento básico de:
- Activity
- Fragment
- Lists e Adapters
- Custom Lists e Custom Adapters
Loaders
Introduzido no Android 3.0, os loaders fazem ser mais fáceis o carregamento de dados de maneira assíncrona nas Activitys e Fragments. Loaders tem as seguintes características:
- Eles estão disponíveis em cada Activity e Fragment.
- Eles proveem carregamento de dados de maneira assíncrona .
- Eles monitoram a fonte de seus dados e entregam novos resultados quando o conteúdo é modificado.
- Eles automaticamente reconectam para o último cursor do loader quando estão sendo recriados após uma mudança de configuração. Portanto, eles não precisam re-consultar seus dados.
Resumo da API do Loader
Essas são as múltiplas classes e interfaces que estão envolvidas no uso dos loaders em uma aplicação. Elas são resumidas nesta tabela:
OBS: Esta tabela foi montada a partir da tabela que se encontra no site oficial da documentação do android sobre loader. Eu peguei a tabela deles, traduzi, montei em um editor de texto, tirei print e então editei a imagem. Referências para os sites se encontram no final do post.
Referências para as classes / interfaces:
As classes e interfaces na tabela acima são os componentes essenciais que você vai usar para implementar um Loader em sua aplicação. Você não vai precisar de todos elas para cada Loader que criar, mas você sempre vai precisar de uma referência ao LoaderManager para inicializar um Loader e uma implementação de uma classe Loader como CursorLoader.
Usando Loaders em sua aplicação
Uma aplicação que usa Loaders tipicamente incluirá o seguinte:
OBS: PRESTE ATENÇÃO NO ITEM 3 A SEGUIR, A PARTE EM NEGRITO.
- Uma Activity ou Fragment.
- Uma instância do LoaderManager.
- Um CursorLoader para carregar dados apoiados por um ContentProvider. Alternativamente, você pode implementar sua própria subclasse de carregador ou AsyncTaskLoader para carregar dados de alguma outra fonte.
- Uma implementação de LoaderManager.LoaderCallbacks. Isto é onde você cria novos Loaders e gerencia suas referências a Loaders existentes.
Vimos um pouco sobre Loader e as classes que estão envolvidas em sua implementação. Você reparou no item 3 acima? Eu pedi para reparar. Na documentação, de onde foi retirado o texto acima, ele diz para utilizar um CursorLoader para carregar dados a partir de um ContentProvider, mas eu não quero isso.
Vou ensinar a como carregar dados diretamente de um banco de dados SQLite sem precisar criar um ContentProvider. Faremos isso a partir de uma biblioteca disponibilizada publicamente. Porém, vale lembrar, que poderíamos implementar nosso próprio Custom Loader se não quiséssemos utilizar a biblioteca. Mas fique calmo, ainda ensinarei a implementar um Custom Loader.
Biblioteca cwac-loaderex
Independente de como vocês criam o seu banco de dados, a biblioteca precisa utilizar uma referência a SQLiteOpenHelper, então tenha um método onde seja possível o retorno de tal objeto.
Com a biblioteca importada para o seu projeto e supondo que você já tenha uma referência para SQLiteOpenHelper, vamos utilizar como exemplo um ListFragment que quer exibir uma lista de fabricantes que está armazenado no banco de dados e quer utilizar um SimpleCursorAdapter para vincular esses dados a lista.
Classe FabricanteListFragment
Essa classe apresenta apenas os métodos e comandos necessários para a implementação, ignorando o resto.
/**
* Classe que exibe uma lista de fabricantes que estao cadastradas no banco de dados.
* O usuario pode cadastrar, editar e deletar um fabricante. Esses fabricantes sao utilizados somente para selecionar o fabricante do instrumento.
*
* @author Lucas Santos
* Date: 28/03/2014
* Time: 09:11:20
*/
public class FabricanteListFragment extends ListFragment implements LoaderCallbacks<Cursor> {
/** O ID unico do Loader. ID's dos Loaders sao especificos para a Activity ou Fragment em que eles residem. */
private static final int LOADER_ID = 1;
/** Referencia a interface callback no qual iremos interagir com o LoaderManager. */
private LoaderCallbacks<Cursor> loaderCallbacks;
/** O adapter que vincula nossos dados para o ListFragment. */
private SimpleCursorAdapter mAdapter;
/** Um Loader para um cursor que carrega dados diretamente de um banco de dados ao invés de utilizar Content Provider. */
private SQLiteCursorLoader loader;
@Override
public void onCreate( Bundle savedInstanceState ) {
super.onCreate( savedInstanceState );
String[] projection = { Fabricante.COLUNA_NOME.texto };
int[] to = { android.R.id.text1 };
/*
* Inicializa o adapter. O cursor do adapter e null. Nos iremos passar o cursor somente quando tiverem seu carregamento finalizado pela primeira vez.
* Exemplo: quando LoaderManager entrega os dados para onLoadFinished. Passango a flag 0 como ultimo argumento do adapter, isto previne que o adapter
* registre um ContentObserver para o Cursor (CursorLoader ira se encarregar disto para nos).
*/
mAdapter = new SimpleCursorAdapter( getActivity().getApplicationContext(), R.layout.list_fragment_item_drawer, null, projection, to, 0 );
// Associa o adapter, agora vazio, com o ListView
setListAdapter( mAdapter );
/*
* A Activity ou Fragment (que implementa a interfce LoaderCallbacks<D>) e o objeto callback do qual iremos interagir com o LoaderManager.
* O LoaderManager usa este objeto para instanciar um Loader e para notificar o cliente quando os dados estao disponiveis/indisponiveis.
*/
loaderCallbacks = this;
// Indica que este Fragmento gostaria de participar no preenchimento do menu de opcoes recebendo uma chamada para onCreateOptionsMenu e metodos relacionados.
setHasOptionsMenu( true );
}
@Override
public void onActivityCreated( Bundle savedInstanceState ) {
super.onActivityCreated( savedInstanceState );
/*
* Inicializa o Loader com o id "LOADER_ID" e callback 'loaderCallbacks'. Se o Loader nao existe, um e criado. Caso contrario, o Loader ja existente e reutilizado.
* O chamada ao initLoader assegura que o loader está inicializado e ativo. São duas as respostas a essa chamada:
* Se o loader especificado já existe, o último loader criado será reutilizado.
* Se o loader especificado não existe, o initLoader inicia o método onCreateLoader dentro de LoaderManager.LoaderCallbacks.
* Aqui é onde você implementa código para instanciar e retornar um novo loader.
* Em ambos os casos, o LoaderManager ira gerenciar o Loader sobre o ciclo de vida da Activity/Fragment, ira receber qualquer novos Loaders uma vez que estiverem completados,
* e ira relatar estes novos dados de volta para o objeto 'loaderCallbacks'.
*/
getLoaderManager().initLoader( LOADER_ID, null, loaderCallbacks );
}
/*
* Instancia e retorna um novo Loader para um dado ID.
* É um método de fábrica que simplesmente retorna um novo Loader. O LoaderManager vai chamar esse método quando ele for o Loader pela primeira vez.
*/
@Override
public Loader<Cursor> onCreateLoader( int id, Bundle args ) {
// AQUI eu obtenho referência para um objeto `SQLiteOpenHelper` através da minha classe de banco de dados.
DatabaseHelper databaseHelper = DatabaseHelper.getInstance( getActivity().getApplicationContext() );
// Criamos o Loader através da biblioteca sem a menor dificuldade, apenas passando o `context`, objeto `SQLiteOpenHelper`, uma `Query` e os argumentos null.
// `Fabricante.GET_ALL_FABRICANTES.texto` é uma `Query` em forma de String que fará a consulta ao banco de dados. Como eu não utilizo a clausula WHERE, então o quarto parâmetro é null.
loader = new SQLiteCursorLoader( getActivity().getApplicationContext(), databaseHelper, Fabricante.GET_ALL_FABRICANTES.texto, null );
return loader;
}
/*
* Chamado quando um loader criado préviamente tem seu carregamento finalizado.
* Este método é geralmente onde o cliente irá atualizar a interface do usuário do aplicativo com os dados carregados.
* O cliente pode (e deve) assumir que novos dados serão retornados a este método cada vez que novos dados são disponibilizados.
* Lembre-se que este é o trabalho do Loader, monitorar a fonte de dados e realizar os carregamentos assíncronos reais.
* O LoaderManager receberá esses carregamentos uma vez que tenham concluído, em seguida, passar o resultado para o método onLoadFinished do objeto callback
* para o cliente (ou seja, a Activity/Fragment) para usar.
*/
@Override
public void onLoadFinished( Loader<Cursor> loader, Cursor data ) {
this.loader = (SQLiteCursorLoader) loader;
// O carregamento assincrono esta completo e os dados agora estao disponiveis para uso. Somente agora podemos associar o cursor consultado com o Adapter.
mAdapter.swapCursor( data );
// O listview agora exibe os dados consultados.
}
/*
* Chamado quando um loader criado préviamente está sendo resetado, fazendo com que seus dados fiquem indisponíveis.
* É chamado quando os dados do Loader está prestes a ser resetado. Este método dá a você a oportunidade para remover
* quaisquer referências a dados antigos que podem não estar mais disponíveis.
*/
@Override
public void onLoaderReset( Loader<Cursor> loader ) {
// Por algume razao, os dados dos Loader's estao agora indisponiveis. Remova qualquer referencia para os dados antigos substituindo ele com um Cursor null.
mAdapter.swapCursor( null );
}
}
Como a classe está TODA comentada, não vou comentar sobre a classe aqui, analisem o código.
Utilizar está biblioteca é realmente muito fácil. Agora depois de terem utilizado e implementado, testem como o Loader carrega automaticamente quando uma mudança é detectada. Experimentem colocar um método que exclui um fabricante da lista ou então adiciona, mas façam isso sem sair do Fragment da lista. Mas como? Por exemplo, coloque para quando apertar um item da lista, aparecer um Dialog perguntando se quer deletar, você confirma dizendo que sim e então realiza a exclusão no banco de dados. A tela irá atualizar automaticamente.
Deem uma olhada na documentação da biblioteca, ela fornece métodos para o seu Loader criado a partir do SQLiteCursorLoader para inserir e deletar do banco de dados sem precisar criar uma AsyncTask para isso. A criação da AsyncTask está encapsulada dentro do método fornecido pela biblioteca. Por exemplo, na lista acima se você quisesse excluir um registro no banco de dados utilizando o seu Loader bastava apenas fazer isso:
// Usando este metodo com um SQLiteCursorLoader ele automaticamente e executado em uma AsyncTask, ou seja, fora da Thread Main.
loader.delete( Fabricante.NOME_TABELA.texto, Fabricante.COLUNA_ID.texto + " = " + idItemSelecionado, null );
Simples não? :). Estarei explicando em outra resposta como implementar um Custom Loader para carregar dados de uma classe e retorná-los para exibição em uma Custom List que utiliza um Custom Adapter.
Referências: