15.2. MultimapCache API
MultimapCache API 会公开几种与多映射缓存交互的方法。在大多数情况下,这些方法是非阻塞的;如需更多信息,请参阅 限制。
public interface MultimapCache<K, V> { CompletableFuture<Optional<CacheEntry<K, Collection<V>>>> getEntry(K key); CompletableFuture<Void> remove(SerializablePredicate<? super V> p); CompletableFuture<Void> put(K key, V value); CompletableFuture<Collection<V>> get(K key); CompletableFuture<Boolean> remove(K key); CompletableFuture<Boolean> remove(K key, V value); CompletableFuture<Void> remove(Predicate<? super V> p); CompletableFuture<Boolean> containsKey(K key); CompletableFuture<Boolean> containsValue(V value); CompletableFuture<Boolean> containsEntry(K key, V value); CompletableFuture<Long> size(); boolean supportsDuplicates(); }
CompletableFuture<Void> put (K key, V value)
将键值对放在 multimap 缓存中。
MultimapCache<String, String> multimapCache = ...; multimapCache.put("girlNames", "marie") .thenCompose(r1 -> multimapCache.put("girlNames", "oihana")) .thenCompose(r3 -> multimapCache.get("girlNames")) .thenAccept(names -> { if(names.contains("marie")) System.out.println("Marie is a girl name"); if(names.contains("oihana")) System.out.println("Oihana is a girl name"); });
这个代码的输出如下:
Marie is a girl name Oihana is a girl name
CompletableFuture<Collection<V>> get (K key)
异步返回与这个多映射缓存中键关联的值(若有)的视图集合。对检索到的集合的任何更改都不会更改此多映射缓存中的值。当此方法返回空集合时,这意味着未找到该密钥。
CompletableFuture<Boolean> remove (K key)
异步的异步从多映射缓存中删除与密钥关联的条目(如果存在)。
CompletableFuture<Boolean> remove (K key, V value)
异步的异步,它会从多映射缓存中删除键值对(如果存在)。
CompletableFuture<Void> remove (Predicate<? super V> p)
异步方法.删除与给定 predicate 匹配的每个值。
CompletableFuture<Boolean> containsKey (K key)
如果这个多map包含密钥,则异步返回 true。
CompletableFuture<Boolean> containsValue (V value)
如果此多map包含至少一个键中的值,则异步返回 true。
CompletableFuture<Boolean> containsEntry(K key, V value)
如果此多map至少包含一个键值对和值,则异步返回 true。
CompletableFuture<Long> size ()
在多映射缓存中返回键值对数的异步。它不会返回不同的密钥数。
boolean supportsDuplicates()
如果多映射缓存支持重复,则异步返回 true。这意味着 multimap 的内容可以是 'a'