クラス Device Realm

Realm に変更リスナーを追加します。このスレッドまたは別のスレッドによって変更がコミットされたときにリスナーが実行されます。

Realmインスタンスはスレッドごとにキャッシュされます。そのため、排除するためには重要な注意点があります。メモリ リークが発生する可能性があります。

パラメーター

• listener - 変更リスナー。

スロー

• IllealArgmentException - 変更リスナーが null の場合。

この Realm への変更を監視する RxJava フロー可能を返します。 にサブスクライブすると、現在の状態が発行されます。 Realm が更新されるにつれてアイテムは継続的に出力されます。 onCompleteは呼び出されません。

Realm フロー可能な から出力されたアイテムは固定されます（ Releases ()を参照してください。 つまり、これらは不変で、どのスレッドでも読み取ることができます。

Realm フロー接続は、ライブ Realm を保持するスレッドから常にアイテムを出力します。 つまり、追加の処理が必要な場合は、計算スケジューラーで の値を確認することをお勧めします。

realm.asFlowable()
 .observeOn(Schedulers.computation())
 .map(rxRealm -> doExpensiveWork(rxRealm))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

asFlowable()で 項目の発行を停止する場合は、 first()演算子を使用して RxJava に最初の 項目のみを発行するように指示できます。

realm.asFlowable().first().subscribe( ... ); // You only get the results once

戻り値

RxJava Observable はonNextのみを呼び出します。 onCompleteまたはOnErrorは呼び出されません。

の上書き

asFlowable クラスbaseRealm 内

インスタンス化され、Realm に新しい埋め込みオブジェクトが追加されます。このメソッドは、埋め込みとしてマークされているタイプのオブジェクトを作成するためにのみ使用してください。

パラメーター

• className - 作成するオブジェクトのクラス名。

• parentObject - 埋め込みオブジェクトへの参照を保持する親オブジェクト。 親プロパティがリストの場合、埋め込みオブジェクトはそのリストの末尾に追加されます。

• parentProperty - 参照を保持する親クラスの プロパティ。

戻り値

新しく作成された埋め込みオブジェクト。

スロー

• IllealArメントException - clazz が埋め込みクラスではない場合、または親クラスのプロパティが適切な型のオブジェクトを保持できない場合。

指定されたプライマリキーを持つオブジェクトを作成します。プライマリキーが定義されていないクラスは、代わりに createObject(string) } を使用する必要があります。

戻り値

新しい オブジェクト。 すべてのフィールドにはそのタイプのデフォルト値が含まれます。ただし、指定された値を持つプライマリキー フィールドは除きます。

スロー

• RealmException - プライマリキーが無効であるためオブジェクトを作成できなかった場合。

• IllimalStateException - モデル クラスにプライマリキーが定義されていない場合。

• IllealArgmentException - primaryKeyValue に期待値に変換できる値がない場合。

インスタンス化して、新しいオブジェクトを Realm に追加します。

パラメーター

• className - 作成するオブジェクトのクラス名。

戻り値

新しい オブジェクト。

スロー

• RealmException - オブジェクトを作成できなかった場合。

指定されたクラスのすべてのオブジェクトを Realm から削除します。

パラメーター

• className - すべてのオブジェクトを削除するクラス。

スロー

• IllealStateException - Realmが閉じられている場合、または誤ったスレッドから呼び出された場合。

指定されたトランザクションを DeploymentRealm で実行します。 startTransaction( )とcommitTransaction()は自動的に呼び出されます。 トランザクション中に例外が発生した場合、 commitTransaction( ) ではなく、 CancelTransaction()が呼び出されます。

UIスレッドからこのメソッドを呼び出すと、 RealmException がスローされます。フレームワークが削除されるか、 ARN が発生する可能性があります。 このメソッドは 以外のUIから呼び出すか、 executionTransactionAsync(Transaction) を使用することをお勧めします。

パラメーター

• transaction - 実行するトランザクション。

スロー

• IllexalArgmentException - transaction が null の場合。

• RealmException - UI スレッドから呼び出された場合。ただし、 RealmConfiguration.Builder.allowWritesOnUiThread( ブール値)で明示的なオプトインが宣言されていない限り、 。

executionTransactionAsync(Transaction) と同様に、 OnSuccess および OnError コールバックも受け入れます。

パラメーター

• transaction - 実行するトランザクション。

• onSuccess - トランザクションが成功したときに呼び出されるコールバック。

• onError - トランザクションが失敗したときに呼び出されるコールバック。

戻り値

キャンセル可能なタスクを表すRealmAsyncTask 。

スロー

• IllealArgmentException - transaction が null の場合、または邦土が別のスレッドから開かれている場合。

executionTransactionAsync(Transaction) と同様ですが、 OnErrorコールバックも受け入れます。

パラメーター

• transaction - 実行するトランザクション。

• onError - トランザクションが失敗したときに呼び出されるコールバック。

戻り値

キャンセル可能なタスクを表すRealmAsyncTask 。

スロー

• IllealArgmentException - transaction が null の場合、または邦土が別のスレッドから開かれている場合。

executionTransactionAsync(Transaction) と同様ですが、 OnSuccessコールバックも受け入れます。

パラメーター

• transaction - 実行するトランザクション。

• onSuccess - トランザクションが成功したときに呼び出されるコールバック。

戻り値

キャンセル可能なタスクを表すRealmAsyncTask 。

スロー

• IllealArgmentException - transaction が null の場合、または邦土が別のスレッドから開かれている場合。

executionTransaction(Transaction) と同様ですが、ワーカー スレッド上で非同期に実行されます。

パラメーター

• transaction - 実行するトランザクション。

戻り値

キャンセル可能なタスクを表すRealmAsyncTask 。

スロー

• IllgealArgmentException - transaction が null の場合、またはRealmが別のスレッドから開かれている場合。

現在のRealmの固定スナップショットを返します。 This Realm は、 IllialStateException をスローすることなく、任意のスレッドから読み取りとクエリを実行できます。固定されたRealmには独自のライフサイクルがあり、close() を呼び出すことで閉じることができますが、固定されたコピーを生成したRealmを完全に閉じると、固定されたRealmも閉じられます。

凍結されたデータは通常どおりクエリできますが、そのデータを何らかの方法で変更しようとしたり、リスナーを登録しようとすると、 IllealStateException がスローされます。

注: 異なるバージョンを持つ多数の Realm を有効にすると、Realm のファイルサイズに悪影響が及ぶ可能性があります。 このような状況を回避するには、 RealmConfiguration.Builder.maxNumberOfActiveVersions(long)を設定できます。

戻り値

この Realm の固定コピー。

の上書き

freeze クラスbaseRealm 内

提供されたio.realm.RealmConfigurationによって定義された Realm インスタンスの動的バリアントを返す Realm 静的コンストラクター。 動的 Realm では schemaVersion とスキーマは管理されないため、Device Realm を開きても移行はtriggerされません。

戻り値

構成によって定義された 動的Realm 。

スロー

• RealmFileException - 基礎となる Realm ファイルにアクセスするときにエラーが発生した場合。

• IllexalArgmentException - configuration の引数が null の場合。

プロセス内のRealmConfigurationごとに最初の Realm インスタンスを作成するには、その時点ですべての初期化コードを実行する必要があるため、時間がかかる場合があります（Realm の設定、スキーマの検証、初期データの作成）。 このメソッドは初期化作業をバックグラウンド スレッドに配置し、初期化完了後に Realm インスタンスを呼び出し元のスレッドに非同期に配信します。

パラメーター

• configuration - Realm を開くために使用されるRealmConfiguration 。

• callback - 結果を返すために呼び出されます。

戻り値

キャンセル可能なタスクを表すRealmAsyncTask 。

スロー

• IllegalArgumentException - null RealmConfiguration または null コールバック が提供されている場合。

• IllealStateException - 非 Loader または Android から呼び出された場合。アプリ.IntentService スレッド。

この Realm の可変スキーマを返します。

戻り値

この Realm のRealmSchema 。

の上書き

getSchema クラスbaseRealm 内

このio.realm.Realmにオブジェクトが含まれているかどうかを確認します。

戻り値

true 空の場合は @{code false} を します。

の上書き

isEmpty クラスbaseRealm 内

ユーザー定義のすべての変更リスナーを削除します。

スロー

• IllealStateException - 非 ループ スレッドからリスナーを削除しようとする場合。

指定された変更リスナーを削除します。

パラメーター

• listener - 削除する変更リスナー。

スロー

• IllealArgmentException - 変更リスナーが null の場合。

• IllealStateException - 非 ループ スレッドからリスナーを削除しようとする場合。

指定されたクラスをクエリするために使用できる RealmQuery を返します。

パラメーター

• className - クエリ対象のオブジェクトのクラス。

戻り値

RealmQuery は、提供されたタイプの特定のオブジェクトをクエリするために使用できます。

スロー

• IllealArgmentException -クラスが存在しない場合。