迭代Guava LoadingCache的map-view条目集会重置用于到期的访问时间吗?

时间:2013-01-17 03:41:53

标签: java guava

我使用LoadingCache<K,V>创建了CacheBuilder

LoadingCache<K,V> myCache = CacheBuilder.newBuilder()
    .expireAfterAccess(1, TimeUnit.MINUTES)
    .maximumSize(500)
    .build(someCacheLoader);

我需要定期迭代缓存中的所有条目(键和值)。我知道我可以使用LoadingCache#asMap()完成此任务,并且:

在前一种情况下:

for (Map.Entry<K, V> entry : myCache.asMap().entrySet()) {
    K key = entry.getKey();
    V value = entry.getValue();

    doSomeWorkOn(key, value);
}

这会更新缓存中每个条目的访问时间吗?我已经非常仔细地阅读了CacheBuilder#expireAfterAccess(long, TimeUnit)的JavaDoc,但在这种情况下发现它是模棱两可的/不清楚的:

  

指定在条目创建,最近替换其值或上次访问后经过固定的持续时间后,应自动从缓存中删除每个条目。所有缓存读写操作(包括Cache.asMap().get(Object)Cache.asMap().put(K, V))都会重置访问时间,但不会通过Cache.asMap的集合视图上的操作重置访问时间。

显然,我提到的第二种迭代方式重置访问时间,但我想知道第一种方式是什么行为。

1 个答案:

答案 0 :(得分:15)

我会解释这个:

  

(...)但不是对Cache.asMap的集合视图的操作

引用entrySetkeySetvalues。这是Map的三个集合视图。因此,使用它们不应导致访问。

以下是JUnit(+ Mockito)测试,显示每种情况下的行为。通过entrySetvalues读取值会阻止条目被删除(也不会从entrySetkeySet中读取密钥)。正如文档所指定的那样,使用asMap().get()进行阅读会被视为访问权限。

设置

private Ticker ticker = Mockito.mock(Ticker.class);

@SuppressWarnings({"unchecked"})
private RemovalListener<String, String> removalListener = Mockito.mock(RemovalListener.class);

private Cache<String, String> cache = CacheBuilder.newBuilder()
            .expireAfterAccess(5, TimeUnit.SECONDS)
            .removalListener(removalListener)
            .ticker(ticker)
            .build();

entrySet

@Test
public void testEntrySetAccessDoesNotCountAsAccess() {
    //write
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(0));
    cache.put("foo", "bar");

    //read
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(4));
    cache.asMap().entrySet().iterator().next().getValue();
    cache.asMap().entrySet().iterator().next().getKey();

    //maintenance
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(6));
    cache.cleanUp();

    verify(removalListener).onRemoval(Mockito.<RemovalNotification<String,String>>any());
}

keySet

@Test
public void testKeySetAccessDoesNotCountAsAccess() {
    //write
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(0));
    cache.put("foo", "bar");

    //read
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(4));
    cache.asMap().keySet().iterator().next();

    //maintenance
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(6));
    cache.cleanUp();

    verify(removalListener).onRemoval(Mockito.<RemovalNotification<String,String>>any());
}

values

@Test
public void testValuesAccessDoesNotCountAsAccess() {
    //write
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(0));
    cache.put("foo", "bar");

    //read
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(4));
    cache.asMap().values().iterator().next();

    //maintenance
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(6));
    cache.cleanUp();

    verify(removalListener).onRemoval(Mockito.<RemovalNotification<String,String>>any());
}

asMap().get()

@Test
public void testMapGetAccessCountsAsAccess() {
    //write
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(0));
    cache.put("foo", "bar");

    //read
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(4));
    cache.asMap().get("foo");

    //maintenance
    when(ticker.read()).thenReturn(TimeUnit.SECONDS.toNanos(6));
    cache.cleanUp();

    verify(removalListener, never()).onRemoval(Mockito.<RemovalNotification<String,String>>any());
}