11d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert/* 21d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Copyright (C) 2011 The Guava Authors 31d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 41d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Licensed under the Apache License, Version 2.0 (the "License"); 51d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * you may not use this file except in compliance with the License. 61d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * You may obtain a copy of the License at 71d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 81d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * http://www.apache.org/licenses/LICENSE-2.0 91d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 101d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Unless required by applicable law or agreed to in writing, software 111d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * distributed under the License is distributed on an "AS IS" BASIS, 121d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 131d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * See the License for the specific language governing permissions and 141d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * limitations under the License. 151d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 161d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 171d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertpackage com.google.common.cache; 181d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 191d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport com.google.common.annotations.Beta; 207dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.annotations.GwtCompatible; 211d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 221d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.util.Iterator; 231d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.util.Map; 241d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.util.concurrent.ConcurrentMap; 251d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 261d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert/** 271d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * The reason why a cached entry was removed. 281d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 291d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * @author Charles Fry 301d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * @since 10.0 311d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 321d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert@Beta 337dd252788645e940eada959bdde927426e2531c9Paul Duffin@GwtCompatible 341d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertpublic enum RemovalCause { 351d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** 361d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * The entry was manually removed by the user. This can result from the user invoking 371d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link Cache#invalidate}, {@link Cache#invalidateAll(Iterable)}, {@link Cache#invalidateAll()}, 381d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link Map#remove}, {@link ConcurrentMap#remove}, or {@link Iterator#remove}. 391d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 401d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert EXPLICIT { 411d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @Override 421d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert boolean wasEvicted() { 431d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert return false; 441d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 451d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert }, 461d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 471d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** 481d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * The entry itself was not actually removed, but its value was replaced by the user. This can 491d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * result from the user invoking {@link Cache#put}, {@link LoadingCache#refresh}, {@link Map#put}, 501d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link Map#putAll}, {@link ConcurrentMap#replace(Object, Object)}, or 511d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link ConcurrentMap#replace(Object, Object, Object)}. 521d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 531d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert REPLACED { 541d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @Override 551d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert boolean wasEvicted() { 561d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert return false; 571d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 581d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert }, 591d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 601d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** 611d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * The entry was removed automatically because its key or value was garbage-collected. This 621d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * can occur when using {@link CacheBuilder#weakKeys}, {@link CacheBuilder#weakValues}, or 631d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link CacheBuilder#softValues}. 641d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 651d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert COLLECTED { 661d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @Override 671d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert boolean wasEvicted() { 681d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert return true; 691d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 701d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert }, 711d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 721d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** 731d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * The entry's expiration timestamp has passed. This can occur when using 741d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link CacheBuilder#expireAfterWrite} or {@link CacheBuilder#expireAfterAccess}. 751d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 761d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert EXPIRED { 771d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @Override 781d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert boolean wasEvicted() { 791d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert return true; 801d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 811d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert }, 821d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 831d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** 841d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * The entry was evicted due to size constraints. This can occur when using 851d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link CacheBuilder#maximumSize} or {@link CacheBuilder#maximumWeight}. 861d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 871d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert SIZE { 881d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @Override 891d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert boolean wasEvicted() { 901d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert return true; 911d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 921d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert }; 931d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 941d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** 951d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Returns {@code true} if there was an automatic removal due to eviction (the cause is neither 961d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link #EXPLICIT} nor {@link #REPLACED}). 971d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 981d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert abstract boolean wasEvicted(); 991d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert} 100