パッケージ io.realm

クラス順序<E>

  • すべての実装インターフェース:
    io.realm.internal.Freezable<RealmCollection<E>>, io.realm.internal.ManageableObject, OrderedRealmCollection<E>, RealmCollection<E>, Iterable<E>, Collection<E>, List<E>
    public class OrderedRealmCollectionSnapshot<E>
extends AbstractList<E>
    OrderedRealmCollectionSnapshotはOrderedRealmCollectionの特殊な型です。 これはOrderedRealmCollection.createSnapshot()を呼び出すことで作成できます。 RealmResultsやRealmListとは異なり、その要素のサイズと順序は作成後に変更されることはありません。

    OrderedRealmCollectionSnapshot は、単純なループ内でコレクションのサイズや順序に影響を与える可能性のある変更を行う場合に役立ちます。 例: 

     
 final RealmResults<Dog>  dogs = realm.where(Dog.class).findAll();
 final OrderedRealmCollectionSnapshot<Dog> snapshot = dogs.createSnapshot();
 final int dogsCount = snapshot.size(); // dogs.size() == snapshot.size() == 10
 realm.executeTransaction(new Realm.Transaction() {
     /@Override
     public void execute(Realm realm) {
         for (int i = 0; i < dogsCount; i++) {
         // This won't work since RealmResults is always up-to-date, its size gets decreased by 1 after every loop. An
         // IndexOutOfBoundsException will be thrown after 5 loops.
         // dogs.deleteFromRealm(i);
         snapshot.deleteFromRealm(i); // Deletion on OrderedRealmCollectionSnapshot won't change the size of it.
         }
     }
 });

    • フィールドの詳細

      • baseRealm

        public final io.realm.BaseRealm baseRealm
        このコレクションが存在するBaseRealmインスタンス。

        警告: このフィールドは内部使用でのみ公開されており、使用しないでください。

    • メソッドの詳細

      • サイズ

        public int size()
        このクエリ結果にある要素の数を返します。
        次のによって指定されます。
        size 内 インターフェース Collection<E>
        次のによって指定されます。
        size 内 インターフェース List<E>
        次の値を返します。
        このクエリ結果に含まれる要素の数。

      • sort

        public RealmResults<E> sort​(String fieldName)
        OrderedRealmCollectionSnapshotではサポートされていません。 代わりに、元のOrderedRealmCollectionで「sort()」を使用します。
        次のによって指定されます。
        sort 内 インターフェース OrderedRealmCollection<E>
        パラメーター:
        fieldName - 並べ替えるフィールド名。 ブール値、短縮、int、long、float、double、Date、string 型のフィールドのみがサポートされます。
        次の値を返します。
        新しいソートされたRealmResultsが作成され、返されます。 元のコレクションは変更されません。
        次の例外がスローされます。
        UnsupportedOperationException

      • sort

        public RealmResults<E> sort​(String fieldName,
                            Sort sortOrder)
        OrderedRealmCollectionSnapshotではサポートされていません。 代わりに、元のOrderedRealmCollectionで「sort()」を使用します。
        次のによって指定されます。
        sort 内 インターフェース OrderedRealmCollection<E>
        パラメーター:
        fieldName - 並べ替えるフィールド名。 ブール値、短縮、int、long、float、double、Date、string 型のフィールドのみがサポートされます。
        sortOrder - 並べ替える方向。
        次の値を返します。
        新しいソートされたRealmResultsが作成され、返されます。 元のコレクションは変更されません。
        次の例外がスローされます。
        UnsupportedOperationException

      • sort

        public RealmResults<E> sort​(String fieldName1,
                            Sort sortOrder1,
                            String fieldName2,
                            Sort sortOrder2)
        OrderedRealmCollectionSnapshotではサポートされていません。 代わりに、元のOrderedRealmCollectionで「sort()」を使用します。
        次のによって指定されます。
        sort 内 インターフェース OrderedRealmCollection<E>
        パラメーター:
        fieldName1 - 最初のフィールド名。 ブール値、短縮、int、long、float、double、Date、string 型のフィールドのみがサポートされます。
        sortOrder1 - 最初のフィールドのソート順。
        fieldName2 - 2 番目のフィールド名。 ブール値、短縮、int、long、float、double、Date、string 型のフィールドのみがサポートされます。
        sortOrder2 - 2 番目のフィールドのソート順序。
        次の値を返します。
        新しいソートされたRealmResultsが作成され、返されます。 元のコレクションは変更されません。
        次の例外がスローされます。
        UnsupportedOperationException

      • sort

        public RealmResults<E> sort​(String[] fieldNames,
                            Sort[] sortOrders)
        OrderedRealmCollectionSnapshotではサポートされていません。 代わりに、元のOrderedRealmCollectionで「sort()」を使用します。
        次のによって指定されます。
        sort 内 インターフェース OrderedRealmCollection<E>
        パラメーター:
        fieldNames - ソートするフィールド名の配列。 ブール値、短縮、int、long、float、double、Date、string 型のフィールドのみがサポートされます。
        sortOrders - 並べ替える方向。
        次の値を返します。
        新しいソートされたRealmResultsが作成され、返されます。 元のコレクションは変更されません。
        次の例外がスローされます。
        UnsupportedOperationException

      • isLoaded

        公開ブール値 isLoaded()
        コレクションがデータのロードをまだ完了しているかどうかを確認します。
        次の値を返します。
        true データがロードされ、利用可能な場合は 、データがまだロード中の場合はfalseになります。

      • 負荷

        public ブール値 load()
        すべてのデータが利用可能になるまでコレクションをブロックします。
        次の値を返します。
        true データを正常に読み込むことができた場合は 、そうでない場合はfalse 。

      • deleteFromRealm

        public void deleteFromRealm​(int location)
        指定されたインデックスにあるオブジェクトを Realm から削除します。 指定されたインデックスのオブジェクトは無効になります。 オブジェクトがすでに無効になっている場合は を返します。
        次のによって指定されます。
        deleteFromRealm 内 インターフェース OrderedRealmCollection<E>
        パラメーター:
        location - 削除するオブジェクトを識別する配列インデックス。
        次の例外がスローされます。
        IndexOutOfBoundsException - location < 0 || location >= size()の場合。
        IllegalStateException - Realm が閉じている場合、またはメソッドが間違ったスレッドから呼び出された場合。

      • deleteFirstFromRealm

        公開ブール値の deleteFirstFromRealm()
        Realm から最初のオブジェクトを削除します。 最初のオブジェクトは無効になります。
        次のによって指定されます。
        deleteFirstFromRealm 内 インターフェース OrderedRealmCollection<E>
        次の値を返します。
        true オブジェクトが削除された場合は 、それ以外の場合はfalse 。
        次の例外がスローされます。
        IllegalStateException - Realm が閉じている場合、またはメソッドが間違ったスレッドで呼び出された場合。

      • deleteLastFromRealm

        公開ブール値の deleteLastFromRealm()
        Realm から最後のオブジェクトを削除します。 最後のオブジェクトは無効になります。
        次のによって指定されます。
        deleteLastFromRealm 内 インターフェース OrderedRealmCollection<E>
        次の値を返します。
        true オブジェクトが削除された場合は 、それ以外の場合はfalse 。
        次の例外がスローされます。
        IllegalStateException - Realm が閉じている場合、またはメソッドが間違ったスレッドから呼び出された場合。

      • deleteAllFromRealm

        公開ブール値の deleteAllFromRealm()
        これにより、コレクション内のすべてのオブジェクトが基礎の Realm から削除されます。 コレクションのスナップショット内のすべてのオブジェクトが無効になります。
        次のによって指定されます。
        deleteAllFromRealm 内 インターフェース RealmCollection<E>
        次の値を返します。
        true オブジェクトが削除された場合は 、それ以外の場合はfalse 。
        次の例外がスローされます。
        IllegalStateException - 対応する Realm が閉じているか、誤ったスレッドにある場合。
        IllegalStateException - Realm が閉じられているか、誤ったスレッドから呼び出された場合。

      • IsFrozen

        公開ブール値 isFrozen()

      • isValid

        公開ブール値 isValid()
        コレクションがまだ使用可能かどうか、つまり、 Realmインスタンスが閉じられていないかどうかを確認します。 管理されていないコレクションでは常にtrueが返されます。
        次のによって指定されます。
        isValid 内 インターフェース io.realm.internal.ManageableObject
        次のによって指定されます。
        isValid 内 インターフェース RealmCollection<E>
        次の値を返します。
        true または管理されていないコレクションを使用するためにまだ有効な場合は 、それ以外の場合はfalseです。

      • に含まれる

        公開ブール値には が含まれます（ @Nullable Object object）
        このOrderedRealmCollectionで指定されたオブジェクトを検索します。
        次のによって指定されます。
        contains 内 インターフェース Collection<E>
        次のによって指定されます。
        contains 内 インターフェース List<E>
        次のによって指定されます。
        contains 内 インターフェース RealmCollection<E>
        上書き:
        contains クラス内 AbstractCollection<E>
        パラメーター:
        object - 検索するオブジェクト。
        次の値を返します。
        true objectがこのOrderedRealmCollectionの要素である場合は 、そうでない場合はfalseです。

      • 得る

        @Nullable public E get （intlocation）
        このリスト内の指定された場所にある要素を返します。
        次のによって指定されます。
        get 内 インターフェース List<E>
        次のによって指定されます。
        get クラス内 AbstractList<E>
        パラメーター:
        location - 返す要素のインデックス。
        次の値を返します。
        指定されたインデックスの要素。
        次の例外がスローされます。
        IndexOutOfBoundsException - location < 0 || location >= size()の場合。

      • 最初に

        @Nullable public E first()
        コレクションから最初のオブジェクトを取得します。
        次のによって指定されます。
        first 内 インターフェース OrderedRealmCollection<E>
        次の値を返します。
        最初のオブジェクト。

      • 最初に

        @Nullableパブリック E ファースト（ @Nullable E defaultValue）
        コレクションから最初のオブジェクトを取得します。 コレクションが空の場合は、指定されたデフォルトが代わりに使用されます。
        次のによって指定されます。
        first 内 インターフェース OrderedRealmCollection<E>
        次の値を返します。
        最初のオブジェクトまたは指定されたデフォルトの 。

      • last

        @Nullable public E last()
        コレクションから最後のオブジェクトを取得します。
        次のによって指定されます。
        last 内 インターフェース OrderedRealmCollection<E>
        次の値を返します。
        最後のオブジェクト。

      • last

        @Nullable public E last（ @Nullable E defaultValue）
        コレクションから最後のオブジェクトを取得します。 コレクションが空の場合は、指定されたデフォルトが代わりに使用されます。
        次のによって指定されます。
        last 内 インターフェース OrderedRealmCollection<E>
        次の値を返します。
        最後の オブジェクトまたは指定されたデフォルトの 。

      • イテレータ

        public Iterator<E> iterator()
        クエリの結果のイテレータを返します。 反復処理中に Realm に変更を加えると、アクセス時にこのイテレータはConcurrentModificationExceptionをスローします。
        次のによって指定されます。
        iterator 内 インターフェース Collection<E>
        次のによって指定されます。
        iterator 内 インターフェース Iterable<E>
        次のによって指定されます。
        iterator 内 インターフェース List<E>
        上書き:
        iterator クラス内 AbstractList<E>
        次の値を返します。
        このリストの要素のイテレータ。
        以下も参照してください。
        Iterator

      • listIterator

        public ListIterator<E> listIterator()
        クエリの結果のリスト イテレータを返します。 反復処理中に Realm を変更すると、アクセスされた場合にイテレータはConcurrentModificationExceptionをスローします。
        次のによって指定されます。
        listIterator 内 インターフェース List<E>
        上書き:
        listIterator クラス内 AbstractList<E>
        次の値を返します。
        このリストの要素に対する ListIterator 。
        以下も参照してください。
        ListIterator

      • listIterator

        public ListIterator<E> listIterator​(int location)
        クエリの結果のリスト イテレータを返します。 反復処理中に Realm を変更すると、アクセスされた場合にイテレータはConcurrentModificationExceptionをスローします。
        次のによって指定されます。
        listIterator 内 インターフェース List<E>
        上書き:
        listIterator クラス内 AbstractList<E>
        パラメーター:
        location - 反復を開始するインデックス。
        次の値を返します。
        このリストの要素に対する ListIterator 。
        次の例外がスローされます。
        IndexOutOfBoundsException - location < 0 || location > size()の場合。
        以下も参照してください。
        ListIterator

      • min

        public Number min（ string fieldName）
        フィールドの最小値を検索します。
        次のによって指定されます。
        min 内 インターフェース RealmCollection<E>
        パラメーター:
        fieldName - 最小を検索するフィールド。 数値フィールドのみがサポートされます。
        次の値を返します。
        オブジェクトが存在しない場合、または特定のフィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最小値が返されます。 最小値を決定する場合、 null値を持つオブジェクトは無視されます。

      • minDate

        public Date minDate （ string fieldName）
        最小日付を検索します。
        次のによって指定されます。
        minDate 内 インターフェース RealmCollection<E>
        パラメーター:
        fieldName - 最小日付を検索するフィールド。 fieldName が Date 型でない場合、例外がスローされます。
        次の値を返します。
        オブジェクトが存在しない場合、または特定の日付フィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最小日付が返されます。 最小日付を決定する場合、 null値を持つオブジェクトは無視されます。

      • 最大

        public Number max（ string fieldName）
        フィールドの最大値を検索します。
        次のによって指定されます。
        max 内 インターフェース RealmCollection<E>
        パラメーター:
        fieldName - の最大値を検索するフィールド。 数値フィールドのみがサポートされます。
        次の値を返します。
        オブジェクトが存在しない場合、または特定のフィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最大値が返されます。 最大値を決定する際、 null値を持つオブジェクトは無視されます。

      • 最大日付

        @Nullable public Date （ string fieldName）
        最大日付を検索します。
        次のによって指定されます。
        maxDate 内 インターフェース RealmCollection<E>
        パラメーター:
        fieldName - 最大日付を検索するフィールド。 fieldName が Date 型でない場合、例外がスローされます。
        次の値を返します。
        オブジェクトが存在しない場合、または特定の日付フィールドの値としてnullが含まれている場合は、 nullが返されます。 それ以外の場合は、最大日付が返されます。 最大日付を決定する際、 null値を持つオブジェクトは無視されます。
        次の例外がスローされます。
        IllegalArgumentException - fieldName が日付フィールドでない場合。

      • 合計

        public preview （ string fieldName）
        指定された フィールドの合計を計算します。
        次のによって指定されます。
        sum 内 インターフェース RealmCollection<E>
        パラメーター:
        fieldName - 合計するフィールド。 数値フィールドのみがサポートされます。
        次の値を返します。
        の合計。 オブジェクトが存在しない場合、または指定されたフィールドの値としてnullが含まれている場合は、 0が返されます。 合計を計算する場合、 null値を持つオブジェクトは無視されます。

      • 平均

        public double Average（ string fieldName）
        指定されたフィールドの平均を返します。
        次のによって指定されます。
        average 内 インターフェース RealmCollection<E>
        パラメーター:
        fieldName - 平均を計算するフィールド。 数値フィールドのみがサポートされます。
        次の値を返します。
        クエリ結果内のオブジェクト内の特定のフィールドの平均。 これは、すべての型の数値フィールドで double 型になります。 オブジェクトが存在しない場合、または指定されたフィールドの値としてnullが含まれている場合は、 0が返されます。 平均を計算する場合、 null値を持つオブジェクトは無視されます。

      • getRealm

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

        返されたインスタンスでCloseable.close()を呼び出すことは、元の Realm インスタンスで呼び出すのと同じであるため推奨されません。これにより、Realm はクエリ結果を無効にして、完全に閉じてしまう可能性があります。

        次の値を返します。
        Realm このコレクションが属する インスタンス。
        次の例外がスローされます。
        IllegalStateException - Realm がDynamicRealmのインスタンスであるか、 Realmがすでに閉じられている場合。