kotlin-extensions / io.realm.kotlin / io.realm.RealmModel / freeze

동결

fun <T : RealmModel> RealmModel.freeze(): T

이 객체의 동결된 스냅샷을 반환합니다. 동결된 사본은 불법적인 상태 예외( IllegalStateException) 없이 모든 스레드에서 읽고 쿼리할 수 있습니다.

RealmModel을 동결하면 자체 라이프사이클이 있는 동결된 Realm 도 생성되지만, 원래 컬렉션 을 생성한 라이브 Realm 이 완전히 닫히면(예: 모든 스레드의 모든 인스턴스가 닫히면 동결된 Realm 과 객체 도 닫힙니다.

동결된 객체는 정상적으로 쿼리할 수 있지만 어떤 방식으로든 이를 변경하려고 하거나 리스너를 등록하려고 하면 불법적인 상태 예외( IllegalStateException)가 발생합니다.

참고: 버전이 다른 다수의 동결된 객체를 활성 상태로 유지하면 Realm의 파일 크기에 부정적인 영향을 미칠 수 있습니다. 이러한 상황을 방지하려면 io.realm.RealmConfiguration.Builder.maxNumberOfActiveVersions 를 설정할 수 있습니다.

예외

IllegalStateException - 이 메서드가 쓰기 트랜잭션(write transaction) 내부에서 호출된 경우.

Return
이 객체의 동결된 복사본입니다.