패키지 io.realm

인터페이스 RealmCollection<E>

  • 유형 매개변수:
    E - collection에 저장된 RealmObject 유형입니다.
    모든 슈퍼인터페이스:
    Collection<E>, io.realm.internal.Freezable<RealmCollection<E>>, Iterable<E>, io.realm.internal.ManageableObject
    알려진 모든 하위 인터페이스:
    OrderedRealmCollection<E>
    알려진 모든 구현 클래스:
    OrderedRealmCollectionSnapshot, RealmList, RealmResults, RealmSet
    public interface RealmCollection<E>
extends Collection<E>, io.realm.internal.ManageableObject, io.realm.internal.Freezable<RealmCollection<E>>
    RealmCollection Realm이 지원하는 컬렉션 계층 구조의 루트입니다. 데이터 collection에 대한 연산과 RealmCollection의 모든 구현에서 수행할 동작을 정의합니다.

    Realm 컬렉션은 기본 데이터에 대한 '라이브' 뷰입니다. 즉, 자동으로 최신 상태로 유지됩니다. 따라서 Collections.unmodifiableCollection(Collection) 과 같은 메서드를 사용해도 컬렉션 수정이 방지되지는 않습니다.

    • 메서드 세부 정보

      • 위치

        RealmQuery<E> where()
        이 컬렉션에서 특정 객체를 쿼리하는 데 사용할 수 있는 RealmQuery 를 반환합니다.
        반환합니다:
        RealmQuery 객체
        예외 처리:
        IllegalStateException - Realm 인스턴스가 닫혔거나 쿼리를 사용할 수 없는 경우
        다음도 참조하세요.
        RealmQuery

      • min

        @Nullable
최소 숫자 ​(문자열 필드 이름)
        필드의 최소값을 찾습니다.
        매개변수:
        fieldName - 최소값을 찾을 필드입니다. 숫자 필드만 지원됩니다.
        반환합니다:
        객체가 없거나 지정된 필드의 값으로 객체가 모두 null 있는 경우 null 가 반환됩니다. 그렇지 않으면 최소값이 반환됩니다. 최소값을 결정할 때 null 값을 가진 객체는 무시됩니다.
        예외 처리:
        IllegalArgumentException - 필드가 숫자 유형이 아닌 경우.
        IllegalStateException - Realm이 닫혔거나 잘못된 스레드에서 호출된 경우

      • 최대

        @Nullable
최대 숫자 ​(문자열 필드 이름)
        필드의 최대값을 찾습니다.
        매개변수:
        fieldName - 최대값을 찾을 필드입니다. 숫자 필드만 지원됩니다.
        반환합니다:
        객체가 없거나 지정된 필드의 값으로 객체가 모두 null 있는 경우 null 가 반환됩니다. 그렇지 않으면 최대값이 반환됩니다. 최대값을 결정할 때 null 값을 가진 객체는 무시됩니다.
        예외 처리:
        IllegalArgumentException - 필드가 숫자 유형이 아닌 경우.
        IllegalStateException - Realm이 닫혔거나 잘못된 스레드에서 호출된 경우

      • 합계

        숫자 합계​(문자열 필드 이름)
        지정된 필드의 합계를 계산합니다.
        매개변수:
        fieldName - 합계할 필드입니다. 숫자 필드만 지원됩니다.
        반환합니다:
        합계. 객체가 없거나 지정된 필드의 값으로 모두 null 가 있는 경우 0 가 반환됩니다. 합계를 계산할 때 null 값을 가진 객체는 무시됩니다.
        예외 처리:
        IllegalArgumentException - 필드가 숫자 유형이 아닌 경우.
        IllegalStateException - Realm이 닫혔거나 잘못된 스레드에서 호출된 경우

      • 평균

        이중 평균​(String fieldName)
        지정된 필드의 평균을 반환합니다.
        매개변수:
        fieldName - 평균을 계산할 필드입니다. 숫자 필드만 지원됩니다.
        반환합니다:
        쿼리 결과에 있는 객체 중 지정된 필드에 대한 평균입니다. 이 필드는 모든 유형의 숫자 필드에 대해 double 유형이 됩니다. 객체가 없거나 지정된 필드의 값으로 모두 null 가 있는 경우 0 가 반환됩니다. 평균을 계산할 때 null 값을 가진 객체는 무시됩니다.
        예외 처리:
        IllegalArgumentException - 필드가 숫자 유형이 아닌 경우.
        IllegalStateException - Realm이 닫혔거나 잘못된 스레드에서 호출된 경우

      • maxDate

        @Nullable
날짜 maxDate(문자열 fieldName)
        최대 날짜를 찾습니다.
        매개변수:
        fieldName - 최대 날짜를 찾을 필드입니다. fieldName이 날짜 유형이 아닌 경우 예외가 발생합니다.
        반환합니다:
        객체가 없거나 지정된 날짜 필드의 값으로 객체가 모두 null 있는 경우 null 가 반환됩니다. 그렇지 않으면 최대 날짜가 반환됩니다. 최대 날짜를 결정할 때 null 값을 가진 객체는 무시됩니다.
        예외 처리:
        IllegalArgumentException - fieldName이 날짜 필드가 아닌 경우.
        IllegalStateException - Realm이 닫혔거나 잘못된 스레드에서 호출된 경우

      • minDate

        @Nullable
날짜 minDate​(문자열 fieldName)
        최소 날짜를 찾습니다.
        매개변수:
        fieldName - 최소 날짜를 찾을 필드입니다. fieldName이 날짜 유형이 아닌 경우 예외가 발생합니다.
        반환합니다:
        객체가 없거나 지정된 날짜 필드의 값으로 객체가 모두 null 있는 경우 null 가 반환됩니다. 그렇지 않으면 최소 날짜가 반환됩니다. 최소 날짜를 결정할 때 null 값을 가진 객체는 무시됩니다.
        예외 처리:
        IllegalArgumentException - fieldName이 날짜 필드가 아닌 경우.
        IllegalStateException - Realm이 닫혔거나 잘못된 스레드에서 호출된 경우

      • deleteAllFromRealm

        부울 deleteAllFromRealm()
        이렇게 하면 collection뿐만 아니라 기본 Realm에서도 collection의 모든 객체가 삭제됩니다.
        반환합니다:
        true 객체가 삭제된 경우 false , 그렇지 않으면 입니다.
        예외 처리:
        IllegalStateException - 해당 Realm이 닫혔거나 잘못된 스레드에 있는 경우
        IllegalStateException - Realm이 닫혔거나 잘못된 스레드에서 호출된 경우

      • isLoaded

        부울 isLoaded()
        collection이 아직 데이터 로드를 완료했는지 확인합니다.
        반환합니다:
        true 데이터가 로드되어 사용 가능한 경우 false , 데이터가 아직 로드 중인 경우.

      • 로드

        boolean load()
        모든 데이터를 사용할 수 있을 때까지 collection을 차단합니다.
        반환합니다:
        true 데이터를 성공적으로 로드할 수 있으면 false 을 반환합니다.

      • isValid

        부울 isValid()
        collection이 여전히 사용하기에 유효한지, 즉 Realm 인스턴스가 닫히지 않은지 확인합니다. 관리되지 않는 collection에 대해서는 항상 true 을(를) 반환합니다.
        다음에 의해 지정됩니다:
        isValid 인터페이스에서 io.realm.internal.ManageableObject
        반환합니다:
        true 사용하기에 여전히 유효한 경우 또는 관리되지 않는 collection을 사용하는 경우, 그렇지 않으면 false 를 반환합니다.

      • isManaged

        부울 isManaged()
        collection이 Realm에서 managed 확인합니다. managed collection은 기본 Realm 파일의 데이터를 감싸는 래퍼에 불과합니다. 이벤트 루프 스레드에서 managed collection은 실시간으로 업데이트되어 항상 최신 데이터를 점합니다. managed collection은 스레드 제한되어 있으므로 collection을 만든 다른 스레드에서 액세스할 수 없습니다.

        이 메서드가 false 을(를) 반환하면 collection이 관리되지 않는 것입니다. 관리되지 않는 collection은 일반적인 Java collection이므로 실시간 업데이트가 제공되지 않습니다.

        다음에 의해 지정됩니다:
        isManaged 인터페이스에서 io.realm.internal.ManageableObject
        반환합니다:
        true managed RealmCollection 인 경우 그렇지 않으면 false 를 반환합니다.

      • contains

        부울에는 (@Nullable
                 Object 객체)가 포함됩니다.
        이 Collection 에 지정된 객체가 포함되어 있는지 테스트합니다. 이 Collection 의 요소 elem 중 하나 이상이 다음 요구 사항을 충족하는 경우에만 true 를 반환합니다: (object==null ? elem==null : object.equals(elem)).
        다음에 의해 지정됩니다:
        contains 인터페이스에서 Collection<E>
        매개변수:
        object - 검색할 객체입니다.
        반환합니다:
        true 객체가 이 Collection 의 요소이면 false , 그렇지 않으면 입니다.
        예외 처리:
        NullPointerException - 찾으려는 객체가 null 이고 이 Collection 가 null 요소를 지원하지 않는 경우.