Package io.realm

Class RealmDictionary<V>

  • Type Parameters:
    V - the type of the values stored in this dictionary
    All Implemented Interfaces:
    io.realm.internal.Freezable<RealmMap<String,​V>>, io.realm.internal.ManageableObject, Map<String,​V>

    public class RealmDictionary<V>
    extends RealmMap<String,​V>
    Specialization of RealmMaps whose keys are strings.

    Similarly to RealmLists, a RealmDictionary can operate in managed and unmanaged modes. In managed mode a RealmDictionary persists all its contents inside a Realm whereas in unmanaged mode it functions like a HashMap.

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

    Unmanaged RealmDictionaries can be created by the user and can contain both managed and unmanaged RealmObjects. This is useful when dealing with JSON deserializers like GSON or other frameworks that inject values into a class. Unmanaged RealmDictionaries can be added to a Realm using the Realm.copyToRealm(Iterable, ImportFlag...) method.

    • Constructor Detail

      • RealmDictionary

        public RealmDictionary()
        Instantiates a RealmDictionary in unmanaged mode.
      • RealmDictionary

        public RealmDictionary​(Map<String,​V> map)
        Instantiates a RealmDictionary in unmanaged mode with an initial dictionary.
        Parameters:
        map - initial dictionary