クラス RealmObject

値フィールドまたは参照された RealmObject フィールドが変更された場合、または RealmList フィールド自体が変更された場合にトリガーされる 変更リスナー を RealmObject に追加します。変更リスナーを登録しても、基礎となる RealmObject がガベージ コレクションされるのを妨げるものではありません。 RealmObject がガベージ コレクションされると、変更リスナーはトリガーされなくなります。 これを回避するには、クラス変数内で適切な例がある限り、強力な参照を保持します。

public class MyActivity extends Activity {
    private Person person; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      person = realm.where(Person.class).findFirst();
      person.addChangeListener(new RealmChangeListener<Person>() {
          @Override
          public void onChange(Person person) {
              // React to change
          }
      });
    }
}

パラメーター

• object - リスナーを追加する RealmObject。

• listener - 通知される変更リスナー。

スロー

• IllialArgmentException - がobject nullまたは非管理オブジェクトである場合、または変更リスナーがnull の場合。

• IllalStateException - 非 loader または IntentService スレッドからリスナーを追加しようとする場合。

• IllalStateException - トランザクション内にリスナーを追加しようとする場合。

RealmObject に 変更リスナー を追加して、変更に関する詳細情報を取得します。 リスナーは、値フィールドもしくは参照された RealmObject フィールドが変更された場合、または RealmList フィールド自体が変更された場合にトリガーされます。変更リスナーを登録しても、基礎となる RealmObject がガベージ コレクションされるのを妨げるものではありません。 RealmObject がガベージ コレクションされると、変更リスナーはトリガーされなくなります。 これを回避するには、クラス変数内で適切な例がある限り、強力な参照を保持します。

public class MyActivity extends Activity {
    private Person person; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      person = realm.where(Person.class).findFirst();
      person.addChangeListener(new RealmObjectChangeListener<Person>() {
          @Override
          public void onChange(Person person, ObjectChangeSet changeSet) {
              // React to change
          }
      });
    }
}

パラメーター

• object - リスナーを追加する RealmObject。

• listener - 通知される変更リスナー。

スロー

• IllialArgmentException - がobject nullまたは非管理オブジェクトである場合、または変更リスナーがnull の場合。

• IllalStateException - 非 loader または IntentService スレッドからリスナーを追加しようとする場合。

• IllalStateException - トランザクション内にリスナーを追加しようとする場合。

この Realm。 RealmObject がガベージ コレクションされると、変更リスナーはトリガーされなくなります。 これを回避するには、クラス変数内で適切な例がある限り、強力な参照を保持します。

public class MyActivity extends Activity {
    private Person person; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      person = realm.where(Person.class).findFirst();
      person.addChangeListener(new RealmChangeListener<Person>() {
          @Override
          public void onChange(Person person) {
              // React to change
          }
      });
    }
}

パラメーター

• listener - 通知される変更リスナー。

スロー

• IllialArgmentException - 変更リスナーがnull であるか、 オブジェクトが非管理オブジェクトである場合。

• IllalStateException - 非 loader または IntentService スレッドからリスナーを追加しようとする場合。

• IllalStateException - トランザクション内にリスナーを追加しようとする場合。

この RealmObject に 変更リスナー を追加して、変更に関する詳細情報を取得します。 リスナーは、値フィールドもしくは参照された RealmObject フィールドが変更された場合、または RealmList フィールド自体が変更された場合にトリガーされます。変更リスナーを登録しても、基礎となる RealmObject がガベージ コレクションされるのを妨げるものではありません。 RealmObject がガベージ コレクションされると、変更リスナーはトリガーされなくなります。 これを回避するには、クラス変数内で適切な例がある限り、強力な参照を保持します。

public class MyActivity extends Activity {
    private Person person; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      person = realm.where(Person.class).findFirst();
      person.addChangeListener(new RealmObjectChangeListener<Person>() {
          @Override
          public void onChange(Person person, ObjectChangeSet changeSet) {
              // React to change
          }
      });
    }
}

パラメーター

• listener - 通知される変更リスナー。

スロー

• IllialArgmentException - 変更リスナーがnull であるか、 オブジェクトが非管理オブジェクトである場合。

• IllalStateException - 非 loader または IntentService スレッドからリスナーを追加しようとする場合。

• IllalStateException - トランザクション内にリスナーを追加しようとする場合。

この RealmObject への変更を監視する Rx Observable を返します。 サブスクライブすると、現在の RealmObject が発行されます。 RealmObject への更新ごとに、 RealmObjectと Object ChangeSet で構成されるペアが送信されます。 RealmObject が初めて発行されるときに、変更セットはnullになります。

RealmObject は更新されるたびに継続的に出力されます。 onCompleteは呼び出されません。

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

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

obj.asChangesetObservable()
 .observeOn(Schedulers.computation())
 .map((rxObj, changes) -> doExpensiveWork(rxObj, changeså))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

パラメーター

• object - 監視されている RealmObject クラス。 このクラスまたはそのスーパータイプである必要があります。

戻り値

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

スロー

• UnsupportedOperationException - 必要な RxJava フレームワークがクラスパスにない場合、または対応する Realm インスタンスが RxJava をサポートしていない場合。

• IllalStateException - Realm が Double スレッドで開かれていない場合。

この RealmObject への変更を監視する Rx Observable を返します。 サブスクライブすると、現在の RealmObject が発行されます。 RealmObject への更新ごとに、 RealmObjectと Object ChangeSet で構成されるペアが送信されます。 RealmObject が初めて発行されるときに、変更セットはnullになります。

RealmObject は更新されるたびに継続的に出力されます。 onCompleteは呼び出されません。

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

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

obj.asChangesetObservable()
 .observeOn(Schedulers.computation())
 .map((rxObj, changes) -> doExpensiveWork(rxObj, changeså))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

戻り値

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

スロー

• UnsupportedOperationException - 必要な RxJava フレームワークがクラスパスにない場合、または対応する Realm インスタンスが RxJava をサポートしていない場合。

• IllalStateException - Realm が Double スレッドで開かれていない場合。

この RealmObject への変更を監視する RxJava フロー可能を返します。 サブスクライブすると、現在のオブジェクトが発行されます。 RealmObject が更新されると、オブジェクトの更新が継続的に発行されます - onCompleteは呼び出されません。

RealmObject Observable を連鎖させる場合、 obj.<MyRealmObjectClass>asFlowable()を使用して型情報を渡します。それ以外の場合、次の観察可能な値の型はRealmObjectになります。

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

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

obj.asFlowable()
 .observeOn(Schedulers.computation())
 .map((rxObj) -> doExpensiveWork(rxObj))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

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

obj.asFlowable()
     .filter(obj -> obj.isLoaded())
     .first()
     .subscribe( ... ) // You only get the object once

パラメーター

• object - 監視されている RealmObject クラス。 このクラスまたはそのスーパータイプである必要があります。

戻り値

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

スロー

• UnsupportedOperationException - 必要な RxJava フレームワークがクラスパスにない場合。

• IllalStateException - Realm が Double スレッドで開かれていない場合。

この RealmObject への変更を監視する RxJava フロー可能を返します。 サブスクライブすると、現在のオブジェクトが発行されます。 RealmObject が更新されると、オブジェクトの更新が継続的に発行されます - onCompleteは呼び出されません。

RealmObject フローを連鎖させる場合、 obj.<MyRealmObjectClass>asFlowable()を使用して型情報を渡します。それ以外の場合、次の観察可能な値の型はRealmObjectになります。

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

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

obj.asFlowable()
 .observeOn(Schedulers.computation())
 .map((rxObj) -> doExpensiveWork(rxObj))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

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

obj.asFlowable()
     .filter(obj -> obj.isLoaded())
     .first()
     .subscribe( ... ) // You only get the object once

型パラメータ

• E - 監視されている RealmObject クラス。 このクラスまたはそのスーパータイプである必要があります。

戻り値

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

スロー

• UnsupportedOperationException - 必要な RxJava フレームワークがクラスパスにない場合、または対応する Realm インスタンスが RxJava をサポートしていない場合。

• IllalStateException - Realm が Double スレッドで開かれていない場合。

現在関連付けられている Realm からオブジェクトを削除します。このメソッドが呼び出されると、オブジェクトは無効になり、そのオブジェクトで実行されたすべての操作（読み取りまたは書込み）は IllealStateException で失敗します。

スロー

• IllalStateException - 対応する Realm が閉じているか、誤ったスレッドにある場合。

現在関連付けられている Realm からオブジェクトを削除します。このメソッドが呼び出されると、オブジェクトは無効になり、そのオブジェクトで実行されたすべての操作（読み取りまたは書込み）は IllealStateException で失敗します。

スロー

• IllalStateException - 対応する Realm が閉じているか、誤ったスレッドにある場合。

このオブジェクトの固定スナップショットを返します。 固定されたコピーは、 IllialStateException をスローすることなく、任意のスレッドから読み取りとクエリが可能 。

RealmObject を固定すると、独自のライフサイクルを持つ固定 Realm も作成されますが、元のコレクションを生成したライブ Realm が完全に閉じている場合（つまり 全スレッドにわたるすべての インスタンスが閉じられます）。固定された Realm と オブジェクトも閉じられます。

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

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

戻り値

このオブジェクトの固定されたコピー。

スロー

• IllalStateException - このメソッドが書込みトランザクション内から呼び出される場合。

このオブジェクトの固定スナップショットを返します。 固定されたコピーは、 IllialStateException をスローすることなく、任意のスレッドから読み取りとクエリが可能 。

RealmObject を固定すると、独自のライフサイクルを持つ固定 Realm も作成されますが、元のコレクションを生成したライブ Realm が完全に閉じている場合（つまり 全スレッドにわたるすべての インスタンスが閉じられます）。固定された Realm と オブジェクトも閉じられます。

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

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

戻り値

このオブジェクトの固定されたコピー。

スロー

• IllalStateException - このメソッドが書込みトランザクション内から呼び出される場合。

は、 modelが属するRealmインスタンスを返します。

Realm.close()は呼び出しないでください。 返されたインスタンスに対して。

パラメーター

• model - DeploymentObject 以外の RealmModel インスタンス。

戻り値

modelが属するRealmインスタンス、またはmodelが管理されていない場合はnull 。

スロー

• IllialArgmentException - がmodel nullの場合。

• IllalStateException - がmodel DeploymentRealmObject のインスタンスであるか、このオブジェクトがすでに削除されているか、対応する Realm がすでに閉じられている場合。

この RealmObject が属する Realm インスタンスを返します。

Realm.close()は呼び出しないでください。 返されたインスタンスに対して。

戻り値

このオブジェクトが属するRealmインスタンス、またはこのオブジェクトが管理されていない場合はnull 。

スロー

• IllalStateException - このオブジェクトが DeploymentRealmObject のインスタンスであるか、このオブジェクトがすでに削除されているか、対応する Realm がすでに閉じられている場合。

この RealmObject が固定されているかどうかを返します。

戻り値

true RealmObject が固定されている場合は 、固定されていない場合はfalseになります。

この RealmObject が固定されているかどうかを返します。

戻り値

true RealmObject が固定されている場合は 、固定されていない場合はfalseになります。

この RealmObject を検索するために使用されたクエリが完了しているかどうかを確認します。 RealmQuery.findFirstAsync() などの非同期メソッドは、 RealmQuery の将来の結果を表す RealmObject を返します。java.uty.concurrent.feature は、 この点では 。

isLoaded()がtrueを返すと、クエリでクエリ パラメータに一致するオブジェクトが見つからなかった場合でも、 オブジェクトはクエリ結果を表します。 この場合、 RealmObjectは "null" オブジェクトになります。

「Null」オブジェクトはnullを表します。 いずれかのアクセスサーが呼び出された場合は例外がスローされるため、メソッドを呼び出す前にはisValid()も確認することが重要です。 一般的なパターンは次のとおりです。

Person person = realm.where(Person.class).findFirstAsync();
RealmObject.isLoaded(person); // == false
RealmObject.addChangeListener(person, new RealmChangeListener() {
     @Override
     public void onChange(Person person) {
         RealmObject.isLoaded(person); // always true here
         if (RealmObject.isValid(person)) {
             // It is safe to access the person.
         }
     }
});

同期 RealmObject は定義上、このメソッドはそれらに対して常にtrueを返します。 このメソッドは、管理対象ではないオブジェクト（Realm 外で作成）で呼び出されるとtrueを返します。

パラメーター

• object - 確認する RealmObject。

戻り値

true クエリが完了した場合は 、クエリが進行中の場合はfalseになります。

この RealmObject を検索するために使用されたクエリが完了しているかどうかを確認します。 RealmQuery.findFirstAsync() などの非同期メソッドは、 RealmQuery の将来の結果を表す RealmObject を返します。java.uty.concurrent.feature は、 この点では 。

isLoaded()がtrueを返すと、クエリでクエリ パラメータに一致するオブジェクトが見つからなかった場合でも、 オブジェクトはクエリ結果を表します。 この場合、 RealmObjectは "null" オブジェクトになります。

「Null」オブジェクトはnullを表します。 いずれかのアクセスサーが呼び出された場合は例外がスローされるため、メソッドを呼び出す前にはisValid()も確認することが重要です。 一般的なパターンは次のとおりです。

Person person = realm.where(Person.class).findFirstAsync();
person.isLoaded(); // == false
person.addChangeListener(new RealmChangeListener() {
     @Override
     public void onChange(Person person) {
         person.isLoaded(); // Always true here
         if (person.isValid()) {
             // It is safe to access the person.
         }
     }
});

同期 RealmObject は定義上、このメソッドはそれらに対して常にtrueを返します。 このメソッドは、管理対象ではないオブジェクト（Realm 外で作成）で呼び出されるとtrueを返します。

戻り値

true クエリが完了した場合は 、クエリが進行中の場合はfalseになります。

このオブジェクトが Realm によって管理されているかどうかを確認します。 管理対象オブジェクトは、基礎となる Realm ファイル内のデータを囲むラッパーに相当します。 ルーパー スレッドでは、管理対象のオブジェクトがライブアップデートされるため、常に最新データを参照します。 addCheckLister(RealmModel, RealmchangeLister)を使用して変更リスナーを登録し、変更が発生したときに通知を受けることができます。 管理されたオブジェクトはスレッド制限され、作成されたオブジェクト以外の他のスレッドからはアクセスできません。

このメソッドがfalseを返す場合、オブジェクトは管理されていません。 管理されていない オブジェクトは通常の Java オブジェクトであるため、スレッド間で自由に解析できますが、オブジェクト内のデータは基礎となる Realm に接続されていないため、ライブ更新はされません。

Realm. copyToRealm(RealmModel, ImportFlag...)を使用して、管理されていないオブジェクトから管理されたオブジェクトを作成することができます。 Realm. copyFromRealm(RealmModel)を使用して、管理対象オブジェクトから管理されていないオブジェクトを作成できます。

戻り値

true オブジェクトが管理されている場合は 、管理されていない場合はfalseになります。

このオブジェクトが Realm によって管理されているかどうかを確認します。 管理対象オブジェクトは、基礎となる Realm ファイル内のデータを囲むラッパーに相当します。 ルーパー スレッドでは、管理対象のオブジェクトがライブアップデートされるため、常に最新データを参照します。 addCheckLister(RealmchangeLister)を使用して変更リスナーを登録し、変更が発生したときに通知を受けることができます。 管理されたオブジェクトはスレッド制限され、作成されたオブジェクト以外の他のスレッドからはアクセスできません。

このメソッドがfalseを返す場合、オブジェクトは管理されていません。 管理されていない オブジェクトは通常の Java オブジェクトであるため、スレッド間で自由に解析できますが、オブジェクト内のデータは基礎となる Realm に接続されていないため、ライブ更新はされません。

Realm. copyToRealm(RealmModel, ImportFlag...)を使用して、管理されていないオブジェクトから管理されたオブジェクトを作成することができます。 Realm. copyFromRealm(RealmModel)を使用して、管理対象オブジェクトから管理されていないオブジェクトを作成できます。

戻り値

true オブジェクトが管理されている場合は 、管理されていない場合はfalseになります。

RealmObject がまだ を使用するために有効であるかどうか、つまり RealmObject が削除されておらず、 io.realm.Realmが閉じられていないことを確認します。 管理されていないオブジェクトでは常にtrueが返されます。

パラメーター

• object - 有効性を確認する RealmObject。

戻り値

true オブジェクトがまだアクセス可能であるか、管理されていないオブジェクトである場合は、 false 、それ以外の場合は 。

RealmObject がまだ を使用するために有効であるかどうか、つまり RealmObject が削除されておらず、 io.realm.Realmが閉じられていないことを確認します。 管理されていないオブジェクトでは常にtrueが返されます。

これは、観察された場合にnullであるなど、特定の条件の有効性を確認するために使用できることに注意してください。

realm.where(BannerRealm.class).equalTo("type", type).findFirstAsync().asFlowable()
     .filter(result.isLoaded() && result.isValid())
     .first()

戻り値

true オブジェクトがまだアクセス可能であるか、管理されていないオブジェクトである場合は、 false 、それ以外の場合は 。

非同期クエリをブロック化します。 これにより、登録されているリスナーも trigger されます。注意: これは、アンマネージドオブジェクト(Realmの外部で作成されたオブジェクト)に対して呼び出された場合、 true を返します。

パラメーター

• object - 負荷を強制するための RealmObject。

戻り値

true クエリが正常に完了した場合は、 false 、そうでない場合は になります。

非同期クエリをブロック化します。 これにより、登録されているリスナーも trigger されます。注意: これは、アンマネージドオブジェクト(Realmの外部で作成されたオブジェクト)に対して呼び出された場合、 true を返します。

戻り値

true クエリが正常に完了した場合は、 false 、そうでない場合は になります。

指定された RealmObject から登録されたすべてのリスナーを削除します。

パラメーター

• object - すべてのリスナーを削除する RealmObject。

スロー

• IllialArgmentException - オブジェクトが であるか、null Realm によって管理されていない場合。

指定された RealmObject に以前に登録されたリスナーを削除します。

パラメーター

• object - リスナーから削除する RealmObject。

• listener - 削除する インスタンス。

スロー

• IllialArgmentException -object または変更リスナーがnull の場合。

• IllialArgmentException - オブジェクトが管理されていない RealmObject の場合。

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

指定された RealmObject に以前に登録されたリスナーを削除します。

パラメーター

• object - リスナーから削除する RealmObject。

• listener - 削除する インスタンス。

スロー

• IllialArgmentException -object または変更リスナーがnull の場合。

• IllialArgmentException - オブジェクトが管理されていない RealmObject の場合。

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

以前に登録されたリスナーを削除します。

パラメーター

• listener - 削除する インスタンス。

スロー

• IllialArgmentException - 変更リスナーがnull であるか、 オブジェクトが非管理オブジェクトである場合。

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

以前に登録されたリスナーを削除します。

パラメーター

• listener - 削除する インスタンス。

スロー

• IllialArgmentException - 変更リスナーがnull であるか、 オブジェクトが非管理オブジェクトである場合。

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