类 RealmMap

Atlas Device SDK 已弃用。有关详细信息，请参阅弃用页面。

io.realm

java.lang.Object

io.realm.RealmMap

实现的接口：

java.util.Map

RealmMap 用于将键映射到值。 RealmMap 不能包含重复的键，每个键最多只能映射到一个值。 RealmMap 不能有 null键，但可以有null值。

与RealmList类似，RealmDictionary 可以在托管和非托管模式下运行。在托管模式，RealmDictionary 会将其所有内容持久保存在Realm中，而在非托管模式，其功能类似于 HashMap 。

托管 RealmDictionaries 只能由 Realm 创建，并且每当底层 Realm 更新时都会自动更新其内容。托管 RealmDictionaries 只能使用指向 RealmObject 的RealmDictionary字段的 getter 来访问。

非托管 RealmDictionaries 可由用户创建，可包含托管和非托管 RealmObject。这在处理 JSON 反序列化器（例如 GSON）或其他将值注入到类中的框架时非常有用。可以使用Realm.copyToRealm(Iterable, ImportFlag...)方法将非托管 RealmMap 添加到 Realm。

方法摘要

修饰符和类型	方法和说明
public void	addChangeListener ( io.realm.RealmChangeListener<io.realm.RealmMap<K, V>> listener ) 向此RealmMap添加变更侦听器。
public void	addChangeListener ( io.realm.MapChangeListener<K, V> listener ) 向此RealmMap添加变更侦听器。
public void	clear ()
公共布尔值	containsKey ( Object key )
公共布尔值	containsValue ( Object value )
公共集合	entrySet ()
公共RealmMap	freeze ()
公共V	get ( Object key )
公共布尔值	isEmpty ()
公共布尔值	isFrozen ()
公共布尔值	isManaged ()
公共布尔值	isValid ()
公共集合	keySet ()
公共V	put ( K key, V value )
public void	putAll ( java.util.Map<? extends K, ? extends V> m )
公共V	remove ( Object key )
public void	removeAllChangeListeners () 删除所有用户定义的变更侦听器。
public void	removeChangeListener ( io.realm.RealmChangeListener<io.realm.RealmMap<K, V>> listener ) 删除指定的变更侦听器。
public void	removeChangeListener ( io.realm.MapChangeListener<K, V> listener ) 删除指定的变更侦听器。
公共整型	size ()
公共集合	values ()

继承方法

从类 java.lang.Object 继承的方法：getClass 、hashCode 、equals 、clone 、toString 、notify 、notifyAll 、wait 、wait 、wait 、finalize

方法详细信息

addChangeListener

public void addChangeListener (

io.realm.RealmChangeListener<io.realm.RealmMap<K, V>> listener

)

向此RealmMap添加变更侦听器。

注册变更侦听器不会阻止底层 RealmMap 被垃圾收集。如果对 RealmMap 进行垃圾回收，则将停止触发变更侦听器。为避免这种情况，请尽可能长时间地保留强引用，例如在类变量中。

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

参数

listener - 要通知的变更侦听器。

抛出异常

IllegalArgumentException - 如果变更侦听器为null 。
IllegalStateException - 如果您尝试从非 Looper 或 android.app.IntentService 添加监听器线程。

提示

另请参阅：

io.realm.RealmChangeListener

public void addChangeListener (

io.realm.MapChangeListener<K, V> listener

)

向此RealmMap添加变更侦听器。

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

参数

listener - 要通知的变更侦听器。

抛出异常

IllegalArgumentException - 如果变更侦听器为null 。
IllegalStateException - 如果您尝试从非 Looper 或 android.app.IntentService 添加监听器线程。

清除

public void clear ()

containsKey

public boolean containsKey ( Object key )

containsValue

public boolean containsValue ( Object value )

entrySet

public Set entrySet ()

冻结

public RealmMap freeze ()

获取

public V get ( Object key )

isEmpty

public boolean isEmpty ()

IsFrozen

public boolean isFrozen ()

isManaged

public boolean isManaged ()

isValid

public boolean isValid ()

keySet

public Set keySet ()

PUT

public V put ( K key, V value )

putAll

public void putAll ( java.util.Map<? extends K, ? extends V> m )

删除

public V remove ( Object key )

删除所有变更监听器

public void removeAllChangeListeners ()
删除所有用户定义的变更侦听器。抛出异常 IllegalStateException - 如果您尝试从非 Looper 线程中删除侦听器。提示另请参阅： io.realm.RealmChangeListener

removeChangeListener

public void removeChangeListener ( io.realm.RealmChangeListener<io.realm.RealmMap<K, V>> listener )
删除指定的变更侦听器。参数 `listener` - 要删除的变更侦听器。抛出异常 IllegalArgumentException - 如果变更侦听器为`null` 。 IllegalStateException - 如果尝试从非 Looper 线程中删除侦听器。提示另请参阅： io.realm.RealmChangeListener

public void removeChangeListener ( io.realm.MapChangeListener<K, V> listener )
删除指定的变更侦听器。参数 `listener` - 要删除的变更侦听器。抛出异常 IllegalArgumentException - 如果变更侦听器为`null` 。 IllegalStateException - 如果尝试从非 Looper 线程中删除侦听器。

size

public int size ()

values

public Collection values ()

后退

RealmList

来年

RealmMigration