帮助
- 编程问题？询问StackOverflow, 我们会积极地监督和回答问题！
- 提交Bug？ 在我们的repo打开一个问题。 如果可以的话，请告知我们Realm版本，完整日志，Realm文件和显示问题的项目。
- 功能请求？ 在我们的repo打开一个问题。 告诉我们该功能应该做什么，以及为什么需要该功能。
- 想了解接下来我们会更新什么内容？ 看看我们的changelog。 日志显示我们计划最近发布的最新添加和更改，以及Realm的发展历史。
模型
Realm model类都是RealmObject的子类
public class User extends RealmObject {
private String name;
private int age;
@Ignore
private int sessionId;
// Standard getters & setters generated by your IDE…
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
public int getSessionId() { return sessionId; }
public void setSessionId(int sessionId) { this.sessionId = sessionId; }
}一个Realm Model类同样支持public,protected,private字段和自定义方法
public class User extends RealmObject {
public String name;
public boolean hasLongName() {
return name.length() > 7;
}
@Override
public boolean equals(Object o) {
// Custom equals comparison
}
}字段类型
Realm支持以下字段类型：boolean，byte，short，int，long，float，double，String，Date和byte []。 整数类型byte，short，int和long都在Realm中映射到相同的类型（实际上是long）。 此外，RealmObject和RealmList
必填字段和空值
在某些情况下，null不是字段的适当值。 @Required注解可以用于告诉Realm强制执行检查以禁止空值。 只有布尔值，字节，短整型，整数，长整数，浮点型，双精度型，字符串型，字节型[]和日期可以注解为必填。 其他类型的字段具有@Required注解时，编译将失败。 原始类型和RealmList类型的字段默认就是必填的。 RealmObject类型的字段始终可空的。
忽略属性
注解@Ignore意味着一个字段不应该持久化到磁盘。 如果你的输入包含的字段多于模型的字段，并且你不希望有很多特殊情况来处理这些未使用的数据字段，则忽略字段很有用。
自动更新对象
RealmObjects是实时的，自动更新视图到底层数据，这意味着对象不必被刷新。 修改影响查询的对象将立即反映在结果中。
realm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
Dog myDog = realm.createObject(Dog.class);
myDog.setName("Fido");
myDog.setAge(1);
}
});
Dog myDog = realm.where(Dog.class).equalTo("age", 1).findFirst();
realm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
Dog myPuppy = realm.where(Dog.class).equalTo("age", 1).findFirst();
myPuppy.setAge(2);
}
});
myDog.getAge(); // => 2所有RealmObject和RealmResults的这个属性不仅保持了Realm的快速和高效，而且它允许你的代码更简单，更灵活。 例如，如果你的Activity或Fragment依赖于特定的RealmObject或RealmResults实例，则在更新UI之前不必担心刷新或重新获取它。
你可以订阅Realm通知，以了解Realm数据何时更新，指示应用的UI应该何时刷新
索引属性
注解@Index将向字段添加搜索索引。 这将使插入速度更慢，数据文件更大，但查询速度更快。 因此，建议只在优化读取性能的特定情况时添加索引。 我们支持索引：String，byte，short，int，long，boolean和Date字段。
主键
要将字段提升为主键，请使用注解@PrimaryKey，字段类型必须要么是string（String），要么就是整数（byte，short，int或long）及其封装类（Byte，Short，Integer和Long）。不能使用多个字段（复合键）作为主键。使用字符串字段作为主键意味着字段被索引（注释@PrimaryKey隐式地设置注解@Index）。
使用主键后，我们可以使用copyToRealmOrUpdate（）方法使用此主键查找现有对象，如果找到，则更新它;如果没有找到，它将创建一个新的对象。在没有主键的类上调用copyToRealmOrUpdate（）时，将抛出异常。
使用主键对性能有影响。创建和更新对象会有点慢，而查询预计会有点快。由于性能的变化取决于数据集的大小，因此很难给出明确的数值。
当调用Realm.createObject（）时，它将返回一个新对象，所有字段都设置为默认值。在这种情况下，可能与主键字段为默认值的现有对象存在冲突。为了避免这种情况，建议创建一个非托管对象，设置字段的值，然后通过copyToRealm（）方法将其复制到Realm。
final MyObject obj = new MyObject();
obj.setId(42);
obj.setName("Fish");
realm.executeTransaction(new Realm.Transaction() {
@Override
public void execute(Realm realm) {
// This will create a new object in Realm or throw an exception if the
// object already exists (same primary key)
// realm.copyToRealm(obj);
// This will update an existing object with the same primary key
// or create a new object if an object with no primary key = 42
realm.copyToRealmOrUpdate(obj);
}
});对于string（String）和封装 整型（Byte，Short，Integer和Long），主键可以具有null值，除非@PrimaryKey与@Required配合使用。
自定义对象
我们几乎可以RealmObjects当作POJO来使用。 继承自RealmObject，我们可以设置public 字段，并使用简单的赋值，而不是setter和getter。 这样的模型类的一个例子是
public class Dog extends RealmObject {
public String name;
public int age;
}你可以像任何其他类一样使用Dog。 为了在Realm中创建受管理的Dog对象，可以使用createObject（）或copyToRealm（）方法。
realm.executeTransaction(new Realm.Transaction() {
@Overrride
public void execute(Realm realm) {
Dog dog = realm.createObject(Dog.class);
dog.name = "Fido";
dog.age = 5;
}
};你可以添加逻辑到你的setters和getters如果更好地满足你的需要。 如果你希望在将值存储在Realm之前验证值，这可能很有用。 此外，你可以轻松地添加自定义方法到RealmObjects。
限制
目前不支持final，transient 和volatile 字段。 这主要是为了避免对象如何由Realm管理或不受管理的行为之间的差异。
Realm Model类不允许继承除RealmObject之外的任何其他对象。 如果要声明构造函数，默认构造函数（没有参数的构造函数）必须始终为空。 原因是默认的构造函数会调用假定存在Realm实例的方法。 但是这个实例不是在创建者返回之前创建的。 你也可以自己添加构造函数。
Realm Model 接口
另一种继承RealmObject的方法是实现RealmModel接口并添加@RealmClass注解
@RealmClass
public class User implements RealmModel {
}RealmObject上可用的所有方法都可以通过静态方法使用。
// With RealmObject
user.isValid();
user.addChangeListener(listener);
// With RealmModel
RealmObject.isValid(user);
RealmObject.addChangeListener(user, listener);
Relationships原文链接
https://realm.io/docs/java/latest/#getting-help