Realm使用简介

参考：
官方文档：https://realm.io/docs/java/latest/#installation
API：https://realm.io/docs/java/latest/api/

配置要求

Android Studio >= 1.5.1
A recent version of the Android SDK.
JDK version >=7.
We support all Android versions since API Level 9(Android 2.3 Gingerbread & above).

1.在Android项目下面的第一级build.gradle文件中添加依赖

classpath "io.realm:realm-gradle-plugin:2.1.1"

示例：

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0'
        /*realm 配置这一行*/
        classpath "io.realm:realm-gradle-plugin:2.1.1"
    }
}
......

2.在第二级的build.gradle中使用插件

apply plugin: 'realm-android'

示例：

apply plugin: 'com.android.application'
/*realm 配置这一行*/
apply plugin: 'realm-android'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.3"

    defaultConfig {
        minSdkVersion 18
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}
......

3.完成1、2步骤之后，rebuild或者clean项目（./gradlew clean），然后在Application中进行初始化操作，话可以对realm进行配置

初始化：

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    //使用默认的配置
    Realm.init(this);
    RealmConfiguration config = new RealmConfiguration.Builder().build();
    Realm.setDefaultConfiguration(config);
  }
}

自定义配置：

// The RealmConfiguration is created using the builder pattern.
// The Realm file will be located in Context.getFilesDir() with name "myrealm.realm"
RealmConfiguration config = new RealmConfiguration.Builder()
  .name("myrealm.realm")
  .encryptionKey(getKey())
  .schemaVersion(42)
  .modules(new MySchemaModule())
  .migration(new MyMigration())
  .build();
// Use the config
Realm realm = Realm.getInstance(config);

Activity中使用：

public class MyActivity extends Activity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    Realm realm = Realm.getDefaultInstance();
    // ... Do something ...
    realm.close();//用完一定记得记得关闭realm
  }
}

4.示例代码：

//我们的实体类需要继承RealmObject
public class User extends RealmObject {
    //@PrimaryKey ：声明主键
    @PrimaryKey
    private int id;
    // @Required:会检查这个字段是否为空；
    //只有Boolean, Byte, Short, Integer, Long, Float, Double, String, byte[]，Date类型可以使用 @Required来标记；
    @Required
    private String          name;
    private int             age;
    // @Ignore ：建表时忽略这个字段，即数据库中不会存在这个属性
    @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; }
}

5.增删改查

• 增：

realm.beginTransaction();
User user = realm.createObject(User.class);
user.setName("John");
user.setEmail("john@corporation.com");
realm.commitTransaction();

User user = new User("John");
user.setEmail("john@corporation.com");

realm.beginTransaction();
User realmUser = realm.copyToRealm(user);
realm.commitTransaction();

• 删：

// obtain the results of a query
final RealmResults<Dog> results = realm.where(Dog.class).findAll();

// All changes to data must happen in a transaction
realm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        // remove single match
        results.deleteFirstFromRealm();
        results.deleteLastFromRealm();

        // remove a single object
        Dog dog = results.get(5);
        dog.deleteFromRealm();

        // Delete all matches
        results.deleteAllFromRealm();
    }
});

• 改：

RealmResults<User> r = realm.where(User.class)
                            .greaterThan("age", 10)  //implicit AND
                            .beginGroup()
                                .equalTo("name", "Peter")
                                .or()
                                .contains("name", "Jo")
                            .endGroup()
                            .findAll();

• 查：

// Build the query looking at all users:
RealmQuery<User> query = realm.where(User.class);

// Add query conditions:
query.equalTo("name", "John");
query.or().equalTo("name", "Peter");

// Execute the query:
RealmResults<User> result1 = query.findAll();

// Or alternatively do the same all at once (the "Fluent interface"):
RealmResults<User> result2 = realm.where(User.class)
                                  .equalTo("name", "John")
                                  .or()
                                  .equalTo("name", "Peter")
                                  .findAll();

6.还有很多很多功能可以参考官方说明：
https://realm.io/docs/java/latest/#getting-started