クラス RealmList

指定したオブジェクトをこのリストの末尾に追加します。

1. 非管理の Realmlist : 管理対象と非管理の両方のオブジェクトを追加できます。 管理対象のオブジェクトを管理されていない RealmList に追加した場合、その後 Realm. copyToRealm(RealmModel, ImportFlag...)を使用すると、それらは Realm に再度コピーされることはありません。

2. 管理対象 RealmList : すでに管理されている RealmList に管理されていないオブジェクトを追加できます。 その場合、プライマリキーがある場合、オブジェクトは Realm . copyToRealm（RealmModel, ImportFlag...）またはRealm . copyToRealmOrUpdate（RealmModel, ImportFlag...）を使用して Realm に透過的にコピーされます。

パラメーター

• object - 追加するオブジェクト。

戻り値

は常にtrueです。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、親オブジェクトが削除されている場合。

の上書き

add クラス 抽象化リスト 内

指定されたオブジェクトを指定された場所にあるこのリストに挿入します。 オブジェクトは、指定された場所にある前の要素の前に挿入されます。 場所がこのリストのサイズと等しい場合、オブジェクトは末尾に追加されます。

1. 非管理の Realmlist : 管理対象と非管理の両方のオブジェクトを追加できます。 管理対象のオブジェクトを管理されていない RealmList に追加した場合、その後 Realm. copyToRealm(RealmModel, ImportFlag...)を使用すると、それらは Realm に再度コピーされることはありません。

2. 管理対象 RealmList : すでに管理されている RealmList に管理されていないオブジェクトを追加できます。 その場合、プライマリキーがある場合、オブジェクトは Realm . copyToRealm（RealmModel, ImportFlag...）またはRealm . copyToRealmOrUpdate（RealmModel, ImportFlag...）を使用して Realm に透過的にコピーされます。

パラメーター

• location - 挿入するインデックス。

• element - 追加する要素。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、コンテナ オブジェクトが削除されている場合。

• IndexOutOfBoundsException - if location < 0 || location > size() .

の上書き

add クラス 抽象化リスト 内

このRealmListに変更リスナーを追加します。

変更リスナーを登録しても、基礎となる RealmList がガベージ されるのを防ぐものではありません。 RealmList がガベージコレクションされている場合、変更リスナーはトリガーされなくなります。 これを回避するには、クラス変数内で適切な例がある限り、強力な参照を保持します。

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

パラメーター

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

スロー

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

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

このRealmListに変更リスナーを追加します。

変更リスナーを登録しても、基礎となる RealmList がガベージ されるのを防ぐものではありません。 RealmList がガベージコレクションされている場合、変更リスナーはトリガーされなくなります。 これを回避するには、クラス変数内で適切な例がある限り、強力な参照を保持します。

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

パラメーター

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

スロー

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

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

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

RealmList が更新されるにつれて RealmList は継続的に出力されます - onCompleteは呼び出されません。

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

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

list.asChangesetObservable()
 .observeOn(Schedulers.computation())
 .map((rxList, changes) -> doExpensiveWork(rxList, changes))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

戻り値

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

スロー

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

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

この RealmList への変更を監視する Rx Flowable を返します。 サブスクライブすると、現在の RealmList が発行されます。 RealmList が更新されるにつれて RealmList は継続的に出力されます - onCompleteは呼び出されません。

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

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

list.asFlowable()
 .observeOn(Schedulers.computation())
 .map(rxResults -> doExpensiveWork(rxResults))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

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

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

戻り値

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

スロー

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

指定されたフィールドの平均を返します。

戻り値

クエリ結果内のオブジェクト内の特定のフィールドの平均。 これは、すべての型の数値フィールドで double 型になります。 オブジェクトが存在しない場合、または指定されたフィールドの値としてnullが含まれている場合は、 0が返されます。 平均を計算する場合、 null値を持つオブジェクトは無視されます。

このリストからすべての要素を削除し、空にします。 このメソッドは、Realm からオブジェクトを削除しません。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、親オブジェクトが削除されている場合。

の上書き

clear クラス 抽象化リスト 内

Realm にアタッチされた場合、リストに指定された要素が含まれている場合はtrueを返します。 このメソッドは、基礎となるネイティブ Realm ストレージ エンジンをクエリして、指定された要素を迅速に見つけます。

リストが Realm にアタッチされていない場合、デフォルトの List.contains(Object) 実装が発生します。

パラメーター

• object - このリスト内の存在をテストする要素。

戻り値

true このリストに指定された要素が含まれている場合は、それ以外の場合falseです。

の上書き

contains クラス 抽象コレクション 内

このOrderedRealmCollectionからスナップショットを作成します。

戻り値

このコレクションのスナップショット。

これにより、コレクション内のすべてのオブジェクトが基礎の Realm と コレクションから削除されます。

戻り値

true オブジェクトが削除された場合は 、それ以外の場合はfalse 。

Realm から最初のオブジェクトを削除します。 これにより、このコレクションからそのファイルも削除されます。

戻り値

true オブジェクトが削除された場合は 、それ以外の場合はfalse 。

Realm から最後のオブジェクトを削除します。 これにより、このコレクションからそのファイルも削除されます。

戻り値

true オブジェクトが削除された場合は 、それ以外の場合はfalse 。

コレクションから最初のオブジェクトを取得します。 コレクションが空の場合は、指定されたデフォルトが代わりに使用されます。

戻り値

最初のオブジェクトまたは指定されたデフォルトの 。

コレクションから最初のオブジェクトを取得します。

戻り値

最初のオブジェクト。

このリスト内の指定された場所にある要素を返します。

パラメーター

• location - 返す要素のインデックス。

戻り値

指定されたインデックスの要素。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、親オブジェクトが削除されている場合。

• IndexOutOfBoundsException - if location < 0 || location >= size() .

の上書き

get クラス 抽象化リスト 内

このコレクションが属するRealmインスタンスを返します。

返された インスタンスでRealm.close()を呼び出すことは、元の Realm インスタンスで呼び出すのと同じであるため、Realm がリストの無効化を完全に閉じる可能性があるため推奨されません。

戻り値

Realmインスタンスこのコレクションは、コレクションが管理されていない場合は またはnullに属します。

スロー

• IllalStateException - Realm が DateRealm のインスタンスであるか、 Realm がすでに閉じられている場合。

コレクションがデータのロードをまだ完了しているかどうかを確認します。

戻り値

true データがロードされ、利用可能な場合は 、データがまだロード中の場合はfalseになります。

コレクションが Realm によって管理されているかどうかを確認します。 マネージド コレクションは、基礎となる Realm ファイル内のデータを囲むラッパーに相当します。 ルーパー スレッドでは、管理対象のコレクションがライブアップデートされるため、常に最新データを参照します。 管理されたコレクションはスレッド制限され、作成したコレクション以外のスレッドからはアクセスできません。このメソッドがfalseを返す場合、コレクションは管理されません。 管理されていないコレクションは通常の Java コレクションであるため、ライブ更新はされません。

戻り値

true これが管理対象のRealmCollectionである場合は 、それ以外の場合はfalseです。

コレクションがまだ使用可能かどうか、つまりio.realm.Realmインスタンスが閉じられていないかどうかを確認します。 管理されていないコレクションでは常にtrueが返されます。

戻り値

true または管理されていないコレクションを使用するためにまだ有効な場合は 、それ以外の場合はfalseです。

の上書き

iterator クラス 抽象化リスト 内

コレクションから最後のオブジェクトを取得します。 コレクションが空の場合は、指定されたデフォルトが代わりに使用されます。

戻り値

最後の オブジェクトまたは指定されたデフォルトの 。

コレクションから最後のオブジェクトを取得します。

戻り値

最後のオブジェクト。

の上書き

listIterator クラス 抽象化リスト 内

の上書き

listIterator クラス 抽象化リスト 内

すべてのデータが利用可能になるまでコレクションをブロックします。

戻り値

true データを正常に読み込むことができた場合は 、そうでない場合はfalse 。

フィールドの最大値を検索します。

戻り値

オブジェクトが存在しない場合、または特定のフィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最大値が返されます。 最大値を決定する際、 null値を持つオブジェクトは無視されます。

最大日付を検索します。

戻り値

オブジェクトが存在しない場合、または特定の日付フィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最大日付が返されます。 最大日付を決定する際、 null値を持つオブジェクトは無視されます。

フィールドの最小値を検索します。

戻り値

オブジェクトが存在しない場合、または特定のフィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最小値が返されます。 最小値を決定する場合、 null値を持つオブジェクトは無視されます。

最小日付を検索します。

戻り値

オブジェクトが存在しない場合、または特定の日付フィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最小日付が返されます。 最小日付を決定する場合、 null値を持つオブジェクトは無視されます。

固定サイズのリストを維持しながら、オブジェクトをある位置から別の位置に移動します。 RealmObject はシフトされ、 null値は導入されません。

パラメーター

• oldPos - 移動する RealmObject のインデックス。

• newPos - ターゲット位置。 newPos が oldPos より小さい場合、ロケーションにあるオブジェクトは右に移動されます。 oldPos oldPos は左側に 1 回シフトされます。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、親オブジェクトが削除されている場合。

• java.lang.IndexOutOfBoundsException - いずれかの位置が [0 , size()] の外部にある場合。

指定されたオブジェクトの 1 つのインスタンスが含まれている場合は、このCollectionから 1 つのインスタンスを削除します。 この実装では、このCollectionを反復処理し、イテレータによって返される各要素eをテストし、 eが指定されたオブジェクトと等しいかどうかを確認します。 object != nullの場合、このテストはobject.equals(e)を使用して実行され、それ以外の場合はobject == nullを使用します。 指定されたオブジェクトと等しい要素が見つかった場合、イテレータ上でremoveメソッドが呼び出され、 trueが返されます（それ以外の場合はfalse 。 イテレータが要素の削除をサポートしていない場合、 UnsupportedOperationExceptionがスローされます。

パラメーター

• object - 削除するオブジェクト。

戻り値

true このCollectionが変更されている場合は 、それ以外の場合はfalseになります。

スロー

• ClassCastException - 渡されたオブジェクトが正しい型でない場合。

• NullPointerException -object がnull の場合。

の上書き

remove クラス 抽象コレクション 内

指定した場所にあるオブジェクトをこのリストから削除します。

パラメーター

• location - 削除するオブジェクトのインデックス。

戻り値

削除されたオブジェクト。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、親オブジェクトが削除されている場合。

• IndexOutOfBoundsException - if location < 0 || location >= size() .

の上書き

remove クラス 抽象化リスト 内

指定されたCollection内の各オブジェクトのこのCollection内のすべての発生を削除します。 このメソッドが渡されたCollection内のどの要素も返さない後、このCollectionでは見つからなくなります。

この実装ではCollectionを反復処理し、イテレータによって返される各要素eをテストし、指定されたCollectionに含まれているかどうかをテストします。 このテストが正の場合、 removeメソッドがイテレータで呼び出されます。

パラメーター

• collection - 削除するオブジェクトのコレクション。

戻り値

true このCollectionが変更されている場合は 、それ以外の場合はfalseになります。

スロー

• ClassCastException - の 1collection つ以上の要素が正しい型でない場合。

• NullPointerException -collection がnull の場合。

の上書き

removeAll クラス 抽象コレクション 内

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

スロー

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

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

パラメーター

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

スロー

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

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

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

パラメーター

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

スロー

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

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

このリスト内の指定された場所にある要素を指定されたオブジェクトで置き換えます。

1. 非管理の Realmlist : 管理対象と非管理の両方のオブジェクトを追加できます。 管理対象のオブジェクトを管理されていない RealmList に追加した場合、その後 Realm. copyToRealm(RealmModel, ImportFlag...)を使用すると、それらは Realm に再度コピーされることはありません。

2. 管理対象 RealmList : すでに管理されている RealmList に管理されていないオブジェクトを追加できます。 その場合、プライマリキーがある場合、オブジェクトは Realm . copyToRealm（RealmModel, ImportFlag...）またはRealm . copyToRealmOrUpdate（RealmModel, ImportFlag...）を使用して Realm に透過的にコピーされます。

パラメーター

• location - 指定されたオブジェクトを配置するインデックス。

• object - 追加するオブジェクト。

戻り値

インデックスにある前の要素。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、親オブジェクトが削除されている場合。

• IndexOutOfBoundsException - if location < 0 || location >= size() .

の上書き

set クラス 抽象化リスト 内

このList内の要素の数を返します。

戻り値

このList内の要素の数。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、親オブジェクトが削除されている場合。

の上書き

size クラス 抽象コレクション 内

指定されたフィールドとソート順序に基づいてコレクションをソートします。

戻り値

新しいソートされたRealmResultが作成され、返されます。 元のコレクションは変更されません。

指定されたフィールドとソート順序に基づいてコレクションをソートします。

戻り値

新しいソートされたRealmResultが作成され、返されます。 元のコレクションは変更されません。

指定されたフィールドとソート順序に基づいてコレクションをソートします。

戻り値

新しいソートされたRealmResultが作成され、返されます。 元のコレクションは変更されません。

指定された フィールドに基づいてコレクションを昇順でソートします。

戻り値

新しいソートされたRealmResultが作成され、返されます。 元のコレクションは変更されません。

指定された フィールドの合計を計算します。

戻り値

の合計。 オブジェクトが存在しない場合、または指定されたフィールドの値としてnullが含まれている場合は、 0が返されます。 合計を計算する場合、 null値を持つオブジェクトは無視されます。

の上書き

toString クラス 抽象コレクション 内

RealmQuery を返します。これは、このクラスの特定のオブジェクトをクエリするために使用できます。

戻り値

RealmQuery オブジェクト。

スロー

• IllalStateException - Realm インスタンスが閉じられているか、親オブジェクトが削除されている場合。