Pacote io.realm

Interface RealmCollection<E>

  • Parâmetros do tipo:
    E - tipo de RealmObject armazenado na collection.
    Todas as interfaces:
    Collection<E>, io.realm.internal.Freezable<RealmCollection<E>>, Iterable<E>, io.realm.internal.ManageableObject
    Todas as subinterfaces conhecidas:
    OrderedRealmCollection<E>
    Todas as classes de implementação conhecidas:
    OrderedRealmCollectionSnapshot, RealmList, RealmResults, RealmSet

    public interface RealmCollection<E>
    extends Collection<E>, io.realm.internal.ManageableObject, io.realm.internal.Freezable<RealmCollection<E>>
    RealmCollection é a raiz da hierarquia de collection que o Realm suporta. Define operações em collection de dados e o comportamento que elas terão em todas as implementações de RealmCollections.

    As collection Realm são visualizações "ativas" dos dados subjacentes. Isso significa que eles serão automaticamente mantidos atualizados. Como consequência, o uso de métodos como Collections.unmodifiableCollection(Collection) não impedirá que uma collection seja modificada.

    • Detalhes do método

      • ONDE

        RealmQuery < E > onde ()
        Retorna um RealmQuery , que pode ser utilizado para fazer query de objetos específicos desta coleção.
        Retorna:
        um objeto RealmQuery.
        Lançamentos:
        IllegalStateException - se a Instância de Realm tiver sido fechada ou as query não estiverem disponíveis de outra forma.
        Veja também:
        RealmQuery
      • min

        @Nullable
        Número min( String fieldName)
        Localiza o valor mínimo de um campo.
        Parâmetros:
        fieldName - o campo para procurar um mínimo. Somente campos numéricos são permitidos.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como o valor para o campo fornecido, null será retornado. Caso contrário, o valor mínimo é devolvido. Ao determinar o valor mínimo, os objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for um tipo de número.
        IllegalStateException - se o Realm tiver sido fechado ou chamado de um tópico incorreto.
      • max

        @Nullable
        Número máximo (String fieldName)
        Localiza o valor máximo de um campo.
        Parâmetros:
        fieldName - o campo para procurar um máximo. Somente campos numéricos são permitidos.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como o valor para o campo fornecido, null será retornado. Caso contrário, o valor máximo é retornado. Ao determinar o valor máximo, os objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for um tipo de número.
        IllegalStateException - se o Realm tiver sido fechado ou chamado de um tópico incorreto.
      • soma

        Soma do número (String fieldName)
        Calcula a soma de um determinado campo.
        Parâmetros:
        fieldName - o campo a ser somado. Somente campos numéricos são permitidos.
        Retorna:
        a soma. Se não existirem objetos ou todos eles tiverem null como o valor para o campo fornecido, 0 será retornado. Ao calcular a soma, objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for um tipo de número.
        IllegalStateException - se o Realm tiver sido fechado ou chamado de um tópico incorreto.
      • média

        média dupla (String fieldName)
        Retorna a média de um determinado campo.
        Parâmetros:
        fieldName - o campo para calcular a média. Somente campos numéricos são permitidos.
        Retorna:
        a média do campo fornecido entre os objetos nos resultados da query. Isso será do tipo double para todos os tipos de campos numéricos. Se não existirem objetos ou todos eles tiverem null como o valor para o campo fornecido, 0 será retornado. Ao calcular a média, objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se o campo não for um tipo de número.
        IllegalStateException - se o Realm tiver sido fechado ou chamado de um tópico incorreto.
      • maxDate

        @Nullable
        Date maxDate( String fieldName)
        Encontra a data máxima.
        Parâmetros:
        fieldName - o campo para procurar a data máxima. Se fieldName não for do tipo Date, uma exceção será lançada.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como valor para o campo de data fornecido, null será retornado. Caso contrário, a data máxima é retornada. Ao determinar a data máxima, os objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se fieldName não for um campo de data.
        IllegalStateException - se o Realm tiver sido fechado ou chamado de um tópico incorreto.
      • minDate

        @Nullable
        Data minDate (String fieldName)
        Encontra a data mínima.
        Parâmetros:
        fieldName - o campo para procurar a data mínima. Se fieldName não for do tipo Date, uma exceção será lançada.
        Retorna:
        se não existirem objetos ou se todos eles tiverem null como valor para o campo de data fornecido, null será retornado. Caso contrário, a data mínima é retornada. Ao determinar a data mínima, os objetos com valores null são ignorados.
        Lançamentos:
        IllegalArgumentException - se fieldName não for um campo de data.
        IllegalStateException - se o Realm tiver sido fechado ou chamado de um tópico incorreto.
      • deleteAllFromRealm

        boolean deleteAllFromRealm()
        Isso exclui todos os objetos da collection do Realm subjacente e da collection.
        Retorna:
        true se os objetos foram excluídos, false caso contrário.
        Lançamentos:
        IllegalStateException - se o Realm correspondente estiver fechado ou em um thread incorreto.
        IllegalStateException - se o Realm tiver sido fechado ou chamado de um tópico incorreto.
      • isLoaded

        boolean isLoaded()
        Verifica se uma collection já terminou de carregar seus dados.
        Retorna:
        true se os dados tiverem sido carregados e estiverem disponíveis, false se os dados ainda estiverem sendo carregados.
      • carregar

        boolean load()
        Bloqueia a collection até que todos os dados estejam disponíveis.
        Retorna:
        true se os dados puderem ser carregados com sucesso, false caso contrário.
      • é válido

        boolean isValid()
        Verifica se a collection ainda é válida para uso, ou seja, a instância Realm não foi fechada. Ele sempre retornará true para uma coleção não gerenciada.
        Especificado por:
        isValid na interface io.realm.internal.ManageableObject
        Retorna:
        true se ainda for válido para usar ou uma collection não gerenciada, false caso contrário.
      • isManaged

        boolean isManaged()
        Verifica se a collection é managed pelo Realm. Uma managed collection é apenas um invólucro que envolve os dados no Arquivo de Realm subjacente. Nos threads do loop de eventos, uma managed collection será atualizada ao vivo para que sempre ponto para os dados mais recentes. As managed collection são confinadas por threads para que não possam ser acessadas de outros threads além daquele que as criou.

        Se esse método retornar false, a collection não será gerenciada. Uma collection não gerenciada é apenas uma Java collection normal, portanto, não será atualizada em tempo real.

        Especificado por:
        isManaged na interface io.realm.internal.ManageableObject
        Retorna:
        true se este for um RealmCollection managed, false caso contrário.
      • contém

        boolean contém(objeto @Nullable
                         Object )
        Testa se este Collection contém o objeto especificado. Retorna true se e somente se pelo menos um elemento elem neste Collection atender ao seguinte requisito: (object==null ? elem==null : object.equals(elem)).
        Especificado por:
        contains na interface Collection<E>
        Parâmetros:
        object - o objeto a ser pesquisado.
        Retorna:
        true se o objeto for um elemento deste Collection, false caso contrário.
        Lançamentos:
        NullPointerException - se o objeto a procurar for null e este Collection não suportar elementos null .