CRUD - Java SDK

쓰기 작업

영역에서 객체를 생성 하고, 객체를 업데이트 하고, 최종적으로 영역에서 객체를 삭제할 수 있습니다. 이러한 작업은 영역의 상태를 수정하기 때문에 쓰기 작업이라고 합니다.

Realm은 트랜잭션 측면에서 쓰기를 처리합니다. 트랜잭션은 Realm이 분할할 수 없는 단일 작업으로 처리하는 읽기 및 쓰기 작업 목록입니다. 다시 말해, 트랜잭션은 전부 아니면 아무것도 아닙니다: 트랜잭션의 모든 작업이 성공하거나 트랜잭션의 작업 중 어느 것도 적용되지 않습니다.

영역은 한 번에 하나의 쓰기 트랜잭션 (write transaction)만 허용합니다. Realm은 열린 트랜잭션이 완료될 때까지 다른 스레드에서 다른 쓰기를 차단합니다. 따라서 트랜잭션 내의 영역에서 값을 읽을 때 경쟁 상태가 없습니다.

트랜잭션이 완료되면 Realm은 트랜잭션을 커밋 하거나 취소 합니다.

• Realm은 트랜잭션을 커밋 하면 모든 변경 사항을 디스크에 씁니다. 동기화된 영역의 경우 Realm은 Atlas App Services와의 동기화를 위해 변경 사항을 대기열에 넣습니다.

• Realm이 쓰기 트랜잭션(write transaction)을 취소 하거나 트랜잭션 작업에서 오류가 발생하면 모든 변경 사항이 삭제(또는 "롤백")됩니다.

SyncConfiguration config = new SyncConfiguration.Builder(app.currentUser(), PARTITION)
        .allowQueriesOnUiThread(true)
        .allowWritesOnUiThread(true)
        .build();
Realm.getInstanceAsync(config, new Realm.Callback() {
    @Override
    public void onSuccess(Realm realm) {
        Log.v(
                "EXAMPLE",
                "Successfully opened a realm with reads and writes allowed on the UI thread."
        );
    }
});

val config = SyncConfiguration.Builder(app.currentUser(), PARTITION)
    .allowQueriesOnUiThread(true)
    .allowWritesOnUiThread(true)
    .build()
Realm.getInstanceAsync(config, object : Realm.Callback() {
    override fun onSuccess(realm: Realm) {
        Log.v("EXAMPLE", "Successfully opened a realm with reads and writes allowed on the UI thread.")
    }
})

managed 객체

managed 객체 는 Realm의 기본 데이터 변경에 따라 업데이트되는 live Realm 객체입니다. managed 객체는 열린 영역에서만 가져올 수 있으며 해당 영역이 열려 있는 한 업데이트를 받습니다. managed 객체 는 스레드 간에 전달할 수 없습니다.

관리되지 않는 객체

관리되지 않는 객체 는 라이브가 아닌 Realm 객체의 인스턴스입니다. Realm 객체를 수동으로 생성하거나 Realm.copyFromRealm() 을 호출하여 관리되지 않는 객체를 가져올 수 있습니다. 관리되지 않는 객체 는 스레드 간에 전달될 수 있습니다.

트랜잭션 실행

Realm은 각 트랜잭션을 0개 이상의 읽기 및 쓰기 작업을 포함하는 콜백 함수로 나타냅니다. 트랜잭션을 실행하려면 트랜잭션 콜백을 정의하고 이를 영역의 write 메서드에 전달하세요. 이 콜백 내에서 영역에서 자유롭게 만들고, 읽고, 업데이트하고, 삭제할 수 있습니다. Realm에서 콜백의 코드가 실행할 때 예외가 발생하면 Realm은 트랜잭션을 취소합니다. 그렇지 않으면 Realm은 콜백 직후 트랜잭션을 커밋합니다.

realm.executeTransaction(r -> {
    // Create a turtle enthusiast named Ali.
    TurtleEnthusiast ali = r.createObject(TurtleEnthusiast.class, new ObjectId());
    ali.setName("Ali");
    // Find turtles younger than 2 years old
    RealmResults<Turtle> hatchlings = r.where(Turtle.class).lessThan("age", 2).findAll();
    // Give all hatchlings to Ali.
    hatchlings.setObject("owner", ali);
});

realm.executeTransaction { r: Realm ->
    // Create a turtle enthusiast named Ali.
    val ali = r.createObject(TurtleEnthusiast::class.java, ObjectId())
    ali.name = "Ali"
    // Find turtles younger than 2 years old
    val hatchlings =
        r.where(Turtle::class.java).lessThan("age", 2).findAll()
    // Give all hatchlings to Ali.
    hatchlings.setObject("owner", ali)
}