O documento fornece uma introdução sobre persistência de dados com a biblioteca Realm.io para Android. Explica o que é persistência, quando devemos usar uma biblioteca para isso e apresenta o Realm como uma opção. Detalha como configurar o Realm no projeto, definir modelos de dados, fazer consultas, transações e remover dados. Fornece também dicas e truques sobre integração e boas práticas.

1. Persistência com Realm.io
Pedro Salomão
@ppgsalomao
ppgsalomao@gmail.com / pedro@onyo.com

2. #whoami

3. Persistência
O que é persistência?
Quando devemos buscar
uma biblioteca?
Realm resolve todos os
problemas de persistência?
Existe bala de prata?

4. O que precisamos saber
para usar o Realm?

5. Must know
Android Threads
ProGuard

6. Realm.io

7. Documentação
https://realm.io/

8. buildscript
{
repositories
{
jcenter()
}
}
dependencies
{
compile
'io.realm:realm-­‐android:0.82.2'
}
../your_module/build.gradle
-­‐keep
class
io.realm.annotations.RealmModule
-­‐keep
@io.realm.annotations.RealmModule
class
*
-­‐dontwarn
javax.**
-­‐dontwarn
io.realm.**
../your_module/proguard-­‐rules.pro

9. Modelos

10. Modelo
public class User extends RealmObject {
private String name;
private boolean boolValue;
private short number;
private int number2;
private long number3;
private float fractionNumber;
private double fractionNumber2;
private byte[] bytes;
private Date date;
private RealmObject object;
private RealmList<? extends RealmObject> list;
@PrimaryKey
private int id; // inteiros ou String
@Index
private int index; // Tipos primitivos
@Ignore
private int sessionId;
// Getters & Setters padrão
public String getName() { return name; }
public void setName(String name) { this.name = name; }
…
}

11. Tips & Tricks - Modelos
Todos os inteiros são mapeados para long, inclusive
os Wrappers.
Não é possível armazenar null para nenhum tipo
diferente de RealmObject ou RealmLists.
Os getters e setters são obrigatórios para todas as
propriedades não anotadas com @Ignore.
Getters e Setters são alterados depois pelo Realm,
então qualquer implementação diferente é descartada.

12. Tips & Tricks - Modelos
Todos os atributos devem ser privados.
Métodos e atributos estáticos são liberados.
@PrimaryKey não pode ser usada em mais de um
atributo.
@PrimaryKey já define implicitamente o @Index para
o atributo.

13. Tips & Tricks - Modelos
Nome da classe deve ter no máximo 57 caracteres.
Nome de atributo deve ter no máximo 63 caracteres
Datas são armazenadas com precisão de segundos,
no período 13/12/1900 e 19/01/2038.
Strings e byte[] devem ter no máximo 16mb.

14. Transações

15. Transações
Realm realm = Realm.getInstance(this);
realm.beginTransaction();
// Insere, altera ou remove objetos da base
realm.commitTransaction();
realm.cancelTransaction();
Realm realm = Realm.getInstance(this);
realm.executeTransaction((realm) -> {
// Insere, altera ou remove objetos da base
});
Realm realm = Realm.getInstance(this);
realm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
// Insere, altera ou remove objetos da base
}
});
Explicitamente
Realm + Lambda
Realm

16. Tips & Tricks - Transações
São obrigatórias para qualquer alteração na base de
dados.
Dados só são persistidos no disco após o commit da
transação.
Operações de escrita no banco bloqueiam outras
transações de escrita e podem demorar.
ATENÇÃO: Não faça operações de escrita no banco
na UI Thread.

17. Tips & Tricks - Transações
Divida o processo em criar objetos e gravar no
banco.
Escritas no banco não bloqueiam a leitura do
mesmo.
Transações aninhadas (uma transação dentro de outra
transação) não são suportadas e geram exceção.

18. Gravando no Banco

19. Criando objetos
User user = realm.createObject(User.class); // Create a new object
user.setName("John");
user.setEmail("john@corporation.com");
User user = new User("John");
user.setEmail("john@corporation.com");
User realmUser = realm.copyToRealm(user);
String json = ...;
realm.createObjectFromJson(User.class, json);
String json = ...;
realm.createOrUpdateObjectFromJson(User.class, json);

20. Tips & Tricks - Objetos
Manipulação de objetos deve sempre ocorrer dentro
de uma transação.
O objeto só pode ser usado na Thread em que ele foi
criado.
Pode-se criar um Wrapper para o objeto para poder
transitá-lo entre threads e inserir métodos nele.
Cuidado com restrições definidas por PrimaryKey ao
inserir ou atualizar objetos.

21. Fazendo consultas

22. Consultas
// Criando a consulta para pegar todos os usuários.
RealmQuery<User> query = realm.where(User.class);
// Adiciona as condições
query.equalTo("nome", "Joao");
query.or().equalTo("nome", "Pedro");
// Executa a consulta
RealmResults<User> resultado = query.findAll();
// Fazendo tudo junto
RealmResults<User> resultado = realm.where(User.class)
.equalTo("nome", "Joao")
.or()
.equalTo("nome", "Pedro")
.findAll();

23. Consultas
// Agrupando Operadores Lógicos
RealmResults<User> resultado = realm.where(User.class)
.greaterThan(“idade”, 10)
.beginGroup()
.equalTo("nome", "Joao")
.or()
.contains("nome", “Paulo")
.endGroup()
.findAll();
// Encadeando consultas
RealmResults<User> adolescentes = realm.where(User.class)
.between(“idade”, 13, 20)
.findAll();
User primeiroJoao = adolescentes.where()
.equalTo("nome", "Joao")
.findFirst();

24. Consultas
// Funções de agregação
long sum = resultado.sum("idade").longValue();
long min = resultado.min("idade").longValue();
long max = resultado.max("idade").longValue();
double average = resultado.average("idade");
long matches = result.size();
// Ordenando o resultado
RealmResults<User> result = realm.where(User.class).findAll();
result.sort("idade"); // Sort ascending
result.sort(""idade", RealmResults.SORT_ORDER_DESCENDING);
// Ordenando já na consulta
RealmResults<User> result = realm.where(User.class).findAllSorted("idade");

25. Consultas
public class User extends RealmObject {
...
private RealmList<Email> emails;
...
}
public class Email extends RealmObject {
...
private boolean active;
...
}
RealmResults<Contact> contacts = realm.where(Contact.class)
.equalTo("emails.active", true)
.findAll();
public class User extends RealmObject {
...
private RealmList<Email> emails;
...
}
public class Email extends RealmObject {
...
private boolean active;
...
}
RealmResults<Contact> contacts = realm.where(Contact.class)
.equalTo("emails.active", true)
.equalTo("emails.active", false)
.findAll();

26. Tips & Tricks - Consultas
Cuidado com o nome das propriedades na hora de
filtrar para evitar erros de digitação.
Só é possível ordenar utilizando os campos que
estão no modelo de retorno.
Não é possível fazer GROUP BY como é feito no
SQL.
Todas as consultas são LAZY.

27. Removendo da Base

28. Remoção
// Remover o objeto de um resultado.
result.remove(0);
result.removeLast();
// Remover um objeto específico.
User usuario = result.get(5);
usuario.removeFromRealm();
// Remover todos os objetos de um resultado.
result.clear();

29. Utilitários
Integrando com a Aplicação

30. Utilitários
Notificações
Migrações
Criptografia
RealmBaseAdapter

31. Integração
com outras
bibliotecas
Parceler
Robolectric

32. Geral

33. Tips & Tricks - Geral
public abstract class AbstractRealmPersistenceService {
private Context context;
private Realm realm;
private int currentThreadId;
public AbstractRealmPersistenceService(Context context) {
this(context, null);
}
public AbstractRealmPersistenceService(Context context, Realm realm) {
this.context = context;
this.realm = realm;
this.currentThreadId = android.os.Process.myTid();
}
protected Realm getRealm() {
this.reloadRealm();
return this.realm;
}
private void reloadRealm() {
int threadId = android.os.Process.myTid();
if(this.currentThreadId != threadId || this.realm == null) {
this.realm = Realm.getInstance(this.context);
this.currentThreadId = threadId;
}
}
}

34. Tips & Tricks - Geral
Cuidado com a transição entre Threads, principalmente
se você faz operações em Background.

35. Dúvidas?
Pedro Salomão
@ppgsalomao

36. Obrigado!
Estamos contratando!
Pedro Salomão
@ppgsalomao
ppgsalomao@gmail.com / pedro@onyo.com