Docs Menu

Docs Home → Develop Applications → Atlas Device SDKs

Class RealmSet

On this page

  • io.realm
  • Constructors
  • Method Summary
  • Inherited Methods
  • Constructor Detail
  • Method Detail
  • add
  • addAll
  • addChangeListener
  • average
  • clear
  • contains
  • containsAll
  • deleteAllFromRealm
  • freeze
  • getValueClass
  • getValueClassName
  • isEmpty
  • isFrozen
  • isLoaded
  • isManaged
  • isValid
  • iterator
  • load
  • max
  • maxDate
  • min
  • minDate
  • remove
  • removeAll
  • removeAllChangeListeners
  • removeChangeListener
  • retainAll
  • size
  • sum
  • toArray
  • where

io.realm

java.lang.Object
io.realm.RealmSet

Implemented interfaces:

RealmSet is a collection that contains no duplicate elements.Similarly to RealmList s, a RealmSet can operate in managed and unmanaged modes. In managed mode a RealmSet persists all its contents inside a Realm whereas in unmanaged mode it functions like a HashSet .

Managed RealmSets can only be created by Realm and will automatically update their content whenever the underlying Realm is updated. Managed RealmSet can only be accessed using the getter that points to a RealmSet field of a RealmObject .

Unmanaged elements in this set can be added to a Realm using the Realm.copyToRealm(Iterable, ImportFlag...) method.

Warning: the following methods are not supported for classes containing set fields yet:

Constructors

Constructor and Description
RealmSet ()

Instantiates a RealmSet in unmanaged mode.

RealmSet (
java.util.Collection<E> collection
)

Instantiates a RealmSet in unmanaged mode with another collection.

RealmSet (
BaseRealm baseRealm,
OsSet osSet,
java.lang.Class<E> valueClass
)

Instantiates a RealmSet in managed mode.

RealmSet (
BaseRealm baseRealm,
OsSet osSet,
String className
)

Instantiates a RealmSet in managed mode.

Method Summary

Modifier and Type
Method and Description
public boolean
add (
E e
)
public boolean
addAll (
java.util.Collection<? extends E> c
)
public void
addChangeListener (
io.realm.SetChangeListener<E> listener
)

Adds a change listener to this RealmSet .

public void
addChangeListener (
io.realm.RealmChangeListener<io.realm.RealmSet<E>> listener
)

Adds a change listener to this RealmSet .

public double
average (
String fieldName
)

Returns the average of a given field.

public void
clear ()

public boolean
contains (
Object o
)

Tests whether this Collection contains the specified object.

public boolean
containsAll (
java.util.Collection<?> c
)
public boolean
deleteAllFromRealm ()

This deletes all objects in the collection from the underlying Realm as well as from the collection.

public RealmSet
freeze ()

public Class
getValueClass ()

public String
getValueClassName ()

public boolean
isEmpty ()

public boolean
isFrozen ()

public boolean
isLoaded ()

Checks if a collection has finished loading its data yet.

public boolean
isManaged ()

Checks if the collection is managed by Realm.

public boolean
isValid ()

Checks if the collection is still valid to use, i.e., the io.realm.Realm instance hasn't been closed.

public Iterator
iterator ()

public boolean
load ()

Blocks the collection until all data are available.

public Number
max (
String fieldName
)

Finds the maximum value of a field.

public Date
maxDate (
String fieldName
)

Finds the maximum date.

public Number
min (
String fieldName
)

Finds the minimum value of a field.

public Date
minDate (
String fieldName
)

Finds the minimum date.

public boolean
remove (
Object o
)
public boolean
removeAll (
java.util.Collection<?> c
)
public void
removeAllChangeListeners ()

Removes all user-defined change listeners.

public void
removeChangeListener (
io.realm.SetChangeListener<E> listener
)

Removes the specified change listener.

public void
removeChangeListener (
io.realm.RealmChangeListener<io.realm.RealmSet<E>> listener
)

Removes the specified change listener.

public boolean
retainAll (
java.util.Collection<?> c
)
public int
size ()

public Number
sum (
String fieldName
)

Calculates the sum of a given field.

public T
toArray <T >(
T[] a
)
public Object
toArray ()

public RealmQuery
where ()

Returns a RealmQuery, which can be used to query for specific objects of this class.

Inherited Methods

  • Methods inherited from class java.lang.Object : getClass , hashCode , equals , clone , toString , notify , notifyAll , wait , wait , wait , finalize

Constructor Detail

public RealmSet ()

Instantiates a RealmSet in unmanaged mode.
public RealmSet (
java.util.Collection<E> collection
)

Instantiates a RealmSet in unmanaged mode with another collection.

Parameters

  • collection - the collection with which the set will be initially populated.

public RealmSet (
BaseRealm baseRealm,
OsSet osSet,
java.lang.Class<E> valueClass
)

Instantiates a RealmSet in managed mode. This constructor is used internally by Realm.

Parameters

  • baseRealm -

  • osSet -

  • valueClass -

public RealmSet (
BaseRealm baseRealm,
OsSet osSet,
String className
)

Instantiates a RealmSet in managed mode. This constructor is used internally by a Dynamic Realm.

Parameters

  • baseRealm -

  • osSet -

  • className -

Method Detail

add

public boolean add (
E e
)

addAll

public boolean addAll (
java.util.Collection<? extends E> c
)

addChangeListener

public void addChangeListener (
io.realm.SetChangeListener<E> listener
)

Adds a change listener to this RealmSet .

Registering a change listener will not prevent the underlying RealmSet from being garbage collected. If the RealmSet is garbage collected, the change listener will stop being triggered. To avoid this, keep a strong reference for as long as appropriate e.g. in a class variable.

public class MyActivity extends Activity {
    private RealmSet<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 SetChangeListener<Dog>() {
          @Override
          public void onChange(RealmSet<Dog> set, SetChangeSet changeSet) {
              // React to change
          }
      });
    }
}

Parameters

  • listener - the listener to be notified.

Throws

public void addChangeListener (
io.realm.RealmChangeListener<io.realm.RealmSet<E>> listener
)

Adds a change listener to this RealmSet .

Registering a change listener will not prevent the underlying RealmSet from being garbage collected. If the RealmSet is garbage collected, the change listener will stop being triggered. To avoid this, keep a strong reference for as long as appropriate e.g. in a class variable.

public class MyActivity extends Activity {
    private RealmSet<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<RealmSet<Dog>>() {
          @Override
          public void onChange(RealmSet<Dog> map) {
              // React to change
          }
      });
    }
}

Parameters

  • listener - the listener to be notified.

Throws

average

public double average (
String fieldName
)

Returns the average of a given field.

Returns

the average for the given field amongst objects in query results. This will be of type double for all types of number fields. If no objects exist or they all have null as the value for the given field, 0 will be returned. When computing the average, objects with null values are ignored.

clear

public void clear ()

contains

public boolean contains (
Object o
)

Tests whether this Collection contains the specified object. Returns true if and only if at least one element elem in this Collection meets following requirement: (object==null ? elem==null : object.equals(elem)) .

Returns

true if object is an element of this Collection , false otherwise.

containsAll

public boolean containsAll (
java.util.Collection<?> c
)

deleteAllFromRealm

public boolean deleteAllFromRealm ()

This deletes all objects in the collection from the underlying Realm as well as from the collection.

Returns

true if objects was deleted, false otherwise.

freeze

public RealmSet freeze ()

getValueClass

public Class getValueClass ()

getValueClassName

public String getValueClassName ()

isEmpty

public boolean isEmpty ()

isFrozen

public boolean isFrozen ()

isLoaded

public boolean isLoaded ()

Checks if a collection has finished loading its data yet.

Returns

true if data has been loaded and is available, false if data is still being loaded.

isManaged

public boolean isManaged ()

Checks if the collection is managed by Realm. A managed collection is just a wrapper around the data in the underlying Realm file. On Looper threads, a managed collection will be live-updated so it always points to the latest data. Managed collections are thread confined so that they cannot be accessed from other threads than the one that created them.If this method returns false , the collection is unmanaged. An unmanaged collection is just a normal java collection, so it will not be live updated.

Returns

true if this is a managed RealmCollection , false otherwise.

isValid

public boolean isValid ()

Checks if the collection is still valid to use, i.e., the io.realm.Realm instance hasn't been closed. It will always return true for an unmanaged collection.

Returns

true if it is still valid to use or an unmanaged collection, false otherwise.

iterator

public Iterator iterator ()

load

public boolean load ()

Blocks the collection until all data are available.

Returns

true if the data could be successfully loaded, false otherwise.

max

public Number max (
String fieldName
)

Finds the maximum value of a field.

Returns

if no objects exist or they all have null as the value for the given field, null will be returned. Otherwise the maximum value is returned. When determining the maximum value, objects with null values are ignored.

maxDate

public Date maxDate (
String fieldName
)

Finds the maximum date.

Returns

if no objects exist or they all have null as the value for the given date field, null will be returned. Otherwise the maximum date is returned. When determining the maximum date, objects with null values are ignored.

min

public Number min (
String fieldName
)

Finds the minimum value of a field.

Returns

if no objects exist or they all have null as the value for the given field, null will be returned. Otherwise the minimum value is returned. When determining the minimum value, objects with null values are ignored.

minDate

public Date minDate (
String fieldName
)

Finds the minimum date.

Returns

if no objects exist or they all have null as the value for the given date field, null will be returned. Otherwise the minimum date is returned. When determining the minimum date, objects with null values are ignored.

remove

public boolean remove (
Object o
)

removeAll

public boolean removeAll (
java.util.Collection<?> c
)

removeAllChangeListeners

public void removeAllChangeListeners ()

Removes all user-defined change listeners.

Throws

Tip

See also:

removeChangeListener

public void removeChangeListener (
io.realm.SetChangeListener<E> listener
)

Removes the specified change listener.

Parameters

  • listener - the change listener to be removed.

Throws

public void removeChangeListener (
io.realm.RealmChangeListener<io.realm.RealmSet<E>> listener
)

Removes the specified change listener.

Parameters

  • listener - the change listener to be removed.

Throws

retainAll

public boolean retainAll (
java.util.Collection<?> c
)

size

public int size ()

sum

public Number sum (
String fieldName
)

Calculates the sum of a given field.

Returns

the sum. If no objects exist or they all have null as the value for the given field, 0 will be returned. When computing the sum, objects with null values are ignored.

toArray

public T toArray <T >(
T[] a
)
public Object toArray ()

where

public RealmQuery where ()

Returns a RealmQuery, which can be used to query for specific objects of this class.

Returns

a RealmQuery object.

Throws

Tip

See also:

← Class RealmSchema
Interface SetChangeListener →

On this page