클래스 RealmConfiguration.Builder

UI 스레드에서 RealmQuery 를 실행할 수 있는지 여부를 설정합니다.

기본적으로 Realm은 메인 스레드에서 쿼리를 허용합니다. 그러나 이렇게 하면 애플리케이션에서 프레임 드롭이나 ANR이 발생할 수 있습니다. 쿼리를 UI가 아닌 스레드로 전환하거나 RealmQuery.findAllAsync () 또는 RealmQuery.findFirstAsync( ) 를 사용하는 것이 좋습니다.

UI 스레드에서 Realm.executeTransaction 에 대한 호출을 허용할지 여부를 설정합니다.

경고: Realm은 사용자가 이 메서드를 명시적으로 옵트인하지 않는 한 메인 스레드에서 동기 트랜잭션을 실행하는 것을 허용하지 않습니다. executeTransaction 에 대한 호출을 UI가 아닌 스레드로 전환하거나 Realm.executeTransactionAsync 를 사용하는 것이 좋습니다.

지정된 자산 파일 경로에서 Realm 파일을 복사합니다. Realm을 처음 열 때 빈 파일을 생성하는 대신 제공된 자산 파일에서 Realm 파일을 복사하여 대신 사용합니다.

deleteRealmIfMigrationNeeded() 와 함께 사용하면 복사된 파일이 삭제되기 때문에 이 기능을 사용할 수 없습니다.

경고: 이 작업은 시간이 오래 걸릴 수 있으므로 백그라운드 스레드에서 수행하는 것이 좋습니다.

매개변수

• assetFile - 자산 데이터베이스 파일의 경로입니다.

스로우

• 불법적인 상태예외 - deleteRealmIfMigrationNeeded() 를 호출하여 스키마를 지우도록 구성된 경우.

빌더 매개변수를 기반으로 RealmConfiguration을 생성합니다.

반환

생성된 RealmConfiguration .

사용자에게 반환되기 전에 Realm 파일을 압축해야 하는지 여부를 결정하기 위해 설정합니다. 총 파일 크기(데이터 + 여유 공간)와 파일의 데이터가 사용한 바이트가 전달됩니다.

매개변수

• compactOnLaunch - 프로세스 수명 동안 처음으로 Realm을 열 때 사용자에게 반환되기 전에 압축해야 하는지 여부를 결정하기 위해 호출되는 콜백입니다. 총 파일 크기(데이터 + 여유 공간)와 파일의 데이터가 사용한 바이트가 전달됩니다.

이 값을 설정하면 마이그레이션 예외가 처리되는 방식이 변경됩니다. io.realm.Exceptions.RealmMigrationneededException 을 발생시키는 대신 온디스크 Realm이 지워지고 새 Realm 스키마로 다시 생성됩니다.

제공된 자산 파일은 마이그레이션에서 삭제되므로 자산 파일 (string) 을 호출하여 자산 파일을 동시에 갖도록 구성할 수 없습니다.

경고! 이로 인해 데이터가 손실됩니다.

스로우

• 불법적인 상태 예외 - 이전에 자산 파일 ( ) 을 호출하여 자산 파일을 사용하도록 구성된 경우.string

Realm 파일이 저장될 디렉토리를 지정합니다. 기본값은 context.getFilesDir() 입니다. 디렉토리가 존재하지 않으면 디렉토리가 생성됩니다.

매개변수

• directory - Realm 파일을 저장할 디렉토리입니다. 디렉토리는 쓰기 가능해야 합니다.

스로우

• 불법적인 인수 예외 - directory 가 null인 경우, 쓰기 불가능하거나 파일입니다.

Realm 객체에서 코루틴 Flow를 만드는 데 사용되는 FlowFactory 를 설정합니다. 기본 팩토리는 RealmFlowFactory 입니다.

매개변수

• factory - 사용할 팩토리입니다.

io.realm.Realm 에 초기 데이터를 설정합니다. 이 트랜잭션은 데이터베이스 파일이 생성될 때 처음으로 실행되거나 Builder.deleteRealmIfMigrationNeeded() 가 설정된 경우 데이터를 마이그레이션하는 동안에만 실행됩니다.

매개변수

• transaction - 실행할 트랜잭션입니다.

IllegalStateException 이 발생하기 전에 Realm 파일의 최대 라이브 버전 수를 설정합니다. 더 많은 데이터를 쓰려고 할 때 발생합니다.

Realm은 다양한 버전의 Realm 객체를 동시에 처리할 수 있습니다. 예를 들면 다음과 같습니다. Realm이 여러 스레드에서 열려 있거나 데이터가 파일에 기록되는 동안 객체가 정지되는 경우에 발생합니다.

정상적인 상황에서는 문제가 되지 않지만 활성 버전 수가 너무 많아지면 디스크의 파일 크기에 부정적인 영향을 미칩니다. 따라서 이 매개변수를 설정하면 매우 큰 Realm이 발생할 수 있는 Realm 사용을 방지할 수 있습니다.

매개변수

• number - 예외가 발생하기 전의 최대 활성 버전 수입니다.

기존 모듈을 하나 이상의 RealmModule 로 대체합니다. 이 방법을 사용하면 이 Realm의 현재 스키마가 제공된 모듈에서 정의된 스키마로 대체됩니다.

프로젝트의 모든 Realm 클래스(종속성 제외)를 포함하는 기본 Realm 모듈에 대한 참고는 Realm.getDefaultModule() 을 사용하여 찾을 수 있습니다. 따라서 다음 코드를 사용하여 앱 프로젝트의 스키마와 라이브러리 종속성을 결합합니다.

builder.modules(Realm.getDefaultMode(), new MyLibraryModule());

매개변수

• baseModule - 첫 번째 Realm 모듈(필수).

• additionalModules - 추가 Realm 모듈

스로우

• 불법적인 인수 예외 - 모듈에 RealmModule 주석이 없는 경우.

이 값을 설정하면 Realm이 읽기 전용이 되며 이 Realm에 대한 모든 쓰기 트랜잭션(write transaction)이 실패하고 실패합니다(IllegalStateException ). .

이는 특히 initialData(Realm.Transaction) 가 읽기 전용 Realm과 함께 작동하지 않으며 이를 설정하면 불법적인 상태 예외(IllegalStateException )가 발생한다는 의미입니다. 던져지고 있습니다.

이 프로세스에서 Realm을 읽기 전용으로 표시하는 것은 Realm에만 적용됩니다. 다른 프로세스는 여전히 Realm에 쓸 수 있습니다.

Realm 객체에서 Rx Observable을 생성하는 데 사용되는 RxObservableFactory 를 설정합니다. 기본 팩토리는 RealmObservableFactory 입니다.

매개변수

• factory - 사용할 팩토리입니다.

Realm의 스키마 버전을 설정합니다. 이 값은 기존 Realm 파일의 스키마 버전과 동일하거나 그 이상이어야 합니다. 스키마 버전이 기존 Realm 보다 높은 경우 마이그레이션이 필요합니다.