You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hbase.apache.org by gi...@apache.org on 2022/11/21 14:43:59 UTC
[hbase-site] branch asf-site updated: Published site at 94629331791ea9dbec171ad9070d8c4d486bd16b.
This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/hbase-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 4308a8636ef Published site at 94629331791ea9dbec171ad9070d8c4d486bd16b.
4308a8636ef is described below
commit 4308a8636ef7176f742925434f968211bf278b30
Author: jenkins <bu...@apache.org>
AuthorDate: Mon Nov 21 14:43:47 2022 +0000
Published site at 94629331791ea9dbec171ad9070d8c4d486bd16b.
---
acid-semantics.html | 2 +-
apache_hbase_reference_guide.pdf | 4 +-
book.html | 2 +-
bulk-loads.html | 2 +-
checkstyle-aggregate.html | 12 +-
coc.html | 2 +-
dependencies.html | 2 +-
dependency-convergence.html | 2 +-
dependency-info.html | 2 +-
dependency-management.html | 2 +-
.../hfile/bucket/BucketCache.BucketEntryGroup.html | 18 +-
.../io/hfile/bucket/BucketCache.RAMCache.html | 20 +-
.../io/hfile/bucket/BucketCache.RAMQueueEntry.html | 22 +-
.../hadoop/hbase/io/hfile/bucket/BucketCache.html | 64 +-
.../hbase/master/cleaner/HFileLinkCleaner.html | 2 +-
.../hfile/bucket/BucketCache.BucketEntryGroup.html | 1492 ++++++++++----------
.../io/hfile/bucket/BucketCache.RAMCache.html | 1492 ++++++++++----------
.../io/hfile/bucket/BucketCache.RAMQueueEntry.html | 1492 ++++++++++----------
.../hfile/bucket/BucketCache.StatisticsThread.html | 1492 ++++++++++----------
.../io/hfile/bucket/BucketCache.WriterThread.html | 1492 ++++++++++----------
.../hadoop/hbase/io/hfile/bucket/BucketCache.html | 1492 ++++++++++----------
.../hbase/master/cleaner/HFileLinkCleaner.html | 81 +-
downloads.html | 2 +-
export_control.html | 2 +-
index.html | 2 +-
issue-management.html | 2 +-
licenses.html | 2 +-
mailing-lists.html | 2 +-
metrics.html | 2 +-
old_news.html | 2 +-
plugin-management.html | 2 +-
plugins.html | 2 +-
poweredbyhbase.html | 2 +-
project-info.html | 2 +-
project-reports.html | 2 +-
pseudo-distributed.html | 2 +-
replication.html | 2 +-
resources.html | 2 +-
scm.html | 2 +-
sponsors.html | 2 +-
summary.html | 2 +-
supportingprojects.html | 2 +-
team.html | 2 +-
testdevapidocs/constant-values.html | 19 +
testdevapidocs/index-all.html | 50 +
.../apache/hadoop/hbase/io/hfile/package-tree.html | 2 +-
.../cleaner/TestHFileLinkCleaner.DummyServer.html | 8 +-
.../hbase/master/cleaner/TestHFileLinkCleaner.html | 384 ++++-
.../org/apache/hadoop/hbase/package-tree.html | 16 +-
.../hadoop/hbase/procedure2/package-tree.html | 2 +-
.../hadoop/hbase/regionserver/package-tree.html | 8 +-
.../org/apache/hadoop/hbase/test/package-tree.html | 6 +-
.../cleaner/TestHFileLinkCleaner.DummyServer.html | 298 ++--
.../hbase/master/cleaner/TestHFileLinkCleaner.html | 298 ++--
54 files changed, 5449 insertions(+), 4875 deletions(-)
diff --git a/acid-semantics.html b/acid-semantics.html
index 2a6c7bef335..f59aa925b87 100644
--- a/acid-semantics.html
+++ b/acid-semantics.html
@@ -464,7 +464,7 @@
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
diff --git a/apache_hbase_reference_guide.pdf b/apache_hbase_reference_guide.pdf
index aaf3df2fca0..ba932dc3797 100644
--- a/apache_hbase_reference_guide.pdf
+++ b/apache_hbase_reference_guide.pdf
@@ -5,8 +5,8 @@
/Author (Apache HBase Team)
/Creator (Asciidoctor PDF 2.0.6, based on Prawn 2.4.0)
/Producer (Apache HBase Team)
-/ModDate (D:20221118143040+00'00')
-/CreationDate (D:20221118144118+00'00')
+/ModDate (D:20221121143041+00'00')
+/CreationDate (D:20221121144123+00'00')
>>
endobj
2 0 obj
diff --git a/book.html b/book.html
index 2f08985d5ea..7dc8bd324ec 100644
--- a/book.html
+++ b/book.html
@@ -48194,7 +48194,7 @@ org/apache/hadoop/hbase/security/access/AccessControlClient.revoke:(Lorg/apache/
<div id="footer">
<div id="footer-text">
Version 3.0.0-alpha-4-SNAPSHOT<br>
-Last updated 2022-11-18 14:30:40 UTC
+Last updated 2022-11-21 14:30:41 UTC
</div>
</div>
<script type="text/x-mathjax-config">
diff --git a/bulk-loads.html b/bulk-loads.html
index c8318acf316..ddd3f276cc0 100644
--- a/bulk-loads.html
+++ b/bulk-loads.html
@@ -180,7 +180,7 @@
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
diff --git a/checkstyle-aggregate.html b/checkstyle-aggregate.html
index 7b678277a75..49315270343 100644
--- a/checkstyle-aggregate.html
+++ b/checkstyle-aggregate.html
@@ -8850,31 +8850,31 @@
<td>blocks</td>
<td>NeedBraces</td>
<td>'if' construct must use '{}'s.</td>
-<td>1356</td></tr>
+<td>1362</td></tr>
<tr class="a">
<td><figure><img src="images/icon_error_sml.gif" alt="" /></figure> Error</td>
<td>blocks</td>
<td>NeedBraces</td>
<td>'for' construct must use '{}'s.</td>
-<td>1360</td></tr>
+<td>1366</td></tr>
<tr class="b">
<td><figure><img src="images/icon_error_sml.gif" alt="" /></figure> Error</td>
<td>blocks</td>
<td>NeedBraces</td>
<td>'for' construct must use '{}'s.</td>
-<td>1370</td></tr>
+<td>1376</td></tr>
<tr class="a">
<td><figure><img src="images/icon_error_sml.gif" alt="" /></figure> Error</td>
<td>blocks</td>
<td>NeedBraces</td>
<td>'if' construct must use '{}'s.</td>
-<td>1650</td></tr>
+<td>1656</td></tr>
<tr class="b">
<td><figure><img src="images/icon_error_sml.gif" alt="" /></figure> Error</td>
<td>blocks</td>
<td>NeedBraces</td>
<td>'if' construct must use '{}'s.</td>
-<td>1653</td></tr></table></section><section>
+<td>1659</td></tr></table></section><section>
<h3 id="org.apache.hadoop.hbase.io.hfile.bucket.TestBucketCache.java">org/apache/hadoop/hbase/io/hfile/bucket/TestBucketCache.java</h3>
<table border="0" class="table table-striped">
<tr class="a">
@@ -18721,7 +18721,7 @@
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
diff --git a/coc.html b/coc.html
index 4d8cab126a4..b23706c7395 100644
--- a/coc.html
+++ b/coc.html
@@ -248,7 +248,7 @@ email to <a class="externalLink" href="mailto:private@hbase.apache.org">the priv
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
diff --git a/dependencies.html b/dependencies.html
index d1c4d6bea25..b4216608e22 100644
--- a/dependencies.html
+++ b/dependencies.html
@@ -313,7 +313,7 @@
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
diff --git a/dependency-convergence.html b/dependency-convergence.html
index c66dc4f0ef7..0dc32611c82 100644
--- a/dependency-convergence.html
+++ b/dependency-convergence.html
@@ -1011,7 +1011,7 @@
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
diff --git a/dependency-info.html b/dependency-info.html
index 5783fb8bae7..25603078766 100644
--- a/dependency-info.html
+++ b/dependency-info.html
@@ -195,7 +195,7 @@
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
diff --git a/dependency-management.html b/dependency-management.html
index 96182c3b040..299c52b233b 100644
--- a/dependency-management.html
+++ b/dependency-management.html
@@ -1326,7 +1326,7 @@
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
diff --git a/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html b/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html
index f36301b899c..5a37e96bf51 100644
--- a/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html
+++ b/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html
@@ -113,7 +113,7 @@ var activeTableTab = "activeTableTab";
</dl>
<hr>
<br>
-<pre>private class <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1466">BucketCache.BucketEntryGroup</a>
+<pre>private class <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1472">BucketCache.BucketEntryGroup</a>
extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each
priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate
@@ -226,7 +226,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>queue</h4>
-<pre>private <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/CachedEntryQueue.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">CachedEntryQueue</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1468">queue</a></pre>
+<pre>private <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/CachedEntryQueue.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">CachedEntryQueue</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1474">queue</a></pre>
</li>
</ul>
<a name="totalSize">
@@ -235,7 +235,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>totalSize</h4>
-<pre>private long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1469">totalSize</a></pre>
+<pre>private long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1475">totalSize</a></pre>
</li>
</ul>
<a name="bucketSize">
@@ -244,7 +244,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>bucketSize</h4>
-<pre>private long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1470">bucketSize</a></pre>
+<pre>private long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1476">bucketSize</a></pre>
</li>
</ul>
</li>
@@ -261,7 +261,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>BucketEntryGroup</h4>
-<pre>public <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1472">BucketEntryGroup</a>(long bytesToFree,
+<pre>public <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1478">BucketEntryGroup</a>(long bytesToFree,
long blockSize,
long bucketSize)</pre>
</li>
@@ -280,7 +280,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>add</h4>
-<pre>public void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1478">add</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">Map.Entry</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a>,<a href="../../../../../../../o [...]
+<pre>public void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1484">add</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.Entry.html?is-external=true" title="class or interface in java.util">Map.Entry</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a>,<a href="../../../../../../../o [...]
</li>
</ul>
<a name="free-long-">
@@ -289,7 +289,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>free</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1483">free</a>(long toFree)</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1489">free</a>(long toFree)</pre>
</li>
</ul>
<a name="overflow--">
@@ -298,7 +298,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>overflow</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1501">overflow</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1507">overflow</a>()</pre>
</li>
</ul>
<a name="totalSize--">
@@ -307,7 +307,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>totalSize</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1505">totalSize</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html#line.1511">totalSize</a>()</pre>
</li>
</ul>
</li>
diff --git a/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html b/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html
index 0a97409d656..7818cb1d9b2 100644
--- a/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html
+++ b/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html
@@ -113,7 +113,7 @@ var activeTableTab = "activeTableTab";
</dl>
<hr>
<br>
-<pre>static class <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1725">BucketCache.RAMCache</a>
+<pre>static class <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1731">BucketCache.RAMCache</a>
extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Wrapped the delegate ConcurrentMap with maintaining its block's reference count.</div>
</li>
@@ -239,7 +239,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>delegate</h4>
-<pre>final <a href="https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ConcurrentHashMap.html?is-external=true" title="class or interface in java.util.concurrent">ConcurrentHashMap</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a>,<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop. [...]
+<pre>final <a href="https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ConcurrentHashMap.html?is-external=true" title="class or interface in java.util.concurrent">ConcurrentHashMap</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a>,<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop. [...]
<div class="block">Defined the map as <a href="https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ConcurrentHashMap.html?is-external=true" title="class or interface in java.util.concurrent"><code>ConcurrentHashMap</code></a> explicitly here, because in
<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#get-org.apache.hadoop.hbase.io.hfile.BlockCacheKey-"><code>get(BlockCacheKey)</code></a> and
<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#putIfAbsent-org.apache.hadoop.hbase.io.hfile.BlockCacheKey-org.apache.hadoop.hbase.io.hfile.bucket.BucketCache.RAMQueueEntry-"><code>putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)</code></a> , we need to guarantee
@@ -263,7 +263,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>RAMCache</h4>
-<pre><a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1725">RAMCache</a>()</pre>
+<pre><a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1731">RAMCache</a>()</pre>
</li>
</ul>
</li>
@@ -280,7 +280,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>containsKey</h4>
-<pre>public boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1737">containsKey</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> key)</pre>
+<pre>public boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1743">containsKey</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> key)</pre>
</li>
</ul>
<a name="get-org.apache.hadoop.hbase.io.hfile.BlockCacheKey-">
@@ -289,7 +289,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>get</h4>
-<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1741">get</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> k [...]
+<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1747">get</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> k [...]
</li>
</ul>
<a name="putIfAbsent-org.apache.hadoop.hbase.io.hfile.BlockCacheKey-org.apache.hadoop.hbase.io.hfile.bucket.BucketCache.RAMQueueEntry-">
@@ -298,7 +298,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>putIfAbsent</h4>
-<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1755">putIfAbsent</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a [...]
+<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1761">putIfAbsent</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a [...]
<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a> entry)</pre>
<div class="block">Return the previous associated value, or null if absent. It has the same meaning as
<a href="https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/ConcurrentMap.html?is-external=true#putIfAbsent-K-V-" title="class or interface in java.util.concurrent"><code>ConcurrentMap.putIfAbsent(Object, Object)</code></a></div>
@@ -310,7 +310,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>remove</h4>
-<pre>public boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1766">remove</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> key)</pre>
+<pre>public boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1772">remove</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> key)</pre>
</li>
</ul>
<a name="remove-org.apache.hadoop.hbase.io.hfile.BlockCacheKey-java.util.function.Consumer-">
@@ -319,7 +319,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>remove</h4>
-<pre>public boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1777">remove</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> key,
+<pre>public boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1783">remove</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> key,
<a href="https://docs.oracle.com/javase/8/docs/api/java/util/function/Consumer.html?is-external=true" title="class or interface in java.util.function">Consumer</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a>> action)</pre>
<div class="block">Defined an <a href="https://docs.oracle.com/javase/8/docs/api/java/util/function/Consumer.html?is-external=true" title="class or interface in java.util.function"><code>Consumer</code></a> here, because once the removed entry release its reference count,
then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an
@@ -333,7 +333,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>isEmpty</h4>
-<pre>public boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1786">isEmpty</a>()</pre>
+<pre>public boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1792">isEmpty</a>()</pre>
</li>
</ul>
<a name="clear--">
@@ -342,7 +342,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>clear</h4>
-<pre>public void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1790">clear</a>()</pre>
+<pre>public void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html#line.1796">clear</a>()</pre>
</li>
</ul>
</li>
diff --git a/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html b/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html
index 105a8d33d56..9bbc0a48f83 100644
--- a/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html
+++ b/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html
@@ -113,7 +113,7 @@ var activeTableTab = "activeTableTab";
</dl>
<hr>
<br>
-<pre>static class <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1513">BucketCache.RAMQueueEntry</a>
+<pre>static class <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1519">BucketCache.RAMQueueEntry</a>
extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></pre>
<div class="block">Block Entry stored in the memory with key,data and so on</div>
</li>
@@ -237,7 +237,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>key</h4>
-<pre>private final <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1514">key</a></pre>
+<pre>private final <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1520">key</a></pre>
</li>
</ul>
<a name="data">
@@ -246,7 +246,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>data</h4>
-<pre>private final <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/Cacheable.html" title="interface in org.apache.hadoop.hbase.io.hfile">Cacheable</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1515">data</a></pre>
+<pre>private final <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/Cacheable.html" title="interface in org.apache.hadoop.hbase.io.hfile">Cacheable</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1521">data</a></pre>
</li>
</ul>
<a name="accessCounter">
@@ -255,7 +255,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>accessCounter</h4>
-<pre>private long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1516">accessCounter</a></pre>
+<pre>private long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1522">accessCounter</a></pre>
</li>
</ul>
<a name="inMemory">
@@ -264,7 +264,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>inMemory</h4>
-<pre>private boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1517">inMemory</a></pre>
+<pre>private boolean <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1523">inMemory</a></pre>
</li>
</ul>
</li>
@@ -281,7 +281,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>RAMQueueEntry</h4>
-<pre><a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1519">RAMQueueEntry</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> bck,
+<pre><a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1525">RAMQueueEntry</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> bck,
<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/Cacheable.html" title="interface in org.apache.hadoop.hbase.io.hfile">Cacheable</a> data,
long accessCounter,
boolean inMemory)</pre>
@@ -301,7 +301,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>getData</h4>
-<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/Cacheable.html" title="interface in org.apache.hadoop.hbase.io.hfile">Cacheable</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1526">getData</a>()</pre>
+<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/Cacheable.html" title="interface in org.apache.hadoop.hbase.io.hfile">Cacheable</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1532">getData</a>()</pre>
</li>
</ul>
<a name="getKey--">
@@ -310,7 +310,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>getKey</h4>
-<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1530">getKey</a>()</pre>
+<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1536">getKey</a>()</pre>
</li>
</ul>
<a name="access-long-">
@@ -319,7 +319,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>access</h4>
-<pre>public void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1534">access</a>(long accessCounter)</pre>
+<pre>public void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1540">access</a>(long accessCounter)</pre>
</li>
</ul>
<a name="getByteBuffAllocator--">
@@ -328,7 +328,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockList">
<li class="blockList">
<h4>getByteBuffAllocator</h4>
-<pre>private <a href="../../../../../../../org/apache/hadoop/hbase/io/ByteBuffAllocator.html" title="class in org.apache.hadoop.hbase.io">ByteBuffAllocator</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1538">getByteBuffAllocator</a>()</pre>
+<pre>private <a href="../../../../../../../org/apache/hadoop/hbase/io/ByteBuffAllocator.html" title="class in org.apache.hadoop.hbase.io">ByteBuffAllocator</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1544">getByteBuffAllocator</a>()</pre>
</li>
</ul>
<a name="writeToCache-org.apache.hadoop.hbase.io.hfile.bucket.IOEngine-org.apache.hadoop.hbase.io.hfile.bucket.BucketAllocator-java.util.concurrent.atomic.LongAdder-java.util.function.Function-java.nio.ByteBuffer-">
@@ -337,7 +337,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
<ul class="blockListLast">
<li class="blockList">
<h4>writeToCache</h4>
-<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketEntry</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1545">writeToCache</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/IOEngine.html" title="interface in org.apache.hadoop.hbase.io.hfile.bucket">IOEngine</a> ioEngine,
+<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketEntry</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html#line.1551">writeToCache</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/IOEngine.html" title="interface in org.apache.hadoop.hbase.io.hfile.bucket">IOEngine</a> ioEngine,
<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketAllocator.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketAllocator</a> alloc,
<a href="https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/atomic/LongAdder.html?is-external=true" title="class or interface in java.util.concurrent.atomic">LongAdder</a> realCacheSize,
<a href="https://docs.oracle.com/javase/8/docs/api/java/util/function/Function.html?is-external=true" title="class or interface in java.util.function">Function</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketEntry</a>,<a href="../../../../../../../org/apache/hadoop/hbase/io/ByteBuffAllocator.Recycler.html" title="interface in org.apache.hadoop.hbas [...]
diff --git a/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html b/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html
index 974a462ec8c..93f3458bdbf 100644
--- a/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html
+++ b/devapidocs/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html
@@ -2085,7 +2085,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>doDrain</h4>
-<pre>void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1073">doDrain</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a>> entries,
+<pre>void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1079">doDrain</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a>> entries,
<a href="https://docs.oracle.com/javase/8/docs/api/java/nio/ByteBuffer.html?is-external=true" title="class or interface in java.nio">ByteBuffer</a> metaBuff)
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/InterruptedException.html?is-external=true" title="class or interface in java.lang">InterruptedException</a></pre>
<div class="block">Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that
@@ -2106,7 +2106,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getRAMQueueEntries</h4>
-<pre>static <a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a>> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1198">getRAMQueueEntries</a>(<a hre [...]
+<pre>static <a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a>> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1204">getRAMQueueEntries</a>(<a hre [...]
<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketCache.RAMQueueEntry</a>> receptacle)
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/InterruptedException.html?is-external=true" title="class or interface in java.lang">InterruptedException</a></pre>
<div class="block">Blocks until elements available in <code>q</code> then tries to grab as many as possible before
@@ -2129,7 +2129,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>persistToFile</h4>
-<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1213">persistToFile</a>()
+<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1219">persistToFile</a>()
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -2145,7 +2145,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>retrieveFromFile</h4>
-<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1230">retrieveFromFile</a>(int[] bucketSizes)
+<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1236">retrieveFromFile</a>(int[] bucketSizes)
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -2161,7 +2161,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>deleteFileOnClose</h4>
-<pre>private <a href="https://docs.oracle.com/javase/8/docs/api/java/io/FileInputStream.html?is-external=true" title="class or interface in java.io">FileInputStream</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1277">deleteFileOnClose</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</a> file)
+<pre>private <a href="https://docs.oracle.com/javase/8/docs/api/java/io/FileInputStream.html?is-external=true" title="class or interface in java.io">FileInputStream</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1283">deleteFileOnClose</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</a> file)
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<div class="block">Create an input stream that deletes the file after reading it. Use in try-with-resources to
avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:
@@ -2190,7 +2190,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>verifyCapacityAndClasses</h4>
-<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1304">verifyCapacityAndClasses</a>(long capacitySize,
+<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1310">verifyCapacityAndClasses</a>(long capacitySize,
<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> ioclass,
<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> mapclass)
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
@@ -2206,7 +2206,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>parsePB</h4>
-<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1320">parsePB</a>(org.apache.hadoop.hbase.shaded.protobuf.generated.BucketCacheProtos.BucketCacheEntry proto)
+<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1326">parsePB</a>(org.apache.hadoop.hbase.shaded.protobuf.generated.BucketCacheProtos.BucketCacheEntry proto)
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -2220,7 +2220,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>checkIOErrorIsTolerated</h4>
-<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1337">checkIOErrorIsTolerated</a>()</pre>
+<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1343">checkIOErrorIsTolerated</a>()</pre>
<div class="block">Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors
exceeds ioErrorsDurationTimeTolerated, we will disable the cache</div>
</li>
@@ -2231,7 +2231,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>disableCache</h4>
-<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1355">disableCache</a>()</pre>
+<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1361">disableCache</a>()</pre>
<div class="block">Used to shut down the cache -or- turn it off in the case of something broken.</div>
</li>
</ul>
@@ -2241,7 +2241,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>join</h4>
-<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1369">join</a>()
+<pre>private void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1375">join</a>()
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/InterruptedException.html?is-external=true" title="class or interface in java.lang">InterruptedException</a></pre>
<dl>
<dt><span class="throwsLabel">Throws:</span></dt>
@@ -2255,7 +2255,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>shutdown</h4>
-<pre>public void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1375">shutdown</a>()</pre>
+<pre>public void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1381">shutdown</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#shutdown--">BlockCache</a></code></span></div>
<div class="block">Shutdown the cache.</div>
<dl>
@@ -2270,7 +2270,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getStats</h4>
-<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/CacheStats.html" title="class in org.apache.hadoop.hbase.io.hfile">CacheStats</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1392">getStats</a>()</pre>
+<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/CacheStats.html" title="class in org.apache.hadoop.hbase.io.hfile">CacheStats</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1398">getStats</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#getStats--">BlockCache</a></code></span></div>
<div class="block">Get the statistics for this block cache.</div>
<dl>
@@ -2285,7 +2285,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getAllocator</h4>
-<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketAllocator.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketAllocator</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1396">getAllocator</a>()</pre>
+<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/bucket/BucketAllocator.html" title="class in org.apache.hadoop.hbase.io.hfile.bucket">BucketAllocator</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1402">getAllocator</a>()</pre>
</li>
</ul>
<a name="heapSize--">
@@ -2294,7 +2294,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>heapSize</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1401">heapSize</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1407">heapSize</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/HeapSize.html#heapSize--">HeapSize</a></code></span></div>
<div class="block">Return the approximate 'exclusive deep size' of implementing object. Includes count of payload
and hosting object sizings.</div>
@@ -2310,7 +2310,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>size</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1406">size</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1412">size</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#size--">BlockCache</a></code></span></div>
<div class="block">Returns the total size of the block cache, in bytes.</div>
<dl>
@@ -2327,7 +2327,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getCurrentDataSize</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1411">getCurrentDataSize</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1417">getCurrentDataSize</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#getCurrentDataSize--">BlockCache</a></code></span></div>
<div class="block">Returns the occupied size of data blocks, in bytes.</div>
<dl>
@@ -2344,7 +2344,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getFreeSize</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1416">getFreeSize</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1422">getFreeSize</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#getFreeSize--">BlockCache</a></code></span></div>
<div class="block">Returns the free size of the block cache, in bytes.</div>
<dl>
@@ -2361,7 +2361,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getBlockCount</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1421">getBlockCount</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1427">getBlockCount</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#getBlockCount--">BlockCache</a></code></span></div>
<div class="block">Returns the number of blocks currently cached in the block cache.</div>
<dl>
@@ -2378,7 +2378,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getDataBlockCount</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1426">getDataBlockCount</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1432">getDataBlockCount</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#getDataBlockCount--">BlockCache</a></code></span></div>
<div class="block">Returns the number of data blocks currently cached in the block cache.</div>
<dl>
@@ -2395,7 +2395,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getCurrentSize</h4>
-<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1431">getCurrentSize</a>()</pre>
+<pre>public long <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1437">getCurrentSize</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#getCurrentSize--">BlockCache</a></code></span></div>
<div class="block">Returns the occupied size of the block cache, in bytes.</div>
<dl>
@@ -2412,7 +2412,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getAlgorithm</h4>
-<pre>protected <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1435">getAlgorithm</a>()</pre>
+<pre>protected <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1441">getAlgorithm</a>()</pre>
</li>
</ul>
<a name="evictBlocksByHfileName-java.lang.String-">
@@ -2421,7 +2421,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>evictBlocksByHfileName</h4>
-<pre>public int <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1446">evictBlocksByHfileName</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> hfileName)</pre>
+<pre>public int <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1452">evictBlocksByHfileName</a>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> hfileName)</pre>
<div class="block">Evicts all blocks for a specific HFile.
<p>
This is used for evict-on-close to remove all blocks of a specific HFile.</div>
@@ -2439,7 +2439,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>stopWriterThreads</h4>
-<pre>void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1587">stopWriterThreads</a>()
+<pre>void <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1593">stopWriterThreads</a>()
throws <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/InterruptedException.html?is-external=true" title="class or interface in java.lang">InterruptedException</a></pre>
<div class="block">Only used in test</div>
<dl>
@@ -2454,7 +2454,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>iterator</h4>
-<pre>public <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/CachedBlock.html" title="interface in org.apache.hadoop.hbase.io.hfile">CachedBlock</a>> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1596">iterator</a>()</pre>
+<pre>public <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html?is-external=true" title="class or interface in java.util">Iterator</a><<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/CachedBlock.html" title="interface in org.apache.hadoop.hbase.io.hfile">CachedBlock</a>> <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1602">iterator</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#iterator--">BlockCache</a></code></span></div>
<div class="block">Returns Iterator over the blocks in the cache.</div>
<dl>
@@ -2471,7 +2471,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getBlockCaches</h4>
-<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html" title="interface in org.apache.hadoop.hbase.io.hfile">BlockCache</a>[] <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1686">getBlockCaches</a>()</pre>
+<pre>public <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html" title="interface in org.apache.hadoop.hbase.io.hfile">BlockCache</a>[] <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1692">getBlockCaches</a>()</pre>
<div class="block"><span class="descfrmTypeLabel">Description copied from interface: <code><a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCache.html#getBlockCaches--">BlockCache</a></code></span></div>
<div class="block">Returns The list of sub blockcaches that make up this one; returns null if no sub caches.</div>
<dl>
@@ -2486,7 +2486,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getRpcRefCount</h4>
-<pre>public int <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1690">getRpcRefCount</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> cacheKey)</pre>
+<pre>public int <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1696">getRpcRefCount</a>(<a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockCacheKey.html" title="class in org.apache.hadoop.hbase.io.hfile">BlockCacheKey</a> cacheKey)</pre>
</li>
</ul>
<a name="getAcceptableFactor--">
@@ -2495,7 +2495,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getAcceptableFactor</h4>
-<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1698">getAcceptableFactor</a>()</pre>
+<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1704">getAcceptableFactor</a>()</pre>
</li>
</ul>
<a name="getMinFactor--">
@@ -2504,7 +2504,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getMinFactor</h4>
-<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1702">getMinFactor</a>()</pre>
+<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1708">getMinFactor</a>()</pre>
</li>
</ul>
<a name="getExtraFreeFactor--">
@@ -2513,7 +2513,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getExtraFreeFactor</h4>
-<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1706">getExtraFreeFactor</a>()</pre>
+<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1712">getExtraFreeFactor</a>()</pre>
</li>
</ul>
<a name="getSingleFactor--">
@@ -2522,7 +2522,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getSingleFactor</h4>
-<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1710">getSingleFactor</a>()</pre>
+<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1716">getSingleFactor</a>()</pre>
</li>
</ul>
<a name="getMultiFactor--">
@@ -2531,7 +2531,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockList">
<li class="blockList">
<h4>getMultiFactor</h4>
-<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1714">getMultiFactor</a>()</pre>
+<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1720">getMultiFactor</a>()</pre>
</li>
</ul>
<a name="getMemoryFactor--">
@@ -2540,7 +2540,7 @@ implements <a href="../../../../../../../org/apache/hadoop/hbase/io/hfile/BlockC
<ul class="blockListLast">
<li class="blockList">
<h4>getMemoryFactor</h4>
-<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1718">getMemoryFactor</a>()</pre>
+<pre>float <a href="../../../../../../../src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html#line.1724">getMemoryFactor</a>()</pre>
</li>
</ul>
</li>
diff --git a/devapidocs/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html b/devapidocs/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html
index 81848443d8a..ff3e4b07875 100644
--- a/devapidocs/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html
+++ b/devapidocs/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html
@@ -341,7 +341,7 @@ extends <a href="../../../../../../org/apache/hadoop/hbase/master/cleaner/BaseHF
<ul class="blockListLast">
<li class="blockList">
<h4>setConf</h4>
-<pre>public void <a href="../../../../../../src-html/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html#line.110">setConf</a>(org.apache.hadoop.conf.Configuration conf)</pre>
+<pre>public void <a href="../../../../../../src-html/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html#line.123">setConf</a>(org.apache.hadoop.conf.Configuration conf)</pre>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code>setConf</code> in interface <code>org.apache.hadoop.conf.Configurable</code></dd>
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html
index 30710531ef1..6b016942fa7 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.BucketEntryGroup.html
@@ -1053,758 +1053,764 @@
<span class="sourceLineNo">1045</span> final HFileContext fileContext = ((HFileBlock) re.getData()).getHFileContext();<a name="line.1045"></a>
<span class="sourceLineNo">1046</span> final String columnFamily = Bytes.toString(fileContext.getColumnFamily());<a name="line.1046"></a>
<span class="sourceLineNo">1047</span> final String tableName = Bytes.toString(fileContext.getTableName());<a name="line.1047"></a>
-<span class="sourceLineNo">1048</span> if (tableName != null && columnFamily != null) {<a name="line.1048"></a>
+<span class="sourceLineNo">1048</span> if (tableName != null) {<a name="line.1048"></a>
<span class="sourceLineNo">1049</span> sb.append(" Table: ");<a name="line.1049"></a>
<span class="sourceLineNo">1050</span> sb.append(tableName);<a name="line.1050"></a>
-<span class="sourceLineNo">1051</span> sb.append(" CF: ");<a name="line.1051"></a>
-<span class="sourceLineNo">1052</span> sb.append(columnFamily);<a name="line.1052"></a>
-<span class="sourceLineNo">1053</span> sb.append(" HFile: ");<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span> sb.append(fileContext.getHFileName());<a name="line.1054"></a>
+<span class="sourceLineNo">1051</span> }<a name="line.1051"></a>
+<span class="sourceLineNo">1052</span> if (columnFamily != null) {<a name="line.1052"></a>
+<span class="sourceLineNo">1053</span> sb.append(" CF: ");<a name="line.1053"></a>
+<span class="sourceLineNo">1054</span> sb.append(columnFamily);<a name="line.1054"></a>
<span class="sourceLineNo">1055</span> }<a name="line.1055"></a>
-<span class="sourceLineNo">1056</span> } else {<a name="line.1056"></a>
-<span class="sourceLineNo">1057</span> sb.append(" HFile: ");<a name="line.1057"></a>
-<span class="sourceLineNo">1058</span> sb.append(re.getKey());<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span> }<a name="line.1059"></a>
-<span class="sourceLineNo">1060</span> }<a name="line.1060"></a>
-<span class="sourceLineNo">1061</span> sb.append(" Message: ");<a name="line.1061"></a>
-<span class="sourceLineNo">1062</span> sb.append(fle.getMessage());<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> return sb.toString();<a name="line.1063"></a>
-<span class="sourceLineNo">1064</span> }<a name="line.1064"></a>
-<span class="sourceLineNo">1065</span><a name="line.1065"></a>
-<span class="sourceLineNo">1066</span> /**<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1067"></a>
-<span class="sourceLineNo">1068</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1068"></a>
-<span class="sourceLineNo">1069</span> * references and we'll OOME.<a name="line.1069"></a>
-<span class="sourceLineNo">1070</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1070"></a>
-<span class="sourceLineNo">1071</span> * interference expected.<a name="line.1071"></a>
-<span class="sourceLineNo">1072</span> */<a name="line.1072"></a>
-<span class="sourceLineNo">1073</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1073"></a>
-<span class="sourceLineNo">1074</span> if (entries.isEmpty()) {<a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> return;<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span> }<a name="line.1076"></a>
-<span class="sourceLineNo">1077</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1078"></a>
-<span class="sourceLineNo">1079</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1081"></a>
-<span class="sourceLineNo">1082</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1082"></a>
-<span class="sourceLineNo">1083</span> final int size = entries.size();<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1084"></a>
-<span class="sourceLineNo">1085</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1086"></a>
-<span class="sourceLineNo">1087</span> int index = 0;<a name="line.1087"></a>
-<span class="sourceLineNo">1088</span> while (cacheEnabled && index < size) {<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span> RAMQueueEntry re = null;<a name="line.1089"></a>
-<span class="sourceLineNo">1090</span> try {<a name="line.1090"></a>
-<span class="sourceLineNo">1091</span> re = entries.get(index);<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span> if (re == null) {<a name="line.1092"></a>
-<span class="sourceLineNo">1093</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span> index++;<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span> continue;<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span> }<a name="line.1096"></a>
-<span class="sourceLineNo">1097</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1097"></a>
-<span class="sourceLineNo">1098</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> blocksByHFile.add(cacheKey);<a name="line.1099"></a>
-<span class="sourceLineNo">1100</span> }<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span> // Reset the position for reuse.<a name="line.1101"></a>
-<span class="sourceLineNo">1102</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1102"></a>
-<span class="sourceLineNo">1103</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span> // IOEngine in the future.<a name="line.1105"></a>
-<span class="sourceLineNo">1106</span> metaBuff.clear();<a name="line.1106"></a>
-<span class="sourceLineNo">1107</span> BucketEntry bucketEntry =<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1108"></a>
-<span class="sourceLineNo">1109</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1109"></a>
-<span class="sourceLineNo">1110</span> bucketEntries[index] = bucketEntry;<a name="line.1110"></a>
-<span class="sourceLineNo">1111</span> if (ioErrorStartTime > 0) {<a name="line.1111"></a>
-<span class="sourceLineNo">1112</span> ioErrorStartTime = -1;<a name="line.1112"></a>
-<span class="sourceLineNo">1113</span> }<a name="line.1113"></a>
-<span class="sourceLineNo">1114</span> index++;<a name="line.1114"></a>
-<span class="sourceLineNo">1115</span> } catch (BucketAllocatorException fle) {<a name="line.1115"></a>
-<span class="sourceLineNo">1116</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1116"></a>
-<span class="sourceLineNo">1117</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span> if (<a name="line.1118"></a>
-<span class="sourceLineNo">1119</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1119"></a>
-<span class="sourceLineNo">1120</span> ) {<a name="line.1120"></a>
-<span class="sourceLineNo">1121</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1121"></a>
-<span class="sourceLineNo">1122</span> allocFailLogPrevTs = currTs;<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span> }<a name="line.1123"></a>
-<span class="sourceLineNo">1124</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span> bucketEntries[index] = null;<a name="line.1125"></a>
-<span class="sourceLineNo">1126</span> index++;<a name="line.1126"></a>
-<span class="sourceLineNo">1127</span> } catch (CacheFullException cfe) {<a name="line.1127"></a>
-<span class="sourceLineNo">1128</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span> if (!freeInProgress) {<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span> freeSpace("Full!");<a name="line.1130"></a>
-<span class="sourceLineNo">1131</span> } else {<a name="line.1131"></a>
-<span class="sourceLineNo">1132</span> Thread.sleep(50);<a name="line.1132"></a>
-<span class="sourceLineNo">1133</span> }<a name="line.1133"></a>
-<span class="sourceLineNo">1134</span> } catch (IOException ioex) {<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1135"></a>
-<span class="sourceLineNo">1136</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1136"></a>
-<span class="sourceLineNo">1137</span> checkIOErrorIsTolerated();<a name="line.1137"></a>
-<span class="sourceLineNo">1138</span> }<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
-<span class="sourceLineNo">1140</span><a name="line.1140"></a>
-<span class="sourceLineNo">1141</span> // Make sure data pages are written on media before we update maps.<a name="line.1141"></a>
-<span class="sourceLineNo">1142</span> try {<a name="line.1142"></a>
-<span class="sourceLineNo">1143</span> ioEngine.sync();<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span> } catch (IOException ioex) {<a name="line.1144"></a>
-<span class="sourceLineNo">1145</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1145"></a>
-<span class="sourceLineNo">1146</span> checkIOErrorIsTolerated();<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1147"></a>
-<span class="sourceLineNo">1148</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> if (bucketEntry != null) {<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> bucketEntries[i] = null;<a name="line.1152"></a>
-<span class="sourceLineNo">1153</span> }<a name="line.1153"></a>
-<span class="sourceLineNo">1154</span> }<a name="line.1154"></a>
-<span class="sourceLineNo">1155</span> }<a name="line.1155"></a>
-<span class="sourceLineNo">1156</span><a name="line.1156"></a>
-<span class="sourceLineNo">1157</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1157"></a>
-<span class="sourceLineNo">1158</span> // success or error.<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span> for (int i = 0; i < size; ++i) {<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1160"></a>
-<span class="sourceLineNo">1161</span> // Only add if non-null entry.<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span> if (bucketEntries[i] != null) {<a name="line.1162"></a>
-<span class="sourceLineNo">1163</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span> }<a name="line.1164"></a>
-<span class="sourceLineNo">1165</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span> if (re != null) {<a name="line.1167"></a>
-<span class="sourceLineNo">1168</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1168"></a>
-<span class="sourceLineNo">1169</span> }<a name="line.1169"></a>
-<span class="sourceLineNo">1170</span> });<a name="line.1170"></a>
-<span class="sourceLineNo">1171</span> if (!existed && bucketEntries[i] != null) {<a name="line.1171"></a>
-<span class="sourceLineNo">1172</span> // Block should have already been evicted. Remove it and free space.<a name="line.1172"></a>
-<span class="sourceLineNo">1173</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1173"></a>
-<span class="sourceLineNo">1174</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1174"></a>
-<span class="sourceLineNo">1175</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1175"></a>
-<span class="sourceLineNo">1176</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1176"></a>
-<span class="sourceLineNo">1177</span> }<a name="line.1177"></a>
-<span class="sourceLineNo">1178</span> return null;<a name="line.1178"></a>
-<span class="sourceLineNo">1179</span> });<a name="line.1179"></a>
-<span class="sourceLineNo">1180</span> }<a name="line.1180"></a>
-<span class="sourceLineNo">1181</span> }<a name="line.1181"></a>
-<span class="sourceLineNo">1182</span><a name="line.1182"></a>
-<span class="sourceLineNo">1183</span> long used = bucketAllocator.getUsedSize();<a name="line.1183"></a>
-<span class="sourceLineNo">1184</span> if (used > acceptableSize()) {<a name="line.1184"></a>
-<span class="sourceLineNo">1185</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1185"></a>
-<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
-<span class="sourceLineNo">1187</span> return;<a name="line.1187"></a>
-<span class="sourceLineNo">1188</span> }<a name="line.1188"></a>
-<span class="sourceLineNo">1189</span><a name="line.1189"></a>
-<span class="sourceLineNo">1190</span> /**<a name="line.1190"></a>
-<span class="sourceLineNo">1191</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1191"></a>
-<span class="sourceLineNo">1192</span> * returning.<a name="line.1192"></a>
-<span class="sourceLineNo">1193</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1193"></a>
-<span class="sourceLineNo">1194</span> * in case.<a name="line.1194"></a>
-<span class="sourceLineNo">1195</span> * @param q The queue to take from.<a name="line.1195"></a>
-<span class="sourceLineNo">1196</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1196"></a>
-<span class="sourceLineNo">1197</span> */<a name="line.1197"></a>
-<span class="sourceLineNo">1198</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1198"></a>
-<span class="sourceLineNo">1199</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1199"></a>
-<span class="sourceLineNo">1200</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1200"></a>
-<span class="sourceLineNo">1201</span> // ok even if list grew to accommodate thousands.<a name="line.1201"></a>
-<span class="sourceLineNo">1202</span> receptacle.clear();<a name="line.1202"></a>
-<span class="sourceLineNo">1203</span> receptacle.add(q.take());<a name="line.1203"></a>
-<span class="sourceLineNo">1204</span> q.drainTo(receptacle);<a name="line.1204"></a>
-<span class="sourceLineNo">1205</span> return receptacle;<a name="line.1205"></a>
-<span class="sourceLineNo">1206</span> }<a name="line.1206"></a>
-<span class="sourceLineNo">1207</span><a name="line.1207"></a>
-<span class="sourceLineNo">1208</span> /**<a name="line.1208"></a>
-<span class="sourceLineNo">1209</span> * @see #retrieveFromFile(int[])<a name="line.1209"></a>
-<span class="sourceLineNo">1210</span> */<a name="line.1210"></a>
-<span class="sourceLineNo">1211</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1211"></a>
-<span class="sourceLineNo">1212</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1212"></a>
-<span class="sourceLineNo">1213</span> private void persistToFile() throws IOException {<a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> assert !cacheEnabled;<a name="line.1214"></a>
-<span class="sourceLineNo">1215</span> if (!ioEngine.isPersistent()) {<a name="line.1215"></a>
-<span class="sourceLineNo">1216</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1216"></a>
-<span class="sourceLineNo">1217</span> }<a name="line.1217"></a>
-<span class="sourceLineNo">1218</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1218"></a>
-<span class="sourceLineNo">1219</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1219"></a>
-<span class="sourceLineNo">1220</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1220"></a>
-<span class="sourceLineNo">1221</span> }<a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> if (prefetchedFileListPath != null) {<a name="line.1222"></a>
-<span class="sourceLineNo">1223</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1223"></a>
-<span class="sourceLineNo">1224</span> }<a name="line.1224"></a>
-<span class="sourceLineNo">1225</span> }<a name="line.1225"></a>
-<span class="sourceLineNo">1226</span><a name="line.1226"></a>
-<span class="sourceLineNo">1227</span> /**<a name="line.1227"></a>
-<span class="sourceLineNo">1228</span> * @see #persistToFile()<a name="line.1228"></a>
-<span class="sourceLineNo">1229</span> */<a name="line.1229"></a>
-<span class="sourceLineNo">1230</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1230"></a>
-<span class="sourceLineNo">1231</span> File persistenceFile = new File(persistencePath);<a name="line.1231"></a>
-<span class="sourceLineNo">1232</span> if (!persistenceFile.exists()) {<a name="line.1232"></a>
-<span class="sourceLineNo">1233</span> return;<a name="line.1233"></a>
-<span class="sourceLineNo">1234</span> }<a name="line.1234"></a>
-<span class="sourceLineNo">1235</span> assert !cacheEnabled;<a name="line.1235"></a>
-<span class="sourceLineNo">1236</span> if (prefetchedFileListPath != null) {<a name="line.1236"></a>
-<span class="sourceLineNo">1237</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1237"></a>
-<span class="sourceLineNo">1238</span> }<a name="line.1238"></a>
-<span class="sourceLineNo">1239</span><a name="line.1239"></a>
-<span class="sourceLineNo">1240</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1240"></a>
-<span class="sourceLineNo">1241</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1241"></a>
-<span class="sourceLineNo">1242</span> byte[] pbuf = new byte[pblen];<a name="line.1242"></a>
-<span class="sourceLineNo">1243</span> int read = in.read(pbuf);<a name="line.1243"></a>
-<span class="sourceLineNo">1244</span> if (read != pblen) {<a name="line.1244"></a>
-<span class="sourceLineNo">1245</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1245"></a>
-<span class="sourceLineNo">1246</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1246"></a>
-<span class="sourceLineNo">1247</span> }<a name="line.1247"></a>
-<span class="sourceLineNo">1248</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1248"></a>
-<span class="sourceLineNo">1249</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1249"></a>
-<span class="sourceLineNo">1250</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1250"></a>
-<span class="sourceLineNo">1251</span> throw new IOException(<a name="line.1251"></a>
-<span class="sourceLineNo">1252</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1252"></a>
+<span class="sourceLineNo">1056</span> sb.append(" HFile: ");<a name="line.1056"></a>
+<span class="sourceLineNo">1057</span> if (fileContext.getHFileName() != null) {<a name="line.1057"></a>
+<span class="sourceLineNo">1058</span> sb.append(fileContext.getHFileName());<a name="line.1058"></a>
+<span class="sourceLineNo">1059</span> } else {<a name="line.1059"></a>
+<span class="sourceLineNo">1060</span> sb.append(re.getKey());<a name="line.1060"></a>
+<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
+<span class="sourceLineNo">1062</span> } else {<a name="line.1062"></a>
+<span class="sourceLineNo">1063</span> sb.append(" HFile: ");<a name="line.1063"></a>
+<span class="sourceLineNo">1064</span> sb.append(re.getKey());<a name="line.1064"></a>
+<span class="sourceLineNo">1065</span> }<a name="line.1065"></a>
+<span class="sourceLineNo">1066</span> }<a name="line.1066"></a>
+<span class="sourceLineNo">1067</span> sb.append(" Message: ");<a name="line.1067"></a>
+<span class="sourceLineNo">1068</span> sb.append(fle.getMessage());<a name="line.1068"></a>
+<span class="sourceLineNo">1069</span> return sb.toString();<a name="line.1069"></a>
+<span class="sourceLineNo">1070</span> }<a name="line.1070"></a>
+<span class="sourceLineNo">1071</span><a name="line.1071"></a>
+<span class="sourceLineNo">1072</span> /**<a name="line.1072"></a>
+<span class="sourceLineNo">1073</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1073"></a>
+<span class="sourceLineNo">1074</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1074"></a>
+<span class="sourceLineNo">1075</span> * references and we'll OOME.<a name="line.1075"></a>
+<span class="sourceLineNo">1076</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1076"></a>
+<span class="sourceLineNo">1077</span> * interference expected.<a name="line.1077"></a>
+<span class="sourceLineNo">1078</span> */<a name="line.1078"></a>
+<span class="sourceLineNo">1079</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1079"></a>
+<span class="sourceLineNo">1080</span> if (entries.isEmpty()) {<a name="line.1080"></a>
+<span class="sourceLineNo">1081</span> return;<a name="line.1081"></a>
+<span class="sourceLineNo">1082</span> }<a name="line.1082"></a>
+<span class="sourceLineNo">1083</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1083"></a>
+<span class="sourceLineNo">1084</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1084"></a>
+<span class="sourceLineNo">1085</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1085"></a>
+<span class="sourceLineNo">1086</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1086"></a>
+<span class="sourceLineNo">1087</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1087"></a>
+<span class="sourceLineNo">1088</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1088"></a>
+<span class="sourceLineNo">1089</span> final int size = entries.size();<a name="line.1089"></a>
+<span class="sourceLineNo">1090</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1090"></a>
+<span class="sourceLineNo">1091</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1091"></a>
+<span class="sourceLineNo">1092</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1092"></a>
+<span class="sourceLineNo">1093</span> int index = 0;<a name="line.1093"></a>
+<span class="sourceLineNo">1094</span> while (cacheEnabled && index < size) {<a name="line.1094"></a>
+<span class="sourceLineNo">1095</span> RAMQueueEntry re = null;<a name="line.1095"></a>
+<span class="sourceLineNo">1096</span> try {<a name="line.1096"></a>
+<span class="sourceLineNo">1097</span> re = entries.get(index);<a name="line.1097"></a>
+<span class="sourceLineNo">1098</span> if (re == null) {<a name="line.1098"></a>
+<span class="sourceLineNo">1099</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1099"></a>
+<span class="sourceLineNo">1100</span> index++;<a name="line.1100"></a>
+<span class="sourceLineNo">1101</span> continue;<a name="line.1101"></a>
+<span class="sourceLineNo">1102</span> }<a name="line.1102"></a>
+<span class="sourceLineNo">1103</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1103"></a>
+<span class="sourceLineNo">1104</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1104"></a>
+<span class="sourceLineNo">1105</span> blocksByHFile.add(cacheKey);<a name="line.1105"></a>
+<span class="sourceLineNo">1106</span> }<a name="line.1106"></a>
+<span class="sourceLineNo">1107</span> // Reset the position for reuse.<a name="line.1107"></a>
+<span class="sourceLineNo">1108</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1108"></a>
+<span class="sourceLineNo">1109</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1109"></a>
+<span class="sourceLineNo">1110</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1110"></a>
+<span class="sourceLineNo">1111</span> // IOEngine in the future.<a name="line.1111"></a>
+<span class="sourceLineNo">1112</span> metaBuff.clear();<a name="line.1112"></a>
+<span class="sourceLineNo">1113</span> BucketEntry bucketEntry =<a name="line.1113"></a>
+<span class="sourceLineNo">1114</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1114"></a>
+<span class="sourceLineNo">1115</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1115"></a>
+<span class="sourceLineNo">1116</span> bucketEntries[index] = bucketEntry;<a name="line.1116"></a>
+<span class="sourceLineNo">1117</span> if (ioErrorStartTime > 0) {<a name="line.1117"></a>
+<span class="sourceLineNo">1118</span> ioErrorStartTime = -1;<a name="line.1118"></a>
+<span class="sourceLineNo">1119</span> }<a name="line.1119"></a>
+<span class="sourceLineNo">1120</span> index++;<a name="line.1120"></a>
+<span class="sourceLineNo">1121</span> } catch (BucketAllocatorException fle) {<a name="line.1121"></a>
+<span class="sourceLineNo">1122</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1122"></a>
+<span class="sourceLineNo">1123</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1123"></a>
+<span class="sourceLineNo">1124</span> if (<a name="line.1124"></a>
+<span class="sourceLineNo">1125</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1125"></a>
+<span class="sourceLineNo">1126</span> ) {<a name="line.1126"></a>
+<span class="sourceLineNo">1127</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1127"></a>
+<span class="sourceLineNo">1128</span> allocFailLogPrevTs = currTs;<a name="line.1128"></a>
+<span class="sourceLineNo">1129</span> }<a name="line.1129"></a>
+<span class="sourceLineNo">1130</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1130"></a>
+<span class="sourceLineNo">1131</span> bucketEntries[index] = null;<a name="line.1131"></a>
+<span class="sourceLineNo">1132</span> index++;<a name="line.1132"></a>
+<span class="sourceLineNo">1133</span> } catch (CacheFullException cfe) {<a name="line.1133"></a>
+<span class="sourceLineNo">1134</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1134"></a>
+<span class="sourceLineNo">1135</span> if (!freeInProgress) {<a name="line.1135"></a>
+<span class="sourceLineNo">1136</span> freeSpace("Full!");<a name="line.1136"></a>
+<span class="sourceLineNo">1137</span> } else {<a name="line.1137"></a>
+<span class="sourceLineNo">1138</span> Thread.sleep(50);<a name="line.1138"></a>
+<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
+<span class="sourceLineNo">1140</span> } catch (IOException ioex) {<a name="line.1140"></a>
+<span class="sourceLineNo">1141</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1141"></a>
+<span class="sourceLineNo">1142</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1142"></a>
+<span class="sourceLineNo">1143</span> checkIOErrorIsTolerated();<a name="line.1143"></a>
+<span class="sourceLineNo">1144</span> }<a name="line.1144"></a>
+<span class="sourceLineNo">1145</span> }<a name="line.1145"></a>
+<span class="sourceLineNo">1146</span><a name="line.1146"></a>
+<span class="sourceLineNo">1147</span> // Make sure data pages are written on media before we update maps.<a name="line.1147"></a>
+<span class="sourceLineNo">1148</span> try {<a name="line.1148"></a>
+<span class="sourceLineNo">1149</span> ioEngine.sync();<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span> } catch (IOException ioex) {<a name="line.1150"></a>
+<span class="sourceLineNo">1151</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1151"></a>
+<span class="sourceLineNo">1152</span> checkIOErrorIsTolerated();<a name="line.1152"></a>
+<span class="sourceLineNo">1153</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1153"></a>
+<span class="sourceLineNo">1154</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1154"></a>
+<span class="sourceLineNo">1155</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1155"></a>
+<span class="sourceLineNo">1156</span> if (bucketEntry != null) {<a name="line.1156"></a>
+<span class="sourceLineNo">1157</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1157"></a>
+<span class="sourceLineNo">1158</span> bucketEntries[i] = null;<a name="line.1158"></a>
+<span class="sourceLineNo">1159</span> }<a name="line.1159"></a>
+<span class="sourceLineNo">1160</span> }<a name="line.1160"></a>
+<span class="sourceLineNo">1161</span> }<a name="line.1161"></a>
+<span class="sourceLineNo">1162</span><a name="line.1162"></a>
+<span class="sourceLineNo">1163</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1163"></a>
+<span class="sourceLineNo">1164</span> // success or error.<a name="line.1164"></a>
+<span class="sourceLineNo">1165</span> for (int i = 0; i < size; ++i) {<a name="line.1165"></a>
+<span class="sourceLineNo">1166</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1166"></a>
+<span class="sourceLineNo">1167</span> // Only add if non-null entry.<a name="line.1167"></a>
+<span class="sourceLineNo">1168</span> if (bucketEntries[i] != null) {<a name="line.1168"></a>
+<span class="sourceLineNo">1169</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1169"></a>
+<span class="sourceLineNo">1170</span> }<a name="line.1170"></a>
+<span class="sourceLineNo">1171</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1171"></a>
+<span class="sourceLineNo">1172</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1172"></a>
+<span class="sourceLineNo">1173</span> if (re != null) {<a name="line.1173"></a>
+<span class="sourceLineNo">1174</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1174"></a>
+<span class="sourceLineNo">1175</span> }<a name="line.1175"></a>
+<span class="sourceLineNo">1176</span> });<a name="line.1176"></a>
+<span class="sourceLineNo">1177</span> if (!existed && bucketEntries[i] != null) {<a name="line.1177"></a>
+<span class="sourceLineNo">1178</span> // Block should have already been evicted. Remove it and free space.<a name="line.1178"></a>
+<span class="sourceLineNo">1179</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1179"></a>
+<span class="sourceLineNo">1180</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1180"></a>
+<span class="sourceLineNo">1181</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1181"></a>
+<span class="sourceLineNo">1182</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1182"></a>
+<span class="sourceLineNo">1183</span> }<a name="line.1183"></a>
+<span class="sourceLineNo">1184</span> return null;<a name="line.1184"></a>
+<span class="sourceLineNo">1185</span> });<a name="line.1185"></a>
+<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
+<span class="sourceLineNo">1187</span> }<a name="line.1187"></a>
+<span class="sourceLineNo">1188</span><a name="line.1188"></a>
+<span class="sourceLineNo">1189</span> long used = bucketAllocator.getUsedSize();<a name="line.1189"></a>
+<span class="sourceLineNo">1190</span> if (used > acceptableSize()) {<a name="line.1190"></a>
+<span class="sourceLineNo">1191</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1191"></a>
+<span class="sourceLineNo">1192</span> }<a name="line.1192"></a>
+<span class="sourceLineNo">1193</span> return;<a name="line.1193"></a>
+<span class="sourceLineNo">1194</span> }<a name="line.1194"></a>
+<span class="sourceLineNo">1195</span><a name="line.1195"></a>
+<span class="sourceLineNo">1196</span> /**<a name="line.1196"></a>
+<span class="sourceLineNo">1197</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1197"></a>
+<span class="sourceLineNo">1198</span> * returning.<a name="line.1198"></a>
+<span class="sourceLineNo">1199</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1199"></a>
+<span class="sourceLineNo">1200</span> * in case.<a name="line.1200"></a>
+<span class="sourceLineNo">1201</span> * @param q The queue to take from.<a name="line.1201"></a>
+<span class="sourceLineNo">1202</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1202"></a>
+<span class="sourceLineNo">1203</span> */<a name="line.1203"></a>
+<span class="sourceLineNo">1204</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1204"></a>
+<span class="sourceLineNo">1205</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1205"></a>
+<span class="sourceLineNo">1206</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1206"></a>
+<span class="sourceLineNo">1207</span> // ok even if list grew to accommodate thousands.<a name="line.1207"></a>
+<span class="sourceLineNo">1208</span> receptacle.clear();<a name="line.1208"></a>
+<span class="sourceLineNo">1209</span> receptacle.add(q.take());<a name="line.1209"></a>
+<span class="sourceLineNo">1210</span> q.drainTo(receptacle);<a name="line.1210"></a>
+<span class="sourceLineNo">1211</span> return receptacle;<a name="line.1211"></a>
+<span class="sourceLineNo">1212</span> }<a name="line.1212"></a>
+<span class="sourceLineNo">1213</span><a name="line.1213"></a>
+<span class="sourceLineNo">1214</span> /**<a name="line.1214"></a>
+<span class="sourceLineNo">1215</span> * @see #retrieveFromFile(int[])<a name="line.1215"></a>
+<span class="sourceLineNo">1216</span> */<a name="line.1216"></a>
+<span class="sourceLineNo">1217</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1217"></a>
+<span class="sourceLineNo">1218</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1218"></a>
+<span class="sourceLineNo">1219</span> private void persistToFile() throws IOException {<a name="line.1219"></a>
+<span class="sourceLineNo">1220</span> assert !cacheEnabled;<a name="line.1220"></a>
+<span class="sourceLineNo">1221</span> if (!ioEngine.isPersistent()) {<a name="line.1221"></a>
+<span class="sourceLineNo">1222</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1222"></a>
+<span class="sourceLineNo">1223</span> }<a name="line.1223"></a>
+<span class="sourceLineNo">1224</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1224"></a>
+<span class="sourceLineNo">1225</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1225"></a>
+<span class="sourceLineNo">1226</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1226"></a>
+<span class="sourceLineNo">1227</span> }<a name="line.1227"></a>
+<span class="sourceLineNo">1228</span> if (prefetchedFileListPath != null) {<a name="line.1228"></a>
+<span class="sourceLineNo">1229</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1229"></a>
+<span class="sourceLineNo">1230</span> }<a name="line.1230"></a>
+<span class="sourceLineNo">1231</span> }<a name="line.1231"></a>
+<span class="sourceLineNo">1232</span><a name="line.1232"></a>
+<span class="sourceLineNo">1233</span> /**<a name="line.1233"></a>
+<span class="sourceLineNo">1234</span> * @see #persistToFile()<a name="line.1234"></a>
+<span class="sourceLineNo">1235</span> */<a name="line.1235"></a>
+<span class="sourceLineNo">1236</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1236"></a>
+<span class="sourceLineNo">1237</span> File persistenceFile = new File(persistencePath);<a name="line.1237"></a>
+<span class="sourceLineNo">1238</span> if (!persistenceFile.exists()) {<a name="line.1238"></a>
+<span class="sourceLineNo">1239</span> return;<a name="line.1239"></a>
+<span class="sourceLineNo">1240</span> }<a name="line.1240"></a>
+<span class="sourceLineNo">1241</span> assert !cacheEnabled;<a name="line.1241"></a>
+<span class="sourceLineNo">1242</span> if (prefetchedFileListPath != null) {<a name="line.1242"></a>
+<span class="sourceLineNo">1243</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1243"></a>
+<span class="sourceLineNo">1244</span> }<a name="line.1244"></a>
+<span class="sourceLineNo">1245</span><a name="line.1245"></a>
+<span class="sourceLineNo">1246</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1246"></a>
+<span class="sourceLineNo">1247</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1247"></a>
+<span class="sourceLineNo">1248</span> byte[] pbuf = new byte[pblen];<a name="line.1248"></a>
+<span class="sourceLineNo">1249</span> int read = in.read(pbuf);<a name="line.1249"></a>
+<span class="sourceLineNo">1250</span> if (read != pblen) {<a name="line.1250"></a>
+<span class="sourceLineNo">1251</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1251"></a>
+<span class="sourceLineNo">1252</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1252"></a>
<span class="sourceLineNo">1253</span> }<a name="line.1253"></a>
-<span class="sourceLineNo">1254</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1254"></a>
-<span class="sourceLineNo">1255</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1255"></a>
-<span class="sourceLineNo">1256</span> blockNumber.add(backingMap.size());<a name="line.1256"></a>
-<span class="sourceLineNo">1257</span> }<a name="line.1257"></a>
-<span class="sourceLineNo">1258</span> }<a name="line.1258"></a>
-<span class="sourceLineNo">1259</span><a name="line.1259"></a>
-<span class="sourceLineNo">1260</span> /**<a name="line.1260"></a>
-<span class="sourceLineNo">1261</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1261"></a>
-<span class="sourceLineNo">1262</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1262"></a>
-<span class="sourceLineNo">1263</span> *<a name="line.1263"></a>
-<span class="sourceLineNo">1264</span> * <pre><a name="line.1264"></a>
-<span class="sourceLineNo">1265</span> * File f = ...<a name="line.1265"></a>
-<span class="sourceLineNo">1266</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1266"></a>
-<span class="sourceLineNo">1267</span> * // use the input stream<a name="line.1267"></a>
-<span class="sourceLineNo">1268</span> * } finally {<a name="line.1268"></a>
-<span class="sourceLineNo">1269</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1269"></a>
-<span class="sourceLineNo">1270</span> * }<a name="line.1270"></a>
-<span class="sourceLineNo">1271</span> * </pre><a name="line.1271"></a>
-<span class="sourceLineNo">1272</span> *<a name="line.1272"></a>
-<span class="sourceLineNo">1273</span> * @param file the file to read and delete<a name="line.1273"></a>
-<span class="sourceLineNo">1274</span> * @return a FileInputStream for the given file<a name="line.1274"></a>
-<span class="sourceLineNo">1275</span> * @throws IOException if there is a problem creating the stream<a name="line.1275"></a>
-<span class="sourceLineNo">1276</span> */<a name="line.1276"></a>
-<span class="sourceLineNo">1277</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1277"></a>
-<span class="sourceLineNo">1278</span> return new FileInputStream(file) {<a name="line.1278"></a>
-<span class="sourceLineNo">1279</span> private File myFile;<a name="line.1279"></a>
-<span class="sourceLineNo">1280</span><a name="line.1280"></a>
-<span class="sourceLineNo">1281</span> private FileInputStream init(File file) {<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> myFile = file;<a name="line.1282"></a>
-<span class="sourceLineNo">1283</span> return this;<a name="line.1283"></a>
-<span class="sourceLineNo">1284</span> }<a name="line.1284"></a>
-<span class="sourceLineNo">1285</span><a name="line.1285"></a>
-<span class="sourceLineNo">1286</span> @Override<a name="line.1286"></a>
-<span class="sourceLineNo">1287</span> public void close() throws IOException {<a name="line.1287"></a>
-<span class="sourceLineNo">1288</span> // close() will be called during try-with-resources and it will be<a name="line.1288"></a>
-<span class="sourceLineNo">1289</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1289"></a>
-<span class="sourceLineNo">1290</span> // set myFile to null after the first call.<a name="line.1290"></a>
-<span class="sourceLineNo">1291</span> if (myFile == null) {<a name="line.1291"></a>
-<span class="sourceLineNo">1292</span> return;<a name="line.1292"></a>
-<span class="sourceLineNo">1293</span> }<a name="line.1293"></a>
-<span class="sourceLineNo">1294</span><a name="line.1294"></a>
-<span class="sourceLineNo">1295</span> super.close();<a name="line.1295"></a>
-<span class="sourceLineNo">1296</span> if (!myFile.delete()) {<a name="line.1296"></a>
-<span class="sourceLineNo">1297</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1297"></a>
-<span class="sourceLineNo">1298</span> }<a name="line.1298"></a>
-<span class="sourceLineNo">1299</span> myFile = null;<a name="line.1299"></a>
-<span class="sourceLineNo">1300</span> }<a name="line.1300"></a>
-<span class="sourceLineNo">1301</span> }.init(file);<a name="line.1301"></a>
-<span class="sourceLineNo">1302</span> }<a name="line.1302"></a>
-<span class="sourceLineNo">1303</span><a name="line.1303"></a>
-<span class="sourceLineNo">1304</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1304"></a>
-<span class="sourceLineNo">1305</span> throws IOException {<a name="line.1305"></a>
-<span class="sourceLineNo">1306</span> if (capacitySize != cacheCapacity) {<a name="line.1306"></a>
-<span class="sourceLineNo">1307</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1307"></a>
-<span class="sourceLineNo">1308</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1308"></a>
-<span class="sourceLineNo">1309</span> }<a name="line.1309"></a>
-<span class="sourceLineNo">1310</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1310"></a>
-<span class="sourceLineNo">1311</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1311"></a>
-<span class="sourceLineNo">1312</span> + ioEngine.getClass().getName());<a name="line.1312"></a>
-<span class="sourceLineNo">1313</span> }<a name="line.1313"></a>
-<span class="sourceLineNo">1314</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1314"></a>
-<span class="sourceLineNo">1315</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1315"></a>
-<span class="sourceLineNo">1316</span> + backingMap.getClass().getName());<a name="line.1316"></a>
-<span class="sourceLineNo">1317</span> }<a name="line.1317"></a>
-<span class="sourceLineNo">1318</span> }<a name="line.1318"></a>
-<span class="sourceLineNo">1319</span><a name="line.1319"></a>
-<span class="sourceLineNo">1320</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1320"></a>
-<span class="sourceLineNo">1321</span> if (proto.hasChecksum()) {<a name="line.1321"></a>
-<span class="sourceLineNo">1322</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1322"></a>
-<span class="sourceLineNo">1323</span> algorithm);<a name="line.1323"></a>
-<span class="sourceLineNo">1324</span> } else {<a name="line.1324"></a>
-<span class="sourceLineNo">1325</span> // if has not checksum, it means the persistence file is old format<a name="line.1325"></a>
-<span class="sourceLineNo">1326</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1326"></a>
-<span class="sourceLineNo">1327</span> }<a name="line.1327"></a>
-<span class="sourceLineNo">1328</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1328"></a>
-<span class="sourceLineNo">1329</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1329"></a>
-<span class="sourceLineNo">1330</span> this::createRecycler);<a name="line.1330"></a>
-<span class="sourceLineNo">1331</span> }<a name="line.1331"></a>
-<span class="sourceLineNo">1332</span><a name="line.1332"></a>
-<span class="sourceLineNo">1333</span> /**<a name="line.1333"></a>
-<span class="sourceLineNo">1334</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1334"></a>
-<span class="sourceLineNo">1335</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1335"></a>
-<span class="sourceLineNo">1336</span> */<a name="line.1336"></a>
-<span class="sourceLineNo">1337</span> private void checkIOErrorIsTolerated() {<a name="line.1337"></a>
-<span class="sourceLineNo">1338</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1338"></a>
-<span class="sourceLineNo">1339</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1339"></a>
-<span class="sourceLineNo">1340</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1340"></a>
-<span class="sourceLineNo">1341</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1341"></a>
-<span class="sourceLineNo">1342</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1343"></a>
-<span class="sourceLineNo">1344</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1344"></a>
-<span class="sourceLineNo">1345</span> disableCache();<a name="line.1345"></a>
-<span class="sourceLineNo">1346</span> }<a name="line.1346"></a>
-<span class="sourceLineNo">1347</span> } else {<a name="line.1347"></a>
-<span class="sourceLineNo">1348</span> this.ioErrorStartTime = now;<a name="line.1348"></a>
-<span class="sourceLineNo">1349</span> }<a name="line.1349"></a>
-<span class="sourceLineNo">1350</span> }<a name="line.1350"></a>
-<span class="sourceLineNo">1351</span><a name="line.1351"></a>
-<span class="sourceLineNo">1352</span> /**<a name="line.1352"></a>
-<span class="sourceLineNo">1353</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1353"></a>
-<span class="sourceLineNo">1354</span> */<a name="line.1354"></a>
-<span class="sourceLineNo">1355</span> private void disableCache() {<a name="line.1355"></a>
-<span class="sourceLineNo">1356</span> if (!cacheEnabled) return;<a name="line.1356"></a>
-<span class="sourceLineNo">1357</span> cacheEnabled = false;<a name="line.1357"></a>
-<span class="sourceLineNo">1358</span> ioEngine.shutdown();<a name="line.1358"></a>
-<span class="sourceLineNo">1359</span> this.scheduleThreadPool.shutdown();<a name="line.1359"></a>
-<span class="sourceLineNo">1360</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1360"></a>
-<span class="sourceLineNo">1361</span> writerThreads[i].interrupt();<a name="line.1361"></a>
-<span class="sourceLineNo">1362</span> this.ramCache.clear();<a name="line.1362"></a>
-<span class="sourceLineNo">1363</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1363"></a>
-<span class="sourceLineNo">1364</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1364"></a>
-<span class="sourceLineNo">1365</span> this.backingMap.clear();<a name="line.1365"></a>
-<span class="sourceLineNo">1366</span> }<a name="line.1366"></a>
-<span class="sourceLineNo">1367</span> }<a name="line.1367"></a>
-<span class="sourceLineNo">1368</span><a name="line.1368"></a>
-<span class="sourceLineNo">1369</span> private void join() throws InterruptedException {<a name="line.1369"></a>
-<span class="sourceLineNo">1370</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1370"></a>
-<span class="sourceLineNo">1371</span> writerThreads[i].join();<a name="line.1371"></a>
-<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
-<span class="sourceLineNo">1373</span><a name="line.1373"></a>
-<span class="sourceLineNo">1374</span> @Override<a name="line.1374"></a>
-<span class="sourceLineNo">1375</span> public void shutdown() {<a name="line.1375"></a>
-<span class="sourceLineNo">1376</span> disableCache();<a name="line.1376"></a>
-<span class="sourceLineNo">1377</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1377"></a>
-<span class="sourceLineNo">1378</span> + persistencePath);<a name="line.1378"></a>
-<span class="sourceLineNo">1379</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1379"></a>
-<span class="sourceLineNo">1380</span> try {<a name="line.1380"></a>
-<span class="sourceLineNo">1381</span> join();<a name="line.1381"></a>
-<span class="sourceLineNo">1382</span> persistToFile();<a name="line.1382"></a>
-<span class="sourceLineNo">1383</span> } catch (IOException ex) {<a name="line.1383"></a>
-<span class="sourceLineNo">1384</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1384"></a>
-<span class="sourceLineNo">1385</span> } catch (InterruptedException e) {<a name="line.1385"></a>
-<span class="sourceLineNo">1386</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> }<a name="line.1387"></a>
-<span class="sourceLineNo">1388</span> }<a name="line.1388"></a>
-<span class="sourceLineNo">1389</span> }<a name="line.1389"></a>
-<span class="sourceLineNo">1390</span><a name="line.1390"></a>
-<span class="sourceLineNo">1391</span> @Override<a name="line.1391"></a>
-<span class="sourceLineNo">1392</span> public CacheStats getStats() {<a name="line.1392"></a>
-<span class="sourceLineNo">1393</span> return cacheStats;<a name="line.1393"></a>
-<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
-<span class="sourceLineNo">1395</span><a name="line.1395"></a>
-<span class="sourceLineNo">1396</span> public BucketAllocator getAllocator() {<a name="line.1396"></a>
-<span class="sourceLineNo">1397</span> return this.bucketAllocator;<a name="line.1397"></a>
-<span class="sourceLineNo">1398</span> }<a name="line.1398"></a>
-<span class="sourceLineNo">1399</span><a name="line.1399"></a>
-<span class="sourceLineNo">1400</span> @Override<a name="line.1400"></a>
-<span class="sourceLineNo">1401</span> public long heapSize() {<a name="line.1401"></a>
-<span class="sourceLineNo">1402</span> return this.heapSize.sum();<a name="line.1402"></a>
-<span class="sourceLineNo">1403</span> }<a name="line.1403"></a>
-<span class="sourceLineNo">1404</span><a name="line.1404"></a>
-<span class="sourceLineNo">1405</span> @Override<a name="line.1405"></a>
-<span class="sourceLineNo">1406</span> public long size() {<a name="line.1406"></a>
-<span class="sourceLineNo">1407</span> return this.realCacheSize.sum();<a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> }<a name="line.1408"></a>
-<span class="sourceLineNo">1409</span><a name="line.1409"></a>
-<span class="sourceLineNo">1410</span> @Override<a name="line.1410"></a>
-<span class="sourceLineNo">1411</span> public long getCurrentDataSize() {<a name="line.1411"></a>
-<span class="sourceLineNo">1412</span> return size();<a name="line.1412"></a>
-<span class="sourceLineNo">1413</span> }<a name="line.1413"></a>
-<span class="sourceLineNo">1414</span><a name="line.1414"></a>
-<span class="sourceLineNo">1415</span> @Override<a name="line.1415"></a>
-<span class="sourceLineNo">1416</span> public long getFreeSize() {<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> return this.bucketAllocator.getFreeSize();<a name="line.1417"></a>
-<span class="sourceLineNo">1418</span> }<a name="line.1418"></a>
-<span class="sourceLineNo">1419</span><a name="line.1419"></a>
-<span class="sourceLineNo">1420</span> @Override<a name="line.1420"></a>
-<span class="sourceLineNo">1421</span> public long getBlockCount() {<a name="line.1421"></a>
-<span class="sourceLineNo">1422</span> return this.blockNumber.sum();<a name="line.1422"></a>
-<span class="sourceLineNo">1423</span> }<a name="line.1423"></a>
-<span class="sourceLineNo">1424</span><a name="line.1424"></a>
-<span class="sourceLineNo">1425</span> @Override<a name="line.1425"></a>
-<span class="sourceLineNo">1426</span> public long getDataBlockCount() {<a name="line.1426"></a>
-<span class="sourceLineNo">1427</span> return getBlockCount();<a name="line.1427"></a>
-<span class="sourceLineNo">1428</span> }<a name="line.1428"></a>
-<span class="sourceLineNo">1429</span><a name="line.1429"></a>
-<span class="sourceLineNo">1430</span> @Override<a name="line.1430"></a>
-<span class="sourceLineNo">1431</span> public long getCurrentSize() {<a name="line.1431"></a>
-<span class="sourceLineNo">1432</span> return this.bucketAllocator.getUsedSize();<a name="line.1432"></a>
-<span class="sourceLineNo">1433</span> }<a name="line.1433"></a>
-<span class="sourceLineNo">1434</span><a name="line.1434"></a>
-<span class="sourceLineNo">1435</span> protected String getAlgorithm() {<a name="line.1435"></a>
-<span class="sourceLineNo">1436</span> return algorithm;<a name="line.1436"></a>
-<span class="sourceLineNo">1437</span> }<a name="line.1437"></a>
-<span class="sourceLineNo">1438</span><a name="line.1438"></a>
-<span class="sourceLineNo">1439</span> /**<a name="line.1439"></a>
-<span class="sourceLineNo">1440</span> * Evicts all blocks for a specific HFile.<a name="line.1440"></a>
-<span class="sourceLineNo">1441</span> * <p><a name="line.1441"></a>
-<span class="sourceLineNo">1442</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1442"></a>
-<span class="sourceLineNo">1443</span> * @return the number of blocks evicted<a name="line.1443"></a>
-<span class="sourceLineNo">1444</span> */<a name="line.1444"></a>
-<span class="sourceLineNo">1445</span> @Override<a name="line.1445"></a>
-<span class="sourceLineNo">1446</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1446"></a>
-<span class="sourceLineNo">1447</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1447"></a>
-<span class="sourceLineNo">1448</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1448"></a>
-<span class="sourceLineNo">1449</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1449"></a>
-<span class="sourceLineNo">1450</span><a name="line.1450"></a>
-<span class="sourceLineNo">1451</span> int numEvicted = 0;<a name="line.1451"></a>
-<span class="sourceLineNo">1452</span> for (BlockCacheKey key : keySet) {<a name="line.1452"></a>
-<span class="sourceLineNo">1453</span> if (evictBlock(key)) {<a name="line.1453"></a>
-<span class="sourceLineNo">1454</span> ++numEvicted;<a name="line.1454"></a>
-<span class="sourceLineNo">1455</span> }<a name="line.1455"></a>
-<span class="sourceLineNo">1456</span> }<a name="line.1456"></a>
-<span class="sourceLineNo">1457</span><a name="line.1457"></a>
-<span class="sourceLineNo">1458</span> return numEvicted;<a name="line.1458"></a>
-<span class="sourceLineNo">1459</span> }<a name="line.1459"></a>
-<span class="sourceLineNo">1460</span><a name="line.1460"></a>
-<span class="sourceLineNo">1461</span> /**<a name="line.1461"></a>
-<span class="sourceLineNo">1462</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1462"></a>
-<span class="sourceLineNo">1463</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1463"></a>
-<span class="sourceLineNo">1464</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1464"></a>
-<span class="sourceLineNo">1465</span> */<a name="line.1465"></a>
-<span class="sourceLineNo">1466</span> private class BucketEntryGroup {<a name="line.1466"></a>
-<span class="sourceLineNo">1467</span><a name="line.1467"></a>
-<span class="sourceLineNo">1468</span> private CachedEntryQueue queue;<a name="line.1468"></a>
-<span class="sourceLineNo">1469</span> private long totalSize = 0;<a name="line.1469"></a>
-<span class="sourceLineNo">1470</span> private long bucketSize;<a name="line.1470"></a>
-<span class="sourceLineNo">1471</span><a name="line.1471"></a>
-<span class="sourceLineNo">1472</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1472"></a>
-<span class="sourceLineNo">1473</span> this.bucketSize = bucketSize;<a name="line.1473"></a>
-<span class="sourceLineNo">1474</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1474"></a>
-<span class="sourceLineNo">1475</span> totalSize = 0;<a name="line.1475"></a>
-<span class="sourceLineNo">1476</span> }<a name="line.1476"></a>
+<span class="sourceLineNo">1254</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1254"></a>
+<span class="sourceLineNo">1255</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1255"></a>
+<span class="sourceLineNo">1256</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1256"></a>
+<span class="sourceLineNo">1257</span> throw new IOException(<a name="line.1257"></a>
+<span class="sourceLineNo">1258</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1258"></a>
+<span class="sourceLineNo">1259</span> }<a name="line.1259"></a>
+<span class="sourceLineNo">1260</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1260"></a>
+<span class="sourceLineNo">1261</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1261"></a>
+<span class="sourceLineNo">1262</span> blockNumber.add(backingMap.size());<a name="line.1262"></a>
+<span class="sourceLineNo">1263</span> }<a name="line.1263"></a>
+<span class="sourceLineNo">1264</span> }<a name="line.1264"></a>
+<span class="sourceLineNo">1265</span><a name="line.1265"></a>
+<span class="sourceLineNo">1266</span> /**<a name="line.1266"></a>
+<span class="sourceLineNo">1267</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1267"></a>
+<span class="sourceLineNo">1268</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1268"></a>
+<span class="sourceLineNo">1269</span> *<a name="line.1269"></a>
+<span class="sourceLineNo">1270</span> * <pre><a name="line.1270"></a>
+<span class="sourceLineNo">1271</span> * File f = ...<a name="line.1271"></a>
+<span class="sourceLineNo">1272</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1272"></a>
+<span class="sourceLineNo">1273</span> * // use the input stream<a name="line.1273"></a>
+<span class="sourceLineNo">1274</span> * } finally {<a name="line.1274"></a>
+<span class="sourceLineNo">1275</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1275"></a>
+<span class="sourceLineNo">1276</span> * }<a name="line.1276"></a>
+<span class="sourceLineNo">1277</span> * </pre><a name="line.1277"></a>
+<span class="sourceLineNo">1278</span> *<a name="line.1278"></a>
+<span class="sourceLineNo">1279</span> * @param file the file to read and delete<a name="line.1279"></a>
+<span class="sourceLineNo">1280</span> * @return a FileInputStream for the given file<a name="line.1280"></a>
+<span class="sourceLineNo">1281</span> * @throws IOException if there is a problem creating the stream<a name="line.1281"></a>
+<span class="sourceLineNo">1282</span> */<a name="line.1282"></a>
+<span class="sourceLineNo">1283</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1283"></a>
+<span class="sourceLineNo">1284</span> return new FileInputStream(file) {<a name="line.1284"></a>
+<span class="sourceLineNo">1285</span> private File myFile;<a name="line.1285"></a>
+<span class="sourceLineNo">1286</span><a name="line.1286"></a>
+<span class="sourceLineNo">1287</span> private FileInputStream init(File file) {<a name="line.1287"></a>
+<span class="sourceLineNo">1288</span> myFile = file;<a name="line.1288"></a>
+<span class="sourceLineNo">1289</span> return this;<a name="line.1289"></a>
+<span class="sourceLineNo">1290</span> }<a name="line.1290"></a>
+<span class="sourceLineNo">1291</span><a name="line.1291"></a>
+<span class="sourceLineNo">1292</span> @Override<a name="line.1292"></a>
+<span class="sourceLineNo">1293</span> public void close() throws IOException {<a name="line.1293"></a>
+<span class="sourceLineNo">1294</span> // close() will be called during try-with-resources and it will be<a name="line.1294"></a>
+<span class="sourceLineNo">1295</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1295"></a>
+<span class="sourceLineNo">1296</span> // set myFile to null after the first call.<a name="line.1296"></a>
+<span class="sourceLineNo">1297</span> if (myFile == null) {<a name="line.1297"></a>
+<span class="sourceLineNo">1298</span> return;<a name="line.1298"></a>
+<span class="sourceLineNo">1299</span> }<a name="line.1299"></a>
+<span class="sourceLineNo">1300</span><a name="line.1300"></a>
+<span class="sourceLineNo">1301</span> super.close();<a name="line.1301"></a>
+<span class="sourceLineNo">1302</span> if (!myFile.delete()) {<a name="line.1302"></a>
+<span class="sourceLineNo">1303</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1303"></a>
+<span class="sourceLineNo">1304</span> }<a name="line.1304"></a>
+<span class="sourceLineNo">1305</span> myFile = null;<a name="line.1305"></a>
+<span class="sourceLineNo">1306</span> }<a name="line.1306"></a>
+<span class="sourceLineNo">1307</span> }.init(file);<a name="line.1307"></a>
+<span class="sourceLineNo">1308</span> }<a name="line.1308"></a>
+<span class="sourceLineNo">1309</span><a name="line.1309"></a>
+<span class="sourceLineNo">1310</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1310"></a>
+<span class="sourceLineNo">1311</span> throws IOException {<a name="line.1311"></a>
+<span class="sourceLineNo">1312</span> if (capacitySize != cacheCapacity) {<a name="line.1312"></a>
+<span class="sourceLineNo">1313</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1313"></a>
+<span class="sourceLineNo">1314</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1314"></a>
+<span class="sourceLineNo">1315</span> }<a name="line.1315"></a>
+<span class="sourceLineNo">1316</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1316"></a>
+<span class="sourceLineNo">1317</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1317"></a>
+<span class="sourceLineNo">1318</span> + ioEngine.getClass().getName());<a name="line.1318"></a>
+<span class="sourceLineNo">1319</span> }<a name="line.1319"></a>
+<span class="sourceLineNo">1320</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1320"></a>
+<span class="sourceLineNo">1321</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1321"></a>
+<span class="sourceLineNo">1322</span> + backingMap.getClass().getName());<a name="line.1322"></a>
+<span class="sourceLineNo">1323</span> }<a name="line.1323"></a>
+<span class="sourceLineNo">1324</span> }<a name="line.1324"></a>
+<span class="sourceLineNo">1325</span><a name="line.1325"></a>
+<span class="sourceLineNo">1326</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1326"></a>
+<span class="sourceLineNo">1327</span> if (proto.hasChecksum()) {<a name="line.1327"></a>
+<span class="sourceLineNo">1328</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1328"></a>
+<span class="sourceLineNo">1329</span> algorithm);<a name="line.1329"></a>
+<span class="sourceLineNo">1330</span> } else {<a name="line.1330"></a>
+<span class="sourceLineNo">1331</span> // if has not checksum, it means the persistence file is old format<a name="line.1331"></a>
+<span class="sourceLineNo">1332</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1332"></a>
+<span class="sourceLineNo">1333</span> }<a name="line.1333"></a>
+<span class="sourceLineNo">1334</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1334"></a>
+<span class="sourceLineNo">1335</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1335"></a>
+<span class="sourceLineNo">1336</span> this::createRecycler);<a name="line.1336"></a>
+<span class="sourceLineNo">1337</span> }<a name="line.1337"></a>
+<span class="sourceLineNo">1338</span><a name="line.1338"></a>
+<span class="sourceLineNo">1339</span> /**<a name="line.1339"></a>
+<span class="sourceLineNo">1340</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1340"></a>
+<span class="sourceLineNo">1341</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1341"></a>
+<span class="sourceLineNo">1342</span> */<a name="line.1342"></a>
+<span class="sourceLineNo">1343</span> private void checkIOErrorIsTolerated() {<a name="line.1343"></a>
+<span class="sourceLineNo">1344</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1344"></a>
+<span class="sourceLineNo">1345</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1345"></a>
+<span class="sourceLineNo">1346</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1346"></a>
+<span class="sourceLineNo">1347</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1347"></a>
+<span class="sourceLineNo">1348</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1348"></a>
+<span class="sourceLineNo">1349</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1349"></a>
+<span class="sourceLineNo">1350</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1350"></a>
+<span class="sourceLineNo">1351</span> disableCache();<a name="line.1351"></a>
+<span class="sourceLineNo">1352</span> }<a name="line.1352"></a>
+<span class="sourceLineNo">1353</span> } else {<a name="line.1353"></a>
+<span class="sourceLineNo">1354</span> this.ioErrorStartTime = now;<a name="line.1354"></a>
+<span class="sourceLineNo">1355</span> }<a name="line.1355"></a>
+<span class="sourceLineNo">1356</span> }<a name="line.1356"></a>
+<span class="sourceLineNo">1357</span><a name="line.1357"></a>
+<span class="sourceLineNo">1358</span> /**<a name="line.1358"></a>
+<span class="sourceLineNo">1359</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1359"></a>
+<span class="sourceLineNo">1360</span> */<a name="line.1360"></a>
+<span class="sourceLineNo">1361</span> private void disableCache() {<a name="line.1361"></a>
+<span class="sourceLineNo">1362</span> if (!cacheEnabled) return;<a name="line.1362"></a>
+<span class="sourceLineNo">1363</span> cacheEnabled = false;<a name="line.1363"></a>
+<span class="sourceLineNo">1364</span> ioEngine.shutdown();<a name="line.1364"></a>
+<span class="sourceLineNo">1365</span> this.scheduleThreadPool.shutdown();<a name="line.1365"></a>
+<span class="sourceLineNo">1366</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1366"></a>
+<span class="sourceLineNo">1367</span> writerThreads[i].interrupt();<a name="line.1367"></a>
+<span class="sourceLineNo">1368</span> this.ramCache.clear();<a name="line.1368"></a>
+<span class="sourceLineNo">1369</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1369"></a>
+<span class="sourceLineNo">1370</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1370"></a>
+<span class="sourceLineNo">1371</span> this.backingMap.clear();<a name="line.1371"></a>
+<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
+<span class="sourceLineNo">1373</span> }<a name="line.1373"></a>
+<span class="sourceLineNo">1374</span><a name="line.1374"></a>
+<span class="sourceLineNo">1375</span> private void join() throws InterruptedException {<a name="line.1375"></a>
+<span class="sourceLineNo">1376</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1376"></a>
+<span class="sourceLineNo">1377</span> writerThreads[i].join();<a name="line.1377"></a>
+<span class="sourceLineNo">1378</span> }<a name="line.1378"></a>
+<span class="sourceLineNo">1379</span><a name="line.1379"></a>
+<span class="sourceLineNo">1380</span> @Override<a name="line.1380"></a>
+<span class="sourceLineNo">1381</span> public void shutdown() {<a name="line.1381"></a>
+<span class="sourceLineNo">1382</span> disableCache();<a name="line.1382"></a>
+<span class="sourceLineNo">1383</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1383"></a>
+<span class="sourceLineNo">1384</span> + persistencePath);<a name="line.1384"></a>
+<span class="sourceLineNo">1385</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1385"></a>
+<span class="sourceLineNo">1386</span> try {<a name="line.1386"></a>
+<span class="sourceLineNo">1387</span> join();<a name="line.1387"></a>
+<span class="sourceLineNo">1388</span> persistToFile();<a name="line.1388"></a>
+<span class="sourceLineNo">1389</span> } catch (IOException ex) {<a name="line.1389"></a>
+<span class="sourceLineNo">1390</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1390"></a>
+<span class="sourceLineNo">1391</span> } catch (InterruptedException e) {<a name="line.1391"></a>
+<span class="sourceLineNo">1392</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1392"></a>
+<span class="sourceLineNo">1393</span> }<a name="line.1393"></a>
+<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
+<span class="sourceLineNo">1395</span> }<a name="line.1395"></a>
+<span class="sourceLineNo">1396</span><a name="line.1396"></a>
+<span class="sourceLineNo">1397</span> @Override<a name="line.1397"></a>
+<span class="sourceLineNo">1398</span> public CacheStats getStats() {<a name="line.1398"></a>
+<span class="sourceLineNo">1399</span> return cacheStats;<a name="line.1399"></a>
+<span class="sourceLineNo">1400</span> }<a name="line.1400"></a>
+<span class="sourceLineNo">1401</span><a name="line.1401"></a>
+<span class="sourceLineNo">1402</span> public BucketAllocator getAllocator() {<a name="line.1402"></a>
+<span class="sourceLineNo">1403</span> return this.bucketAllocator;<a name="line.1403"></a>
+<span class="sourceLineNo">1404</span> }<a name="line.1404"></a>
+<span class="sourceLineNo">1405</span><a name="line.1405"></a>
+<span class="sourceLineNo">1406</span> @Override<a name="line.1406"></a>
+<span class="sourceLineNo">1407</span> public long heapSize() {<a name="line.1407"></a>
+<span class="sourceLineNo">1408</span> return this.heapSize.sum();<a name="line.1408"></a>
+<span class="sourceLineNo">1409</span> }<a name="line.1409"></a>
+<span class="sourceLineNo">1410</span><a name="line.1410"></a>
+<span class="sourceLineNo">1411</span> @Override<a name="line.1411"></a>
+<span class="sourceLineNo">1412</span> public long size() {<a name="line.1412"></a>
+<span class="sourceLineNo">1413</span> return this.realCacheSize.sum();<a name="line.1413"></a>
+<span class="sourceLineNo">1414</span> }<a name="line.1414"></a>
+<span class="sourceLineNo">1415</span><a name="line.1415"></a>
+<span class="sourceLineNo">1416</span> @Override<a name="line.1416"></a>
+<span class="sourceLineNo">1417</span> public long getCurrentDataSize() {<a name="line.1417"></a>
+<span class="sourceLineNo">1418</span> return size();<a name="line.1418"></a>
+<span class="sourceLineNo">1419</span> }<a name="line.1419"></a>
+<span class="sourceLineNo">1420</span><a name="line.1420"></a>
+<span class="sourceLineNo">1421</span> @Override<a name="line.1421"></a>
+<span class="sourceLineNo">1422</span> public long getFreeSize() {<a name="line.1422"></a>
+<span class="sourceLineNo">1423</span> return this.bucketAllocator.getFreeSize();<a name="line.1423"></a>
+<span class="sourceLineNo">1424</span> }<a name="line.1424"></a>
+<span class="sourceLineNo">1425</span><a name="line.1425"></a>
+<span class="sourceLineNo">1426</span> @Override<a name="line.1426"></a>
+<span class="sourceLineNo">1427</span> public long getBlockCount() {<a name="line.1427"></a>
+<span class="sourceLineNo">1428</span> return this.blockNumber.sum();<a name="line.1428"></a>
+<span class="sourceLineNo">1429</span> }<a name="line.1429"></a>
+<span class="sourceLineNo">1430</span><a name="line.1430"></a>
+<span class="sourceLineNo">1431</span> @Override<a name="line.1431"></a>
+<span class="sourceLineNo">1432</span> public long getDataBlockCount() {<a name="line.1432"></a>
+<span class="sourceLineNo">1433</span> return getBlockCount();<a name="line.1433"></a>
+<span class="sourceLineNo">1434</span> }<a name="line.1434"></a>
+<span class="sourceLineNo">1435</span><a name="line.1435"></a>
+<span class="sourceLineNo">1436</span> @Override<a name="line.1436"></a>
+<span class="sourceLineNo">1437</span> public long getCurrentSize() {<a name="line.1437"></a>
+<span class="sourceLineNo">1438</span> return this.bucketAllocator.getUsedSize();<a name="line.1438"></a>
+<span class="sourceLineNo">1439</span> }<a name="line.1439"></a>
+<span class="sourceLineNo">1440</span><a name="line.1440"></a>
+<span class="sourceLineNo">1441</span> protected String getAlgorithm() {<a name="line.1441"></a>
+<span class="sourceLineNo">1442</span> return algorithm;<a name="line.1442"></a>
+<span class="sourceLineNo">1443</span> }<a name="line.1443"></a>
+<span class="sourceLineNo">1444</span><a name="line.1444"></a>
+<span class="sourceLineNo">1445</span> /**<a name="line.1445"></a>
+<span class="sourceLineNo">1446</span> * Evicts all blocks for a specific HFile.<a name="line.1446"></a>
+<span class="sourceLineNo">1447</span> * <p><a name="line.1447"></a>
+<span class="sourceLineNo">1448</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1448"></a>
+<span class="sourceLineNo">1449</span> * @return the number of blocks evicted<a name="line.1449"></a>
+<span class="sourceLineNo">1450</span> */<a name="line.1450"></a>
+<span class="sourceLineNo">1451</span> @Override<a name="line.1451"></a>
+<span class="sourceLineNo">1452</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1452"></a>
+<span class="sourceLineNo">1453</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1453"></a>
+<span class="sourceLineNo">1454</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1454"></a>
+<span class="sourceLineNo">1455</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1455"></a>
+<span class="sourceLineNo">1456</span><a name="line.1456"></a>
+<span class="sourceLineNo">1457</span> int numEvicted = 0;<a name="line.1457"></a>
+<span class="sourceLineNo">1458</span> for (BlockCacheKey key : keySet) {<a name="line.1458"></a>
+<span class="sourceLineNo">1459</span> if (evictBlock(key)) {<a name="line.1459"></a>
+<span class="sourceLineNo">1460</span> ++numEvicted;<a name="line.1460"></a>
+<span class="sourceLineNo">1461</span> }<a name="line.1461"></a>
+<span class="sourceLineNo">1462</span> }<a name="line.1462"></a>
+<span class="sourceLineNo">1463</span><a name="line.1463"></a>
+<span class="sourceLineNo">1464</span> return numEvicted;<a name="line.1464"></a>
+<span class="sourceLineNo">1465</span> }<a name="line.1465"></a>
+<span class="sourceLineNo">1466</span><a name="line.1466"></a>
+<span class="sourceLineNo">1467</span> /**<a name="line.1467"></a>
+<span class="sourceLineNo">1468</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1468"></a>
+<span class="sourceLineNo">1469</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1469"></a>
+<span class="sourceLineNo">1470</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1470"></a>
+<span class="sourceLineNo">1471</span> */<a name="line.1471"></a>
+<span class="sourceLineNo">1472</span> private class BucketEntryGroup {<a name="line.1472"></a>
+<span class="sourceLineNo">1473</span><a name="line.1473"></a>
+<span class="sourceLineNo">1474</span> private CachedEntryQueue queue;<a name="line.1474"></a>
+<span class="sourceLineNo">1475</span> private long totalSize = 0;<a name="line.1475"></a>
+<span class="sourceLineNo">1476</span> private long bucketSize;<a name="line.1476"></a>
<span class="sourceLineNo">1477</span><a name="line.1477"></a>
-<span class="sourceLineNo">1478</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1478"></a>
-<span class="sourceLineNo">1479</span> totalSize += block.getValue().getLength();<a name="line.1479"></a>
-<span class="sourceLineNo">1480</span> queue.add(block);<a name="line.1480"></a>
-<span class="sourceLineNo">1481</span> }<a name="line.1481"></a>
-<span class="sourceLineNo">1482</span><a name="line.1482"></a>
-<span class="sourceLineNo">1483</span> public long free(long toFree) {<a name="line.1483"></a>
-<span class="sourceLineNo">1484</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1484"></a>
-<span class="sourceLineNo">1485</span> long freedBytes = 0;<a name="line.1485"></a>
-<span class="sourceLineNo">1486</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1486"></a>
-<span class="sourceLineNo">1487</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1487"></a>
-<span class="sourceLineNo">1488</span> while ((entry = queue.pollLast()) != null) {<a name="line.1488"></a>
-<span class="sourceLineNo">1489</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1489"></a>
-<span class="sourceLineNo">1490</span> BucketEntry be = entry.getValue();<a name="line.1490"></a>
-<span class="sourceLineNo">1491</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1491"></a>
-<span class="sourceLineNo">1492</span> freedBytes += be.getLength();<a name="line.1492"></a>
-<span class="sourceLineNo">1493</span> }<a name="line.1493"></a>
-<span class="sourceLineNo">1494</span> if (freedBytes >= toFree) {<a name="line.1494"></a>
-<span class="sourceLineNo">1495</span> return freedBytes;<a name="line.1495"></a>
-<span class="sourceLineNo">1496</span> }<a name="line.1496"></a>
-<span class="sourceLineNo">1497</span> }<a name="line.1497"></a>
-<span class="sourceLineNo">1498</span> return freedBytes;<a name="line.1498"></a>
-<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
-<span class="sourceLineNo">1500</span><a name="line.1500"></a>
-<span class="sourceLineNo">1501</span> public long overflow() {<a name="line.1501"></a>
-<span class="sourceLineNo">1502</span> return totalSize - bucketSize;<a name="line.1502"></a>
-<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
-<span class="sourceLineNo">1504</span><a name="line.1504"></a>
-<span class="sourceLineNo">1505</span> public long totalSize() {<a name="line.1505"></a>
-<span class="sourceLineNo">1506</span> return totalSize;<a name="line.1506"></a>
-<span class="sourceLineNo">1507</span> }<a name="line.1507"></a>
-<span class="sourceLineNo">1508</span> }<a name="line.1508"></a>
-<span class="sourceLineNo">1509</span><a name="line.1509"></a>
-<span class="sourceLineNo">1510</span> /**<a name="line.1510"></a>
-<span class="sourceLineNo">1511</span> * Block Entry stored in the memory with key,data and so on<a name="line.1511"></a>
-<span class="sourceLineNo">1512</span> */<a name="line.1512"></a>
-<span class="sourceLineNo">1513</span> static class RAMQueueEntry {<a name="line.1513"></a>
-<span class="sourceLineNo">1514</span> private final BlockCacheKey key;<a name="line.1514"></a>
-<span class="sourceLineNo">1515</span> private final Cacheable data;<a name="line.1515"></a>
-<span class="sourceLineNo">1516</span> private long accessCounter;<a name="line.1516"></a>
-<span class="sourceLineNo">1517</span> private boolean inMemory;<a name="line.1517"></a>
-<span class="sourceLineNo">1518</span><a name="line.1518"></a>
-<span class="sourceLineNo">1519</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1519"></a>
-<span class="sourceLineNo">1520</span> this.key = bck;<a name="line.1520"></a>
-<span class="sourceLineNo">1521</span> this.data = data;<a name="line.1521"></a>
-<span class="sourceLineNo">1522</span> this.accessCounter = accessCounter;<a name="line.1522"></a>
-<span class="sourceLineNo">1523</span> this.inMemory = inMemory;<a name="line.1523"></a>
-<span class="sourceLineNo">1524</span> }<a name="line.1524"></a>
-<span class="sourceLineNo">1525</span><a name="line.1525"></a>
-<span class="sourceLineNo">1526</span> public Cacheable getData() {<a name="line.1526"></a>
-<span class="sourceLineNo">1527</span> return data;<a name="line.1527"></a>
-<span class="sourceLineNo">1528</span> }<a name="line.1528"></a>
-<span class="sourceLineNo">1529</span><a name="line.1529"></a>
-<span class="sourceLineNo">1530</span> public BlockCacheKey getKey() {<a name="line.1530"></a>
-<span class="sourceLineNo">1531</span> return key;<a name="line.1531"></a>
-<span class="sourceLineNo">1532</span> }<a name="line.1532"></a>
-<span class="sourceLineNo">1533</span><a name="line.1533"></a>
-<span class="sourceLineNo">1534</span> public void access(long accessCounter) {<a name="line.1534"></a>
-<span class="sourceLineNo">1535</span> this.accessCounter = accessCounter;<a name="line.1535"></a>
-<span class="sourceLineNo">1536</span> }<a name="line.1536"></a>
-<span class="sourceLineNo">1537</span><a name="line.1537"></a>
-<span class="sourceLineNo">1538</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1538"></a>
-<span class="sourceLineNo">1539</span> if (data instanceof HFileBlock) {<a name="line.1539"></a>
-<span class="sourceLineNo">1540</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1540"></a>
-<span class="sourceLineNo">1541</span> }<a name="line.1541"></a>
-<span class="sourceLineNo">1542</span> return ByteBuffAllocator.HEAP;<a name="line.1542"></a>
-<span class="sourceLineNo">1543</span> }<a name="line.1543"></a>
-<span class="sourceLineNo">1544</span><a name="line.1544"></a>
-<span class="sourceLineNo">1545</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1545"></a>
-<span class="sourceLineNo">1546</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1546"></a>
-<span class="sourceLineNo">1547</span> ByteBuffer metaBuff) throws IOException {<a name="line.1547"></a>
-<span class="sourceLineNo">1548</span> int len = data.getSerializedLength();<a name="line.1548"></a>
-<span class="sourceLineNo">1549</span> // This cacheable thing can't be serialized<a name="line.1549"></a>
-<span class="sourceLineNo">1550</span> if (len == 0) {<a name="line.1550"></a>
-<span class="sourceLineNo">1551</span> return null;<a name="line.1551"></a>
-<span class="sourceLineNo">1552</span> }<a name="line.1552"></a>
-<span class="sourceLineNo">1553</span> long offset = alloc.allocateBlock(len);<a name="line.1553"></a>
-<span class="sourceLineNo">1554</span> boolean succ = false;<a name="line.1554"></a>
-<span class="sourceLineNo">1555</span> BucketEntry bucketEntry = null;<a name="line.1555"></a>
-<span class="sourceLineNo">1556</span> try {<a name="line.1556"></a>
-<span class="sourceLineNo">1557</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1557"></a>
-<span class="sourceLineNo">1558</span> getByteBuffAllocator());<a name="line.1558"></a>
-<span class="sourceLineNo">1559</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1559"></a>
-<span class="sourceLineNo">1560</span> if (data instanceof HFileBlock) {<a name="line.1560"></a>
-<span class="sourceLineNo">1561</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1561"></a>
-<span class="sourceLineNo">1562</span> HFileBlock block = (HFileBlock) data;<a name="line.1562"></a>
-<span class="sourceLineNo">1563</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1563"></a>
-<span class="sourceLineNo">1564</span> block.getMetaData(metaBuff);<a name="line.1564"></a>
-<span class="sourceLineNo">1565</span> ioEngine.write(sliceBuf, offset);<a name="line.1565"></a>
-<span class="sourceLineNo">1566</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1566"></a>
-<span class="sourceLineNo">1567</span> } else {<a name="line.1567"></a>
-<span class="sourceLineNo">1568</span> // Only used for testing.<a name="line.1568"></a>
-<span class="sourceLineNo">1569</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1569"></a>
-<span class="sourceLineNo">1570</span> data.serialize(bb, true);<a name="line.1570"></a>
-<span class="sourceLineNo">1571</span> ioEngine.write(bb, offset);<a name="line.1571"></a>
-<span class="sourceLineNo">1572</span> }<a name="line.1572"></a>
-<span class="sourceLineNo">1573</span> succ = true;<a name="line.1573"></a>
-<span class="sourceLineNo">1574</span> } finally {<a name="line.1574"></a>
-<span class="sourceLineNo">1575</span> if (!succ) {<a name="line.1575"></a>
-<span class="sourceLineNo">1576</span> alloc.freeBlock(offset, len);<a name="line.1576"></a>
-<span class="sourceLineNo">1577</span> }<a name="line.1577"></a>
-<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
-<span class="sourceLineNo">1579</span> realCacheSize.add(len);<a name="line.1579"></a>
-<span class="sourceLineNo">1580</span> return bucketEntry;<a name="line.1580"></a>
-<span class="sourceLineNo">1581</span> }<a name="line.1581"></a>
-<span class="sourceLineNo">1582</span> }<a name="line.1582"></a>
-<span class="sourceLineNo">1583</span><a name="line.1583"></a>
-<span class="sourceLineNo">1584</span> /**<a name="line.1584"></a>
-<span class="sourceLineNo">1585</span> * Only used in test<a name="line.1585"></a>
-<span class="sourceLineNo">1586</span> */<a name="line.1586"></a>
-<span class="sourceLineNo">1587</span> void stopWriterThreads() throws InterruptedException {<a name="line.1587"></a>
-<span class="sourceLineNo">1588</span> for (WriterThread writerThread : writerThreads) {<a name="line.1588"></a>
-<span class="sourceLineNo">1589</span> writerThread.disableWriter();<a name="line.1589"></a>
-<span class="sourceLineNo">1590</span> writerThread.interrupt();<a name="line.1590"></a>
-<span class="sourceLineNo">1591</span> writerThread.join();<a name="line.1591"></a>
-<span class="sourceLineNo">1592</span> }<a name="line.1592"></a>
-<span class="sourceLineNo">1593</span> }<a name="line.1593"></a>
-<span class="sourceLineNo">1594</span><a name="line.1594"></a>
-<span class="sourceLineNo">1595</span> @Override<a name="line.1595"></a>
-<span class="sourceLineNo">1596</span> public Iterator<CachedBlock> iterator() {<a name="line.1596"></a>
-<span class="sourceLineNo">1597</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1597"></a>
-<span class="sourceLineNo">1598</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1598"></a>
-<span class="sourceLineNo">1599</span> return new Iterator<CachedBlock>() {<a name="line.1599"></a>
-<span class="sourceLineNo">1600</span> private final long now = System.nanoTime();<a name="line.1600"></a>
-<span class="sourceLineNo">1601</span><a name="line.1601"></a>
-<span class="sourceLineNo">1602</span> @Override<a name="line.1602"></a>
-<span class="sourceLineNo">1603</span> public boolean hasNext() {<a name="line.1603"></a>
-<span class="sourceLineNo">1604</span> return i.hasNext();<a name="line.1604"></a>
-<span class="sourceLineNo">1605</span> }<a name="line.1605"></a>
-<span class="sourceLineNo">1606</span><a name="line.1606"></a>
-<span class="sourceLineNo">1607</span> @Override<a name="line.1607"></a>
-<span class="sourceLineNo">1608</span> public CachedBlock next() {<a name="line.1608"></a>
-<span class="sourceLineNo">1609</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1609"></a>
-<span class="sourceLineNo">1610</span> return new CachedBlock() {<a name="line.1610"></a>
-<span class="sourceLineNo">1611</span> @Override<a name="line.1611"></a>
-<span class="sourceLineNo">1612</span> public String toString() {<a name="line.1612"></a>
-<span class="sourceLineNo">1613</span> return BlockCacheUtil.toString(this, now);<a name="line.1613"></a>
-<span class="sourceLineNo">1614</span> }<a name="line.1614"></a>
-<span class="sourceLineNo">1615</span><a name="line.1615"></a>
-<span class="sourceLineNo">1616</span> @Override<a name="line.1616"></a>
-<span class="sourceLineNo">1617</span> public BlockPriority getBlockPriority() {<a name="line.1617"></a>
-<span class="sourceLineNo">1618</span> return e.getValue().getPriority();<a name="line.1618"></a>
-<span class="sourceLineNo">1619</span> }<a name="line.1619"></a>
-<span class="sourceLineNo">1620</span><a name="line.1620"></a>
-<span class="sourceLineNo">1621</span> @Override<a name="line.1621"></a>
-<span class="sourceLineNo">1622</span> public BlockType getBlockType() {<a name="line.1622"></a>
-<span class="sourceLineNo">1623</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1623"></a>
-<span class="sourceLineNo">1624</span> return null;<a name="line.1624"></a>
+<span class="sourceLineNo">1478</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1478"></a>
+<span class="sourceLineNo">1479</span> this.bucketSize = bucketSize;<a name="line.1479"></a>
+<span class="sourceLineNo">1480</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1480"></a>
+<span class="sourceLineNo">1481</span> totalSize = 0;<a name="line.1481"></a>
+<span class="sourceLineNo">1482</span> }<a name="line.1482"></a>
+<span class="sourceLineNo">1483</span><a name="line.1483"></a>
+<span class="sourceLineNo">1484</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1484"></a>
+<span class="sourceLineNo">1485</span> totalSize += block.getValue().getLength();<a name="line.1485"></a>
+<span class="sourceLineNo">1486</span> queue.add(block);<a name="line.1486"></a>
+<span class="sourceLineNo">1487</span> }<a name="line.1487"></a>
+<span class="sourceLineNo">1488</span><a name="line.1488"></a>
+<span class="sourceLineNo">1489</span> public long free(long toFree) {<a name="line.1489"></a>
+<span class="sourceLineNo">1490</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1490"></a>
+<span class="sourceLineNo">1491</span> long freedBytes = 0;<a name="line.1491"></a>
+<span class="sourceLineNo">1492</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1492"></a>
+<span class="sourceLineNo">1493</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1493"></a>
+<span class="sourceLineNo">1494</span> while ((entry = queue.pollLast()) != null) {<a name="line.1494"></a>
+<span class="sourceLineNo">1495</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1495"></a>
+<span class="sourceLineNo">1496</span> BucketEntry be = entry.getValue();<a name="line.1496"></a>
+<span class="sourceLineNo">1497</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1497"></a>
+<span class="sourceLineNo">1498</span> freedBytes += be.getLength();<a name="line.1498"></a>
+<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
+<span class="sourceLineNo">1500</span> if (freedBytes >= toFree) {<a name="line.1500"></a>
+<span class="sourceLineNo">1501</span> return freedBytes;<a name="line.1501"></a>
+<span class="sourceLineNo">1502</span> }<a name="line.1502"></a>
+<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
+<span class="sourceLineNo">1504</span> return freedBytes;<a name="line.1504"></a>
+<span class="sourceLineNo">1505</span> }<a name="line.1505"></a>
+<span class="sourceLineNo">1506</span><a name="line.1506"></a>
+<span class="sourceLineNo">1507</span> public long overflow() {<a name="line.1507"></a>
+<span class="sourceLineNo">1508</span> return totalSize - bucketSize;<a name="line.1508"></a>
+<span class="sourceLineNo">1509</span> }<a name="line.1509"></a>
+<span class="sourceLineNo">1510</span><a name="line.1510"></a>
+<span class="sourceLineNo">1511</span> public long totalSize() {<a name="line.1511"></a>
+<span class="sourceLineNo">1512</span> return totalSize;<a name="line.1512"></a>
+<span class="sourceLineNo">1513</span> }<a name="line.1513"></a>
+<span class="sourceLineNo">1514</span> }<a name="line.1514"></a>
+<span class="sourceLineNo">1515</span><a name="line.1515"></a>
+<span class="sourceLineNo">1516</span> /**<a name="line.1516"></a>
+<span class="sourceLineNo">1517</span> * Block Entry stored in the memory with key,data and so on<a name="line.1517"></a>
+<span class="sourceLineNo">1518</span> */<a name="line.1518"></a>
+<span class="sourceLineNo">1519</span> static class RAMQueueEntry {<a name="line.1519"></a>
+<span class="sourceLineNo">1520</span> private final BlockCacheKey key;<a name="line.1520"></a>
+<span class="sourceLineNo">1521</span> private final Cacheable data;<a name="line.1521"></a>
+<span class="sourceLineNo">1522</span> private long accessCounter;<a name="line.1522"></a>
+<span class="sourceLineNo">1523</span> private boolean inMemory;<a name="line.1523"></a>
+<span class="sourceLineNo">1524</span><a name="line.1524"></a>
+<span class="sourceLineNo">1525</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1525"></a>
+<span class="sourceLineNo">1526</span> this.key = bck;<a name="line.1526"></a>
+<span class="sourceLineNo">1527</span> this.data = data;<a name="line.1527"></a>
+<span class="sourceLineNo">1528</span> this.accessCounter = accessCounter;<a name="line.1528"></a>
+<span class="sourceLineNo">1529</span> this.inMemory = inMemory;<a name="line.1529"></a>
+<span class="sourceLineNo">1530</span> }<a name="line.1530"></a>
+<span class="sourceLineNo">1531</span><a name="line.1531"></a>
+<span class="sourceLineNo">1532</span> public Cacheable getData() {<a name="line.1532"></a>
+<span class="sourceLineNo">1533</span> return data;<a name="line.1533"></a>
+<span class="sourceLineNo">1534</span> }<a name="line.1534"></a>
+<span class="sourceLineNo">1535</span><a name="line.1535"></a>
+<span class="sourceLineNo">1536</span> public BlockCacheKey getKey() {<a name="line.1536"></a>
+<span class="sourceLineNo">1537</span> return key;<a name="line.1537"></a>
+<span class="sourceLineNo">1538</span> }<a name="line.1538"></a>
+<span class="sourceLineNo">1539</span><a name="line.1539"></a>
+<span class="sourceLineNo">1540</span> public void access(long accessCounter) {<a name="line.1540"></a>
+<span class="sourceLineNo">1541</span> this.accessCounter = accessCounter;<a name="line.1541"></a>
+<span class="sourceLineNo">1542</span> }<a name="line.1542"></a>
+<span class="sourceLineNo">1543</span><a name="line.1543"></a>
+<span class="sourceLineNo">1544</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1544"></a>
+<span class="sourceLineNo">1545</span> if (data instanceof HFileBlock) {<a name="line.1545"></a>
+<span class="sourceLineNo">1546</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1546"></a>
+<span class="sourceLineNo">1547</span> }<a name="line.1547"></a>
+<span class="sourceLineNo">1548</span> return ByteBuffAllocator.HEAP;<a name="line.1548"></a>
+<span class="sourceLineNo">1549</span> }<a name="line.1549"></a>
+<span class="sourceLineNo">1550</span><a name="line.1550"></a>
+<span class="sourceLineNo">1551</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1551"></a>
+<span class="sourceLineNo">1552</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1552"></a>
+<span class="sourceLineNo">1553</span> ByteBuffer metaBuff) throws IOException {<a name="line.1553"></a>
+<span class="sourceLineNo">1554</span> int len = data.getSerializedLength();<a name="line.1554"></a>
+<span class="sourceLineNo">1555</span> // This cacheable thing can't be serialized<a name="line.1555"></a>
+<span class="sourceLineNo">1556</span> if (len == 0) {<a name="line.1556"></a>
+<span class="sourceLineNo">1557</span> return null;<a name="line.1557"></a>
+<span class="sourceLineNo">1558</span> }<a name="line.1558"></a>
+<span class="sourceLineNo">1559</span> long offset = alloc.allocateBlock(len);<a name="line.1559"></a>
+<span class="sourceLineNo">1560</span> boolean succ = false;<a name="line.1560"></a>
+<span class="sourceLineNo">1561</span> BucketEntry bucketEntry = null;<a name="line.1561"></a>
+<span class="sourceLineNo">1562</span> try {<a name="line.1562"></a>
+<span class="sourceLineNo">1563</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1563"></a>
+<span class="sourceLineNo">1564</span> getByteBuffAllocator());<a name="line.1564"></a>
+<span class="sourceLineNo">1565</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1565"></a>
+<span class="sourceLineNo">1566</span> if (data instanceof HFileBlock) {<a name="line.1566"></a>
+<span class="sourceLineNo">1567</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1567"></a>
+<span class="sourceLineNo">1568</span> HFileBlock block = (HFileBlock) data;<a name="line.1568"></a>
+<span class="sourceLineNo">1569</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1569"></a>
+<span class="sourceLineNo">1570</span> block.getMetaData(metaBuff);<a name="line.1570"></a>
+<span class="sourceLineNo">1571</span> ioEngine.write(sliceBuf, offset);<a name="line.1571"></a>
+<span class="sourceLineNo">1572</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1572"></a>
+<span class="sourceLineNo">1573</span> } else {<a name="line.1573"></a>
+<span class="sourceLineNo">1574</span> // Only used for testing.<a name="line.1574"></a>
+<span class="sourceLineNo">1575</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1575"></a>
+<span class="sourceLineNo">1576</span> data.serialize(bb, true);<a name="line.1576"></a>
+<span class="sourceLineNo">1577</span> ioEngine.write(bb, offset);<a name="line.1577"></a>
+<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
+<span class="sourceLineNo">1579</span> succ = true;<a name="line.1579"></a>
+<span class="sourceLineNo">1580</span> } finally {<a name="line.1580"></a>
+<span class="sourceLineNo">1581</span> if (!succ) {<a name="line.1581"></a>
+<span class="sourceLineNo">1582</span> alloc.freeBlock(offset, len);<a name="line.1582"></a>
+<span class="sourceLineNo">1583</span> }<a name="line.1583"></a>
+<span class="sourceLineNo">1584</span> }<a name="line.1584"></a>
+<span class="sourceLineNo">1585</span> realCacheSize.add(len);<a name="line.1585"></a>
+<span class="sourceLineNo">1586</span> return bucketEntry;<a name="line.1586"></a>
+<span class="sourceLineNo">1587</span> }<a name="line.1587"></a>
+<span class="sourceLineNo">1588</span> }<a name="line.1588"></a>
+<span class="sourceLineNo">1589</span><a name="line.1589"></a>
+<span class="sourceLineNo">1590</span> /**<a name="line.1590"></a>
+<span class="sourceLineNo">1591</span> * Only used in test<a name="line.1591"></a>
+<span class="sourceLineNo">1592</span> */<a name="line.1592"></a>
+<span class="sourceLineNo">1593</span> void stopWriterThreads() throws InterruptedException {<a name="line.1593"></a>
+<span class="sourceLineNo">1594</span> for (WriterThread writerThread : writerThreads) {<a name="line.1594"></a>
+<span class="sourceLineNo">1595</span> writerThread.disableWriter();<a name="line.1595"></a>
+<span class="sourceLineNo">1596</span> writerThread.interrupt();<a name="line.1596"></a>
+<span class="sourceLineNo">1597</span> writerThread.join();<a name="line.1597"></a>
+<span class="sourceLineNo">1598</span> }<a name="line.1598"></a>
+<span class="sourceLineNo">1599</span> }<a name="line.1599"></a>
+<span class="sourceLineNo">1600</span><a name="line.1600"></a>
+<span class="sourceLineNo">1601</span> @Override<a name="line.1601"></a>
+<span class="sourceLineNo">1602</span> public Iterator<CachedBlock> iterator() {<a name="line.1602"></a>
+<span class="sourceLineNo">1603</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1603"></a>
+<span class="sourceLineNo">1604</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1604"></a>
+<span class="sourceLineNo">1605</span> return new Iterator<CachedBlock>() {<a name="line.1605"></a>
+<span class="sourceLineNo">1606</span> private final long now = System.nanoTime();<a name="line.1606"></a>
+<span class="sourceLineNo">1607</span><a name="line.1607"></a>
+<span class="sourceLineNo">1608</span> @Override<a name="line.1608"></a>
+<span class="sourceLineNo">1609</span> public boolean hasNext() {<a name="line.1609"></a>
+<span class="sourceLineNo">1610</span> return i.hasNext();<a name="line.1610"></a>
+<span class="sourceLineNo">1611</span> }<a name="line.1611"></a>
+<span class="sourceLineNo">1612</span><a name="line.1612"></a>
+<span class="sourceLineNo">1613</span> @Override<a name="line.1613"></a>
+<span class="sourceLineNo">1614</span> public CachedBlock next() {<a name="line.1614"></a>
+<span class="sourceLineNo">1615</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1615"></a>
+<span class="sourceLineNo">1616</span> return new CachedBlock() {<a name="line.1616"></a>
+<span class="sourceLineNo">1617</span> @Override<a name="line.1617"></a>
+<span class="sourceLineNo">1618</span> public String toString() {<a name="line.1618"></a>
+<span class="sourceLineNo">1619</span> return BlockCacheUtil.toString(this, now);<a name="line.1619"></a>
+<span class="sourceLineNo">1620</span> }<a name="line.1620"></a>
+<span class="sourceLineNo">1621</span><a name="line.1621"></a>
+<span class="sourceLineNo">1622</span> @Override<a name="line.1622"></a>
+<span class="sourceLineNo">1623</span> public BlockPriority getBlockPriority() {<a name="line.1623"></a>
+<span class="sourceLineNo">1624</span> return e.getValue().getPriority();<a name="line.1624"></a>
<span class="sourceLineNo">1625</span> }<a name="line.1625"></a>
<span class="sourceLineNo">1626</span><a name="line.1626"></a>
<span class="sourceLineNo">1627</span> @Override<a name="line.1627"></a>
-<span class="sourceLineNo">1628</span> public long getOffset() {<a name="line.1628"></a>
-<span class="sourceLineNo">1629</span> return e.getKey().getOffset();<a name="line.1629"></a>
-<span class="sourceLineNo">1630</span> }<a name="line.1630"></a>
-<span class="sourceLineNo">1631</span><a name="line.1631"></a>
-<span class="sourceLineNo">1632</span> @Override<a name="line.1632"></a>
-<span class="sourceLineNo">1633</span> public long getSize() {<a name="line.1633"></a>
-<span class="sourceLineNo">1634</span> return e.getValue().getLength();<a name="line.1634"></a>
-<span class="sourceLineNo">1635</span> }<a name="line.1635"></a>
-<span class="sourceLineNo">1636</span><a name="line.1636"></a>
-<span class="sourceLineNo">1637</span> @Override<a name="line.1637"></a>
-<span class="sourceLineNo">1638</span> public long getCachedTime() {<a name="line.1638"></a>
-<span class="sourceLineNo">1639</span> return e.getValue().getCachedTime();<a name="line.1639"></a>
-<span class="sourceLineNo">1640</span> }<a name="line.1640"></a>
-<span class="sourceLineNo">1641</span><a name="line.1641"></a>
-<span class="sourceLineNo">1642</span> @Override<a name="line.1642"></a>
-<span class="sourceLineNo">1643</span> public String getFilename() {<a name="line.1643"></a>
-<span class="sourceLineNo">1644</span> return e.getKey().getHfileName();<a name="line.1644"></a>
-<span class="sourceLineNo">1645</span> }<a name="line.1645"></a>
-<span class="sourceLineNo">1646</span><a name="line.1646"></a>
-<span class="sourceLineNo">1647</span> @Override<a name="line.1647"></a>
-<span class="sourceLineNo">1648</span> public int compareTo(CachedBlock other) {<a name="line.1648"></a>
-<span class="sourceLineNo">1649</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1649"></a>
-<span class="sourceLineNo">1650</span> if (diff != 0) return diff;<a name="line.1650"></a>
-<span class="sourceLineNo">1651</span><a name="line.1651"></a>
-<span class="sourceLineNo">1652</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1652"></a>
-<span class="sourceLineNo">1653</span> if (diff != 0) return diff;<a name="line.1653"></a>
-<span class="sourceLineNo">1654</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1654"></a>
-<span class="sourceLineNo">1655</span> throw new IllegalStateException(<a name="line.1655"></a>
-<span class="sourceLineNo">1656</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1656"></a>
-<span class="sourceLineNo">1657</span> }<a name="line.1657"></a>
-<span class="sourceLineNo">1658</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1658"></a>
-<span class="sourceLineNo">1659</span> }<a name="line.1659"></a>
-<span class="sourceLineNo">1660</span><a name="line.1660"></a>
-<span class="sourceLineNo">1661</span> @Override<a name="line.1661"></a>
-<span class="sourceLineNo">1662</span> public int hashCode() {<a name="line.1662"></a>
-<span class="sourceLineNo">1663</span> return e.getKey().hashCode();<a name="line.1663"></a>
-<span class="sourceLineNo">1664</span> }<a name="line.1664"></a>
-<span class="sourceLineNo">1665</span><a name="line.1665"></a>
-<span class="sourceLineNo">1666</span> @Override<a name="line.1666"></a>
-<span class="sourceLineNo">1667</span> public boolean equals(Object obj) {<a name="line.1667"></a>
-<span class="sourceLineNo">1668</span> if (obj instanceof CachedBlock) {<a name="line.1668"></a>
-<span class="sourceLineNo">1669</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1669"></a>
-<span class="sourceLineNo">1670</span> return compareTo(cb) == 0;<a name="line.1670"></a>
-<span class="sourceLineNo">1671</span> } else {<a name="line.1671"></a>
-<span class="sourceLineNo">1672</span> return false;<a name="line.1672"></a>
-<span class="sourceLineNo">1673</span> }<a name="line.1673"></a>
-<span class="sourceLineNo">1674</span> }<a name="line.1674"></a>
-<span class="sourceLineNo">1675</span> };<a name="line.1675"></a>
-<span class="sourceLineNo">1676</span> }<a name="line.1676"></a>
-<span class="sourceLineNo">1677</span><a name="line.1677"></a>
-<span class="sourceLineNo">1678</span> @Override<a name="line.1678"></a>
-<span class="sourceLineNo">1679</span> public void remove() {<a name="line.1679"></a>
-<span class="sourceLineNo">1680</span> throw new UnsupportedOperationException();<a name="line.1680"></a>
-<span class="sourceLineNo">1681</span> }<a name="line.1681"></a>
-<span class="sourceLineNo">1682</span> };<a name="line.1682"></a>
-<span class="sourceLineNo">1683</span> }<a name="line.1683"></a>
-<span class="sourceLineNo">1684</span><a name="line.1684"></a>
-<span class="sourceLineNo">1685</span> @Override<a name="line.1685"></a>
-<span class="sourceLineNo">1686</span> public BlockCache[] getBlockCaches() {<a name="line.1686"></a>
-<span class="sourceLineNo">1687</span> return null;<a name="line.1687"></a>
-<span class="sourceLineNo">1688</span> }<a name="line.1688"></a>
-<span class="sourceLineNo">1689</span><a name="line.1689"></a>
-<span class="sourceLineNo">1690</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1690"></a>
-<span class="sourceLineNo">1691</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1691"></a>
-<span class="sourceLineNo">1692</span> if (bucketEntry != null) {<a name="line.1692"></a>
-<span class="sourceLineNo">1693</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1693"></a>
-<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
-<span class="sourceLineNo">1695</span> return 0;<a name="line.1695"></a>
-<span class="sourceLineNo">1696</span> }<a name="line.1696"></a>
-<span class="sourceLineNo">1697</span><a name="line.1697"></a>
-<span class="sourceLineNo">1698</span> float getAcceptableFactor() {<a name="line.1698"></a>
-<span class="sourceLineNo">1699</span> return acceptableFactor;<a name="line.1699"></a>
-<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
-<span class="sourceLineNo">1701</span><a name="line.1701"></a>
-<span class="sourceLineNo">1702</span> float getMinFactor() {<a name="line.1702"></a>
-<span class="sourceLineNo">1703</span> return minFactor;<a name="line.1703"></a>
-<span class="sourceLineNo">1704</span> }<a name="line.1704"></a>
-<span class="sourceLineNo">1705</span><a name="line.1705"></a>
-<span class="sourceLineNo">1706</span> float getExtraFreeFactor() {<a name="line.1706"></a>
-<span class="sourceLineNo">1707</span> return extraFreeFactor;<a name="line.1707"></a>
-<span class="sourceLineNo">1708</span> }<a name="line.1708"></a>
-<span class="sourceLineNo">1709</span><a name="line.1709"></a>
-<span class="sourceLineNo">1710</span> float getSingleFactor() {<a name="line.1710"></a>
-<span class="sourceLineNo">1711</span> return singleFactor;<a name="line.1711"></a>
-<span class="sourceLineNo">1712</span> }<a name="line.1712"></a>
-<span class="sourceLineNo">1713</span><a name="line.1713"></a>
-<span class="sourceLineNo">1714</span> float getMultiFactor() {<a name="line.1714"></a>
-<span class="sourceLineNo">1715</span> return multiFactor;<a name="line.1715"></a>
-<span class="sourceLineNo">1716</span> }<a name="line.1716"></a>
-<span class="sourceLineNo">1717</span><a name="line.1717"></a>
-<span class="sourceLineNo">1718</span> float getMemoryFactor() {<a name="line.1718"></a>
-<span class="sourceLineNo">1719</span> return memoryFactor;<a name="line.1719"></a>
-<span class="sourceLineNo">1720</span> }<a name="line.1720"></a>
-<span class="sourceLineNo">1721</span><a name="line.1721"></a>
-<span class="sourceLineNo">1722</span> /**<a name="line.1722"></a>
-<span class="sourceLineNo">1723</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1723"></a>
-<span class="sourceLineNo">1724</span> */<a name="line.1724"></a>
-<span class="sourceLineNo">1725</span> static class RAMCache {<a name="line.1725"></a>
-<span class="sourceLineNo">1726</span> /**<a name="line.1726"></a>
-<span class="sourceLineNo">1727</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1727"></a>
-<span class="sourceLineNo">1728</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1728"></a>
-<span class="sourceLineNo">1729</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1729"></a>
-<span class="sourceLineNo">1730</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1730"></a>
-<span class="sourceLineNo">1731</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1731"></a>
-<span class="sourceLineNo">1732</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1732"></a>
-<span class="sourceLineNo">1733</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1733"></a>
-<span class="sourceLineNo">1734</span> */<a name="line.1734"></a>
-<span class="sourceLineNo">1735</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1735"></a>
-<span class="sourceLineNo">1736</span><a name="line.1736"></a>
-<span class="sourceLineNo">1737</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1737"></a>
-<span class="sourceLineNo">1738</span> return delegate.containsKey(key);<a name="line.1738"></a>
-<span class="sourceLineNo">1739</span> }<a name="line.1739"></a>
-<span class="sourceLineNo">1740</span><a name="line.1740"></a>
-<span class="sourceLineNo">1741</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1741"></a>
-<span class="sourceLineNo">1742</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1742"></a>
-<span class="sourceLineNo">1743</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1743"></a>
-<span class="sourceLineNo">1744</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1744"></a>
-<span class="sourceLineNo">1745</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1745"></a>
-<span class="sourceLineNo">1746</span> re.getData().retain();<a name="line.1746"></a>
-<span class="sourceLineNo">1747</span> return re;<a name="line.1747"></a>
-<span class="sourceLineNo">1748</span> });<a name="line.1748"></a>
-<span class="sourceLineNo">1749</span> }<a name="line.1749"></a>
-<span class="sourceLineNo">1750</span><a name="line.1750"></a>
-<span class="sourceLineNo">1751</span> /**<a name="line.1751"></a>
-<span class="sourceLineNo">1752</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1752"></a>
-<span class="sourceLineNo">1753</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1753"></a>
-<span class="sourceLineNo">1754</span> */<a name="line.1754"></a>
-<span class="sourceLineNo">1755</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1755"></a>
-<span class="sourceLineNo">1756</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1756"></a>
-<span class="sourceLineNo">1757</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1757"></a>
-<span class="sourceLineNo">1758</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1758"></a>
-<span class="sourceLineNo">1759</span> entry.getData().retain();<a name="line.1759"></a>
-<span class="sourceLineNo">1760</span> absent.set(true);<a name="line.1760"></a>
-<span class="sourceLineNo">1761</span> return entry;<a name="line.1761"></a>
-<span class="sourceLineNo">1762</span> });<a name="line.1762"></a>
-<span class="sourceLineNo">1763</span> return absent.get() ? null : re;<a name="line.1763"></a>
-<span class="sourceLineNo">1764</span> }<a name="line.1764"></a>
-<span class="sourceLineNo">1765</span><a name="line.1765"></a>
-<span class="sourceLineNo">1766</span> public boolean remove(BlockCacheKey key) {<a name="line.1766"></a>
-<span class="sourceLineNo">1767</span> return remove(key, re -> {<a name="line.1767"></a>
+<span class="sourceLineNo">1628</span> public BlockType getBlockType() {<a name="line.1628"></a>
+<span class="sourceLineNo">1629</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1629"></a>
+<span class="sourceLineNo">1630</span> return null;<a name="line.1630"></a>
+<span class="sourceLineNo">1631</span> }<a name="line.1631"></a>
+<span class="sourceLineNo">1632</span><a name="line.1632"></a>
+<span class="sourceLineNo">1633</span> @Override<a name="line.1633"></a>
+<span class="sourceLineNo">1634</span> public long getOffset() {<a name="line.1634"></a>
+<span class="sourceLineNo">1635</span> return e.getKey().getOffset();<a name="line.1635"></a>
+<span class="sourceLineNo">1636</span> }<a name="line.1636"></a>
+<span class="sourceLineNo">1637</span><a name="line.1637"></a>
+<span class="sourceLineNo">1638</span> @Override<a name="line.1638"></a>
+<span class="sourceLineNo">1639</span> public long getSize() {<a name="line.1639"></a>
+<span class="sourceLineNo">1640</span> return e.getValue().getLength();<a name="line.1640"></a>
+<span class="sourceLineNo">1641</span> }<a name="line.1641"></a>
+<span class="sourceLineNo">1642</span><a name="line.1642"></a>
+<span class="sourceLineNo">1643</span> @Override<a name="line.1643"></a>
+<span class="sourceLineNo">1644</span> public long getCachedTime() {<a name="line.1644"></a>
+<span class="sourceLineNo">1645</span> return e.getValue().getCachedTime();<a name="line.1645"></a>
+<span class="sourceLineNo">1646</span> }<a name="line.1646"></a>
+<span class="sourceLineNo">1647</span><a name="line.1647"></a>
+<span class="sourceLineNo">1648</span> @Override<a name="line.1648"></a>
+<span class="sourceLineNo">1649</span> public String getFilename() {<a name="line.1649"></a>
+<span class="sourceLineNo">1650</span> return e.getKey().getHfileName();<a name="line.1650"></a>
+<span class="sourceLineNo">1651</span> }<a name="line.1651"></a>
+<span class="sourceLineNo">1652</span><a name="line.1652"></a>
+<span class="sourceLineNo">1653</span> @Override<a name="line.1653"></a>
+<span class="sourceLineNo">1654</span> public int compareTo(CachedBlock other) {<a name="line.1654"></a>
+<span class="sourceLineNo">1655</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1655"></a>
+<span class="sourceLineNo">1656</span> if (diff != 0) return diff;<a name="line.1656"></a>
+<span class="sourceLineNo">1657</span><a name="line.1657"></a>
+<span class="sourceLineNo">1658</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1658"></a>
+<span class="sourceLineNo">1659</span> if (diff != 0) return diff;<a name="line.1659"></a>
+<span class="sourceLineNo">1660</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1660"></a>
+<span class="sourceLineNo">1661</span> throw new IllegalStateException(<a name="line.1661"></a>
+<span class="sourceLineNo">1662</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1662"></a>
+<span class="sourceLineNo">1663</span> }<a name="line.1663"></a>
+<span class="sourceLineNo">1664</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1664"></a>
+<span class="sourceLineNo">1665</span> }<a name="line.1665"></a>
+<span class="sourceLineNo">1666</span><a name="line.1666"></a>
+<span class="sourceLineNo">1667</span> @Override<a name="line.1667"></a>
+<span class="sourceLineNo">1668</span> public int hashCode() {<a name="line.1668"></a>
+<span class="sourceLineNo">1669</span> return e.getKey().hashCode();<a name="line.1669"></a>
+<span class="sourceLineNo">1670</span> }<a name="line.1670"></a>
+<span class="sourceLineNo">1671</span><a name="line.1671"></a>
+<span class="sourceLineNo">1672</span> @Override<a name="line.1672"></a>
+<span class="sourceLineNo">1673</span> public boolean equals(Object obj) {<a name="line.1673"></a>
+<span class="sourceLineNo">1674</span> if (obj instanceof CachedBlock) {<a name="line.1674"></a>
+<span class="sourceLineNo">1675</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1675"></a>
+<span class="sourceLineNo">1676</span> return compareTo(cb) == 0;<a name="line.1676"></a>
+<span class="sourceLineNo">1677</span> } else {<a name="line.1677"></a>
+<span class="sourceLineNo">1678</span> return false;<a name="line.1678"></a>
+<span class="sourceLineNo">1679</span> }<a name="line.1679"></a>
+<span class="sourceLineNo">1680</span> }<a name="line.1680"></a>
+<span class="sourceLineNo">1681</span> };<a name="line.1681"></a>
+<span class="sourceLineNo">1682</span> }<a name="line.1682"></a>
+<span class="sourceLineNo">1683</span><a name="line.1683"></a>
+<span class="sourceLineNo">1684</span> @Override<a name="line.1684"></a>
+<span class="sourceLineNo">1685</span> public void remove() {<a name="line.1685"></a>
+<span class="sourceLineNo">1686</span> throw new UnsupportedOperationException();<a name="line.1686"></a>
+<span class="sourceLineNo">1687</span> }<a name="line.1687"></a>
+<span class="sourceLineNo">1688</span> };<a name="line.1688"></a>
+<span class="sourceLineNo">1689</span> }<a name="line.1689"></a>
+<span class="sourceLineNo">1690</span><a name="line.1690"></a>
+<span class="sourceLineNo">1691</span> @Override<a name="line.1691"></a>
+<span class="sourceLineNo">1692</span> public BlockCache[] getBlockCaches() {<a name="line.1692"></a>
+<span class="sourceLineNo">1693</span> return null;<a name="line.1693"></a>
+<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
+<span class="sourceLineNo">1695</span><a name="line.1695"></a>
+<span class="sourceLineNo">1696</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1696"></a>
+<span class="sourceLineNo">1697</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1697"></a>
+<span class="sourceLineNo">1698</span> if (bucketEntry != null) {<a name="line.1698"></a>
+<span class="sourceLineNo">1699</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1699"></a>
+<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
+<span class="sourceLineNo">1701</span> return 0;<a name="line.1701"></a>
+<span class="sourceLineNo">1702</span> }<a name="line.1702"></a>
+<span class="sourceLineNo">1703</span><a name="line.1703"></a>
+<span class="sourceLineNo">1704</span> float getAcceptableFactor() {<a name="line.1704"></a>
+<span class="sourceLineNo">1705</span> return acceptableFactor;<a name="line.1705"></a>
+<span class="sourceLineNo">1706</span> }<a name="line.1706"></a>
+<span class="sourceLineNo">1707</span><a name="line.1707"></a>
+<span class="sourceLineNo">1708</span> float getMinFactor() {<a name="line.1708"></a>
+<span class="sourceLineNo">1709</span> return minFactor;<a name="line.1709"></a>
+<span class="sourceLineNo">1710</span> }<a name="line.1710"></a>
+<span class="sourceLineNo">1711</span><a name="line.1711"></a>
+<span class="sourceLineNo">1712</span> float getExtraFreeFactor() {<a name="line.1712"></a>
+<span class="sourceLineNo">1713</span> return extraFreeFactor;<a name="line.1713"></a>
+<span class="sourceLineNo">1714</span> }<a name="line.1714"></a>
+<span class="sourceLineNo">1715</span><a name="line.1715"></a>
+<span class="sourceLineNo">1716</span> float getSingleFactor() {<a name="line.1716"></a>
+<span class="sourceLineNo">1717</span> return singleFactor;<a name="line.1717"></a>
+<span class="sourceLineNo">1718</span> }<a name="line.1718"></a>
+<span class="sourceLineNo">1719</span><a name="line.1719"></a>
+<span class="sourceLineNo">1720</span> float getMultiFactor() {<a name="line.1720"></a>
+<span class="sourceLineNo">1721</span> return multiFactor;<a name="line.1721"></a>
+<span class="sourceLineNo">1722</span> }<a name="line.1722"></a>
+<span class="sourceLineNo">1723</span><a name="line.1723"></a>
+<span class="sourceLineNo">1724</span> float getMemoryFactor() {<a name="line.1724"></a>
+<span class="sourceLineNo">1725</span> return memoryFactor;<a name="line.1725"></a>
+<span class="sourceLineNo">1726</span> }<a name="line.1726"></a>
+<span class="sourceLineNo">1727</span><a name="line.1727"></a>
+<span class="sourceLineNo">1728</span> /**<a name="line.1728"></a>
+<span class="sourceLineNo">1729</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1729"></a>
+<span class="sourceLineNo">1730</span> */<a name="line.1730"></a>
+<span class="sourceLineNo">1731</span> static class RAMCache {<a name="line.1731"></a>
+<span class="sourceLineNo">1732</span> /**<a name="line.1732"></a>
+<span class="sourceLineNo">1733</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1733"></a>
+<span class="sourceLineNo">1734</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1734"></a>
+<span class="sourceLineNo">1735</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1735"></a>
+<span class="sourceLineNo">1736</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1736"></a>
+<span class="sourceLineNo">1737</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1737"></a>
+<span class="sourceLineNo">1738</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1738"></a>
+<span class="sourceLineNo">1739</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1739"></a>
+<span class="sourceLineNo">1740</span> */<a name="line.1740"></a>
+<span class="sourceLineNo">1741</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1741"></a>
+<span class="sourceLineNo">1742</span><a name="line.1742"></a>
+<span class="sourceLineNo">1743</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1743"></a>
+<span class="sourceLineNo">1744</span> return delegate.containsKey(key);<a name="line.1744"></a>
+<span class="sourceLineNo">1745</span> }<a name="line.1745"></a>
+<span class="sourceLineNo">1746</span><a name="line.1746"></a>
+<span class="sourceLineNo">1747</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1747"></a>
+<span class="sourceLineNo">1748</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1748"></a>
+<span class="sourceLineNo">1749</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1749"></a>
+<span class="sourceLineNo">1750</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1750"></a>
+<span class="sourceLineNo">1751</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1751"></a>
+<span class="sourceLineNo">1752</span> re.getData().retain();<a name="line.1752"></a>
+<span class="sourceLineNo">1753</span> return re;<a name="line.1753"></a>
+<span class="sourceLineNo">1754</span> });<a name="line.1754"></a>
+<span class="sourceLineNo">1755</span> }<a name="line.1755"></a>
+<span class="sourceLineNo">1756</span><a name="line.1756"></a>
+<span class="sourceLineNo">1757</span> /**<a name="line.1757"></a>
+<span class="sourceLineNo">1758</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1758"></a>
+<span class="sourceLineNo">1759</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1759"></a>
+<span class="sourceLineNo">1760</span> */<a name="line.1760"></a>
+<span class="sourceLineNo">1761</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1761"></a>
+<span class="sourceLineNo">1762</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1762"></a>
+<span class="sourceLineNo">1763</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1763"></a>
+<span class="sourceLineNo">1764</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1764"></a>
+<span class="sourceLineNo">1765</span> entry.getData().retain();<a name="line.1765"></a>
+<span class="sourceLineNo">1766</span> absent.set(true);<a name="line.1766"></a>
+<span class="sourceLineNo">1767</span> return entry;<a name="line.1767"></a>
<span class="sourceLineNo">1768</span> });<a name="line.1768"></a>
-<span class="sourceLineNo">1769</span> }<a name="line.1769"></a>
-<span class="sourceLineNo">1770</span><a name="line.1770"></a>
-<span class="sourceLineNo">1771</span> /**<a name="line.1771"></a>
-<span class="sourceLineNo">1772</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1772"></a>
-<span class="sourceLineNo">1773</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1773"></a>
-<span class="sourceLineNo">1774</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1774"></a>
-<span class="sourceLineNo">1775</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1775"></a>
-<span class="sourceLineNo">1776</span> */<a name="line.1776"></a>
-<span class="sourceLineNo">1777</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1777"></a>
-<span class="sourceLineNo">1778</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1778"></a>
-<span class="sourceLineNo">1779</span> action.accept(previous);<a name="line.1779"></a>
-<span class="sourceLineNo">1780</span> if (previous != null) {<a name="line.1780"></a>
-<span class="sourceLineNo">1781</span> previous.getData().release();<a name="line.1781"></a>
-<span class="sourceLineNo">1782</span> }<a name="line.1782"></a>
-<span class="sourceLineNo">1783</span> return previous != null;<a name="line.1783"></a>
-<span class="sourceLineNo">1784</span> }<a name="line.1784"></a>
-<span class="sourceLineNo">1785</span><a name="line.1785"></a>
-<span class="sourceLineNo">1786</span> public boolean isEmpty() {<a name="line.1786"></a>
-<span class="sourceLineNo">1787</span> return delegate.isEmpty();<a name="line.1787"></a>
-<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
-<span class="sourceLineNo">1789</span><a name="line.1789"></a>
-<span class="sourceLineNo">1790</span> public void clear() {<a name="line.1790"></a>
-<span class="sourceLineNo">1791</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1791"></a>
-<span class="sourceLineNo">1792</span> while (it.hasNext()) {<a name="line.1792"></a>
-<span class="sourceLineNo">1793</span> RAMQueueEntry re = it.next().getValue();<a name="line.1793"></a>
-<span class="sourceLineNo">1794</span> it.remove();<a name="line.1794"></a>
-<span class="sourceLineNo">1795</span> re.getData().release();<a name="line.1795"></a>
-<span class="sourceLineNo">1796</span> }<a name="line.1796"></a>
-<span class="sourceLineNo">1797</span> }<a name="line.1797"></a>
-<span class="sourceLineNo">1798</span> }<a name="line.1798"></a>
-<span class="sourceLineNo">1799</span>}<a name="line.1799"></a>
+<span class="sourceLineNo">1769</span> return absent.get() ? null : re;<a name="line.1769"></a>
+<span class="sourceLineNo">1770</span> }<a name="line.1770"></a>
+<span class="sourceLineNo">1771</span><a name="line.1771"></a>
+<span class="sourceLineNo">1772</span> public boolean remove(BlockCacheKey key) {<a name="line.1772"></a>
+<span class="sourceLineNo">1773</span> return remove(key, re -> {<a name="line.1773"></a>
+<span class="sourceLineNo">1774</span> });<a name="line.1774"></a>
+<span class="sourceLineNo">1775</span> }<a name="line.1775"></a>
+<span class="sourceLineNo">1776</span><a name="line.1776"></a>
+<span class="sourceLineNo">1777</span> /**<a name="line.1777"></a>
+<span class="sourceLineNo">1778</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1778"></a>
+<span class="sourceLineNo">1779</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1779"></a>
+<span class="sourceLineNo">1780</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1780"></a>
+<span class="sourceLineNo">1781</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1781"></a>
+<span class="sourceLineNo">1782</span> */<a name="line.1782"></a>
+<span class="sourceLineNo">1783</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1783"></a>
+<span class="sourceLineNo">1784</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1784"></a>
+<span class="sourceLineNo">1785</span> action.accept(previous);<a name="line.1785"></a>
+<span class="sourceLineNo">1786</span> if (previous != null) {<a name="line.1786"></a>
+<span class="sourceLineNo">1787</span> previous.getData().release();<a name="line.1787"></a>
+<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
+<span class="sourceLineNo">1789</span> return previous != null;<a name="line.1789"></a>
+<span class="sourceLineNo">1790</span> }<a name="line.1790"></a>
+<span class="sourceLineNo">1791</span><a name="line.1791"></a>
+<span class="sourceLineNo">1792</span> public boolean isEmpty() {<a name="line.1792"></a>
+<span class="sourceLineNo">1793</span> return delegate.isEmpty();<a name="line.1793"></a>
+<span class="sourceLineNo">1794</span> }<a name="line.1794"></a>
+<span class="sourceLineNo">1795</span><a name="line.1795"></a>
+<span class="sourceLineNo">1796</span> public void clear() {<a name="line.1796"></a>
+<span class="sourceLineNo">1797</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1797"></a>
+<span class="sourceLineNo">1798</span> while (it.hasNext()) {<a name="line.1798"></a>
+<span class="sourceLineNo">1799</span> RAMQueueEntry re = it.next().getValue();<a name="line.1799"></a>
+<span class="sourceLineNo">1800</span> it.remove();<a name="line.1800"></a>
+<span class="sourceLineNo">1801</span> re.getData().release();<a name="line.1801"></a>
+<span class="sourceLineNo">1802</span> }<a name="line.1802"></a>
+<span class="sourceLineNo">1803</span> }<a name="line.1803"></a>
+<span class="sourceLineNo">1804</span> }<a name="line.1804"></a>
+<span class="sourceLineNo">1805</span>}<a name="line.1805"></a>
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html
index 30710531ef1..6b016942fa7 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMCache.html
@@ -1053,758 +1053,764 @@
<span class="sourceLineNo">1045</span> final HFileContext fileContext = ((HFileBlock) re.getData()).getHFileContext();<a name="line.1045"></a>
<span class="sourceLineNo">1046</span> final String columnFamily = Bytes.toString(fileContext.getColumnFamily());<a name="line.1046"></a>
<span class="sourceLineNo">1047</span> final String tableName = Bytes.toString(fileContext.getTableName());<a name="line.1047"></a>
-<span class="sourceLineNo">1048</span> if (tableName != null && columnFamily != null) {<a name="line.1048"></a>
+<span class="sourceLineNo">1048</span> if (tableName != null) {<a name="line.1048"></a>
<span class="sourceLineNo">1049</span> sb.append(" Table: ");<a name="line.1049"></a>
<span class="sourceLineNo">1050</span> sb.append(tableName);<a name="line.1050"></a>
-<span class="sourceLineNo">1051</span> sb.append(" CF: ");<a name="line.1051"></a>
-<span class="sourceLineNo">1052</span> sb.append(columnFamily);<a name="line.1052"></a>
-<span class="sourceLineNo">1053</span> sb.append(" HFile: ");<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span> sb.append(fileContext.getHFileName());<a name="line.1054"></a>
+<span class="sourceLineNo">1051</span> }<a name="line.1051"></a>
+<span class="sourceLineNo">1052</span> if (columnFamily != null) {<a name="line.1052"></a>
+<span class="sourceLineNo">1053</span> sb.append(" CF: ");<a name="line.1053"></a>
+<span class="sourceLineNo">1054</span> sb.append(columnFamily);<a name="line.1054"></a>
<span class="sourceLineNo">1055</span> }<a name="line.1055"></a>
-<span class="sourceLineNo">1056</span> } else {<a name="line.1056"></a>
-<span class="sourceLineNo">1057</span> sb.append(" HFile: ");<a name="line.1057"></a>
-<span class="sourceLineNo">1058</span> sb.append(re.getKey());<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span> }<a name="line.1059"></a>
-<span class="sourceLineNo">1060</span> }<a name="line.1060"></a>
-<span class="sourceLineNo">1061</span> sb.append(" Message: ");<a name="line.1061"></a>
-<span class="sourceLineNo">1062</span> sb.append(fle.getMessage());<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> return sb.toString();<a name="line.1063"></a>
-<span class="sourceLineNo">1064</span> }<a name="line.1064"></a>
-<span class="sourceLineNo">1065</span><a name="line.1065"></a>
-<span class="sourceLineNo">1066</span> /**<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1067"></a>
-<span class="sourceLineNo">1068</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1068"></a>
-<span class="sourceLineNo">1069</span> * references and we'll OOME.<a name="line.1069"></a>
-<span class="sourceLineNo">1070</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1070"></a>
-<span class="sourceLineNo">1071</span> * interference expected.<a name="line.1071"></a>
-<span class="sourceLineNo">1072</span> */<a name="line.1072"></a>
-<span class="sourceLineNo">1073</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1073"></a>
-<span class="sourceLineNo">1074</span> if (entries.isEmpty()) {<a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> return;<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span> }<a name="line.1076"></a>
-<span class="sourceLineNo">1077</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1078"></a>
-<span class="sourceLineNo">1079</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1081"></a>
-<span class="sourceLineNo">1082</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1082"></a>
-<span class="sourceLineNo">1083</span> final int size = entries.size();<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1084"></a>
-<span class="sourceLineNo">1085</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1086"></a>
-<span class="sourceLineNo">1087</span> int index = 0;<a name="line.1087"></a>
-<span class="sourceLineNo">1088</span> while (cacheEnabled && index < size) {<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span> RAMQueueEntry re = null;<a name="line.1089"></a>
-<span class="sourceLineNo">1090</span> try {<a name="line.1090"></a>
-<span class="sourceLineNo">1091</span> re = entries.get(index);<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span> if (re == null) {<a name="line.1092"></a>
-<span class="sourceLineNo">1093</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span> index++;<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span> continue;<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span> }<a name="line.1096"></a>
-<span class="sourceLineNo">1097</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1097"></a>
-<span class="sourceLineNo">1098</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> blocksByHFile.add(cacheKey);<a name="line.1099"></a>
-<span class="sourceLineNo">1100</span> }<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span> // Reset the position for reuse.<a name="line.1101"></a>
-<span class="sourceLineNo">1102</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1102"></a>
-<span class="sourceLineNo">1103</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span> // IOEngine in the future.<a name="line.1105"></a>
-<span class="sourceLineNo">1106</span> metaBuff.clear();<a name="line.1106"></a>
-<span class="sourceLineNo">1107</span> BucketEntry bucketEntry =<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1108"></a>
-<span class="sourceLineNo">1109</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1109"></a>
-<span class="sourceLineNo">1110</span> bucketEntries[index] = bucketEntry;<a name="line.1110"></a>
-<span class="sourceLineNo">1111</span> if (ioErrorStartTime > 0) {<a name="line.1111"></a>
-<span class="sourceLineNo">1112</span> ioErrorStartTime = -1;<a name="line.1112"></a>
-<span class="sourceLineNo">1113</span> }<a name="line.1113"></a>
-<span class="sourceLineNo">1114</span> index++;<a name="line.1114"></a>
-<span class="sourceLineNo">1115</span> } catch (BucketAllocatorException fle) {<a name="line.1115"></a>
-<span class="sourceLineNo">1116</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1116"></a>
-<span class="sourceLineNo">1117</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span> if (<a name="line.1118"></a>
-<span class="sourceLineNo">1119</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1119"></a>
-<span class="sourceLineNo">1120</span> ) {<a name="line.1120"></a>
-<span class="sourceLineNo">1121</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1121"></a>
-<span class="sourceLineNo">1122</span> allocFailLogPrevTs = currTs;<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span> }<a name="line.1123"></a>
-<span class="sourceLineNo">1124</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span> bucketEntries[index] = null;<a name="line.1125"></a>
-<span class="sourceLineNo">1126</span> index++;<a name="line.1126"></a>
-<span class="sourceLineNo">1127</span> } catch (CacheFullException cfe) {<a name="line.1127"></a>
-<span class="sourceLineNo">1128</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span> if (!freeInProgress) {<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span> freeSpace("Full!");<a name="line.1130"></a>
-<span class="sourceLineNo">1131</span> } else {<a name="line.1131"></a>
-<span class="sourceLineNo">1132</span> Thread.sleep(50);<a name="line.1132"></a>
-<span class="sourceLineNo">1133</span> }<a name="line.1133"></a>
-<span class="sourceLineNo">1134</span> } catch (IOException ioex) {<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1135"></a>
-<span class="sourceLineNo">1136</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1136"></a>
-<span class="sourceLineNo">1137</span> checkIOErrorIsTolerated();<a name="line.1137"></a>
-<span class="sourceLineNo">1138</span> }<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
-<span class="sourceLineNo">1140</span><a name="line.1140"></a>
-<span class="sourceLineNo">1141</span> // Make sure data pages are written on media before we update maps.<a name="line.1141"></a>
-<span class="sourceLineNo">1142</span> try {<a name="line.1142"></a>
-<span class="sourceLineNo">1143</span> ioEngine.sync();<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span> } catch (IOException ioex) {<a name="line.1144"></a>
-<span class="sourceLineNo">1145</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1145"></a>
-<span class="sourceLineNo">1146</span> checkIOErrorIsTolerated();<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1147"></a>
-<span class="sourceLineNo">1148</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> if (bucketEntry != null) {<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> bucketEntries[i] = null;<a name="line.1152"></a>
-<span class="sourceLineNo">1153</span> }<a name="line.1153"></a>
-<span class="sourceLineNo">1154</span> }<a name="line.1154"></a>
-<span class="sourceLineNo">1155</span> }<a name="line.1155"></a>
-<span class="sourceLineNo">1156</span><a name="line.1156"></a>
-<span class="sourceLineNo">1157</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1157"></a>
-<span class="sourceLineNo">1158</span> // success or error.<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span> for (int i = 0; i < size; ++i) {<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1160"></a>
-<span class="sourceLineNo">1161</span> // Only add if non-null entry.<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span> if (bucketEntries[i] != null) {<a name="line.1162"></a>
-<span class="sourceLineNo">1163</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span> }<a name="line.1164"></a>
-<span class="sourceLineNo">1165</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span> if (re != null) {<a name="line.1167"></a>
-<span class="sourceLineNo">1168</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1168"></a>
-<span class="sourceLineNo">1169</span> }<a name="line.1169"></a>
-<span class="sourceLineNo">1170</span> });<a name="line.1170"></a>
-<span class="sourceLineNo">1171</span> if (!existed && bucketEntries[i] != null) {<a name="line.1171"></a>
-<span class="sourceLineNo">1172</span> // Block should have already been evicted. Remove it and free space.<a name="line.1172"></a>
-<span class="sourceLineNo">1173</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1173"></a>
-<span class="sourceLineNo">1174</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1174"></a>
-<span class="sourceLineNo">1175</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1175"></a>
-<span class="sourceLineNo">1176</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1176"></a>
-<span class="sourceLineNo">1177</span> }<a name="line.1177"></a>
-<span class="sourceLineNo">1178</span> return null;<a name="line.1178"></a>
-<span class="sourceLineNo">1179</span> });<a name="line.1179"></a>
-<span class="sourceLineNo">1180</span> }<a name="line.1180"></a>
-<span class="sourceLineNo">1181</span> }<a name="line.1181"></a>
-<span class="sourceLineNo">1182</span><a name="line.1182"></a>
-<span class="sourceLineNo">1183</span> long used = bucketAllocator.getUsedSize();<a name="line.1183"></a>
-<span class="sourceLineNo">1184</span> if (used > acceptableSize()) {<a name="line.1184"></a>
-<span class="sourceLineNo">1185</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1185"></a>
-<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
-<span class="sourceLineNo">1187</span> return;<a name="line.1187"></a>
-<span class="sourceLineNo">1188</span> }<a name="line.1188"></a>
-<span class="sourceLineNo">1189</span><a name="line.1189"></a>
-<span class="sourceLineNo">1190</span> /**<a name="line.1190"></a>
-<span class="sourceLineNo">1191</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1191"></a>
-<span class="sourceLineNo">1192</span> * returning.<a name="line.1192"></a>
-<span class="sourceLineNo">1193</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1193"></a>
-<span class="sourceLineNo">1194</span> * in case.<a name="line.1194"></a>
-<span class="sourceLineNo">1195</span> * @param q The queue to take from.<a name="line.1195"></a>
-<span class="sourceLineNo">1196</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1196"></a>
-<span class="sourceLineNo">1197</span> */<a name="line.1197"></a>
-<span class="sourceLineNo">1198</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1198"></a>
-<span class="sourceLineNo">1199</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1199"></a>
-<span class="sourceLineNo">1200</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1200"></a>
-<span class="sourceLineNo">1201</span> // ok even if list grew to accommodate thousands.<a name="line.1201"></a>
-<span class="sourceLineNo">1202</span> receptacle.clear();<a name="line.1202"></a>
-<span class="sourceLineNo">1203</span> receptacle.add(q.take());<a name="line.1203"></a>
-<span class="sourceLineNo">1204</span> q.drainTo(receptacle);<a name="line.1204"></a>
-<span class="sourceLineNo">1205</span> return receptacle;<a name="line.1205"></a>
-<span class="sourceLineNo">1206</span> }<a name="line.1206"></a>
-<span class="sourceLineNo">1207</span><a name="line.1207"></a>
-<span class="sourceLineNo">1208</span> /**<a name="line.1208"></a>
-<span class="sourceLineNo">1209</span> * @see #retrieveFromFile(int[])<a name="line.1209"></a>
-<span class="sourceLineNo">1210</span> */<a name="line.1210"></a>
-<span class="sourceLineNo">1211</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1211"></a>
-<span class="sourceLineNo">1212</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1212"></a>
-<span class="sourceLineNo">1213</span> private void persistToFile() throws IOException {<a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> assert !cacheEnabled;<a name="line.1214"></a>
-<span class="sourceLineNo">1215</span> if (!ioEngine.isPersistent()) {<a name="line.1215"></a>
-<span class="sourceLineNo">1216</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1216"></a>
-<span class="sourceLineNo">1217</span> }<a name="line.1217"></a>
-<span class="sourceLineNo">1218</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1218"></a>
-<span class="sourceLineNo">1219</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1219"></a>
-<span class="sourceLineNo">1220</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1220"></a>
-<span class="sourceLineNo">1221</span> }<a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> if (prefetchedFileListPath != null) {<a name="line.1222"></a>
-<span class="sourceLineNo">1223</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1223"></a>
-<span class="sourceLineNo">1224</span> }<a name="line.1224"></a>
-<span class="sourceLineNo">1225</span> }<a name="line.1225"></a>
-<span class="sourceLineNo">1226</span><a name="line.1226"></a>
-<span class="sourceLineNo">1227</span> /**<a name="line.1227"></a>
-<span class="sourceLineNo">1228</span> * @see #persistToFile()<a name="line.1228"></a>
-<span class="sourceLineNo">1229</span> */<a name="line.1229"></a>
-<span class="sourceLineNo">1230</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1230"></a>
-<span class="sourceLineNo">1231</span> File persistenceFile = new File(persistencePath);<a name="line.1231"></a>
-<span class="sourceLineNo">1232</span> if (!persistenceFile.exists()) {<a name="line.1232"></a>
-<span class="sourceLineNo">1233</span> return;<a name="line.1233"></a>
-<span class="sourceLineNo">1234</span> }<a name="line.1234"></a>
-<span class="sourceLineNo">1235</span> assert !cacheEnabled;<a name="line.1235"></a>
-<span class="sourceLineNo">1236</span> if (prefetchedFileListPath != null) {<a name="line.1236"></a>
-<span class="sourceLineNo">1237</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1237"></a>
-<span class="sourceLineNo">1238</span> }<a name="line.1238"></a>
-<span class="sourceLineNo">1239</span><a name="line.1239"></a>
-<span class="sourceLineNo">1240</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1240"></a>
-<span class="sourceLineNo">1241</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1241"></a>
-<span class="sourceLineNo">1242</span> byte[] pbuf = new byte[pblen];<a name="line.1242"></a>
-<span class="sourceLineNo">1243</span> int read = in.read(pbuf);<a name="line.1243"></a>
-<span class="sourceLineNo">1244</span> if (read != pblen) {<a name="line.1244"></a>
-<span class="sourceLineNo">1245</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1245"></a>
-<span class="sourceLineNo">1246</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1246"></a>
-<span class="sourceLineNo">1247</span> }<a name="line.1247"></a>
-<span class="sourceLineNo">1248</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1248"></a>
-<span class="sourceLineNo">1249</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1249"></a>
-<span class="sourceLineNo">1250</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1250"></a>
-<span class="sourceLineNo">1251</span> throw new IOException(<a name="line.1251"></a>
-<span class="sourceLineNo">1252</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1252"></a>
+<span class="sourceLineNo">1056</span> sb.append(" HFile: ");<a name="line.1056"></a>
+<span class="sourceLineNo">1057</span> if (fileContext.getHFileName() != null) {<a name="line.1057"></a>
+<span class="sourceLineNo">1058</span> sb.append(fileContext.getHFileName());<a name="line.1058"></a>
+<span class="sourceLineNo">1059</span> } else {<a name="line.1059"></a>
+<span class="sourceLineNo">1060</span> sb.append(re.getKey());<a name="line.1060"></a>
+<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
+<span class="sourceLineNo">1062</span> } else {<a name="line.1062"></a>
+<span class="sourceLineNo">1063</span> sb.append(" HFile: ");<a name="line.1063"></a>
+<span class="sourceLineNo">1064</span> sb.append(re.getKey());<a name="line.1064"></a>
+<span class="sourceLineNo">1065</span> }<a name="line.1065"></a>
+<span class="sourceLineNo">1066</span> }<a name="line.1066"></a>
+<span class="sourceLineNo">1067</span> sb.append(" Message: ");<a name="line.1067"></a>
+<span class="sourceLineNo">1068</span> sb.append(fle.getMessage());<a name="line.1068"></a>
+<span class="sourceLineNo">1069</span> return sb.toString();<a name="line.1069"></a>
+<span class="sourceLineNo">1070</span> }<a name="line.1070"></a>
+<span class="sourceLineNo">1071</span><a name="line.1071"></a>
+<span class="sourceLineNo">1072</span> /**<a name="line.1072"></a>
+<span class="sourceLineNo">1073</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1073"></a>
+<span class="sourceLineNo">1074</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1074"></a>
+<span class="sourceLineNo">1075</span> * references and we'll OOME.<a name="line.1075"></a>
+<span class="sourceLineNo">1076</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1076"></a>
+<span class="sourceLineNo">1077</span> * interference expected.<a name="line.1077"></a>
+<span class="sourceLineNo">1078</span> */<a name="line.1078"></a>
+<span class="sourceLineNo">1079</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1079"></a>
+<span class="sourceLineNo">1080</span> if (entries.isEmpty()) {<a name="line.1080"></a>
+<span class="sourceLineNo">1081</span> return;<a name="line.1081"></a>
+<span class="sourceLineNo">1082</span> }<a name="line.1082"></a>
+<span class="sourceLineNo">1083</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1083"></a>
+<span class="sourceLineNo">1084</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1084"></a>
+<span class="sourceLineNo">1085</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1085"></a>
+<span class="sourceLineNo">1086</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1086"></a>
+<span class="sourceLineNo">1087</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1087"></a>
+<span class="sourceLineNo">1088</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1088"></a>
+<span class="sourceLineNo">1089</span> final int size = entries.size();<a name="line.1089"></a>
+<span class="sourceLineNo">1090</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1090"></a>
+<span class="sourceLineNo">1091</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1091"></a>
+<span class="sourceLineNo">1092</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1092"></a>
+<span class="sourceLineNo">1093</span> int index = 0;<a name="line.1093"></a>
+<span class="sourceLineNo">1094</span> while (cacheEnabled && index < size) {<a name="line.1094"></a>
+<span class="sourceLineNo">1095</span> RAMQueueEntry re = null;<a name="line.1095"></a>
+<span class="sourceLineNo">1096</span> try {<a name="line.1096"></a>
+<span class="sourceLineNo">1097</span> re = entries.get(index);<a name="line.1097"></a>
+<span class="sourceLineNo">1098</span> if (re == null) {<a name="line.1098"></a>
+<span class="sourceLineNo">1099</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1099"></a>
+<span class="sourceLineNo">1100</span> index++;<a name="line.1100"></a>
+<span class="sourceLineNo">1101</span> continue;<a name="line.1101"></a>
+<span class="sourceLineNo">1102</span> }<a name="line.1102"></a>
+<span class="sourceLineNo">1103</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1103"></a>
+<span class="sourceLineNo">1104</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1104"></a>
+<span class="sourceLineNo">1105</span> blocksByHFile.add(cacheKey);<a name="line.1105"></a>
+<span class="sourceLineNo">1106</span> }<a name="line.1106"></a>
+<span class="sourceLineNo">1107</span> // Reset the position for reuse.<a name="line.1107"></a>
+<span class="sourceLineNo">1108</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1108"></a>
+<span class="sourceLineNo">1109</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1109"></a>
+<span class="sourceLineNo">1110</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1110"></a>
+<span class="sourceLineNo">1111</span> // IOEngine in the future.<a name="line.1111"></a>
+<span class="sourceLineNo">1112</span> metaBuff.clear();<a name="line.1112"></a>
+<span class="sourceLineNo">1113</span> BucketEntry bucketEntry =<a name="line.1113"></a>
+<span class="sourceLineNo">1114</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1114"></a>
+<span class="sourceLineNo">1115</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1115"></a>
+<span class="sourceLineNo">1116</span> bucketEntries[index] = bucketEntry;<a name="line.1116"></a>
+<span class="sourceLineNo">1117</span> if (ioErrorStartTime > 0) {<a name="line.1117"></a>
+<span class="sourceLineNo">1118</span> ioErrorStartTime = -1;<a name="line.1118"></a>
+<span class="sourceLineNo">1119</span> }<a name="line.1119"></a>
+<span class="sourceLineNo">1120</span> index++;<a name="line.1120"></a>
+<span class="sourceLineNo">1121</span> } catch (BucketAllocatorException fle) {<a name="line.1121"></a>
+<span class="sourceLineNo">1122</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1122"></a>
+<span class="sourceLineNo">1123</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1123"></a>
+<span class="sourceLineNo">1124</span> if (<a name="line.1124"></a>
+<span class="sourceLineNo">1125</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1125"></a>
+<span class="sourceLineNo">1126</span> ) {<a name="line.1126"></a>
+<span class="sourceLineNo">1127</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1127"></a>
+<span class="sourceLineNo">1128</span> allocFailLogPrevTs = currTs;<a name="line.1128"></a>
+<span class="sourceLineNo">1129</span> }<a name="line.1129"></a>
+<span class="sourceLineNo">1130</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1130"></a>
+<span class="sourceLineNo">1131</span> bucketEntries[index] = null;<a name="line.1131"></a>
+<span class="sourceLineNo">1132</span> index++;<a name="line.1132"></a>
+<span class="sourceLineNo">1133</span> } catch (CacheFullException cfe) {<a name="line.1133"></a>
+<span class="sourceLineNo">1134</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1134"></a>
+<span class="sourceLineNo">1135</span> if (!freeInProgress) {<a name="line.1135"></a>
+<span class="sourceLineNo">1136</span> freeSpace("Full!");<a name="line.1136"></a>
+<span class="sourceLineNo">1137</span> } else {<a name="line.1137"></a>
+<span class="sourceLineNo">1138</span> Thread.sleep(50);<a name="line.1138"></a>
+<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
+<span class="sourceLineNo">1140</span> } catch (IOException ioex) {<a name="line.1140"></a>
+<span class="sourceLineNo">1141</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1141"></a>
+<span class="sourceLineNo">1142</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1142"></a>
+<span class="sourceLineNo">1143</span> checkIOErrorIsTolerated();<a name="line.1143"></a>
+<span class="sourceLineNo">1144</span> }<a name="line.1144"></a>
+<span class="sourceLineNo">1145</span> }<a name="line.1145"></a>
+<span class="sourceLineNo">1146</span><a name="line.1146"></a>
+<span class="sourceLineNo">1147</span> // Make sure data pages are written on media before we update maps.<a name="line.1147"></a>
+<span class="sourceLineNo">1148</span> try {<a name="line.1148"></a>
+<span class="sourceLineNo">1149</span> ioEngine.sync();<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span> } catch (IOException ioex) {<a name="line.1150"></a>
+<span class="sourceLineNo">1151</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1151"></a>
+<span class="sourceLineNo">1152</span> checkIOErrorIsTolerated();<a name="line.1152"></a>
+<span class="sourceLineNo">1153</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1153"></a>
+<span class="sourceLineNo">1154</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1154"></a>
+<span class="sourceLineNo">1155</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1155"></a>
+<span class="sourceLineNo">1156</span> if (bucketEntry != null) {<a name="line.1156"></a>
+<span class="sourceLineNo">1157</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1157"></a>
+<span class="sourceLineNo">1158</span> bucketEntries[i] = null;<a name="line.1158"></a>
+<span class="sourceLineNo">1159</span> }<a name="line.1159"></a>
+<span class="sourceLineNo">1160</span> }<a name="line.1160"></a>
+<span class="sourceLineNo">1161</span> }<a name="line.1161"></a>
+<span class="sourceLineNo">1162</span><a name="line.1162"></a>
+<span class="sourceLineNo">1163</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1163"></a>
+<span class="sourceLineNo">1164</span> // success or error.<a name="line.1164"></a>
+<span class="sourceLineNo">1165</span> for (int i = 0; i < size; ++i) {<a name="line.1165"></a>
+<span class="sourceLineNo">1166</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1166"></a>
+<span class="sourceLineNo">1167</span> // Only add if non-null entry.<a name="line.1167"></a>
+<span class="sourceLineNo">1168</span> if (bucketEntries[i] != null) {<a name="line.1168"></a>
+<span class="sourceLineNo">1169</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1169"></a>
+<span class="sourceLineNo">1170</span> }<a name="line.1170"></a>
+<span class="sourceLineNo">1171</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1171"></a>
+<span class="sourceLineNo">1172</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1172"></a>
+<span class="sourceLineNo">1173</span> if (re != null) {<a name="line.1173"></a>
+<span class="sourceLineNo">1174</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1174"></a>
+<span class="sourceLineNo">1175</span> }<a name="line.1175"></a>
+<span class="sourceLineNo">1176</span> });<a name="line.1176"></a>
+<span class="sourceLineNo">1177</span> if (!existed && bucketEntries[i] != null) {<a name="line.1177"></a>
+<span class="sourceLineNo">1178</span> // Block should have already been evicted. Remove it and free space.<a name="line.1178"></a>
+<span class="sourceLineNo">1179</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1179"></a>
+<span class="sourceLineNo">1180</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1180"></a>
+<span class="sourceLineNo">1181</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1181"></a>
+<span class="sourceLineNo">1182</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1182"></a>
+<span class="sourceLineNo">1183</span> }<a name="line.1183"></a>
+<span class="sourceLineNo">1184</span> return null;<a name="line.1184"></a>
+<span class="sourceLineNo">1185</span> });<a name="line.1185"></a>
+<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
+<span class="sourceLineNo">1187</span> }<a name="line.1187"></a>
+<span class="sourceLineNo">1188</span><a name="line.1188"></a>
+<span class="sourceLineNo">1189</span> long used = bucketAllocator.getUsedSize();<a name="line.1189"></a>
+<span class="sourceLineNo">1190</span> if (used > acceptableSize()) {<a name="line.1190"></a>
+<span class="sourceLineNo">1191</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1191"></a>
+<span class="sourceLineNo">1192</span> }<a name="line.1192"></a>
+<span class="sourceLineNo">1193</span> return;<a name="line.1193"></a>
+<span class="sourceLineNo">1194</span> }<a name="line.1194"></a>
+<span class="sourceLineNo">1195</span><a name="line.1195"></a>
+<span class="sourceLineNo">1196</span> /**<a name="line.1196"></a>
+<span class="sourceLineNo">1197</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1197"></a>
+<span class="sourceLineNo">1198</span> * returning.<a name="line.1198"></a>
+<span class="sourceLineNo">1199</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1199"></a>
+<span class="sourceLineNo">1200</span> * in case.<a name="line.1200"></a>
+<span class="sourceLineNo">1201</span> * @param q The queue to take from.<a name="line.1201"></a>
+<span class="sourceLineNo">1202</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1202"></a>
+<span class="sourceLineNo">1203</span> */<a name="line.1203"></a>
+<span class="sourceLineNo">1204</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1204"></a>
+<span class="sourceLineNo">1205</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1205"></a>
+<span class="sourceLineNo">1206</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1206"></a>
+<span class="sourceLineNo">1207</span> // ok even if list grew to accommodate thousands.<a name="line.1207"></a>
+<span class="sourceLineNo">1208</span> receptacle.clear();<a name="line.1208"></a>
+<span class="sourceLineNo">1209</span> receptacle.add(q.take());<a name="line.1209"></a>
+<span class="sourceLineNo">1210</span> q.drainTo(receptacle);<a name="line.1210"></a>
+<span class="sourceLineNo">1211</span> return receptacle;<a name="line.1211"></a>
+<span class="sourceLineNo">1212</span> }<a name="line.1212"></a>
+<span class="sourceLineNo">1213</span><a name="line.1213"></a>
+<span class="sourceLineNo">1214</span> /**<a name="line.1214"></a>
+<span class="sourceLineNo">1215</span> * @see #retrieveFromFile(int[])<a name="line.1215"></a>
+<span class="sourceLineNo">1216</span> */<a name="line.1216"></a>
+<span class="sourceLineNo">1217</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1217"></a>
+<span class="sourceLineNo">1218</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1218"></a>
+<span class="sourceLineNo">1219</span> private void persistToFile() throws IOException {<a name="line.1219"></a>
+<span class="sourceLineNo">1220</span> assert !cacheEnabled;<a name="line.1220"></a>
+<span class="sourceLineNo">1221</span> if (!ioEngine.isPersistent()) {<a name="line.1221"></a>
+<span class="sourceLineNo">1222</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1222"></a>
+<span class="sourceLineNo">1223</span> }<a name="line.1223"></a>
+<span class="sourceLineNo">1224</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1224"></a>
+<span class="sourceLineNo">1225</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1225"></a>
+<span class="sourceLineNo">1226</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1226"></a>
+<span class="sourceLineNo">1227</span> }<a name="line.1227"></a>
+<span class="sourceLineNo">1228</span> if (prefetchedFileListPath != null) {<a name="line.1228"></a>
+<span class="sourceLineNo">1229</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1229"></a>
+<span class="sourceLineNo">1230</span> }<a name="line.1230"></a>
+<span class="sourceLineNo">1231</span> }<a name="line.1231"></a>
+<span class="sourceLineNo">1232</span><a name="line.1232"></a>
+<span class="sourceLineNo">1233</span> /**<a name="line.1233"></a>
+<span class="sourceLineNo">1234</span> * @see #persistToFile()<a name="line.1234"></a>
+<span class="sourceLineNo">1235</span> */<a name="line.1235"></a>
+<span class="sourceLineNo">1236</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1236"></a>
+<span class="sourceLineNo">1237</span> File persistenceFile = new File(persistencePath);<a name="line.1237"></a>
+<span class="sourceLineNo">1238</span> if (!persistenceFile.exists()) {<a name="line.1238"></a>
+<span class="sourceLineNo">1239</span> return;<a name="line.1239"></a>
+<span class="sourceLineNo">1240</span> }<a name="line.1240"></a>
+<span class="sourceLineNo">1241</span> assert !cacheEnabled;<a name="line.1241"></a>
+<span class="sourceLineNo">1242</span> if (prefetchedFileListPath != null) {<a name="line.1242"></a>
+<span class="sourceLineNo">1243</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1243"></a>
+<span class="sourceLineNo">1244</span> }<a name="line.1244"></a>
+<span class="sourceLineNo">1245</span><a name="line.1245"></a>
+<span class="sourceLineNo">1246</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1246"></a>
+<span class="sourceLineNo">1247</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1247"></a>
+<span class="sourceLineNo">1248</span> byte[] pbuf = new byte[pblen];<a name="line.1248"></a>
+<span class="sourceLineNo">1249</span> int read = in.read(pbuf);<a name="line.1249"></a>
+<span class="sourceLineNo">1250</span> if (read != pblen) {<a name="line.1250"></a>
+<span class="sourceLineNo">1251</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1251"></a>
+<span class="sourceLineNo">1252</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1252"></a>
<span class="sourceLineNo">1253</span> }<a name="line.1253"></a>
-<span class="sourceLineNo">1254</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1254"></a>
-<span class="sourceLineNo">1255</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1255"></a>
-<span class="sourceLineNo">1256</span> blockNumber.add(backingMap.size());<a name="line.1256"></a>
-<span class="sourceLineNo">1257</span> }<a name="line.1257"></a>
-<span class="sourceLineNo">1258</span> }<a name="line.1258"></a>
-<span class="sourceLineNo">1259</span><a name="line.1259"></a>
-<span class="sourceLineNo">1260</span> /**<a name="line.1260"></a>
-<span class="sourceLineNo">1261</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1261"></a>
-<span class="sourceLineNo">1262</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1262"></a>
-<span class="sourceLineNo">1263</span> *<a name="line.1263"></a>
-<span class="sourceLineNo">1264</span> * <pre><a name="line.1264"></a>
-<span class="sourceLineNo">1265</span> * File f = ...<a name="line.1265"></a>
-<span class="sourceLineNo">1266</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1266"></a>
-<span class="sourceLineNo">1267</span> * // use the input stream<a name="line.1267"></a>
-<span class="sourceLineNo">1268</span> * } finally {<a name="line.1268"></a>
-<span class="sourceLineNo">1269</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1269"></a>
-<span class="sourceLineNo">1270</span> * }<a name="line.1270"></a>
-<span class="sourceLineNo">1271</span> * </pre><a name="line.1271"></a>
-<span class="sourceLineNo">1272</span> *<a name="line.1272"></a>
-<span class="sourceLineNo">1273</span> * @param file the file to read and delete<a name="line.1273"></a>
-<span class="sourceLineNo">1274</span> * @return a FileInputStream for the given file<a name="line.1274"></a>
-<span class="sourceLineNo">1275</span> * @throws IOException if there is a problem creating the stream<a name="line.1275"></a>
-<span class="sourceLineNo">1276</span> */<a name="line.1276"></a>
-<span class="sourceLineNo">1277</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1277"></a>
-<span class="sourceLineNo">1278</span> return new FileInputStream(file) {<a name="line.1278"></a>
-<span class="sourceLineNo">1279</span> private File myFile;<a name="line.1279"></a>
-<span class="sourceLineNo">1280</span><a name="line.1280"></a>
-<span class="sourceLineNo">1281</span> private FileInputStream init(File file) {<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> myFile = file;<a name="line.1282"></a>
-<span class="sourceLineNo">1283</span> return this;<a name="line.1283"></a>
-<span class="sourceLineNo">1284</span> }<a name="line.1284"></a>
-<span class="sourceLineNo">1285</span><a name="line.1285"></a>
-<span class="sourceLineNo">1286</span> @Override<a name="line.1286"></a>
-<span class="sourceLineNo">1287</span> public void close() throws IOException {<a name="line.1287"></a>
-<span class="sourceLineNo">1288</span> // close() will be called during try-with-resources and it will be<a name="line.1288"></a>
-<span class="sourceLineNo">1289</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1289"></a>
-<span class="sourceLineNo">1290</span> // set myFile to null after the first call.<a name="line.1290"></a>
-<span class="sourceLineNo">1291</span> if (myFile == null) {<a name="line.1291"></a>
-<span class="sourceLineNo">1292</span> return;<a name="line.1292"></a>
-<span class="sourceLineNo">1293</span> }<a name="line.1293"></a>
-<span class="sourceLineNo">1294</span><a name="line.1294"></a>
-<span class="sourceLineNo">1295</span> super.close();<a name="line.1295"></a>
-<span class="sourceLineNo">1296</span> if (!myFile.delete()) {<a name="line.1296"></a>
-<span class="sourceLineNo">1297</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1297"></a>
-<span class="sourceLineNo">1298</span> }<a name="line.1298"></a>
-<span class="sourceLineNo">1299</span> myFile = null;<a name="line.1299"></a>
-<span class="sourceLineNo">1300</span> }<a name="line.1300"></a>
-<span class="sourceLineNo">1301</span> }.init(file);<a name="line.1301"></a>
-<span class="sourceLineNo">1302</span> }<a name="line.1302"></a>
-<span class="sourceLineNo">1303</span><a name="line.1303"></a>
-<span class="sourceLineNo">1304</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1304"></a>
-<span class="sourceLineNo">1305</span> throws IOException {<a name="line.1305"></a>
-<span class="sourceLineNo">1306</span> if (capacitySize != cacheCapacity) {<a name="line.1306"></a>
-<span class="sourceLineNo">1307</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1307"></a>
-<span class="sourceLineNo">1308</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1308"></a>
-<span class="sourceLineNo">1309</span> }<a name="line.1309"></a>
-<span class="sourceLineNo">1310</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1310"></a>
-<span class="sourceLineNo">1311</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1311"></a>
-<span class="sourceLineNo">1312</span> + ioEngine.getClass().getName());<a name="line.1312"></a>
-<span class="sourceLineNo">1313</span> }<a name="line.1313"></a>
-<span class="sourceLineNo">1314</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1314"></a>
-<span class="sourceLineNo">1315</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1315"></a>
-<span class="sourceLineNo">1316</span> + backingMap.getClass().getName());<a name="line.1316"></a>
-<span class="sourceLineNo">1317</span> }<a name="line.1317"></a>
-<span class="sourceLineNo">1318</span> }<a name="line.1318"></a>
-<span class="sourceLineNo">1319</span><a name="line.1319"></a>
-<span class="sourceLineNo">1320</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1320"></a>
-<span class="sourceLineNo">1321</span> if (proto.hasChecksum()) {<a name="line.1321"></a>
-<span class="sourceLineNo">1322</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1322"></a>
-<span class="sourceLineNo">1323</span> algorithm);<a name="line.1323"></a>
-<span class="sourceLineNo">1324</span> } else {<a name="line.1324"></a>
-<span class="sourceLineNo">1325</span> // if has not checksum, it means the persistence file is old format<a name="line.1325"></a>
-<span class="sourceLineNo">1326</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1326"></a>
-<span class="sourceLineNo">1327</span> }<a name="line.1327"></a>
-<span class="sourceLineNo">1328</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1328"></a>
-<span class="sourceLineNo">1329</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1329"></a>
-<span class="sourceLineNo">1330</span> this::createRecycler);<a name="line.1330"></a>
-<span class="sourceLineNo">1331</span> }<a name="line.1331"></a>
-<span class="sourceLineNo">1332</span><a name="line.1332"></a>
-<span class="sourceLineNo">1333</span> /**<a name="line.1333"></a>
-<span class="sourceLineNo">1334</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1334"></a>
-<span class="sourceLineNo">1335</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1335"></a>
-<span class="sourceLineNo">1336</span> */<a name="line.1336"></a>
-<span class="sourceLineNo">1337</span> private void checkIOErrorIsTolerated() {<a name="line.1337"></a>
-<span class="sourceLineNo">1338</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1338"></a>
-<span class="sourceLineNo">1339</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1339"></a>
-<span class="sourceLineNo">1340</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1340"></a>
-<span class="sourceLineNo">1341</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1341"></a>
-<span class="sourceLineNo">1342</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1343"></a>
-<span class="sourceLineNo">1344</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1344"></a>
-<span class="sourceLineNo">1345</span> disableCache();<a name="line.1345"></a>
-<span class="sourceLineNo">1346</span> }<a name="line.1346"></a>
-<span class="sourceLineNo">1347</span> } else {<a name="line.1347"></a>
-<span class="sourceLineNo">1348</span> this.ioErrorStartTime = now;<a name="line.1348"></a>
-<span class="sourceLineNo">1349</span> }<a name="line.1349"></a>
-<span class="sourceLineNo">1350</span> }<a name="line.1350"></a>
-<span class="sourceLineNo">1351</span><a name="line.1351"></a>
-<span class="sourceLineNo">1352</span> /**<a name="line.1352"></a>
-<span class="sourceLineNo">1353</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1353"></a>
-<span class="sourceLineNo">1354</span> */<a name="line.1354"></a>
-<span class="sourceLineNo">1355</span> private void disableCache() {<a name="line.1355"></a>
-<span class="sourceLineNo">1356</span> if (!cacheEnabled) return;<a name="line.1356"></a>
-<span class="sourceLineNo">1357</span> cacheEnabled = false;<a name="line.1357"></a>
-<span class="sourceLineNo">1358</span> ioEngine.shutdown();<a name="line.1358"></a>
-<span class="sourceLineNo">1359</span> this.scheduleThreadPool.shutdown();<a name="line.1359"></a>
-<span class="sourceLineNo">1360</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1360"></a>
-<span class="sourceLineNo">1361</span> writerThreads[i].interrupt();<a name="line.1361"></a>
-<span class="sourceLineNo">1362</span> this.ramCache.clear();<a name="line.1362"></a>
-<span class="sourceLineNo">1363</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1363"></a>
-<span class="sourceLineNo">1364</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1364"></a>
-<span class="sourceLineNo">1365</span> this.backingMap.clear();<a name="line.1365"></a>
-<span class="sourceLineNo">1366</span> }<a name="line.1366"></a>
-<span class="sourceLineNo">1367</span> }<a name="line.1367"></a>
-<span class="sourceLineNo">1368</span><a name="line.1368"></a>
-<span class="sourceLineNo">1369</span> private void join() throws InterruptedException {<a name="line.1369"></a>
-<span class="sourceLineNo">1370</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1370"></a>
-<span class="sourceLineNo">1371</span> writerThreads[i].join();<a name="line.1371"></a>
-<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
-<span class="sourceLineNo">1373</span><a name="line.1373"></a>
-<span class="sourceLineNo">1374</span> @Override<a name="line.1374"></a>
-<span class="sourceLineNo">1375</span> public void shutdown() {<a name="line.1375"></a>
-<span class="sourceLineNo">1376</span> disableCache();<a name="line.1376"></a>
-<span class="sourceLineNo">1377</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1377"></a>
-<span class="sourceLineNo">1378</span> + persistencePath);<a name="line.1378"></a>
-<span class="sourceLineNo">1379</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1379"></a>
-<span class="sourceLineNo">1380</span> try {<a name="line.1380"></a>
-<span class="sourceLineNo">1381</span> join();<a name="line.1381"></a>
-<span class="sourceLineNo">1382</span> persistToFile();<a name="line.1382"></a>
-<span class="sourceLineNo">1383</span> } catch (IOException ex) {<a name="line.1383"></a>
-<span class="sourceLineNo">1384</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1384"></a>
-<span class="sourceLineNo">1385</span> } catch (InterruptedException e) {<a name="line.1385"></a>
-<span class="sourceLineNo">1386</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> }<a name="line.1387"></a>
-<span class="sourceLineNo">1388</span> }<a name="line.1388"></a>
-<span class="sourceLineNo">1389</span> }<a name="line.1389"></a>
-<span class="sourceLineNo">1390</span><a name="line.1390"></a>
-<span class="sourceLineNo">1391</span> @Override<a name="line.1391"></a>
-<span class="sourceLineNo">1392</span> public CacheStats getStats() {<a name="line.1392"></a>
-<span class="sourceLineNo">1393</span> return cacheStats;<a name="line.1393"></a>
-<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
-<span class="sourceLineNo">1395</span><a name="line.1395"></a>
-<span class="sourceLineNo">1396</span> public BucketAllocator getAllocator() {<a name="line.1396"></a>
-<span class="sourceLineNo">1397</span> return this.bucketAllocator;<a name="line.1397"></a>
-<span class="sourceLineNo">1398</span> }<a name="line.1398"></a>
-<span class="sourceLineNo">1399</span><a name="line.1399"></a>
-<span class="sourceLineNo">1400</span> @Override<a name="line.1400"></a>
-<span class="sourceLineNo">1401</span> public long heapSize() {<a name="line.1401"></a>
-<span class="sourceLineNo">1402</span> return this.heapSize.sum();<a name="line.1402"></a>
-<span class="sourceLineNo">1403</span> }<a name="line.1403"></a>
-<span class="sourceLineNo">1404</span><a name="line.1404"></a>
-<span class="sourceLineNo">1405</span> @Override<a name="line.1405"></a>
-<span class="sourceLineNo">1406</span> public long size() {<a name="line.1406"></a>
-<span class="sourceLineNo">1407</span> return this.realCacheSize.sum();<a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> }<a name="line.1408"></a>
-<span class="sourceLineNo">1409</span><a name="line.1409"></a>
-<span class="sourceLineNo">1410</span> @Override<a name="line.1410"></a>
-<span class="sourceLineNo">1411</span> public long getCurrentDataSize() {<a name="line.1411"></a>
-<span class="sourceLineNo">1412</span> return size();<a name="line.1412"></a>
-<span class="sourceLineNo">1413</span> }<a name="line.1413"></a>
-<span class="sourceLineNo">1414</span><a name="line.1414"></a>
-<span class="sourceLineNo">1415</span> @Override<a name="line.1415"></a>
-<span class="sourceLineNo">1416</span> public long getFreeSize() {<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> return this.bucketAllocator.getFreeSize();<a name="line.1417"></a>
-<span class="sourceLineNo">1418</span> }<a name="line.1418"></a>
-<span class="sourceLineNo">1419</span><a name="line.1419"></a>
-<span class="sourceLineNo">1420</span> @Override<a name="line.1420"></a>
-<span class="sourceLineNo">1421</span> public long getBlockCount() {<a name="line.1421"></a>
-<span class="sourceLineNo">1422</span> return this.blockNumber.sum();<a name="line.1422"></a>
-<span class="sourceLineNo">1423</span> }<a name="line.1423"></a>
-<span class="sourceLineNo">1424</span><a name="line.1424"></a>
-<span class="sourceLineNo">1425</span> @Override<a name="line.1425"></a>
-<span class="sourceLineNo">1426</span> public long getDataBlockCount() {<a name="line.1426"></a>
-<span class="sourceLineNo">1427</span> return getBlockCount();<a name="line.1427"></a>
-<span class="sourceLineNo">1428</span> }<a name="line.1428"></a>
-<span class="sourceLineNo">1429</span><a name="line.1429"></a>
-<span class="sourceLineNo">1430</span> @Override<a name="line.1430"></a>
-<span class="sourceLineNo">1431</span> public long getCurrentSize() {<a name="line.1431"></a>
-<span class="sourceLineNo">1432</span> return this.bucketAllocator.getUsedSize();<a name="line.1432"></a>
-<span class="sourceLineNo">1433</span> }<a name="line.1433"></a>
-<span class="sourceLineNo">1434</span><a name="line.1434"></a>
-<span class="sourceLineNo">1435</span> protected String getAlgorithm() {<a name="line.1435"></a>
-<span class="sourceLineNo">1436</span> return algorithm;<a name="line.1436"></a>
-<span class="sourceLineNo">1437</span> }<a name="line.1437"></a>
-<span class="sourceLineNo">1438</span><a name="line.1438"></a>
-<span class="sourceLineNo">1439</span> /**<a name="line.1439"></a>
-<span class="sourceLineNo">1440</span> * Evicts all blocks for a specific HFile.<a name="line.1440"></a>
-<span class="sourceLineNo">1441</span> * <p><a name="line.1441"></a>
-<span class="sourceLineNo">1442</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1442"></a>
-<span class="sourceLineNo">1443</span> * @return the number of blocks evicted<a name="line.1443"></a>
-<span class="sourceLineNo">1444</span> */<a name="line.1444"></a>
-<span class="sourceLineNo">1445</span> @Override<a name="line.1445"></a>
-<span class="sourceLineNo">1446</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1446"></a>
-<span class="sourceLineNo">1447</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1447"></a>
-<span class="sourceLineNo">1448</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1448"></a>
-<span class="sourceLineNo">1449</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1449"></a>
-<span class="sourceLineNo">1450</span><a name="line.1450"></a>
-<span class="sourceLineNo">1451</span> int numEvicted = 0;<a name="line.1451"></a>
-<span class="sourceLineNo">1452</span> for (BlockCacheKey key : keySet) {<a name="line.1452"></a>
-<span class="sourceLineNo">1453</span> if (evictBlock(key)) {<a name="line.1453"></a>
-<span class="sourceLineNo">1454</span> ++numEvicted;<a name="line.1454"></a>
-<span class="sourceLineNo">1455</span> }<a name="line.1455"></a>
-<span class="sourceLineNo">1456</span> }<a name="line.1456"></a>
-<span class="sourceLineNo">1457</span><a name="line.1457"></a>
-<span class="sourceLineNo">1458</span> return numEvicted;<a name="line.1458"></a>
-<span class="sourceLineNo">1459</span> }<a name="line.1459"></a>
-<span class="sourceLineNo">1460</span><a name="line.1460"></a>
-<span class="sourceLineNo">1461</span> /**<a name="line.1461"></a>
-<span class="sourceLineNo">1462</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1462"></a>
-<span class="sourceLineNo">1463</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1463"></a>
-<span class="sourceLineNo">1464</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1464"></a>
-<span class="sourceLineNo">1465</span> */<a name="line.1465"></a>
-<span class="sourceLineNo">1466</span> private class BucketEntryGroup {<a name="line.1466"></a>
-<span class="sourceLineNo">1467</span><a name="line.1467"></a>
-<span class="sourceLineNo">1468</span> private CachedEntryQueue queue;<a name="line.1468"></a>
-<span class="sourceLineNo">1469</span> private long totalSize = 0;<a name="line.1469"></a>
-<span class="sourceLineNo">1470</span> private long bucketSize;<a name="line.1470"></a>
-<span class="sourceLineNo">1471</span><a name="line.1471"></a>
-<span class="sourceLineNo">1472</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1472"></a>
-<span class="sourceLineNo">1473</span> this.bucketSize = bucketSize;<a name="line.1473"></a>
-<span class="sourceLineNo">1474</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1474"></a>
-<span class="sourceLineNo">1475</span> totalSize = 0;<a name="line.1475"></a>
-<span class="sourceLineNo">1476</span> }<a name="line.1476"></a>
+<span class="sourceLineNo">1254</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1254"></a>
+<span class="sourceLineNo">1255</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1255"></a>
+<span class="sourceLineNo">1256</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1256"></a>
+<span class="sourceLineNo">1257</span> throw new IOException(<a name="line.1257"></a>
+<span class="sourceLineNo">1258</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1258"></a>
+<span class="sourceLineNo">1259</span> }<a name="line.1259"></a>
+<span class="sourceLineNo">1260</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1260"></a>
+<span class="sourceLineNo">1261</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1261"></a>
+<span class="sourceLineNo">1262</span> blockNumber.add(backingMap.size());<a name="line.1262"></a>
+<span class="sourceLineNo">1263</span> }<a name="line.1263"></a>
+<span class="sourceLineNo">1264</span> }<a name="line.1264"></a>
+<span class="sourceLineNo">1265</span><a name="line.1265"></a>
+<span class="sourceLineNo">1266</span> /**<a name="line.1266"></a>
+<span class="sourceLineNo">1267</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1267"></a>
+<span class="sourceLineNo">1268</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1268"></a>
+<span class="sourceLineNo">1269</span> *<a name="line.1269"></a>
+<span class="sourceLineNo">1270</span> * <pre><a name="line.1270"></a>
+<span class="sourceLineNo">1271</span> * File f = ...<a name="line.1271"></a>
+<span class="sourceLineNo">1272</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1272"></a>
+<span class="sourceLineNo">1273</span> * // use the input stream<a name="line.1273"></a>
+<span class="sourceLineNo">1274</span> * } finally {<a name="line.1274"></a>
+<span class="sourceLineNo">1275</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1275"></a>
+<span class="sourceLineNo">1276</span> * }<a name="line.1276"></a>
+<span class="sourceLineNo">1277</span> * </pre><a name="line.1277"></a>
+<span class="sourceLineNo">1278</span> *<a name="line.1278"></a>
+<span class="sourceLineNo">1279</span> * @param file the file to read and delete<a name="line.1279"></a>
+<span class="sourceLineNo">1280</span> * @return a FileInputStream for the given file<a name="line.1280"></a>
+<span class="sourceLineNo">1281</span> * @throws IOException if there is a problem creating the stream<a name="line.1281"></a>
+<span class="sourceLineNo">1282</span> */<a name="line.1282"></a>
+<span class="sourceLineNo">1283</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1283"></a>
+<span class="sourceLineNo">1284</span> return new FileInputStream(file) {<a name="line.1284"></a>
+<span class="sourceLineNo">1285</span> private File myFile;<a name="line.1285"></a>
+<span class="sourceLineNo">1286</span><a name="line.1286"></a>
+<span class="sourceLineNo">1287</span> private FileInputStream init(File file) {<a name="line.1287"></a>
+<span class="sourceLineNo">1288</span> myFile = file;<a name="line.1288"></a>
+<span class="sourceLineNo">1289</span> return this;<a name="line.1289"></a>
+<span class="sourceLineNo">1290</span> }<a name="line.1290"></a>
+<span class="sourceLineNo">1291</span><a name="line.1291"></a>
+<span class="sourceLineNo">1292</span> @Override<a name="line.1292"></a>
+<span class="sourceLineNo">1293</span> public void close() throws IOException {<a name="line.1293"></a>
+<span class="sourceLineNo">1294</span> // close() will be called during try-with-resources and it will be<a name="line.1294"></a>
+<span class="sourceLineNo">1295</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1295"></a>
+<span class="sourceLineNo">1296</span> // set myFile to null after the first call.<a name="line.1296"></a>
+<span class="sourceLineNo">1297</span> if (myFile == null) {<a name="line.1297"></a>
+<span class="sourceLineNo">1298</span> return;<a name="line.1298"></a>
+<span class="sourceLineNo">1299</span> }<a name="line.1299"></a>
+<span class="sourceLineNo">1300</span><a name="line.1300"></a>
+<span class="sourceLineNo">1301</span> super.close();<a name="line.1301"></a>
+<span class="sourceLineNo">1302</span> if (!myFile.delete()) {<a name="line.1302"></a>
+<span class="sourceLineNo">1303</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1303"></a>
+<span class="sourceLineNo">1304</span> }<a name="line.1304"></a>
+<span class="sourceLineNo">1305</span> myFile = null;<a name="line.1305"></a>
+<span class="sourceLineNo">1306</span> }<a name="line.1306"></a>
+<span class="sourceLineNo">1307</span> }.init(file);<a name="line.1307"></a>
+<span class="sourceLineNo">1308</span> }<a name="line.1308"></a>
+<span class="sourceLineNo">1309</span><a name="line.1309"></a>
+<span class="sourceLineNo">1310</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1310"></a>
+<span class="sourceLineNo">1311</span> throws IOException {<a name="line.1311"></a>
+<span class="sourceLineNo">1312</span> if (capacitySize != cacheCapacity) {<a name="line.1312"></a>
+<span class="sourceLineNo">1313</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1313"></a>
+<span class="sourceLineNo">1314</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1314"></a>
+<span class="sourceLineNo">1315</span> }<a name="line.1315"></a>
+<span class="sourceLineNo">1316</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1316"></a>
+<span class="sourceLineNo">1317</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1317"></a>
+<span class="sourceLineNo">1318</span> + ioEngine.getClass().getName());<a name="line.1318"></a>
+<span class="sourceLineNo">1319</span> }<a name="line.1319"></a>
+<span class="sourceLineNo">1320</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1320"></a>
+<span class="sourceLineNo">1321</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1321"></a>
+<span class="sourceLineNo">1322</span> + backingMap.getClass().getName());<a name="line.1322"></a>
+<span class="sourceLineNo">1323</span> }<a name="line.1323"></a>
+<span class="sourceLineNo">1324</span> }<a name="line.1324"></a>
+<span class="sourceLineNo">1325</span><a name="line.1325"></a>
+<span class="sourceLineNo">1326</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1326"></a>
+<span class="sourceLineNo">1327</span> if (proto.hasChecksum()) {<a name="line.1327"></a>
+<span class="sourceLineNo">1328</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1328"></a>
+<span class="sourceLineNo">1329</span> algorithm);<a name="line.1329"></a>
+<span class="sourceLineNo">1330</span> } else {<a name="line.1330"></a>
+<span class="sourceLineNo">1331</span> // if has not checksum, it means the persistence file is old format<a name="line.1331"></a>
+<span class="sourceLineNo">1332</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1332"></a>
+<span class="sourceLineNo">1333</span> }<a name="line.1333"></a>
+<span class="sourceLineNo">1334</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1334"></a>
+<span class="sourceLineNo">1335</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1335"></a>
+<span class="sourceLineNo">1336</span> this::createRecycler);<a name="line.1336"></a>
+<span class="sourceLineNo">1337</span> }<a name="line.1337"></a>
+<span class="sourceLineNo">1338</span><a name="line.1338"></a>
+<span class="sourceLineNo">1339</span> /**<a name="line.1339"></a>
+<span class="sourceLineNo">1340</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1340"></a>
+<span class="sourceLineNo">1341</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1341"></a>
+<span class="sourceLineNo">1342</span> */<a name="line.1342"></a>
+<span class="sourceLineNo">1343</span> private void checkIOErrorIsTolerated() {<a name="line.1343"></a>
+<span class="sourceLineNo">1344</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1344"></a>
+<span class="sourceLineNo">1345</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1345"></a>
+<span class="sourceLineNo">1346</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1346"></a>
+<span class="sourceLineNo">1347</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1347"></a>
+<span class="sourceLineNo">1348</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1348"></a>
+<span class="sourceLineNo">1349</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1349"></a>
+<span class="sourceLineNo">1350</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1350"></a>
+<span class="sourceLineNo">1351</span> disableCache();<a name="line.1351"></a>
+<span class="sourceLineNo">1352</span> }<a name="line.1352"></a>
+<span class="sourceLineNo">1353</span> } else {<a name="line.1353"></a>
+<span class="sourceLineNo">1354</span> this.ioErrorStartTime = now;<a name="line.1354"></a>
+<span class="sourceLineNo">1355</span> }<a name="line.1355"></a>
+<span class="sourceLineNo">1356</span> }<a name="line.1356"></a>
+<span class="sourceLineNo">1357</span><a name="line.1357"></a>
+<span class="sourceLineNo">1358</span> /**<a name="line.1358"></a>
+<span class="sourceLineNo">1359</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1359"></a>
+<span class="sourceLineNo">1360</span> */<a name="line.1360"></a>
+<span class="sourceLineNo">1361</span> private void disableCache() {<a name="line.1361"></a>
+<span class="sourceLineNo">1362</span> if (!cacheEnabled) return;<a name="line.1362"></a>
+<span class="sourceLineNo">1363</span> cacheEnabled = false;<a name="line.1363"></a>
+<span class="sourceLineNo">1364</span> ioEngine.shutdown();<a name="line.1364"></a>
+<span class="sourceLineNo">1365</span> this.scheduleThreadPool.shutdown();<a name="line.1365"></a>
+<span class="sourceLineNo">1366</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1366"></a>
+<span class="sourceLineNo">1367</span> writerThreads[i].interrupt();<a name="line.1367"></a>
+<span class="sourceLineNo">1368</span> this.ramCache.clear();<a name="line.1368"></a>
+<span class="sourceLineNo">1369</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1369"></a>
+<span class="sourceLineNo">1370</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1370"></a>
+<span class="sourceLineNo">1371</span> this.backingMap.clear();<a name="line.1371"></a>
+<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
+<span class="sourceLineNo">1373</span> }<a name="line.1373"></a>
+<span class="sourceLineNo">1374</span><a name="line.1374"></a>
+<span class="sourceLineNo">1375</span> private void join() throws InterruptedException {<a name="line.1375"></a>
+<span class="sourceLineNo">1376</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1376"></a>
+<span class="sourceLineNo">1377</span> writerThreads[i].join();<a name="line.1377"></a>
+<span class="sourceLineNo">1378</span> }<a name="line.1378"></a>
+<span class="sourceLineNo">1379</span><a name="line.1379"></a>
+<span class="sourceLineNo">1380</span> @Override<a name="line.1380"></a>
+<span class="sourceLineNo">1381</span> public void shutdown() {<a name="line.1381"></a>
+<span class="sourceLineNo">1382</span> disableCache();<a name="line.1382"></a>
+<span class="sourceLineNo">1383</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1383"></a>
+<span class="sourceLineNo">1384</span> + persistencePath);<a name="line.1384"></a>
+<span class="sourceLineNo">1385</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1385"></a>
+<span class="sourceLineNo">1386</span> try {<a name="line.1386"></a>
+<span class="sourceLineNo">1387</span> join();<a name="line.1387"></a>
+<span class="sourceLineNo">1388</span> persistToFile();<a name="line.1388"></a>
+<span class="sourceLineNo">1389</span> } catch (IOException ex) {<a name="line.1389"></a>
+<span class="sourceLineNo">1390</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1390"></a>
+<span class="sourceLineNo">1391</span> } catch (InterruptedException e) {<a name="line.1391"></a>
+<span class="sourceLineNo">1392</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1392"></a>
+<span class="sourceLineNo">1393</span> }<a name="line.1393"></a>
+<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
+<span class="sourceLineNo">1395</span> }<a name="line.1395"></a>
+<span class="sourceLineNo">1396</span><a name="line.1396"></a>
+<span class="sourceLineNo">1397</span> @Override<a name="line.1397"></a>
+<span class="sourceLineNo">1398</span> public CacheStats getStats() {<a name="line.1398"></a>
+<span class="sourceLineNo">1399</span> return cacheStats;<a name="line.1399"></a>
+<span class="sourceLineNo">1400</span> }<a name="line.1400"></a>
+<span class="sourceLineNo">1401</span><a name="line.1401"></a>
+<span class="sourceLineNo">1402</span> public BucketAllocator getAllocator() {<a name="line.1402"></a>
+<span class="sourceLineNo">1403</span> return this.bucketAllocator;<a name="line.1403"></a>
+<span class="sourceLineNo">1404</span> }<a name="line.1404"></a>
+<span class="sourceLineNo">1405</span><a name="line.1405"></a>
+<span class="sourceLineNo">1406</span> @Override<a name="line.1406"></a>
+<span class="sourceLineNo">1407</span> public long heapSize() {<a name="line.1407"></a>
+<span class="sourceLineNo">1408</span> return this.heapSize.sum();<a name="line.1408"></a>
+<span class="sourceLineNo">1409</span> }<a name="line.1409"></a>
+<span class="sourceLineNo">1410</span><a name="line.1410"></a>
+<span class="sourceLineNo">1411</span> @Override<a name="line.1411"></a>
+<span class="sourceLineNo">1412</span> public long size() {<a name="line.1412"></a>
+<span class="sourceLineNo">1413</span> return this.realCacheSize.sum();<a name="line.1413"></a>
+<span class="sourceLineNo">1414</span> }<a name="line.1414"></a>
+<span class="sourceLineNo">1415</span><a name="line.1415"></a>
+<span class="sourceLineNo">1416</span> @Override<a name="line.1416"></a>
+<span class="sourceLineNo">1417</span> public long getCurrentDataSize() {<a name="line.1417"></a>
+<span class="sourceLineNo">1418</span> return size();<a name="line.1418"></a>
+<span class="sourceLineNo">1419</span> }<a name="line.1419"></a>
+<span class="sourceLineNo">1420</span><a name="line.1420"></a>
+<span class="sourceLineNo">1421</span> @Override<a name="line.1421"></a>
+<span class="sourceLineNo">1422</span> public long getFreeSize() {<a name="line.1422"></a>
+<span class="sourceLineNo">1423</span> return this.bucketAllocator.getFreeSize();<a name="line.1423"></a>
+<span class="sourceLineNo">1424</span> }<a name="line.1424"></a>
+<span class="sourceLineNo">1425</span><a name="line.1425"></a>
+<span class="sourceLineNo">1426</span> @Override<a name="line.1426"></a>
+<span class="sourceLineNo">1427</span> public long getBlockCount() {<a name="line.1427"></a>
+<span class="sourceLineNo">1428</span> return this.blockNumber.sum();<a name="line.1428"></a>
+<span class="sourceLineNo">1429</span> }<a name="line.1429"></a>
+<span class="sourceLineNo">1430</span><a name="line.1430"></a>
+<span class="sourceLineNo">1431</span> @Override<a name="line.1431"></a>
+<span class="sourceLineNo">1432</span> public long getDataBlockCount() {<a name="line.1432"></a>
+<span class="sourceLineNo">1433</span> return getBlockCount();<a name="line.1433"></a>
+<span class="sourceLineNo">1434</span> }<a name="line.1434"></a>
+<span class="sourceLineNo">1435</span><a name="line.1435"></a>
+<span class="sourceLineNo">1436</span> @Override<a name="line.1436"></a>
+<span class="sourceLineNo">1437</span> public long getCurrentSize() {<a name="line.1437"></a>
+<span class="sourceLineNo">1438</span> return this.bucketAllocator.getUsedSize();<a name="line.1438"></a>
+<span class="sourceLineNo">1439</span> }<a name="line.1439"></a>
+<span class="sourceLineNo">1440</span><a name="line.1440"></a>
+<span class="sourceLineNo">1441</span> protected String getAlgorithm() {<a name="line.1441"></a>
+<span class="sourceLineNo">1442</span> return algorithm;<a name="line.1442"></a>
+<span class="sourceLineNo">1443</span> }<a name="line.1443"></a>
+<span class="sourceLineNo">1444</span><a name="line.1444"></a>
+<span class="sourceLineNo">1445</span> /**<a name="line.1445"></a>
+<span class="sourceLineNo">1446</span> * Evicts all blocks for a specific HFile.<a name="line.1446"></a>
+<span class="sourceLineNo">1447</span> * <p><a name="line.1447"></a>
+<span class="sourceLineNo">1448</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1448"></a>
+<span class="sourceLineNo">1449</span> * @return the number of blocks evicted<a name="line.1449"></a>
+<span class="sourceLineNo">1450</span> */<a name="line.1450"></a>
+<span class="sourceLineNo">1451</span> @Override<a name="line.1451"></a>
+<span class="sourceLineNo">1452</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1452"></a>
+<span class="sourceLineNo">1453</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1453"></a>
+<span class="sourceLineNo">1454</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1454"></a>
+<span class="sourceLineNo">1455</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1455"></a>
+<span class="sourceLineNo">1456</span><a name="line.1456"></a>
+<span class="sourceLineNo">1457</span> int numEvicted = 0;<a name="line.1457"></a>
+<span class="sourceLineNo">1458</span> for (BlockCacheKey key : keySet) {<a name="line.1458"></a>
+<span class="sourceLineNo">1459</span> if (evictBlock(key)) {<a name="line.1459"></a>
+<span class="sourceLineNo">1460</span> ++numEvicted;<a name="line.1460"></a>
+<span class="sourceLineNo">1461</span> }<a name="line.1461"></a>
+<span class="sourceLineNo">1462</span> }<a name="line.1462"></a>
+<span class="sourceLineNo">1463</span><a name="line.1463"></a>
+<span class="sourceLineNo">1464</span> return numEvicted;<a name="line.1464"></a>
+<span class="sourceLineNo">1465</span> }<a name="line.1465"></a>
+<span class="sourceLineNo">1466</span><a name="line.1466"></a>
+<span class="sourceLineNo">1467</span> /**<a name="line.1467"></a>
+<span class="sourceLineNo">1468</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1468"></a>
+<span class="sourceLineNo">1469</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1469"></a>
+<span class="sourceLineNo">1470</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1470"></a>
+<span class="sourceLineNo">1471</span> */<a name="line.1471"></a>
+<span class="sourceLineNo">1472</span> private class BucketEntryGroup {<a name="line.1472"></a>
+<span class="sourceLineNo">1473</span><a name="line.1473"></a>
+<span class="sourceLineNo">1474</span> private CachedEntryQueue queue;<a name="line.1474"></a>
+<span class="sourceLineNo">1475</span> private long totalSize = 0;<a name="line.1475"></a>
+<span class="sourceLineNo">1476</span> private long bucketSize;<a name="line.1476"></a>
<span class="sourceLineNo">1477</span><a name="line.1477"></a>
-<span class="sourceLineNo">1478</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1478"></a>
-<span class="sourceLineNo">1479</span> totalSize += block.getValue().getLength();<a name="line.1479"></a>
-<span class="sourceLineNo">1480</span> queue.add(block);<a name="line.1480"></a>
-<span class="sourceLineNo">1481</span> }<a name="line.1481"></a>
-<span class="sourceLineNo">1482</span><a name="line.1482"></a>
-<span class="sourceLineNo">1483</span> public long free(long toFree) {<a name="line.1483"></a>
-<span class="sourceLineNo">1484</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1484"></a>
-<span class="sourceLineNo">1485</span> long freedBytes = 0;<a name="line.1485"></a>
-<span class="sourceLineNo">1486</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1486"></a>
-<span class="sourceLineNo">1487</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1487"></a>
-<span class="sourceLineNo">1488</span> while ((entry = queue.pollLast()) != null) {<a name="line.1488"></a>
-<span class="sourceLineNo">1489</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1489"></a>
-<span class="sourceLineNo">1490</span> BucketEntry be = entry.getValue();<a name="line.1490"></a>
-<span class="sourceLineNo">1491</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1491"></a>
-<span class="sourceLineNo">1492</span> freedBytes += be.getLength();<a name="line.1492"></a>
-<span class="sourceLineNo">1493</span> }<a name="line.1493"></a>
-<span class="sourceLineNo">1494</span> if (freedBytes >= toFree) {<a name="line.1494"></a>
-<span class="sourceLineNo">1495</span> return freedBytes;<a name="line.1495"></a>
-<span class="sourceLineNo">1496</span> }<a name="line.1496"></a>
-<span class="sourceLineNo">1497</span> }<a name="line.1497"></a>
-<span class="sourceLineNo">1498</span> return freedBytes;<a name="line.1498"></a>
-<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
-<span class="sourceLineNo">1500</span><a name="line.1500"></a>
-<span class="sourceLineNo">1501</span> public long overflow() {<a name="line.1501"></a>
-<span class="sourceLineNo">1502</span> return totalSize - bucketSize;<a name="line.1502"></a>
-<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
-<span class="sourceLineNo">1504</span><a name="line.1504"></a>
-<span class="sourceLineNo">1505</span> public long totalSize() {<a name="line.1505"></a>
-<span class="sourceLineNo">1506</span> return totalSize;<a name="line.1506"></a>
-<span class="sourceLineNo">1507</span> }<a name="line.1507"></a>
-<span class="sourceLineNo">1508</span> }<a name="line.1508"></a>
-<span class="sourceLineNo">1509</span><a name="line.1509"></a>
-<span class="sourceLineNo">1510</span> /**<a name="line.1510"></a>
-<span class="sourceLineNo">1511</span> * Block Entry stored in the memory with key,data and so on<a name="line.1511"></a>
-<span class="sourceLineNo">1512</span> */<a name="line.1512"></a>
-<span class="sourceLineNo">1513</span> static class RAMQueueEntry {<a name="line.1513"></a>
-<span class="sourceLineNo">1514</span> private final BlockCacheKey key;<a name="line.1514"></a>
-<span class="sourceLineNo">1515</span> private final Cacheable data;<a name="line.1515"></a>
-<span class="sourceLineNo">1516</span> private long accessCounter;<a name="line.1516"></a>
-<span class="sourceLineNo">1517</span> private boolean inMemory;<a name="line.1517"></a>
-<span class="sourceLineNo">1518</span><a name="line.1518"></a>
-<span class="sourceLineNo">1519</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1519"></a>
-<span class="sourceLineNo">1520</span> this.key = bck;<a name="line.1520"></a>
-<span class="sourceLineNo">1521</span> this.data = data;<a name="line.1521"></a>
-<span class="sourceLineNo">1522</span> this.accessCounter = accessCounter;<a name="line.1522"></a>
-<span class="sourceLineNo">1523</span> this.inMemory = inMemory;<a name="line.1523"></a>
-<span class="sourceLineNo">1524</span> }<a name="line.1524"></a>
-<span class="sourceLineNo">1525</span><a name="line.1525"></a>
-<span class="sourceLineNo">1526</span> public Cacheable getData() {<a name="line.1526"></a>
-<span class="sourceLineNo">1527</span> return data;<a name="line.1527"></a>
-<span class="sourceLineNo">1528</span> }<a name="line.1528"></a>
-<span class="sourceLineNo">1529</span><a name="line.1529"></a>
-<span class="sourceLineNo">1530</span> public BlockCacheKey getKey() {<a name="line.1530"></a>
-<span class="sourceLineNo">1531</span> return key;<a name="line.1531"></a>
-<span class="sourceLineNo">1532</span> }<a name="line.1532"></a>
-<span class="sourceLineNo">1533</span><a name="line.1533"></a>
-<span class="sourceLineNo">1534</span> public void access(long accessCounter) {<a name="line.1534"></a>
-<span class="sourceLineNo">1535</span> this.accessCounter = accessCounter;<a name="line.1535"></a>
-<span class="sourceLineNo">1536</span> }<a name="line.1536"></a>
-<span class="sourceLineNo">1537</span><a name="line.1537"></a>
-<span class="sourceLineNo">1538</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1538"></a>
-<span class="sourceLineNo">1539</span> if (data instanceof HFileBlock) {<a name="line.1539"></a>
-<span class="sourceLineNo">1540</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1540"></a>
-<span class="sourceLineNo">1541</span> }<a name="line.1541"></a>
-<span class="sourceLineNo">1542</span> return ByteBuffAllocator.HEAP;<a name="line.1542"></a>
-<span class="sourceLineNo">1543</span> }<a name="line.1543"></a>
-<span class="sourceLineNo">1544</span><a name="line.1544"></a>
-<span class="sourceLineNo">1545</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1545"></a>
-<span class="sourceLineNo">1546</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1546"></a>
-<span class="sourceLineNo">1547</span> ByteBuffer metaBuff) throws IOException {<a name="line.1547"></a>
-<span class="sourceLineNo">1548</span> int len = data.getSerializedLength();<a name="line.1548"></a>
-<span class="sourceLineNo">1549</span> // This cacheable thing can't be serialized<a name="line.1549"></a>
-<span class="sourceLineNo">1550</span> if (len == 0) {<a name="line.1550"></a>
-<span class="sourceLineNo">1551</span> return null;<a name="line.1551"></a>
-<span class="sourceLineNo">1552</span> }<a name="line.1552"></a>
-<span class="sourceLineNo">1553</span> long offset = alloc.allocateBlock(len);<a name="line.1553"></a>
-<span class="sourceLineNo">1554</span> boolean succ = false;<a name="line.1554"></a>
-<span class="sourceLineNo">1555</span> BucketEntry bucketEntry = null;<a name="line.1555"></a>
-<span class="sourceLineNo">1556</span> try {<a name="line.1556"></a>
-<span class="sourceLineNo">1557</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1557"></a>
-<span class="sourceLineNo">1558</span> getByteBuffAllocator());<a name="line.1558"></a>
-<span class="sourceLineNo">1559</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1559"></a>
-<span class="sourceLineNo">1560</span> if (data instanceof HFileBlock) {<a name="line.1560"></a>
-<span class="sourceLineNo">1561</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1561"></a>
-<span class="sourceLineNo">1562</span> HFileBlock block = (HFileBlock) data;<a name="line.1562"></a>
-<span class="sourceLineNo">1563</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1563"></a>
-<span class="sourceLineNo">1564</span> block.getMetaData(metaBuff);<a name="line.1564"></a>
-<span class="sourceLineNo">1565</span> ioEngine.write(sliceBuf, offset);<a name="line.1565"></a>
-<span class="sourceLineNo">1566</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1566"></a>
-<span class="sourceLineNo">1567</span> } else {<a name="line.1567"></a>
-<span class="sourceLineNo">1568</span> // Only used for testing.<a name="line.1568"></a>
-<span class="sourceLineNo">1569</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1569"></a>
-<span class="sourceLineNo">1570</span> data.serialize(bb, true);<a name="line.1570"></a>
-<span class="sourceLineNo">1571</span> ioEngine.write(bb, offset);<a name="line.1571"></a>
-<span class="sourceLineNo">1572</span> }<a name="line.1572"></a>
-<span class="sourceLineNo">1573</span> succ = true;<a name="line.1573"></a>
-<span class="sourceLineNo">1574</span> } finally {<a name="line.1574"></a>
-<span class="sourceLineNo">1575</span> if (!succ) {<a name="line.1575"></a>
-<span class="sourceLineNo">1576</span> alloc.freeBlock(offset, len);<a name="line.1576"></a>
-<span class="sourceLineNo">1577</span> }<a name="line.1577"></a>
-<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
-<span class="sourceLineNo">1579</span> realCacheSize.add(len);<a name="line.1579"></a>
-<span class="sourceLineNo">1580</span> return bucketEntry;<a name="line.1580"></a>
-<span class="sourceLineNo">1581</span> }<a name="line.1581"></a>
-<span class="sourceLineNo">1582</span> }<a name="line.1582"></a>
-<span class="sourceLineNo">1583</span><a name="line.1583"></a>
-<span class="sourceLineNo">1584</span> /**<a name="line.1584"></a>
-<span class="sourceLineNo">1585</span> * Only used in test<a name="line.1585"></a>
-<span class="sourceLineNo">1586</span> */<a name="line.1586"></a>
-<span class="sourceLineNo">1587</span> void stopWriterThreads() throws InterruptedException {<a name="line.1587"></a>
-<span class="sourceLineNo">1588</span> for (WriterThread writerThread : writerThreads) {<a name="line.1588"></a>
-<span class="sourceLineNo">1589</span> writerThread.disableWriter();<a name="line.1589"></a>
-<span class="sourceLineNo">1590</span> writerThread.interrupt();<a name="line.1590"></a>
-<span class="sourceLineNo">1591</span> writerThread.join();<a name="line.1591"></a>
-<span class="sourceLineNo">1592</span> }<a name="line.1592"></a>
-<span class="sourceLineNo">1593</span> }<a name="line.1593"></a>
-<span class="sourceLineNo">1594</span><a name="line.1594"></a>
-<span class="sourceLineNo">1595</span> @Override<a name="line.1595"></a>
-<span class="sourceLineNo">1596</span> public Iterator<CachedBlock> iterator() {<a name="line.1596"></a>
-<span class="sourceLineNo">1597</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1597"></a>
-<span class="sourceLineNo">1598</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1598"></a>
-<span class="sourceLineNo">1599</span> return new Iterator<CachedBlock>() {<a name="line.1599"></a>
-<span class="sourceLineNo">1600</span> private final long now = System.nanoTime();<a name="line.1600"></a>
-<span class="sourceLineNo">1601</span><a name="line.1601"></a>
-<span class="sourceLineNo">1602</span> @Override<a name="line.1602"></a>
-<span class="sourceLineNo">1603</span> public boolean hasNext() {<a name="line.1603"></a>
-<span class="sourceLineNo">1604</span> return i.hasNext();<a name="line.1604"></a>
-<span class="sourceLineNo">1605</span> }<a name="line.1605"></a>
-<span class="sourceLineNo">1606</span><a name="line.1606"></a>
-<span class="sourceLineNo">1607</span> @Override<a name="line.1607"></a>
-<span class="sourceLineNo">1608</span> public CachedBlock next() {<a name="line.1608"></a>
-<span class="sourceLineNo">1609</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1609"></a>
-<span class="sourceLineNo">1610</span> return new CachedBlock() {<a name="line.1610"></a>
-<span class="sourceLineNo">1611</span> @Override<a name="line.1611"></a>
-<span class="sourceLineNo">1612</span> public String toString() {<a name="line.1612"></a>
-<span class="sourceLineNo">1613</span> return BlockCacheUtil.toString(this, now);<a name="line.1613"></a>
-<span class="sourceLineNo">1614</span> }<a name="line.1614"></a>
-<span class="sourceLineNo">1615</span><a name="line.1615"></a>
-<span class="sourceLineNo">1616</span> @Override<a name="line.1616"></a>
-<span class="sourceLineNo">1617</span> public BlockPriority getBlockPriority() {<a name="line.1617"></a>
-<span class="sourceLineNo">1618</span> return e.getValue().getPriority();<a name="line.1618"></a>
-<span class="sourceLineNo">1619</span> }<a name="line.1619"></a>
-<span class="sourceLineNo">1620</span><a name="line.1620"></a>
-<span class="sourceLineNo">1621</span> @Override<a name="line.1621"></a>
-<span class="sourceLineNo">1622</span> public BlockType getBlockType() {<a name="line.1622"></a>
-<span class="sourceLineNo">1623</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1623"></a>
-<span class="sourceLineNo">1624</span> return null;<a name="line.1624"></a>
+<span class="sourceLineNo">1478</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1478"></a>
+<span class="sourceLineNo">1479</span> this.bucketSize = bucketSize;<a name="line.1479"></a>
+<span class="sourceLineNo">1480</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1480"></a>
+<span class="sourceLineNo">1481</span> totalSize = 0;<a name="line.1481"></a>
+<span class="sourceLineNo">1482</span> }<a name="line.1482"></a>
+<span class="sourceLineNo">1483</span><a name="line.1483"></a>
+<span class="sourceLineNo">1484</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1484"></a>
+<span class="sourceLineNo">1485</span> totalSize += block.getValue().getLength();<a name="line.1485"></a>
+<span class="sourceLineNo">1486</span> queue.add(block);<a name="line.1486"></a>
+<span class="sourceLineNo">1487</span> }<a name="line.1487"></a>
+<span class="sourceLineNo">1488</span><a name="line.1488"></a>
+<span class="sourceLineNo">1489</span> public long free(long toFree) {<a name="line.1489"></a>
+<span class="sourceLineNo">1490</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1490"></a>
+<span class="sourceLineNo">1491</span> long freedBytes = 0;<a name="line.1491"></a>
+<span class="sourceLineNo">1492</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1492"></a>
+<span class="sourceLineNo">1493</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1493"></a>
+<span class="sourceLineNo">1494</span> while ((entry = queue.pollLast()) != null) {<a name="line.1494"></a>
+<span class="sourceLineNo">1495</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1495"></a>
+<span class="sourceLineNo">1496</span> BucketEntry be = entry.getValue();<a name="line.1496"></a>
+<span class="sourceLineNo">1497</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1497"></a>
+<span class="sourceLineNo">1498</span> freedBytes += be.getLength();<a name="line.1498"></a>
+<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
+<span class="sourceLineNo">1500</span> if (freedBytes >= toFree) {<a name="line.1500"></a>
+<span class="sourceLineNo">1501</span> return freedBytes;<a name="line.1501"></a>
+<span class="sourceLineNo">1502</span> }<a name="line.1502"></a>
+<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
+<span class="sourceLineNo">1504</span> return freedBytes;<a name="line.1504"></a>
+<span class="sourceLineNo">1505</span> }<a name="line.1505"></a>
+<span class="sourceLineNo">1506</span><a name="line.1506"></a>
+<span class="sourceLineNo">1507</span> public long overflow() {<a name="line.1507"></a>
+<span class="sourceLineNo">1508</span> return totalSize - bucketSize;<a name="line.1508"></a>
+<span class="sourceLineNo">1509</span> }<a name="line.1509"></a>
+<span class="sourceLineNo">1510</span><a name="line.1510"></a>
+<span class="sourceLineNo">1511</span> public long totalSize() {<a name="line.1511"></a>
+<span class="sourceLineNo">1512</span> return totalSize;<a name="line.1512"></a>
+<span class="sourceLineNo">1513</span> }<a name="line.1513"></a>
+<span class="sourceLineNo">1514</span> }<a name="line.1514"></a>
+<span class="sourceLineNo">1515</span><a name="line.1515"></a>
+<span class="sourceLineNo">1516</span> /**<a name="line.1516"></a>
+<span class="sourceLineNo">1517</span> * Block Entry stored in the memory with key,data and so on<a name="line.1517"></a>
+<span class="sourceLineNo">1518</span> */<a name="line.1518"></a>
+<span class="sourceLineNo">1519</span> static class RAMQueueEntry {<a name="line.1519"></a>
+<span class="sourceLineNo">1520</span> private final BlockCacheKey key;<a name="line.1520"></a>
+<span class="sourceLineNo">1521</span> private final Cacheable data;<a name="line.1521"></a>
+<span class="sourceLineNo">1522</span> private long accessCounter;<a name="line.1522"></a>
+<span class="sourceLineNo">1523</span> private boolean inMemory;<a name="line.1523"></a>
+<span class="sourceLineNo">1524</span><a name="line.1524"></a>
+<span class="sourceLineNo">1525</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1525"></a>
+<span class="sourceLineNo">1526</span> this.key = bck;<a name="line.1526"></a>
+<span class="sourceLineNo">1527</span> this.data = data;<a name="line.1527"></a>
+<span class="sourceLineNo">1528</span> this.accessCounter = accessCounter;<a name="line.1528"></a>
+<span class="sourceLineNo">1529</span> this.inMemory = inMemory;<a name="line.1529"></a>
+<span class="sourceLineNo">1530</span> }<a name="line.1530"></a>
+<span class="sourceLineNo">1531</span><a name="line.1531"></a>
+<span class="sourceLineNo">1532</span> public Cacheable getData() {<a name="line.1532"></a>
+<span class="sourceLineNo">1533</span> return data;<a name="line.1533"></a>
+<span class="sourceLineNo">1534</span> }<a name="line.1534"></a>
+<span class="sourceLineNo">1535</span><a name="line.1535"></a>
+<span class="sourceLineNo">1536</span> public BlockCacheKey getKey() {<a name="line.1536"></a>
+<span class="sourceLineNo">1537</span> return key;<a name="line.1537"></a>
+<span class="sourceLineNo">1538</span> }<a name="line.1538"></a>
+<span class="sourceLineNo">1539</span><a name="line.1539"></a>
+<span class="sourceLineNo">1540</span> public void access(long accessCounter) {<a name="line.1540"></a>
+<span class="sourceLineNo">1541</span> this.accessCounter = accessCounter;<a name="line.1541"></a>
+<span class="sourceLineNo">1542</span> }<a name="line.1542"></a>
+<span class="sourceLineNo">1543</span><a name="line.1543"></a>
+<span class="sourceLineNo">1544</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1544"></a>
+<span class="sourceLineNo">1545</span> if (data instanceof HFileBlock) {<a name="line.1545"></a>
+<span class="sourceLineNo">1546</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1546"></a>
+<span class="sourceLineNo">1547</span> }<a name="line.1547"></a>
+<span class="sourceLineNo">1548</span> return ByteBuffAllocator.HEAP;<a name="line.1548"></a>
+<span class="sourceLineNo">1549</span> }<a name="line.1549"></a>
+<span class="sourceLineNo">1550</span><a name="line.1550"></a>
+<span class="sourceLineNo">1551</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1551"></a>
+<span class="sourceLineNo">1552</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1552"></a>
+<span class="sourceLineNo">1553</span> ByteBuffer metaBuff) throws IOException {<a name="line.1553"></a>
+<span class="sourceLineNo">1554</span> int len = data.getSerializedLength();<a name="line.1554"></a>
+<span class="sourceLineNo">1555</span> // This cacheable thing can't be serialized<a name="line.1555"></a>
+<span class="sourceLineNo">1556</span> if (len == 0) {<a name="line.1556"></a>
+<span class="sourceLineNo">1557</span> return null;<a name="line.1557"></a>
+<span class="sourceLineNo">1558</span> }<a name="line.1558"></a>
+<span class="sourceLineNo">1559</span> long offset = alloc.allocateBlock(len);<a name="line.1559"></a>
+<span class="sourceLineNo">1560</span> boolean succ = false;<a name="line.1560"></a>
+<span class="sourceLineNo">1561</span> BucketEntry bucketEntry = null;<a name="line.1561"></a>
+<span class="sourceLineNo">1562</span> try {<a name="line.1562"></a>
+<span class="sourceLineNo">1563</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1563"></a>
+<span class="sourceLineNo">1564</span> getByteBuffAllocator());<a name="line.1564"></a>
+<span class="sourceLineNo">1565</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1565"></a>
+<span class="sourceLineNo">1566</span> if (data instanceof HFileBlock) {<a name="line.1566"></a>
+<span class="sourceLineNo">1567</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1567"></a>
+<span class="sourceLineNo">1568</span> HFileBlock block = (HFileBlock) data;<a name="line.1568"></a>
+<span class="sourceLineNo">1569</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1569"></a>
+<span class="sourceLineNo">1570</span> block.getMetaData(metaBuff);<a name="line.1570"></a>
+<span class="sourceLineNo">1571</span> ioEngine.write(sliceBuf, offset);<a name="line.1571"></a>
+<span class="sourceLineNo">1572</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1572"></a>
+<span class="sourceLineNo">1573</span> } else {<a name="line.1573"></a>
+<span class="sourceLineNo">1574</span> // Only used for testing.<a name="line.1574"></a>
+<span class="sourceLineNo">1575</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1575"></a>
+<span class="sourceLineNo">1576</span> data.serialize(bb, true);<a name="line.1576"></a>
+<span class="sourceLineNo">1577</span> ioEngine.write(bb, offset);<a name="line.1577"></a>
+<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
+<span class="sourceLineNo">1579</span> succ = true;<a name="line.1579"></a>
+<span class="sourceLineNo">1580</span> } finally {<a name="line.1580"></a>
+<span class="sourceLineNo">1581</span> if (!succ) {<a name="line.1581"></a>
+<span class="sourceLineNo">1582</span> alloc.freeBlock(offset, len);<a name="line.1582"></a>
+<span class="sourceLineNo">1583</span> }<a name="line.1583"></a>
+<span class="sourceLineNo">1584</span> }<a name="line.1584"></a>
+<span class="sourceLineNo">1585</span> realCacheSize.add(len);<a name="line.1585"></a>
+<span class="sourceLineNo">1586</span> return bucketEntry;<a name="line.1586"></a>
+<span class="sourceLineNo">1587</span> }<a name="line.1587"></a>
+<span class="sourceLineNo">1588</span> }<a name="line.1588"></a>
+<span class="sourceLineNo">1589</span><a name="line.1589"></a>
+<span class="sourceLineNo">1590</span> /**<a name="line.1590"></a>
+<span class="sourceLineNo">1591</span> * Only used in test<a name="line.1591"></a>
+<span class="sourceLineNo">1592</span> */<a name="line.1592"></a>
+<span class="sourceLineNo">1593</span> void stopWriterThreads() throws InterruptedException {<a name="line.1593"></a>
+<span class="sourceLineNo">1594</span> for (WriterThread writerThread : writerThreads) {<a name="line.1594"></a>
+<span class="sourceLineNo">1595</span> writerThread.disableWriter();<a name="line.1595"></a>
+<span class="sourceLineNo">1596</span> writerThread.interrupt();<a name="line.1596"></a>
+<span class="sourceLineNo">1597</span> writerThread.join();<a name="line.1597"></a>
+<span class="sourceLineNo">1598</span> }<a name="line.1598"></a>
+<span class="sourceLineNo">1599</span> }<a name="line.1599"></a>
+<span class="sourceLineNo">1600</span><a name="line.1600"></a>
+<span class="sourceLineNo">1601</span> @Override<a name="line.1601"></a>
+<span class="sourceLineNo">1602</span> public Iterator<CachedBlock> iterator() {<a name="line.1602"></a>
+<span class="sourceLineNo">1603</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1603"></a>
+<span class="sourceLineNo">1604</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1604"></a>
+<span class="sourceLineNo">1605</span> return new Iterator<CachedBlock>() {<a name="line.1605"></a>
+<span class="sourceLineNo">1606</span> private final long now = System.nanoTime();<a name="line.1606"></a>
+<span class="sourceLineNo">1607</span><a name="line.1607"></a>
+<span class="sourceLineNo">1608</span> @Override<a name="line.1608"></a>
+<span class="sourceLineNo">1609</span> public boolean hasNext() {<a name="line.1609"></a>
+<span class="sourceLineNo">1610</span> return i.hasNext();<a name="line.1610"></a>
+<span class="sourceLineNo">1611</span> }<a name="line.1611"></a>
+<span class="sourceLineNo">1612</span><a name="line.1612"></a>
+<span class="sourceLineNo">1613</span> @Override<a name="line.1613"></a>
+<span class="sourceLineNo">1614</span> public CachedBlock next() {<a name="line.1614"></a>
+<span class="sourceLineNo">1615</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1615"></a>
+<span class="sourceLineNo">1616</span> return new CachedBlock() {<a name="line.1616"></a>
+<span class="sourceLineNo">1617</span> @Override<a name="line.1617"></a>
+<span class="sourceLineNo">1618</span> public String toString() {<a name="line.1618"></a>
+<span class="sourceLineNo">1619</span> return BlockCacheUtil.toString(this, now);<a name="line.1619"></a>
+<span class="sourceLineNo">1620</span> }<a name="line.1620"></a>
+<span class="sourceLineNo">1621</span><a name="line.1621"></a>
+<span class="sourceLineNo">1622</span> @Override<a name="line.1622"></a>
+<span class="sourceLineNo">1623</span> public BlockPriority getBlockPriority() {<a name="line.1623"></a>
+<span class="sourceLineNo">1624</span> return e.getValue().getPriority();<a name="line.1624"></a>
<span class="sourceLineNo">1625</span> }<a name="line.1625"></a>
<span class="sourceLineNo">1626</span><a name="line.1626"></a>
<span class="sourceLineNo">1627</span> @Override<a name="line.1627"></a>
-<span class="sourceLineNo">1628</span> public long getOffset() {<a name="line.1628"></a>
-<span class="sourceLineNo">1629</span> return e.getKey().getOffset();<a name="line.1629"></a>
-<span class="sourceLineNo">1630</span> }<a name="line.1630"></a>
-<span class="sourceLineNo">1631</span><a name="line.1631"></a>
-<span class="sourceLineNo">1632</span> @Override<a name="line.1632"></a>
-<span class="sourceLineNo">1633</span> public long getSize() {<a name="line.1633"></a>
-<span class="sourceLineNo">1634</span> return e.getValue().getLength();<a name="line.1634"></a>
-<span class="sourceLineNo">1635</span> }<a name="line.1635"></a>
-<span class="sourceLineNo">1636</span><a name="line.1636"></a>
-<span class="sourceLineNo">1637</span> @Override<a name="line.1637"></a>
-<span class="sourceLineNo">1638</span> public long getCachedTime() {<a name="line.1638"></a>
-<span class="sourceLineNo">1639</span> return e.getValue().getCachedTime();<a name="line.1639"></a>
-<span class="sourceLineNo">1640</span> }<a name="line.1640"></a>
-<span class="sourceLineNo">1641</span><a name="line.1641"></a>
-<span class="sourceLineNo">1642</span> @Override<a name="line.1642"></a>
-<span class="sourceLineNo">1643</span> public String getFilename() {<a name="line.1643"></a>
-<span class="sourceLineNo">1644</span> return e.getKey().getHfileName();<a name="line.1644"></a>
-<span class="sourceLineNo">1645</span> }<a name="line.1645"></a>
-<span class="sourceLineNo">1646</span><a name="line.1646"></a>
-<span class="sourceLineNo">1647</span> @Override<a name="line.1647"></a>
-<span class="sourceLineNo">1648</span> public int compareTo(CachedBlock other) {<a name="line.1648"></a>
-<span class="sourceLineNo">1649</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1649"></a>
-<span class="sourceLineNo">1650</span> if (diff != 0) return diff;<a name="line.1650"></a>
-<span class="sourceLineNo">1651</span><a name="line.1651"></a>
-<span class="sourceLineNo">1652</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1652"></a>
-<span class="sourceLineNo">1653</span> if (diff != 0) return diff;<a name="line.1653"></a>
-<span class="sourceLineNo">1654</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1654"></a>
-<span class="sourceLineNo">1655</span> throw new IllegalStateException(<a name="line.1655"></a>
-<span class="sourceLineNo">1656</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1656"></a>
-<span class="sourceLineNo">1657</span> }<a name="line.1657"></a>
-<span class="sourceLineNo">1658</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1658"></a>
-<span class="sourceLineNo">1659</span> }<a name="line.1659"></a>
-<span class="sourceLineNo">1660</span><a name="line.1660"></a>
-<span class="sourceLineNo">1661</span> @Override<a name="line.1661"></a>
-<span class="sourceLineNo">1662</span> public int hashCode() {<a name="line.1662"></a>
-<span class="sourceLineNo">1663</span> return e.getKey().hashCode();<a name="line.1663"></a>
-<span class="sourceLineNo">1664</span> }<a name="line.1664"></a>
-<span class="sourceLineNo">1665</span><a name="line.1665"></a>
-<span class="sourceLineNo">1666</span> @Override<a name="line.1666"></a>
-<span class="sourceLineNo">1667</span> public boolean equals(Object obj) {<a name="line.1667"></a>
-<span class="sourceLineNo">1668</span> if (obj instanceof CachedBlock) {<a name="line.1668"></a>
-<span class="sourceLineNo">1669</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1669"></a>
-<span class="sourceLineNo">1670</span> return compareTo(cb) == 0;<a name="line.1670"></a>
-<span class="sourceLineNo">1671</span> } else {<a name="line.1671"></a>
-<span class="sourceLineNo">1672</span> return false;<a name="line.1672"></a>
-<span class="sourceLineNo">1673</span> }<a name="line.1673"></a>
-<span class="sourceLineNo">1674</span> }<a name="line.1674"></a>
-<span class="sourceLineNo">1675</span> };<a name="line.1675"></a>
-<span class="sourceLineNo">1676</span> }<a name="line.1676"></a>
-<span class="sourceLineNo">1677</span><a name="line.1677"></a>
-<span class="sourceLineNo">1678</span> @Override<a name="line.1678"></a>
-<span class="sourceLineNo">1679</span> public void remove() {<a name="line.1679"></a>
-<span class="sourceLineNo">1680</span> throw new UnsupportedOperationException();<a name="line.1680"></a>
-<span class="sourceLineNo">1681</span> }<a name="line.1681"></a>
-<span class="sourceLineNo">1682</span> };<a name="line.1682"></a>
-<span class="sourceLineNo">1683</span> }<a name="line.1683"></a>
-<span class="sourceLineNo">1684</span><a name="line.1684"></a>
-<span class="sourceLineNo">1685</span> @Override<a name="line.1685"></a>
-<span class="sourceLineNo">1686</span> public BlockCache[] getBlockCaches() {<a name="line.1686"></a>
-<span class="sourceLineNo">1687</span> return null;<a name="line.1687"></a>
-<span class="sourceLineNo">1688</span> }<a name="line.1688"></a>
-<span class="sourceLineNo">1689</span><a name="line.1689"></a>
-<span class="sourceLineNo">1690</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1690"></a>
-<span class="sourceLineNo">1691</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1691"></a>
-<span class="sourceLineNo">1692</span> if (bucketEntry != null) {<a name="line.1692"></a>
-<span class="sourceLineNo">1693</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1693"></a>
-<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
-<span class="sourceLineNo">1695</span> return 0;<a name="line.1695"></a>
-<span class="sourceLineNo">1696</span> }<a name="line.1696"></a>
-<span class="sourceLineNo">1697</span><a name="line.1697"></a>
-<span class="sourceLineNo">1698</span> float getAcceptableFactor() {<a name="line.1698"></a>
-<span class="sourceLineNo">1699</span> return acceptableFactor;<a name="line.1699"></a>
-<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
-<span class="sourceLineNo">1701</span><a name="line.1701"></a>
-<span class="sourceLineNo">1702</span> float getMinFactor() {<a name="line.1702"></a>
-<span class="sourceLineNo">1703</span> return minFactor;<a name="line.1703"></a>
-<span class="sourceLineNo">1704</span> }<a name="line.1704"></a>
-<span class="sourceLineNo">1705</span><a name="line.1705"></a>
-<span class="sourceLineNo">1706</span> float getExtraFreeFactor() {<a name="line.1706"></a>
-<span class="sourceLineNo">1707</span> return extraFreeFactor;<a name="line.1707"></a>
-<span class="sourceLineNo">1708</span> }<a name="line.1708"></a>
-<span class="sourceLineNo">1709</span><a name="line.1709"></a>
-<span class="sourceLineNo">1710</span> float getSingleFactor() {<a name="line.1710"></a>
-<span class="sourceLineNo">1711</span> return singleFactor;<a name="line.1711"></a>
-<span class="sourceLineNo">1712</span> }<a name="line.1712"></a>
-<span class="sourceLineNo">1713</span><a name="line.1713"></a>
-<span class="sourceLineNo">1714</span> float getMultiFactor() {<a name="line.1714"></a>
-<span class="sourceLineNo">1715</span> return multiFactor;<a name="line.1715"></a>
-<span class="sourceLineNo">1716</span> }<a name="line.1716"></a>
-<span class="sourceLineNo">1717</span><a name="line.1717"></a>
-<span class="sourceLineNo">1718</span> float getMemoryFactor() {<a name="line.1718"></a>
-<span class="sourceLineNo">1719</span> return memoryFactor;<a name="line.1719"></a>
-<span class="sourceLineNo">1720</span> }<a name="line.1720"></a>
-<span class="sourceLineNo">1721</span><a name="line.1721"></a>
-<span class="sourceLineNo">1722</span> /**<a name="line.1722"></a>
-<span class="sourceLineNo">1723</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1723"></a>
-<span class="sourceLineNo">1724</span> */<a name="line.1724"></a>
-<span class="sourceLineNo">1725</span> static class RAMCache {<a name="line.1725"></a>
-<span class="sourceLineNo">1726</span> /**<a name="line.1726"></a>
-<span class="sourceLineNo">1727</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1727"></a>
-<span class="sourceLineNo">1728</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1728"></a>
-<span class="sourceLineNo">1729</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1729"></a>
-<span class="sourceLineNo">1730</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1730"></a>
-<span class="sourceLineNo">1731</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1731"></a>
-<span class="sourceLineNo">1732</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1732"></a>
-<span class="sourceLineNo">1733</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1733"></a>
-<span class="sourceLineNo">1734</span> */<a name="line.1734"></a>
-<span class="sourceLineNo">1735</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1735"></a>
-<span class="sourceLineNo">1736</span><a name="line.1736"></a>
-<span class="sourceLineNo">1737</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1737"></a>
-<span class="sourceLineNo">1738</span> return delegate.containsKey(key);<a name="line.1738"></a>
-<span class="sourceLineNo">1739</span> }<a name="line.1739"></a>
-<span class="sourceLineNo">1740</span><a name="line.1740"></a>
-<span class="sourceLineNo">1741</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1741"></a>
-<span class="sourceLineNo">1742</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1742"></a>
-<span class="sourceLineNo">1743</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1743"></a>
-<span class="sourceLineNo">1744</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1744"></a>
-<span class="sourceLineNo">1745</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1745"></a>
-<span class="sourceLineNo">1746</span> re.getData().retain();<a name="line.1746"></a>
-<span class="sourceLineNo">1747</span> return re;<a name="line.1747"></a>
-<span class="sourceLineNo">1748</span> });<a name="line.1748"></a>
-<span class="sourceLineNo">1749</span> }<a name="line.1749"></a>
-<span class="sourceLineNo">1750</span><a name="line.1750"></a>
-<span class="sourceLineNo">1751</span> /**<a name="line.1751"></a>
-<span class="sourceLineNo">1752</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1752"></a>
-<span class="sourceLineNo">1753</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1753"></a>
-<span class="sourceLineNo">1754</span> */<a name="line.1754"></a>
-<span class="sourceLineNo">1755</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1755"></a>
-<span class="sourceLineNo">1756</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1756"></a>
-<span class="sourceLineNo">1757</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1757"></a>
-<span class="sourceLineNo">1758</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1758"></a>
-<span class="sourceLineNo">1759</span> entry.getData().retain();<a name="line.1759"></a>
-<span class="sourceLineNo">1760</span> absent.set(true);<a name="line.1760"></a>
-<span class="sourceLineNo">1761</span> return entry;<a name="line.1761"></a>
-<span class="sourceLineNo">1762</span> });<a name="line.1762"></a>
-<span class="sourceLineNo">1763</span> return absent.get() ? null : re;<a name="line.1763"></a>
-<span class="sourceLineNo">1764</span> }<a name="line.1764"></a>
-<span class="sourceLineNo">1765</span><a name="line.1765"></a>
-<span class="sourceLineNo">1766</span> public boolean remove(BlockCacheKey key) {<a name="line.1766"></a>
-<span class="sourceLineNo">1767</span> return remove(key, re -> {<a name="line.1767"></a>
+<span class="sourceLineNo">1628</span> public BlockType getBlockType() {<a name="line.1628"></a>
+<span class="sourceLineNo">1629</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1629"></a>
+<span class="sourceLineNo">1630</span> return null;<a name="line.1630"></a>
+<span class="sourceLineNo">1631</span> }<a name="line.1631"></a>
+<span class="sourceLineNo">1632</span><a name="line.1632"></a>
+<span class="sourceLineNo">1633</span> @Override<a name="line.1633"></a>
+<span class="sourceLineNo">1634</span> public long getOffset() {<a name="line.1634"></a>
+<span class="sourceLineNo">1635</span> return e.getKey().getOffset();<a name="line.1635"></a>
+<span class="sourceLineNo">1636</span> }<a name="line.1636"></a>
+<span class="sourceLineNo">1637</span><a name="line.1637"></a>
+<span class="sourceLineNo">1638</span> @Override<a name="line.1638"></a>
+<span class="sourceLineNo">1639</span> public long getSize() {<a name="line.1639"></a>
+<span class="sourceLineNo">1640</span> return e.getValue().getLength();<a name="line.1640"></a>
+<span class="sourceLineNo">1641</span> }<a name="line.1641"></a>
+<span class="sourceLineNo">1642</span><a name="line.1642"></a>
+<span class="sourceLineNo">1643</span> @Override<a name="line.1643"></a>
+<span class="sourceLineNo">1644</span> public long getCachedTime() {<a name="line.1644"></a>
+<span class="sourceLineNo">1645</span> return e.getValue().getCachedTime();<a name="line.1645"></a>
+<span class="sourceLineNo">1646</span> }<a name="line.1646"></a>
+<span class="sourceLineNo">1647</span><a name="line.1647"></a>
+<span class="sourceLineNo">1648</span> @Override<a name="line.1648"></a>
+<span class="sourceLineNo">1649</span> public String getFilename() {<a name="line.1649"></a>
+<span class="sourceLineNo">1650</span> return e.getKey().getHfileName();<a name="line.1650"></a>
+<span class="sourceLineNo">1651</span> }<a name="line.1651"></a>
+<span class="sourceLineNo">1652</span><a name="line.1652"></a>
+<span class="sourceLineNo">1653</span> @Override<a name="line.1653"></a>
+<span class="sourceLineNo">1654</span> public int compareTo(CachedBlock other) {<a name="line.1654"></a>
+<span class="sourceLineNo">1655</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1655"></a>
+<span class="sourceLineNo">1656</span> if (diff != 0) return diff;<a name="line.1656"></a>
+<span class="sourceLineNo">1657</span><a name="line.1657"></a>
+<span class="sourceLineNo">1658</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1658"></a>
+<span class="sourceLineNo">1659</span> if (diff != 0) return diff;<a name="line.1659"></a>
+<span class="sourceLineNo">1660</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1660"></a>
+<span class="sourceLineNo">1661</span> throw new IllegalStateException(<a name="line.1661"></a>
+<span class="sourceLineNo">1662</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1662"></a>
+<span class="sourceLineNo">1663</span> }<a name="line.1663"></a>
+<span class="sourceLineNo">1664</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1664"></a>
+<span class="sourceLineNo">1665</span> }<a name="line.1665"></a>
+<span class="sourceLineNo">1666</span><a name="line.1666"></a>
+<span class="sourceLineNo">1667</span> @Override<a name="line.1667"></a>
+<span class="sourceLineNo">1668</span> public int hashCode() {<a name="line.1668"></a>
+<span class="sourceLineNo">1669</span> return e.getKey().hashCode();<a name="line.1669"></a>
+<span class="sourceLineNo">1670</span> }<a name="line.1670"></a>
+<span class="sourceLineNo">1671</span><a name="line.1671"></a>
+<span class="sourceLineNo">1672</span> @Override<a name="line.1672"></a>
+<span class="sourceLineNo">1673</span> public boolean equals(Object obj) {<a name="line.1673"></a>
+<span class="sourceLineNo">1674</span> if (obj instanceof CachedBlock) {<a name="line.1674"></a>
+<span class="sourceLineNo">1675</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1675"></a>
+<span class="sourceLineNo">1676</span> return compareTo(cb) == 0;<a name="line.1676"></a>
+<span class="sourceLineNo">1677</span> } else {<a name="line.1677"></a>
+<span class="sourceLineNo">1678</span> return false;<a name="line.1678"></a>
+<span class="sourceLineNo">1679</span> }<a name="line.1679"></a>
+<span class="sourceLineNo">1680</span> }<a name="line.1680"></a>
+<span class="sourceLineNo">1681</span> };<a name="line.1681"></a>
+<span class="sourceLineNo">1682</span> }<a name="line.1682"></a>
+<span class="sourceLineNo">1683</span><a name="line.1683"></a>
+<span class="sourceLineNo">1684</span> @Override<a name="line.1684"></a>
+<span class="sourceLineNo">1685</span> public void remove() {<a name="line.1685"></a>
+<span class="sourceLineNo">1686</span> throw new UnsupportedOperationException();<a name="line.1686"></a>
+<span class="sourceLineNo">1687</span> }<a name="line.1687"></a>
+<span class="sourceLineNo">1688</span> };<a name="line.1688"></a>
+<span class="sourceLineNo">1689</span> }<a name="line.1689"></a>
+<span class="sourceLineNo">1690</span><a name="line.1690"></a>
+<span class="sourceLineNo">1691</span> @Override<a name="line.1691"></a>
+<span class="sourceLineNo">1692</span> public BlockCache[] getBlockCaches() {<a name="line.1692"></a>
+<span class="sourceLineNo">1693</span> return null;<a name="line.1693"></a>
+<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
+<span class="sourceLineNo">1695</span><a name="line.1695"></a>
+<span class="sourceLineNo">1696</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1696"></a>
+<span class="sourceLineNo">1697</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1697"></a>
+<span class="sourceLineNo">1698</span> if (bucketEntry != null) {<a name="line.1698"></a>
+<span class="sourceLineNo">1699</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1699"></a>
+<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
+<span class="sourceLineNo">1701</span> return 0;<a name="line.1701"></a>
+<span class="sourceLineNo">1702</span> }<a name="line.1702"></a>
+<span class="sourceLineNo">1703</span><a name="line.1703"></a>
+<span class="sourceLineNo">1704</span> float getAcceptableFactor() {<a name="line.1704"></a>
+<span class="sourceLineNo">1705</span> return acceptableFactor;<a name="line.1705"></a>
+<span class="sourceLineNo">1706</span> }<a name="line.1706"></a>
+<span class="sourceLineNo">1707</span><a name="line.1707"></a>
+<span class="sourceLineNo">1708</span> float getMinFactor() {<a name="line.1708"></a>
+<span class="sourceLineNo">1709</span> return minFactor;<a name="line.1709"></a>
+<span class="sourceLineNo">1710</span> }<a name="line.1710"></a>
+<span class="sourceLineNo">1711</span><a name="line.1711"></a>
+<span class="sourceLineNo">1712</span> float getExtraFreeFactor() {<a name="line.1712"></a>
+<span class="sourceLineNo">1713</span> return extraFreeFactor;<a name="line.1713"></a>
+<span class="sourceLineNo">1714</span> }<a name="line.1714"></a>
+<span class="sourceLineNo">1715</span><a name="line.1715"></a>
+<span class="sourceLineNo">1716</span> float getSingleFactor() {<a name="line.1716"></a>
+<span class="sourceLineNo">1717</span> return singleFactor;<a name="line.1717"></a>
+<span class="sourceLineNo">1718</span> }<a name="line.1718"></a>
+<span class="sourceLineNo">1719</span><a name="line.1719"></a>
+<span class="sourceLineNo">1720</span> float getMultiFactor() {<a name="line.1720"></a>
+<span class="sourceLineNo">1721</span> return multiFactor;<a name="line.1721"></a>
+<span class="sourceLineNo">1722</span> }<a name="line.1722"></a>
+<span class="sourceLineNo">1723</span><a name="line.1723"></a>
+<span class="sourceLineNo">1724</span> float getMemoryFactor() {<a name="line.1724"></a>
+<span class="sourceLineNo">1725</span> return memoryFactor;<a name="line.1725"></a>
+<span class="sourceLineNo">1726</span> }<a name="line.1726"></a>
+<span class="sourceLineNo">1727</span><a name="line.1727"></a>
+<span class="sourceLineNo">1728</span> /**<a name="line.1728"></a>
+<span class="sourceLineNo">1729</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1729"></a>
+<span class="sourceLineNo">1730</span> */<a name="line.1730"></a>
+<span class="sourceLineNo">1731</span> static class RAMCache {<a name="line.1731"></a>
+<span class="sourceLineNo">1732</span> /**<a name="line.1732"></a>
+<span class="sourceLineNo">1733</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1733"></a>
+<span class="sourceLineNo">1734</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1734"></a>
+<span class="sourceLineNo">1735</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1735"></a>
+<span class="sourceLineNo">1736</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1736"></a>
+<span class="sourceLineNo">1737</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1737"></a>
+<span class="sourceLineNo">1738</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1738"></a>
+<span class="sourceLineNo">1739</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1739"></a>
+<span class="sourceLineNo">1740</span> */<a name="line.1740"></a>
+<span class="sourceLineNo">1741</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1741"></a>
+<span class="sourceLineNo">1742</span><a name="line.1742"></a>
+<span class="sourceLineNo">1743</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1743"></a>
+<span class="sourceLineNo">1744</span> return delegate.containsKey(key);<a name="line.1744"></a>
+<span class="sourceLineNo">1745</span> }<a name="line.1745"></a>
+<span class="sourceLineNo">1746</span><a name="line.1746"></a>
+<span class="sourceLineNo">1747</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1747"></a>
+<span class="sourceLineNo">1748</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1748"></a>
+<span class="sourceLineNo">1749</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1749"></a>
+<span class="sourceLineNo">1750</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1750"></a>
+<span class="sourceLineNo">1751</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1751"></a>
+<span class="sourceLineNo">1752</span> re.getData().retain();<a name="line.1752"></a>
+<span class="sourceLineNo">1753</span> return re;<a name="line.1753"></a>
+<span class="sourceLineNo">1754</span> });<a name="line.1754"></a>
+<span class="sourceLineNo">1755</span> }<a name="line.1755"></a>
+<span class="sourceLineNo">1756</span><a name="line.1756"></a>
+<span class="sourceLineNo">1757</span> /**<a name="line.1757"></a>
+<span class="sourceLineNo">1758</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1758"></a>
+<span class="sourceLineNo">1759</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1759"></a>
+<span class="sourceLineNo">1760</span> */<a name="line.1760"></a>
+<span class="sourceLineNo">1761</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1761"></a>
+<span class="sourceLineNo">1762</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1762"></a>
+<span class="sourceLineNo">1763</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1763"></a>
+<span class="sourceLineNo">1764</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1764"></a>
+<span class="sourceLineNo">1765</span> entry.getData().retain();<a name="line.1765"></a>
+<span class="sourceLineNo">1766</span> absent.set(true);<a name="line.1766"></a>
+<span class="sourceLineNo">1767</span> return entry;<a name="line.1767"></a>
<span class="sourceLineNo">1768</span> });<a name="line.1768"></a>
-<span class="sourceLineNo">1769</span> }<a name="line.1769"></a>
-<span class="sourceLineNo">1770</span><a name="line.1770"></a>
-<span class="sourceLineNo">1771</span> /**<a name="line.1771"></a>
-<span class="sourceLineNo">1772</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1772"></a>
-<span class="sourceLineNo">1773</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1773"></a>
-<span class="sourceLineNo">1774</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1774"></a>
-<span class="sourceLineNo">1775</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1775"></a>
-<span class="sourceLineNo">1776</span> */<a name="line.1776"></a>
-<span class="sourceLineNo">1777</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1777"></a>
-<span class="sourceLineNo">1778</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1778"></a>
-<span class="sourceLineNo">1779</span> action.accept(previous);<a name="line.1779"></a>
-<span class="sourceLineNo">1780</span> if (previous != null) {<a name="line.1780"></a>
-<span class="sourceLineNo">1781</span> previous.getData().release();<a name="line.1781"></a>
-<span class="sourceLineNo">1782</span> }<a name="line.1782"></a>
-<span class="sourceLineNo">1783</span> return previous != null;<a name="line.1783"></a>
-<span class="sourceLineNo">1784</span> }<a name="line.1784"></a>
-<span class="sourceLineNo">1785</span><a name="line.1785"></a>
-<span class="sourceLineNo">1786</span> public boolean isEmpty() {<a name="line.1786"></a>
-<span class="sourceLineNo">1787</span> return delegate.isEmpty();<a name="line.1787"></a>
-<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
-<span class="sourceLineNo">1789</span><a name="line.1789"></a>
-<span class="sourceLineNo">1790</span> public void clear() {<a name="line.1790"></a>
-<span class="sourceLineNo">1791</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1791"></a>
-<span class="sourceLineNo">1792</span> while (it.hasNext()) {<a name="line.1792"></a>
-<span class="sourceLineNo">1793</span> RAMQueueEntry re = it.next().getValue();<a name="line.1793"></a>
-<span class="sourceLineNo">1794</span> it.remove();<a name="line.1794"></a>
-<span class="sourceLineNo">1795</span> re.getData().release();<a name="line.1795"></a>
-<span class="sourceLineNo">1796</span> }<a name="line.1796"></a>
-<span class="sourceLineNo">1797</span> }<a name="line.1797"></a>
-<span class="sourceLineNo">1798</span> }<a name="line.1798"></a>
-<span class="sourceLineNo">1799</span>}<a name="line.1799"></a>
+<span class="sourceLineNo">1769</span> return absent.get() ? null : re;<a name="line.1769"></a>
+<span class="sourceLineNo">1770</span> }<a name="line.1770"></a>
+<span class="sourceLineNo">1771</span><a name="line.1771"></a>
+<span class="sourceLineNo">1772</span> public boolean remove(BlockCacheKey key) {<a name="line.1772"></a>
+<span class="sourceLineNo">1773</span> return remove(key, re -> {<a name="line.1773"></a>
+<span class="sourceLineNo">1774</span> });<a name="line.1774"></a>
+<span class="sourceLineNo">1775</span> }<a name="line.1775"></a>
+<span class="sourceLineNo">1776</span><a name="line.1776"></a>
+<span class="sourceLineNo">1777</span> /**<a name="line.1777"></a>
+<span class="sourceLineNo">1778</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1778"></a>
+<span class="sourceLineNo">1779</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1779"></a>
+<span class="sourceLineNo">1780</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1780"></a>
+<span class="sourceLineNo">1781</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1781"></a>
+<span class="sourceLineNo">1782</span> */<a name="line.1782"></a>
+<span class="sourceLineNo">1783</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1783"></a>
+<span class="sourceLineNo">1784</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1784"></a>
+<span class="sourceLineNo">1785</span> action.accept(previous);<a name="line.1785"></a>
+<span class="sourceLineNo">1786</span> if (previous != null) {<a name="line.1786"></a>
+<span class="sourceLineNo">1787</span> previous.getData().release();<a name="line.1787"></a>
+<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
+<span class="sourceLineNo">1789</span> return previous != null;<a name="line.1789"></a>
+<span class="sourceLineNo">1790</span> }<a name="line.1790"></a>
+<span class="sourceLineNo">1791</span><a name="line.1791"></a>
+<span class="sourceLineNo">1792</span> public boolean isEmpty() {<a name="line.1792"></a>
+<span class="sourceLineNo">1793</span> return delegate.isEmpty();<a name="line.1793"></a>
+<span class="sourceLineNo">1794</span> }<a name="line.1794"></a>
+<span class="sourceLineNo">1795</span><a name="line.1795"></a>
+<span class="sourceLineNo">1796</span> public void clear() {<a name="line.1796"></a>
+<span class="sourceLineNo">1797</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1797"></a>
+<span class="sourceLineNo">1798</span> while (it.hasNext()) {<a name="line.1798"></a>
+<span class="sourceLineNo">1799</span> RAMQueueEntry re = it.next().getValue();<a name="line.1799"></a>
+<span class="sourceLineNo">1800</span> it.remove();<a name="line.1800"></a>
+<span class="sourceLineNo">1801</span> re.getData().release();<a name="line.1801"></a>
+<span class="sourceLineNo">1802</span> }<a name="line.1802"></a>
+<span class="sourceLineNo">1803</span> }<a name="line.1803"></a>
+<span class="sourceLineNo">1804</span> }<a name="line.1804"></a>
+<span class="sourceLineNo">1805</span>}<a name="line.1805"></a>
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html
index 30710531ef1..6b016942fa7 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.RAMQueueEntry.html
@@ -1053,758 +1053,764 @@
<span class="sourceLineNo">1045</span> final HFileContext fileContext = ((HFileBlock) re.getData()).getHFileContext();<a name="line.1045"></a>
<span class="sourceLineNo">1046</span> final String columnFamily = Bytes.toString(fileContext.getColumnFamily());<a name="line.1046"></a>
<span class="sourceLineNo">1047</span> final String tableName = Bytes.toString(fileContext.getTableName());<a name="line.1047"></a>
-<span class="sourceLineNo">1048</span> if (tableName != null && columnFamily != null) {<a name="line.1048"></a>
+<span class="sourceLineNo">1048</span> if (tableName != null) {<a name="line.1048"></a>
<span class="sourceLineNo">1049</span> sb.append(" Table: ");<a name="line.1049"></a>
<span class="sourceLineNo">1050</span> sb.append(tableName);<a name="line.1050"></a>
-<span class="sourceLineNo">1051</span> sb.append(" CF: ");<a name="line.1051"></a>
-<span class="sourceLineNo">1052</span> sb.append(columnFamily);<a name="line.1052"></a>
-<span class="sourceLineNo">1053</span> sb.append(" HFile: ");<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span> sb.append(fileContext.getHFileName());<a name="line.1054"></a>
+<span class="sourceLineNo">1051</span> }<a name="line.1051"></a>
+<span class="sourceLineNo">1052</span> if (columnFamily != null) {<a name="line.1052"></a>
+<span class="sourceLineNo">1053</span> sb.append(" CF: ");<a name="line.1053"></a>
+<span class="sourceLineNo">1054</span> sb.append(columnFamily);<a name="line.1054"></a>
<span class="sourceLineNo">1055</span> }<a name="line.1055"></a>
-<span class="sourceLineNo">1056</span> } else {<a name="line.1056"></a>
-<span class="sourceLineNo">1057</span> sb.append(" HFile: ");<a name="line.1057"></a>
-<span class="sourceLineNo">1058</span> sb.append(re.getKey());<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span> }<a name="line.1059"></a>
-<span class="sourceLineNo">1060</span> }<a name="line.1060"></a>
-<span class="sourceLineNo">1061</span> sb.append(" Message: ");<a name="line.1061"></a>
-<span class="sourceLineNo">1062</span> sb.append(fle.getMessage());<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> return sb.toString();<a name="line.1063"></a>
-<span class="sourceLineNo">1064</span> }<a name="line.1064"></a>
-<span class="sourceLineNo">1065</span><a name="line.1065"></a>
-<span class="sourceLineNo">1066</span> /**<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1067"></a>
-<span class="sourceLineNo">1068</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1068"></a>
-<span class="sourceLineNo">1069</span> * references and we'll OOME.<a name="line.1069"></a>
-<span class="sourceLineNo">1070</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1070"></a>
-<span class="sourceLineNo">1071</span> * interference expected.<a name="line.1071"></a>
-<span class="sourceLineNo">1072</span> */<a name="line.1072"></a>
-<span class="sourceLineNo">1073</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1073"></a>
-<span class="sourceLineNo">1074</span> if (entries.isEmpty()) {<a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> return;<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span> }<a name="line.1076"></a>
-<span class="sourceLineNo">1077</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1078"></a>
-<span class="sourceLineNo">1079</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1081"></a>
-<span class="sourceLineNo">1082</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1082"></a>
-<span class="sourceLineNo">1083</span> final int size = entries.size();<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1084"></a>
-<span class="sourceLineNo">1085</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1086"></a>
-<span class="sourceLineNo">1087</span> int index = 0;<a name="line.1087"></a>
-<span class="sourceLineNo">1088</span> while (cacheEnabled && index < size) {<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span> RAMQueueEntry re = null;<a name="line.1089"></a>
-<span class="sourceLineNo">1090</span> try {<a name="line.1090"></a>
-<span class="sourceLineNo">1091</span> re = entries.get(index);<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span> if (re == null) {<a name="line.1092"></a>
-<span class="sourceLineNo">1093</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span> index++;<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span> continue;<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span> }<a name="line.1096"></a>
-<span class="sourceLineNo">1097</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1097"></a>
-<span class="sourceLineNo">1098</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> blocksByHFile.add(cacheKey);<a name="line.1099"></a>
-<span class="sourceLineNo">1100</span> }<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span> // Reset the position for reuse.<a name="line.1101"></a>
-<span class="sourceLineNo">1102</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1102"></a>
-<span class="sourceLineNo">1103</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span> // IOEngine in the future.<a name="line.1105"></a>
-<span class="sourceLineNo">1106</span> metaBuff.clear();<a name="line.1106"></a>
-<span class="sourceLineNo">1107</span> BucketEntry bucketEntry =<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1108"></a>
-<span class="sourceLineNo">1109</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1109"></a>
-<span class="sourceLineNo">1110</span> bucketEntries[index] = bucketEntry;<a name="line.1110"></a>
-<span class="sourceLineNo">1111</span> if (ioErrorStartTime > 0) {<a name="line.1111"></a>
-<span class="sourceLineNo">1112</span> ioErrorStartTime = -1;<a name="line.1112"></a>
-<span class="sourceLineNo">1113</span> }<a name="line.1113"></a>
-<span class="sourceLineNo">1114</span> index++;<a name="line.1114"></a>
-<span class="sourceLineNo">1115</span> } catch (BucketAllocatorException fle) {<a name="line.1115"></a>
-<span class="sourceLineNo">1116</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1116"></a>
-<span class="sourceLineNo">1117</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span> if (<a name="line.1118"></a>
-<span class="sourceLineNo">1119</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1119"></a>
-<span class="sourceLineNo">1120</span> ) {<a name="line.1120"></a>
-<span class="sourceLineNo">1121</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1121"></a>
-<span class="sourceLineNo">1122</span> allocFailLogPrevTs = currTs;<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span> }<a name="line.1123"></a>
-<span class="sourceLineNo">1124</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span> bucketEntries[index] = null;<a name="line.1125"></a>
-<span class="sourceLineNo">1126</span> index++;<a name="line.1126"></a>
-<span class="sourceLineNo">1127</span> } catch (CacheFullException cfe) {<a name="line.1127"></a>
-<span class="sourceLineNo">1128</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span> if (!freeInProgress) {<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span> freeSpace("Full!");<a name="line.1130"></a>
-<span class="sourceLineNo">1131</span> } else {<a name="line.1131"></a>
-<span class="sourceLineNo">1132</span> Thread.sleep(50);<a name="line.1132"></a>
-<span class="sourceLineNo">1133</span> }<a name="line.1133"></a>
-<span class="sourceLineNo">1134</span> } catch (IOException ioex) {<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1135"></a>
-<span class="sourceLineNo">1136</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1136"></a>
-<span class="sourceLineNo">1137</span> checkIOErrorIsTolerated();<a name="line.1137"></a>
-<span class="sourceLineNo">1138</span> }<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
-<span class="sourceLineNo">1140</span><a name="line.1140"></a>
-<span class="sourceLineNo">1141</span> // Make sure data pages are written on media before we update maps.<a name="line.1141"></a>
-<span class="sourceLineNo">1142</span> try {<a name="line.1142"></a>
-<span class="sourceLineNo">1143</span> ioEngine.sync();<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span> } catch (IOException ioex) {<a name="line.1144"></a>
-<span class="sourceLineNo">1145</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1145"></a>
-<span class="sourceLineNo">1146</span> checkIOErrorIsTolerated();<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1147"></a>
-<span class="sourceLineNo">1148</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> if (bucketEntry != null) {<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> bucketEntries[i] = null;<a name="line.1152"></a>
-<span class="sourceLineNo">1153</span> }<a name="line.1153"></a>
-<span class="sourceLineNo">1154</span> }<a name="line.1154"></a>
-<span class="sourceLineNo">1155</span> }<a name="line.1155"></a>
-<span class="sourceLineNo">1156</span><a name="line.1156"></a>
-<span class="sourceLineNo">1157</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1157"></a>
-<span class="sourceLineNo">1158</span> // success or error.<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span> for (int i = 0; i < size; ++i) {<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1160"></a>
-<span class="sourceLineNo">1161</span> // Only add if non-null entry.<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span> if (bucketEntries[i] != null) {<a name="line.1162"></a>
-<span class="sourceLineNo">1163</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span> }<a name="line.1164"></a>
-<span class="sourceLineNo">1165</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span> if (re != null) {<a name="line.1167"></a>
-<span class="sourceLineNo">1168</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1168"></a>
-<span class="sourceLineNo">1169</span> }<a name="line.1169"></a>
-<span class="sourceLineNo">1170</span> });<a name="line.1170"></a>
-<span class="sourceLineNo">1171</span> if (!existed && bucketEntries[i] != null) {<a name="line.1171"></a>
-<span class="sourceLineNo">1172</span> // Block should have already been evicted. Remove it and free space.<a name="line.1172"></a>
-<span class="sourceLineNo">1173</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1173"></a>
-<span class="sourceLineNo">1174</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1174"></a>
-<span class="sourceLineNo">1175</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1175"></a>
-<span class="sourceLineNo">1176</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1176"></a>
-<span class="sourceLineNo">1177</span> }<a name="line.1177"></a>
-<span class="sourceLineNo">1178</span> return null;<a name="line.1178"></a>
-<span class="sourceLineNo">1179</span> });<a name="line.1179"></a>
-<span class="sourceLineNo">1180</span> }<a name="line.1180"></a>
-<span class="sourceLineNo">1181</span> }<a name="line.1181"></a>
-<span class="sourceLineNo">1182</span><a name="line.1182"></a>
-<span class="sourceLineNo">1183</span> long used = bucketAllocator.getUsedSize();<a name="line.1183"></a>
-<span class="sourceLineNo">1184</span> if (used > acceptableSize()) {<a name="line.1184"></a>
-<span class="sourceLineNo">1185</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1185"></a>
-<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
-<span class="sourceLineNo">1187</span> return;<a name="line.1187"></a>
-<span class="sourceLineNo">1188</span> }<a name="line.1188"></a>
-<span class="sourceLineNo">1189</span><a name="line.1189"></a>
-<span class="sourceLineNo">1190</span> /**<a name="line.1190"></a>
-<span class="sourceLineNo">1191</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1191"></a>
-<span class="sourceLineNo">1192</span> * returning.<a name="line.1192"></a>
-<span class="sourceLineNo">1193</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1193"></a>
-<span class="sourceLineNo">1194</span> * in case.<a name="line.1194"></a>
-<span class="sourceLineNo">1195</span> * @param q The queue to take from.<a name="line.1195"></a>
-<span class="sourceLineNo">1196</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1196"></a>
-<span class="sourceLineNo">1197</span> */<a name="line.1197"></a>
-<span class="sourceLineNo">1198</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1198"></a>
-<span class="sourceLineNo">1199</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1199"></a>
-<span class="sourceLineNo">1200</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1200"></a>
-<span class="sourceLineNo">1201</span> // ok even if list grew to accommodate thousands.<a name="line.1201"></a>
-<span class="sourceLineNo">1202</span> receptacle.clear();<a name="line.1202"></a>
-<span class="sourceLineNo">1203</span> receptacle.add(q.take());<a name="line.1203"></a>
-<span class="sourceLineNo">1204</span> q.drainTo(receptacle);<a name="line.1204"></a>
-<span class="sourceLineNo">1205</span> return receptacle;<a name="line.1205"></a>
-<span class="sourceLineNo">1206</span> }<a name="line.1206"></a>
-<span class="sourceLineNo">1207</span><a name="line.1207"></a>
-<span class="sourceLineNo">1208</span> /**<a name="line.1208"></a>
-<span class="sourceLineNo">1209</span> * @see #retrieveFromFile(int[])<a name="line.1209"></a>
-<span class="sourceLineNo">1210</span> */<a name="line.1210"></a>
-<span class="sourceLineNo">1211</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1211"></a>
-<span class="sourceLineNo">1212</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1212"></a>
-<span class="sourceLineNo">1213</span> private void persistToFile() throws IOException {<a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> assert !cacheEnabled;<a name="line.1214"></a>
-<span class="sourceLineNo">1215</span> if (!ioEngine.isPersistent()) {<a name="line.1215"></a>
-<span class="sourceLineNo">1216</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1216"></a>
-<span class="sourceLineNo">1217</span> }<a name="line.1217"></a>
-<span class="sourceLineNo">1218</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1218"></a>
-<span class="sourceLineNo">1219</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1219"></a>
-<span class="sourceLineNo">1220</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1220"></a>
-<span class="sourceLineNo">1221</span> }<a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> if (prefetchedFileListPath != null) {<a name="line.1222"></a>
-<span class="sourceLineNo">1223</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1223"></a>
-<span class="sourceLineNo">1224</span> }<a name="line.1224"></a>
-<span class="sourceLineNo">1225</span> }<a name="line.1225"></a>
-<span class="sourceLineNo">1226</span><a name="line.1226"></a>
-<span class="sourceLineNo">1227</span> /**<a name="line.1227"></a>
-<span class="sourceLineNo">1228</span> * @see #persistToFile()<a name="line.1228"></a>
-<span class="sourceLineNo">1229</span> */<a name="line.1229"></a>
-<span class="sourceLineNo">1230</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1230"></a>
-<span class="sourceLineNo">1231</span> File persistenceFile = new File(persistencePath);<a name="line.1231"></a>
-<span class="sourceLineNo">1232</span> if (!persistenceFile.exists()) {<a name="line.1232"></a>
-<span class="sourceLineNo">1233</span> return;<a name="line.1233"></a>
-<span class="sourceLineNo">1234</span> }<a name="line.1234"></a>
-<span class="sourceLineNo">1235</span> assert !cacheEnabled;<a name="line.1235"></a>
-<span class="sourceLineNo">1236</span> if (prefetchedFileListPath != null) {<a name="line.1236"></a>
-<span class="sourceLineNo">1237</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1237"></a>
-<span class="sourceLineNo">1238</span> }<a name="line.1238"></a>
-<span class="sourceLineNo">1239</span><a name="line.1239"></a>
-<span class="sourceLineNo">1240</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1240"></a>
-<span class="sourceLineNo">1241</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1241"></a>
-<span class="sourceLineNo">1242</span> byte[] pbuf = new byte[pblen];<a name="line.1242"></a>
-<span class="sourceLineNo">1243</span> int read = in.read(pbuf);<a name="line.1243"></a>
-<span class="sourceLineNo">1244</span> if (read != pblen) {<a name="line.1244"></a>
-<span class="sourceLineNo">1245</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1245"></a>
-<span class="sourceLineNo">1246</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1246"></a>
-<span class="sourceLineNo">1247</span> }<a name="line.1247"></a>
-<span class="sourceLineNo">1248</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1248"></a>
-<span class="sourceLineNo">1249</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1249"></a>
-<span class="sourceLineNo">1250</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1250"></a>
-<span class="sourceLineNo">1251</span> throw new IOException(<a name="line.1251"></a>
-<span class="sourceLineNo">1252</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1252"></a>
+<span class="sourceLineNo">1056</span> sb.append(" HFile: ");<a name="line.1056"></a>
+<span class="sourceLineNo">1057</span> if (fileContext.getHFileName() != null) {<a name="line.1057"></a>
+<span class="sourceLineNo">1058</span> sb.append(fileContext.getHFileName());<a name="line.1058"></a>
+<span class="sourceLineNo">1059</span> } else {<a name="line.1059"></a>
+<span class="sourceLineNo">1060</span> sb.append(re.getKey());<a name="line.1060"></a>
+<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
+<span class="sourceLineNo">1062</span> } else {<a name="line.1062"></a>
+<span class="sourceLineNo">1063</span> sb.append(" HFile: ");<a name="line.1063"></a>
+<span class="sourceLineNo">1064</span> sb.append(re.getKey());<a name="line.1064"></a>
+<span class="sourceLineNo">1065</span> }<a name="line.1065"></a>
+<span class="sourceLineNo">1066</span> }<a name="line.1066"></a>
+<span class="sourceLineNo">1067</span> sb.append(" Message: ");<a name="line.1067"></a>
+<span class="sourceLineNo">1068</span> sb.append(fle.getMessage());<a name="line.1068"></a>
+<span class="sourceLineNo">1069</span> return sb.toString();<a name="line.1069"></a>
+<span class="sourceLineNo">1070</span> }<a name="line.1070"></a>
+<span class="sourceLineNo">1071</span><a name="line.1071"></a>
+<span class="sourceLineNo">1072</span> /**<a name="line.1072"></a>
+<span class="sourceLineNo">1073</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1073"></a>
+<span class="sourceLineNo">1074</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1074"></a>
+<span class="sourceLineNo">1075</span> * references and we'll OOME.<a name="line.1075"></a>
+<span class="sourceLineNo">1076</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1076"></a>
+<span class="sourceLineNo">1077</span> * interference expected.<a name="line.1077"></a>
+<span class="sourceLineNo">1078</span> */<a name="line.1078"></a>
+<span class="sourceLineNo">1079</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1079"></a>
+<span class="sourceLineNo">1080</span> if (entries.isEmpty()) {<a name="line.1080"></a>
+<span class="sourceLineNo">1081</span> return;<a name="line.1081"></a>
+<span class="sourceLineNo">1082</span> }<a name="line.1082"></a>
+<span class="sourceLineNo">1083</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1083"></a>
+<span class="sourceLineNo">1084</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1084"></a>
+<span class="sourceLineNo">1085</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1085"></a>
+<span class="sourceLineNo">1086</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1086"></a>
+<span class="sourceLineNo">1087</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1087"></a>
+<span class="sourceLineNo">1088</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1088"></a>
+<span class="sourceLineNo">1089</span> final int size = entries.size();<a name="line.1089"></a>
+<span class="sourceLineNo">1090</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1090"></a>
+<span class="sourceLineNo">1091</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1091"></a>
+<span class="sourceLineNo">1092</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1092"></a>
+<span class="sourceLineNo">1093</span> int index = 0;<a name="line.1093"></a>
+<span class="sourceLineNo">1094</span> while (cacheEnabled && index < size) {<a name="line.1094"></a>
+<span class="sourceLineNo">1095</span> RAMQueueEntry re = null;<a name="line.1095"></a>
+<span class="sourceLineNo">1096</span> try {<a name="line.1096"></a>
+<span class="sourceLineNo">1097</span> re = entries.get(index);<a name="line.1097"></a>
+<span class="sourceLineNo">1098</span> if (re == null) {<a name="line.1098"></a>
+<span class="sourceLineNo">1099</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1099"></a>
+<span class="sourceLineNo">1100</span> index++;<a name="line.1100"></a>
+<span class="sourceLineNo">1101</span> continue;<a name="line.1101"></a>
+<span class="sourceLineNo">1102</span> }<a name="line.1102"></a>
+<span class="sourceLineNo">1103</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1103"></a>
+<span class="sourceLineNo">1104</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1104"></a>
+<span class="sourceLineNo">1105</span> blocksByHFile.add(cacheKey);<a name="line.1105"></a>
+<span class="sourceLineNo">1106</span> }<a name="line.1106"></a>
+<span class="sourceLineNo">1107</span> // Reset the position for reuse.<a name="line.1107"></a>
+<span class="sourceLineNo">1108</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1108"></a>
+<span class="sourceLineNo">1109</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1109"></a>
+<span class="sourceLineNo">1110</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1110"></a>
+<span class="sourceLineNo">1111</span> // IOEngine in the future.<a name="line.1111"></a>
+<span class="sourceLineNo">1112</span> metaBuff.clear();<a name="line.1112"></a>
+<span class="sourceLineNo">1113</span> BucketEntry bucketEntry =<a name="line.1113"></a>
+<span class="sourceLineNo">1114</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1114"></a>
+<span class="sourceLineNo">1115</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1115"></a>
+<span class="sourceLineNo">1116</span> bucketEntries[index] = bucketEntry;<a name="line.1116"></a>
+<span class="sourceLineNo">1117</span> if (ioErrorStartTime > 0) {<a name="line.1117"></a>
+<span class="sourceLineNo">1118</span> ioErrorStartTime = -1;<a name="line.1118"></a>
+<span class="sourceLineNo">1119</span> }<a name="line.1119"></a>
+<span class="sourceLineNo">1120</span> index++;<a name="line.1120"></a>
+<span class="sourceLineNo">1121</span> } catch (BucketAllocatorException fle) {<a name="line.1121"></a>
+<span class="sourceLineNo">1122</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1122"></a>
+<span class="sourceLineNo">1123</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1123"></a>
+<span class="sourceLineNo">1124</span> if (<a name="line.1124"></a>
+<span class="sourceLineNo">1125</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1125"></a>
+<span class="sourceLineNo">1126</span> ) {<a name="line.1126"></a>
+<span class="sourceLineNo">1127</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1127"></a>
+<span class="sourceLineNo">1128</span> allocFailLogPrevTs = currTs;<a name="line.1128"></a>
+<span class="sourceLineNo">1129</span> }<a name="line.1129"></a>
+<span class="sourceLineNo">1130</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1130"></a>
+<span class="sourceLineNo">1131</span> bucketEntries[index] = null;<a name="line.1131"></a>
+<span class="sourceLineNo">1132</span> index++;<a name="line.1132"></a>
+<span class="sourceLineNo">1133</span> } catch (CacheFullException cfe) {<a name="line.1133"></a>
+<span class="sourceLineNo">1134</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1134"></a>
+<span class="sourceLineNo">1135</span> if (!freeInProgress) {<a name="line.1135"></a>
+<span class="sourceLineNo">1136</span> freeSpace("Full!");<a name="line.1136"></a>
+<span class="sourceLineNo">1137</span> } else {<a name="line.1137"></a>
+<span class="sourceLineNo">1138</span> Thread.sleep(50);<a name="line.1138"></a>
+<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
+<span class="sourceLineNo">1140</span> } catch (IOException ioex) {<a name="line.1140"></a>
+<span class="sourceLineNo">1141</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1141"></a>
+<span class="sourceLineNo">1142</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1142"></a>
+<span class="sourceLineNo">1143</span> checkIOErrorIsTolerated();<a name="line.1143"></a>
+<span class="sourceLineNo">1144</span> }<a name="line.1144"></a>
+<span class="sourceLineNo">1145</span> }<a name="line.1145"></a>
+<span class="sourceLineNo">1146</span><a name="line.1146"></a>
+<span class="sourceLineNo">1147</span> // Make sure data pages are written on media before we update maps.<a name="line.1147"></a>
+<span class="sourceLineNo">1148</span> try {<a name="line.1148"></a>
+<span class="sourceLineNo">1149</span> ioEngine.sync();<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span> } catch (IOException ioex) {<a name="line.1150"></a>
+<span class="sourceLineNo">1151</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1151"></a>
+<span class="sourceLineNo">1152</span> checkIOErrorIsTolerated();<a name="line.1152"></a>
+<span class="sourceLineNo">1153</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1153"></a>
+<span class="sourceLineNo">1154</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1154"></a>
+<span class="sourceLineNo">1155</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1155"></a>
+<span class="sourceLineNo">1156</span> if (bucketEntry != null) {<a name="line.1156"></a>
+<span class="sourceLineNo">1157</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1157"></a>
+<span class="sourceLineNo">1158</span> bucketEntries[i] = null;<a name="line.1158"></a>
+<span class="sourceLineNo">1159</span> }<a name="line.1159"></a>
+<span class="sourceLineNo">1160</span> }<a name="line.1160"></a>
+<span class="sourceLineNo">1161</span> }<a name="line.1161"></a>
+<span class="sourceLineNo">1162</span><a name="line.1162"></a>
+<span class="sourceLineNo">1163</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1163"></a>
+<span class="sourceLineNo">1164</span> // success or error.<a name="line.1164"></a>
+<span class="sourceLineNo">1165</span> for (int i = 0; i < size; ++i) {<a name="line.1165"></a>
+<span class="sourceLineNo">1166</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1166"></a>
+<span class="sourceLineNo">1167</span> // Only add if non-null entry.<a name="line.1167"></a>
+<span class="sourceLineNo">1168</span> if (bucketEntries[i] != null) {<a name="line.1168"></a>
+<span class="sourceLineNo">1169</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1169"></a>
+<span class="sourceLineNo">1170</span> }<a name="line.1170"></a>
+<span class="sourceLineNo">1171</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1171"></a>
+<span class="sourceLineNo">1172</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1172"></a>
+<span class="sourceLineNo">1173</span> if (re != null) {<a name="line.1173"></a>
+<span class="sourceLineNo">1174</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1174"></a>
+<span class="sourceLineNo">1175</span> }<a name="line.1175"></a>
+<span class="sourceLineNo">1176</span> });<a name="line.1176"></a>
+<span class="sourceLineNo">1177</span> if (!existed && bucketEntries[i] != null) {<a name="line.1177"></a>
+<span class="sourceLineNo">1178</span> // Block should have already been evicted. Remove it and free space.<a name="line.1178"></a>
+<span class="sourceLineNo">1179</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1179"></a>
+<span class="sourceLineNo">1180</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1180"></a>
+<span class="sourceLineNo">1181</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1181"></a>
+<span class="sourceLineNo">1182</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1182"></a>
+<span class="sourceLineNo">1183</span> }<a name="line.1183"></a>
+<span class="sourceLineNo">1184</span> return null;<a name="line.1184"></a>
+<span class="sourceLineNo">1185</span> });<a name="line.1185"></a>
+<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
+<span class="sourceLineNo">1187</span> }<a name="line.1187"></a>
+<span class="sourceLineNo">1188</span><a name="line.1188"></a>
+<span class="sourceLineNo">1189</span> long used = bucketAllocator.getUsedSize();<a name="line.1189"></a>
+<span class="sourceLineNo">1190</span> if (used > acceptableSize()) {<a name="line.1190"></a>
+<span class="sourceLineNo">1191</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1191"></a>
+<span class="sourceLineNo">1192</span> }<a name="line.1192"></a>
+<span class="sourceLineNo">1193</span> return;<a name="line.1193"></a>
+<span class="sourceLineNo">1194</span> }<a name="line.1194"></a>
+<span class="sourceLineNo">1195</span><a name="line.1195"></a>
+<span class="sourceLineNo">1196</span> /**<a name="line.1196"></a>
+<span class="sourceLineNo">1197</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1197"></a>
+<span class="sourceLineNo">1198</span> * returning.<a name="line.1198"></a>
+<span class="sourceLineNo">1199</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1199"></a>
+<span class="sourceLineNo">1200</span> * in case.<a name="line.1200"></a>
+<span class="sourceLineNo">1201</span> * @param q The queue to take from.<a name="line.1201"></a>
+<span class="sourceLineNo">1202</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1202"></a>
+<span class="sourceLineNo">1203</span> */<a name="line.1203"></a>
+<span class="sourceLineNo">1204</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1204"></a>
+<span class="sourceLineNo">1205</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1205"></a>
+<span class="sourceLineNo">1206</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1206"></a>
+<span class="sourceLineNo">1207</span> // ok even if list grew to accommodate thousands.<a name="line.1207"></a>
+<span class="sourceLineNo">1208</span> receptacle.clear();<a name="line.1208"></a>
+<span class="sourceLineNo">1209</span> receptacle.add(q.take());<a name="line.1209"></a>
+<span class="sourceLineNo">1210</span> q.drainTo(receptacle);<a name="line.1210"></a>
+<span class="sourceLineNo">1211</span> return receptacle;<a name="line.1211"></a>
+<span class="sourceLineNo">1212</span> }<a name="line.1212"></a>
+<span class="sourceLineNo">1213</span><a name="line.1213"></a>
+<span class="sourceLineNo">1214</span> /**<a name="line.1214"></a>
+<span class="sourceLineNo">1215</span> * @see #retrieveFromFile(int[])<a name="line.1215"></a>
+<span class="sourceLineNo">1216</span> */<a name="line.1216"></a>
+<span class="sourceLineNo">1217</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1217"></a>
+<span class="sourceLineNo">1218</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1218"></a>
+<span class="sourceLineNo">1219</span> private void persistToFile() throws IOException {<a name="line.1219"></a>
+<span class="sourceLineNo">1220</span> assert !cacheEnabled;<a name="line.1220"></a>
+<span class="sourceLineNo">1221</span> if (!ioEngine.isPersistent()) {<a name="line.1221"></a>
+<span class="sourceLineNo">1222</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1222"></a>
+<span class="sourceLineNo">1223</span> }<a name="line.1223"></a>
+<span class="sourceLineNo">1224</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1224"></a>
+<span class="sourceLineNo">1225</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1225"></a>
+<span class="sourceLineNo">1226</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1226"></a>
+<span class="sourceLineNo">1227</span> }<a name="line.1227"></a>
+<span class="sourceLineNo">1228</span> if (prefetchedFileListPath != null) {<a name="line.1228"></a>
+<span class="sourceLineNo">1229</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1229"></a>
+<span class="sourceLineNo">1230</span> }<a name="line.1230"></a>
+<span class="sourceLineNo">1231</span> }<a name="line.1231"></a>
+<span class="sourceLineNo">1232</span><a name="line.1232"></a>
+<span class="sourceLineNo">1233</span> /**<a name="line.1233"></a>
+<span class="sourceLineNo">1234</span> * @see #persistToFile()<a name="line.1234"></a>
+<span class="sourceLineNo">1235</span> */<a name="line.1235"></a>
+<span class="sourceLineNo">1236</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1236"></a>
+<span class="sourceLineNo">1237</span> File persistenceFile = new File(persistencePath);<a name="line.1237"></a>
+<span class="sourceLineNo">1238</span> if (!persistenceFile.exists()) {<a name="line.1238"></a>
+<span class="sourceLineNo">1239</span> return;<a name="line.1239"></a>
+<span class="sourceLineNo">1240</span> }<a name="line.1240"></a>
+<span class="sourceLineNo">1241</span> assert !cacheEnabled;<a name="line.1241"></a>
+<span class="sourceLineNo">1242</span> if (prefetchedFileListPath != null) {<a name="line.1242"></a>
+<span class="sourceLineNo">1243</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1243"></a>
+<span class="sourceLineNo">1244</span> }<a name="line.1244"></a>
+<span class="sourceLineNo">1245</span><a name="line.1245"></a>
+<span class="sourceLineNo">1246</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1246"></a>
+<span class="sourceLineNo">1247</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1247"></a>
+<span class="sourceLineNo">1248</span> byte[] pbuf = new byte[pblen];<a name="line.1248"></a>
+<span class="sourceLineNo">1249</span> int read = in.read(pbuf);<a name="line.1249"></a>
+<span class="sourceLineNo">1250</span> if (read != pblen) {<a name="line.1250"></a>
+<span class="sourceLineNo">1251</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1251"></a>
+<span class="sourceLineNo">1252</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1252"></a>
<span class="sourceLineNo">1253</span> }<a name="line.1253"></a>
-<span class="sourceLineNo">1254</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1254"></a>
-<span class="sourceLineNo">1255</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1255"></a>
-<span class="sourceLineNo">1256</span> blockNumber.add(backingMap.size());<a name="line.1256"></a>
-<span class="sourceLineNo">1257</span> }<a name="line.1257"></a>
-<span class="sourceLineNo">1258</span> }<a name="line.1258"></a>
-<span class="sourceLineNo">1259</span><a name="line.1259"></a>
-<span class="sourceLineNo">1260</span> /**<a name="line.1260"></a>
-<span class="sourceLineNo">1261</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1261"></a>
-<span class="sourceLineNo">1262</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1262"></a>
-<span class="sourceLineNo">1263</span> *<a name="line.1263"></a>
-<span class="sourceLineNo">1264</span> * <pre><a name="line.1264"></a>
-<span class="sourceLineNo">1265</span> * File f = ...<a name="line.1265"></a>
-<span class="sourceLineNo">1266</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1266"></a>
-<span class="sourceLineNo">1267</span> * // use the input stream<a name="line.1267"></a>
-<span class="sourceLineNo">1268</span> * } finally {<a name="line.1268"></a>
-<span class="sourceLineNo">1269</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1269"></a>
-<span class="sourceLineNo">1270</span> * }<a name="line.1270"></a>
-<span class="sourceLineNo">1271</span> * </pre><a name="line.1271"></a>
-<span class="sourceLineNo">1272</span> *<a name="line.1272"></a>
-<span class="sourceLineNo">1273</span> * @param file the file to read and delete<a name="line.1273"></a>
-<span class="sourceLineNo">1274</span> * @return a FileInputStream for the given file<a name="line.1274"></a>
-<span class="sourceLineNo">1275</span> * @throws IOException if there is a problem creating the stream<a name="line.1275"></a>
-<span class="sourceLineNo">1276</span> */<a name="line.1276"></a>
-<span class="sourceLineNo">1277</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1277"></a>
-<span class="sourceLineNo">1278</span> return new FileInputStream(file) {<a name="line.1278"></a>
-<span class="sourceLineNo">1279</span> private File myFile;<a name="line.1279"></a>
-<span class="sourceLineNo">1280</span><a name="line.1280"></a>
-<span class="sourceLineNo">1281</span> private FileInputStream init(File file) {<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> myFile = file;<a name="line.1282"></a>
-<span class="sourceLineNo">1283</span> return this;<a name="line.1283"></a>
-<span class="sourceLineNo">1284</span> }<a name="line.1284"></a>
-<span class="sourceLineNo">1285</span><a name="line.1285"></a>
-<span class="sourceLineNo">1286</span> @Override<a name="line.1286"></a>
-<span class="sourceLineNo">1287</span> public void close() throws IOException {<a name="line.1287"></a>
-<span class="sourceLineNo">1288</span> // close() will be called during try-with-resources and it will be<a name="line.1288"></a>
-<span class="sourceLineNo">1289</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1289"></a>
-<span class="sourceLineNo">1290</span> // set myFile to null after the first call.<a name="line.1290"></a>
-<span class="sourceLineNo">1291</span> if (myFile == null) {<a name="line.1291"></a>
-<span class="sourceLineNo">1292</span> return;<a name="line.1292"></a>
-<span class="sourceLineNo">1293</span> }<a name="line.1293"></a>
-<span class="sourceLineNo">1294</span><a name="line.1294"></a>
-<span class="sourceLineNo">1295</span> super.close();<a name="line.1295"></a>
-<span class="sourceLineNo">1296</span> if (!myFile.delete()) {<a name="line.1296"></a>
-<span class="sourceLineNo">1297</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1297"></a>
-<span class="sourceLineNo">1298</span> }<a name="line.1298"></a>
-<span class="sourceLineNo">1299</span> myFile = null;<a name="line.1299"></a>
-<span class="sourceLineNo">1300</span> }<a name="line.1300"></a>
-<span class="sourceLineNo">1301</span> }.init(file);<a name="line.1301"></a>
-<span class="sourceLineNo">1302</span> }<a name="line.1302"></a>
-<span class="sourceLineNo">1303</span><a name="line.1303"></a>
-<span class="sourceLineNo">1304</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1304"></a>
-<span class="sourceLineNo">1305</span> throws IOException {<a name="line.1305"></a>
-<span class="sourceLineNo">1306</span> if (capacitySize != cacheCapacity) {<a name="line.1306"></a>
-<span class="sourceLineNo">1307</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1307"></a>
-<span class="sourceLineNo">1308</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1308"></a>
-<span class="sourceLineNo">1309</span> }<a name="line.1309"></a>
-<span class="sourceLineNo">1310</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1310"></a>
-<span class="sourceLineNo">1311</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1311"></a>
-<span class="sourceLineNo">1312</span> + ioEngine.getClass().getName());<a name="line.1312"></a>
-<span class="sourceLineNo">1313</span> }<a name="line.1313"></a>
-<span class="sourceLineNo">1314</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1314"></a>
-<span class="sourceLineNo">1315</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1315"></a>
-<span class="sourceLineNo">1316</span> + backingMap.getClass().getName());<a name="line.1316"></a>
-<span class="sourceLineNo">1317</span> }<a name="line.1317"></a>
-<span class="sourceLineNo">1318</span> }<a name="line.1318"></a>
-<span class="sourceLineNo">1319</span><a name="line.1319"></a>
-<span class="sourceLineNo">1320</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1320"></a>
-<span class="sourceLineNo">1321</span> if (proto.hasChecksum()) {<a name="line.1321"></a>
-<span class="sourceLineNo">1322</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1322"></a>
-<span class="sourceLineNo">1323</span> algorithm);<a name="line.1323"></a>
-<span class="sourceLineNo">1324</span> } else {<a name="line.1324"></a>
-<span class="sourceLineNo">1325</span> // if has not checksum, it means the persistence file is old format<a name="line.1325"></a>
-<span class="sourceLineNo">1326</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1326"></a>
-<span class="sourceLineNo">1327</span> }<a name="line.1327"></a>
-<span class="sourceLineNo">1328</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1328"></a>
-<span class="sourceLineNo">1329</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1329"></a>
-<span class="sourceLineNo">1330</span> this::createRecycler);<a name="line.1330"></a>
-<span class="sourceLineNo">1331</span> }<a name="line.1331"></a>
-<span class="sourceLineNo">1332</span><a name="line.1332"></a>
-<span class="sourceLineNo">1333</span> /**<a name="line.1333"></a>
-<span class="sourceLineNo">1334</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1334"></a>
-<span class="sourceLineNo">1335</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1335"></a>
-<span class="sourceLineNo">1336</span> */<a name="line.1336"></a>
-<span class="sourceLineNo">1337</span> private void checkIOErrorIsTolerated() {<a name="line.1337"></a>
-<span class="sourceLineNo">1338</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1338"></a>
-<span class="sourceLineNo">1339</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1339"></a>
-<span class="sourceLineNo">1340</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1340"></a>
-<span class="sourceLineNo">1341</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1341"></a>
-<span class="sourceLineNo">1342</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1343"></a>
-<span class="sourceLineNo">1344</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1344"></a>
-<span class="sourceLineNo">1345</span> disableCache();<a name="line.1345"></a>
-<span class="sourceLineNo">1346</span> }<a name="line.1346"></a>
-<span class="sourceLineNo">1347</span> } else {<a name="line.1347"></a>
-<span class="sourceLineNo">1348</span> this.ioErrorStartTime = now;<a name="line.1348"></a>
-<span class="sourceLineNo">1349</span> }<a name="line.1349"></a>
-<span class="sourceLineNo">1350</span> }<a name="line.1350"></a>
-<span class="sourceLineNo">1351</span><a name="line.1351"></a>
-<span class="sourceLineNo">1352</span> /**<a name="line.1352"></a>
-<span class="sourceLineNo">1353</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1353"></a>
-<span class="sourceLineNo">1354</span> */<a name="line.1354"></a>
-<span class="sourceLineNo">1355</span> private void disableCache() {<a name="line.1355"></a>
-<span class="sourceLineNo">1356</span> if (!cacheEnabled) return;<a name="line.1356"></a>
-<span class="sourceLineNo">1357</span> cacheEnabled = false;<a name="line.1357"></a>
-<span class="sourceLineNo">1358</span> ioEngine.shutdown();<a name="line.1358"></a>
-<span class="sourceLineNo">1359</span> this.scheduleThreadPool.shutdown();<a name="line.1359"></a>
-<span class="sourceLineNo">1360</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1360"></a>
-<span class="sourceLineNo">1361</span> writerThreads[i].interrupt();<a name="line.1361"></a>
-<span class="sourceLineNo">1362</span> this.ramCache.clear();<a name="line.1362"></a>
-<span class="sourceLineNo">1363</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1363"></a>
-<span class="sourceLineNo">1364</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1364"></a>
-<span class="sourceLineNo">1365</span> this.backingMap.clear();<a name="line.1365"></a>
-<span class="sourceLineNo">1366</span> }<a name="line.1366"></a>
-<span class="sourceLineNo">1367</span> }<a name="line.1367"></a>
-<span class="sourceLineNo">1368</span><a name="line.1368"></a>
-<span class="sourceLineNo">1369</span> private void join() throws InterruptedException {<a name="line.1369"></a>
-<span class="sourceLineNo">1370</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1370"></a>
-<span class="sourceLineNo">1371</span> writerThreads[i].join();<a name="line.1371"></a>
-<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
-<span class="sourceLineNo">1373</span><a name="line.1373"></a>
-<span class="sourceLineNo">1374</span> @Override<a name="line.1374"></a>
-<span class="sourceLineNo">1375</span> public void shutdown() {<a name="line.1375"></a>
-<span class="sourceLineNo">1376</span> disableCache();<a name="line.1376"></a>
-<span class="sourceLineNo">1377</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1377"></a>
-<span class="sourceLineNo">1378</span> + persistencePath);<a name="line.1378"></a>
-<span class="sourceLineNo">1379</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1379"></a>
-<span class="sourceLineNo">1380</span> try {<a name="line.1380"></a>
-<span class="sourceLineNo">1381</span> join();<a name="line.1381"></a>
-<span class="sourceLineNo">1382</span> persistToFile();<a name="line.1382"></a>
-<span class="sourceLineNo">1383</span> } catch (IOException ex) {<a name="line.1383"></a>
-<span class="sourceLineNo">1384</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1384"></a>
-<span class="sourceLineNo">1385</span> } catch (InterruptedException e) {<a name="line.1385"></a>
-<span class="sourceLineNo">1386</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> }<a name="line.1387"></a>
-<span class="sourceLineNo">1388</span> }<a name="line.1388"></a>
-<span class="sourceLineNo">1389</span> }<a name="line.1389"></a>
-<span class="sourceLineNo">1390</span><a name="line.1390"></a>
-<span class="sourceLineNo">1391</span> @Override<a name="line.1391"></a>
-<span class="sourceLineNo">1392</span> public CacheStats getStats() {<a name="line.1392"></a>
-<span class="sourceLineNo">1393</span> return cacheStats;<a name="line.1393"></a>
-<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
-<span class="sourceLineNo">1395</span><a name="line.1395"></a>
-<span class="sourceLineNo">1396</span> public BucketAllocator getAllocator() {<a name="line.1396"></a>
-<span class="sourceLineNo">1397</span> return this.bucketAllocator;<a name="line.1397"></a>
-<span class="sourceLineNo">1398</span> }<a name="line.1398"></a>
-<span class="sourceLineNo">1399</span><a name="line.1399"></a>
-<span class="sourceLineNo">1400</span> @Override<a name="line.1400"></a>
-<span class="sourceLineNo">1401</span> public long heapSize() {<a name="line.1401"></a>
-<span class="sourceLineNo">1402</span> return this.heapSize.sum();<a name="line.1402"></a>
-<span class="sourceLineNo">1403</span> }<a name="line.1403"></a>
-<span class="sourceLineNo">1404</span><a name="line.1404"></a>
-<span class="sourceLineNo">1405</span> @Override<a name="line.1405"></a>
-<span class="sourceLineNo">1406</span> public long size() {<a name="line.1406"></a>
-<span class="sourceLineNo">1407</span> return this.realCacheSize.sum();<a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> }<a name="line.1408"></a>
-<span class="sourceLineNo">1409</span><a name="line.1409"></a>
-<span class="sourceLineNo">1410</span> @Override<a name="line.1410"></a>
-<span class="sourceLineNo">1411</span> public long getCurrentDataSize() {<a name="line.1411"></a>
-<span class="sourceLineNo">1412</span> return size();<a name="line.1412"></a>
-<span class="sourceLineNo">1413</span> }<a name="line.1413"></a>
-<span class="sourceLineNo">1414</span><a name="line.1414"></a>
-<span class="sourceLineNo">1415</span> @Override<a name="line.1415"></a>
-<span class="sourceLineNo">1416</span> public long getFreeSize() {<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> return this.bucketAllocator.getFreeSize();<a name="line.1417"></a>
-<span class="sourceLineNo">1418</span> }<a name="line.1418"></a>
-<span class="sourceLineNo">1419</span><a name="line.1419"></a>
-<span class="sourceLineNo">1420</span> @Override<a name="line.1420"></a>
-<span class="sourceLineNo">1421</span> public long getBlockCount() {<a name="line.1421"></a>
-<span class="sourceLineNo">1422</span> return this.blockNumber.sum();<a name="line.1422"></a>
-<span class="sourceLineNo">1423</span> }<a name="line.1423"></a>
-<span class="sourceLineNo">1424</span><a name="line.1424"></a>
-<span class="sourceLineNo">1425</span> @Override<a name="line.1425"></a>
-<span class="sourceLineNo">1426</span> public long getDataBlockCount() {<a name="line.1426"></a>
-<span class="sourceLineNo">1427</span> return getBlockCount();<a name="line.1427"></a>
-<span class="sourceLineNo">1428</span> }<a name="line.1428"></a>
-<span class="sourceLineNo">1429</span><a name="line.1429"></a>
-<span class="sourceLineNo">1430</span> @Override<a name="line.1430"></a>
-<span class="sourceLineNo">1431</span> public long getCurrentSize() {<a name="line.1431"></a>
-<span class="sourceLineNo">1432</span> return this.bucketAllocator.getUsedSize();<a name="line.1432"></a>
-<span class="sourceLineNo">1433</span> }<a name="line.1433"></a>
-<span class="sourceLineNo">1434</span><a name="line.1434"></a>
-<span class="sourceLineNo">1435</span> protected String getAlgorithm() {<a name="line.1435"></a>
-<span class="sourceLineNo">1436</span> return algorithm;<a name="line.1436"></a>
-<span class="sourceLineNo">1437</span> }<a name="line.1437"></a>
-<span class="sourceLineNo">1438</span><a name="line.1438"></a>
-<span class="sourceLineNo">1439</span> /**<a name="line.1439"></a>
-<span class="sourceLineNo">1440</span> * Evicts all blocks for a specific HFile.<a name="line.1440"></a>
-<span class="sourceLineNo">1441</span> * <p><a name="line.1441"></a>
-<span class="sourceLineNo">1442</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1442"></a>
-<span class="sourceLineNo">1443</span> * @return the number of blocks evicted<a name="line.1443"></a>
-<span class="sourceLineNo">1444</span> */<a name="line.1444"></a>
-<span class="sourceLineNo">1445</span> @Override<a name="line.1445"></a>
-<span class="sourceLineNo">1446</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1446"></a>
-<span class="sourceLineNo">1447</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1447"></a>
-<span class="sourceLineNo">1448</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1448"></a>
-<span class="sourceLineNo">1449</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1449"></a>
-<span class="sourceLineNo">1450</span><a name="line.1450"></a>
-<span class="sourceLineNo">1451</span> int numEvicted = 0;<a name="line.1451"></a>
-<span class="sourceLineNo">1452</span> for (BlockCacheKey key : keySet) {<a name="line.1452"></a>
-<span class="sourceLineNo">1453</span> if (evictBlock(key)) {<a name="line.1453"></a>
-<span class="sourceLineNo">1454</span> ++numEvicted;<a name="line.1454"></a>
-<span class="sourceLineNo">1455</span> }<a name="line.1455"></a>
-<span class="sourceLineNo">1456</span> }<a name="line.1456"></a>
-<span class="sourceLineNo">1457</span><a name="line.1457"></a>
-<span class="sourceLineNo">1458</span> return numEvicted;<a name="line.1458"></a>
-<span class="sourceLineNo">1459</span> }<a name="line.1459"></a>
-<span class="sourceLineNo">1460</span><a name="line.1460"></a>
-<span class="sourceLineNo">1461</span> /**<a name="line.1461"></a>
-<span class="sourceLineNo">1462</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1462"></a>
-<span class="sourceLineNo">1463</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1463"></a>
-<span class="sourceLineNo">1464</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1464"></a>
-<span class="sourceLineNo">1465</span> */<a name="line.1465"></a>
-<span class="sourceLineNo">1466</span> private class BucketEntryGroup {<a name="line.1466"></a>
-<span class="sourceLineNo">1467</span><a name="line.1467"></a>
-<span class="sourceLineNo">1468</span> private CachedEntryQueue queue;<a name="line.1468"></a>
-<span class="sourceLineNo">1469</span> private long totalSize = 0;<a name="line.1469"></a>
-<span class="sourceLineNo">1470</span> private long bucketSize;<a name="line.1470"></a>
-<span class="sourceLineNo">1471</span><a name="line.1471"></a>
-<span class="sourceLineNo">1472</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1472"></a>
-<span class="sourceLineNo">1473</span> this.bucketSize = bucketSize;<a name="line.1473"></a>
-<span class="sourceLineNo">1474</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1474"></a>
-<span class="sourceLineNo">1475</span> totalSize = 0;<a name="line.1475"></a>
-<span class="sourceLineNo">1476</span> }<a name="line.1476"></a>
+<span class="sourceLineNo">1254</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1254"></a>
+<span class="sourceLineNo">1255</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1255"></a>
+<span class="sourceLineNo">1256</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1256"></a>
+<span class="sourceLineNo">1257</span> throw new IOException(<a name="line.1257"></a>
+<span class="sourceLineNo">1258</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1258"></a>
+<span class="sourceLineNo">1259</span> }<a name="line.1259"></a>
+<span class="sourceLineNo">1260</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1260"></a>
+<span class="sourceLineNo">1261</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1261"></a>
+<span class="sourceLineNo">1262</span> blockNumber.add(backingMap.size());<a name="line.1262"></a>
+<span class="sourceLineNo">1263</span> }<a name="line.1263"></a>
+<span class="sourceLineNo">1264</span> }<a name="line.1264"></a>
+<span class="sourceLineNo">1265</span><a name="line.1265"></a>
+<span class="sourceLineNo">1266</span> /**<a name="line.1266"></a>
+<span class="sourceLineNo">1267</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1267"></a>
+<span class="sourceLineNo">1268</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1268"></a>
+<span class="sourceLineNo">1269</span> *<a name="line.1269"></a>
+<span class="sourceLineNo">1270</span> * <pre><a name="line.1270"></a>
+<span class="sourceLineNo">1271</span> * File f = ...<a name="line.1271"></a>
+<span class="sourceLineNo">1272</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1272"></a>
+<span class="sourceLineNo">1273</span> * // use the input stream<a name="line.1273"></a>
+<span class="sourceLineNo">1274</span> * } finally {<a name="line.1274"></a>
+<span class="sourceLineNo">1275</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1275"></a>
+<span class="sourceLineNo">1276</span> * }<a name="line.1276"></a>
+<span class="sourceLineNo">1277</span> * </pre><a name="line.1277"></a>
+<span class="sourceLineNo">1278</span> *<a name="line.1278"></a>
+<span class="sourceLineNo">1279</span> * @param file the file to read and delete<a name="line.1279"></a>
+<span class="sourceLineNo">1280</span> * @return a FileInputStream for the given file<a name="line.1280"></a>
+<span class="sourceLineNo">1281</span> * @throws IOException if there is a problem creating the stream<a name="line.1281"></a>
+<span class="sourceLineNo">1282</span> */<a name="line.1282"></a>
+<span class="sourceLineNo">1283</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1283"></a>
+<span class="sourceLineNo">1284</span> return new FileInputStream(file) {<a name="line.1284"></a>
+<span class="sourceLineNo">1285</span> private File myFile;<a name="line.1285"></a>
+<span class="sourceLineNo">1286</span><a name="line.1286"></a>
+<span class="sourceLineNo">1287</span> private FileInputStream init(File file) {<a name="line.1287"></a>
+<span class="sourceLineNo">1288</span> myFile = file;<a name="line.1288"></a>
+<span class="sourceLineNo">1289</span> return this;<a name="line.1289"></a>
+<span class="sourceLineNo">1290</span> }<a name="line.1290"></a>
+<span class="sourceLineNo">1291</span><a name="line.1291"></a>
+<span class="sourceLineNo">1292</span> @Override<a name="line.1292"></a>
+<span class="sourceLineNo">1293</span> public void close() throws IOException {<a name="line.1293"></a>
+<span class="sourceLineNo">1294</span> // close() will be called during try-with-resources and it will be<a name="line.1294"></a>
+<span class="sourceLineNo">1295</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1295"></a>
+<span class="sourceLineNo">1296</span> // set myFile to null after the first call.<a name="line.1296"></a>
+<span class="sourceLineNo">1297</span> if (myFile == null) {<a name="line.1297"></a>
+<span class="sourceLineNo">1298</span> return;<a name="line.1298"></a>
+<span class="sourceLineNo">1299</span> }<a name="line.1299"></a>
+<span class="sourceLineNo">1300</span><a name="line.1300"></a>
+<span class="sourceLineNo">1301</span> super.close();<a name="line.1301"></a>
+<span class="sourceLineNo">1302</span> if (!myFile.delete()) {<a name="line.1302"></a>
+<span class="sourceLineNo">1303</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1303"></a>
+<span class="sourceLineNo">1304</span> }<a name="line.1304"></a>
+<span class="sourceLineNo">1305</span> myFile = null;<a name="line.1305"></a>
+<span class="sourceLineNo">1306</span> }<a name="line.1306"></a>
+<span class="sourceLineNo">1307</span> }.init(file);<a name="line.1307"></a>
+<span class="sourceLineNo">1308</span> }<a name="line.1308"></a>
+<span class="sourceLineNo">1309</span><a name="line.1309"></a>
+<span class="sourceLineNo">1310</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1310"></a>
+<span class="sourceLineNo">1311</span> throws IOException {<a name="line.1311"></a>
+<span class="sourceLineNo">1312</span> if (capacitySize != cacheCapacity) {<a name="line.1312"></a>
+<span class="sourceLineNo">1313</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1313"></a>
+<span class="sourceLineNo">1314</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1314"></a>
+<span class="sourceLineNo">1315</span> }<a name="line.1315"></a>
+<span class="sourceLineNo">1316</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1316"></a>
+<span class="sourceLineNo">1317</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1317"></a>
+<span class="sourceLineNo">1318</span> + ioEngine.getClass().getName());<a name="line.1318"></a>
+<span class="sourceLineNo">1319</span> }<a name="line.1319"></a>
+<span class="sourceLineNo">1320</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1320"></a>
+<span class="sourceLineNo">1321</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1321"></a>
+<span class="sourceLineNo">1322</span> + backingMap.getClass().getName());<a name="line.1322"></a>
+<span class="sourceLineNo">1323</span> }<a name="line.1323"></a>
+<span class="sourceLineNo">1324</span> }<a name="line.1324"></a>
+<span class="sourceLineNo">1325</span><a name="line.1325"></a>
+<span class="sourceLineNo">1326</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1326"></a>
+<span class="sourceLineNo">1327</span> if (proto.hasChecksum()) {<a name="line.1327"></a>
+<span class="sourceLineNo">1328</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1328"></a>
+<span class="sourceLineNo">1329</span> algorithm);<a name="line.1329"></a>
+<span class="sourceLineNo">1330</span> } else {<a name="line.1330"></a>
+<span class="sourceLineNo">1331</span> // if has not checksum, it means the persistence file is old format<a name="line.1331"></a>
+<span class="sourceLineNo">1332</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1332"></a>
+<span class="sourceLineNo">1333</span> }<a name="line.1333"></a>
+<span class="sourceLineNo">1334</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1334"></a>
+<span class="sourceLineNo">1335</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1335"></a>
+<span class="sourceLineNo">1336</span> this::createRecycler);<a name="line.1336"></a>
+<span class="sourceLineNo">1337</span> }<a name="line.1337"></a>
+<span class="sourceLineNo">1338</span><a name="line.1338"></a>
+<span class="sourceLineNo">1339</span> /**<a name="line.1339"></a>
+<span class="sourceLineNo">1340</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1340"></a>
+<span class="sourceLineNo">1341</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1341"></a>
+<span class="sourceLineNo">1342</span> */<a name="line.1342"></a>
+<span class="sourceLineNo">1343</span> private void checkIOErrorIsTolerated() {<a name="line.1343"></a>
+<span class="sourceLineNo">1344</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1344"></a>
+<span class="sourceLineNo">1345</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1345"></a>
+<span class="sourceLineNo">1346</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1346"></a>
+<span class="sourceLineNo">1347</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1347"></a>
+<span class="sourceLineNo">1348</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1348"></a>
+<span class="sourceLineNo">1349</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1349"></a>
+<span class="sourceLineNo">1350</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1350"></a>
+<span class="sourceLineNo">1351</span> disableCache();<a name="line.1351"></a>
+<span class="sourceLineNo">1352</span> }<a name="line.1352"></a>
+<span class="sourceLineNo">1353</span> } else {<a name="line.1353"></a>
+<span class="sourceLineNo">1354</span> this.ioErrorStartTime = now;<a name="line.1354"></a>
+<span class="sourceLineNo">1355</span> }<a name="line.1355"></a>
+<span class="sourceLineNo">1356</span> }<a name="line.1356"></a>
+<span class="sourceLineNo">1357</span><a name="line.1357"></a>
+<span class="sourceLineNo">1358</span> /**<a name="line.1358"></a>
+<span class="sourceLineNo">1359</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1359"></a>
+<span class="sourceLineNo">1360</span> */<a name="line.1360"></a>
+<span class="sourceLineNo">1361</span> private void disableCache() {<a name="line.1361"></a>
+<span class="sourceLineNo">1362</span> if (!cacheEnabled) return;<a name="line.1362"></a>
+<span class="sourceLineNo">1363</span> cacheEnabled = false;<a name="line.1363"></a>
+<span class="sourceLineNo">1364</span> ioEngine.shutdown();<a name="line.1364"></a>
+<span class="sourceLineNo">1365</span> this.scheduleThreadPool.shutdown();<a name="line.1365"></a>
+<span class="sourceLineNo">1366</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1366"></a>
+<span class="sourceLineNo">1367</span> writerThreads[i].interrupt();<a name="line.1367"></a>
+<span class="sourceLineNo">1368</span> this.ramCache.clear();<a name="line.1368"></a>
+<span class="sourceLineNo">1369</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1369"></a>
+<span class="sourceLineNo">1370</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1370"></a>
+<span class="sourceLineNo">1371</span> this.backingMap.clear();<a name="line.1371"></a>
+<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
+<span class="sourceLineNo">1373</span> }<a name="line.1373"></a>
+<span class="sourceLineNo">1374</span><a name="line.1374"></a>
+<span class="sourceLineNo">1375</span> private void join() throws InterruptedException {<a name="line.1375"></a>
+<span class="sourceLineNo">1376</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1376"></a>
+<span class="sourceLineNo">1377</span> writerThreads[i].join();<a name="line.1377"></a>
+<span class="sourceLineNo">1378</span> }<a name="line.1378"></a>
+<span class="sourceLineNo">1379</span><a name="line.1379"></a>
+<span class="sourceLineNo">1380</span> @Override<a name="line.1380"></a>
+<span class="sourceLineNo">1381</span> public void shutdown() {<a name="line.1381"></a>
+<span class="sourceLineNo">1382</span> disableCache();<a name="line.1382"></a>
+<span class="sourceLineNo">1383</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1383"></a>
+<span class="sourceLineNo">1384</span> + persistencePath);<a name="line.1384"></a>
+<span class="sourceLineNo">1385</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1385"></a>
+<span class="sourceLineNo">1386</span> try {<a name="line.1386"></a>
+<span class="sourceLineNo">1387</span> join();<a name="line.1387"></a>
+<span class="sourceLineNo">1388</span> persistToFile();<a name="line.1388"></a>
+<span class="sourceLineNo">1389</span> } catch (IOException ex) {<a name="line.1389"></a>
+<span class="sourceLineNo">1390</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1390"></a>
+<span class="sourceLineNo">1391</span> } catch (InterruptedException e) {<a name="line.1391"></a>
+<span class="sourceLineNo">1392</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1392"></a>
+<span class="sourceLineNo">1393</span> }<a name="line.1393"></a>
+<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
+<span class="sourceLineNo">1395</span> }<a name="line.1395"></a>
+<span class="sourceLineNo">1396</span><a name="line.1396"></a>
+<span class="sourceLineNo">1397</span> @Override<a name="line.1397"></a>
+<span class="sourceLineNo">1398</span> public CacheStats getStats() {<a name="line.1398"></a>
+<span class="sourceLineNo">1399</span> return cacheStats;<a name="line.1399"></a>
+<span class="sourceLineNo">1400</span> }<a name="line.1400"></a>
+<span class="sourceLineNo">1401</span><a name="line.1401"></a>
+<span class="sourceLineNo">1402</span> public BucketAllocator getAllocator() {<a name="line.1402"></a>
+<span class="sourceLineNo">1403</span> return this.bucketAllocator;<a name="line.1403"></a>
+<span class="sourceLineNo">1404</span> }<a name="line.1404"></a>
+<span class="sourceLineNo">1405</span><a name="line.1405"></a>
+<span class="sourceLineNo">1406</span> @Override<a name="line.1406"></a>
+<span class="sourceLineNo">1407</span> public long heapSize() {<a name="line.1407"></a>
+<span class="sourceLineNo">1408</span> return this.heapSize.sum();<a name="line.1408"></a>
+<span class="sourceLineNo">1409</span> }<a name="line.1409"></a>
+<span class="sourceLineNo">1410</span><a name="line.1410"></a>
+<span class="sourceLineNo">1411</span> @Override<a name="line.1411"></a>
+<span class="sourceLineNo">1412</span> public long size() {<a name="line.1412"></a>
+<span class="sourceLineNo">1413</span> return this.realCacheSize.sum();<a name="line.1413"></a>
+<span class="sourceLineNo">1414</span> }<a name="line.1414"></a>
+<span class="sourceLineNo">1415</span><a name="line.1415"></a>
+<span class="sourceLineNo">1416</span> @Override<a name="line.1416"></a>
+<span class="sourceLineNo">1417</span> public long getCurrentDataSize() {<a name="line.1417"></a>
+<span class="sourceLineNo">1418</span> return size();<a name="line.1418"></a>
+<span class="sourceLineNo">1419</span> }<a name="line.1419"></a>
+<span class="sourceLineNo">1420</span><a name="line.1420"></a>
+<span class="sourceLineNo">1421</span> @Override<a name="line.1421"></a>
+<span class="sourceLineNo">1422</span> public long getFreeSize() {<a name="line.1422"></a>
+<span class="sourceLineNo">1423</span> return this.bucketAllocator.getFreeSize();<a name="line.1423"></a>
+<span class="sourceLineNo">1424</span> }<a name="line.1424"></a>
+<span class="sourceLineNo">1425</span><a name="line.1425"></a>
+<span class="sourceLineNo">1426</span> @Override<a name="line.1426"></a>
+<span class="sourceLineNo">1427</span> public long getBlockCount() {<a name="line.1427"></a>
+<span class="sourceLineNo">1428</span> return this.blockNumber.sum();<a name="line.1428"></a>
+<span class="sourceLineNo">1429</span> }<a name="line.1429"></a>
+<span class="sourceLineNo">1430</span><a name="line.1430"></a>
+<span class="sourceLineNo">1431</span> @Override<a name="line.1431"></a>
+<span class="sourceLineNo">1432</span> public long getDataBlockCount() {<a name="line.1432"></a>
+<span class="sourceLineNo">1433</span> return getBlockCount();<a name="line.1433"></a>
+<span class="sourceLineNo">1434</span> }<a name="line.1434"></a>
+<span class="sourceLineNo">1435</span><a name="line.1435"></a>
+<span class="sourceLineNo">1436</span> @Override<a name="line.1436"></a>
+<span class="sourceLineNo">1437</span> public long getCurrentSize() {<a name="line.1437"></a>
+<span class="sourceLineNo">1438</span> return this.bucketAllocator.getUsedSize();<a name="line.1438"></a>
+<span class="sourceLineNo">1439</span> }<a name="line.1439"></a>
+<span class="sourceLineNo">1440</span><a name="line.1440"></a>
+<span class="sourceLineNo">1441</span> protected String getAlgorithm() {<a name="line.1441"></a>
+<span class="sourceLineNo">1442</span> return algorithm;<a name="line.1442"></a>
+<span class="sourceLineNo">1443</span> }<a name="line.1443"></a>
+<span class="sourceLineNo">1444</span><a name="line.1444"></a>
+<span class="sourceLineNo">1445</span> /**<a name="line.1445"></a>
+<span class="sourceLineNo">1446</span> * Evicts all blocks for a specific HFile.<a name="line.1446"></a>
+<span class="sourceLineNo">1447</span> * <p><a name="line.1447"></a>
+<span class="sourceLineNo">1448</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1448"></a>
+<span class="sourceLineNo">1449</span> * @return the number of blocks evicted<a name="line.1449"></a>
+<span class="sourceLineNo">1450</span> */<a name="line.1450"></a>
+<span class="sourceLineNo">1451</span> @Override<a name="line.1451"></a>
+<span class="sourceLineNo">1452</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1452"></a>
+<span class="sourceLineNo">1453</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1453"></a>
+<span class="sourceLineNo">1454</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1454"></a>
+<span class="sourceLineNo">1455</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1455"></a>
+<span class="sourceLineNo">1456</span><a name="line.1456"></a>
+<span class="sourceLineNo">1457</span> int numEvicted = 0;<a name="line.1457"></a>
+<span class="sourceLineNo">1458</span> for (BlockCacheKey key : keySet) {<a name="line.1458"></a>
+<span class="sourceLineNo">1459</span> if (evictBlock(key)) {<a name="line.1459"></a>
+<span class="sourceLineNo">1460</span> ++numEvicted;<a name="line.1460"></a>
+<span class="sourceLineNo">1461</span> }<a name="line.1461"></a>
+<span class="sourceLineNo">1462</span> }<a name="line.1462"></a>
+<span class="sourceLineNo">1463</span><a name="line.1463"></a>
+<span class="sourceLineNo">1464</span> return numEvicted;<a name="line.1464"></a>
+<span class="sourceLineNo">1465</span> }<a name="line.1465"></a>
+<span class="sourceLineNo">1466</span><a name="line.1466"></a>
+<span class="sourceLineNo">1467</span> /**<a name="line.1467"></a>
+<span class="sourceLineNo">1468</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1468"></a>
+<span class="sourceLineNo">1469</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1469"></a>
+<span class="sourceLineNo">1470</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1470"></a>
+<span class="sourceLineNo">1471</span> */<a name="line.1471"></a>
+<span class="sourceLineNo">1472</span> private class BucketEntryGroup {<a name="line.1472"></a>
+<span class="sourceLineNo">1473</span><a name="line.1473"></a>
+<span class="sourceLineNo">1474</span> private CachedEntryQueue queue;<a name="line.1474"></a>
+<span class="sourceLineNo">1475</span> private long totalSize = 0;<a name="line.1475"></a>
+<span class="sourceLineNo">1476</span> private long bucketSize;<a name="line.1476"></a>
<span class="sourceLineNo">1477</span><a name="line.1477"></a>
-<span class="sourceLineNo">1478</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1478"></a>
-<span class="sourceLineNo">1479</span> totalSize += block.getValue().getLength();<a name="line.1479"></a>
-<span class="sourceLineNo">1480</span> queue.add(block);<a name="line.1480"></a>
-<span class="sourceLineNo">1481</span> }<a name="line.1481"></a>
-<span class="sourceLineNo">1482</span><a name="line.1482"></a>
-<span class="sourceLineNo">1483</span> public long free(long toFree) {<a name="line.1483"></a>
-<span class="sourceLineNo">1484</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1484"></a>
-<span class="sourceLineNo">1485</span> long freedBytes = 0;<a name="line.1485"></a>
-<span class="sourceLineNo">1486</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1486"></a>
-<span class="sourceLineNo">1487</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1487"></a>
-<span class="sourceLineNo">1488</span> while ((entry = queue.pollLast()) != null) {<a name="line.1488"></a>
-<span class="sourceLineNo">1489</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1489"></a>
-<span class="sourceLineNo">1490</span> BucketEntry be = entry.getValue();<a name="line.1490"></a>
-<span class="sourceLineNo">1491</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1491"></a>
-<span class="sourceLineNo">1492</span> freedBytes += be.getLength();<a name="line.1492"></a>
-<span class="sourceLineNo">1493</span> }<a name="line.1493"></a>
-<span class="sourceLineNo">1494</span> if (freedBytes >= toFree) {<a name="line.1494"></a>
-<span class="sourceLineNo">1495</span> return freedBytes;<a name="line.1495"></a>
-<span class="sourceLineNo">1496</span> }<a name="line.1496"></a>
-<span class="sourceLineNo">1497</span> }<a name="line.1497"></a>
-<span class="sourceLineNo">1498</span> return freedBytes;<a name="line.1498"></a>
-<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
-<span class="sourceLineNo">1500</span><a name="line.1500"></a>
-<span class="sourceLineNo">1501</span> public long overflow() {<a name="line.1501"></a>
-<span class="sourceLineNo">1502</span> return totalSize - bucketSize;<a name="line.1502"></a>
-<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
-<span class="sourceLineNo">1504</span><a name="line.1504"></a>
-<span class="sourceLineNo">1505</span> public long totalSize() {<a name="line.1505"></a>
-<span class="sourceLineNo">1506</span> return totalSize;<a name="line.1506"></a>
-<span class="sourceLineNo">1507</span> }<a name="line.1507"></a>
-<span class="sourceLineNo">1508</span> }<a name="line.1508"></a>
-<span class="sourceLineNo">1509</span><a name="line.1509"></a>
-<span class="sourceLineNo">1510</span> /**<a name="line.1510"></a>
-<span class="sourceLineNo">1511</span> * Block Entry stored in the memory with key,data and so on<a name="line.1511"></a>
-<span class="sourceLineNo">1512</span> */<a name="line.1512"></a>
-<span class="sourceLineNo">1513</span> static class RAMQueueEntry {<a name="line.1513"></a>
-<span class="sourceLineNo">1514</span> private final BlockCacheKey key;<a name="line.1514"></a>
-<span class="sourceLineNo">1515</span> private final Cacheable data;<a name="line.1515"></a>
-<span class="sourceLineNo">1516</span> private long accessCounter;<a name="line.1516"></a>
-<span class="sourceLineNo">1517</span> private boolean inMemory;<a name="line.1517"></a>
-<span class="sourceLineNo">1518</span><a name="line.1518"></a>
-<span class="sourceLineNo">1519</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1519"></a>
-<span class="sourceLineNo">1520</span> this.key = bck;<a name="line.1520"></a>
-<span class="sourceLineNo">1521</span> this.data = data;<a name="line.1521"></a>
-<span class="sourceLineNo">1522</span> this.accessCounter = accessCounter;<a name="line.1522"></a>
-<span class="sourceLineNo">1523</span> this.inMemory = inMemory;<a name="line.1523"></a>
-<span class="sourceLineNo">1524</span> }<a name="line.1524"></a>
-<span class="sourceLineNo">1525</span><a name="line.1525"></a>
-<span class="sourceLineNo">1526</span> public Cacheable getData() {<a name="line.1526"></a>
-<span class="sourceLineNo">1527</span> return data;<a name="line.1527"></a>
-<span class="sourceLineNo">1528</span> }<a name="line.1528"></a>
-<span class="sourceLineNo">1529</span><a name="line.1529"></a>
-<span class="sourceLineNo">1530</span> public BlockCacheKey getKey() {<a name="line.1530"></a>
-<span class="sourceLineNo">1531</span> return key;<a name="line.1531"></a>
-<span class="sourceLineNo">1532</span> }<a name="line.1532"></a>
-<span class="sourceLineNo">1533</span><a name="line.1533"></a>
-<span class="sourceLineNo">1534</span> public void access(long accessCounter) {<a name="line.1534"></a>
-<span class="sourceLineNo">1535</span> this.accessCounter = accessCounter;<a name="line.1535"></a>
-<span class="sourceLineNo">1536</span> }<a name="line.1536"></a>
-<span class="sourceLineNo">1537</span><a name="line.1537"></a>
-<span class="sourceLineNo">1538</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1538"></a>
-<span class="sourceLineNo">1539</span> if (data instanceof HFileBlock) {<a name="line.1539"></a>
-<span class="sourceLineNo">1540</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1540"></a>
-<span class="sourceLineNo">1541</span> }<a name="line.1541"></a>
-<span class="sourceLineNo">1542</span> return ByteBuffAllocator.HEAP;<a name="line.1542"></a>
-<span class="sourceLineNo">1543</span> }<a name="line.1543"></a>
-<span class="sourceLineNo">1544</span><a name="line.1544"></a>
-<span class="sourceLineNo">1545</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1545"></a>
-<span class="sourceLineNo">1546</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1546"></a>
-<span class="sourceLineNo">1547</span> ByteBuffer metaBuff) throws IOException {<a name="line.1547"></a>
-<span class="sourceLineNo">1548</span> int len = data.getSerializedLength();<a name="line.1548"></a>
-<span class="sourceLineNo">1549</span> // This cacheable thing can't be serialized<a name="line.1549"></a>
-<span class="sourceLineNo">1550</span> if (len == 0) {<a name="line.1550"></a>
-<span class="sourceLineNo">1551</span> return null;<a name="line.1551"></a>
-<span class="sourceLineNo">1552</span> }<a name="line.1552"></a>
-<span class="sourceLineNo">1553</span> long offset = alloc.allocateBlock(len);<a name="line.1553"></a>
-<span class="sourceLineNo">1554</span> boolean succ = false;<a name="line.1554"></a>
-<span class="sourceLineNo">1555</span> BucketEntry bucketEntry = null;<a name="line.1555"></a>
-<span class="sourceLineNo">1556</span> try {<a name="line.1556"></a>
-<span class="sourceLineNo">1557</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1557"></a>
-<span class="sourceLineNo">1558</span> getByteBuffAllocator());<a name="line.1558"></a>
-<span class="sourceLineNo">1559</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1559"></a>
-<span class="sourceLineNo">1560</span> if (data instanceof HFileBlock) {<a name="line.1560"></a>
-<span class="sourceLineNo">1561</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1561"></a>
-<span class="sourceLineNo">1562</span> HFileBlock block = (HFileBlock) data;<a name="line.1562"></a>
-<span class="sourceLineNo">1563</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1563"></a>
-<span class="sourceLineNo">1564</span> block.getMetaData(metaBuff);<a name="line.1564"></a>
-<span class="sourceLineNo">1565</span> ioEngine.write(sliceBuf, offset);<a name="line.1565"></a>
-<span class="sourceLineNo">1566</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1566"></a>
-<span class="sourceLineNo">1567</span> } else {<a name="line.1567"></a>
-<span class="sourceLineNo">1568</span> // Only used for testing.<a name="line.1568"></a>
-<span class="sourceLineNo">1569</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1569"></a>
-<span class="sourceLineNo">1570</span> data.serialize(bb, true);<a name="line.1570"></a>
-<span class="sourceLineNo">1571</span> ioEngine.write(bb, offset);<a name="line.1571"></a>
-<span class="sourceLineNo">1572</span> }<a name="line.1572"></a>
-<span class="sourceLineNo">1573</span> succ = true;<a name="line.1573"></a>
-<span class="sourceLineNo">1574</span> } finally {<a name="line.1574"></a>
-<span class="sourceLineNo">1575</span> if (!succ) {<a name="line.1575"></a>
-<span class="sourceLineNo">1576</span> alloc.freeBlock(offset, len);<a name="line.1576"></a>
-<span class="sourceLineNo">1577</span> }<a name="line.1577"></a>
-<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
-<span class="sourceLineNo">1579</span> realCacheSize.add(len);<a name="line.1579"></a>
-<span class="sourceLineNo">1580</span> return bucketEntry;<a name="line.1580"></a>
-<span class="sourceLineNo">1581</span> }<a name="line.1581"></a>
-<span class="sourceLineNo">1582</span> }<a name="line.1582"></a>
-<span class="sourceLineNo">1583</span><a name="line.1583"></a>
-<span class="sourceLineNo">1584</span> /**<a name="line.1584"></a>
-<span class="sourceLineNo">1585</span> * Only used in test<a name="line.1585"></a>
-<span class="sourceLineNo">1586</span> */<a name="line.1586"></a>
-<span class="sourceLineNo">1587</span> void stopWriterThreads() throws InterruptedException {<a name="line.1587"></a>
-<span class="sourceLineNo">1588</span> for (WriterThread writerThread : writerThreads) {<a name="line.1588"></a>
-<span class="sourceLineNo">1589</span> writerThread.disableWriter();<a name="line.1589"></a>
-<span class="sourceLineNo">1590</span> writerThread.interrupt();<a name="line.1590"></a>
-<span class="sourceLineNo">1591</span> writerThread.join();<a name="line.1591"></a>
-<span class="sourceLineNo">1592</span> }<a name="line.1592"></a>
-<span class="sourceLineNo">1593</span> }<a name="line.1593"></a>
-<span class="sourceLineNo">1594</span><a name="line.1594"></a>
-<span class="sourceLineNo">1595</span> @Override<a name="line.1595"></a>
-<span class="sourceLineNo">1596</span> public Iterator<CachedBlock> iterator() {<a name="line.1596"></a>
-<span class="sourceLineNo">1597</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1597"></a>
-<span class="sourceLineNo">1598</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1598"></a>
-<span class="sourceLineNo">1599</span> return new Iterator<CachedBlock>() {<a name="line.1599"></a>
-<span class="sourceLineNo">1600</span> private final long now = System.nanoTime();<a name="line.1600"></a>
-<span class="sourceLineNo">1601</span><a name="line.1601"></a>
-<span class="sourceLineNo">1602</span> @Override<a name="line.1602"></a>
-<span class="sourceLineNo">1603</span> public boolean hasNext() {<a name="line.1603"></a>
-<span class="sourceLineNo">1604</span> return i.hasNext();<a name="line.1604"></a>
-<span class="sourceLineNo">1605</span> }<a name="line.1605"></a>
-<span class="sourceLineNo">1606</span><a name="line.1606"></a>
-<span class="sourceLineNo">1607</span> @Override<a name="line.1607"></a>
-<span class="sourceLineNo">1608</span> public CachedBlock next() {<a name="line.1608"></a>
-<span class="sourceLineNo">1609</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1609"></a>
-<span class="sourceLineNo">1610</span> return new CachedBlock() {<a name="line.1610"></a>
-<span class="sourceLineNo">1611</span> @Override<a name="line.1611"></a>
-<span class="sourceLineNo">1612</span> public String toString() {<a name="line.1612"></a>
-<span class="sourceLineNo">1613</span> return BlockCacheUtil.toString(this, now);<a name="line.1613"></a>
-<span class="sourceLineNo">1614</span> }<a name="line.1614"></a>
-<span class="sourceLineNo">1615</span><a name="line.1615"></a>
-<span class="sourceLineNo">1616</span> @Override<a name="line.1616"></a>
-<span class="sourceLineNo">1617</span> public BlockPriority getBlockPriority() {<a name="line.1617"></a>
-<span class="sourceLineNo">1618</span> return e.getValue().getPriority();<a name="line.1618"></a>
-<span class="sourceLineNo">1619</span> }<a name="line.1619"></a>
-<span class="sourceLineNo">1620</span><a name="line.1620"></a>
-<span class="sourceLineNo">1621</span> @Override<a name="line.1621"></a>
-<span class="sourceLineNo">1622</span> public BlockType getBlockType() {<a name="line.1622"></a>
-<span class="sourceLineNo">1623</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1623"></a>
-<span class="sourceLineNo">1624</span> return null;<a name="line.1624"></a>
+<span class="sourceLineNo">1478</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1478"></a>
+<span class="sourceLineNo">1479</span> this.bucketSize = bucketSize;<a name="line.1479"></a>
+<span class="sourceLineNo">1480</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1480"></a>
+<span class="sourceLineNo">1481</span> totalSize = 0;<a name="line.1481"></a>
+<span class="sourceLineNo">1482</span> }<a name="line.1482"></a>
+<span class="sourceLineNo">1483</span><a name="line.1483"></a>
+<span class="sourceLineNo">1484</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1484"></a>
+<span class="sourceLineNo">1485</span> totalSize += block.getValue().getLength();<a name="line.1485"></a>
+<span class="sourceLineNo">1486</span> queue.add(block);<a name="line.1486"></a>
+<span class="sourceLineNo">1487</span> }<a name="line.1487"></a>
+<span class="sourceLineNo">1488</span><a name="line.1488"></a>
+<span class="sourceLineNo">1489</span> public long free(long toFree) {<a name="line.1489"></a>
+<span class="sourceLineNo">1490</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1490"></a>
+<span class="sourceLineNo">1491</span> long freedBytes = 0;<a name="line.1491"></a>
+<span class="sourceLineNo">1492</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1492"></a>
+<span class="sourceLineNo">1493</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1493"></a>
+<span class="sourceLineNo">1494</span> while ((entry = queue.pollLast()) != null) {<a name="line.1494"></a>
+<span class="sourceLineNo">1495</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1495"></a>
+<span class="sourceLineNo">1496</span> BucketEntry be = entry.getValue();<a name="line.1496"></a>
+<span class="sourceLineNo">1497</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1497"></a>
+<span class="sourceLineNo">1498</span> freedBytes += be.getLength();<a name="line.1498"></a>
+<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
+<span class="sourceLineNo">1500</span> if (freedBytes >= toFree) {<a name="line.1500"></a>
+<span class="sourceLineNo">1501</span> return freedBytes;<a name="line.1501"></a>
+<span class="sourceLineNo">1502</span> }<a name="line.1502"></a>
+<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
+<span class="sourceLineNo">1504</span> return freedBytes;<a name="line.1504"></a>
+<span class="sourceLineNo">1505</span> }<a name="line.1505"></a>
+<span class="sourceLineNo">1506</span><a name="line.1506"></a>
+<span class="sourceLineNo">1507</span> public long overflow() {<a name="line.1507"></a>
+<span class="sourceLineNo">1508</span> return totalSize - bucketSize;<a name="line.1508"></a>
+<span class="sourceLineNo">1509</span> }<a name="line.1509"></a>
+<span class="sourceLineNo">1510</span><a name="line.1510"></a>
+<span class="sourceLineNo">1511</span> public long totalSize() {<a name="line.1511"></a>
+<span class="sourceLineNo">1512</span> return totalSize;<a name="line.1512"></a>
+<span class="sourceLineNo">1513</span> }<a name="line.1513"></a>
+<span class="sourceLineNo">1514</span> }<a name="line.1514"></a>
+<span class="sourceLineNo">1515</span><a name="line.1515"></a>
+<span class="sourceLineNo">1516</span> /**<a name="line.1516"></a>
+<span class="sourceLineNo">1517</span> * Block Entry stored in the memory with key,data and so on<a name="line.1517"></a>
+<span class="sourceLineNo">1518</span> */<a name="line.1518"></a>
+<span class="sourceLineNo">1519</span> static class RAMQueueEntry {<a name="line.1519"></a>
+<span class="sourceLineNo">1520</span> private final BlockCacheKey key;<a name="line.1520"></a>
+<span class="sourceLineNo">1521</span> private final Cacheable data;<a name="line.1521"></a>
+<span class="sourceLineNo">1522</span> private long accessCounter;<a name="line.1522"></a>
+<span class="sourceLineNo">1523</span> private boolean inMemory;<a name="line.1523"></a>
+<span class="sourceLineNo">1524</span><a name="line.1524"></a>
+<span class="sourceLineNo">1525</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1525"></a>
+<span class="sourceLineNo">1526</span> this.key = bck;<a name="line.1526"></a>
+<span class="sourceLineNo">1527</span> this.data = data;<a name="line.1527"></a>
+<span class="sourceLineNo">1528</span> this.accessCounter = accessCounter;<a name="line.1528"></a>
+<span class="sourceLineNo">1529</span> this.inMemory = inMemory;<a name="line.1529"></a>
+<span class="sourceLineNo">1530</span> }<a name="line.1530"></a>
+<span class="sourceLineNo">1531</span><a name="line.1531"></a>
+<span class="sourceLineNo">1532</span> public Cacheable getData() {<a name="line.1532"></a>
+<span class="sourceLineNo">1533</span> return data;<a name="line.1533"></a>
+<span class="sourceLineNo">1534</span> }<a name="line.1534"></a>
+<span class="sourceLineNo">1535</span><a name="line.1535"></a>
+<span class="sourceLineNo">1536</span> public BlockCacheKey getKey() {<a name="line.1536"></a>
+<span class="sourceLineNo">1537</span> return key;<a name="line.1537"></a>
+<span class="sourceLineNo">1538</span> }<a name="line.1538"></a>
+<span class="sourceLineNo">1539</span><a name="line.1539"></a>
+<span class="sourceLineNo">1540</span> public void access(long accessCounter) {<a name="line.1540"></a>
+<span class="sourceLineNo">1541</span> this.accessCounter = accessCounter;<a name="line.1541"></a>
+<span class="sourceLineNo">1542</span> }<a name="line.1542"></a>
+<span class="sourceLineNo">1543</span><a name="line.1543"></a>
+<span class="sourceLineNo">1544</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1544"></a>
+<span class="sourceLineNo">1545</span> if (data instanceof HFileBlock) {<a name="line.1545"></a>
+<span class="sourceLineNo">1546</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1546"></a>
+<span class="sourceLineNo">1547</span> }<a name="line.1547"></a>
+<span class="sourceLineNo">1548</span> return ByteBuffAllocator.HEAP;<a name="line.1548"></a>
+<span class="sourceLineNo">1549</span> }<a name="line.1549"></a>
+<span class="sourceLineNo">1550</span><a name="line.1550"></a>
+<span class="sourceLineNo">1551</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1551"></a>
+<span class="sourceLineNo">1552</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1552"></a>
+<span class="sourceLineNo">1553</span> ByteBuffer metaBuff) throws IOException {<a name="line.1553"></a>
+<span class="sourceLineNo">1554</span> int len = data.getSerializedLength();<a name="line.1554"></a>
+<span class="sourceLineNo">1555</span> // This cacheable thing can't be serialized<a name="line.1555"></a>
+<span class="sourceLineNo">1556</span> if (len == 0) {<a name="line.1556"></a>
+<span class="sourceLineNo">1557</span> return null;<a name="line.1557"></a>
+<span class="sourceLineNo">1558</span> }<a name="line.1558"></a>
+<span class="sourceLineNo">1559</span> long offset = alloc.allocateBlock(len);<a name="line.1559"></a>
+<span class="sourceLineNo">1560</span> boolean succ = false;<a name="line.1560"></a>
+<span class="sourceLineNo">1561</span> BucketEntry bucketEntry = null;<a name="line.1561"></a>
+<span class="sourceLineNo">1562</span> try {<a name="line.1562"></a>
+<span class="sourceLineNo">1563</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1563"></a>
+<span class="sourceLineNo">1564</span> getByteBuffAllocator());<a name="line.1564"></a>
+<span class="sourceLineNo">1565</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1565"></a>
+<span class="sourceLineNo">1566</span> if (data instanceof HFileBlock) {<a name="line.1566"></a>
+<span class="sourceLineNo">1567</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1567"></a>
+<span class="sourceLineNo">1568</span> HFileBlock block = (HFileBlock) data;<a name="line.1568"></a>
+<span class="sourceLineNo">1569</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1569"></a>
+<span class="sourceLineNo">1570</span> block.getMetaData(metaBuff);<a name="line.1570"></a>
+<span class="sourceLineNo">1571</span> ioEngine.write(sliceBuf, offset);<a name="line.1571"></a>
+<span class="sourceLineNo">1572</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1572"></a>
+<span class="sourceLineNo">1573</span> } else {<a name="line.1573"></a>
+<span class="sourceLineNo">1574</span> // Only used for testing.<a name="line.1574"></a>
+<span class="sourceLineNo">1575</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1575"></a>
+<span class="sourceLineNo">1576</span> data.serialize(bb, true);<a name="line.1576"></a>
+<span class="sourceLineNo">1577</span> ioEngine.write(bb, offset);<a name="line.1577"></a>
+<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
+<span class="sourceLineNo">1579</span> succ = true;<a name="line.1579"></a>
+<span class="sourceLineNo">1580</span> } finally {<a name="line.1580"></a>
+<span class="sourceLineNo">1581</span> if (!succ) {<a name="line.1581"></a>
+<span class="sourceLineNo">1582</span> alloc.freeBlock(offset, len);<a name="line.1582"></a>
+<span class="sourceLineNo">1583</span> }<a name="line.1583"></a>
+<span class="sourceLineNo">1584</span> }<a name="line.1584"></a>
+<span class="sourceLineNo">1585</span> realCacheSize.add(len);<a name="line.1585"></a>
+<span class="sourceLineNo">1586</span> return bucketEntry;<a name="line.1586"></a>
+<span class="sourceLineNo">1587</span> }<a name="line.1587"></a>
+<span class="sourceLineNo">1588</span> }<a name="line.1588"></a>
+<span class="sourceLineNo">1589</span><a name="line.1589"></a>
+<span class="sourceLineNo">1590</span> /**<a name="line.1590"></a>
+<span class="sourceLineNo">1591</span> * Only used in test<a name="line.1591"></a>
+<span class="sourceLineNo">1592</span> */<a name="line.1592"></a>
+<span class="sourceLineNo">1593</span> void stopWriterThreads() throws InterruptedException {<a name="line.1593"></a>
+<span class="sourceLineNo">1594</span> for (WriterThread writerThread : writerThreads) {<a name="line.1594"></a>
+<span class="sourceLineNo">1595</span> writerThread.disableWriter();<a name="line.1595"></a>
+<span class="sourceLineNo">1596</span> writerThread.interrupt();<a name="line.1596"></a>
+<span class="sourceLineNo">1597</span> writerThread.join();<a name="line.1597"></a>
+<span class="sourceLineNo">1598</span> }<a name="line.1598"></a>
+<span class="sourceLineNo">1599</span> }<a name="line.1599"></a>
+<span class="sourceLineNo">1600</span><a name="line.1600"></a>
+<span class="sourceLineNo">1601</span> @Override<a name="line.1601"></a>
+<span class="sourceLineNo">1602</span> public Iterator<CachedBlock> iterator() {<a name="line.1602"></a>
+<span class="sourceLineNo">1603</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1603"></a>
+<span class="sourceLineNo">1604</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1604"></a>
+<span class="sourceLineNo">1605</span> return new Iterator<CachedBlock>() {<a name="line.1605"></a>
+<span class="sourceLineNo">1606</span> private final long now = System.nanoTime();<a name="line.1606"></a>
+<span class="sourceLineNo">1607</span><a name="line.1607"></a>
+<span class="sourceLineNo">1608</span> @Override<a name="line.1608"></a>
+<span class="sourceLineNo">1609</span> public boolean hasNext() {<a name="line.1609"></a>
+<span class="sourceLineNo">1610</span> return i.hasNext();<a name="line.1610"></a>
+<span class="sourceLineNo">1611</span> }<a name="line.1611"></a>
+<span class="sourceLineNo">1612</span><a name="line.1612"></a>
+<span class="sourceLineNo">1613</span> @Override<a name="line.1613"></a>
+<span class="sourceLineNo">1614</span> public CachedBlock next() {<a name="line.1614"></a>
+<span class="sourceLineNo">1615</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1615"></a>
+<span class="sourceLineNo">1616</span> return new CachedBlock() {<a name="line.1616"></a>
+<span class="sourceLineNo">1617</span> @Override<a name="line.1617"></a>
+<span class="sourceLineNo">1618</span> public String toString() {<a name="line.1618"></a>
+<span class="sourceLineNo">1619</span> return BlockCacheUtil.toString(this, now);<a name="line.1619"></a>
+<span class="sourceLineNo">1620</span> }<a name="line.1620"></a>
+<span class="sourceLineNo">1621</span><a name="line.1621"></a>
+<span class="sourceLineNo">1622</span> @Override<a name="line.1622"></a>
+<span class="sourceLineNo">1623</span> public BlockPriority getBlockPriority() {<a name="line.1623"></a>
+<span class="sourceLineNo">1624</span> return e.getValue().getPriority();<a name="line.1624"></a>
<span class="sourceLineNo">1625</span> }<a name="line.1625"></a>
<span class="sourceLineNo">1626</span><a name="line.1626"></a>
<span class="sourceLineNo">1627</span> @Override<a name="line.1627"></a>
-<span class="sourceLineNo">1628</span> public long getOffset() {<a name="line.1628"></a>
-<span class="sourceLineNo">1629</span> return e.getKey().getOffset();<a name="line.1629"></a>
-<span class="sourceLineNo">1630</span> }<a name="line.1630"></a>
-<span class="sourceLineNo">1631</span><a name="line.1631"></a>
-<span class="sourceLineNo">1632</span> @Override<a name="line.1632"></a>
-<span class="sourceLineNo">1633</span> public long getSize() {<a name="line.1633"></a>
-<span class="sourceLineNo">1634</span> return e.getValue().getLength();<a name="line.1634"></a>
-<span class="sourceLineNo">1635</span> }<a name="line.1635"></a>
-<span class="sourceLineNo">1636</span><a name="line.1636"></a>
-<span class="sourceLineNo">1637</span> @Override<a name="line.1637"></a>
-<span class="sourceLineNo">1638</span> public long getCachedTime() {<a name="line.1638"></a>
-<span class="sourceLineNo">1639</span> return e.getValue().getCachedTime();<a name="line.1639"></a>
-<span class="sourceLineNo">1640</span> }<a name="line.1640"></a>
-<span class="sourceLineNo">1641</span><a name="line.1641"></a>
-<span class="sourceLineNo">1642</span> @Override<a name="line.1642"></a>
-<span class="sourceLineNo">1643</span> public String getFilename() {<a name="line.1643"></a>
-<span class="sourceLineNo">1644</span> return e.getKey().getHfileName();<a name="line.1644"></a>
-<span class="sourceLineNo">1645</span> }<a name="line.1645"></a>
-<span class="sourceLineNo">1646</span><a name="line.1646"></a>
-<span class="sourceLineNo">1647</span> @Override<a name="line.1647"></a>
-<span class="sourceLineNo">1648</span> public int compareTo(CachedBlock other) {<a name="line.1648"></a>
-<span class="sourceLineNo">1649</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1649"></a>
-<span class="sourceLineNo">1650</span> if (diff != 0) return diff;<a name="line.1650"></a>
-<span class="sourceLineNo">1651</span><a name="line.1651"></a>
-<span class="sourceLineNo">1652</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1652"></a>
-<span class="sourceLineNo">1653</span> if (diff != 0) return diff;<a name="line.1653"></a>
-<span class="sourceLineNo">1654</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1654"></a>
-<span class="sourceLineNo">1655</span> throw new IllegalStateException(<a name="line.1655"></a>
-<span class="sourceLineNo">1656</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1656"></a>
-<span class="sourceLineNo">1657</span> }<a name="line.1657"></a>
-<span class="sourceLineNo">1658</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1658"></a>
-<span class="sourceLineNo">1659</span> }<a name="line.1659"></a>
-<span class="sourceLineNo">1660</span><a name="line.1660"></a>
-<span class="sourceLineNo">1661</span> @Override<a name="line.1661"></a>
-<span class="sourceLineNo">1662</span> public int hashCode() {<a name="line.1662"></a>
-<span class="sourceLineNo">1663</span> return e.getKey().hashCode();<a name="line.1663"></a>
-<span class="sourceLineNo">1664</span> }<a name="line.1664"></a>
-<span class="sourceLineNo">1665</span><a name="line.1665"></a>
-<span class="sourceLineNo">1666</span> @Override<a name="line.1666"></a>
-<span class="sourceLineNo">1667</span> public boolean equals(Object obj) {<a name="line.1667"></a>
-<span class="sourceLineNo">1668</span> if (obj instanceof CachedBlock) {<a name="line.1668"></a>
-<span class="sourceLineNo">1669</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1669"></a>
-<span class="sourceLineNo">1670</span> return compareTo(cb) == 0;<a name="line.1670"></a>
-<span class="sourceLineNo">1671</span> } else {<a name="line.1671"></a>
-<span class="sourceLineNo">1672</span> return false;<a name="line.1672"></a>
-<span class="sourceLineNo">1673</span> }<a name="line.1673"></a>
-<span class="sourceLineNo">1674</span> }<a name="line.1674"></a>
-<span class="sourceLineNo">1675</span> };<a name="line.1675"></a>
-<span class="sourceLineNo">1676</span> }<a name="line.1676"></a>
-<span class="sourceLineNo">1677</span><a name="line.1677"></a>
-<span class="sourceLineNo">1678</span> @Override<a name="line.1678"></a>
-<span class="sourceLineNo">1679</span> public void remove() {<a name="line.1679"></a>
-<span class="sourceLineNo">1680</span> throw new UnsupportedOperationException();<a name="line.1680"></a>
-<span class="sourceLineNo">1681</span> }<a name="line.1681"></a>
-<span class="sourceLineNo">1682</span> };<a name="line.1682"></a>
-<span class="sourceLineNo">1683</span> }<a name="line.1683"></a>
-<span class="sourceLineNo">1684</span><a name="line.1684"></a>
-<span class="sourceLineNo">1685</span> @Override<a name="line.1685"></a>
-<span class="sourceLineNo">1686</span> public BlockCache[] getBlockCaches() {<a name="line.1686"></a>
-<span class="sourceLineNo">1687</span> return null;<a name="line.1687"></a>
-<span class="sourceLineNo">1688</span> }<a name="line.1688"></a>
-<span class="sourceLineNo">1689</span><a name="line.1689"></a>
-<span class="sourceLineNo">1690</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1690"></a>
-<span class="sourceLineNo">1691</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1691"></a>
-<span class="sourceLineNo">1692</span> if (bucketEntry != null) {<a name="line.1692"></a>
-<span class="sourceLineNo">1693</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1693"></a>
-<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
-<span class="sourceLineNo">1695</span> return 0;<a name="line.1695"></a>
-<span class="sourceLineNo">1696</span> }<a name="line.1696"></a>
-<span class="sourceLineNo">1697</span><a name="line.1697"></a>
-<span class="sourceLineNo">1698</span> float getAcceptableFactor() {<a name="line.1698"></a>
-<span class="sourceLineNo">1699</span> return acceptableFactor;<a name="line.1699"></a>
-<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
-<span class="sourceLineNo">1701</span><a name="line.1701"></a>
-<span class="sourceLineNo">1702</span> float getMinFactor() {<a name="line.1702"></a>
-<span class="sourceLineNo">1703</span> return minFactor;<a name="line.1703"></a>
-<span class="sourceLineNo">1704</span> }<a name="line.1704"></a>
-<span class="sourceLineNo">1705</span><a name="line.1705"></a>
-<span class="sourceLineNo">1706</span> float getExtraFreeFactor() {<a name="line.1706"></a>
-<span class="sourceLineNo">1707</span> return extraFreeFactor;<a name="line.1707"></a>
-<span class="sourceLineNo">1708</span> }<a name="line.1708"></a>
-<span class="sourceLineNo">1709</span><a name="line.1709"></a>
-<span class="sourceLineNo">1710</span> float getSingleFactor() {<a name="line.1710"></a>
-<span class="sourceLineNo">1711</span> return singleFactor;<a name="line.1711"></a>
-<span class="sourceLineNo">1712</span> }<a name="line.1712"></a>
-<span class="sourceLineNo">1713</span><a name="line.1713"></a>
-<span class="sourceLineNo">1714</span> float getMultiFactor() {<a name="line.1714"></a>
-<span class="sourceLineNo">1715</span> return multiFactor;<a name="line.1715"></a>
-<span class="sourceLineNo">1716</span> }<a name="line.1716"></a>
-<span class="sourceLineNo">1717</span><a name="line.1717"></a>
-<span class="sourceLineNo">1718</span> float getMemoryFactor() {<a name="line.1718"></a>
-<span class="sourceLineNo">1719</span> return memoryFactor;<a name="line.1719"></a>
-<span class="sourceLineNo">1720</span> }<a name="line.1720"></a>
-<span class="sourceLineNo">1721</span><a name="line.1721"></a>
-<span class="sourceLineNo">1722</span> /**<a name="line.1722"></a>
-<span class="sourceLineNo">1723</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1723"></a>
-<span class="sourceLineNo">1724</span> */<a name="line.1724"></a>
-<span class="sourceLineNo">1725</span> static class RAMCache {<a name="line.1725"></a>
-<span class="sourceLineNo">1726</span> /**<a name="line.1726"></a>
-<span class="sourceLineNo">1727</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1727"></a>
-<span class="sourceLineNo">1728</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1728"></a>
-<span class="sourceLineNo">1729</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1729"></a>
-<span class="sourceLineNo">1730</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1730"></a>
-<span class="sourceLineNo">1731</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1731"></a>
-<span class="sourceLineNo">1732</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1732"></a>
-<span class="sourceLineNo">1733</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1733"></a>
-<span class="sourceLineNo">1734</span> */<a name="line.1734"></a>
-<span class="sourceLineNo">1735</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1735"></a>
-<span class="sourceLineNo">1736</span><a name="line.1736"></a>
-<span class="sourceLineNo">1737</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1737"></a>
-<span class="sourceLineNo">1738</span> return delegate.containsKey(key);<a name="line.1738"></a>
-<span class="sourceLineNo">1739</span> }<a name="line.1739"></a>
-<span class="sourceLineNo">1740</span><a name="line.1740"></a>
-<span class="sourceLineNo">1741</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1741"></a>
-<span class="sourceLineNo">1742</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1742"></a>
-<span class="sourceLineNo">1743</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1743"></a>
-<span class="sourceLineNo">1744</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1744"></a>
-<span class="sourceLineNo">1745</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1745"></a>
-<span class="sourceLineNo">1746</span> re.getData().retain();<a name="line.1746"></a>
-<span class="sourceLineNo">1747</span> return re;<a name="line.1747"></a>
-<span class="sourceLineNo">1748</span> });<a name="line.1748"></a>
-<span class="sourceLineNo">1749</span> }<a name="line.1749"></a>
-<span class="sourceLineNo">1750</span><a name="line.1750"></a>
-<span class="sourceLineNo">1751</span> /**<a name="line.1751"></a>
-<span class="sourceLineNo">1752</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1752"></a>
-<span class="sourceLineNo">1753</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1753"></a>
-<span class="sourceLineNo">1754</span> */<a name="line.1754"></a>
-<span class="sourceLineNo">1755</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1755"></a>
-<span class="sourceLineNo">1756</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1756"></a>
-<span class="sourceLineNo">1757</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1757"></a>
-<span class="sourceLineNo">1758</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1758"></a>
-<span class="sourceLineNo">1759</span> entry.getData().retain();<a name="line.1759"></a>
-<span class="sourceLineNo">1760</span> absent.set(true);<a name="line.1760"></a>
-<span class="sourceLineNo">1761</span> return entry;<a name="line.1761"></a>
-<span class="sourceLineNo">1762</span> });<a name="line.1762"></a>
-<span class="sourceLineNo">1763</span> return absent.get() ? null : re;<a name="line.1763"></a>
-<span class="sourceLineNo">1764</span> }<a name="line.1764"></a>
-<span class="sourceLineNo">1765</span><a name="line.1765"></a>
-<span class="sourceLineNo">1766</span> public boolean remove(BlockCacheKey key) {<a name="line.1766"></a>
-<span class="sourceLineNo">1767</span> return remove(key, re -> {<a name="line.1767"></a>
+<span class="sourceLineNo">1628</span> public BlockType getBlockType() {<a name="line.1628"></a>
+<span class="sourceLineNo">1629</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1629"></a>
+<span class="sourceLineNo">1630</span> return null;<a name="line.1630"></a>
+<span class="sourceLineNo">1631</span> }<a name="line.1631"></a>
+<span class="sourceLineNo">1632</span><a name="line.1632"></a>
+<span class="sourceLineNo">1633</span> @Override<a name="line.1633"></a>
+<span class="sourceLineNo">1634</span> public long getOffset() {<a name="line.1634"></a>
+<span class="sourceLineNo">1635</span> return e.getKey().getOffset();<a name="line.1635"></a>
+<span class="sourceLineNo">1636</span> }<a name="line.1636"></a>
+<span class="sourceLineNo">1637</span><a name="line.1637"></a>
+<span class="sourceLineNo">1638</span> @Override<a name="line.1638"></a>
+<span class="sourceLineNo">1639</span> public long getSize() {<a name="line.1639"></a>
+<span class="sourceLineNo">1640</span> return e.getValue().getLength();<a name="line.1640"></a>
+<span class="sourceLineNo">1641</span> }<a name="line.1641"></a>
+<span class="sourceLineNo">1642</span><a name="line.1642"></a>
+<span class="sourceLineNo">1643</span> @Override<a name="line.1643"></a>
+<span class="sourceLineNo">1644</span> public long getCachedTime() {<a name="line.1644"></a>
+<span class="sourceLineNo">1645</span> return e.getValue().getCachedTime();<a name="line.1645"></a>
+<span class="sourceLineNo">1646</span> }<a name="line.1646"></a>
+<span class="sourceLineNo">1647</span><a name="line.1647"></a>
+<span class="sourceLineNo">1648</span> @Override<a name="line.1648"></a>
+<span class="sourceLineNo">1649</span> public String getFilename() {<a name="line.1649"></a>
+<span class="sourceLineNo">1650</span> return e.getKey().getHfileName();<a name="line.1650"></a>
+<span class="sourceLineNo">1651</span> }<a name="line.1651"></a>
+<span class="sourceLineNo">1652</span><a name="line.1652"></a>
+<span class="sourceLineNo">1653</span> @Override<a name="line.1653"></a>
+<span class="sourceLineNo">1654</span> public int compareTo(CachedBlock other) {<a name="line.1654"></a>
+<span class="sourceLineNo">1655</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1655"></a>
+<span class="sourceLineNo">1656</span> if (diff != 0) return diff;<a name="line.1656"></a>
+<span class="sourceLineNo">1657</span><a name="line.1657"></a>
+<span class="sourceLineNo">1658</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1658"></a>
+<span class="sourceLineNo">1659</span> if (diff != 0) return diff;<a name="line.1659"></a>
+<span class="sourceLineNo">1660</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1660"></a>
+<span class="sourceLineNo">1661</span> throw new IllegalStateException(<a name="line.1661"></a>
+<span class="sourceLineNo">1662</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1662"></a>
+<span class="sourceLineNo">1663</span> }<a name="line.1663"></a>
+<span class="sourceLineNo">1664</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1664"></a>
+<span class="sourceLineNo">1665</span> }<a name="line.1665"></a>
+<span class="sourceLineNo">1666</span><a name="line.1666"></a>
+<span class="sourceLineNo">1667</span> @Override<a name="line.1667"></a>
+<span class="sourceLineNo">1668</span> public int hashCode() {<a name="line.1668"></a>
+<span class="sourceLineNo">1669</span> return e.getKey().hashCode();<a name="line.1669"></a>
+<span class="sourceLineNo">1670</span> }<a name="line.1670"></a>
+<span class="sourceLineNo">1671</span><a name="line.1671"></a>
+<span class="sourceLineNo">1672</span> @Override<a name="line.1672"></a>
+<span class="sourceLineNo">1673</span> public boolean equals(Object obj) {<a name="line.1673"></a>
+<span class="sourceLineNo">1674</span> if (obj instanceof CachedBlock) {<a name="line.1674"></a>
+<span class="sourceLineNo">1675</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1675"></a>
+<span class="sourceLineNo">1676</span> return compareTo(cb) == 0;<a name="line.1676"></a>
+<span class="sourceLineNo">1677</span> } else {<a name="line.1677"></a>
+<span class="sourceLineNo">1678</span> return false;<a name="line.1678"></a>
+<span class="sourceLineNo">1679</span> }<a name="line.1679"></a>
+<span class="sourceLineNo">1680</span> }<a name="line.1680"></a>
+<span class="sourceLineNo">1681</span> };<a name="line.1681"></a>
+<span class="sourceLineNo">1682</span> }<a name="line.1682"></a>
+<span class="sourceLineNo">1683</span><a name="line.1683"></a>
+<span class="sourceLineNo">1684</span> @Override<a name="line.1684"></a>
+<span class="sourceLineNo">1685</span> public void remove() {<a name="line.1685"></a>
+<span class="sourceLineNo">1686</span> throw new UnsupportedOperationException();<a name="line.1686"></a>
+<span class="sourceLineNo">1687</span> }<a name="line.1687"></a>
+<span class="sourceLineNo">1688</span> };<a name="line.1688"></a>
+<span class="sourceLineNo">1689</span> }<a name="line.1689"></a>
+<span class="sourceLineNo">1690</span><a name="line.1690"></a>
+<span class="sourceLineNo">1691</span> @Override<a name="line.1691"></a>
+<span class="sourceLineNo">1692</span> public BlockCache[] getBlockCaches() {<a name="line.1692"></a>
+<span class="sourceLineNo">1693</span> return null;<a name="line.1693"></a>
+<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
+<span class="sourceLineNo">1695</span><a name="line.1695"></a>
+<span class="sourceLineNo">1696</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1696"></a>
+<span class="sourceLineNo">1697</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1697"></a>
+<span class="sourceLineNo">1698</span> if (bucketEntry != null) {<a name="line.1698"></a>
+<span class="sourceLineNo">1699</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1699"></a>
+<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
+<span class="sourceLineNo">1701</span> return 0;<a name="line.1701"></a>
+<span class="sourceLineNo">1702</span> }<a name="line.1702"></a>
+<span class="sourceLineNo">1703</span><a name="line.1703"></a>
+<span class="sourceLineNo">1704</span> float getAcceptableFactor() {<a name="line.1704"></a>
+<span class="sourceLineNo">1705</span> return acceptableFactor;<a name="line.1705"></a>
+<span class="sourceLineNo">1706</span> }<a name="line.1706"></a>
+<span class="sourceLineNo">1707</span><a name="line.1707"></a>
+<span class="sourceLineNo">1708</span> float getMinFactor() {<a name="line.1708"></a>
+<span class="sourceLineNo">1709</span> return minFactor;<a name="line.1709"></a>
+<span class="sourceLineNo">1710</span> }<a name="line.1710"></a>
+<span class="sourceLineNo">1711</span><a name="line.1711"></a>
+<span class="sourceLineNo">1712</span> float getExtraFreeFactor() {<a name="line.1712"></a>
+<span class="sourceLineNo">1713</span> return extraFreeFactor;<a name="line.1713"></a>
+<span class="sourceLineNo">1714</span> }<a name="line.1714"></a>
+<span class="sourceLineNo">1715</span><a name="line.1715"></a>
+<span class="sourceLineNo">1716</span> float getSingleFactor() {<a name="line.1716"></a>
+<span class="sourceLineNo">1717</span> return singleFactor;<a name="line.1717"></a>
+<span class="sourceLineNo">1718</span> }<a name="line.1718"></a>
+<span class="sourceLineNo">1719</span><a name="line.1719"></a>
+<span class="sourceLineNo">1720</span> float getMultiFactor() {<a name="line.1720"></a>
+<span class="sourceLineNo">1721</span> return multiFactor;<a name="line.1721"></a>
+<span class="sourceLineNo">1722</span> }<a name="line.1722"></a>
+<span class="sourceLineNo">1723</span><a name="line.1723"></a>
+<span class="sourceLineNo">1724</span> float getMemoryFactor() {<a name="line.1724"></a>
+<span class="sourceLineNo">1725</span> return memoryFactor;<a name="line.1725"></a>
+<span class="sourceLineNo">1726</span> }<a name="line.1726"></a>
+<span class="sourceLineNo">1727</span><a name="line.1727"></a>
+<span class="sourceLineNo">1728</span> /**<a name="line.1728"></a>
+<span class="sourceLineNo">1729</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1729"></a>
+<span class="sourceLineNo">1730</span> */<a name="line.1730"></a>
+<span class="sourceLineNo">1731</span> static class RAMCache {<a name="line.1731"></a>
+<span class="sourceLineNo">1732</span> /**<a name="line.1732"></a>
+<span class="sourceLineNo">1733</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1733"></a>
+<span class="sourceLineNo">1734</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1734"></a>
+<span class="sourceLineNo">1735</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1735"></a>
+<span class="sourceLineNo">1736</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1736"></a>
+<span class="sourceLineNo">1737</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1737"></a>
+<span class="sourceLineNo">1738</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1738"></a>
+<span class="sourceLineNo">1739</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1739"></a>
+<span class="sourceLineNo">1740</span> */<a name="line.1740"></a>
+<span class="sourceLineNo">1741</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1741"></a>
+<span class="sourceLineNo">1742</span><a name="line.1742"></a>
+<span class="sourceLineNo">1743</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1743"></a>
+<span class="sourceLineNo">1744</span> return delegate.containsKey(key);<a name="line.1744"></a>
+<span class="sourceLineNo">1745</span> }<a name="line.1745"></a>
+<span class="sourceLineNo">1746</span><a name="line.1746"></a>
+<span class="sourceLineNo">1747</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1747"></a>
+<span class="sourceLineNo">1748</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1748"></a>
+<span class="sourceLineNo">1749</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1749"></a>
+<span class="sourceLineNo">1750</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1750"></a>
+<span class="sourceLineNo">1751</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1751"></a>
+<span class="sourceLineNo">1752</span> re.getData().retain();<a name="line.1752"></a>
+<span class="sourceLineNo">1753</span> return re;<a name="line.1753"></a>
+<span class="sourceLineNo">1754</span> });<a name="line.1754"></a>
+<span class="sourceLineNo">1755</span> }<a name="line.1755"></a>
+<span class="sourceLineNo">1756</span><a name="line.1756"></a>
+<span class="sourceLineNo">1757</span> /**<a name="line.1757"></a>
+<span class="sourceLineNo">1758</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1758"></a>
+<span class="sourceLineNo">1759</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1759"></a>
+<span class="sourceLineNo">1760</span> */<a name="line.1760"></a>
+<span class="sourceLineNo">1761</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1761"></a>
+<span class="sourceLineNo">1762</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1762"></a>
+<span class="sourceLineNo">1763</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1763"></a>
+<span class="sourceLineNo">1764</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1764"></a>
+<span class="sourceLineNo">1765</span> entry.getData().retain();<a name="line.1765"></a>
+<span class="sourceLineNo">1766</span> absent.set(true);<a name="line.1766"></a>
+<span class="sourceLineNo">1767</span> return entry;<a name="line.1767"></a>
<span class="sourceLineNo">1768</span> });<a name="line.1768"></a>
-<span class="sourceLineNo">1769</span> }<a name="line.1769"></a>
-<span class="sourceLineNo">1770</span><a name="line.1770"></a>
-<span class="sourceLineNo">1771</span> /**<a name="line.1771"></a>
-<span class="sourceLineNo">1772</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1772"></a>
-<span class="sourceLineNo">1773</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1773"></a>
-<span class="sourceLineNo">1774</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1774"></a>
-<span class="sourceLineNo">1775</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1775"></a>
-<span class="sourceLineNo">1776</span> */<a name="line.1776"></a>
-<span class="sourceLineNo">1777</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1777"></a>
-<span class="sourceLineNo">1778</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1778"></a>
-<span class="sourceLineNo">1779</span> action.accept(previous);<a name="line.1779"></a>
-<span class="sourceLineNo">1780</span> if (previous != null) {<a name="line.1780"></a>
-<span class="sourceLineNo">1781</span> previous.getData().release();<a name="line.1781"></a>
-<span class="sourceLineNo">1782</span> }<a name="line.1782"></a>
-<span class="sourceLineNo">1783</span> return previous != null;<a name="line.1783"></a>
-<span class="sourceLineNo">1784</span> }<a name="line.1784"></a>
-<span class="sourceLineNo">1785</span><a name="line.1785"></a>
-<span class="sourceLineNo">1786</span> public boolean isEmpty() {<a name="line.1786"></a>
-<span class="sourceLineNo">1787</span> return delegate.isEmpty();<a name="line.1787"></a>
-<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
-<span class="sourceLineNo">1789</span><a name="line.1789"></a>
-<span class="sourceLineNo">1790</span> public void clear() {<a name="line.1790"></a>
-<span class="sourceLineNo">1791</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1791"></a>
-<span class="sourceLineNo">1792</span> while (it.hasNext()) {<a name="line.1792"></a>
-<span class="sourceLineNo">1793</span> RAMQueueEntry re = it.next().getValue();<a name="line.1793"></a>
-<span class="sourceLineNo">1794</span> it.remove();<a name="line.1794"></a>
-<span class="sourceLineNo">1795</span> re.getData().release();<a name="line.1795"></a>
-<span class="sourceLineNo">1796</span> }<a name="line.1796"></a>
-<span class="sourceLineNo">1797</span> }<a name="line.1797"></a>
-<span class="sourceLineNo">1798</span> }<a name="line.1798"></a>
-<span class="sourceLineNo">1799</span>}<a name="line.1799"></a>
+<span class="sourceLineNo">1769</span> return absent.get() ? null : re;<a name="line.1769"></a>
+<span class="sourceLineNo">1770</span> }<a name="line.1770"></a>
+<span class="sourceLineNo">1771</span><a name="line.1771"></a>
+<span class="sourceLineNo">1772</span> public boolean remove(BlockCacheKey key) {<a name="line.1772"></a>
+<span class="sourceLineNo">1773</span> return remove(key, re -> {<a name="line.1773"></a>
+<span class="sourceLineNo">1774</span> });<a name="line.1774"></a>
+<span class="sourceLineNo">1775</span> }<a name="line.1775"></a>
+<span class="sourceLineNo">1776</span><a name="line.1776"></a>
+<span class="sourceLineNo">1777</span> /**<a name="line.1777"></a>
+<span class="sourceLineNo">1778</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1778"></a>
+<span class="sourceLineNo">1779</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1779"></a>
+<span class="sourceLineNo">1780</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1780"></a>
+<span class="sourceLineNo">1781</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1781"></a>
+<span class="sourceLineNo">1782</span> */<a name="line.1782"></a>
+<span class="sourceLineNo">1783</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1783"></a>
+<span class="sourceLineNo">1784</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1784"></a>
+<span class="sourceLineNo">1785</span> action.accept(previous);<a name="line.1785"></a>
+<span class="sourceLineNo">1786</span> if (previous != null) {<a name="line.1786"></a>
+<span class="sourceLineNo">1787</span> previous.getData().release();<a name="line.1787"></a>
+<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
+<span class="sourceLineNo">1789</span> return previous != null;<a name="line.1789"></a>
+<span class="sourceLineNo">1790</span> }<a name="line.1790"></a>
+<span class="sourceLineNo">1791</span><a name="line.1791"></a>
+<span class="sourceLineNo">1792</span> public boolean isEmpty() {<a name="line.1792"></a>
+<span class="sourceLineNo">1793</span> return delegate.isEmpty();<a name="line.1793"></a>
+<span class="sourceLineNo">1794</span> }<a name="line.1794"></a>
+<span class="sourceLineNo">1795</span><a name="line.1795"></a>
+<span class="sourceLineNo">1796</span> public void clear() {<a name="line.1796"></a>
+<span class="sourceLineNo">1797</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1797"></a>
+<span class="sourceLineNo">1798</span> while (it.hasNext()) {<a name="line.1798"></a>
+<span class="sourceLineNo">1799</span> RAMQueueEntry re = it.next().getValue();<a name="line.1799"></a>
+<span class="sourceLineNo">1800</span> it.remove();<a name="line.1800"></a>
+<span class="sourceLineNo">1801</span> re.getData().release();<a name="line.1801"></a>
+<span class="sourceLineNo">1802</span> }<a name="line.1802"></a>
+<span class="sourceLineNo">1803</span> }<a name="line.1803"></a>
+<span class="sourceLineNo">1804</span> }<a name="line.1804"></a>
+<span class="sourceLineNo">1805</span>}<a name="line.1805"></a>
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.StatisticsThread.html b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.StatisticsThread.html
index 30710531ef1..6b016942fa7 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.StatisticsThread.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.StatisticsThread.html
@@ -1053,758 +1053,764 @@
<span class="sourceLineNo">1045</span> final HFileContext fileContext = ((HFileBlock) re.getData()).getHFileContext();<a name="line.1045"></a>
<span class="sourceLineNo">1046</span> final String columnFamily = Bytes.toString(fileContext.getColumnFamily());<a name="line.1046"></a>
<span class="sourceLineNo">1047</span> final String tableName = Bytes.toString(fileContext.getTableName());<a name="line.1047"></a>
-<span class="sourceLineNo">1048</span> if (tableName != null && columnFamily != null) {<a name="line.1048"></a>
+<span class="sourceLineNo">1048</span> if (tableName != null) {<a name="line.1048"></a>
<span class="sourceLineNo">1049</span> sb.append(" Table: ");<a name="line.1049"></a>
<span class="sourceLineNo">1050</span> sb.append(tableName);<a name="line.1050"></a>
-<span class="sourceLineNo">1051</span> sb.append(" CF: ");<a name="line.1051"></a>
-<span class="sourceLineNo">1052</span> sb.append(columnFamily);<a name="line.1052"></a>
-<span class="sourceLineNo">1053</span> sb.append(" HFile: ");<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span> sb.append(fileContext.getHFileName());<a name="line.1054"></a>
+<span class="sourceLineNo">1051</span> }<a name="line.1051"></a>
+<span class="sourceLineNo">1052</span> if (columnFamily != null) {<a name="line.1052"></a>
+<span class="sourceLineNo">1053</span> sb.append(" CF: ");<a name="line.1053"></a>
+<span class="sourceLineNo">1054</span> sb.append(columnFamily);<a name="line.1054"></a>
<span class="sourceLineNo">1055</span> }<a name="line.1055"></a>
-<span class="sourceLineNo">1056</span> } else {<a name="line.1056"></a>
-<span class="sourceLineNo">1057</span> sb.append(" HFile: ");<a name="line.1057"></a>
-<span class="sourceLineNo">1058</span> sb.append(re.getKey());<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span> }<a name="line.1059"></a>
-<span class="sourceLineNo">1060</span> }<a name="line.1060"></a>
-<span class="sourceLineNo">1061</span> sb.append(" Message: ");<a name="line.1061"></a>
-<span class="sourceLineNo">1062</span> sb.append(fle.getMessage());<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> return sb.toString();<a name="line.1063"></a>
-<span class="sourceLineNo">1064</span> }<a name="line.1064"></a>
-<span class="sourceLineNo">1065</span><a name="line.1065"></a>
-<span class="sourceLineNo">1066</span> /**<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1067"></a>
-<span class="sourceLineNo">1068</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1068"></a>
-<span class="sourceLineNo">1069</span> * references and we'll OOME.<a name="line.1069"></a>
-<span class="sourceLineNo">1070</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1070"></a>
-<span class="sourceLineNo">1071</span> * interference expected.<a name="line.1071"></a>
-<span class="sourceLineNo">1072</span> */<a name="line.1072"></a>
-<span class="sourceLineNo">1073</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1073"></a>
-<span class="sourceLineNo">1074</span> if (entries.isEmpty()) {<a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> return;<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span> }<a name="line.1076"></a>
-<span class="sourceLineNo">1077</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1078"></a>
-<span class="sourceLineNo">1079</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1081"></a>
-<span class="sourceLineNo">1082</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1082"></a>
-<span class="sourceLineNo">1083</span> final int size = entries.size();<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1084"></a>
-<span class="sourceLineNo">1085</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1086"></a>
-<span class="sourceLineNo">1087</span> int index = 0;<a name="line.1087"></a>
-<span class="sourceLineNo">1088</span> while (cacheEnabled && index < size) {<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span> RAMQueueEntry re = null;<a name="line.1089"></a>
-<span class="sourceLineNo">1090</span> try {<a name="line.1090"></a>
-<span class="sourceLineNo">1091</span> re = entries.get(index);<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span> if (re == null) {<a name="line.1092"></a>
-<span class="sourceLineNo">1093</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span> index++;<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span> continue;<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span> }<a name="line.1096"></a>
-<span class="sourceLineNo">1097</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1097"></a>
-<span class="sourceLineNo">1098</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> blocksByHFile.add(cacheKey);<a name="line.1099"></a>
-<span class="sourceLineNo">1100</span> }<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span> // Reset the position for reuse.<a name="line.1101"></a>
-<span class="sourceLineNo">1102</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1102"></a>
-<span class="sourceLineNo">1103</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span> // IOEngine in the future.<a name="line.1105"></a>
-<span class="sourceLineNo">1106</span> metaBuff.clear();<a name="line.1106"></a>
-<span class="sourceLineNo">1107</span> BucketEntry bucketEntry =<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1108"></a>
-<span class="sourceLineNo">1109</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1109"></a>
-<span class="sourceLineNo">1110</span> bucketEntries[index] = bucketEntry;<a name="line.1110"></a>
-<span class="sourceLineNo">1111</span> if (ioErrorStartTime > 0) {<a name="line.1111"></a>
-<span class="sourceLineNo">1112</span> ioErrorStartTime = -1;<a name="line.1112"></a>
-<span class="sourceLineNo">1113</span> }<a name="line.1113"></a>
-<span class="sourceLineNo">1114</span> index++;<a name="line.1114"></a>
-<span class="sourceLineNo">1115</span> } catch (BucketAllocatorException fle) {<a name="line.1115"></a>
-<span class="sourceLineNo">1116</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1116"></a>
-<span class="sourceLineNo">1117</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span> if (<a name="line.1118"></a>
-<span class="sourceLineNo">1119</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1119"></a>
-<span class="sourceLineNo">1120</span> ) {<a name="line.1120"></a>
-<span class="sourceLineNo">1121</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1121"></a>
-<span class="sourceLineNo">1122</span> allocFailLogPrevTs = currTs;<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span> }<a name="line.1123"></a>
-<span class="sourceLineNo">1124</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span> bucketEntries[index] = null;<a name="line.1125"></a>
-<span class="sourceLineNo">1126</span> index++;<a name="line.1126"></a>
-<span class="sourceLineNo">1127</span> } catch (CacheFullException cfe) {<a name="line.1127"></a>
-<span class="sourceLineNo">1128</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span> if (!freeInProgress) {<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span> freeSpace("Full!");<a name="line.1130"></a>
-<span class="sourceLineNo">1131</span> } else {<a name="line.1131"></a>
-<span class="sourceLineNo">1132</span> Thread.sleep(50);<a name="line.1132"></a>
-<span class="sourceLineNo">1133</span> }<a name="line.1133"></a>
-<span class="sourceLineNo">1134</span> } catch (IOException ioex) {<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1135"></a>
-<span class="sourceLineNo">1136</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1136"></a>
-<span class="sourceLineNo">1137</span> checkIOErrorIsTolerated();<a name="line.1137"></a>
-<span class="sourceLineNo">1138</span> }<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
-<span class="sourceLineNo">1140</span><a name="line.1140"></a>
-<span class="sourceLineNo">1141</span> // Make sure data pages are written on media before we update maps.<a name="line.1141"></a>
-<span class="sourceLineNo">1142</span> try {<a name="line.1142"></a>
-<span class="sourceLineNo">1143</span> ioEngine.sync();<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span> } catch (IOException ioex) {<a name="line.1144"></a>
-<span class="sourceLineNo">1145</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1145"></a>
-<span class="sourceLineNo">1146</span> checkIOErrorIsTolerated();<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1147"></a>
-<span class="sourceLineNo">1148</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> if (bucketEntry != null) {<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> bucketEntries[i] = null;<a name="line.1152"></a>
-<span class="sourceLineNo">1153</span> }<a name="line.1153"></a>
-<span class="sourceLineNo">1154</span> }<a name="line.1154"></a>
-<span class="sourceLineNo">1155</span> }<a name="line.1155"></a>
-<span class="sourceLineNo">1156</span><a name="line.1156"></a>
-<span class="sourceLineNo">1157</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1157"></a>
-<span class="sourceLineNo">1158</span> // success or error.<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span> for (int i = 0; i < size; ++i) {<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1160"></a>
-<span class="sourceLineNo">1161</span> // Only add if non-null entry.<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span> if (bucketEntries[i] != null) {<a name="line.1162"></a>
-<span class="sourceLineNo">1163</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span> }<a name="line.1164"></a>
-<span class="sourceLineNo">1165</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span> if (re != null) {<a name="line.1167"></a>
-<span class="sourceLineNo">1168</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1168"></a>
-<span class="sourceLineNo">1169</span> }<a name="line.1169"></a>
-<span class="sourceLineNo">1170</span> });<a name="line.1170"></a>
-<span class="sourceLineNo">1171</span> if (!existed && bucketEntries[i] != null) {<a name="line.1171"></a>
-<span class="sourceLineNo">1172</span> // Block should have already been evicted. Remove it and free space.<a name="line.1172"></a>
-<span class="sourceLineNo">1173</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1173"></a>
-<span class="sourceLineNo">1174</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1174"></a>
-<span class="sourceLineNo">1175</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1175"></a>
-<span class="sourceLineNo">1176</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1176"></a>
-<span class="sourceLineNo">1177</span> }<a name="line.1177"></a>
-<span class="sourceLineNo">1178</span> return null;<a name="line.1178"></a>
-<span class="sourceLineNo">1179</span> });<a name="line.1179"></a>
-<span class="sourceLineNo">1180</span> }<a name="line.1180"></a>
-<span class="sourceLineNo">1181</span> }<a name="line.1181"></a>
-<span class="sourceLineNo">1182</span><a name="line.1182"></a>
-<span class="sourceLineNo">1183</span> long used = bucketAllocator.getUsedSize();<a name="line.1183"></a>
-<span class="sourceLineNo">1184</span> if (used > acceptableSize()) {<a name="line.1184"></a>
-<span class="sourceLineNo">1185</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1185"></a>
-<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
-<span class="sourceLineNo">1187</span> return;<a name="line.1187"></a>
-<span class="sourceLineNo">1188</span> }<a name="line.1188"></a>
-<span class="sourceLineNo">1189</span><a name="line.1189"></a>
-<span class="sourceLineNo">1190</span> /**<a name="line.1190"></a>
-<span class="sourceLineNo">1191</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1191"></a>
-<span class="sourceLineNo">1192</span> * returning.<a name="line.1192"></a>
-<span class="sourceLineNo">1193</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1193"></a>
-<span class="sourceLineNo">1194</span> * in case.<a name="line.1194"></a>
-<span class="sourceLineNo">1195</span> * @param q The queue to take from.<a name="line.1195"></a>
-<span class="sourceLineNo">1196</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1196"></a>
-<span class="sourceLineNo">1197</span> */<a name="line.1197"></a>
-<span class="sourceLineNo">1198</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1198"></a>
-<span class="sourceLineNo">1199</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1199"></a>
-<span class="sourceLineNo">1200</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1200"></a>
-<span class="sourceLineNo">1201</span> // ok even if list grew to accommodate thousands.<a name="line.1201"></a>
-<span class="sourceLineNo">1202</span> receptacle.clear();<a name="line.1202"></a>
-<span class="sourceLineNo">1203</span> receptacle.add(q.take());<a name="line.1203"></a>
-<span class="sourceLineNo">1204</span> q.drainTo(receptacle);<a name="line.1204"></a>
-<span class="sourceLineNo">1205</span> return receptacle;<a name="line.1205"></a>
-<span class="sourceLineNo">1206</span> }<a name="line.1206"></a>
-<span class="sourceLineNo">1207</span><a name="line.1207"></a>
-<span class="sourceLineNo">1208</span> /**<a name="line.1208"></a>
-<span class="sourceLineNo">1209</span> * @see #retrieveFromFile(int[])<a name="line.1209"></a>
-<span class="sourceLineNo">1210</span> */<a name="line.1210"></a>
-<span class="sourceLineNo">1211</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1211"></a>
-<span class="sourceLineNo">1212</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1212"></a>
-<span class="sourceLineNo">1213</span> private void persistToFile() throws IOException {<a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> assert !cacheEnabled;<a name="line.1214"></a>
-<span class="sourceLineNo">1215</span> if (!ioEngine.isPersistent()) {<a name="line.1215"></a>
-<span class="sourceLineNo">1216</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1216"></a>
-<span class="sourceLineNo">1217</span> }<a name="line.1217"></a>
-<span class="sourceLineNo">1218</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1218"></a>
-<span class="sourceLineNo">1219</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1219"></a>
-<span class="sourceLineNo">1220</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1220"></a>
-<span class="sourceLineNo">1221</span> }<a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> if (prefetchedFileListPath != null) {<a name="line.1222"></a>
-<span class="sourceLineNo">1223</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1223"></a>
-<span class="sourceLineNo">1224</span> }<a name="line.1224"></a>
-<span class="sourceLineNo">1225</span> }<a name="line.1225"></a>
-<span class="sourceLineNo">1226</span><a name="line.1226"></a>
-<span class="sourceLineNo">1227</span> /**<a name="line.1227"></a>
-<span class="sourceLineNo">1228</span> * @see #persistToFile()<a name="line.1228"></a>
-<span class="sourceLineNo">1229</span> */<a name="line.1229"></a>
-<span class="sourceLineNo">1230</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1230"></a>
-<span class="sourceLineNo">1231</span> File persistenceFile = new File(persistencePath);<a name="line.1231"></a>
-<span class="sourceLineNo">1232</span> if (!persistenceFile.exists()) {<a name="line.1232"></a>
-<span class="sourceLineNo">1233</span> return;<a name="line.1233"></a>
-<span class="sourceLineNo">1234</span> }<a name="line.1234"></a>
-<span class="sourceLineNo">1235</span> assert !cacheEnabled;<a name="line.1235"></a>
-<span class="sourceLineNo">1236</span> if (prefetchedFileListPath != null) {<a name="line.1236"></a>
-<span class="sourceLineNo">1237</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1237"></a>
-<span class="sourceLineNo">1238</span> }<a name="line.1238"></a>
-<span class="sourceLineNo">1239</span><a name="line.1239"></a>
-<span class="sourceLineNo">1240</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1240"></a>
-<span class="sourceLineNo">1241</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1241"></a>
-<span class="sourceLineNo">1242</span> byte[] pbuf = new byte[pblen];<a name="line.1242"></a>
-<span class="sourceLineNo">1243</span> int read = in.read(pbuf);<a name="line.1243"></a>
-<span class="sourceLineNo">1244</span> if (read != pblen) {<a name="line.1244"></a>
-<span class="sourceLineNo">1245</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1245"></a>
-<span class="sourceLineNo">1246</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1246"></a>
-<span class="sourceLineNo">1247</span> }<a name="line.1247"></a>
-<span class="sourceLineNo">1248</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1248"></a>
-<span class="sourceLineNo">1249</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1249"></a>
-<span class="sourceLineNo">1250</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1250"></a>
-<span class="sourceLineNo">1251</span> throw new IOException(<a name="line.1251"></a>
-<span class="sourceLineNo">1252</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1252"></a>
+<span class="sourceLineNo">1056</span> sb.append(" HFile: ");<a name="line.1056"></a>
+<span class="sourceLineNo">1057</span> if (fileContext.getHFileName() != null) {<a name="line.1057"></a>
+<span class="sourceLineNo">1058</span> sb.append(fileContext.getHFileName());<a name="line.1058"></a>
+<span class="sourceLineNo">1059</span> } else {<a name="line.1059"></a>
+<span class="sourceLineNo">1060</span> sb.append(re.getKey());<a name="line.1060"></a>
+<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
+<span class="sourceLineNo">1062</span> } else {<a name="line.1062"></a>
+<span class="sourceLineNo">1063</span> sb.append(" HFile: ");<a name="line.1063"></a>
+<span class="sourceLineNo">1064</span> sb.append(re.getKey());<a name="line.1064"></a>
+<span class="sourceLineNo">1065</span> }<a name="line.1065"></a>
+<span class="sourceLineNo">1066</span> }<a name="line.1066"></a>
+<span class="sourceLineNo">1067</span> sb.append(" Message: ");<a name="line.1067"></a>
+<span class="sourceLineNo">1068</span> sb.append(fle.getMessage());<a name="line.1068"></a>
+<span class="sourceLineNo">1069</span> return sb.toString();<a name="line.1069"></a>
+<span class="sourceLineNo">1070</span> }<a name="line.1070"></a>
+<span class="sourceLineNo">1071</span><a name="line.1071"></a>
+<span class="sourceLineNo">1072</span> /**<a name="line.1072"></a>
+<span class="sourceLineNo">1073</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1073"></a>
+<span class="sourceLineNo">1074</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1074"></a>
+<span class="sourceLineNo">1075</span> * references and we'll OOME.<a name="line.1075"></a>
+<span class="sourceLineNo">1076</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1076"></a>
+<span class="sourceLineNo">1077</span> * interference expected.<a name="line.1077"></a>
+<span class="sourceLineNo">1078</span> */<a name="line.1078"></a>
+<span class="sourceLineNo">1079</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1079"></a>
+<span class="sourceLineNo">1080</span> if (entries.isEmpty()) {<a name="line.1080"></a>
+<span class="sourceLineNo">1081</span> return;<a name="line.1081"></a>
+<span class="sourceLineNo">1082</span> }<a name="line.1082"></a>
+<span class="sourceLineNo">1083</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1083"></a>
+<span class="sourceLineNo">1084</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1084"></a>
+<span class="sourceLineNo">1085</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1085"></a>
+<span class="sourceLineNo">1086</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1086"></a>
+<span class="sourceLineNo">1087</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1087"></a>
+<span class="sourceLineNo">1088</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1088"></a>
+<span class="sourceLineNo">1089</span> final int size = entries.size();<a name="line.1089"></a>
+<span class="sourceLineNo">1090</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1090"></a>
+<span class="sourceLineNo">1091</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1091"></a>
+<span class="sourceLineNo">1092</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1092"></a>
+<span class="sourceLineNo">1093</span> int index = 0;<a name="line.1093"></a>
+<span class="sourceLineNo">1094</span> while (cacheEnabled && index < size) {<a name="line.1094"></a>
+<span class="sourceLineNo">1095</span> RAMQueueEntry re = null;<a name="line.1095"></a>
+<span class="sourceLineNo">1096</span> try {<a name="line.1096"></a>
+<span class="sourceLineNo">1097</span> re = entries.get(index);<a name="line.1097"></a>
+<span class="sourceLineNo">1098</span> if (re == null) {<a name="line.1098"></a>
+<span class="sourceLineNo">1099</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1099"></a>
+<span class="sourceLineNo">1100</span> index++;<a name="line.1100"></a>
+<span class="sourceLineNo">1101</span> continue;<a name="line.1101"></a>
+<span class="sourceLineNo">1102</span> }<a name="line.1102"></a>
+<span class="sourceLineNo">1103</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1103"></a>
+<span class="sourceLineNo">1104</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1104"></a>
+<span class="sourceLineNo">1105</span> blocksByHFile.add(cacheKey);<a name="line.1105"></a>
+<span class="sourceLineNo">1106</span> }<a name="line.1106"></a>
+<span class="sourceLineNo">1107</span> // Reset the position for reuse.<a name="line.1107"></a>
+<span class="sourceLineNo">1108</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1108"></a>
+<span class="sourceLineNo">1109</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1109"></a>
+<span class="sourceLineNo">1110</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1110"></a>
+<span class="sourceLineNo">1111</span> // IOEngine in the future.<a name="line.1111"></a>
+<span class="sourceLineNo">1112</span> metaBuff.clear();<a name="line.1112"></a>
+<span class="sourceLineNo">1113</span> BucketEntry bucketEntry =<a name="line.1113"></a>
+<span class="sourceLineNo">1114</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1114"></a>
+<span class="sourceLineNo">1115</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1115"></a>
+<span class="sourceLineNo">1116</span> bucketEntries[index] = bucketEntry;<a name="line.1116"></a>
+<span class="sourceLineNo">1117</span> if (ioErrorStartTime > 0) {<a name="line.1117"></a>
+<span class="sourceLineNo">1118</span> ioErrorStartTime = -1;<a name="line.1118"></a>
+<span class="sourceLineNo">1119</span> }<a name="line.1119"></a>
+<span class="sourceLineNo">1120</span> index++;<a name="line.1120"></a>
+<span class="sourceLineNo">1121</span> } catch (BucketAllocatorException fle) {<a name="line.1121"></a>
+<span class="sourceLineNo">1122</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1122"></a>
+<span class="sourceLineNo">1123</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1123"></a>
+<span class="sourceLineNo">1124</span> if (<a name="line.1124"></a>
+<span class="sourceLineNo">1125</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1125"></a>
+<span class="sourceLineNo">1126</span> ) {<a name="line.1126"></a>
+<span class="sourceLineNo">1127</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1127"></a>
+<span class="sourceLineNo">1128</span> allocFailLogPrevTs = currTs;<a name="line.1128"></a>
+<span class="sourceLineNo">1129</span> }<a name="line.1129"></a>
+<span class="sourceLineNo">1130</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1130"></a>
+<span class="sourceLineNo">1131</span> bucketEntries[index] = null;<a name="line.1131"></a>
+<span class="sourceLineNo">1132</span> index++;<a name="line.1132"></a>
+<span class="sourceLineNo">1133</span> } catch (CacheFullException cfe) {<a name="line.1133"></a>
+<span class="sourceLineNo">1134</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1134"></a>
+<span class="sourceLineNo">1135</span> if (!freeInProgress) {<a name="line.1135"></a>
+<span class="sourceLineNo">1136</span> freeSpace("Full!");<a name="line.1136"></a>
+<span class="sourceLineNo">1137</span> } else {<a name="line.1137"></a>
+<span class="sourceLineNo">1138</span> Thread.sleep(50);<a name="line.1138"></a>
+<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
+<span class="sourceLineNo">1140</span> } catch (IOException ioex) {<a name="line.1140"></a>
+<span class="sourceLineNo">1141</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1141"></a>
+<span class="sourceLineNo">1142</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1142"></a>
+<span class="sourceLineNo">1143</span> checkIOErrorIsTolerated();<a name="line.1143"></a>
+<span class="sourceLineNo">1144</span> }<a name="line.1144"></a>
+<span class="sourceLineNo">1145</span> }<a name="line.1145"></a>
+<span class="sourceLineNo">1146</span><a name="line.1146"></a>
+<span class="sourceLineNo">1147</span> // Make sure data pages are written on media before we update maps.<a name="line.1147"></a>
+<span class="sourceLineNo">1148</span> try {<a name="line.1148"></a>
+<span class="sourceLineNo">1149</span> ioEngine.sync();<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span> } catch (IOException ioex) {<a name="line.1150"></a>
+<span class="sourceLineNo">1151</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1151"></a>
+<span class="sourceLineNo">1152</span> checkIOErrorIsTolerated();<a name="line.1152"></a>
+<span class="sourceLineNo">1153</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1153"></a>
+<span class="sourceLineNo">1154</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1154"></a>
+<span class="sourceLineNo">1155</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1155"></a>
+<span class="sourceLineNo">1156</span> if (bucketEntry != null) {<a name="line.1156"></a>
+<span class="sourceLineNo">1157</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1157"></a>
+<span class="sourceLineNo">1158</span> bucketEntries[i] = null;<a name="line.1158"></a>
+<span class="sourceLineNo">1159</span> }<a name="line.1159"></a>
+<span class="sourceLineNo">1160</span> }<a name="line.1160"></a>
+<span class="sourceLineNo">1161</span> }<a name="line.1161"></a>
+<span class="sourceLineNo">1162</span><a name="line.1162"></a>
+<span class="sourceLineNo">1163</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1163"></a>
+<span class="sourceLineNo">1164</span> // success or error.<a name="line.1164"></a>
+<span class="sourceLineNo">1165</span> for (int i = 0; i < size; ++i) {<a name="line.1165"></a>
+<span class="sourceLineNo">1166</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1166"></a>
+<span class="sourceLineNo">1167</span> // Only add if non-null entry.<a name="line.1167"></a>
+<span class="sourceLineNo">1168</span> if (bucketEntries[i] != null) {<a name="line.1168"></a>
+<span class="sourceLineNo">1169</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1169"></a>
+<span class="sourceLineNo">1170</span> }<a name="line.1170"></a>
+<span class="sourceLineNo">1171</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1171"></a>
+<span class="sourceLineNo">1172</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1172"></a>
+<span class="sourceLineNo">1173</span> if (re != null) {<a name="line.1173"></a>
+<span class="sourceLineNo">1174</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1174"></a>
+<span class="sourceLineNo">1175</span> }<a name="line.1175"></a>
+<span class="sourceLineNo">1176</span> });<a name="line.1176"></a>
+<span class="sourceLineNo">1177</span> if (!existed && bucketEntries[i] != null) {<a name="line.1177"></a>
+<span class="sourceLineNo">1178</span> // Block should have already been evicted. Remove it and free space.<a name="line.1178"></a>
+<span class="sourceLineNo">1179</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1179"></a>
+<span class="sourceLineNo">1180</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1180"></a>
+<span class="sourceLineNo">1181</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1181"></a>
+<span class="sourceLineNo">1182</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1182"></a>
+<span class="sourceLineNo">1183</span> }<a name="line.1183"></a>
+<span class="sourceLineNo">1184</span> return null;<a name="line.1184"></a>
+<span class="sourceLineNo">1185</span> });<a name="line.1185"></a>
+<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
+<span class="sourceLineNo">1187</span> }<a name="line.1187"></a>
+<span class="sourceLineNo">1188</span><a name="line.1188"></a>
+<span class="sourceLineNo">1189</span> long used = bucketAllocator.getUsedSize();<a name="line.1189"></a>
+<span class="sourceLineNo">1190</span> if (used > acceptableSize()) {<a name="line.1190"></a>
+<span class="sourceLineNo">1191</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1191"></a>
+<span class="sourceLineNo">1192</span> }<a name="line.1192"></a>
+<span class="sourceLineNo">1193</span> return;<a name="line.1193"></a>
+<span class="sourceLineNo">1194</span> }<a name="line.1194"></a>
+<span class="sourceLineNo">1195</span><a name="line.1195"></a>
+<span class="sourceLineNo">1196</span> /**<a name="line.1196"></a>
+<span class="sourceLineNo">1197</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1197"></a>
+<span class="sourceLineNo">1198</span> * returning.<a name="line.1198"></a>
+<span class="sourceLineNo">1199</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1199"></a>
+<span class="sourceLineNo">1200</span> * in case.<a name="line.1200"></a>
+<span class="sourceLineNo">1201</span> * @param q The queue to take from.<a name="line.1201"></a>
+<span class="sourceLineNo">1202</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1202"></a>
+<span class="sourceLineNo">1203</span> */<a name="line.1203"></a>
+<span class="sourceLineNo">1204</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1204"></a>
+<span class="sourceLineNo">1205</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1205"></a>
+<span class="sourceLineNo">1206</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1206"></a>
+<span class="sourceLineNo">1207</span> // ok even if list grew to accommodate thousands.<a name="line.1207"></a>
+<span class="sourceLineNo">1208</span> receptacle.clear();<a name="line.1208"></a>
+<span class="sourceLineNo">1209</span> receptacle.add(q.take());<a name="line.1209"></a>
+<span class="sourceLineNo">1210</span> q.drainTo(receptacle);<a name="line.1210"></a>
+<span class="sourceLineNo">1211</span> return receptacle;<a name="line.1211"></a>
+<span class="sourceLineNo">1212</span> }<a name="line.1212"></a>
+<span class="sourceLineNo">1213</span><a name="line.1213"></a>
+<span class="sourceLineNo">1214</span> /**<a name="line.1214"></a>
+<span class="sourceLineNo">1215</span> * @see #retrieveFromFile(int[])<a name="line.1215"></a>
+<span class="sourceLineNo">1216</span> */<a name="line.1216"></a>
+<span class="sourceLineNo">1217</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1217"></a>
+<span class="sourceLineNo">1218</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1218"></a>
+<span class="sourceLineNo">1219</span> private void persistToFile() throws IOException {<a name="line.1219"></a>
+<span class="sourceLineNo">1220</span> assert !cacheEnabled;<a name="line.1220"></a>
+<span class="sourceLineNo">1221</span> if (!ioEngine.isPersistent()) {<a name="line.1221"></a>
+<span class="sourceLineNo">1222</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1222"></a>
+<span class="sourceLineNo">1223</span> }<a name="line.1223"></a>
+<span class="sourceLineNo">1224</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1224"></a>
+<span class="sourceLineNo">1225</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1225"></a>
+<span class="sourceLineNo">1226</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1226"></a>
+<span class="sourceLineNo">1227</span> }<a name="line.1227"></a>
+<span class="sourceLineNo">1228</span> if (prefetchedFileListPath != null) {<a name="line.1228"></a>
+<span class="sourceLineNo">1229</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1229"></a>
+<span class="sourceLineNo">1230</span> }<a name="line.1230"></a>
+<span class="sourceLineNo">1231</span> }<a name="line.1231"></a>
+<span class="sourceLineNo">1232</span><a name="line.1232"></a>
+<span class="sourceLineNo">1233</span> /**<a name="line.1233"></a>
+<span class="sourceLineNo">1234</span> * @see #persistToFile()<a name="line.1234"></a>
+<span class="sourceLineNo">1235</span> */<a name="line.1235"></a>
+<span class="sourceLineNo">1236</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1236"></a>
+<span class="sourceLineNo">1237</span> File persistenceFile = new File(persistencePath);<a name="line.1237"></a>
+<span class="sourceLineNo">1238</span> if (!persistenceFile.exists()) {<a name="line.1238"></a>
+<span class="sourceLineNo">1239</span> return;<a name="line.1239"></a>
+<span class="sourceLineNo">1240</span> }<a name="line.1240"></a>
+<span class="sourceLineNo">1241</span> assert !cacheEnabled;<a name="line.1241"></a>
+<span class="sourceLineNo">1242</span> if (prefetchedFileListPath != null) {<a name="line.1242"></a>
+<span class="sourceLineNo">1243</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1243"></a>
+<span class="sourceLineNo">1244</span> }<a name="line.1244"></a>
+<span class="sourceLineNo">1245</span><a name="line.1245"></a>
+<span class="sourceLineNo">1246</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1246"></a>
+<span class="sourceLineNo">1247</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1247"></a>
+<span class="sourceLineNo">1248</span> byte[] pbuf = new byte[pblen];<a name="line.1248"></a>
+<span class="sourceLineNo">1249</span> int read = in.read(pbuf);<a name="line.1249"></a>
+<span class="sourceLineNo">1250</span> if (read != pblen) {<a name="line.1250"></a>
+<span class="sourceLineNo">1251</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1251"></a>
+<span class="sourceLineNo">1252</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1252"></a>
<span class="sourceLineNo">1253</span> }<a name="line.1253"></a>
-<span class="sourceLineNo">1254</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1254"></a>
-<span class="sourceLineNo">1255</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1255"></a>
-<span class="sourceLineNo">1256</span> blockNumber.add(backingMap.size());<a name="line.1256"></a>
-<span class="sourceLineNo">1257</span> }<a name="line.1257"></a>
-<span class="sourceLineNo">1258</span> }<a name="line.1258"></a>
-<span class="sourceLineNo">1259</span><a name="line.1259"></a>
-<span class="sourceLineNo">1260</span> /**<a name="line.1260"></a>
-<span class="sourceLineNo">1261</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1261"></a>
-<span class="sourceLineNo">1262</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1262"></a>
-<span class="sourceLineNo">1263</span> *<a name="line.1263"></a>
-<span class="sourceLineNo">1264</span> * <pre><a name="line.1264"></a>
-<span class="sourceLineNo">1265</span> * File f = ...<a name="line.1265"></a>
-<span class="sourceLineNo">1266</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1266"></a>
-<span class="sourceLineNo">1267</span> * // use the input stream<a name="line.1267"></a>
-<span class="sourceLineNo">1268</span> * } finally {<a name="line.1268"></a>
-<span class="sourceLineNo">1269</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1269"></a>
-<span class="sourceLineNo">1270</span> * }<a name="line.1270"></a>
-<span class="sourceLineNo">1271</span> * </pre><a name="line.1271"></a>
-<span class="sourceLineNo">1272</span> *<a name="line.1272"></a>
-<span class="sourceLineNo">1273</span> * @param file the file to read and delete<a name="line.1273"></a>
-<span class="sourceLineNo">1274</span> * @return a FileInputStream for the given file<a name="line.1274"></a>
-<span class="sourceLineNo">1275</span> * @throws IOException if there is a problem creating the stream<a name="line.1275"></a>
-<span class="sourceLineNo">1276</span> */<a name="line.1276"></a>
-<span class="sourceLineNo">1277</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1277"></a>
-<span class="sourceLineNo">1278</span> return new FileInputStream(file) {<a name="line.1278"></a>
-<span class="sourceLineNo">1279</span> private File myFile;<a name="line.1279"></a>
-<span class="sourceLineNo">1280</span><a name="line.1280"></a>
-<span class="sourceLineNo">1281</span> private FileInputStream init(File file) {<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> myFile = file;<a name="line.1282"></a>
-<span class="sourceLineNo">1283</span> return this;<a name="line.1283"></a>
-<span class="sourceLineNo">1284</span> }<a name="line.1284"></a>
-<span class="sourceLineNo">1285</span><a name="line.1285"></a>
-<span class="sourceLineNo">1286</span> @Override<a name="line.1286"></a>
-<span class="sourceLineNo">1287</span> public void close() throws IOException {<a name="line.1287"></a>
-<span class="sourceLineNo">1288</span> // close() will be called during try-with-resources and it will be<a name="line.1288"></a>
-<span class="sourceLineNo">1289</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1289"></a>
-<span class="sourceLineNo">1290</span> // set myFile to null after the first call.<a name="line.1290"></a>
-<span class="sourceLineNo">1291</span> if (myFile == null) {<a name="line.1291"></a>
-<span class="sourceLineNo">1292</span> return;<a name="line.1292"></a>
-<span class="sourceLineNo">1293</span> }<a name="line.1293"></a>
-<span class="sourceLineNo">1294</span><a name="line.1294"></a>
-<span class="sourceLineNo">1295</span> super.close();<a name="line.1295"></a>
-<span class="sourceLineNo">1296</span> if (!myFile.delete()) {<a name="line.1296"></a>
-<span class="sourceLineNo">1297</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1297"></a>
-<span class="sourceLineNo">1298</span> }<a name="line.1298"></a>
-<span class="sourceLineNo">1299</span> myFile = null;<a name="line.1299"></a>
-<span class="sourceLineNo">1300</span> }<a name="line.1300"></a>
-<span class="sourceLineNo">1301</span> }.init(file);<a name="line.1301"></a>
-<span class="sourceLineNo">1302</span> }<a name="line.1302"></a>
-<span class="sourceLineNo">1303</span><a name="line.1303"></a>
-<span class="sourceLineNo">1304</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1304"></a>
-<span class="sourceLineNo">1305</span> throws IOException {<a name="line.1305"></a>
-<span class="sourceLineNo">1306</span> if (capacitySize != cacheCapacity) {<a name="line.1306"></a>
-<span class="sourceLineNo">1307</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1307"></a>
-<span class="sourceLineNo">1308</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1308"></a>
-<span class="sourceLineNo">1309</span> }<a name="line.1309"></a>
-<span class="sourceLineNo">1310</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1310"></a>
-<span class="sourceLineNo">1311</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1311"></a>
-<span class="sourceLineNo">1312</span> + ioEngine.getClass().getName());<a name="line.1312"></a>
-<span class="sourceLineNo">1313</span> }<a name="line.1313"></a>
-<span class="sourceLineNo">1314</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1314"></a>
-<span class="sourceLineNo">1315</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1315"></a>
-<span class="sourceLineNo">1316</span> + backingMap.getClass().getName());<a name="line.1316"></a>
-<span class="sourceLineNo">1317</span> }<a name="line.1317"></a>
-<span class="sourceLineNo">1318</span> }<a name="line.1318"></a>
-<span class="sourceLineNo">1319</span><a name="line.1319"></a>
-<span class="sourceLineNo">1320</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1320"></a>
-<span class="sourceLineNo">1321</span> if (proto.hasChecksum()) {<a name="line.1321"></a>
-<span class="sourceLineNo">1322</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1322"></a>
-<span class="sourceLineNo">1323</span> algorithm);<a name="line.1323"></a>
-<span class="sourceLineNo">1324</span> } else {<a name="line.1324"></a>
-<span class="sourceLineNo">1325</span> // if has not checksum, it means the persistence file is old format<a name="line.1325"></a>
-<span class="sourceLineNo">1326</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1326"></a>
-<span class="sourceLineNo">1327</span> }<a name="line.1327"></a>
-<span class="sourceLineNo">1328</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1328"></a>
-<span class="sourceLineNo">1329</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1329"></a>
-<span class="sourceLineNo">1330</span> this::createRecycler);<a name="line.1330"></a>
-<span class="sourceLineNo">1331</span> }<a name="line.1331"></a>
-<span class="sourceLineNo">1332</span><a name="line.1332"></a>
-<span class="sourceLineNo">1333</span> /**<a name="line.1333"></a>
-<span class="sourceLineNo">1334</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1334"></a>
-<span class="sourceLineNo">1335</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1335"></a>
-<span class="sourceLineNo">1336</span> */<a name="line.1336"></a>
-<span class="sourceLineNo">1337</span> private void checkIOErrorIsTolerated() {<a name="line.1337"></a>
-<span class="sourceLineNo">1338</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1338"></a>
-<span class="sourceLineNo">1339</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1339"></a>
-<span class="sourceLineNo">1340</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1340"></a>
-<span class="sourceLineNo">1341</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1341"></a>
-<span class="sourceLineNo">1342</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1343"></a>
-<span class="sourceLineNo">1344</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1344"></a>
-<span class="sourceLineNo">1345</span> disableCache();<a name="line.1345"></a>
-<span class="sourceLineNo">1346</span> }<a name="line.1346"></a>
-<span class="sourceLineNo">1347</span> } else {<a name="line.1347"></a>
-<span class="sourceLineNo">1348</span> this.ioErrorStartTime = now;<a name="line.1348"></a>
-<span class="sourceLineNo">1349</span> }<a name="line.1349"></a>
-<span class="sourceLineNo">1350</span> }<a name="line.1350"></a>
-<span class="sourceLineNo">1351</span><a name="line.1351"></a>
-<span class="sourceLineNo">1352</span> /**<a name="line.1352"></a>
-<span class="sourceLineNo">1353</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1353"></a>
-<span class="sourceLineNo">1354</span> */<a name="line.1354"></a>
-<span class="sourceLineNo">1355</span> private void disableCache() {<a name="line.1355"></a>
-<span class="sourceLineNo">1356</span> if (!cacheEnabled) return;<a name="line.1356"></a>
-<span class="sourceLineNo">1357</span> cacheEnabled = false;<a name="line.1357"></a>
-<span class="sourceLineNo">1358</span> ioEngine.shutdown();<a name="line.1358"></a>
-<span class="sourceLineNo">1359</span> this.scheduleThreadPool.shutdown();<a name="line.1359"></a>
-<span class="sourceLineNo">1360</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1360"></a>
-<span class="sourceLineNo">1361</span> writerThreads[i].interrupt();<a name="line.1361"></a>
-<span class="sourceLineNo">1362</span> this.ramCache.clear();<a name="line.1362"></a>
-<span class="sourceLineNo">1363</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1363"></a>
-<span class="sourceLineNo">1364</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1364"></a>
-<span class="sourceLineNo">1365</span> this.backingMap.clear();<a name="line.1365"></a>
-<span class="sourceLineNo">1366</span> }<a name="line.1366"></a>
-<span class="sourceLineNo">1367</span> }<a name="line.1367"></a>
-<span class="sourceLineNo">1368</span><a name="line.1368"></a>
-<span class="sourceLineNo">1369</span> private void join() throws InterruptedException {<a name="line.1369"></a>
-<span class="sourceLineNo">1370</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1370"></a>
-<span class="sourceLineNo">1371</span> writerThreads[i].join();<a name="line.1371"></a>
-<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
-<span class="sourceLineNo">1373</span><a name="line.1373"></a>
-<span class="sourceLineNo">1374</span> @Override<a name="line.1374"></a>
-<span class="sourceLineNo">1375</span> public void shutdown() {<a name="line.1375"></a>
-<span class="sourceLineNo">1376</span> disableCache();<a name="line.1376"></a>
-<span class="sourceLineNo">1377</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1377"></a>
-<span class="sourceLineNo">1378</span> + persistencePath);<a name="line.1378"></a>
-<span class="sourceLineNo">1379</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1379"></a>
-<span class="sourceLineNo">1380</span> try {<a name="line.1380"></a>
-<span class="sourceLineNo">1381</span> join();<a name="line.1381"></a>
-<span class="sourceLineNo">1382</span> persistToFile();<a name="line.1382"></a>
-<span class="sourceLineNo">1383</span> } catch (IOException ex) {<a name="line.1383"></a>
-<span class="sourceLineNo">1384</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1384"></a>
-<span class="sourceLineNo">1385</span> } catch (InterruptedException e) {<a name="line.1385"></a>
-<span class="sourceLineNo">1386</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> }<a name="line.1387"></a>
-<span class="sourceLineNo">1388</span> }<a name="line.1388"></a>
-<span class="sourceLineNo">1389</span> }<a name="line.1389"></a>
-<span class="sourceLineNo">1390</span><a name="line.1390"></a>
-<span class="sourceLineNo">1391</span> @Override<a name="line.1391"></a>
-<span class="sourceLineNo">1392</span> public CacheStats getStats() {<a name="line.1392"></a>
-<span class="sourceLineNo">1393</span> return cacheStats;<a name="line.1393"></a>
-<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
-<span class="sourceLineNo">1395</span><a name="line.1395"></a>
-<span class="sourceLineNo">1396</span> public BucketAllocator getAllocator() {<a name="line.1396"></a>
-<span class="sourceLineNo">1397</span> return this.bucketAllocator;<a name="line.1397"></a>
-<span class="sourceLineNo">1398</span> }<a name="line.1398"></a>
-<span class="sourceLineNo">1399</span><a name="line.1399"></a>
-<span class="sourceLineNo">1400</span> @Override<a name="line.1400"></a>
-<span class="sourceLineNo">1401</span> public long heapSize() {<a name="line.1401"></a>
-<span class="sourceLineNo">1402</span> return this.heapSize.sum();<a name="line.1402"></a>
-<span class="sourceLineNo">1403</span> }<a name="line.1403"></a>
-<span class="sourceLineNo">1404</span><a name="line.1404"></a>
-<span class="sourceLineNo">1405</span> @Override<a name="line.1405"></a>
-<span class="sourceLineNo">1406</span> public long size() {<a name="line.1406"></a>
-<span class="sourceLineNo">1407</span> return this.realCacheSize.sum();<a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> }<a name="line.1408"></a>
-<span class="sourceLineNo">1409</span><a name="line.1409"></a>
-<span class="sourceLineNo">1410</span> @Override<a name="line.1410"></a>
-<span class="sourceLineNo">1411</span> public long getCurrentDataSize() {<a name="line.1411"></a>
-<span class="sourceLineNo">1412</span> return size();<a name="line.1412"></a>
-<span class="sourceLineNo">1413</span> }<a name="line.1413"></a>
-<span class="sourceLineNo">1414</span><a name="line.1414"></a>
-<span class="sourceLineNo">1415</span> @Override<a name="line.1415"></a>
-<span class="sourceLineNo">1416</span> public long getFreeSize() {<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> return this.bucketAllocator.getFreeSize();<a name="line.1417"></a>
-<span class="sourceLineNo">1418</span> }<a name="line.1418"></a>
-<span class="sourceLineNo">1419</span><a name="line.1419"></a>
-<span class="sourceLineNo">1420</span> @Override<a name="line.1420"></a>
-<span class="sourceLineNo">1421</span> public long getBlockCount() {<a name="line.1421"></a>
-<span class="sourceLineNo">1422</span> return this.blockNumber.sum();<a name="line.1422"></a>
-<span class="sourceLineNo">1423</span> }<a name="line.1423"></a>
-<span class="sourceLineNo">1424</span><a name="line.1424"></a>
-<span class="sourceLineNo">1425</span> @Override<a name="line.1425"></a>
-<span class="sourceLineNo">1426</span> public long getDataBlockCount() {<a name="line.1426"></a>
-<span class="sourceLineNo">1427</span> return getBlockCount();<a name="line.1427"></a>
-<span class="sourceLineNo">1428</span> }<a name="line.1428"></a>
-<span class="sourceLineNo">1429</span><a name="line.1429"></a>
-<span class="sourceLineNo">1430</span> @Override<a name="line.1430"></a>
-<span class="sourceLineNo">1431</span> public long getCurrentSize() {<a name="line.1431"></a>
-<span class="sourceLineNo">1432</span> return this.bucketAllocator.getUsedSize();<a name="line.1432"></a>
-<span class="sourceLineNo">1433</span> }<a name="line.1433"></a>
-<span class="sourceLineNo">1434</span><a name="line.1434"></a>
-<span class="sourceLineNo">1435</span> protected String getAlgorithm() {<a name="line.1435"></a>
-<span class="sourceLineNo">1436</span> return algorithm;<a name="line.1436"></a>
-<span class="sourceLineNo">1437</span> }<a name="line.1437"></a>
-<span class="sourceLineNo">1438</span><a name="line.1438"></a>
-<span class="sourceLineNo">1439</span> /**<a name="line.1439"></a>
-<span class="sourceLineNo">1440</span> * Evicts all blocks for a specific HFile.<a name="line.1440"></a>
-<span class="sourceLineNo">1441</span> * <p><a name="line.1441"></a>
-<span class="sourceLineNo">1442</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1442"></a>
-<span class="sourceLineNo">1443</span> * @return the number of blocks evicted<a name="line.1443"></a>
-<span class="sourceLineNo">1444</span> */<a name="line.1444"></a>
-<span class="sourceLineNo">1445</span> @Override<a name="line.1445"></a>
-<span class="sourceLineNo">1446</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1446"></a>
-<span class="sourceLineNo">1447</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1447"></a>
-<span class="sourceLineNo">1448</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1448"></a>
-<span class="sourceLineNo">1449</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1449"></a>
-<span class="sourceLineNo">1450</span><a name="line.1450"></a>
-<span class="sourceLineNo">1451</span> int numEvicted = 0;<a name="line.1451"></a>
-<span class="sourceLineNo">1452</span> for (BlockCacheKey key : keySet) {<a name="line.1452"></a>
-<span class="sourceLineNo">1453</span> if (evictBlock(key)) {<a name="line.1453"></a>
-<span class="sourceLineNo">1454</span> ++numEvicted;<a name="line.1454"></a>
-<span class="sourceLineNo">1455</span> }<a name="line.1455"></a>
-<span class="sourceLineNo">1456</span> }<a name="line.1456"></a>
-<span class="sourceLineNo">1457</span><a name="line.1457"></a>
-<span class="sourceLineNo">1458</span> return numEvicted;<a name="line.1458"></a>
-<span class="sourceLineNo">1459</span> }<a name="line.1459"></a>
-<span class="sourceLineNo">1460</span><a name="line.1460"></a>
-<span class="sourceLineNo">1461</span> /**<a name="line.1461"></a>
-<span class="sourceLineNo">1462</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1462"></a>
-<span class="sourceLineNo">1463</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1463"></a>
-<span class="sourceLineNo">1464</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1464"></a>
-<span class="sourceLineNo">1465</span> */<a name="line.1465"></a>
-<span class="sourceLineNo">1466</span> private class BucketEntryGroup {<a name="line.1466"></a>
-<span class="sourceLineNo">1467</span><a name="line.1467"></a>
-<span class="sourceLineNo">1468</span> private CachedEntryQueue queue;<a name="line.1468"></a>
-<span class="sourceLineNo">1469</span> private long totalSize = 0;<a name="line.1469"></a>
-<span class="sourceLineNo">1470</span> private long bucketSize;<a name="line.1470"></a>
-<span class="sourceLineNo">1471</span><a name="line.1471"></a>
-<span class="sourceLineNo">1472</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1472"></a>
-<span class="sourceLineNo">1473</span> this.bucketSize = bucketSize;<a name="line.1473"></a>
-<span class="sourceLineNo">1474</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1474"></a>
-<span class="sourceLineNo">1475</span> totalSize = 0;<a name="line.1475"></a>
-<span class="sourceLineNo">1476</span> }<a name="line.1476"></a>
+<span class="sourceLineNo">1254</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1254"></a>
+<span class="sourceLineNo">1255</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1255"></a>
+<span class="sourceLineNo">1256</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1256"></a>
+<span class="sourceLineNo">1257</span> throw new IOException(<a name="line.1257"></a>
+<span class="sourceLineNo">1258</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1258"></a>
+<span class="sourceLineNo">1259</span> }<a name="line.1259"></a>
+<span class="sourceLineNo">1260</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1260"></a>
+<span class="sourceLineNo">1261</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1261"></a>
+<span class="sourceLineNo">1262</span> blockNumber.add(backingMap.size());<a name="line.1262"></a>
+<span class="sourceLineNo">1263</span> }<a name="line.1263"></a>
+<span class="sourceLineNo">1264</span> }<a name="line.1264"></a>
+<span class="sourceLineNo">1265</span><a name="line.1265"></a>
+<span class="sourceLineNo">1266</span> /**<a name="line.1266"></a>
+<span class="sourceLineNo">1267</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1267"></a>
+<span class="sourceLineNo">1268</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1268"></a>
+<span class="sourceLineNo">1269</span> *<a name="line.1269"></a>
+<span class="sourceLineNo">1270</span> * <pre><a name="line.1270"></a>
+<span class="sourceLineNo">1271</span> * File f = ...<a name="line.1271"></a>
+<span class="sourceLineNo">1272</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1272"></a>
+<span class="sourceLineNo">1273</span> * // use the input stream<a name="line.1273"></a>
+<span class="sourceLineNo">1274</span> * } finally {<a name="line.1274"></a>
+<span class="sourceLineNo">1275</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1275"></a>
+<span class="sourceLineNo">1276</span> * }<a name="line.1276"></a>
+<span class="sourceLineNo">1277</span> * </pre><a name="line.1277"></a>
+<span class="sourceLineNo">1278</span> *<a name="line.1278"></a>
+<span class="sourceLineNo">1279</span> * @param file the file to read and delete<a name="line.1279"></a>
+<span class="sourceLineNo">1280</span> * @return a FileInputStream for the given file<a name="line.1280"></a>
+<span class="sourceLineNo">1281</span> * @throws IOException if there is a problem creating the stream<a name="line.1281"></a>
+<span class="sourceLineNo">1282</span> */<a name="line.1282"></a>
+<span class="sourceLineNo">1283</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1283"></a>
+<span class="sourceLineNo">1284</span> return new FileInputStream(file) {<a name="line.1284"></a>
+<span class="sourceLineNo">1285</span> private File myFile;<a name="line.1285"></a>
+<span class="sourceLineNo">1286</span><a name="line.1286"></a>
+<span class="sourceLineNo">1287</span> private FileInputStream init(File file) {<a name="line.1287"></a>
+<span class="sourceLineNo">1288</span> myFile = file;<a name="line.1288"></a>
+<span class="sourceLineNo">1289</span> return this;<a name="line.1289"></a>
+<span class="sourceLineNo">1290</span> }<a name="line.1290"></a>
+<span class="sourceLineNo">1291</span><a name="line.1291"></a>
+<span class="sourceLineNo">1292</span> @Override<a name="line.1292"></a>
+<span class="sourceLineNo">1293</span> public void close() throws IOException {<a name="line.1293"></a>
+<span class="sourceLineNo">1294</span> // close() will be called during try-with-resources and it will be<a name="line.1294"></a>
+<span class="sourceLineNo">1295</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1295"></a>
+<span class="sourceLineNo">1296</span> // set myFile to null after the first call.<a name="line.1296"></a>
+<span class="sourceLineNo">1297</span> if (myFile == null) {<a name="line.1297"></a>
+<span class="sourceLineNo">1298</span> return;<a name="line.1298"></a>
+<span class="sourceLineNo">1299</span> }<a name="line.1299"></a>
+<span class="sourceLineNo">1300</span><a name="line.1300"></a>
+<span class="sourceLineNo">1301</span> super.close();<a name="line.1301"></a>
+<span class="sourceLineNo">1302</span> if (!myFile.delete()) {<a name="line.1302"></a>
+<span class="sourceLineNo">1303</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1303"></a>
+<span class="sourceLineNo">1304</span> }<a name="line.1304"></a>
+<span class="sourceLineNo">1305</span> myFile = null;<a name="line.1305"></a>
+<span class="sourceLineNo">1306</span> }<a name="line.1306"></a>
+<span class="sourceLineNo">1307</span> }.init(file);<a name="line.1307"></a>
+<span class="sourceLineNo">1308</span> }<a name="line.1308"></a>
+<span class="sourceLineNo">1309</span><a name="line.1309"></a>
+<span class="sourceLineNo">1310</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1310"></a>
+<span class="sourceLineNo">1311</span> throws IOException {<a name="line.1311"></a>
+<span class="sourceLineNo">1312</span> if (capacitySize != cacheCapacity) {<a name="line.1312"></a>
+<span class="sourceLineNo">1313</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1313"></a>
+<span class="sourceLineNo">1314</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1314"></a>
+<span class="sourceLineNo">1315</span> }<a name="line.1315"></a>
+<span class="sourceLineNo">1316</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1316"></a>
+<span class="sourceLineNo">1317</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1317"></a>
+<span class="sourceLineNo">1318</span> + ioEngine.getClass().getName());<a name="line.1318"></a>
+<span class="sourceLineNo">1319</span> }<a name="line.1319"></a>
+<span class="sourceLineNo">1320</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1320"></a>
+<span class="sourceLineNo">1321</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1321"></a>
+<span class="sourceLineNo">1322</span> + backingMap.getClass().getName());<a name="line.1322"></a>
+<span class="sourceLineNo">1323</span> }<a name="line.1323"></a>
+<span class="sourceLineNo">1324</span> }<a name="line.1324"></a>
+<span class="sourceLineNo">1325</span><a name="line.1325"></a>
+<span class="sourceLineNo">1326</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1326"></a>
+<span class="sourceLineNo">1327</span> if (proto.hasChecksum()) {<a name="line.1327"></a>
+<span class="sourceLineNo">1328</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1328"></a>
+<span class="sourceLineNo">1329</span> algorithm);<a name="line.1329"></a>
+<span class="sourceLineNo">1330</span> } else {<a name="line.1330"></a>
+<span class="sourceLineNo">1331</span> // if has not checksum, it means the persistence file is old format<a name="line.1331"></a>
+<span class="sourceLineNo">1332</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1332"></a>
+<span class="sourceLineNo">1333</span> }<a name="line.1333"></a>
+<span class="sourceLineNo">1334</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1334"></a>
+<span class="sourceLineNo">1335</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1335"></a>
+<span class="sourceLineNo">1336</span> this::createRecycler);<a name="line.1336"></a>
+<span class="sourceLineNo">1337</span> }<a name="line.1337"></a>
+<span class="sourceLineNo">1338</span><a name="line.1338"></a>
+<span class="sourceLineNo">1339</span> /**<a name="line.1339"></a>
+<span class="sourceLineNo">1340</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1340"></a>
+<span class="sourceLineNo">1341</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1341"></a>
+<span class="sourceLineNo">1342</span> */<a name="line.1342"></a>
+<span class="sourceLineNo">1343</span> private void checkIOErrorIsTolerated() {<a name="line.1343"></a>
+<span class="sourceLineNo">1344</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1344"></a>
+<span class="sourceLineNo">1345</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1345"></a>
+<span class="sourceLineNo">1346</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1346"></a>
+<span class="sourceLineNo">1347</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1347"></a>
+<span class="sourceLineNo">1348</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1348"></a>
+<span class="sourceLineNo">1349</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1349"></a>
+<span class="sourceLineNo">1350</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1350"></a>
+<span class="sourceLineNo">1351</span> disableCache();<a name="line.1351"></a>
+<span class="sourceLineNo">1352</span> }<a name="line.1352"></a>
+<span class="sourceLineNo">1353</span> } else {<a name="line.1353"></a>
+<span class="sourceLineNo">1354</span> this.ioErrorStartTime = now;<a name="line.1354"></a>
+<span class="sourceLineNo">1355</span> }<a name="line.1355"></a>
+<span class="sourceLineNo">1356</span> }<a name="line.1356"></a>
+<span class="sourceLineNo">1357</span><a name="line.1357"></a>
+<span class="sourceLineNo">1358</span> /**<a name="line.1358"></a>
+<span class="sourceLineNo">1359</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1359"></a>
+<span class="sourceLineNo">1360</span> */<a name="line.1360"></a>
+<span class="sourceLineNo">1361</span> private void disableCache() {<a name="line.1361"></a>
+<span class="sourceLineNo">1362</span> if (!cacheEnabled) return;<a name="line.1362"></a>
+<span class="sourceLineNo">1363</span> cacheEnabled = false;<a name="line.1363"></a>
+<span class="sourceLineNo">1364</span> ioEngine.shutdown();<a name="line.1364"></a>
+<span class="sourceLineNo">1365</span> this.scheduleThreadPool.shutdown();<a name="line.1365"></a>
+<span class="sourceLineNo">1366</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1366"></a>
+<span class="sourceLineNo">1367</span> writerThreads[i].interrupt();<a name="line.1367"></a>
+<span class="sourceLineNo">1368</span> this.ramCache.clear();<a name="line.1368"></a>
+<span class="sourceLineNo">1369</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1369"></a>
+<span class="sourceLineNo">1370</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1370"></a>
+<span class="sourceLineNo">1371</span> this.backingMap.clear();<a name="line.1371"></a>
+<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
+<span class="sourceLineNo">1373</span> }<a name="line.1373"></a>
+<span class="sourceLineNo">1374</span><a name="line.1374"></a>
+<span class="sourceLineNo">1375</span> private void join() throws InterruptedException {<a name="line.1375"></a>
+<span class="sourceLineNo">1376</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1376"></a>
+<span class="sourceLineNo">1377</span> writerThreads[i].join();<a name="line.1377"></a>
+<span class="sourceLineNo">1378</span> }<a name="line.1378"></a>
+<span class="sourceLineNo">1379</span><a name="line.1379"></a>
+<span class="sourceLineNo">1380</span> @Override<a name="line.1380"></a>
+<span class="sourceLineNo">1381</span> public void shutdown() {<a name="line.1381"></a>
+<span class="sourceLineNo">1382</span> disableCache();<a name="line.1382"></a>
+<span class="sourceLineNo">1383</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1383"></a>
+<span class="sourceLineNo">1384</span> + persistencePath);<a name="line.1384"></a>
+<span class="sourceLineNo">1385</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1385"></a>
+<span class="sourceLineNo">1386</span> try {<a name="line.1386"></a>
+<span class="sourceLineNo">1387</span> join();<a name="line.1387"></a>
+<span class="sourceLineNo">1388</span> persistToFile();<a name="line.1388"></a>
+<span class="sourceLineNo">1389</span> } catch (IOException ex) {<a name="line.1389"></a>
+<span class="sourceLineNo">1390</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1390"></a>
+<span class="sourceLineNo">1391</span> } catch (InterruptedException e) {<a name="line.1391"></a>
+<span class="sourceLineNo">1392</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1392"></a>
+<span class="sourceLineNo">1393</span> }<a name="line.1393"></a>
+<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
+<span class="sourceLineNo">1395</span> }<a name="line.1395"></a>
+<span class="sourceLineNo">1396</span><a name="line.1396"></a>
+<span class="sourceLineNo">1397</span> @Override<a name="line.1397"></a>
+<span class="sourceLineNo">1398</span> public CacheStats getStats() {<a name="line.1398"></a>
+<span class="sourceLineNo">1399</span> return cacheStats;<a name="line.1399"></a>
+<span class="sourceLineNo">1400</span> }<a name="line.1400"></a>
+<span class="sourceLineNo">1401</span><a name="line.1401"></a>
+<span class="sourceLineNo">1402</span> public BucketAllocator getAllocator() {<a name="line.1402"></a>
+<span class="sourceLineNo">1403</span> return this.bucketAllocator;<a name="line.1403"></a>
+<span class="sourceLineNo">1404</span> }<a name="line.1404"></a>
+<span class="sourceLineNo">1405</span><a name="line.1405"></a>
+<span class="sourceLineNo">1406</span> @Override<a name="line.1406"></a>
+<span class="sourceLineNo">1407</span> public long heapSize() {<a name="line.1407"></a>
+<span class="sourceLineNo">1408</span> return this.heapSize.sum();<a name="line.1408"></a>
+<span class="sourceLineNo">1409</span> }<a name="line.1409"></a>
+<span class="sourceLineNo">1410</span><a name="line.1410"></a>
+<span class="sourceLineNo">1411</span> @Override<a name="line.1411"></a>
+<span class="sourceLineNo">1412</span> public long size() {<a name="line.1412"></a>
+<span class="sourceLineNo">1413</span> return this.realCacheSize.sum();<a name="line.1413"></a>
+<span class="sourceLineNo">1414</span> }<a name="line.1414"></a>
+<span class="sourceLineNo">1415</span><a name="line.1415"></a>
+<span class="sourceLineNo">1416</span> @Override<a name="line.1416"></a>
+<span class="sourceLineNo">1417</span> public long getCurrentDataSize() {<a name="line.1417"></a>
+<span class="sourceLineNo">1418</span> return size();<a name="line.1418"></a>
+<span class="sourceLineNo">1419</span> }<a name="line.1419"></a>
+<span class="sourceLineNo">1420</span><a name="line.1420"></a>
+<span class="sourceLineNo">1421</span> @Override<a name="line.1421"></a>
+<span class="sourceLineNo">1422</span> public long getFreeSize() {<a name="line.1422"></a>
+<span class="sourceLineNo">1423</span> return this.bucketAllocator.getFreeSize();<a name="line.1423"></a>
+<span class="sourceLineNo">1424</span> }<a name="line.1424"></a>
+<span class="sourceLineNo">1425</span><a name="line.1425"></a>
+<span class="sourceLineNo">1426</span> @Override<a name="line.1426"></a>
+<span class="sourceLineNo">1427</span> public long getBlockCount() {<a name="line.1427"></a>
+<span class="sourceLineNo">1428</span> return this.blockNumber.sum();<a name="line.1428"></a>
+<span class="sourceLineNo">1429</span> }<a name="line.1429"></a>
+<span class="sourceLineNo">1430</span><a name="line.1430"></a>
+<span class="sourceLineNo">1431</span> @Override<a name="line.1431"></a>
+<span class="sourceLineNo">1432</span> public long getDataBlockCount() {<a name="line.1432"></a>
+<span class="sourceLineNo">1433</span> return getBlockCount();<a name="line.1433"></a>
+<span class="sourceLineNo">1434</span> }<a name="line.1434"></a>
+<span class="sourceLineNo">1435</span><a name="line.1435"></a>
+<span class="sourceLineNo">1436</span> @Override<a name="line.1436"></a>
+<span class="sourceLineNo">1437</span> public long getCurrentSize() {<a name="line.1437"></a>
+<span class="sourceLineNo">1438</span> return this.bucketAllocator.getUsedSize();<a name="line.1438"></a>
+<span class="sourceLineNo">1439</span> }<a name="line.1439"></a>
+<span class="sourceLineNo">1440</span><a name="line.1440"></a>
+<span class="sourceLineNo">1441</span> protected String getAlgorithm() {<a name="line.1441"></a>
+<span class="sourceLineNo">1442</span> return algorithm;<a name="line.1442"></a>
+<span class="sourceLineNo">1443</span> }<a name="line.1443"></a>
+<span class="sourceLineNo">1444</span><a name="line.1444"></a>
+<span class="sourceLineNo">1445</span> /**<a name="line.1445"></a>
+<span class="sourceLineNo">1446</span> * Evicts all blocks for a specific HFile.<a name="line.1446"></a>
+<span class="sourceLineNo">1447</span> * <p><a name="line.1447"></a>
+<span class="sourceLineNo">1448</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1448"></a>
+<span class="sourceLineNo">1449</span> * @return the number of blocks evicted<a name="line.1449"></a>
+<span class="sourceLineNo">1450</span> */<a name="line.1450"></a>
+<span class="sourceLineNo">1451</span> @Override<a name="line.1451"></a>
+<span class="sourceLineNo">1452</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1452"></a>
+<span class="sourceLineNo">1453</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1453"></a>
+<span class="sourceLineNo">1454</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1454"></a>
+<span class="sourceLineNo">1455</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1455"></a>
+<span class="sourceLineNo">1456</span><a name="line.1456"></a>
+<span class="sourceLineNo">1457</span> int numEvicted = 0;<a name="line.1457"></a>
+<span class="sourceLineNo">1458</span> for (BlockCacheKey key : keySet) {<a name="line.1458"></a>
+<span class="sourceLineNo">1459</span> if (evictBlock(key)) {<a name="line.1459"></a>
+<span class="sourceLineNo">1460</span> ++numEvicted;<a name="line.1460"></a>
+<span class="sourceLineNo">1461</span> }<a name="line.1461"></a>
+<span class="sourceLineNo">1462</span> }<a name="line.1462"></a>
+<span class="sourceLineNo">1463</span><a name="line.1463"></a>
+<span class="sourceLineNo">1464</span> return numEvicted;<a name="line.1464"></a>
+<span class="sourceLineNo">1465</span> }<a name="line.1465"></a>
+<span class="sourceLineNo">1466</span><a name="line.1466"></a>
+<span class="sourceLineNo">1467</span> /**<a name="line.1467"></a>
+<span class="sourceLineNo">1468</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1468"></a>
+<span class="sourceLineNo">1469</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1469"></a>
+<span class="sourceLineNo">1470</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1470"></a>
+<span class="sourceLineNo">1471</span> */<a name="line.1471"></a>
+<span class="sourceLineNo">1472</span> private class BucketEntryGroup {<a name="line.1472"></a>
+<span class="sourceLineNo">1473</span><a name="line.1473"></a>
+<span class="sourceLineNo">1474</span> private CachedEntryQueue queue;<a name="line.1474"></a>
+<span class="sourceLineNo">1475</span> private long totalSize = 0;<a name="line.1475"></a>
+<span class="sourceLineNo">1476</span> private long bucketSize;<a name="line.1476"></a>
<span class="sourceLineNo">1477</span><a name="line.1477"></a>
-<span class="sourceLineNo">1478</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1478"></a>
-<span class="sourceLineNo">1479</span> totalSize += block.getValue().getLength();<a name="line.1479"></a>
-<span class="sourceLineNo">1480</span> queue.add(block);<a name="line.1480"></a>
-<span class="sourceLineNo">1481</span> }<a name="line.1481"></a>
-<span class="sourceLineNo">1482</span><a name="line.1482"></a>
-<span class="sourceLineNo">1483</span> public long free(long toFree) {<a name="line.1483"></a>
-<span class="sourceLineNo">1484</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1484"></a>
-<span class="sourceLineNo">1485</span> long freedBytes = 0;<a name="line.1485"></a>
-<span class="sourceLineNo">1486</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1486"></a>
-<span class="sourceLineNo">1487</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1487"></a>
-<span class="sourceLineNo">1488</span> while ((entry = queue.pollLast()) != null) {<a name="line.1488"></a>
-<span class="sourceLineNo">1489</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1489"></a>
-<span class="sourceLineNo">1490</span> BucketEntry be = entry.getValue();<a name="line.1490"></a>
-<span class="sourceLineNo">1491</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1491"></a>
-<span class="sourceLineNo">1492</span> freedBytes += be.getLength();<a name="line.1492"></a>
-<span class="sourceLineNo">1493</span> }<a name="line.1493"></a>
-<span class="sourceLineNo">1494</span> if (freedBytes >= toFree) {<a name="line.1494"></a>
-<span class="sourceLineNo">1495</span> return freedBytes;<a name="line.1495"></a>
-<span class="sourceLineNo">1496</span> }<a name="line.1496"></a>
-<span class="sourceLineNo">1497</span> }<a name="line.1497"></a>
-<span class="sourceLineNo">1498</span> return freedBytes;<a name="line.1498"></a>
-<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
-<span class="sourceLineNo">1500</span><a name="line.1500"></a>
-<span class="sourceLineNo">1501</span> public long overflow() {<a name="line.1501"></a>
-<span class="sourceLineNo">1502</span> return totalSize - bucketSize;<a name="line.1502"></a>
-<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
-<span class="sourceLineNo">1504</span><a name="line.1504"></a>
-<span class="sourceLineNo">1505</span> public long totalSize() {<a name="line.1505"></a>
-<span class="sourceLineNo">1506</span> return totalSize;<a name="line.1506"></a>
-<span class="sourceLineNo">1507</span> }<a name="line.1507"></a>
-<span class="sourceLineNo">1508</span> }<a name="line.1508"></a>
-<span class="sourceLineNo">1509</span><a name="line.1509"></a>
-<span class="sourceLineNo">1510</span> /**<a name="line.1510"></a>
-<span class="sourceLineNo">1511</span> * Block Entry stored in the memory with key,data and so on<a name="line.1511"></a>
-<span class="sourceLineNo">1512</span> */<a name="line.1512"></a>
-<span class="sourceLineNo">1513</span> static class RAMQueueEntry {<a name="line.1513"></a>
-<span class="sourceLineNo">1514</span> private final BlockCacheKey key;<a name="line.1514"></a>
-<span class="sourceLineNo">1515</span> private final Cacheable data;<a name="line.1515"></a>
-<span class="sourceLineNo">1516</span> private long accessCounter;<a name="line.1516"></a>
-<span class="sourceLineNo">1517</span> private boolean inMemory;<a name="line.1517"></a>
-<span class="sourceLineNo">1518</span><a name="line.1518"></a>
-<span class="sourceLineNo">1519</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1519"></a>
-<span class="sourceLineNo">1520</span> this.key = bck;<a name="line.1520"></a>
-<span class="sourceLineNo">1521</span> this.data = data;<a name="line.1521"></a>
-<span class="sourceLineNo">1522</span> this.accessCounter = accessCounter;<a name="line.1522"></a>
-<span class="sourceLineNo">1523</span> this.inMemory = inMemory;<a name="line.1523"></a>
-<span class="sourceLineNo">1524</span> }<a name="line.1524"></a>
-<span class="sourceLineNo">1525</span><a name="line.1525"></a>
-<span class="sourceLineNo">1526</span> public Cacheable getData() {<a name="line.1526"></a>
-<span class="sourceLineNo">1527</span> return data;<a name="line.1527"></a>
-<span class="sourceLineNo">1528</span> }<a name="line.1528"></a>
-<span class="sourceLineNo">1529</span><a name="line.1529"></a>
-<span class="sourceLineNo">1530</span> public BlockCacheKey getKey() {<a name="line.1530"></a>
-<span class="sourceLineNo">1531</span> return key;<a name="line.1531"></a>
-<span class="sourceLineNo">1532</span> }<a name="line.1532"></a>
-<span class="sourceLineNo">1533</span><a name="line.1533"></a>
-<span class="sourceLineNo">1534</span> public void access(long accessCounter) {<a name="line.1534"></a>
-<span class="sourceLineNo">1535</span> this.accessCounter = accessCounter;<a name="line.1535"></a>
-<span class="sourceLineNo">1536</span> }<a name="line.1536"></a>
-<span class="sourceLineNo">1537</span><a name="line.1537"></a>
-<span class="sourceLineNo">1538</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1538"></a>
-<span class="sourceLineNo">1539</span> if (data instanceof HFileBlock) {<a name="line.1539"></a>
-<span class="sourceLineNo">1540</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1540"></a>
-<span class="sourceLineNo">1541</span> }<a name="line.1541"></a>
-<span class="sourceLineNo">1542</span> return ByteBuffAllocator.HEAP;<a name="line.1542"></a>
-<span class="sourceLineNo">1543</span> }<a name="line.1543"></a>
-<span class="sourceLineNo">1544</span><a name="line.1544"></a>
-<span class="sourceLineNo">1545</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1545"></a>
-<span class="sourceLineNo">1546</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1546"></a>
-<span class="sourceLineNo">1547</span> ByteBuffer metaBuff) throws IOException {<a name="line.1547"></a>
-<span class="sourceLineNo">1548</span> int len = data.getSerializedLength();<a name="line.1548"></a>
-<span class="sourceLineNo">1549</span> // This cacheable thing can't be serialized<a name="line.1549"></a>
-<span class="sourceLineNo">1550</span> if (len == 0) {<a name="line.1550"></a>
-<span class="sourceLineNo">1551</span> return null;<a name="line.1551"></a>
-<span class="sourceLineNo">1552</span> }<a name="line.1552"></a>
-<span class="sourceLineNo">1553</span> long offset = alloc.allocateBlock(len);<a name="line.1553"></a>
-<span class="sourceLineNo">1554</span> boolean succ = false;<a name="line.1554"></a>
-<span class="sourceLineNo">1555</span> BucketEntry bucketEntry = null;<a name="line.1555"></a>
-<span class="sourceLineNo">1556</span> try {<a name="line.1556"></a>
-<span class="sourceLineNo">1557</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1557"></a>
-<span class="sourceLineNo">1558</span> getByteBuffAllocator());<a name="line.1558"></a>
-<span class="sourceLineNo">1559</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1559"></a>
-<span class="sourceLineNo">1560</span> if (data instanceof HFileBlock) {<a name="line.1560"></a>
-<span class="sourceLineNo">1561</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1561"></a>
-<span class="sourceLineNo">1562</span> HFileBlock block = (HFileBlock) data;<a name="line.1562"></a>
-<span class="sourceLineNo">1563</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1563"></a>
-<span class="sourceLineNo">1564</span> block.getMetaData(metaBuff);<a name="line.1564"></a>
-<span class="sourceLineNo">1565</span> ioEngine.write(sliceBuf, offset);<a name="line.1565"></a>
-<span class="sourceLineNo">1566</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1566"></a>
-<span class="sourceLineNo">1567</span> } else {<a name="line.1567"></a>
-<span class="sourceLineNo">1568</span> // Only used for testing.<a name="line.1568"></a>
-<span class="sourceLineNo">1569</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1569"></a>
-<span class="sourceLineNo">1570</span> data.serialize(bb, true);<a name="line.1570"></a>
-<span class="sourceLineNo">1571</span> ioEngine.write(bb, offset);<a name="line.1571"></a>
-<span class="sourceLineNo">1572</span> }<a name="line.1572"></a>
-<span class="sourceLineNo">1573</span> succ = true;<a name="line.1573"></a>
-<span class="sourceLineNo">1574</span> } finally {<a name="line.1574"></a>
-<span class="sourceLineNo">1575</span> if (!succ) {<a name="line.1575"></a>
-<span class="sourceLineNo">1576</span> alloc.freeBlock(offset, len);<a name="line.1576"></a>
-<span class="sourceLineNo">1577</span> }<a name="line.1577"></a>
-<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
-<span class="sourceLineNo">1579</span> realCacheSize.add(len);<a name="line.1579"></a>
-<span class="sourceLineNo">1580</span> return bucketEntry;<a name="line.1580"></a>
-<span class="sourceLineNo">1581</span> }<a name="line.1581"></a>
-<span class="sourceLineNo">1582</span> }<a name="line.1582"></a>
-<span class="sourceLineNo">1583</span><a name="line.1583"></a>
-<span class="sourceLineNo">1584</span> /**<a name="line.1584"></a>
-<span class="sourceLineNo">1585</span> * Only used in test<a name="line.1585"></a>
-<span class="sourceLineNo">1586</span> */<a name="line.1586"></a>
-<span class="sourceLineNo">1587</span> void stopWriterThreads() throws InterruptedException {<a name="line.1587"></a>
-<span class="sourceLineNo">1588</span> for (WriterThread writerThread : writerThreads) {<a name="line.1588"></a>
-<span class="sourceLineNo">1589</span> writerThread.disableWriter();<a name="line.1589"></a>
-<span class="sourceLineNo">1590</span> writerThread.interrupt();<a name="line.1590"></a>
-<span class="sourceLineNo">1591</span> writerThread.join();<a name="line.1591"></a>
-<span class="sourceLineNo">1592</span> }<a name="line.1592"></a>
-<span class="sourceLineNo">1593</span> }<a name="line.1593"></a>
-<span class="sourceLineNo">1594</span><a name="line.1594"></a>
-<span class="sourceLineNo">1595</span> @Override<a name="line.1595"></a>
-<span class="sourceLineNo">1596</span> public Iterator<CachedBlock> iterator() {<a name="line.1596"></a>
-<span class="sourceLineNo">1597</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1597"></a>
-<span class="sourceLineNo">1598</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1598"></a>
-<span class="sourceLineNo">1599</span> return new Iterator<CachedBlock>() {<a name="line.1599"></a>
-<span class="sourceLineNo">1600</span> private final long now = System.nanoTime();<a name="line.1600"></a>
-<span class="sourceLineNo">1601</span><a name="line.1601"></a>
-<span class="sourceLineNo">1602</span> @Override<a name="line.1602"></a>
-<span class="sourceLineNo">1603</span> public boolean hasNext() {<a name="line.1603"></a>
-<span class="sourceLineNo">1604</span> return i.hasNext();<a name="line.1604"></a>
-<span class="sourceLineNo">1605</span> }<a name="line.1605"></a>
-<span class="sourceLineNo">1606</span><a name="line.1606"></a>
-<span class="sourceLineNo">1607</span> @Override<a name="line.1607"></a>
-<span class="sourceLineNo">1608</span> public CachedBlock next() {<a name="line.1608"></a>
-<span class="sourceLineNo">1609</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1609"></a>
-<span class="sourceLineNo">1610</span> return new CachedBlock() {<a name="line.1610"></a>
-<span class="sourceLineNo">1611</span> @Override<a name="line.1611"></a>
-<span class="sourceLineNo">1612</span> public String toString() {<a name="line.1612"></a>
-<span class="sourceLineNo">1613</span> return BlockCacheUtil.toString(this, now);<a name="line.1613"></a>
-<span class="sourceLineNo">1614</span> }<a name="line.1614"></a>
-<span class="sourceLineNo">1615</span><a name="line.1615"></a>
-<span class="sourceLineNo">1616</span> @Override<a name="line.1616"></a>
-<span class="sourceLineNo">1617</span> public BlockPriority getBlockPriority() {<a name="line.1617"></a>
-<span class="sourceLineNo">1618</span> return e.getValue().getPriority();<a name="line.1618"></a>
-<span class="sourceLineNo">1619</span> }<a name="line.1619"></a>
-<span class="sourceLineNo">1620</span><a name="line.1620"></a>
-<span class="sourceLineNo">1621</span> @Override<a name="line.1621"></a>
-<span class="sourceLineNo">1622</span> public BlockType getBlockType() {<a name="line.1622"></a>
-<span class="sourceLineNo">1623</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1623"></a>
-<span class="sourceLineNo">1624</span> return null;<a name="line.1624"></a>
+<span class="sourceLineNo">1478</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1478"></a>
+<span class="sourceLineNo">1479</span> this.bucketSize = bucketSize;<a name="line.1479"></a>
+<span class="sourceLineNo">1480</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1480"></a>
+<span class="sourceLineNo">1481</span> totalSize = 0;<a name="line.1481"></a>
+<span class="sourceLineNo">1482</span> }<a name="line.1482"></a>
+<span class="sourceLineNo">1483</span><a name="line.1483"></a>
+<span class="sourceLineNo">1484</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1484"></a>
+<span class="sourceLineNo">1485</span> totalSize += block.getValue().getLength();<a name="line.1485"></a>
+<span class="sourceLineNo">1486</span> queue.add(block);<a name="line.1486"></a>
+<span class="sourceLineNo">1487</span> }<a name="line.1487"></a>
+<span class="sourceLineNo">1488</span><a name="line.1488"></a>
+<span class="sourceLineNo">1489</span> public long free(long toFree) {<a name="line.1489"></a>
+<span class="sourceLineNo">1490</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1490"></a>
+<span class="sourceLineNo">1491</span> long freedBytes = 0;<a name="line.1491"></a>
+<span class="sourceLineNo">1492</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1492"></a>
+<span class="sourceLineNo">1493</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1493"></a>
+<span class="sourceLineNo">1494</span> while ((entry = queue.pollLast()) != null) {<a name="line.1494"></a>
+<span class="sourceLineNo">1495</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1495"></a>
+<span class="sourceLineNo">1496</span> BucketEntry be = entry.getValue();<a name="line.1496"></a>
+<span class="sourceLineNo">1497</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1497"></a>
+<span class="sourceLineNo">1498</span> freedBytes += be.getLength();<a name="line.1498"></a>
+<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
+<span class="sourceLineNo">1500</span> if (freedBytes >= toFree) {<a name="line.1500"></a>
+<span class="sourceLineNo">1501</span> return freedBytes;<a name="line.1501"></a>
+<span class="sourceLineNo">1502</span> }<a name="line.1502"></a>
+<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
+<span class="sourceLineNo">1504</span> return freedBytes;<a name="line.1504"></a>
+<span class="sourceLineNo">1505</span> }<a name="line.1505"></a>
+<span class="sourceLineNo">1506</span><a name="line.1506"></a>
+<span class="sourceLineNo">1507</span> public long overflow() {<a name="line.1507"></a>
+<span class="sourceLineNo">1508</span> return totalSize - bucketSize;<a name="line.1508"></a>
+<span class="sourceLineNo">1509</span> }<a name="line.1509"></a>
+<span class="sourceLineNo">1510</span><a name="line.1510"></a>
+<span class="sourceLineNo">1511</span> public long totalSize() {<a name="line.1511"></a>
+<span class="sourceLineNo">1512</span> return totalSize;<a name="line.1512"></a>
+<span class="sourceLineNo">1513</span> }<a name="line.1513"></a>
+<span class="sourceLineNo">1514</span> }<a name="line.1514"></a>
+<span class="sourceLineNo">1515</span><a name="line.1515"></a>
+<span class="sourceLineNo">1516</span> /**<a name="line.1516"></a>
+<span class="sourceLineNo">1517</span> * Block Entry stored in the memory with key,data and so on<a name="line.1517"></a>
+<span class="sourceLineNo">1518</span> */<a name="line.1518"></a>
+<span class="sourceLineNo">1519</span> static class RAMQueueEntry {<a name="line.1519"></a>
+<span class="sourceLineNo">1520</span> private final BlockCacheKey key;<a name="line.1520"></a>
+<span class="sourceLineNo">1521</span> private final Cacheable data;<a name="line.1521"></a>
+<span class="sourceLineNo">1522</span> private long accessCounter;<a name="line.1522"></a>
+<span class="sourceLineNo">1523</span> private boolean inMemory;<a name="line.1523"></a>
+<span class="sourceLineNo">1524</span><a name="line.1524"></a>
+<span class="sourceLineNo">1525</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1525"></a>
+<span class="sourceLineNo">1526</span> this.key = bck;<a name="line.1526"></a>
+<span class="sourceLineNo">1527</span> this.data = data;<a name="line.1527"></a>
+<span class="sourceLineNo">1528</span> this.accessCounter = accessCounter;<a name="line.1528"></a>
+<span class="sourceLineNo">1529</span> this.inMemory = inMemory;<a name="line.1529"></a>
+<span class="sourceLineNo">1530</span> }<a name="line.1530"></a>
+<span class="sourceLineNo">1531</span><a name="line.1531"></a>
+<span class="sourceLineNo">1532</span> public Cacheable getData() {<a name="line.1532"></a>
+<span class="sourceLineNo">1533</span> return data;<a name="line.1533"></a>
+<span class="sourceLineNo">1534</span> }<a name="line.1534"></a>
+<span class="sourceLineNo">1535</span><a name="line.1535"></a>
+<span class="sourceLineNo">1536</span> public BlockCacheKey getKey() {<a name="line.1536"></a>
+<span class="sourceLineNo">1537</span> return key;<a name="line.1537"></a>
+<span class="sourceLineNo">1538</span> }<a name="line.1538"></a>
+<span class="sourceLineNo">1539</span><a name="line.1539"></a>
+<span class="sourceLineNo">1540</span> public void access(long accessCounter) {<a name="line.1540"></a>
+<span class="sourceLineNo">1541</span> this.accessCounter = accessCounter;<a name="line.1541"></a>
+<span class="sourceLineNo">1542</span> }<a name="line.1542"></a>
+<span class="sourceLineNo">1543</span><a name="line.1543"></a>
+<span class="sourceLineNo">1544</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1544"></a>
+<span class="sourceLineNo">1545</span> if (data instanceof HFileBlock) {<a name="line.1545"></a>
+<span class="sourceLineNo">1546</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1546"></a>
+<span class="sourceLineNo">1547</span> }<a name="line.1547"></a>
+<span class="sourceLineNo">1548</span> return ByteBuffAllocator.HEAP;<a name="line.1548"></a>
+<span class="sourceLineNo">1549</span> }<a name="line.1549"></a>
+<span class="sourceLineNo">1550</span><a name="line.1550"></a>
+<span class="sourceLineNo">1551</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1551"></a>
+<span class="sourceLineNo">1552</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1552"></a>
+<span class="sourceLineNo">1553</span> ByteBuffer metaBuff) throws IOException {<a name="line.1553"></a>
+<span class="sourceLineNo">1554</span> int len = data.getSerializedLength();<a name="line.1554"></a>
+<span class="sourceLineNo">1555</span> // This cacheable thing can't be serialized<a name="line.1555"></a>
+<span class="sourceLineNo">1556</span> if (len == 0) {<a name="line.1556"></a>
+<span class="sourceLineNo">1557</span> return null;<a name="line.1557"></a>
+<span class="sourceLineNo">1558</span> }<a name="line.1558"></a>
+<span class="sourceLineNo">1559</span> long offset = alloc.allocateBlock(len);<a name="line.1559"></a>
+<span class="sourceLineNo">1560</span> boolean succ = false;<a name="line.1560"></a>
+<span class="sourceLineNo">1561</span> BucketEntry bucketEntry = null;<a name="line.1561"></a>
+<span class="sourceLineNo">1562</span> try {<a name="line.1562"></a>
+<span class="sourceLineNo">1563</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1563"></a>
+<span class="sourceLineNo">1564</span> getByteBuffAllocator());<a name="line.1564"></a>
+<span class="sourceLineNo">1565</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1565"></a>
+<span class="sourceLineNo">1566</span> if (data instanceof HFileBlock) {<a name="line.1566"></a>
+<span class="sourceLineNo">1567</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1567"></a>
+<span class="sourceLineNo">1568</span> HFileBlock block = (HFileBlock) data;<a name="line.1568"></a>
+<span class="sourceLineNo">1569</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1569"></a>
+<span class="sourceLineNo">1570</span> block.getMetaData(metaBuff);<a name="line.1570"></a>
+<span class="sourceLineNo">1571</span> ioEngine.write(sliceBuf, offset);<a name="line.1571"></a>
+<span class="sourceLineNo">1572</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1572"></a>
+<span class="sourceLineNo">1573</span> } else {<a name="line.1573"></a>
+<span class="sourceLineNo">1574</span> // Only used for testing.<a name="line.1574"></a>
+<span class="sourceLineNo">1575</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1575"></a>
+<span class="sourceLineNo">1576</span> data.serialize(bb, true);<a name="line.1576"></a>
+<span class="sourceLineNo">1577</span> ioEngine.write(bb, offset);<a name="line.1577"></a>
+<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
+<span class="sourceLineNo">1579</span> succ = true;<a name="line.1579"></a>
+<span class="sourceLineNo">1580</span> } finally {<a name="line.1580"></a>
+<span class="sourceLineNo">1581</span> if (!succ) {<a name="line.1581"></a>
+<span class="sourceLineNo">1582</span> alloc.freeBlock(offset, len);<a name="line.1582"></a>
+<span class="sourceLineNo">1583</span> }<a name="line.1583"></a>
+<span class="sourceLineNo">1584</span> }<a name="line.1584"></a>
+<span class="sourceLineNo">1585</span> realCacheSize.add(len);<a name="line.1585"></a>
+<span class="sourceLineNo">1586</span> return bucketEntry;<a name="line.1586"></a>
+<span class="sourceLineNo">1587</span> }<a name="line.1587"></a>
+<span class="sourceLineNo">1588</span> }<a name="line.1588"></a>
+<span class="sourceLineNo">1589</span><a name="line.1589"></a>
+<span class="sourceLineNo">1590</span> /**<a name="line.1590"></a>
+<span class="sourceLineNo">1591</span> * Only used in test<a name="line.1591"></a>
+<span class="sourceLineNo">1592</span> */<a name="line.1592"></a>
+<span class="sourceLineNo">1593</span> void stopWriterThreads() throws InterruptedException {<a name="line.1593"></a>
+<span class="sourceLineNo">1594</span> for (WriterThread writerThread : writerThreads) {<a name="line.1594"></a>
+<span class="sourceLineNo">1595</span> writerThread.disableWriter();<a name="line.1595"></a>
+<span class="sourceLineNo">1596</span> writerThread.interrupt();<a name="line.1596"></a>
+<span class="sourceLineNo">1597</span> writerThread.join();<a name="line.1597"></a>
+<span class="sourceLineNo">1598</span> }<a name="line.1598"></a>
+<span class="sourceLineNo">1599</span> }<a name="line.1599"></a>
+<span class="sourceLineNo">1600</span><a name="line.1600"></a>
+<span class="sourceLineNo">1601</span> @Override<a name="line.1601"></a>
+<span class="sourceLineNo">1602</span> public Iterator<CachedBlock> iterator() {<a name="line.1602"></a>
+<span class="sourceLineNo">1603</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1603"></a>
+<span class="sourceLineNo">1604</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1604"></a>
+<span class="sourceLineNo">1605</span> return new Iterator<CachedBlock>() {<a name="line.1605"></a>
+<span class="sourceLineNo">1606</span> private final long now = System.nanoTime();<a name="line.1606"></a>
+<span class="sourceLineNo">1607</span><a name="line.1607"></a>
+<span class="sourceLineNo">1608</span> @Override<a name="line.1608"></a>
+<span class="sourceLineNo">1609</span> public boolean hasNext() {<a name="line.1609"></a>
+<span class="sourceLineNo">1610</span> return i.hasNext();<a name="line.1610"></a>
+<span class="sourceLineNo">1611</span> }<a name="line.1611"></a>
+<span class="sourceLineNo">1612</span><a name="line.1612"></a>
+<span class="sourceLineNo">1613</span> @Override<a name="line.1613"></a>
+<span class="sourceLineNo">1614</span> public CachedBlock next() {<a name="line.1614"></a>
+<span class="sourceLineNo">1615</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1615"></a>
+<span class="sourceLineNo">1616</span> return new CachedBlock() {<a name="line.1616"></a>
+<span class="sourceLineNo">1617</span> @Override<a name="line.1617"></a>
+<span class="sourceLineNo">1618</span> public String toString() {<a name="line.1618"></a>
+<span class="sourceLineNo">1619</span> return BlockCacheUtil.toString(this, now);<a name="line.1619"></a>
+<span class="sourceLineNo">1620</span> }<a name="line.1620"></a>
+<span class="sourceLineNo">1621</span><a name="line.1621"></a>
+<span class="sourceLineNo">1622</span> @Override<a name="line.1622"></a>
+<span class="sourceLineNo">1623</span> public BlockPriority getBlockPriority() {<a name="line.1623"></a>
+<span class="sourceLineNo">1624</span> return e.getValue().getPriority();<a name="line.1624"></a>
<span class="sourceLineNo">1625</span> }<a name="line.1625"></a>
<span class="sourceLineNo">1626</span><a name="line.1626"></a>
<span class="sourceLineNo">1627</span> @Override<a name="line.1627"></a>
-<span class="sourceLineNo">1628</span> public long getOffset() {<a name="line.1628"></a>
-<span class="sourceLineNo">1629</span> return e.getKey().getOffset();<a name="line.1629"></a>
-<span class="sourceLineNo">1630</span> }<a name="line.1630"></a>
-<span class="sourceLineNo">1631</span><a name="line.1631"></a>
-<span class="sourceLineNo">1632</span> @Override<a name="line.1632"></a>
-<span class="sourceLineNo">1633</span> public long getSize() {<a name="line.1633"></a>
-<span class="sourceLineNo">1634</span> return e.getValue().getLength();<a name="line.1634"></a>
-<span class="sourceLineNo">1635</span> }<a name="line.1635"></a>
-<span class="sourceLineNo">1636</span><a name="line.1636"></a>
-<span class="sourceLineNo">1637</span> @Override<a name="line.1637"></a>
-<span class="sourceLineNo">1638</span> public long getCachedTime() {<a name="line.1638"></a>
-<span class="sourceLineNo">1639</span> return e.getValue().getCachedTime();<a name="line.1639"></a>
-<span class="sourceLineNo">1640</span> }<a name="line.1640"></a>
-<span class="sourceLineNo">1641</span><a name="line.1641"></a>
-<span class="sourceLineNo">1642</span> @Override<a name="line.1642"></a>
-<span class="sourceLineNo">1643</span> public String getFilename() {<a name="line.1643"></a>
-<span class="sourceLineNo">1644</span> return e.getKey().getHfileName();<a name="line.1644"></a>
-<span class="sourceLineNo">1645</span> }<a name="line.1645"></a>
-<span class="sourceLineNo">1646</span><a name="line.1646"></a>
-<span class="sourceLineNo">1647</span> @Override<a name="line.1647"></a>
-<span class="sourceLineNo">1648</span> public int compareTo(CachedBlock other) {<a name="line.1648"></a>
-<span class="sourceLineNo">1649</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1649"></a>
-<span class="sourceLineNo">1650</span> if (diff != 0) return diff;<a name="line.1650"></a>
-<span class="sourceLineNo">1651</span><a name="line.1651"></a>
-<span class="sourceLineNo">1652</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1652"></a>
-<span class="sourceLineNo">1653</span> if (diff != 0) return diff;<a name="line.1653"></a>
-<span class="sourceLineNo">1654</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1654"></a>
-<span class="sourceLineNo">1655</span> throw new IllegalStateException(<a name="line.1655"></a>
-<span class="sourceLineNo">1656</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1656"></a>
-<span class="sourceLineNo">1657</span> }<a name="line.1657"></a>
-<span class="sourceLineNo">1658</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1658"></a>
-<span class="sourceLineNo">1659</span> }<a name="line.1659"></a>
-<span class="sourceLineNo">1660</span><a name="line.1660"></a>
-<span class="sourceLineNo">1661</span> @Override<a name="line.1661"></a>
-<span class="sourceLineNo">1662</span> public int hashCode() {<a name="line.1662"></a>
-<span class="sourceLineNo">1663</span> return e.getKey().hashCode();<a name="line.1663"></a>
-<span class="sourceLineNo">1664</span> }<a name="line.1664"></a>
-<span class="sourceLineNo">1665</span><a name="line.1665"></a>
-<span class="sourceLineNo">1666</span> @Override<a name="line.1666"></a>
-<span class="sourceLineNo">1667</span> public boolean equals(Object obj) {<a name="line.1667"></a>
-<span class="sourceLineNo">1668</span> if (obj instanceof CachedBlock) {<a name="line.1668"></a>
-<span class="sourceLineNo">1669</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1669"></a>
-<span class="sourceLineNo">1670</span> return compareTo(cb) == 0;<a name="line.1670"></a>
-<span class="sourceLineNo">1671</span> } else {<a name="line.1671"></a>
-<span class="sourceLineNo">1672</span> return false;<a name="line.1672"></a>
-<span class="sourceLineNo">1673</span> }<a name="line.1673"></a>
-<span class="sourceLineNo">1674</span> }<a name="line.1674"></a>
-<span class="sourceLineNo">1675</span> };<a name="line.1675"></a>
-<span class="sourceLineNo">1676</span> }<a name="line.1676"></a>
-<span class="sourceLineNo">1677</span><a name="line.1677"></a>
-<span class="sourceLineNo">1678</span> @Override<a name="line.1678"></a>
-<span class="sourceLineNo">1679</span> public void remove() {<a name="line.1679"></a>
-<span class="sourceLineNo">1680</span> throw new UnsupportedOperationException();<a name="line.1680"></a>
-<span class="sourceLineNo">1681</span> }<a name="line.1681"></a>
-<span class="sourceLineNo">1682</span> };<a name="line.1682"></a>
-<span class="sourceLineNo">1683</span> }<a name="line.1683"></a>
-<span class="sourceLineNo">1684</span><a name="line.1684"></a>
-<span class="sourceLineNo">1685</span> @Override<a name="line.1685"></a>
-<span class="sourceLineNo">1686</span> public BlockCache[] getBlockCaches() {<a name="line.1686"></a>
-<span class="sourceLineNo">1687</span> return null;<a name="line.1687"></a>
-<span class="sourceLineNo">1688</span> }<a name="line.1688"></a>
-<span class="sourceLineNo">1689</span><a name="line.1689"></a>
-<span class="sourceLineNo">1690</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1690"></a>
-<span class="sourceLineNo">1691</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1691"></a>
-<span class="sourceLineNo">1692</span> if (bucketEntry != null) {<a name="line.1692"></a>
-<span class="sourceLineNo">1693</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1693"></a>
-<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
-<span class="sourceLineNo">1695</span> return 0;<a name="line.1695"></a>
-<span class="sourceLineNo">1696</span> }<a name="line.1696"></a>
-<span class="sourceLineNo">1697</span><a name="line.1697"></a>
-<span class="sourceLineNo">1698</span> float getAcceptableFactor() {<a name="line.1698"></a>
-<span class="sourceLineNo">1699</span> return acceptableFactor;<a name="line.1699"></a>
-<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
-<span class="sourceLineNo">1701</span><a name="line.1701"></a>
-<span class="sourceLineNo">1702</span> float getMinFactor() {<a name="line.1702"></a>
-<span class="sourceLineNo">1703</span> return minFactor;<a name="line.1703"></a>
-<span class="sourceLineNo">1704</span> }<a name="line.1704"></a>
-<span class="sourceLineNo">1705</span><a name="line.1705"></a>
-<span class="sourceLineNo">1706</span> float getExtraFreeFactor() {<a name="line.1706"></a>
-<span class="sourceLineNo">1707</span> return extraFreeFactor;<a name="line.1707"></a>
-<span class="sourceLineNo">1708</span> }<a name="line.1708"></a>
-<span class="sourceLineNo">1709</span><a name="line.1709"></a>
-<span class="sourceLineNo">1710</span> float getSingleFactor() {<a name="line.1710"></a>
-<span class="sourceLineNo">1711</span> return singleFactor;<a name="line.1711"></a>
-<span class="sourceLineNo">1712</span> }<a name="line.1712"></a>
-<span class="sourceLineNo">1713</span><a name="line.1713"></a>
-<span class="sourceLineNo">1714</span> float getMultiFactor() {<a name="line.1714"></a>
-<span class="sourceLineNo">1715</span> return multiFactor;<a name="line.1715"></a>
-<span class="sourceLineNo">1716</span> }<a name="line.1716"></a>
-<span class="sourceLineNo">1717</span><a name="line.1717"></a>
-<span class="sourceLineNo">1718</span> float getMemoryFactor() {<a name="line.1718"></a>
-<span class="sourceLineNo">1719</span> return memoryFactor;<a name="line.1719"></a>
-<span class="sourceLineNo">1720</span> }<a name="line.1720"></a>
-<span class="sourceLineNo">1721</span><a name="line.1721"></a>
-<span class="sourceLineNo">1722</span> /**<a name="line.1722"></a>
-<span class="sourceLineNo">1723</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1723"></a>
-<span class="sourceLineNo">1724</span> */<a name="line.1724"></a>
-<span class="sourceLineNo">1725</span> static class RAMCache {<a name="line.1725"></a>
-<span class="sourceLineNo">1726</span> /**<a name="line.1726"></a>
-<span class="sourceLineNo">1727</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1727"></a>
-<span class="sourceLineNo">1728</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1728"></a>
-<span class="sourceLineNo">1729</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1729"></a>
-<span class="sourceLineNo">1730</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1730"></a>
-<span class="sourceLineNo">1731</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1731"></a>
-<span class="sourceLineNo">1732</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1732"></a>
-<span class="sourceLineNo">1733</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1733"></a>
-<span class="sourceLineNo">1734</span> */<a name="line.1734"></a>
-<span class="sourceLineNo">1735</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1735"></a>
-<span class="sourceLineNo">1736</span><a name="line.1736"></a>
-<span class="sourceLineNo">1737</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1737"></a>
-<span class="sourceLineNo">1738</span> return delegate.containsKey(key);<a name="line.1738"></a>
-<span class="sourceLineNo">1739</span> }<a name="line.1739"></a>
-<span class="sourceLineNo">1740</span><a name="line.1740"></a>
-<span class="sourceLineNo">1741</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1741"></a>
-<span class="sourceLineNo">1742</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1742"></a>
-<span class="sourceLineNo">1743</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1743"></a>
-<span class="sourceLineNo">1744</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1744"></a>
-<span class="sourceLineNo">1745</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1745"></a>
-<span class="sourceLineNo">1746</span> re.getData().retain();<a name="line.1746"></a>
-<span class="sourceLineNo">1747</span> return re;<a name="line.1747"></a>
-<span class="sourceLineNo">1748</span> });<a name="line.1748"></a>
-<span class="sourceLineNo">1749</span> }<a name="line.1749"></a>
-<span class="sourceLineNo">1750</span><a name="line.1750"></a>
-<span class="sourceLineNo">1751</span> /**<a name="line.1751"></a>
-<span class="sourceLineNo">1752</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1752"></a>
-<span class="sourceLineNo">1753</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1753"></a>
-<span class="sourceLineNo">1754</span> */<a name="line.1754"></a>
-<span class="sourceLineNo">1755</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1755"></a>
-<span class="sourceLineNo">1756</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1756"></a>
-<span class="sourceLineNo">1757</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1757"></a>
-<span class="sourceLineNo">1758</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1758"></a>
-<span class="sourceLineNo">1759</span> entry.getData().retain();<a name="line.1759"></a>
-<span class="sourceLineNo">1760</span> absent.set(true);<a name="line.1760"></a>
-<span class="sourceLineNo">1761</span> return entry;<a name="line.1761"></a>
-<span class="sourceLineNo">1762</span> });<a name="line.1762"></a>
-<span class="sourceLineNo">1763</span> return absent.get() ? null : re;<a name="line.1763"></a>
-<span class="sourceLineNo">1764</span> }<a name="line.1764"></a>
-<span class="sourceLineNo">1765</span><a name="line.1765"></a>
-<span class="sourceLineNo">1766</span> public boolean remove(BlockCacheKey key) {<a name="line.1766"></a>
-<span class="sourceLineNo">1767</span> return remove(key, re -> {<a name="line.1767"></a>
+<span class="sourceLineNo">1628</span> public BlockType getBlockType() {<a name="line.1628"></a>
+<span class="sourceLineNo">1629</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1629"></a>
+<span class="sourceLineNo">1630</span> return null;<a name="line.1630"></a>
+<span class="sourceLineNo">1631</span> }<a name="line.1631"></a>
+<span class="sourceLineNo">1632</span><a name="line.1632"></a>
+<span class="sourceLineNo">1633</span> @Override<a name="line.1633"></a>
+<span class="sourceLineNo">1634</span> public long getOffset() {<a name="line.1634"></a>
+<span class="sourceLineNo">1635</span> return e.getKey().getOffset();<a name="line.1635"></a>
+<span class="sourceLineNo">1636</span> }<a name="line.1636"></a>
+<span class="sourceLineNo">1637</span><a name="line.1637"></a>
+<span class="sourceLineNo">1638</span> @Override<a name="line.1638"></a>
+<span class="sourceLineNo">1639</span> public long getSize() {<a name="line.1639"></a>
+<span class="sourceLineNo">1640</span> return e.getValue().getLength();<a name="line.1640"></a>
+<span class="sourceLineNo">1641</span> }<a name="line.1641"></a>
+<span class="sourceLineNo">1642</span><a name="line.1642"></a>
+<span class="sourceLineNo">1643</span> @Override<a name="line.1643"></a>
+<span class="sourceLineNo">1644</span> public long getCachedTime() {<a name="line.1644"></a>
+<span class="sourceLineNo">1645</span> return e.getValue().getCachedTime();<a name="line.1645"></a>
+<span class="sourceLineNo">1646</span> }<a name="line.1646"></a>
+<span class="sourceLineNo">1647</span><a name="line.1647"></a>
+<span class="sourceLineNo">1648</span> @Override<a name="line.1648"></a>
+<span class="sourceLineNo">1649</span> public String getFilename() {<a name="line.1649"></a>
+<span class="sourceLineNo">1650</span> return e.getKey().getHfileName();<a name="line.1650"></a>
+<span class="sourceLineNo">1651</span> }<a name="line.1651"></a>
+<span class="sourceLineNo">1652</span><a name="line.1652"></a>
+<span class="sourceLineNo">1653</span> @Override<a name="line.1653"></a>
+<span class="sourceLineNo">1654</span> public int compareTo(CachedBlock other) {<a name="line.1654"></a>
+<span class="sourceLineNo">1655</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1655"></a>
+<span class="sourceLineNo">1656</span> if (diff != 0) return diff;<a name="line.1656"></a>
+<span class="sourceLineNo">1657</span><a name="line.1657"></a>
+<span class="sourceLineNo">1658</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1658"></a>
+<span class="sourceLineNo">1659</span> if (diff != 0) return diff;<a name="line.1659"></a>
+<span class="sourceLineNo">1660</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1660"></a>
+<span class="sourceLineNo">1661</span> throw new IllegalStateException(<a name="line.1661"></a>
+<span class="sourceLineNo">1662</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1662"></a>
+<span class="sourceLineNo">1663</span> }<a name="line.1663"></a>
+<span class="sourceLineNo">1664</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1664"></a>
+<span class="sourceLineNo">1665</span> }<a name="line.1665"></a>
+<span class="sourceLineNo">1666</span><a name="line.1666"></a>
+<span class="sourceLineNo">1667</span> @Override<a name="line.1667"></a>
+<span class="sourceLineNo">1668</span> public int hashCode() {<a name="line.1668"></a>
+<span class="sourceLineNo">1669</span> return e.getKey().hashCode();<a name="line.1669"></a>
+<span class="sourceLineNo">1670</span> }<a name="line.1670"></a>
+<span class="sourceLineNo">1671</span><a name="line.1671"></a>
+<span class="sourceLineNo">1672</span> @Override<a name="line.1672"></a>
+<span class="sourceLineNo">1673</span> public boolean equals(Object obj) {<a name="line.1673"></a>
+<span class="sourceLineNo">1674</span> if (obj instanceof CachedBlock) {<a name="line.1674"></a>
+<span class="sourceLineNo">1675</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1675"></a>
+<span class="sourceLineNo">1676</span> return compareTo(cb) == 0;<a name="line.1676"></a>
+<span class="sourceLineNo">1677</span> } else {<a name="line.1677"></a>
+<span class="sourceLineNo">1678</span> return false;<a name="line.1678"></a>
+<span class="sourceLineNo">1679</span> }<a name="line.1679"></a>
+<span class="sourceLineNo">1680</span> }<a name="line.1680"></a>
+<span class="sourceLineNo">1681</span> };<a name="line.1681"></a>
+<span class="sourceLineNo">1682</span> }<a name="line.1682"></a>
+<span class="sourceLineNo">1683</span><a name="line.1683"></a>
+<span class="sourceLineNo">1684</span> @Override<a name="line.1684"></a>
+<span class="sourceLineNo">1685</span> public void remove() {<a name="line.1685"></a>
+<span class="sourceLineNo">1686</span> throw new UnsupportedOperationException();<a name="line.1686"></a>
+<span class="sourceLineNo">1687</span> }<a name="line.1687"></a>
+<span class="sourceLineNo">1688</span> };<a name="line.1688"></a>
+<span class="sourceLineNo">1689</span> }<a name="line.1689"></a>
+<span class="sourceLineNo">1690</span><a name="line.1690"></a>
+<span class="sourceLineNo">1691</span> @Override<a name="line.1691"></a>
+<span class="sourceLineNo">1692</span> public BlockCache[] getBlockCaches() {<a name="line.1692"></a>
+<span class="sourceLineNo">1693</span> return null;<a name="line.1693"></a>
+<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
+<span class="sourceLineNo">1695</span><a name="line.1695"></a>
+<span class="sourceLineNo">1696</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1696"></a>
+<span class="sourceLineNo">1697</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1697"></a>
+<span class="sourceLineNo">1698</span> if (bucketEntry != null) {<a name="line.1698"></a>
+<span class="sourceLineNo">1699</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1699"></a>
+<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
+<span class="sourceLineNo">1701</span> return 0;<a name="line.1701"></a>
+<span class="sourceLineNo">1702</span> }<a name="line.1702"></a>
+<span class="sourceLineNo">1703</span><a name="line.1703"></a>
+<span class="sourceLineNo">1704</span> float getAcceptableFactor() {<a name="line.1704"></a>
+<span class="sourceLineNo">1705</span> return acceptableFactor;<a name="line.1705"></a>
+<span class="sourceLineNo">1706</span> }<a name="line.1706"></a>
+<span class="sourceLineNo">1707</span><a name="line.1707"></a>
+<span class="sourceLineNo">1708</span> float getMinFactor() {<a name="line.1708"></a>
+<span class="sourceLineNo">1709</span> return minFactor;<a name="line.1709"></a>
+<span class="sourceLineNo">1710</span> }<a name="line.1710"></a>
+<span class="sourceLineNo">1711</span><a name="line.1711"></a>
+<span class="sourceLineNo">1712</span> float getExtraFreeFactor() {<a name="line.1712"></a>
+<span class="sourceLineNo">1713</span> return extraFreeFactor;<a name="line.1713"></a>
+<span class="sourceLineNo">1714</span> }<a name="line.1714"></a>
+<span class="sourceLineNo">1715</span><a name="line.1715"></a>
+<span class="sourceLineNo">1716</span> float getSingleFactor() {<a name="line.1716"></a>
+<span class="sourceLineNo">1717</span> return singleFactor;<a name="line.1717"></a>
+<span class="sourceLineNo">1718</span> }<a name="line.1718"></a>
+<span class="sourceLineNo">1719</span><a name="line.1719"></a>
+<span class="sourceLineNo">1720</span> float getMultiFactor() {<a name="line.1720"></a>
+<span class="sourceLineNo">1721</span> return multiFactor;<a name="line.1721"></a>
+<span class="sourceLineNo">1722</span> }<a name="line.1722"></a>
+<span class="sourceLineNo">1723</span><a name="line.1723"></a>
+<span class="sourceLineNo">1724</span> float getMemoryFactor() {<a name="line.1724"></a>
+<span class="sourceLineNo">1725</span> return memoryFactor;<a name="line.1725"></a>
+<span class="sourceLineNo">1726</span> }<a name="line.1726"></a>
+<span class="sourceLineNo">1727</span><a name="line.1727"></a>
+<span class="sourceLineNo">1728</span> /**<a name="line.1728"></a>
+<span class="sourceLineNo">1729</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1729"></a>
+<span class="sourceLineNo">1730</span> */<a name="line.1730"></a>
+<span class="sourceLineNo">1731</span> static class RAMCache {<a name="line.1731"></a>
+<span class="sourceLineNo">1732</span> /**<a name="line.1732"></a>
+<span class="sourceLineNo">1733</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1733"></a>
+<span class="sourceLineNo">1734</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1734"></a>
+<span class="sourceLineNo">1735</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1735"></a>
+<span class="sourceLineNo">1736</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1736"></a>
+<span class="sourceLineNo">1737</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1737"></a>
+<span class="sourceLineNo">1738</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1738"></a>
+<span class="sourceLineNo">1739</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1739"></a>
+<span class="sourceLineNo">1740</span> */<a name="line.1740"></a>
+<span class="sourceLineNo">1741</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1741"></a>
+<span class="sourceLineNo">1742</span><a name="line.1742"></a>
+<span class="sourceLineNo">1743</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1743"></a>
+<span class="sourceLineNo">1744</span> return delegate.containsKey(key);<a name="line.1744"></a>
+<span class="sourceLineNo">1745</span> }<a name="line.1745"></a>
+<span class="sourceLineNo">1746</span><a name="line.1746"></a>
+<span class="sourceLineNo">1747</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1747"></a>
+<span class="sourceLineNo">1748</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1748"></a>
+<span class="sourceLineNo">1749</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1749"></a>
+<span class="sourceLineNo">1750</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1750"></a>
+<span class="sourceLineNo">1751</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1751"></a>
+<span class="sourceLineNo">1752</span> re.getData().retain();<a name="line.1752"></a>
+<span class="sourceLineNo">1753</span> return re;<a name="line.1753"></a>
+<span class="sourceLineNo">1754</span> });<a name="line.1754"></a>
+<span class="sourceLineNo">1755</span> }<a name="line.1755"></a>
+<span class="sourceLineNo">1756</span><a name="line.1756"></a>
+<span class="sourceLineNo">1757</span> /**<a name="line.1757"></a>
+<span class="sourceLineNo">1758</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1758"></a>
+<span class="sourceLineNo">1759</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1759"></a>
+<span class="sourceLineNo">1760</span> */<a name="line.1760"></a>
+<span class="sourceLineNo">1761</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1761"></a>
+<span class="sourceLineNo">1762</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1762"></a>
+<span class="sourceLineNo">1763</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1763"></a>
+<span class="sourceLineNo">1764</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1764"></a>
+<span class="sourceLineNo">1765</span> entry.getData().retain();<a name="line.1765"></a>
+<span class="sourceLineNo">1766</span> absent.set(true);<a name="line.1766"></a>
+<span class="sourceLineNo">1767</span> return entry;<a name="line.1767"></a>
<span class="sourceLineNo">1768</span> });<a name="line.1768"></a>
-<span class="sourceLineNo">1769</span> }<a name="line.1769"></a>
-<span class="sourceLineNo">1770</span><a name="line.1770"></a>
-<span class="sourceLineNo">1771</span> /**<a name="line.1771"></a>
-<span class="sourceLineNo">1772</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1772"></a>
-<span class="sourceLineNo">1773</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1773"></a>
-<span class="sourceLineNo">1774</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1774"></a>
-<span class="sourceLineNo">1775</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1775"></a>
-<span class="sourceLineNo">1776</span> */<a name="line.1776"></a>
-<span class="sourceLineNo">1777</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1777"></a>
-<span class="sourceLineNo">1778</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1778"></a>
-<span class="sourceLineNo">1779</span> action.accept(previous);<a name="line.1779"></a>
-<span class="sourceLineNo">1780</span> if (previous != null) {<a name="line.1780"></a>
-<span class="sourceLineNo">1781</span> previous.getData().release();<a name="line.1781"></a>
-<span class="sourceLineNo">1782</span> }<a name="line.1782"></a>
-<span class="sourceLineNo">1783</span> return previous != null;<a name="line.1783"></a>
-<span class="sourceLineNo">1784</span> }<a name="line.1784"></a>
-<span class="sourceLineNo">1785</span><a name="line.1785"></a>
-<span class="sourceLineNo">1786</span> public boolean isEmpty() {<a name="line.1786"></a>
-<span class="sourceLineNo">1787</span> return delegate.isEmpty();<a name="line.1787"></a>
-<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
-<span class="sourceLineNo">1789</span><a name="line.1789"></a>
-<span class="sourceLineNo">1790</span> public void clear() {<a name="line.1790"></a>
-<span class="sourceLineNo">1791</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1791"></a>
-<span class="sourceLineNo">1792</span> while (it.hasNext()) {<a name="line.1792"></a>
-<span class="sourceLineNo">1793</span> RAMQueueEntry re = it.next().getValue();<a name="line.1793"></a>
-<span class="sourceLineNo">1794</span> it.remove();<a name="line.1794"></a>
-<span class="sourceLineNo">1795</span> re.getData().release();<a name="line.1795"></a>
-<span class="sourceLineNo">1796</span> }<a name="line.1796"></a>
-<span class="sourceLineNo">1797</span> }<a name="line.1797"></a>
-<span class="sourceLineNo">1798</span> }<a name="line.1798"></a>
-<span class="sourceLineNo">1799</span>}<a name="line.1799"></a>
+<span class="sourceLineNo">1769</span> return absent.get() ? null : re;<a name="line.1769"></a>
+<span class="sourceLineNo">1770</span> }<a name="line.1770"></a>
+<span class="sourceLineNo">1771</span><a name="line.1771"></a>
+<span class="sourceLineNo">1772</span> public boolean remove(BlockCacheKey key) {<a name="line.1772"></a>
+<span class="sourceLineNo">1773</span> return remove(key, re -> {<a name="line.1773"></a>
+<span class="sourceLineNo">1774</span> });<a name="line.1774"></a>
+<span class="sourceLineNo">1775</span> }<a name="line.1775"></a>
+<span class="sourceLineNo">1776</span><a name="line.1776"></a>
+<span class="sourceLineNo">1777</span> /**<a name="line.1777"></a>
+<span class="sourceLineNo">1778</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1778"></a>
+<span class="sourceLineNo">1779</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1779"></a>
+<span class="sourceLineNo">1780</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1780"></a>
+<span class="sourceLineNo">1781</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1781"></a>
+<span class="sourceLineNo">1782</span> */<a name="line.1782"></a>
+<span class="sourceLineNo">1783</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1783"></a>
+<span class="sourceLineNo">1784</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1784"></a>
+<span class="sourceLineNo">1785</span> action.accept(previous);<a name="line.1785"></a>
+<span class="sourceLineNo">1786</span> if (previous != null) {<a name="line.1786"></a>
+<span class="sourceLineNo">1787</span> previous.getData().release();<a name="line.1787"></a>
+<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
+<span class="sourceLineNo">1789</span> return previous != null;<a name="line.1789"></a>
+<span class="sourceLineNo">1790</span> }<a name="line.1790"></a>
+<span class="sourceLineNo">1791</span><a name="line.1791"></a>
+<span class="sourceLineNo">1792</span> public boolean isEmpty() {<a name="line.1792"></a>
+<span class="sourceLineNo">1793</span> return delegate.isEmpty();<a name="line.1793"></a>
+<span class="sourceLineNo">1794</span> }<a name="line.1794"></a>
+<span class="sourceLineNo">1795</span><a name="line.1795"></a>
+<span class="sourceLineNo">1796</span> public void clear() {<a name="line.1796"></a>
+<span class="sourceLineNo">1797</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1797"></a>
+<span class="sourceLineNo">1798</span> while (it.hasNext()) {<a name="line.1798"></a>
+<span class="sourceLineNo">1799</span> RAMQueueEntry re = it.next().getValue();<a name="line.1799"></a>
+<span class="sourceLineNo">1800</span> it.remove();<a name="line.1800"></a>
+<span class="sourceLineNo">1801</span> re.getData().release();<a name="line.1801"></a>
+<span class="sourceLineNo">1802</span> }<a name="line.1802"></a>
+<span class="sourceLineNo">1803</span> }<a name="line.1803"></a>
+<span class="sourceLineNo">1804</span> }<a name="line.1804"></a>
+<span class="sourceLineNo">1805</span>}<a name="line.1805"></a>
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.WriterThread.html b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.WriterThread.html
index 30710531ef1..6b016942fa7 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.WriterThread.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.WriterThread.html
@@ -1053,758 +1053,764 @@
<span class="sourceLineNo">1045</span> final HFileContext fileContext = ((HFileBlock) re.getData()).getHFileContext();<a name="line.1045"></a>
<span class="sourceLineNo">1046</span> final String columnFamily = Bytes.toString(fileContext.getColumnFamily());<a name="line.1046"></a>
<span class="sourceLineNo">1047</span> final String tableName = Bytes.toString(fileContext.getTableName());<a name="line.1047"></a>
-<span class="sourceLineNo">1048</span> if (tableName != null && columnFamily != null) {<a name="line.1048"></a>
+<span class="sourceLineNo">1048</span> if (tableName != null) {<a name="line.1048"></a>
<span class="sourceLineNo">1049</span> sb.append(" Table: ");<a name="line.1049"></a>
<span class="sourceLineNo">1050</span> sb.append(tableName);<a name="line.1050"></a>
-<span class="sourceLineNo">1051</span> sb.append(" CF: ");<a name="line.1051"></a>
-<span class="sourceLineNo">1052</span> sb.append(columnFamily);<a name="line.1052"></a>
-<span class="sourceLineNo">1053</span> sb.append(" HFile: ");<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span> sb.append(fileContext.getHFileName());<a name="line.1054"></a>
+<span class="sourceLineNo">1051</span> }<a name="line.1051"></a>
+<span class="sourceLineNo">1052</span> if (columnFamily != null) {<a name="line.1052"></a>
+<span class="sourceLineNo">1053</span> sb.append(" CF: ");<a name="line.1053"></a>
+<span class="sourceLineNo">1054</span> sb.append(columnFamily);<a name="line.1054"></a>
<span class="sourceLineNo">1055</span> }<a name="line.1055"></a>
-<span class="sourceLineNo">1056</span> } else {<a name="line.1056"></a>
-<span class="sourceLineNo">1057</span> sb.append(" HFile: ");<a name="line.1057"></a>
-<span class="sourceLineNo">1058</span> sb.append(re.getKey());<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span> }<a name="line.1059"></a>
-<span class="sourceLineNo">1060</span> }<a name="line.1060"></a>
-<span class="sourceLineNo">1061</span> sb.append(" Message: ");<a name="line.1061"></a>
-<span class="sourceLineNo">1062</span> sb.append(fle.getMessage());<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> return sb.toString();<a name="line.1063"></a>
-<span class="sourceLineNo">1064</span> }<a name="line.1064"></a>
-<span class="sourceLineNo">1065</span><a name="line.1065"></a>
-<span class="sourceLineNo">1066</span> /**<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1067"></a>
-<span class="sourceLineNo">1068</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1068"></a>
-<span class="sourceLineNo">1069</span> * references and we'll OOME.<a name="line.1069"></a>
-<span class="sourceLineNo">1070</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1070"></a>
-<span class="sourceLineNo">1071</span> * interference expected.<a name="line.1071"></a>
-<span class="sourceLineNo">1072</span> */<a name="line.1072"></a>
-<span class="sourceLineNo">1073</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1073"></a>
-<span class="sourceLineNo">1074</span> if (entries.isEmpty()) {<a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> return;<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span> }<a name="line.1076"></a>
-<span class="sourceLineNo">1077</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1078"></a>
-<span class="sourceLineNo">1079</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1081"></a>
-<span class="sourceLineNo">1082</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1082"></a>
-<span class="sourceLineNo">1083</span> final int size = entries.size();<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1084"></a>
-<span class="sourceLineNo">1085</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1086"></a>
-<span class="sourceLineNo">1087</span> int index = 0;<a name="line.1087"></a>
-<span class="sourceLineNo">1088</span> while (cacheEnabled && index < size) {<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span> RAMQueueEntry re = null;<a name="line.1089"></a>
-<span class="sourceLineNo">1090</span> try {<a name="line.1090"></a>
-<span class="sourceLineNo">1091</span> re = entries.get(index);<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span> if (re == null) {<a name="line.1092"></a>
-<span class="sourceLineNo">1093</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span> index++;<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span> continue;<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span> }<a name="line.1096"></a>
-<span class="sourceLineNo">1097</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1097"></a>
-<span class="sourceLineNo">1098</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> blocksByHFile.add(cacheKey);<a name="line.1099"></a>
-<span class="sourceLineNo">1100</span> }<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span> // Reset the position for reuse.<a name="line.1101"></a>
-<span class="sourceLineNo">1102</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1102"></a>
-<span class="sourceLineNo">1103</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span> // IOEngine in the future.<a name="line.1105"></a>
-<span class="sourceLineNo">1106</span> metaBuff.clear();<a name="line.1106"></a>
-<span class="sourceLineNo">1107</span> BucketEntry bucketEntry =<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1108"></a>
-<span class="sourceLineNo">1109</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1109"></a>
-<span class="sourceLineNo">1110</span> bucketEntries[index] = bucketEntry;<a name="line.1110"></a>
-<span class="sourceLineNo">1111</span> if (ioErrorStartTime > 0) {<a name="line.1111"></a>
-<span class="sourceLineNo">1112</span> ioErrorStartTime = -1;<a name="line.1112"></a>
-<span class="sourceLineNo">1113</span> }<a name="line.1113"></a>
-<span class="sourceLineNo">1114</span> index++;<a name="line.1114"></a>
-<span class="sourceLineNo">1115</span> } catch (BucketAllocatorException fle) {<a name="line.1115"></a>
-<span class="sourceLineNo">1116</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1116"></a>
-<span class="sourceLineNo">1117</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span> if (<a name="line.1118"></a>
-<span class="sourceLineNo">1119</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1119"></a>
-<span class="sourceLineNo">1120</span> ) {<a name="line.1120"></a>
-<span class="sourceLineNo">1121</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1121"></a>
-<span class="sourceLineNo">1122</span> allocFailLogPrevTs = currTs;<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span> }<a name="line.1123"></a>
-<span class="sourceLineNo">1124</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span> bucketEntries[index] = null;<a name="line.1125"></a>
-<span class="sourceLineNo">1126</span> index++;<a name="line.1126"></a>
-<span class="sourceLineNo">1127</span> } catch (CacheFullException cfe) {<a name="line.1127"></a>
-<span class="sourceLineNo">1128</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span> if (!freeInProgress) {<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span> freeSpace("Full!");<a name="line.1130"></a>
-<span class="sourceLineNo">1131</span> } else {<a name="line.1131"></a>
-<span class="sourceLineNo">1132</span> Thread.sleep(50);<a name="line.1132"></a>
-<span class="sourceLineNo">1133</span> }<a name="line.1133"></a>
-<span class="sourceLineNo">1134</span> } catch (IOException ioex) {<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1135"></a>
-<span class="sourceLineNo">1136</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1136"></a>
-<span class="sourceLineNo">1137</span> checkIOErrorIsTolerated();<a name="line.1137"></a>
-<span class="sourceLineNo">1138</span> }<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
-<span class="sourceLineNo">1140</span><a name="line.1140"></a>
-<span class="sourceLineNo">1141</span> // Make sure data pages are written on media before we update maps.<a name="line.1141"></a>
-<span class="sourceLineNo">1142</span> try {<a name="line.1142"></a>
-<span class="sourceLineNo">1143</span> ioEngine.sync();<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span> } catch (IOException ioex) {<a name="line.1144"></a>
-<span class="sourceLineNo">1145</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1145"></a>
-<span class="sourceLineNo">1146</span> checkIOErrorIsTolerated();<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1147"></a>
-<span class="sourceLineNo">1148</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> if (bucketEntry != null) {<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> bucketEntries[i] = null;<a name="line.1152"></a>
-<span class="sourceLineNo">1153</span> }<a name="line.1153"></a>
-<span class="sourceLineNo">1154</span> }<a name="line.1154"></a>
-<span class="sourceLineNo">1155</span> }<a name="line.1155"></a>
-<span class="sourceLineNo">1156</span><a name="line.1156"></a>
-<span class="sourceLineNo">1157</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1157"></a>
-<span class="sourceLineNo">1158</span> // success or error.<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span> for (int i = 0; i < size; ++i) {<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1160"></a>
-<span class="sourceLineNo">1161</span> // Only add if non-null entry.<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span> if (bucketEntries[i] != null) {<a name="line.1162"></a>
-<span class="sourceLineNo">1163</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span> }<a name="line.1164"></a>
-<span class="sourceLineNo">1165</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span> if (re != null) {<a name="line.1167"></a>
-<span class="sourceLineNo">1168</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1168"></a>
-<span class="sourceLineNo">1169</span> }<a name="line.1169"></a>
-<span class="sourceLineNo">1170</span> });<a name="line.1170"></a>
-<span class="sourceLineNo">1171</span> if (!existed && bucketEntries[i] != null) {<a name="line.1171"></a>
-<span class="sourceLineNo">1172</span> // Block should have already been evicted. Remove it and free space.<a name="line.1172"></a>
-<span class="sourceLineNo">1173</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1173"></a>
-<span class="sourceLineNo">1174</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1174"></a>
-<span class="sourceLineNo">1175</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1175"></a>
-<span class="sourceLineNo">1176</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1176"></a>
-<span class="sourceLineNo">1177</span> }<a name="line.1177"></a>
-<span class="sourceLineNo">1178</span> return null;<a name="line.1178"></a>
-<span class="sourceLineNo">1179</span> });<a name="line.1179"></a>
-<span class="sourceLineNo">1180</span> }<a name="line.1180"></a>
-<span class="sourceLineNo">1181</span> }<a name="line.1181"></a>
-<span class="sourceLineNo">1182</span><a name="line.1182"></a>
-<span class="sourceLineNo">1183</span> long used = bucketAllocator.getUsedSize();<a name="line.1183"></a>
-<span class="sourceLineNo">1184</span> if (used > acceptableSize()) {<a name="line.1184"></a>
-<span class="sourceLineNo">1185</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1185"></a>
-<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
-<span class="sourceLineNo">1187</span> return;<a name="line.1187"></a>
-<span class="sourceLineNo">1188</span> }<a name="line.1188"></a>
-<span class="sourceLineNo">1189</span><a name="line.1189"></a>
-<span class="sourceLineNo">1190</span> /**<a name="line.1190"></a>
-<span class="sourceLineNo">1191</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1191"></a>
-<span class="sourceLineNo">1192</span> * returning.<a name="line.1192"></a>
-<span class="sourceLineNo">1193</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1193"></a>
-<span class="sourceLineNo">1194</span> * in case.<a name="line.1194"></a>
-<span class="sourceLineNo">1195</span> * @param q The queue to take from.<a name="line.1195"></a>
-<span class="sourceLineNo">1196</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1196"></a>
-<span class="sourceLineNo">1197</span> */<a name="line.1197"></a>
-<span class="sourceLineNo">1198</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1198"></a>
-<span class="sourceLineNo">1199</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1199"></a>
-<span class="sourceLineNo">1200</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1200"></a>
-<span class="sourceLineNo">1201</span> // ok even if list grew to accommodate thousands.<a name="line.1201"></a>
-<span class="sourceLineNo">1202</span> receptacle.clear();<a name="line.1202"></a>
-<span class="sourceLineNo">1203</span> receptacle.add(q.take());<a name="line.1203"></a>
-<span class="sourceLineNo">1204</span> q.drainTo(receptacle);<a name="line.1204"></a>
-<span class="sourceLineNo">1205</span> return receptacle;<a name="line.1205"></a>
-<span class="sourceLineNo">1206</span> }<a name="line.1206"></a>
-<span class="sourceLineNo">1207</span><a name="line.1207"></a>
-<span class="sourceLineNo">1208</span> /**<a name="line.1208"></a>
-<span class="sourceLineNo">1209</span> * @see #retrieveFromFile(int[])<a name="line.1209"></a>
-<span class="sourceLineNo">1210</span> */<a name="line.1210"></a>
-<span class="sourceLineNo">1211</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1211"></a>
-<span class="sourceLineNo">1212</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1212"></a>
-<span class="sourceLineNo">1213</span> private void persistToFile() throws IOException {<a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> assert !cacheEnabled;<a name="line.1214"></a>
-<span class="sourceLineNo">1215</span> if (!ioEngine.isPersistent()) {<a name="line.1215"></a>
-<span class="sourceLineNo">1216</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1216"></a>
-<span class="sourceLineNo">1217</span> }<a name="line.1217"></a>
-<span class="sourceLineNo">1218</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1218"></a>
-<span class="sourceLineNo">1219</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1219"></a>
-<span class="sourceLineNo">1220</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1220"></a>
-<span class="sourceLineNo">1221</span> }<a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> if (prefetchedFileListPath != null) {<a name="line.1222"></a>
-<span class="sourceLineNo">1223</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1223"></a>
-<span class="sourceLineNo">1224</span> }<a name="line.1224"></a>
-<span class="sourceLineNo">1225</span> }<a name="line.1225"></a>
-<span class="sourceLineNo">1226</span><a name="line.1226"></a>
-<span class="sourceLineNo">1227</span> /**<a name="line.1227"></a>
-<span class="sourceLineNo">1228</span> * @see #persistToFile()<a name="line.1228"></a>
-<span class="sourceLineNo">1229</span> */<a name="line.1229"></a>
-<span class="sourceLineNo">1230</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1230"></a>
-<span class="sourceLineNo">1231</span> File persistenceFile = new File(persistencePath);<a name="line.1231"></a>
-<span class="sourceLineNo">1232</span> if (!persistenceFile.exists()) {<a name="line.1232"></a>
-<span class="sourceLineNo">1233</span> return;<a name="line.1233"></a>
-<span class="sourceLineNo">1234</span> }<a name="line.1234"></a>
-<span class="sourceLineNo">1235</span> assert !cacheEnabled;<a name="line.1235"></a>
-<span class="sourceLineNo">1236</span> if (prefetchedFileListPath != null) {<a name="line.1236"></a>
-<span class="sourceLineNo">1237</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1237"></a>
-<span class="sourceLineNo">1238</span> }<a name="line.1238"></a>
-<span class="sourceLineNo">1239</span><a name="line.1239"></a>
-<span class="sourceLineNo">1240</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1240"></a>
-<span class="sourceLineNo">1241</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1241"></a>
-<span class="sourceLineNo">1242</span> byte[] pbuf = new byte[pblen];<a name="line.1242"></a>
-<span class="sourceLineNo">1243</span> int read = in.read(pbuf);<a name="line.1243"></a>
-<span class="sourceLineNo">1244</span> if (read != pblen) {<a name="line.1244"></a>
-<span class="sourceLineNo">1245</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1245"></a>
-<span class="sourceLineNo">1246</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1246"></a>
-<span class="sourceLineNo">1247</span> }<a name="line.1247"></a>
-<span class="sourceLineNo">1248</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1248"></a>
-<span class="sourceLineNo">1249</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1249"></a>
-<span class="sourceLineNo">1250</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1250"></a>
-<span class="sourceLineNo">1251</span> throw new IOException(<a name="line.1251"></a>
-<span class="sourceLineNo">1252</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1252"></a>
+<span class="sourceLineNo">1056</span> sb.append(" HFile: ");<a name="line.1056"></a>
+<span class="sourceLineNo">1057</span> if (fileContext.getHFileName() != null) {<a name="line.1057"></a>
+<span class="sourceLineNo">1058</span> sb.append(fileContext.getHFileName());<a name="line.1058"></a>
+<span class="sourceLineNo">1059</span> } else {<a name="line.1059"></a>
+<span class="sourceLineNo">1060</span> sb.append(re.getKey());<a name="line.1060"></a>
+<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
+<span class="sourceLineNo">1062</span> } else {<a name="line.1062"></a>
+<span class="sourceLineNo">1063</span> sb.append(" HFile: ");<a name="line.1063"></a>
+<span class="sourceLineNo">1064</span> sb.append(re.getKey());<a name="line.1064"></a>
+<span class="sourceLineNo">1065</span> }<a name="line.1065"></a>
+<span class="sourceLineNo">1066</span> }<a name="line.1066"></a>
+<span class="sourceLineNo">1067</span> sb.append(" Message: ");<a name="line.1067"></a>
+<span class="sourceLineNo">1068</span> sb.append(fle.getMessage());<a name="line.1068"></a>
+<span class="sourceLineNo">1069</span> return sb.toString();<a name="line.1069"></a>
+<span class="sourceLineNo">1070</span> }<a name="line.1070"></a>
+<span class="sourceLineNo">1071</span><a name="line.1071"></a>
+<span class="sourceLineNo">1072</span> /**<a name="line.1072"></a>
+<span class="sourceLineNo">1073</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1073"></a>
+<span class="sourceLineNo">1074</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1074"></a>
+<span class="sourceLineNo">1075</span> * references and we'll OOME.<a name="line.1075"></a>
+<span class="sourceLineNo">1076</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1076"></a>
+<span class="sourceLineNo">1077</span> * interference expected.<a name="line.1077"></a>
+<span class="sourceLineNo">1078</span> */<a name="line.1078"></a>
+<span class="sourceLineNo">1079</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1079"></a>
+<span class="sourceLineNo">1080</span> if (entries.isEmpty()) {<a name="line.1080"></a>
+<span class="sourceLineNo">1081</span> return;<a name="line.1081"></a>
+<span class="sourceLineNo">1082</span> }<a name="line.1082"></a>
+<span class="sourceLineNo">1083</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1083"></a>
+<span class="sourceLineNo">1084</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1084"></a>
+<span class="sourceLineNo">1085</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1085"></a>
+<span class="sourceLineNo">1086</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1086"></a>
+<span class="sourceLineNo">1087</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1087"></a>
+<span class="sourceLineNo">1088</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1088"></a>
+<span class="sourceLineNo">1089</span> final int size = entries.size();<a name="line.1089"></a>
+<span class="sourceLineNo">1090</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1090"></a>
+<span class="sourceLineNo">1091</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1091"></a>
+<span class="sourceLineNo">1092</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1092"></a>
+<span class="sourceLineNo">1093</span> int index = 0;<a name="line.1093"></a>
+<span class="sourceLineNo">1094</span> while (cacheEnabled && index < size) {<a name="line.1094"></a>
+<span class="sourceLineNo">1095</span> RAMQueueEntry re = null;<a name="line.1095"></a>
+<span class="sourceLineNo">1096</span> try {<a name="line.1096"></a>
+<span class="sourceLineNo">1097</span> re = entries.get(index);<a name="line.1097"></a>
+<span class="sourceLineNo">1098</span> if (re == null) {<a name="line.1098"></a>
+<span class="sourceLineNo">1099</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1099"></a>
+<span class="sourceLineNo">1100</span> index++;<a name="line.1100"></a>
+<span class="sourceLineNo">1101</span> continue;<a name="line.1101"></a>
+<span class="sourceLineNo">1102</span> }<a name="line.1102"></a>
+<span class="sourceLineNo">1103</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1103"></a>
+<span class="sourceLineNo">1104</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1104"></a>
+<span class="sourceLineNo">1105</span> blocksByHFile.add(cacheKey);<a name="line.1105"></a>
+<span class="sourceLineNo">1106</span> }<a name="line.1106"></a>
+<span class="sourceLineNo">1107</span> // Reset the position for reuse.<a name="line.1107"></a>
+<span class="sourceLineNo">1108</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1108"></a>
+<span class="sourceLineNo">1109</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1109"></a>
+<span class="sourceLineNo">1110</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1110"></a>
+<span class="sourceLineNo">1111</span> // IOEngine in the future.<a name="line.1111"></a>
+<span class="sourceLineNo">1112</span> metaBuff.clear();<a name="line.1112"></a>
+<span class="sourceLineNo">1113</span> BucketEntry bucketEntry =<a name="line.1113"></a>
+<span class="sourceLineNo">1114</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1114"></a>
+<span class="sourceLineNo">1115</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1115"></a>
+<span class="sourceLineNo">1116</span> bucketEntries[index] = bucketEntry;<a name="line.1116"></a>
+<span class="sourceLineNo">1117</span> if (ioErrorStartTime > 0) {<a name="line.1117"></a>
+<span class="sourceLineNo">1118</span> ioErrorStartTime = -1;<a name="line.1118"></a>
+<span class="sourceLineNo">1119</span> }<a name="line.1119"></a>
+<span class="sourceLineNo">1120</span> index++;<a name="line.1120"></a>
+<span class="sourceLineNo">1121</span> } catch (BucketAllocatorException fle) {<a name="line.1121"></a>
+<span class="sourceLineNo">1122</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1122"></a>
+<span class="sourceLineNo">1123</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1123"></a>
+<span class="sourceLineNo">1124</span> if (<a name="line.1124"></a>
+<span class="sourceLineNo">1125</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1125"></a>
+<span class="sourceLineNo">1126</span> ) {<a name="line.1126"></a>
+<span class="sourceLineNo">1127</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1127"></a>
+<span class="sourceLineNo">1128</span> allocFailLogPrevTs = currTs;<a name="line.1128"></a>
+<span class="sourceLineNo">1129</span> }<a name="line.1129"></a>
+<span class="sourceLineNo">1130</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1130"></a>
+<span class="sourceLineNo">1131</span> bucketEntries[index] = null;<a name="line.1131"></a>
+<span class="sourceLineNo">1132</span> index++;<a name="line.1132"></a>
+<span class="sourceLineNo">1133</span> } catch (CacheFullException cfe) {<a name="line.1133"></a>
+<span class="sourceLineNo">1134</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1134"></a>
+<span class="sourceLineNo">1135</span> if (!freeInProgress) {<a name="line.1135"></a>
+<span class="sourceLineNo">1136</span> freeSpace("Full!");<a name="line.1136"></a>
+<span class="sourceLineNo">1137</span> } else {<a name="line.1137"></a>
+<span class="sourceLineNo">1138</span> Thread.sleep(50);<a name="line.1138"></a>
+<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
+<span class="sourceLineNo">1140</span> } catch (IOException ioex) {<a name="line.1140"></a>
+<span class="sourceLineNo">1141</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1141"></a>
+<span class="sourceLineNo">1142</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1142"></a>
+<span class="sourceLineNo">1143</span> checkIOErrorIsTolerated();<a name="line.1143"></a>
+<span class="sourceLineNo">1144</span> }<a name="line.1144"></a>
+<span class="sourceLineNo">1145</span> }<a name="line.1145"></a>
+<span class="sourceLineNo">1146</span><a name="line.1146"></a>
+<span class="sourceLineNo">1147</span> // Make sure data pages are written on media before we update maps.<a name="line.1147"></a>
+<span class="sourceLineNo">1148</span> try {<a name="line.1148"></a>
+<span class="sourceLineNo">1149</span> ioEngine.sync();<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span> } catch (IOException ioex) {<a name="line.1150"></a>
+<span class="sourceLineNo">1151</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1151"></a>
+<span class="sourceLineNo">1152</span> checkIOErrorIsTolerated();<a name="line.1152"></a>
+<span class="sourceLineNo">1153</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1153"></a>
+<span class="sourceLineNo">1154</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1154"></a>
+<span class="sourceLineNo">1155</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1155"></a>
+<span class="sourceLineNo">1156</span> if (bucketEntry != null) {<a name="line.1156"></a>
+<span class="sourceLineNo">1157</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1157"></a>
+<span class="sourceLineNo">1158</span> bucketEntries[i] = null;<a name="line.1158"></a>
+<span class="sourceLineNo">1159</span> }<a name="line.1159"></a>
+<span class="sourceLineNo">1160</span> }<a name="line.1160"></a>
+<span class="sourceLineNo">1161</span> }<a name="line.1161"></a>
+<span class="sourceLineNo">1162</span><a name="line.1162"></a>
+<span class="sourceLineNo">1163</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1163"></a>
+<span class="sourceLineNo">1164</span> // success or error.<a name="line.1164"></a>
+<span class="sourceLineNo">1165</span> for (int i = 0; i < size; ++i) {<a name="line.1165"></a>
+<span class="sourceLineNo">1166</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1166"></a>
+<span class="sourceLineNo">1167</span> // Only add if non-null entry.<a name="line.1167"></a>
+<span class="sourceLineNo">1168</span> if (bucketEntries[i] != null) {<a name="line.1168"></a>
+<span class="sourceLineNo">1169</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1169"></a>
+<span class="sourceLineNo">1170</span> }<a name="line.1170"></a>
+<span class="sourceLineNo">1171</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1171"></a>
+<span class="sourceLineNo">1172</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1172"></a>
+<span class="sourceLineNo">1173</span> if (re != null) {<a name="line.1173"></a>
+<span class="sourceLineNo">1174</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1174"></a>
+<span class="sourceLineNo">1175</span> }<a name="line.1175"></a>
+<span class="sourceLineNo">1176</span> });<a name="line.1176"></a>
+<span class="sourceLineNo">1177</span> if (!existed && bucketEntries[i] != null) {<a name="line.1177"></a>
+<span class="sourceLineNo">1178</span> // Block should have already been evicted. Remove it and free space.<a name="line.1178"></a>
+<span class="sourceLineNo">1179</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1179"></a>
+<span class="sourceLineNo">1180</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1180"></a>
+<span class="sourceLineNo">1181</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1181"></a>
+<span class="sourceLineNo">1182</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1182"></a>
+<span class="sourceLineNo">1183</span> }<a name="line.1183"></a>
+<span class="sourceLineNo">1184</span> return null;<a name="line.1184"></a>
+<span class="sourceLineNo">1185</span> });<a name="line.1185"></a>
+<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
+<span class="sourceLineNo">1187</span> }<a name="line.1187"></a>
+<span class="sourceLineNo">1188</span><a name="line.1188"></a>
+<span class="sourceLineNo">1189</span> long used = bucketAllocator.getUsedSize();<a name="line.1189"></a>
+<span class="sourceLineNo">1190</span> if (used > acceptableSize()) {<a name="line.1190"></a>
+<span class="sourceLineNo">1191</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1191"></a>
+<span class="sourceLineNo">1192</span> }<a name="line.1192"></a>
+<span class="sourceLineNo">1193</span> return;<a name="line.1193"></a>
+<span class="sourceLineNo">1194</span> }<a name="line.1194"></a>
+<span class="sourceLineNo">1195</span><a name="line.1195"></a>
+<span class="sourceLineNo">1196</span> /**<a name="line.1196"></a>
+<span class="sourceLineNo">1197</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1197"></a>
+<span class="sourceLineNo">1198</span> * returning.<a name="line.1198"></a>
+<span class="sourceLineNo">1199</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1199"></a>
+<span class="sourceLineNo">1200</span> * in case.<a name="line.1200"></a>
+<span class="sourceLineNo">1201</span> * @param q The queue to take from.<a name="line.1201"></a>
+<span class="sourceLineNo">1202</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1202"></a>
+<span class="sourceLineNo">1203</span> */<a name="line.1203"></a>
+<span class="sourceLineNo">1204</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1204"></a>
+<span class="sourceLineNo">1205</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1205"></a>
+<span class="sourceLineNo">1206</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1206"></a>
+<span class="sourceLineNo">1207</span> // ok even if list grew to accommodate thousands.<a name="line.1207"></a>
+<span class="sourceLineNo">1208</span> receptacle.clear();<a name="line.1208"></a>
+<span class="sourceLineNo">1209</span> receptacle.add(q.take());<a name="line.1209"></a>
+<span class="sourceLineNo">1210</span> q.drainTo(receptacle);<a name="line.1210"></a>
+<span class="sourceLineNo">1211</span> return receptacle;<a name="line.1211"></a>
+<span class="sourceLineNo">1212</span> }<a name="line.1212"></a>
+<span class="sourceLineNo">1213</span><a name="line.1213"></a>
+<span class="sourceLineNo">1214</span> /**<a name="line.1214"></a>
+<span class="sourceLineNo">1215</span> * @see #retrieveFromFile(int[])<a name="line.1215"></a>
+<span class="sourceLineNo">1216</span> */<a name="line.1216"></a>
+<span class="sourceLineNo">1217</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1217"></a>
+<span class="sourceLineNo">1218</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1218"></a>
+<span class="sourceLineNo">1219</span> private void persistToFile() throws IOException {<a name="line.1219"></a>
+<span class="sourceLineNo">1220</span> assert !cacheEnabled;<a name="line.1220"></a>
+<span class="sourceLineNo">1221</span> if (!ioEngine.isPersistent()) {<a name="line.1221"></a>
+<span class="sourceLineNo">1222</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1222"></a>
+<span class="sourceLineNo">1223</span> }<a name="line.1223"></a>
+<span class="sourceLineNo">1224</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1224"></a>
+<span class="sourceLineNo">1225</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1225"></a>
+<span class="sourceLineNo">1226</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1226"></a>
+<span class="sourceLineNo">1227</span> }<a name="line.1227"></a>
+<span class="sourceLineNo">1228</span> if (prefetchedFileListPath != null) {<a name="line.1228"></a>
+<span class="sourceLineNo">1229</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1229"></a>
+<span class="sourceLineNo">1230</span> }<a name="line.1230"></a>
+<span class="sourceLineNo">1231</span> }<a name="line.1231"></a>
+<span class="sourceLineNo">1232</span><a name="line.1232"></a>
+<span class="sourceLineNo">1233</span> /**<a name="line.1233"></a>
+<span class="sourceLineNo">1234</span> * @see #persistToFile()<a name="line.1234"></a>
+<span class="sourceLineNo">1235</span> */<a name="line.1235"></a>
+<span class="sourceLineNo">1236</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1236"></a>
+<span class="sourceLineNo">1237</span> File persistenceFile = new File(persistencePath);<a name="line.1237"></a>
+<span class="sourceLineNo">1238</span> if (!persistenceFile.exists()) {<a name="line.1238"></a>
+<span class="sourceLineNo">1239</span> return;<a name="line.1239"></a>
+<span class="sourceLineNo">1240</span> }<a name="line.1240"></a>
+<span class="sourceLineNo">1241</span> assert !cacheEnabled;<a name="line.1241"></a>
+<span class="sourceLineNo">1242</span> if (prefetchedFileListPath != null) {<a name="line.1242"></a>
+<span class="sourceLineNo">1243</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1243"></a>
+<span class="sourceLineNo">1244</span> }<a name="line.1244"></a>
+<span class="sourceLineNo">1245</span><a name="line.1245"></a>
+<span class="sourceLineNo">1246</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1246"></a>
+<span class="sourceLineNo">1247</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1247"></a>
+<span class="sourceLineNo">1248</span> byte[] pbuf = new byte[pblen];<a name="line.1248"></a>
+<span class="sourceLineNo">1249</span> int read = in.read(pbuf);<a name="line.1249"></a>
+<span class="sourceLineNo">1250</span> if (read != pblen) {<a name="line.1250"></a>
+<span class="sourceLineNo">1251</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1251"></a>
+<span class="sourceLineNo">1252</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1252"></a>
<span class="sourceLineNo">1253</span> }<a name="line.1253"></a>
-<span class="sourceLineNo">1254</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1254"></a>
-<span class="sourceLineNo">1255</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1255"></a>
-<span class="sourceLineNo">1256</span> blockNumber.add(backingMap.size());<a name="line.1256"></a>
-<span class="sourceLineNo">1257</span> }<a name="line.1257"></a>
-<span class="sourceLineNo">1258</span> }<a name="line.1258"></a>
-<span class="sourceLineNo">1259</span><a name="line.1259"></a>
-<span class="sourceLineNo">1260</span> /**<a name="line.1260"></a>
-<span class="sourceLineNo">1261</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1261"></a>
-<span class="sourceLineNo">1262</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1262"></a>
-<span class="sourceLineNo">1263</span> *<a name="line.1263"></a>
-<span class="sourceLineNo">1264</span> * <pre><a name="line.1264"></a>
-<span class="sourceLineNo">1265</span> * File f = ...<a name="line.1265"></a>
-<span class="sourceLineNo">1266</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1266"></a>
-<span class="sourceLineNo">1267</span> * // use the input stream<a name="line.1267"></a>
-<span class="sourceLineNo">1268</span> * } finally {<a name="line.1268"></a>
-<span class="sourceLineNo">1269</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1269"></a>
-<span class="sourceLineNo">1270</span> * }<a name="line.1270"></a>
-<span class="sourceLineNo">1271</span> * </pre><a name="line.1271"></a>
-<span class="sourceLineNo">1272</span> *<a name="line.1272"></a>
-<span class="sourceLineNo">1273</span> * @param file the file to read and delete<a name="line.1273"></a>
-<span class="sourceLineNo">1274</span> * @return a FileInputStream for the given file<a name="line.1274"></a>
-<span class="sourceLineNo">1275</span> * @throws IOException if there is a problem creating the stream<a name="line.1275"></a>
-<span class="sourceLineNo">1276</span> */<a name="line.1276"></a>
-<span class="sourceLineNo">1277</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1277"></a>
-<span class="sourceLineNo">1278</span> return new FileInputStream(file) {<a name="line.1278"></a>
-<span class="sourceLineNo">1279</span> private File myFile;<a name="line.1279"></a>
-<span class="sourceLineNo">1280</span><a name="line.1280"></a>
-<span class="sourceLineNo">1281</span> private FileInputStream init(File file) {<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> myFile = file;<a name="line.1282"></a>
-<span class="sourceLineNo">1283</span> return this;<a name="line.1283"></a>
-<span class="sourceLineNo">1284</span> }<a name="line.1284"></a>
-<span class="sourceLineNo">1285</span><a name="line.1285"></a>
-<span class="sourceLineNo">1286</span> @Override<a name="line.1286"></a>
-<span class="sourceLineNo">1287</span> public void close() throws IOException {<a name="line.1287"></a>
-<span class="sourceLineNo">1288</span> // close() will be called during try-with-resources and it will be<a name="line.1288"></a>
-<span class="sourceLineNo">1289</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1289"></a>
-<span class="sourceLineNo">1290</span> // set myFile to null after the first call.<a name="line.1290"></a>
-<span class="sourceLineNo">1291</span> if (myFile == null) {<a name="line.1291"></a>
-<span class="sourceLineNo">1292</span> return;<a name="line.1292"></a>
-<span class="sourceLineNo">1293</span> }<a name="line.1293"></a>
-<span class="sourceLineNo">1294</span><a name="line.1294"></a>
-<span class="sourceLineNo">1295</span> super.close();<a name="line.1295"></a>
-<span class="sourceLineNo">1296</span> if (!myFile.delete()) {<a name="line.1296"></a>
-<span class="sourceLineNo">1297</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1297"></a>
-<span class="sourceLineNo">1298</span> }<a name="line.1298"></a>
-<span class="sourceLineNo">1299</span> myFile = null;<a name="line.1299"></a>
-<span class="sourceLineNo">1300</span> }<a name="line.1300"></a>
-<span class="sourceLineNo">1301</span> }.init(file);<a name="line.1301"></a>
-<span class="sourceLineNo">1302</span> }<a name="line.1302"></a>
-<span class="sourceLineNo">1303</span><a name="line.1303"></a>
-<span class="sourceLineNo">1304</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1304"></a>
-<span class="sourceLineNo">1305</span> throws IOException {<a name="line.1305"></a>
-<span class="sourceLineNo">1306</span> if (capacitySize != cacheCapacity) {<a name="line.1306"></a>
-<span class="sourceLineNo">1307</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1307"></a>
-<span class="sourceLineNo">1308</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1308"></a>
-<span class="sourceLineNo">1309</span> }<a name="line.1309"></a>
-<span class="sourceLineNo">1310</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1310"></a>
-<span class="sourceLineNo">1311</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1311"></a>
-<span class="sourceLineNo">1312</span> + ioEngine.getClass().getName());<a name="line.1312"></a>
-<span class="sourceLineNo">1313</span> }<a name="line.1313"></a>
-<span class="sourceLineNo">1314</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1314"></a>
-<span class="sourceLineNo">1315</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1315"></a>
-<span class="sourceLineNo">1316</span> + backingMap.getClass().getName());<a name="line.1316"></a>
-<span class="sourceLineNo">1317</span> }<a name="line.1317"></a>
-<span class="sourceLineNo">1318</span> }<a name="line.1318"></a>
-<span class="sourceLineNo">1319</span><a name="line.1319"></a>
-<span class="sourceLineNo">1320</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1320"></a>
-<span class="sourceLineNo">1321</span> if (proto.hasChecksum()) {<a name="line.1321"></a>
-<span class="sourceLineNo">1322</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1322"></a>
-<span class="sourceLineNo">1323</span> algorithm);<a name="line.1323"></a>
-<span class="sourceLineNo">1324</span> } else {<a name="line.1324"></a>
-<span class="sourceLineNo">1325</span> // if has not checksum, it means the persistence file is old format<a name="line.1325"></a>
-<span class="sourceLineNo">1326</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1326"></a>
-<span class="sourceLineNo">1327</span> }<a name="line.1327"></a>
-<span class="sourceLineNo">1328</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1328"></a>
-<span class="sourceLineNo">1329</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1329"></a>
-<span class="sourceLineNo">1330</span> this::createRecycler);<a name="line.1330"></a>
-<span class="sourceLineNo">1331</span> }<a name="line.1331"></a>
-<span class="sourceLineNo">1332</span><a name="line.1332"></a>
-<span class="sourceLineNo">1333</span> /**<a name="line.1333"></a>
-<span class="sourceLineNo">1334</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1334"></a>
-<span class="sourceLineNo">1335</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1335"></a>
-<span class="sourceLineNo">1336</span> */<a name="line.1336"></a>
-<span class="sourceLineNo">1337</span> private void checkIOErrorIsTolerated() {<a name="line.1337"></a>
-<span class="sourceLineNo">1338</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1338"></a>
-<span class="sourceLineNo">1339</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1339"></a>
-<span class="sourceLineNo">1340</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1340"></a>
-<span class="sourceLineNo">1341</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1341"></a>
-<span class="sourceLineNo">1342</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1343"></a>
-<span class="sourceLineNo">1344</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1344"></a>
-<span class="sourceLineNo">1345</span> disableCache();<a name="line.1345"></a>
-<span class="sourceLineNo">1346</span> }<a name="line.1346"></a>
-<span class="sourceLineNo">1347</span> } else {<a name="line.1347"></a>
-<span class="sourceLineNo">1348</span> this.ioErrorStartTime = now;<a name="line.1348"></a>
-<span class="sourceLineNo">1349</span> }<a name="line.1349"></a>
-<span class="sourceLineNo">1350</span> }<a name="line.1350"></a>
-<span class="sourceLineNo">1351</span><a name="line.1351"></a>
-<span class="sourceLineNo">1352</span> /**<a name="line.1352"></a>
-<span class="sourceLineNo">1353</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1353"></a>
-<span class="sourceLineNo">1354</span> */<a name="line.1354"></a>
-<span class="sourceLineNo">1355</span> private void disableCache() {<a name="line.1355"></a>
-<span class="sourceLineNo">1356</span> if (!cacheEnabled) return;<a name="line.1356"></a>
-<span class="sourceLineNo">1357</span> cacheEnabled = false;<a name="line.1357"></a>
-<span class="sourceLineNo">1358</span> ioEngine.shutdown();<a name="line.1358"></a>
-<span class="sourceLineNo">1359</span> this.scheduleThreadPool.shutdown();<a name="line.1359"></a>
-<span class="sourceLineNo">1360</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1360"></a>
-<span class="sourceLineNo">1361</span> writerThreads[i].interrupt();<a name="line.1361"></a>
-<span class="sourceLineNo">1362</span> this.ramCache.clear();<a name="line.1362"></a>
-<span class="sourceLineNo">1363</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1363"></a>
-<span class="sourceLineNo">1364</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1364"></a>
-<span class="sourceLineNo">1365</span> this.backingMap.clear();<a name="line.1365"></a>
-<span class="sourceLineNo">1366</span> }<a name="line.1366"></a>
-<span class="sourceLineNo">1367</span> }<a name="line.1367"></a>
-<span class="sourceLineNo">1368</span><a name="line.1368"></a>
-<span class="sourceLineNo">1369</span> private void join() throws InterruptedException {<a name="line.1369"></a>
-<span class="sourceLineNo">1370</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1370"></a>
-<span class="sourceLineNo">1371</span> writerThreads[i].join();<a name="line.1371"></a>
-<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
-<span class="sourceLineNo">1373</span><a name="line.1373"></a>
-<span class="sourceLineNo">1374</span> @Override<a name="line.1374"></a>
-<span class="sourceLineNo">1375</span> public void shutdown() {<a name="line.1375"></a>
-<span class="sourceLineNo">1376</span> disableCache();<a name="line.1376"></a>
-<span class="sourceLineNo">1377</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1377"></a>
-<span class="sourceLineNo">1378</span> + persistencePath);<a name="line.1378"></a>
-<span class="sourceLineNo">1379</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1379"></a>
-<span class="sourceLineNo">1380</span> try {<a name="line.1380"></a>
-<span class="sourceLineNo">1381</span> join();<a name="line.1381"></a>
-<span class="sourceLineNo">1382</span> persistToFile();<a name="line.1382"></a>
-<span class="sourceLineNo">1383</span> } catch (IOException ex) {<a name="line.1383"></a>
-<span class="sourceLineNo">1384</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1384"></a>
-<span class="sourceLineNo">1385</span> } catch (InterruptedException e) {<a name="line.1385"></a>
-<span class="sourceLineNo">1386</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> }<a name="line.1387"></a>
-<span class="sourceLineNo">1388</span> }<a name="line.1388"></a>
-<span class="sourceLineNo">1389</span> }<a name="line.1389"></a>
-<span class="sourceLineNo">1390</span><a name="line.1390"></a>
-<span class="sourceLineNo">1391</span> @Override<a name="line.1391"></a>
-<span class="sourceLineNo">1392</span> public CacheStats getStats() {<a name="line.1392"></a>
-<span class="sourceLineNo">1393</span> return cacheStats;<a name="line.1393"></a>
-<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
-<span class="sourceLineNo">1395</span><a name="line.1395"></a>
-<span class="sourceLineNo">1396</span> public BucketAllocator getAllocator() {<a name="line.1396"></a>
-<span class="sourceLineNo">1397</span> return this.bucketAllocator;<a name="line.1397"></a>
-<span class="sourceLineNo">1398</span> }<a name="line.1398"></a>
-<span class="sourceLineNo">1399</span><a name="line.1399"></a>
-<span class="sourceLineNo">1400</span> @Override<a name="line.1400"></a>
-<span class="sourceLineNo">1401</span> public long heapSize() {<a name="line.1401"></a>
-<span class="sourceLineNo">1402</span> return this.heapSize.sum();<a name="line.1402"></a>
-<span class="sourceLineNo">1403</span> }<a name="line.1403"></a>
-<span class="sourceLineNo">1404</span><a name="line.1404"></a>
-<span class="sourceLineNo">1405</span> @Override<a name="line.1405"></a>
-<span class="sourceLineNo">1406</span> public long size() {<a name="line.1406"></a>
-<span class="sourceLineNo">1407</span> return this.realCacheSize.sum();<a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> }<a name="line.1408"></a>
-<span class="sourceLineNo">1409</span><a name="line.1409"></a>
-<span class="sourceLineNo">1410</span> @Override<a name="line.1410"></a>
-<span class="sourceLineNo">1411</span> public long getCurrentDataSize() {<a name="line.1411"></a>
-<span class="sourceLineNo">1412</span> return size();<a name="line.1412"></a>
-<span class="sourceLineNo">1413</span> }<a name="line.1413"></a>
-<span class="sourceLineNo">1414</span><a name="line.1414"></a>
-<span class="sourceLineNo">1415</span> @Override<a name="line.1415"></a>
-<span class="sourceLineNo">1416</span> public long getFreeSize() {<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> return this.bucketAllocator.getFreeSize();<a name="line.1417"></a>
-<span class="sourceLineNo">1418</span> }<a name="line.1418"></a>
-<span class="sourceLineNo">1419</span><a name="line.1419"></a>
-<span class="sourceLineNo">1420</span> @Override<a name="line.1420"></a>
-<span class="sourceLineNo">1421</span> public long getBlockCount() {<a name="line.1421"></a>
-<span class="sourceLineNo">1422</span> return this.blockNumber.sum();<a name="line.1422"></a>
-<span class="sourceLineNo">1423</span> }<a name="line.1423"></a>
-<span class="sourceLineNo">1424</span><a name="line.1424"></a>
-<span class="sourceLineNo">1425</span> @Override<a name="line.1425"></a>
-<span class="sourceLineNo">1426</span> public long getDataBlockCount() {<a name="line.1426"></a>
-<span class="sourceLineNo">1427</span> return getBlockCount();<a name="line.1427"></a>
-<span class="sourceLineNo">1428</span> }<a name="line.1428"></a>
-<span class="sourceLineNo">1429</span><a name="line.1429"></a>
-<span class="sourceLineNo">1430</span> @Override<a name="line.1430"></a>
-<span class="sourceLineNo">1431</span> public long getCurrentSize() {<a name="line.1431"></a>
-<span class="sourceLineNo">1432</span> return this.bucketAllocator.getUsedSize();<a name="line.1432"></a>
-<span class="sourceLineNo">1433</span> }<a name="line.1433"></a>
-<span class="sourceLineNo">1434</span><a name="line.1434"></a>
-<span class="sourceLineNo">1435</span> protected String getAlgorithm() {<a name="line.1435"></a>
-<span class="sourceLineNo">1436</span> return algorithm;<a name="line.1436"></a>
-<span class="sourceLineNo">1437</span> }<a name="line.1437"></a>
-<span class="sourceLineNo">1438</span><a name="line.1438"></a>
-<span class="sourceLineNo">1439</span> /**<a name="line.1439"></a>
-<span class="sourceLineNo">1440</span> * Evicts all blocks for a specific HFile.<a name="line.1440"></a>
-<span class="sourceLineNo">1441</span> * <p><a name="line.1441"></a>
-<span class="sourceLineNo">1442</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1442"></a>
-<span class="sourceLineNo">1443</span> * @return the number of blocks evicted<a name="line.1443"></a>
-<span class="sourceLineNo">1444</span> */<a name="line.1444"></a>
-<span class="sourceLineNo">1445</span> @Override<a name="line.1445"></a>
-<span class="sourceLineNo">1446</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1446"></a>
-<span class="sourceLineNo">1447</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1447"></a>
-<span class="sourceLineNo">1448</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1448"></a>
-<span class="sourceLineNo">1449</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1449"></a>
-<span class="sourceLineNo">1450</span><a name="line.1450"></a>
-<span class="sourceLineNo">1451</span> int numEvicted = 0;<a name="line.1451"></a>
-<span class="sourceLineNo">1452</span> for (BlockCacheKey key : keySet) {<a name="line.1452"></a>
-<span class="sourceLineNo">1453</span> if (evictBlock(key)) {<a name="line.1453"></a>
-<span class="sourceLineNo">1454</span> ++numEvicted;<a name="line.1454"></a>
-<span class="sourceLineNo">1455</span> }<a name="line.1455"></a>
-<span class="sourceLineNo">1456</span> }<a name="line.1456"></a>
-<span class="sourceLineNo">1457</span><a name="line.1457"></a>
-<span class="sourceLineNo">1458</span> return numEvicted;<a name="line.1458"></a>
-<span class="sourceLineNo">1459</span> }<a name="line.1459"></a>
-<span class="sourceLineNo">1460</span><a name="line.1460"></a>
-<span class="sourceLineNo">1461</span> /**<a name="line.1461"></a>
-<span class="sourceLineNo">1462</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1462"></a>
-<span class="sourceLineNo">1463</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1463"></a>
-<span class="sourceLineNo">1464</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1464"></a>
-<span class="sourceLineNo">1465</span> */<a name="line.1465"></a>
-<span class="sourceLineNo">1466</span> private class BucketEntryGroup {<a name="line.1466"></a>
-<span class="sourceLineNo">1467</span><a name="line.1467"></a>
-<span class="sourceLineNo">1468</span> private CachedEntryQueue queue;<a name="line.1468"></a>
-<span class="sourceLineNo">1469</span> private long totalSize = 0;<a name="line.1469"></a>
-<span class="sourceLineNo">1470</span> private long bucketSize;<a name="line.1470"></a>
-<span class="sourceLineNo">1471</span><a name="line.1471"></a>
-<span class="sourceLineNo">1472</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1472"></a>
-<span class="sourceLineNo">1473</span> this.bucketSize = bucketSize;<a name="line.1473"></a>
-<span class="sourceLineNo">1474</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1474"></a>
-<span class="sourceLineNo">1475</span> totalSize = 0;<a name="line.1475"></a>
-<span class="sourceLineNo">1476</span> }<a name="line.1476"></a>
+<span class="sourceLineNo">1254</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1254"></a>
+<span class="sourceLineNo">1255</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1255"></a>
+<span class="sourceLineNo">1256</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1256"></a>
+<span class="sourceLineNo">1257</span> throw new IOException(<a name="line.1257"></a>
+<span class="sourceLineNo">1258</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1258"></a>
+<span class="sourceLineNo">1259</span> }<a name="line.1259"></a>
+<span class="sourceLineNo">1260</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1260"></a>
+<span class="sourceLineNo">1261</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1261"></a>
+<span class="sourceLineNo">1262</span> blockNumber.add(backingMap.size());<a name="line.1262"></a>
+<span class="sourceLineNo">1263</span> }<a name="line.1263"></a>
+<span class="sourceLineNo">1264</span> }<a name="line.1264"></a>
+<span class="sourceLineNo">1265</span><a name="line.1265"></a>
+<span class="sourceLineNo">1266</span> /**<a name="line.1266"></a>
+<span class="sourceLineNo">1267</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1267"></a>
+<span class="sourceLineNo">1268</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1268"></a>
+<span class="sourceLineNo">1269</span> *<a name="line.1269"></a>
+<span class="sourceLineNo">1270</span> * <pre><a name="line.1270"></a>
+<span class="sourceLineNo">1271</span> * File f = ...<a name="line.1271"></a>
+<span class="sourceLineNo">1272</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1272"></a>
+<span class="sourceLineNo">1273</span> * // use the input stream<a name="line.1273"></a>
+<span class="sourceLineNo">1274</span> * } finally {<a name="line.1274"></a>
+<span class="sourceLineNo">1275</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1275"></a>
+<span class="sourceLineNo">1276</span> * }<a name="line.1276"></a>
+<span class="sourceLineNo">1277</span> * </pre><a name="line.1277"></a>
+<span class="sourceLineNo">1278</span> *<a name="line.1278"></a>
+<span class="sourceLineNo">1279</span> * @param file the file to read and delete<a name="line.1279"></a>
+<span class="sourceLineNo">1280</span> * @return a FileInputStream for the given file<a name="line.1280"></a>
+<span class="sourceLineNo">1281</span> * @throws IOException if there is a problem creating the stream<a name="line.1281"></a>
+<span class="sourceLineNo">1282</span> */<a name="line.1282"></a>
+<span class="sourceLineNo">1283</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1283"></a>
+<span class="sourceLineNo">1284</span> return new FileInputStream(file) {<a name="line.1284"></a>
+<span class="sourceLineNo">1285</span> private File myFile;<a name="line.1285"></a>
+<span class="sourceLineNo">1286</span><a name="line.1286"></a>
+<span class="sourceLineNo">1287</span> private FileInputStream init(File file) {<a name="line.1287"></a>
+<span class="sourceLineNo">1288</span> myFile = file;<a name="line.1288"></a>
+<span class="sourceLineNo">1289</span> return this;<a name="line.1289"></a>
+<span class="sourceLineNo">1290</span> }<a name="line.1290"></a>
+<span class="sourceLineNo">1291</span><a name="line.1291"></a>
+<span class="sourceLineNo">1292</span> @Override<a name="line.1292"></a>
+<span class="sourceLineNo">1293</span> public void close() throws IOException {<a name="line.1293"></a>
+<span class="sourceLineNo">1294</span> // close() will be called during try-with-resources and it will be<a name="line.1294"></a>
+<span class="sourceLineNo">1295</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1295"></a>
+<span class="sourceLineNo">1296</span> // set myFile to null after the first call.<a name="line.1296"></a>
+<span class="sourceLineNo">1297</span> if (myFile == null) {<a name="line.1297"></a>
+<span class="sourceLineNo">1298</span> return;<a name="line.1298"></a>
+<span class="sourceLineNo">1299</span> }<a name="line.1299"></a>
+<span class="sourceLineNo">1300</span><a name="line.1300"></a>
+<span class="sourceLineNo">1301</span> super.close();<a name="line.1301"></a>
+<span class="sourceLineNo">1302</span> if (!myFile.delete()) {<a name="line.1302"></a>
+<span class="sourceLineNo">1303</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1303"></a>
+<span class="sourceLineNo">1304</span> }<a name="line.1304"></a>
+<span class="sourceLineNo">1305</span> myFile = null;<a name="line.1305"></a>
+<span class="sourceLineNo">1306</span> }<a name="line.1306"></a>
+<span class="sourceLineNo">1307</span> }.init(file);<a name="line.1307"></a>
+<span class="sourceLineNo">1308</span> }<a name="line.1308"></a>
+<span class="sourceLineNo">1309</span><a name="line.1309"></a>
+<span class="sourceLineNo">1310</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1310"></a>
+<span class="sourceLineNo">1311</span> throws IOException {<a name="line.1311"></a>
+<span class="sourceLineNo">1312</span> if (capacitySize != cacheCapacity) {<a name="line.1312"></a>
+<span class="sourceLineNo">1313</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1313"></a>
+<span class="sourceLineNo">1314</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1314"></a>
+<span class="sourceLineNo">1315</span> }<a name="line.1315"></a>
+<span class="sourceLineNo">1316</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1316"></a>
+<span class="sourceLineNo">1317</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1317"></a>
+<span class="sourceLineNo">1318</span> + ioEngine.getClass().getName());<a name="line.1318"></a>
+<span class="sourceLineNo">1319</span> }<a name="line.1319"></a>
+<span class="sourceLineNo">1320</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1320"></a>
+<span class="sourceLineNo">1321</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1321"></a>
+<span class="sourceLineNo">1322</span> + backingMap.getClass().getName());<a name="line.1322"></a>
+<span class="sourceLineNo">1323</span> }<a name="line.1323"></a>
+<span class="sourceLineNo">1324</span> }<a name="line.1324"></a>
+<span class="sourceLineNo">1325</span><a name="line.1325"></a>
+<span class="sourceLineNo">1326</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1326"></a>
+<span class="sourceLineNo">1327</span> if (proto.hasChecksum()) {<a name="line.1327"></a>
+<span class="sourceLineNo">1328</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1328"></a>
+<span class="sourceLineNo">1329</span> algorithm);<a name="line.1329"></a>
+<span class="sourceLineNo">1330</span> } else {<a name="line.1330"></a>
+<span class="sourceLineNo">1331</span> // if has not checksum, it means the persistence file is old format<a name="line.1331"></a>
+<span class="sourceLineNo">1332</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1332"></a>
+<span class="sourceLineNo">1333</span> }<a name="line.1333"></a>
+<span class="sourceLineNo">1334</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1334"></a>
+<span class="sourceLineNo">1335</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1335"></a>
+<span class="sourceLineNo">1336</span> this::createRecycler);<a name="line.1336"></a>
+<span class="sourceLineNo">1337</span> }<a name="line.1337"></a>
+<span class="sourceLineNo">1338</span><a name="line.1338"></a>
+<span class="sourceLineNo">1339</span> /**<a name="line.1339"></a>
+<span class="sourceLineNo">1340</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1340"></a>
+<span class="sourceLineNo">1341</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1341"></a>
+<span class="sourceLineNo">1342</span> */<a name="line.1342"></a>
+<span class="sourceLineNo">1343</span> private void checkIOErrorIsTolerated() {<a name="line.1343"></a>
+<span class="sourceLineNo">1344</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1344"></a>
+<span class="sourceLineNo">1345</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1345"></a>
+<span class="sourceLineNo">1346</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1346"></a>
+<span class="sourceLineNo">1347</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1347"></a>
+<span class="sourceLineNo">1348</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1348"></a>
+<span class="sourceLineNo">1349</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1349"></a>
+<span class="sourceLineNo">1350</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1350"></a>
+<span class="sourceLineNo">1351</span> disableCache();<a name="line.1351"></a>
+<span class="sourceLineNo">1352</span> }<a name="line.1352"></a>
+<span class="sourceLineNo">1353</span> } else {<a name="line.1353"></a>
+<span class="sourceLineNo">1354</span> this.ioErrorStartTime = now;<a name="line.1354"></a>
+<span class="sourceLineNo">1355</span> }<a name="line.1355"></a>
+<span class="sourceLineNo">1356</span> }<a name="line.1356"></a>
+<span class="sourceLineNo">1357</span><a name="line.1357"></a>
+<span class="sourceLineNo">1358</span> /**<a name="line.1358"></a>
+<span class="sourceLineNo">1359</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1359"></a>
+<span class="sourceLineNo">1360</span> */<a name="line.1360"></a>
+<span class="sourceLineNo">1361</span> private void disableCache() {<a name="line.1361"></a>
+<span class="sourceLineNo">1362</span> if (!cacheEnabled) return;<a name="line.1362"></a>
+<span class="sourceLineNo">1363</span> cacheEnabled = false;<a name="line.1363"></a>
+<span class="sourceLineNo">1364</span> ioEngine.shutdown();<a name="line.1364"></a>
+<span class="sourceLineNo">1365</span> this.scheduleThreadPool.shutdown();<a name="line.1365"></a>
+<span class="sourceLineNo">1366</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1366"></a>
+<span class="sourceLineNo">1367</span> writerThreads[i].interrupt();<a name="line.1367"></a>
+<span class="sourceLineNo">1368</span> this.ramCache.clear();<a name="line.1368"></a>
+<span class="sourceLineNo">1369</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1369"></a>
+<span class="sourceLineNo">1370</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1370"></a>
+<span class="sourceLineNo">1371</span> this.backingMap.clear();<a name="line.1371"></a>
+<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
+<span class="sourceLineNo">1373</span> }<a name="line.1373"></a>
+<span class="sourceLineNo">1374</span><a name="line.1374"></a>
+<span class="sourceLineNo">1375</span> private void join() throws InterruptedException {<a name="line.1375"></a>
+<span class="sourceLineNo">1376</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1376"></a>
+<span class="sourceLineNo">1377</span> writerThreads[i].join();<a name="line.1377"></a>
+<span class="sourceLineNo">1378</span> }<a name="line.1378"></a>
+<span class="sourceLineNo">1379</span><a name="line.1379"></a>
+<span class="sourceLineNo">1380</span> @Override<a name="line.1380"></a>
+<span class="sourceLineNo">1381</span> public void shutdown() {<a name="line.1381"></a>
+<span class="sourceLineNo">1382</span> disableCache();<a name="line.1382"></a>
+<span class="sourceLineNo">1383</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1383"></a>
+<span class="sourceLineNo">1384</span> + persistencePath);<a name="line.1384"></a>
+<span class="sourceLineNo">1385</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1385"></a>
+<span class="sourceLineNo">1386</span> try {<a name="line.1386"></a>
+<span class="sourceLineNo">1387</span> join();<a name="line.1387"></a>
+<span class="sourceLineNo">1388</span> persistToFile();<a name="line.1388"></a>
+<span class="sourceLineNo">1389</span> } catch (IOException ex) {<a name="line.1389"></a>
+<span class="sourceLineNo">1390</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1390"></a>
+<span class="sourceLineNo">1391</span> } catch (InterruptedException e) {<a name="line.1391"></a>
+<span class="sourceLineNo">1392</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1392"></a>
+<span class="sourceLineNo">1393</span> }<a name="line.1393"></a>
+<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
+<span class="sourceLineNo">1395</span> }<a name="line.1395"></a>
+<span class="sourceLineNo">1396</span><a name="line.1396"></a>
+<span class="sourceLineNo">1397</span> @Override<a name="line.1397"></a>
+<span class="sourceLineNo">1398</span> public CacheStats getStats() {<a name="line.1398"></a>
+<span class="sourceLineNo">1399</span> return cacheStats;<a name="line.1399"></a>
+<span class="sourceLineNo">1400</span> }<a name="line.1400"></a>
+<span class="sourceLineNo">1401</span><a name="line.1401"></a>
+<span class="sourceLineNo">1402</span> public BucketAllocator getAllocator() {<a name="line.1402"></a>
+<span class="sourceLineNo">1403</span> return this.bucketAllocator;<a name="line.1403"></a>
+<span class="sourceLineNo">1404</span> }<a name="line.1404"></a>
+<span class="sourceLineNo">1405</span><a name="line.1405"></a>
+<span class="sourceLineNo">1406</span> @Override<a name="line.1406"></a>
+<span class="sourceLineNo">1407</span> public long heapSize() {<a name="line.1407"></a>
+<span class="sourceLineNo">1408</span> return this.heapSize.sum();<a name="line.1408"></a>
+<span class="sourceLineNo">1409</span> }<a name="line.1409"></a>
+<span class="sourceLineNo">1410</span><a name="line.1410"></a>
+<span class="sourceLineNo">1411</span> @Override<a name="line.1411"></a>
+<span class="sourceLineNo">1412</span> public long size() {<a name="line.1412"></a>
+<span class="sourceLineNo">1413</span> return this.realCacheSize.sum();<a name="line.1413"></a>
+<span class="sourceLineNo">1414</span> }<a name="line.1414"></a>
+<span class="sourceLineNo">1415</span><a name="line.1415"></a>
+<span class="sourceLineNo">1416</span> @Override<a name="line.1416"></a>
+<span class="sourceLineNo">1417</span> public long getCurrentDataSize() {<a name="line.1417"></a>
+<span class="sourceLineNo">1418</span> return size();<a name="line.1418"></a>
+<span class="sourceLineNo">1419</span> }<a name="line.1419"></a>
+<span class="sourceLineNo">1420</span><a name="line.1420"></a>
+<span class="sourceLineNo">1421</span> @Override<a name="line.1421"></a>
+<span class="sourceLineNo">1422</span> public long getFreeSize() {<a name="line.1422"></a>
+<span class="sourceLineNo">1423</span> return this.bucketAllocator.getFreeSize();<a name="line.1423"></a>
+<span class="sourceLineNo">1424</span> }<a name="line.1424"></a>
+<span class="sourceLineNo">1425</span><a name="line.1425"></a>
+<span class="sourceLineNo">1426</span> @Override<a name="line.1426"></a>
+<span class="sourceLineNo">1427</span> public long getBlockCount() {<a name="line.1427"></a>
+<span class="sourceLineNo">1428</span> return this.blockNumber.sum();<a name="line.1428"></a>
+<span class="sourceLineNo">1429</span> }<a name="line.1429"></a>
+<span class="sourceLineNo">1430</span><a name="line.1430"></a>
+<span class="sourceLineNo">1431</span> @Override<a name="line.1431"></a>
+<span class="sourceLineNo">1432</span> public long getDataBlockCount() {<a name="line.1432"></a>
+<span class="sourceLineNo">1433</span> return getBlockCount();<a name="line.1433"></a>
+<span class="sourceLineNo">1434</span> }<a name="line.1434"></a>
+<span class="sourceLineNo">1435</span><a name="line.1435"></a>
+<span class="sourceLineNo">1436</span> @Override<a name="line.1436"></a>
+<span class="sourceLineNo">1437</span> public long getCurrentSize() {<a name="line.1437"></a>
+<span class="sourceLineNo">1438</span> return this.bucketAllocator.getUsedSize();<a name="line.1438"></a>
+<span class="sourceLineNo">1439</span> }<a name="line.1439"></a>
+<span class="sourceLineNo">1440</span><a name="line.1440"></a>
+<span class="sourceLineNo">1441</span> protected String getAlgorithm() {<a name="line.1441"></a>
+<span class="sourceLineNo">1442</span> return algorithm;<a name="line.1442"></a>
+<span class="sourceLineNo">1443</span> }<a name="line.1443"></a>
+<span class="sourceLineNo">1444</span><a name="line.1444"></a>
+<span class="sourceLineNo">1445</span> /**<a name="line.1445"></a>
+<span class="sourceLineNo">1446</span> * Evicts all blocks for a specific HFile.<a name="line.1446"></a>
+<span class="sourceLineNo">1447</span> * <p><a name="line.1447"></a>
+<span class="sourceLineNo">1448</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1448"></a>
+<span class="sourceLineNo">1449</span> * @return the number of blocks evicted<a name="line.1449"></a>
+<span class="sourceLineNo">1450</span> */<a name="line.1450"></a>
+<span class="sourceLineNo">1451</span> @Override<a name="line.1451"></a>
+<span class="sourceLineNo">1452</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1452"></a>
+<span class="sourceLineNo">1453</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1453"></a>
+<span class="sourceLineNo">1454</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1454"></a>
+<span class="sourceLineNo">1455</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1455"></a>
+<span class="sourceLineNo">1456</span><a name="line.1456"></a>
+<span class="sourceLineNo">1457</span> int numEvicted = 0;<a name="line.1457"></a>
+<span class="sourceLineNo">1458</span> for (BlockCacheKey key : keySet) {<a name="line.1458"></a>
+<span class="sourceLineNo">1459</span> if (evictBlock(key)) {<a name="line.1459"></a>
+<span class="sourceLineNo">1460</span> ++numEvicted;<a name="line.1460"></a>
+<span class="sourceLineNo">1461</span> }<a name="line.1461"></a>
+<span class="sourceLineNo">1462</span> }<a name="line.1462"></a>
+<span class="sourceLineNo">1463</span><a name="line.1463"></a>
+<span class="sourceLineNo">1464</span> return numEvicted;<a name="line.1464"></a>
+<span class="sourceLineNo">1465</span> }<a name="line.1465"></a>
+<span class="sourceLineNo">1466</span><a name="line.1466"></a>
+<span class="sourceLineNo">1467</span> /**<a name="line.1467"></a>
+<span class="sourceLineNo">1468</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1468"></a>
+<span class="sourceLineNo">1469</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1469"></a>
+<span class="sourceLineNo">1470</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1470"></a>
+<span class="sourceLineNo">1471</span> */<a name="line.1471"></a>
+<span class="sourceLineNo">1472</span> private class BucketEntryGroup {<a name="line.1472"></a>
+<span class="sourceLineNo">1473</span><a name="line.1473"></a>
+<span class="sourceLineNo">1474</span> private CachedEntryQueue queue;<a name="line.1474"></a>
+<span class="sourceLineNo">1475</span> private long totalSize = 0;<a name="line.1475"></a>
+<span class="sourceLineNo">1476</span> private long bucketSize;<a name="line.1476"></a>
<span class="sourceLineNo">1477</span><a name="line.1477"></a>
-<span class="sourceLineNo">1478</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1478"></a>
-<span class="sourceLineNo">1479</span> totalSize += block.getValue().getLength();<a name="line.1479"></a>
-<span class="sourceLineNo">1480</span> queue.add(block);<a name="line.1480"></a>
-<span class="sourceLineNo">1481</span> }<a name="line.1481"></a>
-<span class="sourceLineNo">1482</span><a name="line.1482"></a>
-<span class="sourceLineNo">1483</span> public long free(long toFree) {<a name="line.1483"></a>
-<span class="sourceLineNo">1484</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1484"></a>
-<span class="sourceLineNo">1485</span> long freedBytes = 0;<a name="line.1485"></a>
-<span class="sourceLineNo">1486</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1486"></a>
-<span class="sourceLineNo">1487</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1487"></a>
-<span class="sourceLineNo">1488</span> while ((entry = queue.pollLast()) != null) {<a name="line.1488"></a>
-<span class="sourceLineNo">1489</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1489"></a>
-<span class="sourceLineNo">1490</span> BucketEntry be = entry.getValue();<a name="line.1490"></a>
-<span class="sourceLineNo">1491</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1491"></a>
-<span class="sourceLineNo">1492</span> freedBytes += be.getLength();<a name="line.1492"></a>
-<span class="sourceLineNo">1493</span> }<a name="line.1493"></a>
-<span class="sourceLineNo">1494</span> if (freedBytes >= toFree) {<a name="line.1494"></a>
-<span class="sourceLineNo">1495</span> return freedBytes;<a name="line.1495"></a>
-<span class="sourceLineNo">1496</span> }<a name="line.1496"></a>
-<span class="sourceLineNo">1497</span> }<a name="line.1497"></a>
-<span class="sourceLineNo">1498</span> return freedBytes;<a name="line.1498"></a>
-<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
-<span class="sourceLineNo">1500</span><a name="line.1500"></a>
-<span class="sourceLineNo">1501</span> public long overflow() {<a name="line.1501"></a>
-<span class="sourceLineNo">1502</span> return totalSize - bucketSize;<a name="line.1502"></a>
-<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
-<span class="sourceLineNo">1504</span><a name="line.1504"></a>
-<span class="sourceLineNo">1505</span> public long totalSize() {<a name="line.1505"></a>
-<span class="sourceLineNo">1506</span> return totalSize;<a name="line.1506"></a>
-<span class="sourceLineNo">1507</span> }<a name="line.1507"></a>
-<span class="sourceLineNo">1508</span> }<a name="line.1508"></a>
-<span class="sourceLineNo">1509</span><a name="line.1509"></a>
-<span class="sourceLineNo">1510</span> /**<a name="line.1510"></a>
-<span class="sourceLineNo">1511</span> * Block Entry stored in the memory with key,data and so on<a name="line.1511"></a>
-<span class="sourceLineNo">1512</span> */<a name="line.1512"></a>
-<span class="sourceLineNo">1513</span> static class RAMQueueEntry {<a name="line.1513"></a>
-<span class="sourceLineNo">1514</span> private final BlockCacheKey key;<a name="line.1514"></a>
-<span class="sourceLineNo">1515</span> private final Cacheable data;<a name="line.1515"></a>
-<span class="sourceLineNo">1516</span> private long accessCounter;<a name="line.1516"></a>
-<span class="sourceLineNo">1517</span> private boolean inMemory;<a name="line.1517"></a>
-<span class="sourceLineNo">1518</span><a name="line.1518"></a>
-<span class="sourceLineNo">1519</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1519"></a>
-<span class="sourceLineNo">1520</span> this.key = bck;<a name="line.1520"></a>
-<span class="sourceLineNo">1521</span> this.data = data;<a name="line.1521"></a>
-<span class="sourceLineNo">1522</span> this.accessCounter = accessCounter;<a name="line.1522"></a>
-<span class="sourceLineNo">1523</span> this.inMemory = inMemory;<a name="line.1523"></a>
-<span class="sourceLineNo">1524</span> }<a name="line.1524"></a>
-<span class="sourceLineNo">1525</span><a name="line.1525"></a>
-<span class="sourceLineNo">1526</span> public Cacheable getData() {<a name="line.1526"></a>
-<span class="sourceLineNo">1527</span> return data;<a name="line.1527"></a>
-<span class="sourceLineNo">1528</span> }<a name="line.1528"></a>
-<span class="sourceLineNo">1529</span><a name="line.1529"></a>
-<span class="sourceLineNo">1530</span> public BlockCacheKey getKey() {<a name="line.1530"></a>
-<span class="sourceLineNo">1531</span> return key;<a name="line.1531"></a>
-<span class="sourceLineNo">1532</span> }<a name="line.1532"></a>
-<span class="sourceLineNo">1533</span><a name="line.1533"></a>
-<span class="sourceLineNo">1534</span> public void access(long accessCounter) {<a name="line.1534"></a>
-<span class="sourceLineNo">1535</span> this.accessCounter = accessCounter;<a name="line.1535"></a>
-<span class="sourceLineNo">1536</span> }<a name="line.1536"></a>
-<span class="sourceLineNo">1537</span><a name="line.1537"></a>
-<span class="sourceLineNo">1538</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1538"></a>
-<span class="sourceLineNo">1539</span> if (data instanceof HFileBlock) {<a name="line.1539"></a>
-<span class="sourceLineNo">1540</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1540"></a>
-<span class="sourceLineNo">1541</span> }<a name="line.1541"></a>
-<span class="sourceLineNo">1542</span> return ByteBuffAllocator.HEAP;<a name="line.1542"></a>
-<span class="sourceLineNo">1543</span> }<a name="line.1543"></a>
-<span class="sourceLineNo">1544</span><a name="line.1544"></a>
-<span class="sourceLineNo">1545</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1545"></a>
-<span class="sourceLineNo">1546</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1546"></a>
-<span class="sourceLineNo">1547</span> ByteBuffer metaBuff) throws IOException {<a name="line.1547"></a>
-<span class="sourceLineNo">1548</span> int len = data.getSerializedLength();<a name="line.1548"></a>
-<span class="sourceLineNo">1549</span> // This cacheable thing can't be serialized<a name="line.1549"></a>
-<span class="sourceLineNo">1550</span> if (len == 0) {<a name="line.1550"></a>
-<span class="sourceLineNo">1551</span> return null;<a name="line.1551"></a>
-<span class="sourceLineNo">1552</span> }<a name="line.1552"></a>
-<span class="sourceLineNo">1553</span> long offset = alloc.allocateBlock(len);<a name="line.1553"></a>
-<span class="sourceLineNo">1554</span> boolean succ = false;<a name="line.1554"></a>
-<span class="sourceLineNo">1555</span> BucketEntry bucketEntry = null;<a name="line.1555"></a>
-<span class="sourceLineNo">1556</span> try {<a name="line.1556"></a>
-<span class="sourceLineNo">1557</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1557"></a>
-<span class="sourceLineNo">1558</span> getByteBuffAllocator());<a name="line.1558"></a>
-<span class="sourceLineNo">1559</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1559"></a>
-<span class="sourceLineNo">1560</span> if (data instanceof HFileBlock) {<a name="line.1560"></a>
-<span class="sourceLineNo">1561</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1561"></a>
-<span class="sourceLineNo">1562</span> HFileBlock block = (HFileBlock) data;<a name="line.1562"></a>
-<span class="sourceLineNo">1563</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1563"></a>
-<span class="sourceLineNo">1564</span> block.getMetaData(metaBuff);<a name="line.1564"></a>
-<span class="sourceLineNo">1565</span> ioEngine.write(sliceBuf, offset);<a name="line.1565"></a>
-<span class="sourceLineNo">1566</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1566"></a>
-<span class="sourceLineNo">1567</span> } else {<a name="line.1567"></a>
-<span class="sourceLineNo">1568</span> // Only used for testing.<a name="line.1568"></a>
-<span class="sourceLineNo">1569</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1569"></a>
-<span class="sourceLineNo">1570</span> data.serialize(bb, true);<a name="line.1570"></a>
-<span class="sourceLineNo">1571</span> ioEngine.write(bb, offset);<a name="line.1571"></a>
-<span class="sourceLineNo">1572</span> }<a name="line.1572"></a>
-<span class="sourceLineNo">1573</span> succ = true;<a name="line.1573"></a>
-<span class="sourceLineNo">1574</span> } finally {<a name="line.1574"></a>
-<span class="sourceLineNo">1575</span> if (!succ) {<a name="line.1575"></a>
-<span class="sourceLineNo">1576</span> alloc.freeBlock(offset, len);<a name="line.1576"></a>
-<span class="sourceLineNo">1577</span> }<a name="line.1577"></a>
-<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
-<span class="sourceLineNo">1579</span> realCacheSize.add(len);<a name="line.1579"></a>
-<span class="sourceLineNo">1580</span> return bucketEntry;<a name="line.1580"></a>
-<span class="sourceLineNo">1581</span> }<a name="line.1581"></a>
-<span class="sourceLineNo">1582</span> }<a name="line.1582"></a>
-<span class="sourceLineNo">1583</span><a name="line.1583"></a>
-<span class="sourceLineNo">1584</span> /**<a name="line.1584"></a>
-<span class="sourceLineNo">1585</span> * Only used in test<a name="line.1585"></a>
-<span class="sourceLineNo">1586</span> */<a name="line.1586"></a>
-<span class="sourceLineNo">1587</span> void stopWriterThreads() throws InterruptedException {<a name="line.1587"></a>
-<span class="sourceLineNo">1588</span> for (WriterThread writerThread : writerThreads) {<a name="line.1588"></a>
-<span class="sourceLineNo">1589</span> writerThread.disableWriter();<a name="line.1589"></a>
-<span class="sourceLineNo">1590</span> writerThread.interrupt();<a name="line.1590"></a>
-<span class="sourceLineNo">1591</span> writerThread.join();<a name="line.1591"></a>
-<span class="sourceLineNo">1592</span> }<a name="line.1592"></a>
-<span class="sourceLineNo">1593</span> }<a name="line.1593"></a>
-<span class="sourceLineNo">1594</span><a name="line.1594"></a>
-<span class="sourceLineNo">1595</span> @Override<a name="line.1595"></a>
-<span class="sourceLineNo">1596</span> public Iterator<CachedBlock> iterator() {<a name="line.1596"></a>
-<span class="sourceLineNo">1597</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1597"></a>
-<span class="sourceLineNo">1598</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1598"></a>
-<span class="sourceLineNo">1599</span> return new Iterator<CachedBlock>() {<a name="line.1599"></a>
-<span class="sourceLineNo">1600</span> private final long now = System.nanoTime();<a name="line.1600"></a>
-<span class="sourceLineNo">1601</span><a name="line.1601"></a>
-<span class="sourceLineNo">1602</span> @Override<a name="line.1602"></a>
-<span class="sourceLineNo">1603</span> public boolean hasNext() {<a name="line.1603"></a>
-<span class="sourceLineNo">1604</span> return i.hasNext();<a name="line.1604"></a>
-<span class="sourceLineNo">1605</span> }<a name="line.1605"></a>
-<span class="sourceLineNo">1606</span><a name="line.1606"></a>
-<span class="sourceLineNo">1607</span> @Override<a name="line.1607"></a>
-<span class="sourceLineNo">1608</span> public CachedBlock next() {<a name="line.1608"></a>
-<span class="sourceLineNo">1609</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1609"></a>
-<span class="sourceLineNo">1610</span> return new CachedBlock() {<a name="line.1610"></a>
-<span class="sourceLineNo">1611</span> @Override<a name="line.1611"></a>
-<span class="sourceLineNo">1612</span> public String toString() {<a name="line.1612"></a>
-<span class="sourceLineNo">1613</span> return BlockCacheUtil.toString(this, now);<a name="line.1613"></a>
-<span class="sourceLineNo">1614</span> }<a name="line.1614"></a>
-<span class="sourceLineNo">1615</span><a name="line.1615"></a>
-<span class="sourceLineNo">1616</span> @Override<a name="line.1616"></a>
-<span class="sourceLineNo">1617</span> public BlockPriority getBlockPriority() {<a name="line.1617"></a>
-<span class="sourceLineNo">1618</span> return e.getValue().getPriority();<a name="line.1618"></a>
-<span class="sourceLineNo">1619</span> }<a name="line.1619"></a>
-<span class="sourceLineNo">1620</span><a name="line.1620"></a>
-<span class="sourceLineNo">1621</span> @Override<a name="line.1621"></a>
-<span class="sourceLineNo">1622</span> public BlockType getBlockType() {<a name="line.1622"></a>
-<span class="sourceLineNo">1623</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1623"></a>
-<span class="sourceLineNo">1624</span> return null;<a name="line.1624"></a>
+<span class="sourceLineNo">1478</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1478"></a>
+<span class="sourceLineNo">1479</span> this.bucketSize = bucketSize;<a name="line.1479"></a>
+<span class="sourceLineNo">1480</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1480"></a>
+<span class="sourceLineNo">1481</span> totalSize = 0;<a name="line.1481"></a>
+<span class="sourceLineNo">1482</span> }<a name="line.1482"></a>
+<span class="sourceLineNo">1483</span><a name="line.1483"></a>
+<span class="sourceLineNo">1484</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1484"></a>
+<span class="sourceLineNo">1485</span> totalSize += block.getValue().getLength();<a name="line.1485"></a>
+<span class="sourceLineNo">1486</span> queue.add(block);<a name="line.1486"></a>
+<span class="sourceLineNo">1487</span> }<a name="line.1487"></a>
+<span class="sourceLineNo">1488</span><a name="line.1488"></a>
+<span class="sourceLineNo">1489</span> public long free(long toFree) {<a name="line.1489"></a>
+<span class="sourceLineNo">1490</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1490"></a>
+<span class="sourceLineNo">1491</span> long freedBytes = 0;<a name="line.1491"></a>
+<span class="sourceLineNo">1492</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1492"></a>
+<span class="sourceLineNo">1493</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1493"></a>
+<span class="sourceLineNo">1494</span> while ((entry = queue.pollLast()) != null) {<a name="line.1494"></a>
+<span class="sourceLineNo">1495</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1495"></a>
+<span class="sourceLineNo">1496</span> BucketEntry be = entry.getValue();<a name="line.1496"></a>
+<span class="sourceLineNo">1497</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1497"></a>
+<span class="sourceLineNo">1498</span> freedBytes += be.getLength();<a name="line.1498"></a>
+<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
+<span class="sourceLineNo">1500</span> if (freedBytes >= toFree) {<a name="line.1500"></a>
+<span class="sourceLineNo">1501</span> return freedBytes;<a name="line.1501"></a>
+<span class="sourceLineNo">1502</span> }<a name="line.1502"></a>
+<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
+<span class="sourceLineNo">1504</span> return freedBytes;<a name="line.1504"></a>
+<span class="sourceLineNo">1505</span> }<a name="line.1505"></a>
+<span class="sourceLineNo">1506</span><a name="line.1506"></a>
+<span class="sourceLineNo">1507</span> public long overflow() {<a name="line.1507"></a>
+<span class="sourceLineNo">1508</span> return totalSize - bucketSize;<a name="line.1508"></a>
+<span class="sourceLineNo">1509</span> }<a name="line.1509"></a>
+<span class="sourceLineNo">1510</span><a name="line.1510"></a>
+<span class="sourceLineNo">1511</span> public long totalSize() {<a name="line.1511"></a>
+<span class="sourceLineNo">1512</span> return totalSize;<a name="line.1512"></a>
+<span class="sourceLineNo">1513</span> }<a name="line.1513"></a>
+<span class="sourceLineNo">1514</span> }<a name="line.1514"></a>
+<span class="sourceLineNo">1515</span><a name="line.1515"></a>
+<span class="sourceLineNo">1516</span> /**<a name="line.1516"></a>
+<span class="sourceLineNo">1517</span> * Block Entry stored in the memory with key,data and so on<a name="line.1517"></a>
+<span class="sourceLineNo">1518</span> */<a name="line.1518"></a>
+<span class="sourceLineNo">1519</span> static class RAMQueueEntry {<a name="line.1519"></a>
+<span class="sourceLineNo">1520</span> private final BlockCacheKey key;<a name="line.1520"></a>
+<span class="sourceLineNo">1521</span> private final Cacheable data;<a name="line.1521"></a>
+<span class="sourceLineNo">1522</span> private long accessCounter;<a name="line.1522"></a>
+<span class="sourceLineNo">1523</span> private boolean inMemory;<a name="line.1523"></a>
+<span class="sourceLineNo">1524</span><a name="line.1524"></a>
+<span class="sourceLineNo">1525</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1525"></a>
+<span class="sourceLineNo">1526</span> this.key = bck;<a name="line.1526"></a>
+<span class="sourceLineNo">1527</span> this.data = data;<a name="line.1527"></a>
+<span class="sourceLineNo">1528</span> this.accessCounter = accessCounter;<a name="line.1528"></a>
+<span class="sourceLineNo">1529</span> this.inMemory = inMemory;<a name="line.1529"></a>
+<span class="sourceLineNo">1530</span> }<a name="line.1530"></a>
+<span class="sourceLineNo">1531</span><a name="line.1531"></a>
+<span class="sourceLineNo">1532</span> public Cacheable getData() {<a name="line.1532"></a>
+<span class="sourceLineNo">1533</span> return data;<a name="line.1533"></a>
+<span class="sourceLineNo">1534</span> }<a name="line.1534"></a>
+<span class="sourceLineNo">1535</span><a name="line.1535"></a>
+<span class="sourceLineNo">1536</span> public BlockCacheKey getKey() {<a name="line.1536"></a>
+<span class="sourceLineNo">1537</span> return key;<a name="line.1537"></a>
+<span class="sourceLineNo">1538</span> }<a name="line.1538"></a>
+<span class="sourceLineNo">1539</span><a name="line.1539"></a>
+<span class="sourceLineNo">1540</span> public void access(long accessCounter) {<a name="line.1540"></a>
+<span class="sourceLineNo">1541</span> this.accessCounter = accessCounter;<a name="line.1541"></a>
+<span class="sourceLineNo">1542</span> }<a name="line.1542"></a>
+<span class="sourceLineNo">1543</span><a name="line.1543"></a>
+<span class="sourceLineNo">1544</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1544"></a>
+<span class="sourceLineNo">1545</span> if (data instanceof HFileBlock) {<a name="line.1545"></a>
+<span class="sourceLineNo">1546</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1546"></a>
+<span class="sourceLineNo">1547</span> }<a name="line.1547"></a>
+<span class="sourceLineNo">1548</span> return ByteBuffAllocator.HEAP;<a name="line.1548"></a>
+<span class="sourceLineNo">1549</span> }<a name="line.1549"></a>
+<span class="sourceLineNo">1550</span><a name="line.1550"></a>
+<span class="sourceLineNo">1551</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1551"></a>
+<span class="sourceLineNo">1552</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1552"></a>
+<span class="sourceLineNo">1553</span> ByteBuffer metaBuff) throws IOException {<a name="line.1553"></a>
+<span class="sourceLineNo">1554</span> int len = data.getSerializedLength();<a name="line.1554"></a>
+<span class="sourceLineNo">1555</span> // This cacheable thing can't be serialized<a name="line.1555"></a>
+<span class="sourceLineNo">1556</span> if (len == 0) {<a name="line.1556"></a>
+<span class="sourceLineNo">1557</span> return null;<a name="line.1557"></a>
+<span class="sourceLineNo">1558</span> }<a name="line.1558"></a>
+<span class="sourceLineNo">1559</span> long offset = alloc.allocateBlock(len);<a name="line.1559"></a>
+<span class="sourceLineNo">1560</span> boolean succ = false;<a name="line.1560"></a>
+<span class="sourceLineNo">1561</span> BucketEntry bucketEntry = null;<a name="line.1561"></a>
+<span class="sourceLineNo">1562</span> try {<a name="line.1562"></a>
+<span class="sourceLineNo">1563</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1563"></a>
+<span class="sourceLineNo">1564</span> getByteBuffAllocator());<a name="line.1564"></a>
+<span class="sourceLineNo">1565</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1565"></a>
+<span class="sourceLineNo">1566</span> if (data instanceof HFileBlock) {<a name="line.1566"></a>
+<span class="sourceLineNo">1567</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1567"></a>
+<span class="sourceLineNo">1568</span> HFileBlock block = (HFileBlock) data;<a name="line.1568"></a>
+<span class="sourceLineNo">1569</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1569"></a>
+<span class="sourceLineNo">1570</span> block.getMetaData(metaBuff);<a name="line.1570"></a>
+<span class="sourceLineNo">1571</span> ioEngine.write(sliceBuf, offset);<a name="line.1571"></a>
+<span class="sourceLineNo">1572</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1572"></a>
+<span class="sourceLineNo">1573</span> } else {<a name="line.1573"></a>
+<span class="sourceLineNo">1574</span> // Only used for testing.<a name="line.1574"></a>
+<span class="sourceLineNo">1575</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1575"></a>
+<span class="sourceLineNo">1576</span> data.serialize(bb, true);<a name="line.1576"></a>
+<span class="sourceLineNo">1577</span> ioEngine.write(bb, offset);<a name="line.1577"></a>
+<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
+<span class="sourceLineNo">1579</span> succ = true;<a name="line.1579"></a>
+<span class="sourceLineNo">1580</span> } finally {<a name="line.1580"></a>
+<span class="sourceLineNo">1581</span> if (!succ) {<a name="line.1581"></a>
+<span class="sourceLineNo">1582</span> alloc.freeBlock(offset, len);<a name="line.1582"></a>
+<span class="sourceLineNo">1583</span> }<a name="line.1583"></a>
+<span class="sourceLineNo">1584</span> }<a name="line.1584"></a>
+<span class="sourceLineNo">1585</span> realCacheSize.add(len);<a name="line.1585"></a>
+<span class="sourceLineNo">1586</span> return bucketEntry;<a name="line.1586"></a>
+<span class="sourceLineNo">1587</span> }<a name="line.1587"></a>
+<span class="sourceLineNo">1588</span> }<a name="line.1588"></a>
+<span class="sourceLineNo">1589</span><a name="line.1589"></a>
+<span class="sourceLineNo">1590</span> /**<a name="line.1590"></a>
+<span class="sourceLineNo">1591</span> * Only used in test<a name="line.1591"></a>
+<span class="sourceLineNo">1592</span> */<a name="line.1592"></a>
+<span class="sourceLineNo">1593</span> void stopWriterThreads() throws InterruptedException {<a name="line.1593"></a>
+<span class="sourceLineNo">1594</span> for (WriterThread writerThread : writerThreads) {<a name="line.1594"></a>
+<span class="sourceLineNo">1595</span> writerThread.disableWriter();<a name="line.1595"></a>
+<span class="sourceLineNo">1596</span> writerThread.interrupt();<a name="line.1596"></a>
+<span class="sourceLineNo">1597</span> writerThread.join();<a name="line.1597"></a>
+<span class="sourceLineNo">1598</span> }<a name="line.1598"></a>
+<span class="sourceLineNo">1599</span> }<a name="line.1599"></a>
+<span class="sourceLineNo">1600</span><a name="line.1600"></a>
+<span class="sourceLineNo">1601</span> @Override<a name="line.1601"></a>
+<span class="sourceLineNo">1602</span> public Iterator<CachedBlock> iterator() {<a name="line.1602"></a>
+<span class="sourceLineNo">1603</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1603"></a>
+<span class="sourceLineNo">1604</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1604"></a>
+<span class="sourceLineNo">1605</span> return new Iterator<CachedBlock>() {<a name="line.1605"></a>
+<span class="sourceLineNo">1606</span> private final long now = System.nanoTime();<a name="line.1606"></a>
+<span class="sourceLineNo">1607</span><a name="line.1607"></a>
+<span class="sourceLineNo">1608</span> @Override<a name="line.1608"></a>
+<span class="sourceLineNo">1609</span> public boolean hasNext() {<a name="line.1609"></a>
+<span class="sourceLineNo">1610</span> return i.hasNext();<a name="line.1610"></a>
+<span class="sourceLineNo">1611</span> }<a name="line.1611"></a>
+<span class="sourceLineNo">1612</span><a name="line.1612"></a>
+<span class="sourceLineNo">1613</span> @Override<a name="line.1613"></a>
+<span class="sourceLineNo">1614</span> public CachedBlock next() {<a name="line.1614"></a>
+<span class="sourceLineNo">1615</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1615"></a>
+<span class="sourceLineNo">1616</span> return new CachedBlock() {<a name="line.1616"></a>
+<span class="sourceLineNo">1617</span> @Override<a name="line.1617"></a>
+<span class="sourceLineNo">1618</span> public String toString() {<a name="line.1618"></a>
+<span class="sourceLineNo">1619</span> return BlockCacheUtil.toString(this, now);<a name="line.1619"></a>
+<span class="sourceLineNo">1620</span> }<a name="line.1620"></a>
+<span class="sourceLineNo">1621</span><a name="line.1621"></a>
+<span class="sourceLineNo">1622</span> @Override<a name="line.1622"></a>
+<span class="sourceLineNo">1623</span> public BlockPriority getBlockPriority() {<a name="line.1623"></a>
+<span class="sourceLineNo">1624</span> return e.getValue().getPriority();<a name="line.1624"></a>
<span class="sourceLineNo">1625</span> }<a name="line.1625"></a>
<span class="sourceLineNo">1626</span><a name="line.1626"></a>
<span class="sourceLineNo">1627</span> @Override<a name="line.1627"></a>
-<span class="sourceLineNo">1628</span> public long getOffset() {<a name="line.1628"></a>
-<span class="sourceLineNo">1629</span> return e.getKey().getOffset();<a name="line.1629"></a>
-<span class="sourceLineNo">1630</span> }<a name="line.1630"></a>
-<span class="sourceLineNo">1631</span><a name="line.1631"></a>
-<span class="sourceLineNo">1632</span> @Override<a name="line.1632"></a>
-<span class="sourceLineNo">1633</span> public long getSize() {<a name="line.1633"></a>
-<span class="sourceLineNo">1634</span> return e.getValue().getLength();<a name="line.1634"></a>
-<span class="sourceLineNo">1635</span> }<a name="line.1635"></a>
-<span class="sourceLineNo">1636</span><a name="line.1636"></a>
-<span class="sourceLineNo">1637</span> @Override<a name="line.1637"></a>
-<span class="sourceLineNo">1638</span> public long getCachedTime() {<a name="line.1638"></a>
-<span class="sourceLineNo">1639</span> return e.getValue().getCachedTime();<a name="line.1639"></a>
-<span class="sourceLineNo">1640</span> }<a name="line.1640"></a>
-<span class="sourceLineNo">1641</span><a name="line.1641"></a>
-<span class="sourceLineNo">1642</span> @Override<a name="line.1642"></a>
-<span class="sourceLineNo">1643</span> public String getFilename() {<a name="line.1643"></a>
-<span class="sourceLineNo">1644</span> return e.getKey().getHfileName();<a name="line.1644"></a>
-<span class="sourceLineNo">1645</span> }<a name="line.1645"></a>
-<span class="sourceLineNo">1646</span><a name="line.1646"></a>
-<span class="sourceLineNo">1647</span> @Override<a name="line.1647"></a>
-<span class="sourceLineNo">1648</span> public int compareTo(CachedBlock other) {<a name="line.1648"></a>
-<span class="sourceLineNo">1649</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1649"></a>
-<span class="sourceLineNo">1650</span> if (diff != 0) return diff;<a name="line.1650"></a>
-<span class="sourceLineNo">1651</span><a name="line.1651"></a>
-<span class="sourceLineNo">1652</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1652"></a>
-<span class="sourceLineNo">1653</span> if (diff != 0) return diff;<a name="line.1653"></a>
-<span class="sourceLineNo">1654</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1654"></a>
-<span class="sourceLineNo">1655</span> throw new IllegalStateException(<a name="line.1655"></a>
-<span class="sourceLineNo">1656</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1656"></a>
-<span class="sourceLineNo">1657</span> }<a name="line.1657"></a>
-<span class="sourceLineNo">1658</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1658"></a>
-<span class="sourceLineNo">1659</span> }<a name="line.1659"></a>
-<span class="sourceLineNo">1660</span><a name="line.1660"></a>
-<span class="sourceLineNo">1661</span> @Override<a name="line.1661"></a>
-<span class="sourceLineNo">1662</span> public int hashCode() {<a name="line.1662"></a>
-<span class="sourceLineNo">1663</span> return e.getKey().hashCode();<a name="line.1663"></a>
-<span class="sourceLineNo">1664</span> }<a name="line.1664"></a>
-<span class="sourceLineNo">1665</span><a name="line.1665"></a>
-<span class="sourceLineNo">1666</span> @Override<a name="line.1666"></a>
-<span class="sourceLineNo">1667</span> public boolean equals(Object obj) {<a name="line.1667"></a>
-<span class="sourceLineNo">1668</span> if (obj instanceof CachedBlock) {<a name="line.1668"></a>
-<span class="sourceLineNo">1669</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1669"></a>
-<span class="sourceLineNo">1670</span> return compareTo(cb) == 0;<a name="line.1670"></a>
-<span class="sourceLineNo">1671</span> } else {<a name="line.1671"></a>
-<span class="sourceLineNo">1672</span> return false;<a name="line.1672"></a>
-<span class="sourceLineNo">1673</span> }<a name="line.1673"></a>
-<span class="sourceLineNo">1674</span> }<a name="line.1674"></a>
-<span class="sourceLineNo">1675</span> };<a name="line.1675"></a>
-<span class="sourceLineNo">1676</span> }<a name="line.1676"></a>
-<span class="sourceLineNo">1677</span><a name="line.1677"></a>
-<span class="sourceLineNo">1678</span> @Override<a name="line.1678"></a>
-<span class="sourceLineNo">1679</span> public void remove() {<a name="line.1679"></a>
-<span class="sourceLineNo">1680</span> throw new UnsupportedOperationException();<a name="line.1680"></a>
-<span class="sourceLineNo">1681</span> }<a name="line.1681"></a>
-<span class="sourceLineNo">1682</span> };<a name="line.1682"></a>
-<span class="sourceLineNo">1683</span> }<a name="line.1683"></a>
-<span class="sourceLineNo">1684</span><a name="line.1684"></a>
-<span class="sourceLineNo">1685</span> @Override<a name="line.1685"></a>
-<span class="sourceLineNo">1686</span> public BlockCache[] getBlockCaches() {<a name="line.1686"></a>
-<span class="sourceLineNo">1687</span> return null;<a name="line.1687"></a>
-<span class="sourceLineNo">1688</span> }<a name="line.1688"></a>
-<span class="sourceLineNo">1689</span><a name="line.1689"></a>
-<span class="sourceLineNo">1690</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1690"></a>
-<span class="sourceLineNo">1691</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1691"></a>
-<span class="sourceLineNo">1692</span> if (bucketEntry != null) {<a name="line.1692"></a>
-<span class="sourceLineNo">1693</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1693"></a>
-<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
-<span class="sourceLineNo">1695</span> return 0;<a name="line.1695"></a>
-<span class="sourceLineNo">1696</span> }<a name="line.1696"></a>
-<span class="sourceLineNo">1697</span><a name="line.1697"></a>
-<span class="sourceLineNo">1698</span> float getAcceptableFactor() {<a name="line.1698"></a>
-<span class="sourceLineNo">1699</span> return acceptableFactor;<a name="line.1699"></a>
-<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
-<span class="sourceLineNo">1701</span><a name="line.1701"></a>
-<span class="sourceLineNo">1702</span> float getMinFactor() {<a name="line.1702"></a>
-<span class="sourceLineNo">1703</span> return minFactor;<a name="line.1703"></a>
-<span class="sourceLineNo">1704</span> }<a name="line.1704"></a>
-<span class="sourceLineNo">1705</span><a name="line.1705"></a>
-<span class="sourceLineNo">1706</span> float getExtraFreeFactor() {<a name="line.1706"></a>
-<span class="sourceLineNo">1707</span> return extraFreeFactor;<a name="line.1707"></a>
-<span class="sourceLineNo">1708</span> }<a name="line.1708"></a>
-<span class="sourceLineNo">1709</span><a name="line.1709"></a>
-<span class="sourceLineNo">1710</span> float getSingleFactor() {<a name="line.1710"></a>
-<span class="sourceLineNo">1711</span> return singleFactor;<a name="line.1711"></a>
-<span class="sourceLineNo">1712</span> }<a name="line.1712"></a>
-<span class="sourceLineNo">1713</span><a name="line.1713"></a>
-<span class="sourceLineNo">1714</span> float getMultiFactor() {<a name="line.1714"></a>
-<span class="sourceLineNo">1715</span> return multiFactor;<a name="line.1715"></a>
-<span class="sourceLineNo">1716</span> }<a name="line.1716"></a>
-<span class="sourceLineNo">1717</span><a name="line.1717"></a>
-<span class="sourceLineNo">1718</span> float getMemoryFactor() {<a name="line.1718"></a>
-<span class="sourceLineNo">1719</span> return memoryFactor;<a name="line.1719"></a>
-<span class="sourceLineNo">1720</span> }<a name="line.1720"></a>
-<span class="sourceLineNo">1721</span><a name="line.1721"></a>
-<span class="sourceLineNo">1722</span> /**<a name="line.1722"></a>
-<span class="sourceLineNo">1723</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1723"></a>
-<span class="sourceLineNo">1724</span> */<a name="line.1724"></a>
-<span class="sourceLineNo">1725</span> static class RAMCache {<a name="line.1725"></a>
-<span class="sourceLineNo">1726</span> /**<a name="line.1726"></a>
-<span class="sourceLineNo">1727</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1727"></a>
-<span class="sourceLineNo">1728</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1728"></a>
-<span class="sourceLineNo">1729</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1729"></a>
-<span class="sourceLineNo">1730</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1730"></a>
-<span class="sourceLineNo">1731</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1731"></a>
-<span class="sourceLineNo">1732</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1732"></a>
-<span class="sourceLineNo">1733</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1733"></a>
-<span class="sourceLineNo">1734</span> */<a name="line.1734"></a>
-<span class="sourceLineNo">1735</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1735"></a>
-<span class="sourceLineNo">1736</span><a name="line.1736"></a>
-<span class="sourceLineNo">1737</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1737"></a>
-<span class="sourceLineNo">1738</span> return delegate.containsKey(key);<a name="line.1738"></a>
-<span class="sourceLineNo">1739</span> }<a name="line.1739"></a>
-<span class="sourceLineNo">1740</span><a name="line.1740"></a>
-<span class="sourceLineNo">1741</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1741"></a>
-<span class="sourceLineNo">1742</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1742"></a>
-<span class="sourceLineNo">1743</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1743"></a>
-<span class="sourceLineNo">1744</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1744"></a>
-<span class="sourceLineNo">1745</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1745"></a>
-<span class="sourceLineNo">1746</span> re.getData().retain();<a name="line.1746"></a>
-<span class="sourceLineNo">1747</span> return re;<a name="line.1747"></a>
-<span class="sourceLineNo">1748</span> });<a name="line.1748"></a>
-<span class="sourceLineNo">1749</span> }<a name="line.1749"></a>
-<span class="sourceLineNo">1750</span><a name="line.1750"></a>
-<span class="sourceLineNo">1751</span> /**<a name="line.1751"></a>
-<span class="sourceLineNo">1752</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1752"></a>
-<span class="sourceLineNo">1753</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1753"></a>
-<span class="sourceLineNo">1754</span> */<a name="line.1754"></a>
-<span class="sourceLineNo">1755</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1755"></a>
-<span class="sourceLineNo">1756</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1756"></a>
-<span class="sourceLineNo">1757</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1757"></a>
-<span class="sourceLineNo">1758</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1758"></a>
-<span class="sourceLineNo">1759</span> entry.getData().retain();<a name="line.1759"></a>
-<span class="sourceLineNo">1760</span> absent.set(true);<a name="line.1760"></a>
-<span class="sourceLineNo">1761</span> return entry;<a name="line.1761"></a>
-<span class="sourceLineNo">1762</span> });<a name="line.1762"></a>
-<span class="sourceLineNo">1763</span> return absent.get() ? null : re;<a name="line.1763"></a>
-<span class="sourceLineNo">1764</span> }<a name="line.1764"></a>
-<span class="sourceLineNo">1765</span><a name="line.1765"></a>
-<span class="sourceLineNo">1766</span> public boolean remove(BlockCacheKey key) {<a name="line.1766"></a>
-<span class="sourceLineNo">1767</span> return remove(key, re -> {<a name="line.1767"></a>
+<span class="sourceLineNo">1628</span> public BlockType getBlockType() {<a name="line.1628"></a>
+<span class="sourceLineNo">1629</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1629"></a>
+<span class="sourceLineNo">1630</span> return null;<a name="line.1630"></a>
+<span class="sourceLineNo">1631</span> }<a name="line.1631"></a>
+<span class="sourceLineNo">1632</span><a name="line.1632"></a>
+<span class="sourceLineNo">1633</span> @Override<a name="line.1633"></a>
+<span class="sourceLineNo">1634</span> public long getOffset() {<a name="line.1634"></a>
+<span class="sourceLineNo">1635</span> return e.getKey().getOffset();<a name="line.1635"></a>
+<span class="sourceLineNo">1636</span> }<a name="line.1636"></a>
+<span class="sourceLineNo">1637</span><a name="line.1637"></a>
+<span class="sourceLineNo">1638</span> @Override<a name="line.1638"></a>
+<span class="sourceLineNo">1639</span> public long getSize() {<a name="line.1639"></a>
+<span class="sourceLineNo">1640</span> return e.getValue().getLength();<a name="line.1640"></a>
+<span class="sourceLineNo">1641</span> }<a name="line.1641"></a>
+<span class="sourceLineNo">1642</span><a name="line.1642"></a>
+<span class="sourceLineNo">1643</span> @Override<a name="line.1643"></a>
+<span class="sourceLineNo">1644</span> public long getCachedTime() {<a name="line.1644"></a>
+<span class="sourceLineNo">1645</span> return e.getValue().getCachedTime();<a name="line.1645"></a>
+<span class="sourceLineNo">1646</span> }<a name="line.1646"></a>
+<span class="sourceLineNo">1647</span><a name="line.1647"></a>
+<span class="sourceLineNo">1648</span> @Override<a name="line.1648"></a>
+<span class="sourceLineNo">1649</span> public String getFilename() {<a name="line.1649"></a>
+<span class="sourceLineNo">1650</span> return e.getKey().getHfileName();<a name="line.1650"></a>
+<span class="sourceLineNo">1651</span> }<a name="line.1651"></a>
+<span class="sourceLineNo">1652</span><a name="line.1652"></a>
+<span class="sourceLineNo">1653</span> @Override<a name="line.1653"></a>
+<span class="sourceLineNo">1654</span> public int compareTo(CachedBlock other) {<a name="line.1654"></a>
+<span class="sourceLineNo">1655</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1655"></a>
+<span class="sourceLineNo">1656</span> if (diff != 0) return diff;<a name="line.1656"></a>
+<span class="sourceLineNo">1657</span><a name="line.1657"></a>
+<span class="sourceLineNo">1658</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1658"></a>
+<span class="sourceLineNo">1659</span> if (diff != 0) return diff;<a name="line.1659"></a>
+<span class="sourceLineNo">1660</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1660"></a>
+<span class="sourceLineNo">1661</span> throw new IllegalStateException(<a name="line.1661"></a>
+<span class="sourceLineNo">1662</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1662"></a>
+<span class="sourceLineNo">1663</span> }<a name="line.1663"></a>
+<span class="sourceLineNo">1664</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1664"></a>
+<span class="sourceLineNo">1665</span> }<a name="line.1665"></a>
+<span class="sourceLineNo">1666</span><a name="line.1666"></a>
+<span class="sourceLineNo">1667</span> @Override<a name="line.1667"></a>
+<span class="sourceLineNo">1668</span> public int hashCode() {<a name="line.1668"></a>
+<span class="sourceLineNo">1669</span> return e.getKey().hashCode();<a name="line.1669"></a>
+<span class="sourceLineNo">1670</span> }<a name="line.1670"></a>
+<span class="sourceLineNo">1671</span><a name="line.1671"></a>
+<span class="sourceLineNo">1672</span> @Override<a name="line.1672"></a>
+<span class="sourceLineNo">1673</span> public boolean equals(Object obj) {<a name="line.1673"></a>
+<span class="sourceLineNo">1674</span> if (obj instanceof CachedBlock) {<a name="line.1674"></a>
+<span class="sourceLineNo">1675</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1675"></a>
+<span class="sourceLineNo">1676</span> return compareTo(cb) == 0;<a name="line.1676"></a>
+<span class="sourceLineNo">1677</span> } else {<a name="line.1677"></a>
+<span class="sourceLineNo">1678</span> return false;<a name="line.1678"></a>
+<span class="sourceLineNo">1679</span> }<a name="line.1679"></a>
+<span class="sourceLineNo">1680</span> }<a name="line.1680"></a>
+<span class="sourceLineNo">1681</span> };<a name="line.1681"></a>
+<span class="sourceLineNo">1682</span> }<a name="line.1682"></a>
+<span class="sourceLineNo">1683</span><a name="line.1683"></a>
+<span class="sourceLineNo">1684</span> @Override<a name="line.1684"></a>
+<span class="sourceLineNo">1685</span> public void remove() {<a name="line.1685"></a>
+<span class="sourceLineNo">1686</span> throw new UnsupportedOperationException();<a name="line.1686"></a>
+<span class="sourceLineNo">1687</span> }<a name="line.1687"></a>
+<span class="sourceLineNo">1688</span> };<a name="line.1688"></a>
+<span class="sourceLineNo">1689</span> }<a name="line.1689"></a>
+<span class="sourceLineNo">1690</span><a name="line.1690"></a>
+<span class="sourceLineNo">1691</span> @Override<a name="line.1691"></a>
+<span class="sourceLineNo">1692</span> public BlockCache[] getBlockCaches() {<a name="line.1692"></a>
+<span class="sourceLineNo">1693</span> return null;<a name="line.1693"></a>
+<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
+<span class="sourceLineNo">1695</span><a name="line.1695"></a>
+<span class="sourceLineNo">1696</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1696"></a>
+<span class="sourceLineNo">1697</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1697"></a>
+<span class="sourceLineNo">1698</span> if (bucketEntry != null) {<a name="line.1698"></a>
+<span class="sourceLineNo">1699</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1699"></a>
+<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
+<span class="sourceLineNo">1701</span> return 0;<a name="line.1701"></a>
+<span class="sourceLineNo">1702</span> }<a name="line.1702"></a>
+<span class="sourceLineNo">1703</span><a name="line.1703"></a>
+<span class="sourceLineNo">1704</span> float getAcceptableFactor() {<a name="line.1704"></a>
+<span class="sourceLineNo">1705</span> return acceptableFactor;<a name="line.1705"></a>
+<span class="sourceLineNo">1706</span> }<a name="line.1706"></a>
+<span class="sourceLineNo">1707</span><a name="line.1707"></a>
+<span class="sourceLineNo">1708</span> float getMinFactor() {<a name="line.1708"></a>
+<span class="sourceLineNo">1709</span> return minFactor;<a name="line.1709"></a>
+<span class="sourceLineNo">1710</span> }<a name="line.1710"></a>
+<span class="sourceLineNo">1711</span><a name="line.1711"></a>
+<span class="sourceLineNo">1712</span> float getExtraFreeFactor() {<a name="line.1712"></a>
+<span class="sourceLineNo">1713</span> return extraFreeFactor;<a name="line.1713"></a>
+<span class="sourceLineNo">1714</span> }<a name="line.1714"></a>
+<span class="sourceLineNo">1715</span><a name="line.1715"></a>
+<span class="sourceLineNo">1716</span> float getSingleFactor() {<a name="line.1716"></a>
+<span class="sourceLineNo">1717</span> return singleFactor;<a name="line.1717"></a>
+<span class="sourceLineNo">1718</span> }<a name="line.1718"></a>
+<span class="sourceLineNo">1719</span><a name="line.1719"></a>
+<span class="sourceLineNo">1720</span> float getMultiFactor() {<a name="line.1720"></a>
+<span class="sourceLineNo">1721</span> return multiFactor;<a name="line.1721"></a>
+<span class="sourceLineNo">1722</span> }<a name="line.1722"></a>
+<span class="sourceLineNo">1723</span><a name="line.1723"></a>
+<span class="sourceLineNo">1724</span> float getMemoryFactor() {<a name="line.1724"></a>
+<span class="sourceLineNo">1725</span> return memoryFactor;<a name="line.1725"></a>
+<span class="sourceLineNo">1726</span> }<a name="line.1726"></a>
+<span class="sourceLineNo">1727</span><a name="line.1727"></a>
+<span class="sourceLineNo">1728</span> /**<a name="line.1728"></a>
+<span class="sourceLineNo">1729</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1729"></a>
+<span class="sourceLineNo">1730</span> */<a name="line.1730"></a>
+<span class="sourceLineNo">1731</span> static class RAMCache {<a name="line.1731"></a>
+<span class="sourceLineNo">1732</span> /**<a name="line.1732"></a>
+<span class="sourceLineNo">1733</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1733"></a>
+<span class="sourceLineNo">1734</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1734"></a>
+<span class="sourceLineNo">1735</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1735"></a>
+<span class="sourceLineNo">1736</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1736"></a>
+<span class="sourceLineNo">1737</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1737"></a>
+<span class="sourceLineNo">1738</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1738"></a>
+<span class="sourceLineNo">1739</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1739"></a>
+<span class="sourceLineNo">1740</span> */<a name="line.1740"></a>
+<span class="sourceLineNo">1741</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1741"></a>
+<span class="sourceLineNo">1742</span><a name="line.1742"></a>
+<span class="sourceLineNo">1743</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1743"></a>
+<span class="sourceLineNo">1744</span> return delegate.containsKey(key);<a name="line.1744"></a>
+<span class="sourceLineNo">1745</span> }<a name="line.1745"></a>
+<span class="sourceLineNo">1746</span><a name="line.1746"></a>
+<span class="sourceLineNo">1747</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1747"></a>
+<span class="sourceLineNo">1748</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1748"></a>
+<span class="sourceLineNo">1749</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1749"></a>
+<span class="sourceLineNo">1750</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1750"></a>
+<span class="sourceLineNo">1751</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1751"></a>
+<span class="sourceLineNo">1752</span> re.getData().retain();<a name="line.1752"></a>
+<span class="sourceLineNo">1753</span> return re;<a name="line.1753"></a>
+<span class="sourceLineNo">1754</span> });<a name="line.1754"></a>
+<span class="sourceLineNo">1755</span> }<a name="line.1755"></a>
+<span class="sourceLineNo">1756</span><a name="line.1756"></a>
+<span class="sourceLineNo">1757</span> /**<a name="line.1757"></a>
+<span class="sourceLineNo">1758</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1758"></a>
+<span class="sourceLineNo">1759</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1759"></a>
+<span class="sourceLineNo">1760</span> */<a name="line.1760"></a>
+<span class="sourceLineNo">1761</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1761"></a>
+<span class="sourceLineNo">1762</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1762"></a>
+<span class="sourceLineNo">1763</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1763"></a>
+<span class="sourceLineNo">1764</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1764"></a>
+<span class="sourceLineNo">1765</span> entry.getData().retain();<a name="line.1765"></a>
+<span class="sourceLineNo">1766</span> absent.set(true);<a name="line.1766"></a>
+<span class="sourceLineNo">1767</span> return entry;<a name="line.1767"></a>
<span class="sourceLineNo">1768</span> });<a name="line.1768"></a>
-<span class="sourceLineNo">1769</span> }<a name="line.1769"></a>
-<span class="sourceLineNo">1770</span><a name="line.1770"></a>
-<span class="sourceLineNo">1771</span> /**<a name="line.1771"></a>
-<span class="sourceLineNo">1772</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1772"></a>
-<span class="sourceLineNo">1773</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1773"></a>
-<span class="sourceLineNo">1774</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1774"></a>
-<span class="sourceLineNo">1775</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1775"></a>
-<span class="sourceLineNo">1776</span> */<a name="line.1776"></a>
-<span class="sourceLineNo">1777</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1777"></a>
-<span class="sourceLineNo">1778</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1778"></a>
-<span class="sourceLineNo">1779</span> action.accept(previous);<a name="line.1779"></a>
-<span class="sourceLineNo">1780</span> if (previous != null) {<a name="line.1780"></a>
-<span class="sourceLineNo">1781</span> previous.getData().release();<a name="line.1781"></a>
-<span class="sourceLineNo">1782</span> }<a name="line.1782"></a>
-<span class="sourceLineNo">1783</span> return previous != null;<a name="line.1783"></a>
-<span class="sourceLineNo">1784</span> }<a name="line.1784"></a>
-<span class="sourceLineNo">1785</span><a name="line.1785"></a>
-<span class="sourceLineNo">1786</span> public boolean isEmpty() {<a name="line.1786"></a>
-<span class="sourceLineNo">1787</span> return delegate.isEmpty();<a name="line.1787"></a>
-<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
-<span class="sourceLineNo">1789</span><a name="line.1789"></a>
-<span class="sourceLineNo">1790</span> public void clear() {<a name="line.1790"></a>
-<span class="sourceLineNo">1791</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1791"></a>
-<span class="sourceLineNo">1792</span> while (it.hasNext()) {<a name="line.1792"></a>
-<span class="sourceLineNo">1793</span> RAMQueueEntry re = it.next().getValue();<a name="line.1793"></a>
-<span class="sourceLineNo">1794</span> it.remove();<a name="line.1794"></a>
-<span class="sourceLineNo">1795</span> re.getData().release();<a name="line.1795"></a>
-<span class="sourceLineNo">1796</span> }<a name="line.1796"></a>
-<span class="sourceLineNo">1797</span> }<a name="line.1797"></a>
-<span class="sourceLineNo">1798</span> }<a name="line.1798"></a>
-<span class="sourceLineNo">1799</span>}<a name="line.1799"></a>
+<span class="sourceLineNo">1769</span> return absent.get() ? null : re;<a name="line.1769"></a>
+<span class="sourceLineNo">1770</span> }<a name="line.1770"></a>
+<span class="sourceLineNo">1771</span><a name="line.1771"></a>
+<span class="sourceLineNo">1772</span> public boolean remove(BlockCacheKey key) {<a name="line.1772"></a>
+<span class="sourceLineNo">1773</span> return remove(key, re -> {<a name="line.1773"></a>
+<span class="sourceLineNo">1774</span> });<a name="line.1774"></a>
+<span class="sourceLineNo">1775</span> }<a name="line.1775"></a>
+<span class="sourceLineNo">1776</span><a name="line.1776"></a>
+<span class="sourceLineNo">1777</span> /**<a name="line.1777"></a>
+<span class="sourceLineNo">1778</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1778"></a>
+<span class="sourceLineNo">1779</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1779"></a>
+<span class="sourceLineNo">1780</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1780"></a>
+<span class="sourceLineNo">1781</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1781"></a>
+<span class="sourceLineNo">1782</span> */<a name="line.1782"></a>
+<span class="sourceLineNo">1783</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1783"></a>
+<span class="sourceLineNo">1784</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1784"></a>
+<span class="sourceLineNo">1785</span> action.accept(previous);<a name="line.1785"></a>
+<span class="sourceLineNo">1786</span> if (previous != null) {<a name="line.1786"></a>
+<span class="sourceLineNo">1787</span> previous.getData().release();<a name="line.1787"></a>
+<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
+<span class="sourceLineNo">1789</span> return previous != null;<a name="line.1789"></a>
+<span class="sourceLineNo">1790</span> }<a name="line.1790"></a>
+<span class="sourceLineNo">1791</span><a name="line.1791"></a>
+<span class="sourceLineNo">1792</span> public boolean isEmpty() {<a name="line.1792"></a>
+<span class="sourceLineNo">1793</span> return delegate.isEmpty();<a name="line.1793"></a>
+<span class="sourceLineNo">1794</span> }<a name="line.1794"></a>
+<span class="sourceLineNo">1795</span><a name="line.1795"></a>
+<span class="sourceLineNo">1796</span> public void clear() {<a name="line.1796"></a>
+<span class="sourceLineNo">1797</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1797"></a>
+<span class="sourceLineNo">1798</span> while (it.hasNext()) {<a name="line.1798"></a>
+<span class="sourceLineNo">1799</span> RAMQueueEntry re = it.next().getValue();<a name="line.1799"></a>
+<span class="sourceLineNo">1800</span> it.remove();<a name="line.1800"></a>
+<span class="sourceLineNo">1801</span> re.getData().release();<a name="line.1801"></a>
+<span class="sourceLineNo">1802</span> }<a name="line.1802"></a>
+<span class="sourceLineNo">1803</span> }<a name="line.1803"></a>
+<span class="sourceLineNo">1804</span> }<a name="line.1804"></a>
+<span class="sourceLineNo">1805</span>}<a name="line.1805"></a>
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html
index 30710531ef1..6b016942fa7 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/io/hfile/bucket/BucketCache.html
@@ -1053,758 +1053,764 @@
<span class="sourceLineNo">1045</span> final HFileContext fileContext = ((HFileBlock) re.getData()).getHFileContext();<a name="line.1045"></a>
<span class="sourceLineNo">1046</span> final String columnFamily = Bytes.toString(fileContext.getColumnFamily());<a name="line.1046"></a>
<span class="sourceLineNo">1047</span> final String tableName = Bytes.toString(fileContext.getTableName());<a name="line.1047"></a>
-<span class="sourceLineNo">1048</span> if (tableName != null && columnFamily != null) {<a name="line.1048"></a>
+<span class="sourceLineNo">1048</span> if (tableName != null) {<a name="line.1048"></a>
<span class="sourceLineNo">1049</span> sb.append(" Table: ");<a name="line.1049"></a>
<span class="sourceLineNo">1050</span> sb.append(tableName);<a name="line.1050"></a>
-<span class="sourceLineNo">1051</span> sb.append(" CF: ");<a name="line.1051"></a>
-<span class="sourceLineNo">1052</span> sb.append(columnFamily);<a name="line.1052"></a>
-<span class="sourceLineNo">1053</span> sb.append(" HFile: ");<a name="line.1053"></a>
-<span class="sourceLineNo">1054</span> sb.append(fileContext.getHFileName());<a name="line.1054"></a>
+<span class="sourceLineNo">1051</span> }<a name="line.1051"></a>
+<span class="sourceLineNo">1052</span> if (columnFamily != null) {<a name="line.1052"></a>
+<span class="sourceLineNo">1053</span> sb.append(" CF: ");<a name="line.1053"></a>
+<span class="sourceLineNo">1054</span> sb.append(columnFamily);<a name="line.1054"></a>
<span class="sourceLineNo">1055</span> }<a name="line.1055"></a>
-<span class="sourceLineNo">1056</span> } else {<a name="line.1056"></a>
-<span class="sourceLineNo">1057</span> sb.append(" HFile: ");<a name="line.1057"></a>
-<span class="sourceLineNo">1058</span> sb.append(re.getKey());<a name="line.1058"></a>
-<span class="sourceLineNo">1059</span> }<a name="line.1059"></a>
-<span class="sourceLineNo">1060</span> }<a name="line.1060"></a>
-<span class="sourceLineNo">1061</span> sb.append(" Message: ");<a name="line.1061"></a>
-<span class="sourceLineNo">1062</span> sb.append(fle.getMessage());<a name="line.1062"></a>
-<span class="sourceLineNo">1063</span> return sb.toString();<a name="line.1063"></a>
-<span class="sourceLineNo">1064</span> }<a name="line.1064"></a>
-<span class="sourceLineNo">1065</span><a name="line.1065"></a>
-<span class="sourceLineNo">1066</span> /**<a name="line.1066"></a>
-<span class="sourceLineNo">1067</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1067"></a>
-<span class="sourceLineNo">1068</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1068"></a>
-<span class="sourceLineNo">1069</span> * references and we'll OOME.<a name="line.1069"></a>
-<span class="sourceLineNo">1070</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1070"></a>
-<span class="sourceLineNo">1071</span> * interference expected.<a name="line.1071"></a>
-<span class="sourceLineNo">1072</span> */<a name="line.1072"></a>
-<span class="sourceLineNo">1073</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1073"></a>
-<span class="sourceLineNo">1074</span> if (entries.isEmpty()) {<a name="line.1074"></a>
-<span class="sourceLineNo">1075</span> return;<a name="line.1075"></a>
-<span class="sourceLineNo">1076</span> }<a name="line.1076"></a>
-<span class="sourceLineNo">1077</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1077"></a>
-<span class="sourceLineNo">1078</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1078"></a>
-<span class="sourceLineNo">1079</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1079"></a>
-<span class="sourceLineNo">1080</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1080"></a>
-<span class="sourceLineNo">1081</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1081"></a>
-<span class="sourceLineNo">1082</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1082"></a>
-<span class="sourceLineNo">1083</span> final int size = entries.size();<a name="line.1083"></a>
-<span class="sourceLineNo">1084</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1084"></a>
-<span class="sourceLineNo">1085</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1085"></a>
-<span class="sourceLineNo">1086</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1086"></a>
-<span class="sourceLineNo">1087</span> int index = 0;<a name="line.1087"></a>
-<span class="sourceLineNo">1088</span> while (cacheEnabled && index < size) {<a name="line.1088"></a>
-<span class="sourceLineNo">1089</span> RAMQueueEntry re = null;<a name="line.1089"></a>
-<span class="sourceLineNo">1090</span> try {<a name="line.1090"></a>
-<span class="sourceLineNo">1091</span> re = entries.get(index);<a name="line.1091"></a>
-<span class="sourceLineNo">1092</span> if (re == null) {<a name="line.1092"></a>
-<span class="sourceLineNo">1093</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1093"></a>
-<span class="sourceLineNo">1094</span> index++;<a name="line.1094"></a>
-<span class="sourceLineNo">1095</span> continue;<a name="line.1095"></a>
-<span class="sourceLineNo">1096</span> }<a name="line.1096"></a>
-<span class="sourceLineNo">1097</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1097"></a>
-<span class="sourceLineNo">1098</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1098"></a>
-<span class="sourceLineNo">1099</span> blocksByHFile.add(cacheKey);<a name="line.1099"></a>
-<span class="sourceLineNo">1100</span> }<a name="line.1100"></a>
-<span class="sourceLineNo">1101</span> // Reset the position for reuse.<a name="line.1101"></a>
-<span class="sourceLineNo">1102</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1102"></a>
-<span class="sourceLineNo">1103</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1103"></a>
-<span class="sourceLineNo">1104</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1104"></a>
-<span class="sourceLineNo">1105</span> // IOEngine in the future.<a name="line.1105"></a>
-<span class="sourceLineNo">1106</span> metaBuff.clear();<a name="line.1106"></a>
-<span class="sourceLineNo">1107</span> BucketEntry bucketEntry =<a name="line.1107"></a>
-<span class="sourceLineNo">1108</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1108"></a>
-<span class="sourceLineNo">1109</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1109"></a>
-<span class="sourceLineNo">1110</span> bucketEntries[index] = bucketEntry;<a name="line.1110"></a>
-<span class="sourceLineNo">1111</span> if (ioErrorStartTime > 0) {<a name="line.1111"></a>
-<span class="sourceLineNo">1112</span> ioErrorStartTime = -1;<a name="line.1112"></a>
-<span class="sourceLineNo">1113</span> }<a name="line.1113"></a>
-<span class="sourceLineNo">1114</span> index++;<a name="line.1114"></a>
-<span class="sourceLineNo">1115</span> } catch (BucketAllocatorException fle) {<a name="line.1115"></a>
-<span class="sourceLineNo">1116</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1116"></a>
-<span class="sourceLineNo">1117</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1117"></a>
-<span class="sourceLineNo">1118</span> if (<a name="line.1118"></a>
-<span class="sourceLineNo">1119</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1119"></a>
-<span class="sourceLineNo">1120</span> ) {<a name="line.1120"></a>
-<span class="sourceLineNo">1121</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1121"></a>
-<span class="sourceLineNo">1122</span> allocFailLogPrevTs = currTs;<a name="line.1122"></a>
-<span class="sourceLineNo">1123</span> }<a name="line.1123"></a>
-<span class="sourceLineNo">1124</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1124"></a>
-<span class="sourceLineNo">1125</span> bucketEntries[index] = null;<a name="line.1125"></a>
-<span class="sourceLineNo">1126</span> index++;<a name="line.1126"></a>
-<span class="sourceLineNo">1127</span> } catch (CacheFullException cfe) {<a name="line.1127"></a>
-<span class="sourceLineNo">1128</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1128"></a>
-<span class="sourceLineNo">1129</span> if (!freeInProgress) {<a name="line.1129"></a>
-<span class="sourceLineNo">1130</span> freeSpace("Full!");<a name="line.1130"></a>
-<span class="sourceLineNo">1131</span> } else {<a name="line.1131"></a>
-<span class="sourceLineNo">1132</span> Thread.sleep(50);<a name="line.1132"></a>
-<span class="sourceLineNo">1133</span> }<a name="line.1133"></a>
-<span class="sourceLineNo">1134</span> } catch (IOException ioex) {<a name="line.1134"></a>
-<span class="sourceLineNo">1135</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1135"></a>
-<span class="sourceLineNo">1136</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1136"></a>
-<span class="sourceLineNo">1137</span> checkIOErrorIsTolerated();<a name="line.1137"></a>
-<span class="sourceLineNo">1138</span> }<a name="line.1138"></a>
-<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
-<span class="sourceLineNo">1140</span><a name="line.1140"></a>
-<span class="sourceLineNo">1141</span> // Make sure data pages are written on media before we update maps.<a name="line.1141"></a>
-<span class="sourceLineNo">1142</span> try {<a name="line.1142"></a>
-<span class="sourceLineNo">1143</span> ioEngine.sync();<a name="line.1143"></a>
-<span class="sourceLineNo">1144</span> } catch (IOException ioex) {<a name="line.1144"></a>
-<span class="sourceLineNo">1145</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1145"></a>
-<span class="sourceLineNo">1146</span> checkIOErrorIsTolerated();<a name="line.1146"></a>
-<span class="sourceLineNo">1147</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1147"></a>
-<span class="sourceLineNo">1148</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1148"></a>
-<span class="sourceLineNo">1149</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1149"></a>
-<span class="sourceLineNo">1150</span> if (bucketEntry != null) {<a name="line.1150"></a>
-<span class="sourceLineNo">1151</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1151"></a>
-<span class="sourceLineNo">1152</span> bucketEntries[i] = null;<a name="line.1152"></a>
-<span class="sourceLineNo">1153</span> }<a name="line.1153"></a>
-<span class="sourceLineNo">1154</span> }<a name="line.1154"></a>
-<span class="sourceLineNo">1155</span> }<a name="line.1155"></a>
-<span class="sourceLineNo">1156</span><a name="line.1156"></a>
-<span class="sourceLineNo">1157</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1157"></a>
-<span class="sourceLineNo">1158</span> // success or error.<a name="line.1158"></a>
-<span class="sourceLineNo">1159</span> for (int i = 0; i < size; ++i) {<a name="line.1159"></a>
-<span class="sourceLineNo">1160</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1160"></a>
-<span class="sourceLineNo">1161</span> // Only add if non-null entry.<a name="line.1161"></a>
-<span class="sourceLineNo">1162</span> if (bucketEntries[i] != null) {<a name="line.1162"></a>
-<span class="sourceLineNo">1163</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1163"></a>
-<span class="sourceLineNo">1164</span> }<a name="line.1164"></a>
-<span class="sourceLineNo">1165</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1165"></a>
-<span class="sourceLineNo">1166</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1166"></a>
-<span class="sourceLineNo">1167</span> if (re != null) {<a name="line.1167"></a>
-<span class="sourceLineNo">1168</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1168"></a>
-<span class="sourceLineNo">1169</span> }<a name="line.1169"></a>
-<span class="sourceLineNo">1170</span> });<a name="line.1170"></a>
-<span class="sourceLineNo">1171</span> if (!existed && bucketEntries[i] != null) {<a name="line.1171"></a>
-<span class="sourceLineNo">1172</span> // Block should have already been evicted. Remove it and free space.<a name="line.1172"></a>
-<span class="sourceLineNo">1173</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1173"></a>
-<span class="sourceLineNo">1174</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1174"></a>
-<span class="sourceLineNo">1175</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1175"></a>
-<span class="sourceLineNo">1176</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1176"></a>
-<span class="sourceLineNo">1177</span> }<a name="line.1177"></a>
-<span class="sourceLineNo">1178</span> return null;<a name="line.1178"></a>
-<span class="sourceLineNo">1179</span> });<a name="line.1179"></a>
-<span class="sourceLineNo">1180</span> }<a name="line.1180"></a>
-<span class="sourceLineNo">1181</span> }<a name="line.1181"></a>
-<span class="sourceLineNo">1182</span><a name="line.1182"></a>
-<span class="sourceLineNo">1183</span> long used = bucketAllocator.getUsedSize();<a name="line.1183"></a>
-<span class="sourceLineNo">1184</span> if (used > acceptableSize()) {<a name="line.1184"></a>
-<span class="sourceLineNo">1185</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1185"></a>
-<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
-<span class="sourceLineNo">1187</span> return;<a name="line.1187"></a>
-<span class="sourceLineNo">1188</span> }<a name="line.1188"></a>
-<span class="sourceLineNo">1189</span><a name="line.1189"></a>
-<span class="sourceLineNo">1190</span> /**<a name="line.1190"></a>
-<span class="sourceLineNo">1191</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1191"></a>
-<span class="sourceLineNo">1192</span> * returning.<a name="line.1192"></a>
-<span class="sourceLineNo">1193</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1193"></a>
-<span class="sourceLineNo">1194</span> * in case.<a name="line.1194"></a>
-<span class="sourceLineNo">1195</span> * @param q The queue to take from.<a name="line.1195"></a>
-<span class="sourceLineNo">1196</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1196"></a>
-<span class="sourceLineNo">1197</span> */<a name="line.1197"></a>
-<span class="sourceLineNo">1198</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1198"></a>
-<span class="sourceLineNo">1199</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1199"></a>
-<span class="sourceLineNo">1200</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1200"></a>
-<span class="sourceLineNo">1201</span> // ok even if list grew to accommodate thousands.<a name="line.1201"></a>
-<span class="sourceLineNo">1202</span> receptacle.clear();<a name="line.1202"></a>
-<span class="sourceLineNo">1203</span> receptacle.add(q.take());<a name="line.1203"></a>
-<span class="sourceLineNo">1204</span> q.drainTo(receptacle);<a name="line.1204"></a>
-<span class="sourceLineNo">1205</span> return receptacle;<a name="line.1205"></a>
-<span class="sourceLineNo">1206</span> }<a name="line.1206"></a>
-<span class="sourceLineNo">1207</span><a name="line.1207"></a>
-<span class="sourceLineNo">1208</span> /**<a name="line.1208"></a>
-<span class="sourceLineNo">1209</span> * @see #retrieveFromFile(int[])<a name="line.1209"></a>
-<span class="sourceLineNo">1210</span> */<a name="line.1210"></a>
-<span class="sourceLineNo">1211</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1211"></a>
-<span class="sourceLineNo">1212</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1212"></a>
-<span class="sourceLineNo">1213</span> private void persistToFile() throws IOException {<a name="line.1213"></a>
-<span class="sourceLineNo">1214</span> assert !cacheEnabled;<a name="line.1214"></a>
-<span class="sourceLineNo">1215</span> if (!ioEngine.isPersistent()) {<a name="line.1215"></a>
-<span class="sourceLineNo">1216</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1216"></a>
-<span class="sourceLineNo">1217</span> }<a name="line.1217"></a>
-<span class="sourceLineNo">1218</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1218"></a>
-<span class="sourceLineNo">1219</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1219"></a>
-<span class="sourceLineNo">1220</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1220"></a>
-<span class="sourceLineNo">1221</span> }<a name="line.1221"></a>
-<span class="sourceLineNo">1222</span> if (prefetchedFileListPath != null) {<a name="line.1222"></a>
-<span class="sourceLineNo">1223</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1223"></a>
-<span class="sourceLineNo">1224</span> }<a name="line.1224"></a>
-<span class="sourceLineNo">1225</span> }<a name="line.1225"></a>
-<span class="sourceLineNo">1226</span><a name="line.1226"></a>
-<span class="sourceLineNo">1227</span> /**<a name="line.1227"></a>
-<span class="sourceLineNo">1228</span> * @see #persistToFile()<a name="line.1228"></a>
-<span class="sourceLineNo">1229</span> */<a name="line.1229"></a>
-<span class="sourceLineNo">1230</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1230"></a>
-<span class="sourceLineNo">1231</span> File persistenceFile = new File(persistencePath);<a name="line.1231"></a>
-<span class="sourceLineNo">1232</span> if (!persistenceFile.exists()) {<a name="line.1232"></a>
-<span class="sourceLineNo">1233</span> return;<a name="line.1233"></a>
-<span class="sourceLineNo">1234</span> }<a name="line.1234"></a>
-<span class="sourceLineNo">1235</span> assert !cacheEnabled;<a name="line.1235"></a>
-<span class="sourceLineNo">1236</span> if (prefetchedFileListPath != null) {<a name="line.1236"></a>
-<span class="sourceLineNo">1237</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1237"></a>
-<span class="sourceLineNo">1238</span> }<a name="line.1238"></a>
-<span class="sourceLineNo">1239</span><a name="line.1239"></a>
-<span class="sourceLineNo">1240</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1240"></a>
-<span class="sourceLineNo">1241</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1241"></a>
-<span class="sourceLineNo">1242</span> byte[] pbuf = new byte[pblen];<a name="line.1242"></a>
-<span class="sourceLineNo">1243</span> int read = in.read(pbuf);<a name="line.1243"></a>
-<span class="sourceLineNo">1244</span> if (read != pblen) {<a name="line.1244"></a>
-<span class="sourceLineNo">1245</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1245"></a>
-<span class="sourceLineNo">1246</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1246"></a>
-<span class="sourceLineNo">1247</span> }<a name="line.1247"></a>
-<span class="sourceLineNo">1248</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1248"></a>
-<span class="sourceLineNo">1249</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1249"></a>
-<span class="sourceLineNo">1250</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1250"></a>
-<span class="sourceLineNo">1251</span> throw new IOException(<a name="line.1251"></a>
-<span class="sourceLineNo">1252</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1252"></a>
+<span class="sourceLineNo">1056</span> sb.append(" HFile: ");<a name="line.1056"></a>
+<span class="sourceLineNo">1057</span> if (fileContext.getHFileName() != null) {<a name="line.1057"></a>
+<span class="sourceLineNo">1058</span> sb.append(fileContext.getHFileName());<a name="line.1058"></a>
+<span class="sourceLineNo">1059</span> } else {<a name="line.1059"></a>
+<span class="sourceLineNo">1060</span> sb.append(re.getKey());<a name="line.1060"></a>
+<span class="sourceLineNo">1061</span> }<a name="line.1061"></a>
+<span class="sourceLineNo">1062</span> } else {<a name="line.1062"></a>
+<span class="sourceLineNo">1063</span> sb.append(" HFile: ");<a name="line.1063"></a>
+<span class="sourceLineNo">1064</span> sb.append(re.getKey());<a name="line.1064"></a>
+<span class="sourceLineNo">1065</span> }<a name="line.1065"></a>
+<span class="sourceLineNo">1066</span> }<a name="line.1066"></a>
+<span class="sourceLineNo">1067</span> sb.append(" Message: ");<a name="line.1067"></a>
+<span class="sourceLineNo">1068</span> sb.append(fle.getMessage());<a name="line.1068"></a>
+<span class="sourceLineNo">1069</span> return sb.toString();<a name="line.1069"></a>
+<span class="sourceLineNo">1070</span> }<a name="line.1070"></a>
+<span class="sourceLineNo">1071</span><a name="line.1071"></a>
+<span class="sourceLineNo">1072</span> /**<a name="line.1072"></a>
+<span class="sourceLineNo">1073</span> * Flush the entries in ramCache to IOEngine and add bucket entry to backingMap. Process all that<a name="line.1073"></a>
+<span class="sourceLineNo">1074</span> * are passed in even if failure being sure to remove from ramCache else we'll never undo the<a name="line.1074"></a>
+<span class="sourceLineNo">1075</span> * references and we'll OOME.<a name="line.1075"></a>
+<span class="sourceLineNo">1076</span> * @param entries Presumes list passed in here will be processed by this invocation only. No<a name="line.1076"></a>
+<span class="sourceLineNo">1077</span> * interference expected.<a name="line.1077"></a>
+<span class="sourceLineNo">1078</span> */<a name="line.1078"></a>
+<span class="sourceLineNo">1079</span> void doDrain(final List<RAMQueueEntry> entries, ByteBuffer metaBuff) throws InterruptedException {<a name="line.1079"></a>
+<span class="sourceLineNo">1080</span> if (entries.isEmpty()) {<a name="line.1080"></a>
+<span class="sourceLineNo">1081</span> return;<a name="line.1081"></a>
+<span class="sourceLineNo">1082</span> }<a name="line.1082"></a>
+<span class="sourceLineNo">1083</span> // This method is a little hard to follow. We run through the passed in entries and for each<a name="line.1083"></a>
+<span class="sourceLineNo">1084</span> // successful add, we add a non-null BucketEntry to the below bucketEntries. Later we must<a name="line.1084"></a>
+<span class="sourceLineNo">1085</span> // do cleanup making sure we've cleared ramCache of all entries regardless of whether we<a name="line.1085"></a>
+<span class="sourceLineNo">1086</span> // successfully added the item to the bucketcache; if we don't do the cleanup, we'll OOME by<a name="line.1086"></a>
+<span class="sourceLineNo">1087</span> // filling ramCache. We do the clean up by again running through the passed in entries<a name="line.1087"></a>
+<span class="sourceLineNo">1088</span> // doing extra work when we find a non-null bucketEntries corresponding entry.<a name="line.1088"></a>
+<span class="sourceLineNo">1089</span> final int size = entries.size();<a name="line.1089"></a>
+<span class="sourceLineNo">1090</span> BucketEntry[] bucketEntries = new BucketEntry[size];<a name="line.1090"></a>
+<span class="sourceLineNo">1091</span> // Index updated inside loop if success or if we can't succeed. We retry if cache is full<a name="line.1091"></a>
+<span class="sourceLineNo">1092</span> // when we go to add an entry by going around the loop again without upping the index.<a name="line.1092"></a>
+<span class="sourceLineNo">1093</span> int index = 0;<a name="line.1093"></a>
+<span class="sourceLineNo">1094</span> while (cacheEnabled && index < size) {<a name="line.1094"></a>
+<span class="sourceLineNo">1095</span> RAMQueueEntry re = null;<a name="line.1095"></a>
+<span class="sourceLineNo">1096</span> try {<a name="line.1096"></a>
+<span class="sourceLineNo">1097</span> re = entries.get(index);<a name="line.1097"></a>
+<span class="sourceLineNo">1098</span> if (re == null) {<a name="line.1098"></a>
+<span class="sourceLineNo">1099</span> LOG.warn("Couldn't get entry or changed on us; who else is messing with it?");<a name="line.1099"></a>
+<span class="sourceLineNo">1100</span> index++;<a name="line.1100"></a>
+<span class="sourceLineNo">1101</span> continue;<a name="line.1101"></a>
+<span class="sourceLineNo">1102</span> }<a name="line.1102"></a>
+<span class="sourceLineNo">1103</span> BlockCacheKey cacheKey = re.getKey();<a name="line.1103"></a>
+<span class="sourceLineNo">1104</span> if (ramCache.containsKey(cacheKey)) {<a name="line.1104"></a>
+<span class="sourceLineNo">1105</span> blocksByHFile.add(cacheKey);<a name="line.1105"></a>
+<span class="sourceLineNo">1106</span> }<a name="line.1106"></a>
+<span class="sourceLineNo">1107</span> // Reset the position for reuse.<a name="line.1107"></a>
+<span class="sourceLineNo">1108</span> // It should be guaranteed that the data in the metaBuff has been transferred to the<a name="line.1108"></a>
+<span class="sourceLineNo">1109</span> // ioEngine safely. Otherwise, this reuse is problematic. Fortunately, the data is already<a name="line.1109"></a>
+<span class="sourceLineNo">1110</span> // transferred with our current IOEngines. Should take care, when we have new kinds of<a name="line.1110"></a>
+<span class="sourceLineNo">1111</span> // IOEngine in the future.<a name="line.1111"></a>
+<span class="sourceLineNo">1112</span> metaBuff.clear();<a name="line.1112"></a>
+<span class="sourceLineNo">1113</span> BucketEntry bucketEntry =<a name="line.1113"></a>
+<span class="sourceLineNo">1114</span> re.writeToCache(ioEngine, bucketAllocator, realCacheSize, this::createRecycler, metaBuff);<a name="line.1114"></a>
+<span class="sourceLineNo">1115</span> // Successfully added. Up index and add bucketEntry. Clear io exceptions.<a name="line.1115"></a>
+<span class="sourceLineNo">1116</span> bucketEntries[index] = bucketEntry;<a name="line.1116"></a>
+<span class="sourceLineNo">1117</span> if (ioErrorStartTime > 0) {<a name="line.1117"></a>
+<span class="sourceLineNo">1118</span> ioErrorStartTime = -1;<a name="line.1118"></a>
+<span class="sourceLineNo">1119</span> }<a name="line.1119"></a>
+<span class="sourceLineNo">1120</span> index++;<a name="line.1120"></a>
+<span class="sourceLineNo">1121</span> } catch (BucketAllocatorException fle) {<a name="line.1121"></a>
+<span class="sourceLineNo">1122</span> long currTs = EnvironmentEdgeManager.currentTime();<a name="line.1122"></a>
+<span class="sourceLineNo">1123</span> cacheStats.allocationFailed(); // Record the warning.<a name="line.1123"></a>
+<span class="sourceLineNo">1124</span> if (<a name="line.1124"></a>
+<span class="sourceLineNo">1125</span> allocFailLogPrevTs == 0 || (currTs - allocFailLogPrevTs) > ALLOCATION_FAIL_LOG_TIME_PERIOD<a name="line.1125"></a>
+<span class="sourceLineNo">1126</span> ) {<a name="line.1126"></a>
+<span class="sourceLineNo">1127</span> LOG.warn(getAllocationFailWarningMessage(fle, re));<a name="line.1127"></a>
+<span class="sourceLineNo">1128</span> allocFailLogPrevTs = currTs;<a name="line.1128"></a>
+<span class="sourceLineNo">1129</span> }<a name="line.1129"></a>
+<span class="sourceLineNo">1130</span> // Presume can't add. Too big? Move index on. Entry will be cleared from ramCache below.<a name="line.1130"></a>
+<span class="sourceLineNo">1131</span> bucketEntries[index] = null;<a name="line.1131"></a>
+<span class="sourceLineNo">1132</span> index++;<a name="line.1132"></a>
+<span class="sourceLineNo">1133</span> } catch (CacheFullException cfe) {<a name="line.1133"></a>
+<span class="sourceLineNo">1134</span> // Cache full when we tried to add. Try freeing space and then retrying (don't up index)<a name="line.1134"></a>
+<span class="sourceLineNo">1135</span> if (!freeInProgress) {<a name="line.1135"></a>
+<span class="sourceLineNo">1136</span> freeSpace("Full!");<a name="line.1136"></a>
+<span class="sourceLineNo">1137</span> } else {<a name="line.1137"></a>
+<span class="sourceLineNo">1138</span> Thread.sleep(50);<a name="line.1138"></a>
+<span class="sourceLineNo">1139</span> }<a name="line.1139"></a>
+<span class="sourceLineNo">1140</span> } catch (IOException ioex) {<a name="line.1140"></a>
+<span class="sourceLineNo">1141</span> // Hopefully transient. Retry. checkIOErrorIsTolerated disables cache if problem.<a name="line.1141"></a>
+<span class="sourceLineNo">1142</span> LOG.error("Failed writing to bucket cache", ioex);<a name="line.1142"></a>
+<span class="sourceLineNo">1143</span> checkIOErrorIsTolerated();<a name="line.1143"></a>
+<span class="sourceLineNo">1144</span> }<a name="line.1144"></a>
+<span class="sourceLineNo">1145</span> }<a name="line.1145"></a>
+<span class="sourceLineNo">1146</span><a name="line.1146"></a>
+<span class="sourceLineNo">1147</span> // Make sure data pages are written on media before we update maps.<a name="line.1147"></a>
+<span class="sourceLineNo">1148</span> try {<a name="line.1148"></a>
+<span class="sourceLineNo">1149</span> ioEngine.sync();<a name="line.1149"></a>
+<span class="sourceLineNo">1150</span> } catch (IOException ioex) {<a name="line.1150"></a>
+<span class="sourceLineNo">1151</span> LOG.error("Failed syncing IO engine", ioex);<a name="line.1151"></a>
+<span class="sourceLineNo">1152</span> checkIOErrorIsTolerated();<a name="line.1152"></a>
+<span class="sourceLineNo">1153</span> // Since we failed sync, free the blocks in bucket allocator<a name="line.1153"></a>
+<span class="sourceLineNo">1154</span> for (int i = 0; i < entries.size(); ++i) {<a name="line.1154"></a>
+<span class="sourceLineNo">1155</span> BucketEntry bucketEntry = bucketEntries[i];<a name="line.1155"></a>
+<span class="sourceLineNo">1156</span> if (bucketEntry != null) {<a name="line.1156"></a>
+<span class="sourceLineNo">1157</span> bucketAllocator.freeBlock(bucketEntry.offset(), bucketEntry.getLength());<a name="line.1157"></a>
+<span class="sourceLineNo">1158</span> bucketEntries[i] = null;<a name="line.1158"></a>
+<span class="sourceLineNo">1159</span> }<a name="line.1159"></a>
+<span class="sourceLineNo">1160</span> }<a name="line.1160"></a>
+<span class="sourceLineNo">1161</span> }<a name="line.1161"></a>
+<span class="sourceLineNo">1162</span><a name="line.1162"></a>
+<span class="sourceLineNo">1163</span> // Now add to backingMap if successfully added to bucket cache. Remove from ramCache if<a name="line.1163"></a>
+<span class="sourceLineNo">1164</span> // success or error.<a name="line.1164"></a>
+<span class="sourceLineNo">1165</span> for (int i = 0; i < size; ++i) {<a name="line.1165"></a>
+<span class="sourceLineNo">1166</span> BlockCacheKey key = entries.get(i).getKey();<a name="line.1166"></a>
+<span class="sourceLineNo">1167</span> // Only add if non-null entry.<a name="line.1167"></a>
+<span class="sourceLineNo">1168</span> if (bucketEntries[i] != null) {<a name="line.1168"></a>
+<span class="sourceLineNo">1169</span> putIntoBackingMap(key, bucketEntries[i]);<a name="line.1169"></a>
+<span class="sourceLineNo">1170</span> }<a name="line.1170"></a>
+<span class="sourceLineNo">1171</span> // Always remove from ramCache even if we failed adding it to the block cache above.<a name="line.1171"></a>
+<span class="sourceLineNo">1172</span> boolean existed = ramCache.remove(key, re -> {<a name="line.1172"></a>
+<span class="sourceLineNo">1173</span> if (re != null) {<a name="line.1173"></a>
+<span class="sourceLineNo">1174</span> heapSize.add(-1 * re.getData().heapSize());<a name="line.1174"></a>
+<span class="sourceLineNo">1175</span> }<a name="line.1175"></a>
+<span class="sourceLineNo">1176</span> });<a name="line.1176"></a>
+<span class="sourceLineNo">1177</span> if (!existed && bucketEntries[i] != null) {<a name="line.1177"></a>
+<span class="sourceLineNo">1178</span> // Block should have already been evicted. Remove it and free space.<a name="line.1178"></a>
+<span class="sourceLineNo">1179</span> final BucketEntry bucketEntry = bucketEntries[i];<a name="line.1179"></a>
+<span class="sourceLineNo">1180</span> bucketEntry.withWriteLock(offsetLock, () -> {<a name="line.1180"></a>
+<span class="sourceLineNo">1181</span> if (backingMap.remove(key, bucketEntry)) {<a name="line.1181"></a>
+<span class="sourceLineNo">1182</span> blockEvicted(key, bucketEntry, false, false);<a name="line.1182"></a>
+<span class="sourceLineNo">1183</span> }<a name="line.1183"></a>
+<span class="sourceLineNo">1184</span> return null;<a name="line.1184"></a>
+<span class="sourceLineNo">1185</span> });<a name="line.1185"></a>
+<span class="sourceLineNo">1186</span> }<a name="line.1186"></a>
+<span class="sourceLineNo">1187</span> }<a name="line.1187"></a>
+<span class="sourceLineNo">1188</span><a name="line.1188"></a>
+<span class="sourceLineNo">1189</span> long used = bucketAllocator.getUsedSize();<a name="line.1189"></a>
+<span class="sourceLineNo">1190</span> if (used > acceptableSize()) {<a name="line.1190"></a>
+<span class="sourceLineNo">1191</span> freeSpace("Used=" + used + " > acceptable=" + acceptableSize());<a name="line.1191"></a>
+<span class="sourceLineNo">1192</span> }<a name="line.1192"></a>
+<span class="sourceLineNo">1193</span> return;<a name="line.1193"></a>
+<span class="sourceLineNo">1194</span> }<a name="line.1194"></a>
+<span class="sourceLineNo">1195</span><a name="line.1195"></a>
+<span class="sourceLineNo">1196</span> /**<a name="line.1196"></a>
+<span class="sourceLineNo">1197</span> * Blocks until elements available in {@code q} then tries to grab as many as possible before<a name="line.1197"></a>
+<span class="sourceLineNo">1198</span> * returning.<a name="line.1198"></a>
+<span class="sourceLineNo">1199</span> * @param receptacle Where to stash the elements taken from queue. We clear before we use it just<a name="line.1199"></a>
+<span class="sourceLineNo">1200</span> * in case.<a name="line.1200"></a>
+<span class="sourceLineNo">1201</span> * @param q The queue to take from.<a name="line.1201"></a>
+<span class="sourceLineNo">1202</span> * @return {@code receptacle} laden with elements taken from the queue or empty if none found.<a name="line.1202"></a>
+<span class="sourceLineNo">1203</span> */<a name="line.1203"></a>
+<span class="sourceLineNo">1204</span> static List<RAMQueueEntry> getRAMQueueEntries(BlockingQueue<RAMQueueEntry> q,<a name="line.1204"></a>
+<span class="sourceLineNo">1205</span> List<RAMQueueEntry> receptacle) throws InterruptedException {<a name="line.1205"></a>
+<span class="sourceLineNo">1206</span> // Clear sets all entries to null and sets size to 0. We retain allocations. Presume it<a name="line.1206"></a>
+<span class="sourceLineNo">1207</span> // ok even if list grew to accommodate thousands.<a name="line.1207"></a>
+<span class="sourceLineNo">1208</span> receptacle.clear();<a name="line.1208"></a>
+<span class="sourceLineNo">1209</span> receptacle.add(q.take());<a name="line.1209"></a>
+<span class="sourceLineNo">1210</span> q.drainTo(receptacle);<a name="line.1210"></a>
+<span class="sourceLineNo">1211</span> return receptacle;<a name="line.1211"></a>
+<span class="sourceLineNo">1212</span> }<a name="line.1212"></a>
+<span class="sourceLineNo">1213</span><a name="line.1213"></a>
+<span class="sourceLineNo">1214</span> /**<a name="line.1214"></a>
+<span class="sourceLineNo">1215</span> * @see #retrieveFromFile(int[])<a name="line.1215"></a>
+<span class="sourceLineNo">1216</span> */<a name="line.1216"></a>
+<span class="sourceLineNo">1217</span> @edu.umd.cs.findbugs.annotations.SuppressWarnings(value = "OBL_UNSATISFIED_OBLIGATION",<a name="line.1217"></a>
+<span class="sourceLineNo">1218</span> justification = "false positive, try-with-resources ensures close is called.")<a name="line.1218"></a>
+<span class="sourceLineNo">1219</span> private void persistToFile() throws IOException {<a name="line.1219"></a>
+<span class="sourceLineNo">1220</span> assert !cacheEnabled;<a name="line.1220"></a>
+<span class="sourceLineNo">1221</span> if (!ioEngine.isPersistent()) {<a name="line.1221"></a>
+<span class="sourceLineNo">1222</span> throw new IOException("Attempt to persist non-persistent cache mappings!");<a name="line.1222"></a>
+<span class="sourceLineNo">1223</span> }<a name="line.1223"></a>
+<span class="sourceLineNo">1224</span> try (FileOutputStream fos = new FileOutputStream(persistencePath, false)) {<a name="line.1224"></a>
+<span class="sourceLineNo">1225</span> fos.write(ProtobufMagic.PB_MAGIC);<a name="line.1225"></a>
+<span class="sourceLineNo">1226</span> BucketProtoUtils.toPB(this).writeDelimitedTo(fos);<a name="line.1226"></a>
+<span class="sourceLineNo">1227</span> }<a name="line.1227"></a>
+<span class="sourceLineNo">1228</span> if (prefetchedFileListPath != null) {<a name="line.1228"></a>
+<span class="sourceLineNo">1229</span> PrefetchExecutor.persistToFile(prefetchedFileListPath);<a name="line.1229"></a>
+<span class="sourceLineNo">1230</span> }<a name="line.1230"></a>
+<span class="sourceLineNo">1231</span> }<a name="line.1231"></a>
+<span class="sourceLineNo">1232</span><a name="line.1232"></a>
+<span class="sourceLineNo">1233</span> /**<a name="line.1233"></a>
+<span class="sourceLineNo">1234</span> * @see #persistToFile()<a name="line.1234"></a>
+<span class="sourceLineNo">1235</span> */<a name="line.1235"></a>
+<span class="sourceLineNo">1236</span> private void retrieveFromFile(int[] bucketSizes) throws IOException {<a name="line.1236"></a>
+<span class="sourceLineNo">1237</span> File persistenceFile = new File(persistencePath);<a name="line.1237"></a>
+<span class="sourceLineNo">1238</span> if (!persistenceFile.exists()) {<a name="line.1238"></a>
+<span class="sourceLineNo">1239</span> return;<a name="line.1239"></a>
+<span class="sourceLineNo">1240</span> }<a name="line.1240"></a>
+<span class="sourceLineNo">1241</span> assert !cacheEnabled;<a name="line.1241"></a>
+<span class="sourceLineNo">1242</span> if (prefetchedFileListPath != null) {<a name="line.1242"></a>
+<span class="sourceLineNo">1243</span> PrefetchExecutor.retrieveFromFile(prefetchedFileListPath);<a name="line.1243"></a>
+<span class="sourceLineNo">1244</span> }<a name="line.1244"></a>
+<span class="sourceLineNo">1245</span><a name="line.1245"></a>
+<span class="sourceLineNo">1246</span> try (FileInputStream in = deleteFileOnClose(persistenceFile)) {<a name="line.1246"></a>
+<span class="sourceLineNo">1247</span> int pblen = ProtobufMagic.lengthOfPBMagic();<a name="line.1247"></a>
+<span class="sourceLineNo">1248</span> byte[] pbuf = new byte[pblen];<a name="line.1248"></a>
+<span class="sourceLineNo">1249</span> int read = in.read(pbuf);<a name="line.1249"></a>
+<span class="sourceLineNo">1250</span> if (read != pblen) {<a name="line.1250"></a>
+<span class="sourceLineNo">1251</span> throw new IOException("Incorrect number of bytes read while checking for protobuf magic "<a name="line.1251"></a>
+<span class="sourceLineNo">1252</span> + "number. Requested=" + pblen + ", Received= " + read + ", File=" + persistencePath);<a name="line.1252"></a>
<span class="sourceLineNo">1253</span> }<a name="line.1253"></a>
-<span class="sourceLineNo">1254</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1254"></a>
-<span class="sourceLineNo">1255</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1255"></a>
-<span class="sourceLineNo">1256</span> blockNumber.add(backingMap.size());<a name="line.1256"></a>
-<span class="sourceLineNo">1257</span> }<a name="line.1257"></a>
-<span class="sourceLineNo">1258</span> }<a name="line.1258"></a>
-<span class="sourceLineNo">1259</span><a name="line.1259"></a>
-<span class="sourceLineNo">1260</span> /**<a name="line.1260"></a>
-<span class="sourceLineNo">1261</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1261"></a>
-<span class="sourceLineNo">1262</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1262"></a>
-<span class="sourceLineNo">1263</span> *<a name="line.1263"></a>
-<span class="sourceLineNo">1264</span> * <pre><a name="line.1264"></a>
-<span class="sourceLineNo">1265</span> * File f = ...<a name="line.1265"></a>
-<span class="sourceLineNo">1266</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1266"></a>
-<span class="sourceLineNo">1267</span> * // use the input stream<a name="line.1267"></a>
-<span class="sourceLineNo">1268</span> * } finally {<a name="line.1268"></a>
-<span class="sourceLineNo">1269</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1269"></a>
-<span class="sourceLineNo">1270</span> * }<a name="line.1270"></a>
-<span class="sourceLineNo">1271</span> * </pre><a name="line.1271"></a>
-<span class="sourceLineNo">1272</span> *<a name="line.1272"></a>
-<span class="sourceLineNo">1273</span> * @param file the file to read and delete<a name="line.1273"></a>
-<span class="sourceLineNo">1274</span> * @return a FileInputStream for the given file<a name="line.1274"></a>
-<span class="sourceLineNo">1275</span> * @throws IOException if there is a problem creating the stream<a name="line.1275"></a>
-<span class="sourceLineNo">1276</span> */<a name="line.1276"></a>
-<span class="sourceLineNo">1277</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1277"></a>
-<span class="sourceLineNo">1278</span> return new FileInputStream(file) {<a name="line.1278"></a>
-<span class="sourceLineNo">1279</span> private File myFile;<a name="line.1279"></a>
-<span class="sourceLineNo">1280</span><a name="line.1280"></a>
-<span class="sourceLineNo">1281</span> private FileInputStream init(File file) {<a name="line.1281"></a>
-<span class="sourceLineNo">1282</span> myFile = file;<a name="line.1282"></a>
-<span class="sourceLineNo">1283</span> return this;<a name="line.1283"></a>
-<span class="sourceLineNo">1284</span> }<a name="line.1284"></a>
-<span class="sourceLineNo">1285</span><a name="line.1285"></a>
-<span class="sourceLineNo">1286</span> @Override<a name="line.1286"></a>
-<span class="sourceLineNo">1287</span> public void close() throws IOException {<a name="line.1287"></a>
-<span class="sourceLineNo">1288</span> // close() will be called during try-with-resources and it will be<a name="line.1288"></a>
-<span class="sourceLineNo">1289</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1289"></a>
-<span class="sourceLineNo">1290</span> // set myFile to null after the first call.<a name="line.1290"></a>
-<span class="sourceLineNo">1291</span> if (myFile == null) {<a name="line.1291"></a>
-<span class="sourceLineNo">1292</span> return;<a name="line.1292"></a>
-<span class="sourceLineNo">1293</span> }<a name="line.1293"></a>
-<span class="sourceLineNo">1294</span><a name="line.1294"></a>
-<span class="sourceLineNo">1295</span> super.close();<a name="line.1295"></a>
-<span class="sourceLineNo">1296</span> if (!myFile.delete()) {<a name="line.1296"></a>
-<span class="sourceLineNo">1297</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1297"></a>
-<span class="sourceLineNo">1298</span> }<a name="line.1298"></a>
-<span class="sourceLineNo">1299</span> myFile = null;<a name="line.1299"></a>
-<span class="sourceLineNo">1300</span> }<a name="line.1300"></a>
-<span class="sourceLineNo">1301</span> }.init(file);<a name="line.1301"></a>
-<span class="sourceLineNo">1302</span> }<a name="line.1302"></a>
-<span class="sourceLineNo">1303</span><a name="line.1303"></a>
-<span class="sourceLineNo">1304</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1304"></a>
-<span class="sourceLineNo">1305</span> throws IOException {<a name="line.1305"></a>
-<span class="sourceLineNo">1306</span> if (capacitySize != cacheCapacity) {<a name="line.1306"></a>
-<span class="sourceLineNo">1307</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1307"></a>
-<span class="sourceLineNo">1308</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1308"></a>
-<span class="sourceLineNo">1309</span> }<a name="line.1309"></a>
-<span class="sourceLineNo">1310</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1310"></a>
-<span class="sourceLineNo">1311</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1311"></a>
-<span class="sourceLineNo">1312</span> + ioEngine.getClass().getName());<a name="line.1312"></a>
-<span class="sourceLineNo">1313</span> }<a name="line.1313"></a>
-<span class="sourceLineNo">1314</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1314"></a>
-<span class="sourceLineNo">1315</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1315"></a>
-<span class="sourceLineNo">1316</span> + backingMap.getClass().getName());<a name="line.1316"></a>
-<span class="sourceLineNo">1317</span> }<a name="line.1317"></a>
-<span class="sourceLineNo">1318</span> }<a name="line.1318"></a>
-<span class="sourceLineNo">1319</span><a name="line.1319"></a>
-<span class="sourceLineNo">1320</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1320"></a>
-<span class="sourceLineNo">1321</span> if (proto.hasChecksum()) {<a name="line.1321"></a>
-<span class="sourceLineNo">1322</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1322"></a>
-<span class="sourceLineNo">1323</span> algorithm);<a name="line.1323"></a>
-<span class="sourceLineNo">1324</span> } else {<a name="line.1324"></a>
-<span class="sourceLineNo">1325</span> // if has not checksum, it means the persistence file is old format<a name="line.1325"></a>
-<span class="sourceLineNo">1326</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1326"></a>
-<span class="sourceLineNo">1327</span> }<a name="line.1327"></a>
-<span class="sourceLineNo">1328</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1328"></a>
-<span class="sourceLineNo">1329</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1329"></a>
-<span class="sourceLineNo">1330</span> this::createRecycler);<a name="line.1330"></a>
-<span class="sourceLineNo">1331</span> }<a name="line.1331"></a>
-<span class="sourceLineNo">1332</span><a name="line.1332"></a>
-<span class="sourceLineNo">1333</span> /**<a name="line.1333"></a>
-<span class="sourceLineNo">1334</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1334"></a>
-<span class="sourceLineNo">1335</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1335"></a>
-<span class="sourceLineNo">1336</span> */<a name="line.1336"></a>
-<span class="sourceLineNo">1337</span> private void checkIOErrorIsTolerated() {<a name="line.1337"></a>
-<span class="sourceLineNo">1338</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1338"></a>
-<span class="sourceLineNo">1339</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1339"></a>
-<span class="sourceLineNo">1340</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1340"></a>
-<span class="sourceLineNo">1341</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1341"></a>
-<span class="sourceLineNo">1342</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1342"></a>
-<span class="sourceLineNo">1343</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1343"></a>
-<span class="sourceLineNo">1344</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1344"></a>
-<span class="sourceLineNo">1345</span> disableCache();<a name="line.1345"></a>
-<span class="sourceLineNo">1346</span> }<a name="line.1346"></a>
-<span class="sourceLineNo">1347</span> } else {<a name="line.1347"></a>
-<span class="sourceLineNo">1348</span> this.ioErrorStartTime = now;<a name="line.1348"></a>
-<span class="sourceLineNo">1349</span> }<a name="line.1349"></a>
-<span class="sourceLineNo">1350</span> }<a name="line.1350"></a>
-<span class="sourceLineNo">1351</span><a name="line.1351"></a>
-<span class="sourceLineNo">1352</span> /**<a name="line.1352"></a>
-<span class="sourceLineNo">1353</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1353"></a>
-<span class="sourceLineNo">1354</span> */<a name="line.1354"></a>
-<span class="sourceLineNo">1355</span> private void disableCache() {<a name="line.1355"></a>
-<span class="sourceLineNo">1356</span> if (!cacheEnabled) return;<a name="line.1356"></a>
-<span class="sourceLineNo">1357</span> cacheEnabled = false;<a name="line.1357"></a>
-<span class="sourceLineNo">1358</span> ioEngine.shutdown();<a name="line.1358"></a>
-<span class="sourceLineNo">1359</span> this.scheduleThreadPool.shutdown();<a name="line.1359"></a>
-<span class="sourceLineNo">1360</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1360"></a>
-<span class="sourceLineNo">1361</span> writerThreads[i].interrupt();<a name="line.1361"></a>
-<span class="sourceLineNo">1362</span> this.ramCache.clear();<a name="line.1362"></a>
-<span class="sourceLineNo">1363</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1363"></a>
-<span class="sourceLineNo">1364</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1364"></a>
-<span class="sourceLineNo">1365</span> this.backingMap.clear();<a name="line.1365"></a>
-<span class="sourceLineNo">1366</span> }<a name="line.1366"></a>
-<span class="sourceLineNo">1367</span> }<a name="line.1367"></a>
-<span class="sourceLineNo">1368</span><a name="line.1368"></a>
-<span class="sourceLineNo">1369</span> private void join() throws InterruptedException {<a name="line.1369"></a>
-<span class="sourceLineNo">1370</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1370"></a>
-<span class="sourceLineNo">1371</span> writerThreads[i].join();<a name="line.1371"></a>
-<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
-<span class="sourceLineNo">1373</span><a name="line.1373"></a>
-<span class="sourceLineNo">1374</span> @Override<a name="line.1374"></a>
-<span class="sourceLineNo">1375</span> public void shutdown() {<a name="line.1375"></a>
-<span class="sourceLineNo">1376</span> disableCache();<a name="line.1376"></a>
-<span class="sourceLineNo">1377</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1377"></a>
-<span class="sourceLineNo">1378</span> + persistencePath);<a name="line.1378"></a>
-<span class="sourceLineNo">1379</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1379"></a>
-<span class="sourceLineNo">1380</span> try {<a name="line.1380"></a>
-<span class="sourceLineNo">1381</span> join();<a name="line.1381"></a>
-<span class="sourceLineNo">1382</span> persistToFile();<a name="line.1382"></a>
-<span class="sourceLineNo">1383</span> } catch (IOException ex) {<a name="line.1383"></a>
-<span class="sourceLineNo">1384</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1384"></a>
-<span class="sourceLineNo">1385</span> } catch (InterruptedException e) {<a name="line.1385"></a>
-<span class="sourceLineNo">1386</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1386"></a>
-<span class="sourceLineNo">1387</span> }<a name="line.1387"></a>
-<span class="sourceLineNo">1388</span> }<a name="line.1388"></a>
-<span class="sourceLineNo">1389</span> }<a name="line.1389"></a>
-<span class="sourceLineNo">1390</span><a name="line.1390"></a>
-<span class="sourceLineNo">1391</span> @Override<a name="line.1391"></a>
-<span class="sourceLineNo">1392</span> public CacheStats getStats() {<a name="line.1392"></a>
-<span class="sourceLineNo">1393</span> return cacheStats;<a name="line.1393"></a>
-<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
-<span class="sourceLineNo">1395</span><a name="line.1395"></a>
-<span class="sourceLineNo">1396</span> public BucketAllocator getAllocator() {<a name="line.1396"></a>
-<span class="sourceLineNo">1397</span> return this.bucketAllocator;<a name="line.1397"></a>
-<span class="sourceLineNo">1398</span> }<a name="line.1398"></a>
-<span class="sourceLineNo">1399</span><a name="line.1399"></a>
-<span class="sourceLineNo">1400</span> @Override<a name="line.1400"></a>
-<span class="sourceLineNo">1401</span> public long heapSize() {<a name="line.1401"></a>
-<span class="sourceLineNo">1402</span> return this.heapSize.sum();<a name="line.1402"></a>
-<span class="sourceLineNo">1403</span> }<a name="line.1403"></a>
-<span class="sourceLineNo">1404</span><a name="line.1404"></a>
-<span class="sourceLineNo">1405</span> @Override<a name="line.1405"></a>
-<span class="sourceLineNo">1406</span> public long size() {<a name="line.1406"></a>
-<span class="sourceLineNo">1407</span> return this.realCacheSize.sum();<a name="line.1407"></a>
-<span class="sourceLineNo">1408</span> }<a name="line.1408"></a>
-<span class="sourceLineNo">1409</span><a name="line.1409"></a>
-<span class="sourceLineNo">1410</span> @Override<a name="line.1410"></a>
-<span class="sourceLineNo">1411</span> public long getCurrentDataSize() {<a name="line.1411"></a>
-<span class="sourceLineNo">1412</span> return size();<a name="line.1412"></a>
-<span class="sourceLineNo">1413</span> }<a name="line.1413"></a>
-<span class="sourceLineNo">1414</span><a name="line.1414"></a>
-<span class="sourceLineNo">1415</span> @Override<a name="line.1415"></a>
-<span class="sourceLineNo">1416</span> public long getFreeSize() {<a name="line.1416"></a>
-<span class="sourceLineNo">1417</span> return this.bucketAllocator.getFreeSize();<a name="line.1417"></a>
-<span class="sourceLineNo">1418</span> }<a name="line.1418"></a>
-<span class="sourceLineNo">1419</span><a name="line.1419"></a>
-<span class="sourceLineNo">1420</span> @Override<a name="line.1420"></a>
-<span class="sourceLineNo">1421</span> public long getBlockCount() {<a name="line.1421"></a>
-<span class="sourceLineNo">1422</span> return this.blockNumber.sum();<a name="line.1422"></a>
-<span class="sourceLineNo">1423</span> }<a name="line.1423"></a>
-<span class="sourceLineNo">1424</span><a name="line.1424"></a>
-<span class="sourceLineNo">1425</span> @Override<a name="line.1425"></a>
-<span class="sourceLineNo">1426</span> public long getDataBlockCount() {<a name="line.1426"></a>
-<span class="sourceLineNo">1427</span> return getBlockCount();<a name="line.1427"></a>
-<span class="sourceLineNo">1428</span> }<a name="line.1428"></a>
-<span class="sourceLineNo">1429</span><a name="line.1429"></a>
-<span class="sourceLineNo">1430</span> @Override<a name="line.1430"></a>
-<span class="sourceLineNo">1431</span> public long getCurrentSize() {<a name="line.1431"></a>
-<span class="sourceLineNo">1432</span> return this.bucketAllocator.getUsedSize();<a name="line.1432"></a>
-<span class="sourceLineNo">1433</span> }<a name="line.1433"></a>
-<span class="sourceLineNo">1434</span><a name="line.1434"></a>
-<span class="sourceLineNo">1435</span> protected String getAlgorithm() {<a name="line.1435"></a>
-<span class="sourceLineNo">1436</span> return algorithm;<a name="line.1436"></a>
-<span class="sourceLineNo">1437</span> }<a name="line.1437"></a>
-<span class="sourceLineNo">1438</span><a name="line.1438"></a>
-<span class="sourceLineNo">1439</span> /**<a name="line.1439"></a>
-<span class="sourceLineNo">1440</span> * Evicts all blocks for a specific HFile.<a name="line.1440"></a>
-<span class="sourceLineNo">1441</span> * <p><a name="line.1441"></a>
-<span class="sourceLineNo">1442</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1442"></a>
-<span class="sourceLineNo">1443</span> * @return the number of blocks evicted<a name="line.1443"></a>
-<span class="sourceLineNo">1444</span> */<a name="line.1444"></a>
-<span class="sourceLineNo">1445</span> @Override<a name="line.1445"></a>
-<span class="sourceLineNo">1446</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1446"></a>
-<span class="sourceLineNo">1447</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1447"></a>
-<span class="sourceLineNo">1448</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1448"></a>
-<span class="sourceLineNo">1449</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1449"></a>
-<span class="sourceLineNo">1450</span><a name="line.1450"></a>
-<span class="sourceLineNo">1451</span> int numEvicted = 0;<a name="line.1451"></a>
-<span class="sourceLineNo">1452</span> for (BlockCacheKey key : keySet) {<a name="line.1452"></a>
-<span class="sourceLineNo">1453</span> if (evictBlock(key)) {<a name="line.1453"></a>
-<span class="sourceLineNo">1454</span> ++numEvicted;<a name="line.1454"></a>
-<span class="sourceLineNo">1455</span> }<a name="line.1455"></a>
-<span class="sourceLineNo">1456</span> }<a name="line.1456"></a>
-<span class="sourceLineNo">1457</span><a name="line.1457"></a>
-<span class="sourceLineNo">1458</span> return numEvicted;<a name="line.1458"></a>
-<span class="sourceLineNo">1459</span> }<a name="line.1459"></a>
-<span class="sourceLineNo">1460</span><a name="line.1460"></a>
-<span class="sourceLineNo">1461</span> /**<a name="line.1461"></a>
-<span class="sourceLineNo">1462</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1462"></a>
-<span class="sourceLineNo">1463</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1463"></a>
-<span class="sourceLineNo">1464</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1464"></a>
-<span class="sourceLineNo">1465</span> */<a name="line.1465"></a>
-<span class="sourceLineNo">1466</span> private class BucketEntryGroup {<a name="line.1466"></a>
-<span class="sourceLineNo">1467</span><a name="line.1467"></a>
-<span class="sourceLineNo">1468</span> private CachedEntryQueue queue;<a name="line.1468"></a>
-<span class="sourceLineNo">1469</span> private long totalSize = 0;<a name="line.1469"></a>
-<span class="sourceLineNo">1470</span> private long bucketSize;<a name="line.1470"></a>
-<span class="sourceLineNo">1471</span><a name="line.1471"></a>
-<span class="sourceLineNo">1472</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1472"></a>
-<span class="sourceLineNo">1473</span> this.bucketSize = bucketSize;<a name="line.1473"></a>
-<span class="sourceLineNo">1474</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1474"></a>
-<span class="sourceLineNo">1475</span> totalSize = 0;<a name="line.1475"></a>
-<span class="sourceLineNo">1476</span> }<a name="line.1476"></a>
+<span class="sourceLineNo">1254</span> if (!ProtobufMagic.isPBMagicPrefix(pbuf)) {<a name="line.1254"></a>
+<span class="sourceLineNo">1255</span> // In 3.0 we have enough flexibility to dump the old cache data.<a name="line.1255"></a>
+<span class="sourceLineNo">1256</span> // TODO: In 2.x line, this might need to be filled in to support reading the old format<a name="line.1256"></a>
+<span class="sourceLineNo">1257</span> throw new IOException(<a name="line.1257"></a>
+<span class="sourceLineNo">1258</span> "Persistence file does not start with protobuf magic number. " + persistencePath);<a name="line.1258"></a>
+<span class="sourceLineNo">1259</span> }<a name="line.1259"></a>
+<span class="sourceLineNo">1260</span> parsePB(BucketCacheProtos.BucketCacheEntry.parseDelimitedFrom(in));<a name="line.1260"></a>
+<span class="sourceLineNo">1261</span> bucketAllocator = new BucketAllocator(cacheCapacity, bucketSizes, backingMap, realCacheSize);<a name="line.1261"></a>
+<span class="sourceLineNo">1262</span> blockNumber.add(backingMap.size());<a name="line.1262"></a>
+<span class="sourceLineNo">1263</span> }<a name="line.1263"></a>
+<span class="sourceLineNo">1264</span> }<a name="line.1264"></a>
+<span class="sourceLineNo">1265</span><a name="line.1265"></a>
+<span class="sourceLineNo">1266</span> /**<a name="line.1266"></a>
+<span class="sourceLineNo">1267</span> * Create an input stream that deletes the file after reading it. Use in try-with-resources to<a name="line.1267"></a>
+<span class="sourceLineNo">1268</span> * avoid this pattern where an exception thrown from a finally block may mask earlier exceptions:<a name="line.1268"></a>
+<span class="sourceLineNo">1269</span> *<a name="line.1269"></a>
+<span class="sourceLineNo">1270</span> * <pre><a name="line.1270"></a>
+<span class="sourceLineNo">1271</span> * File f = ...<a name="line.1271"></a>
+<span class="sourceLineNo">1272</span> * try (FileInputStream fis = new FileInputStream(f)) {<a name="line.1272"></a>
+<span class="sourceLineNo">1273</span> * // use the input stream<a name="line.1273"></a>
+<span class="sourceLineNo">1274</span> * } finally {<a name="line.1274"></a>
+<span class="sourceLineNo">1275</span> * if (!f.delete()) throw new IOException("failed to delete");<a name="line.1275"></a>
+<span class="sourceLineNo">1276</span> * }<a name="line.1276"></a>
+<span class="sourceLineNo">1277</span> * </pre><a name="line.1277"></a>
+<span class="sourceLineNo">1278</span> *<a name="line.1278"></a>
+<span class="sourceLineNo">1279</span> * @param file the file to read and delete<a name="line.1279"></a>
+<span class="sourceLineNo">1280</span> * @return a FileInputStream for the given file<a name="line.1280"></a>
+<span class="sourceLineNo">1281</span> * @throws IOException if there is a problem creating the stream<a name="line.1281"></a>
+<span class="sourceLineNo">1282</span> */<a name="line.1282"></a>
+<span class="sourceLineNo">1283</span> private FileInputStream deleteFileOnClose(final File file) throws IOException {<a name="line.1283"></a>
+<span class="sourceLineNo">1284</span> return new FileInputStream(file) {<a name="line.1284"></a>
+<span class="sourceLineNo">1285</span> private File myFile;<a name="line.1285"></a>
+<span class="sourceLineNo">1286</span><a name="line.1286"></a>
+<span class="sourceLineNo">1287</span> private FileInputStream init(File file) {<a name="line.1287"></a>
+<span class="sourceLineNo">1288</span> myFile = file;<a name="line.1288"></a>
+<span class="sourceLineNo">1289</span> return this;<a name="line.1289"></a>
+<span class="sourceLineNo">1290</span> }<a name="line.1290"></a>
+<span class="sourceLineNo">1291</span><a name="line.1291"></a>
+<span class="sourceLineNo">1292</span> @Override<a name="line.1292"></a>
+<span class="sourceLineNo">1293</span> public void close() throws IOException {<a name="line.1293"></a>
+<span class="sourceLineNo">1294</span> // close() will be called during try-with-resources and it will be<a name="line.1294"></a>
+<span class="sourceLineNo">1295</span> // called by finalizer thread during GC. To avoid double-free resource,<a name="line.1295"></a>
+<span class="sourceLineNo">1296</span> // set myFile to null after the first call.<a name="line.1296"></a>
+<span class="sourceLineNo">1297</span> if (myFile == null) {<a name="line.1297"></a>
+<span class="sourceLineNo">1298</span> return;<a name="line.1298"></a>
+<span class="sourceLineNo">1299</span> }<a name="line.1299"></a>
+<span class="sourceLineNo">1300</span><a name="line.1300"></a>
+<span class="sourceLineNo">1301</span> super.close();<a name="line.1301"></a>
+<span class="sourceLineNo">1302</span> if (!myFile.delete()) {<a name="line.1302"></a>
+<span class="sourceLineNo">1303</span> throw new IOException("Failed deleting persistence file " + myFile.getAbsolutePath());<a name="line.1303"></a>
+<span class="sourceLineNo">1304</span> }<a name="line.1304"></a>
+<span class="sourceLineNo">1305</span> myFile = null;<a name="line.1305"></a>
+<span class="sourceLineNo">1306</span> }<a name="line.1306"></a>
+<span class="sourceLineNo">1307</span> }.init(file);<a name="line.1307"></a>
+<span class="sourceLineNo">1308</span> }<a name="line.1308"></a>
+<span class="sourceLineNo">1309</span><a name="line.1309"></a>
+<span class="sourceLineNo">1310</span> private void verifyCapacityAndClasses(long capacitySize, String ioclass, String mapclass)<a name="line.1310"></a>
+<span class="sourceLineNo">1311</span> throws IOException {<a name="line.1311"></a>
+<span class="sourceLineNo">1312</span> if (capacitySize != cacheCapacity) {<a name="line.1312"></a>
+<span class="sourceLineNo">1313</span> throw new IOException("Mismatched cache capacity:" + StringUtils.byteDesc(capacitySize)<a name="line.1313"></a>
+<span class="sourceLineNo">1314</span> + ", expected: " + StringUtils.byteDesc(cacheCapacity));<a name="line.1314"></a>
+<span class="sourceLineNo">1315</span> }<a name="line.1315"></a>
+<span class="sourceLineNo">1316</span> if (!ioEngine.getClass().getName().equals(ioclass)) {<a name="line.1316"></a>
+<span class="sourceLineNo">1317</span> throw new IOException("Class name for IO engine mismatch: " + ioclass + ", expected:"<a name="line.1317"></a>
+<span class="sourceLineNo">1318</span> + ioEngine.getClass().getName());<a name="line.1318"></a>
+<span class="sourceLineNo">1319</span> }<a name="line.1319"></a>
+<span class="sourceLineNo">1320</span> if (!backingMap.getClass().getName().equals(mapclass)) {<a name="line.1320"></a>
+<span class="sourceLineNo">1321</span> throw new IOException("Class name for cache map mismatch: " + mapclass + ", expected:"<a name="line.1321"></a>
+<span class="sourceLineNo">1322</span> + backingMap.getClass().getName());<a name="line.1322"></a>
+<span class="sourceLineNo">1323</span> }<a name="line.1323"></a>
+<span class="sourceLineNo">1324</span> }<a name="line.1324"></a>
+<span class="sourceLineNo">1325</span><a name="line.1325"></a>
+<span class="sourceLineNo">1326</span> private void parsePB(BucketCacheProtos.BucketCacheEntry proto) throws IOException {<a name="line.1326"></a>
+<span class="sourceLineNo">1327</span> if (proto.hasChecksum()) {<a name="line.1327"></a>
+<span class="sourceLineNo">1328</span> ((PersistentIOEngine) ioEngine).verifyFileIntegrity(proto.getChecksum().toByteArray(),<a name="line.1328"></a>
+<span class="sourceLineNo">1329</span> algorithm);<a name="line.1329"></a>
+<span class="sourceLineNo">1330</span> } else {<a name="line.1330"></a>
+<span class="sourceLineNo">1331</span> // if has not checksum, it means the persistence file is old format<a name="line.1331"></a>
+<span class="sourceLineNo">1332</span> LOG.info("Persistent file is old format, it does not support verifying file integrity!");<a name="line.1332"></a>
+<span class="sourceLineNo">1333</span> }<a name="line.1333"></a>
+<span class="sourceLineNo">1334</span> verifyCapacityAndClasses(proto.getCacheCapacity(), proto.getIoClass(), proto.getMapClass());<a name="line.1334"></a>
+<span class="sourceLineNo">1335</span> backingMap = BucketProtoUtils.fromPB(proto.getDeserializersMap(), proto.getBackingMap(),<a name="line.1335"></a>
+<span class="sourceLineNo">1336</span> this::createRecycler);<a name="line.1336"></a>
+<span class="sourceLineNo">1337</span> }<a name="line.1337"></a>
+<span class="sourceLineNo">1338</span><a name="line.1338"></a>
+<span class="sourceLineNo">1339</span> /**<a name="line.1339"></a>
+<span class="sourceLineNo">1340</span> * Check whether we tolerate IO error this time. If the duration of IOEngine throwing errors<a name="line.1340"></a>
+<span class="sourceLineNo">1341</span> * exceeds ioErrorsDurationTimeTolerated, we will disable the cache<a name="line.1341"></a>
+<span class="sourceLineNo">1342</span> */<a name="line.1342"></a>
+<span class="sourceLineNo">1343</span> private void checkIOErrorIsTolerated() {<a name="line.1343"></a>
+<span class="sourceLineNo">1344</span> long now = EnvironmentEdgeManager.currentTime();<a name="line.1344"></a>
+<span class="sourceLineNo">1345</span> // Do a single read to a local variable to avoid timing issue - HBASE-24454<a name="line.1345"></a>
+<span class="sourceLineNo">1346</span> long ioErrorStartTimeTmp = this.ioErrorStartTime;<a name="line.1346"></a>
+<span class="sourceLineNo">1347</span> if (ioErrorStartTimeTmp > 0) {<a name="line.1347"></a>
+<span class="sourceLineNo">1348</span> if (cacheEnabled && (now - ioErrorStartTimeTmp) > this.ioErrorsTolerationDuration) {<a name="line.1348"></a>
+<span class="sourceLineNo">1349</span> LOG.error("IO errors duration time has exceeded " + ioErrorsTolerationDuration<a name="line.1349"></a>
+<span class="sourceLineNo">1350</span> + "ms, disabling cache, please check your IOEngine");<a name="line.1350"></a>
+<span class="sourceLineNo">1351</span> disableCache();<a name="line.1351"></a>
+<span class="sourceLineNo">1352</span> }<a name="line.1352"></a>
+<span class="sourceLineNo">1353</span> } else {<a name="line.1353"></a>
+<span class="sourceLineNo">1354</span> this.ioErrorStartTime = now;<a name="line.1354"></a>
+<span class="sourceLineNo">1355</span> }<a name="line.1355"></a>
+<span class="sourceLineNo">1356</span> }<a name="line.1356"></a>
+<span class="sourceLineNo">1357</span><a name="line.1357"></a>
+<span class="sourceLineNo">1358</span> /**<a name="line.1358"></a>
+<span class="sourceLineNo">1359</span> * Used to shut down the cache -or- turn it off in the case of something broken.<a name="line.1359"></a>
+<span class="sourceLineNo">1360</span> */<a name="line.1360"></a>
+<span class="sourceLineNo">1361</span> private void disableCache() {<a name="line.1361"></a>
+<span class="sourceLineNo">1362</span> if (!cacheEnabled) return;<a name="line.1362"></a>
+<span class="sourceLineNo">1363</span> cacheEnabled = false;<a name="line.1363"></a>
+<span class="sourceLineNo">1364</span> ioEngine.shutdown();<a name="line.1364"></a>
+<span class="sourceLineNo">1365</span> this.scheduleThreadPool.shutdown();<a name="line.1365"></a>
+<span class="sourceLineNo">1366</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1366"></a>
+<span class="sourceLineNo">1367</span> writerThreads[i].interrupt();<a name="line.1367"></a>
+<span class="sourceLineNo">1368</span> this.ramCache.clear();<a name="line.1368"></a>
+<span class="sourceLineNo">1369</span> if (!ioEngine.isPersistent() || persistencePath == null) {<a name="line.1369"></a>
+<span class="sourceLineNo">1370</span> // If persistent ioengine and a path, we will serialize out the backingMap.<a name="line.1370"></a>
+<span class="sourceLineNo">1371</span> this.backingMap.clear();<a name="line.1371"></a>
+<span class="sourceLineNo">1372</span> }<a name="line.1372"></a>
+<span class="sourceLineNo">1373</span> }<a name="line.1373"></a>
+<span class="sourceLineNo">1374</span><a name="line.1374"></a>
+<span class="sourceLineNo">1375</span> private void join() throws InterruptedException {<a name="line.1375"></a>
+<span class="sourceLineNo">1376</span> for (int i = 0; i < writerThreads.length; ++i)<a name="line.1376"></a>
+<span class="sourceLineNo">1377</span> writerThreads[i].join();<a name="line.1377"></a>
+<span class="sourceLineNo">1378</span> }<a name="line.1378"></a>
+<span class="sourceLineNo">1379</span><a name="line.1379"></a>
+<span class="sourceLineNo">1380</span> @Override<a name="line.1380"></a>
+<span class="sourceLineNo">1381</span> public void shutdown() {<a name="line.1381"></a>
+<span class="sourceLineNo">1382</span> disableCache();<a name="line.1382"></a>
+<span class="sourceLineNo">1383</span> LOG.info("Shutdown bucket cache: IO persistent=" + ioEngine.isPersistent() + "; path to write="<a name="line.1383"></a>
+<span class="sourceLineNo">1384</span> + persistencePath);<a name="line.1384"></a>
+<span class="sourceLineNo">1385</span> if (ioEngine.isPersistent() && persistencePath != null) {<a name="line.1385"></a>
+<span class="sourceLineNo">1386</span> try {<a name="line.1386"></a>
+<span class="sourceLineNo">1387</span> join();<a name="line.1387"></a>
+<span class="sourceLineNo">1388</span> persistToFile();<a name="line.1388"></a>
+<span class="sourceLineNo">1389</span> } catch (IOException ex) {<a name="line.1389"></a>
+<span class="sourceLineNo">1390</span> LOG.error("Unable to persist data on exit: " + ex.toString(), ex);<a name="line.1390"></a>
+<span class="sourceLineNo">1391</span> } catch (InterruptedException e) {<a name="line.1391"></a>
+<span class="sourceLineNo">1392</span> LOG.warn("Failed to persist data on exit", e);<a name="line.1392"></a>
+<span class="sourceLineNo">1393</span> }<a name="line.1393"></a>
+<span class="sourceLineNo">1394</span> }<a name="line.1394"></a>
+<span class="sourceLineNo">1395</span> }<a name="line.1395"></a>
+<span class="sourceLineNo">1396</span><a name="line.1396"></a>
+<span class="sourceLineNo">1397</span> @Override<a name="line.1397"></a>
+<span class="sourceLineNo">1398</span> public CacheStats getStats() {<a name="line.1398"></a>
+<span class="sourceLineNo">1399</span> return cacheStats;<a name="line.1399"></a>
+<span class="sourceLineNo">1400</span> }<a name="line.1400"></a>
+<span class="sourceLineNo">1401</span><a name="line.1401"></a>
+<span class="sourceLineNo">1402</span> public BucketAllocator getAllocator() {<a name="line.1402"></a>
+<span class="sourceLineNo">1403</span> return this.bucketAllocator;<a name="line.1403"></a>
+<span class="sourceLineNo">1404</span> }<a name="line.1404"></a>
+<span class="sourceLineNo">1405</span><a name="line.1405"></a>
+<span class="sourceLineNo">1406</span> @Override<a name="line.1406"></a>
+<span class="sourceLineNo">1407</span> public long heapSize() {<a name="line.1407"></a>
+<span class="sourceLineNo">1408</span> return this.heapSize.sum();<a name="line.1408"></a>
+<span class="sourceLineNo">1409</span> }<a name="line.1409"></a>
+<span class="sourceLineNo">1410</span><a name="line.1410"></a>
+<span class="sourceLineNo">1411</span> @Override<a name="line.1411"></a>
+<span class="sourceLineNo">1412</span> public long size() {<a name="line.1412"></a>
+<span class="sourceLineNo">1413</span> return this.realCacheSize.sum();<a name="line.1413"></a>
+<span class="sourceLineNo">1414</span> }<a name="line.1414"></a>
+<span class="sourceLineNo">1415</span><a name="line.1415"></a>
+<span class="sourceLineNo">1416</span> @Override<a name="line.1416"></a>
+<span class="sourceLineNo">1417</span> public long getCurrentDataSize() {<a name="line.1417"></a>
+<span class="sourceLineNo">1418</span> return size();<a name="line.1418"></a>
+<span class="sourceLineNo">1419</span> }<a name="line.1419"></a>
+<span class="sourceLineNo">1420</span><a name="line.1420"></a>
+<span class="sourceLineNo">1421</span> @Override<a name="line.1421"></a>
+<span class="sourceLineNo">1422</span> public long getFreeSize() {<a name="line.1422"></a>
+<span class="sourceLineNo">1423</span> return this.bucketAllocator.getFreeSize();<a name="line.1423"></a>
+<span class="sourceLineNo">1424</span> }<a name="line.1424"></a>
+<span class="sourceLineNo">1425</span><a name="line.1425"></a>
+<span class="sourceLineNo">1426</span> @Override<a name="line.1426"></a>
+<span class="sourceLineNo">1427</span> public long getBlockCount() {<a name="line.1427"></a>
+<span class="sourceLineNo">1428</span> return this.blockNumber.sum();<a name="line.1428"></a>
+<span class="sourceLineNo">1429</span> }<a name="line.1429"></a>
+<span class="sourceLineNo">1430</span><a name="line.1430"></a>
+<span class="sourceLineNo">1431</span> @Override<a name="line.1431"></a>
+<span class="sourceLineNo">1432</span> public long getDataBlockCount() {<a name="line.1432"></a>
+<span class="sourceLineNo">1433</span> return getBlockCount();<a name="line.1433"></a>
+<span class="sourceLineNo">1434</span> }<a name="line.1434"></a>
+<span class="sourceLineNo">1435</span><a name="line.1435"></a>
+<span class="sourceLineNo">1436</span> @Override<a name="line.1436"></a>
+<span class="sourceLineNo">1437</span> public long getCurrentSize() {<a name="line.1437"></a>
+<span class="sourceLineNo">1438</span> return this.bucketAllocator.getUsedSize();<a name="line.1438"></a>
+<span class="sourceLineNo">1439</span> }<a name="line.1439"></a>
+<span class="sourceLineNo">1440</span><a name="line.1440"></a>
+<span class="sourceLineNo">1441</span> protected String getAlgorithm() {<a name="line.1441"></a>
+<span class="sourceLineNo">1442</span> return algorithm;<a name="line.1442"></a>
+<span class="sourceLineNo">1443</span> }<a name="line.1443"></a>
+<span class="sourceLineNo">1444</span><a name="line.1444"></a>
+<span class="sourceLineNo">1445</span> /**<a name="line.1445"></a>
+<span class="sourceLineNo">1446</span> * Evicts all blocks for a specific HFile.<a name="line.1446"></a>
+<span class="sourceLineNo">1447</span> * <p><a name="line.1447"></a>
+<span class="sourceLineNo">1448</span> * This is used for evict-on-close to remove all blocks of a specific HFile.<a name="line.1448"></a>
+<span class="sourceLineNo">1449</span> * @return the number of blocks evicted<a name="line.1449"></a>
+<span class="sourceLineNo">1450</span> */<a name="line.1450"></a>
+<span class="sourceLineNo">1451</span> @Override<a name="line.1451"></a>
+<span class="sourceLineNo">1452</span> public int evictBlocksByHfileName(String hfileName) {<a name="line.1452"></a>
+<span class="sourceLineNo">1453</span> PrefetchExecutor.removePrefetchedFileWhileEvict(hfileName);<a name="line.1453"></a>
+<span class="sourceLineNo">1454</span> Set<BlockCacheKey> keySet = blocksByHFile.subSet(new BlockCacheKey(hfileName, Long.MIN_VALUE),<a name="line.1454"></a>
+<span class="sourceLineNo">1455</span> true, new BlockCacheKey(hfileName, Long.MAX_VALUE), true);<a name="line.1455"></a>
+<span class="sourceLineNo">1456</span><a name="line.1456"></a>
+<span class="sourceLineNo">1457</span> int numEvicted = 0;<a name="line.1457"></a>
+<span class="sourceLineNo">1458</span> for (BlockCacheKey key : keySet) {<a name="line.1458"></a>
+<span class="sourceLineNo">1459</span> if (evictBlock(key)) {<a name="line.1459"></a>
+<span class="sourceLineNo">1460</span> ++numEvicted;<a name="line.1460"></a>
+<span class="sourceLineNo">1461</span> }<a name="line.1461"></a>
+<span class="sourceLineNo">1462</span> }<a name="line.1462"></a>
+<span class="sourceLineNo">1463</span><a name="line.1463"></a>
+<span class="sourceLineNo">1464</span> return numEvicted;<a name="line.1464"></a>
+<span class="sourceLineNo">1465</span> }<a name="line.1465"></a>
+<span class="sourceLineNo">1466</span><a name="line.1466"></a>
+<span class="sourceLineNo">1467</span> /**<a name="line.1467"></a>
+<span class="sourceLineNo">1468</span> * Used to group bucket entries into priority buckets. There will be a BucketEntryGroup for each<a name="line.1468"></a>
+<span class="sourceLineNo">1469</span> * priority (single, multi, memory). Once bucketed, the eviction algorithm takes the appropriate<a name="line.1469"></a>
+<span class="sourceLineNo">1470</span> * number of elements out of each according to configuration parameters and their relative sizes.<a name="line.1470"></a>
+<span class="sourceLineNo">1471</span> */<a name="line.1471"></a>
+<span class="sourceLineNo">1472</span> private class BucketEntryGroup {<a name="line.1472"></a>
+<span class="sourceLineNo">1473</span><a name="line.1473"></a>
+<span class="sourceLineNo">1474</span> private CachedEntryQueue queue;<a name="line.1474"></a>
+<span class="sourceLineNo">1475</span> private long totalSize = 0;<a name="line.1475"></a>
+<span class="sourceLineNo">1476</span> private long bucketSize;<a name="line.1476"></a>
<span class="sourceLineNo">1477</span><a name="line.1477"></a>
-<span class="sourceLineNo">1478</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1478"></a>
-<span class="sourceLineNo">1479</span> totalSize += block.getValue().getLength();<a name="line.1479"></a>
-<span class="sourceLineNo">1480</span> queue.add(block);<a name="line.1480"></a>
-<span class="sourceLineNo">1481</span> }<a name="line.1481"></a>
-<span class="sourceLineNo">1482</span><a name="line.1482"></a>
-<span class="sourceLineNo">1483</span> public long free(long toFree) {<a name="line.1483"></a>
-<span class="sourceLineNo">1484</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1484"></a>
-<span class="sourceLineNo">1485</span> long freedBytes = 0;<a name="line.1485"></a>
-<span class="sourceLineNo">1486</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1486"></a>
-<span class="sourceLineNo">1487</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1487"></a>
-<span class="sourceLineNo">1488</span> while ((entry = queue.pollLast()) != null) {<a name="line.1488"></a>
-<span class="sourceLineNo">1489</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1489"></a>
-<span class="sourceLineNo">1490</span> BucketEntry be = entry.getValue();<a name="line.1490"></a>
-<span class="sourceLineNo">1491</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1491"></a>
-<span class="sourceLineNo">1492</span> freedBytes += be.getLength();<a name="line.1492"></a>
-<span class="sourceLineNo">1493</span> }<a name="line.1493"></a>
-<span class="sourceLineNo">1494</span> if (freedBytes >= toFree) {<a name="line.1494"></a>
-<span class="sourceLineNo">1495</span> return freedBytes;<a name="line.1495"></a>
-<span class="sourceLineNo">1496</span> }<a name="line.1496"></a>
-<span class="sourceLineNo">1497</span> }<a name="line.1497"></a>
-<span class="sourceLineNo">1498</span> return freedBytes;<a name="line.1498"></a>
-<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
-<span class="sourceLineNo">1500</span><a name="line.1500"></a>
-<span class="sourceLineNo">1501</span> public long overflow() {<a name="line.1501"></a>
-<span class="sourceLineNo">1502</span> return totalSize - bucketSize;<a name="line.1502"></a>
-<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
-<span class="sourceLineNo">1504</span><a name="line.1504"></a>
-<span class="sourceLineNo">1505</span> public long totalSize() {<a name="line.1505"></a>
-<span class="sourceLineNo">1506</span> return totalSize;<a name="line.1506"></a>
-<span class="sourceLineNo">1507</span> }<a name="line.1507"></a>
-<span class="sourceLineNo">1508</span> }<a name="line.1508"></a>
-<span class="sourceLineNo">1509</span><a name="line.1509"></a>
-<span class="sourceLineNo">1510</span> /**<a name="line.1510"></a>
-<span class="sourceLineNo">1511</span> * Block Entry stored in the memory with key,data and so on<a name="line.1511"></a>
-<span class="sourceLineNo">1512</span> */<a name="line.1512"></a>
-<span class="sourceLineNo">1513</span> static class RAMQueueEntry {<a name="line.1513"></a>
-<span class="sourceLineNo">1514</span> private final BlockCacheKey key;<a name="line.1514"></a>
-<span class="sourceLineNo">1515</span> private final Cacheable data;<a name="line.1515"></a>
-<span class="sourceLineNo">1516</span> private long accessCounter;<a name="line.1516"></a>
-<span class="sourceLineNo">1517</span> private boolean inMemory;<a name="line.1517"></a>
-<span class="sourceLineNo">1518</span><a name="line.1518"></a>
-<span class="sourceLineNo">1519</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1519"></a>
-<span class="sourceLineNo">1520</span> this.key = bck;<a name="line.1520"></a>
-<span class="sourceLineNo">1521</span> this.data = data;<a name="line.1521"></a>
-<span class="sourceLineNo">1522</span> this.accessCounter = accessCounter;<a name="line.1522"></a>
-<span class="sourceLineNo">1523</span> this.inMemory = inMemory;<a name="line.1523"></a>
-<span class="sourceLineNo">1524</span> }<a name="line.1524"></a>
-<span class="sourceLineNo">1525</span><a name="line.1525"></a>
-<span class="sourceLineNo">1526</span> public Cacheable getData() {<a name="line.1526"></a>
-<span class="sourceLineNo">1527</span> return data;<a name="line.1527"></a>
-<span class="sourceLineNo">1528</span> }<a name="line.1528"></a>
-<span class="sourceLineNo">1529</span><a name="line.1529"></a>
-<span class="sourceLineNo">1530</span> public BlockCacheKey getKey() {<a name="line.1530"></a>
-<span class="sourceLineNo">1531</span> return key;<a name="line.1531"></a>
-<span class="sourceLineNo">1532</span> }<a name="line.1532"></a>
-<span class="sourceLineNo">1533</span><a name="line.1533"></a>
-<span class="sourceLineNo">1534</span> public void access(long accessCounter) {<a name="line.1534"></a>
-<span class="sourceLineNo">1535</span> this.accessCounter = accessCounter;<a name="line.1535"></a>
-<span class="sourceLineNo">1536</span> }<a name="line.1536"></a>
-<span class="sourceLineNo">1537</span><a name="line.1537"></a>
-<span class="sourceLineNo">1538</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1538"></a>
-<span class="sourceLineNo">1539</span> if (data instanceof HFileBlock) {<a name="line.1539"></a>
-<span class="sourceLineNo">1540</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1540"></a>
-<span class="sourceLineNo">1541</span> }<a name="line.1541"></a>
-<span class="sourceLineNo">1542</span> return ByteBuffAllocator.HEAP;<a name="line.1542"></a>
-<span class="sourceLineNo">1543</span> }<a name="line.1543"></a>
-<span class="sourceLineNo">1544</span><a name="line.1544"></a>
-<span class="sourceLineNo">1545</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1545"></a>
-<span class="sourceLineNo">1546</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1546"></a>
-<span class="sourceLineNo">1547</span> ByteBuffer metaBuff) throws IOException {<a name="line.1547"></a>
-<span class="sourceLineNo">1548</span> int len = data.getSerializedLength();<a name="line.1548"></a>
-<span class="sourceLineNo">1549</span> // This cacheable thing can't be serialized<a name="line.1549"></a>
-<span class="sourceLineNo">1550</span> if (len == 0) {<a name="line.1550"></a>
-<span class="sourceLineNo">1551</span> return null;<a name="line.1551"></a>
-<span class="sourceLineNo">1552</span> }<a name="line.1552"></a>
-<span class="sourceLineNo">1553</span> long offset = alloc.allocateBlock(len);<a name="line.1553"></a>
-<span class="sourceLineNo">1554</span> boolean succ = false;<a name="line.1554"></a>
-<span class="sourceLineNo">1555</span> BucketEntry bucketEntry = null;<a name="line.1555"></a>
-<span class="sourceLineNo">1556</span> try {<a name="line.1556"></a>
-<span class="sourceLineNo">1557</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1557"></a>
-<span class="sourceLineNo">1558</span> getByteBuffAllocator());<a name="line.1558"></a>
-<span class="sourceLineNo">1559</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1559"></a>
-<span class="sourceLineNo">1560</span> if (data instanceof HFileBlock) {<a name="line.1560"></a>
-<span class="sourceLineNo">1561</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1561"></a>
-<span class="sourceLineNo">1562</span> HFileBlock block = (HFileBlock) data;<a name="line.1562"></a>
-<span class="sourceLineNo">1563</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1563"></a>
-<span class="sourceLineNo">1564</span> block.getMetaData(metaBuff);<a name="line.1564"></a>
-<span class="sourceLineNo">1565</span> ioEngine.write(sliceBuf, offset);<a name="line.1565"></a>
-<span class="sourceLineNo">1566</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1566"></a>
-<span class="sourceLineNo">1567</span> } else {<a name="line.1567"></a>
-<span class="sourceLineNo">1568</span> // Only used for testing.<a name="line.1568"></a>
-<span class="sourceLineNo">1569</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1569"></a>
-<span class="sourceLineNo">1570</span> data.serialize(bb, true);<a name="line.1570"></a>
-<span class="sourceLineNo">1571</span> ioEngine.write(bb, offset);<a name="line.1571"></a>
-<span class="sourceLineNo">1572</span> }<a name="line.1572"></a>
-<span class="sourceLineNo">1573</span> succ = true;<a name="line.1573"></a>
-<span class="sourceLineNo">1574</span> } finally {<a name="line.1574"></a>
-<span class="sourceLineNo">1575</span> if (!succ) {<a name="line.1575"></a>
-<span class="sourceLineNo">1576</span> alloc.freeBlock(offset, len);<a name="line.1576"></a>
-<span class="sourceLineNo">1577</span> }<a name="line.1577"></a>
-<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
-<span class="sourceLineNo">1579</span> realCacheSize.add(len);<a name="line.1579"></a>
-<span class="sourceLineNo">1580</span> return bucketEntry;<a name="line.1580"></a>
-<span class="sourceLineNo">1581</span> }<a name="line.1581"></a>
-<span class="sourceLineNo">1582</span> }<a name="line.1582"></a>
-<span class="sourceLineNo">1583</span><a name="line.1583"></a>
-<span class="sourceLineNo">1584</span> /**<a name="line.1584"></a>
-<span class="sourceLineNo">1585</span> * Only used in test<a name="line.1585"></a>
-<span class="sourceLineNo">1586</span> */<a name="line.1586"></a>
-<span class="sourceLineNo">1587</span> void stopWriterThreads() throws InterruptedException {<a name="line.1587"></a>
-<span class="sourceLineNo">1588</span> for (WriterThread writerThread : writerThreads) {<a name="line.1588"></a>
-<span class="sourceLineNo">1589</span> writerThread.disableWriter();<a name="line.1589"></a>
-<span class="sourceLineNo">1590</span> writerThread.interrupt();<a name="line.1590"></a>
-<span class="sourceLineNo">1591</span> writerThread.join();<a name="line.1591"></a>
-<span class="sourceLineNo">1592</span> }<a name="line.1592"></a>
-<span class="sourceLineNo">1593</span> }<a name="line.1593"></a>
-<span class="sourceLineNo">1594</span><a name="line.1594"></a>
-<span class="sourceLineNo">1595</span> @Override<a name="line.1595"></a>
-<span class="sourceLineNo">1596</span> public Iterator<CachedBlock> iterator() {<a name="line.1596"></a>
-<span class="sourceLineNo">1597</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1597"></a>
-<span class="sourceLineNo">1598</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1598"></a>
-<span class="sourceLineNo">1599</span> return new Iterator<CachedBlock>() {<a name="line.1599"></a>
-<span class="sourceLineNo">1600</span> private final long now = System.nanoTime();<a name="line.1600"></a>
-<span class="sourceLineNo">1601</span><a name="line.1601"></a>
-<span class="sourceLineNo">1602</span> @Override<a name="line.1602"></a>
-<span class="sourceLineNo">1603</span> public boolean hasNext() {<a name="line.1603"></a>
-<span class="sourceLineNo">1604</span> return i.hasNext();<a name="line.1604"></a>
-<span class="sourceLineNo">1605</span> }<a name="line.1605"></a>
-<span class="sourceLineNo">1606</span><a name="line.1606"></a>
-<span class="sourceLineNo">1607</span> @Override<a name="line.1607"></a>
-<span class="sourceLineNo">1608</span> public CachedBlock next() {<a name="line.1608"></a>
-<span class="sourceLineNo">1609</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1609"></a>
-<span class="sourceLineNo">1610</span> return new CachedBlock() {<a name="line.1610"></a>
-<span class="sourceLineNo">1611</span> @Override<a name="line.1611"></a>
-<span class="sourceLineNo">1612</span> public String toString() {<a name="line.1612"></a>
-<span class="sourceLineNo">1613</span> return BlockCacheUtil.toString(this, now);<a name="line.1613"></a>
-<span class="sourceLineNo">1614</span> }<a name="line.1614"></a>
-<span class="sourceLineNo">1615</span><a name="line.1615"></a>
-<span class="sourceLineNo">1616</span> @Override<a name="line.1616"></a>
-<span class="sourceLineNo">1617</span> public BlockPriority getBlockPriority() {<a name="line.1617"></a>
-<span class="sourceLineNo">1618</span> return e.getValue().getPriority();<a name="line.1618"></a>
-<span class="sourceLineNo">1619</span> }<a name="line.1619"></a>
-<span class="sourceLineNo">1620</span><a name="line.1620"></a>
-<span class="sourceLineNo">1621</span> @Override<a name="line.1621"></a>
-<span class="sourceLineNo">1622</span> public BlockType getBlockType() {<a name="line.1622"></a>
-<span class="sourceLineNo">1623</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1623"></a>
-<span class="sourceLineNo">1624</span> return null;<a name="line.1624"></a>
+<span class="sourceLineNo">1478</span> public BucketEntryGroup(long bytesToFree, long blockSize, long bucketSize) {<a name="line.1478"></a>
+<span class="sourceLineNo">1479</span> this.bucketSize = bucketSize;<a name="line.1479"></a>
+<span class="sourceLineNo">1480</span> queue = new CachedEntryQueue(bytesToFree, blockSize);<a name="line.1480"></a>
+<span class="sourceLineNo">1481</span> totalSize = 0;<a name="line.1481"></a>
+<span class="sourceLineNo">1482</span> }<a name="line.1482"></a>
+<span class="sourceLineNo">1483</span><a name="line.1483"></a>
+<span class="sourceLineNo">1484</span> public void add(Map.Entry<BlockCacheKey, BucketEntry> block) {<a name="line.1484"></a>
+<span class="sourceLineNo">1485</span> totalSize += block.getValue().getLength();<a name="line.1485"></a>
+<span class="sourceLineNo">1486</span> queue.add(block);<a name="line.1486"></a>
+<span class="sourceLineNo">1487</span> }<a name="line.1487"></a>
+<span class="sourceLineNo">1488</span><a name="line.1488"></a>
+<span class="sourceLineNo">1489</span> public long free(long toFree) {<a name="line.1489"></a>
+<span class="sourceLineNo">1490</span> Map.Entry<BlockCacheKey, BucketEntry> entry;<a name="line.1490"></a>
+<span class="sourceLineNo">1491</span> long freedBytes = 0;<a name="line.1491"></a>
+<span class="sourceLineNo">1492</span> // TODO avoid a cycling siutation. We find no block which is not in use and so no way to free<a name="line.1492"></a>
+<span class="sourceLineNo">1493</span> // What to do then? Caching attempt fail? Need some changes in cacheBlock API?<a name="line.1493"></a>
+<span class="sourceLineNo">1494</span> while ((entry = queue.pollLast()) != null) {<a name="line.1494"></a>
+<span class="sourceLineNo">1495</span> BlockCacheKey blockCacheKey = entry.getKey();<a name="line.1495"></a>
+<span class="sourceLineNo">1496</span> BucketEntry be = entry.getValue();<a name="line.1496"></a>
+<span class="sourceLineNo">1497</span> if (evictBucketEntryIfNoRpcReferenced(blockCacheKey, be)) {<a name="line.1497"></a>
+<span class="sourceLineNo">1498</span> freedBytes += be.getLength();<a name="line.1498"></a>
+<span class="sourceLineNo">1499</span> }<a name="line.1499"></a>
+<span class="sourceLineNo">1500</span> if (freedBytes >= toFree) {<a name="line.1500"></a>
+<span class="sourceLineNo">1501</span> return freedBytes;<a name="line.1501"></a>
+<span class="sourceLineNo">1502</span> }<a name="line.1502"></a>
+<span class="sourceLineNo">1503</span> }<a name="line.1503"></a>
+<span class="sourceLineNo">1504</span> return freedBytes;<a name="line.1504"></a>
+<span class="sourceLineNo">1505</span> }<a name="line.1505"></a>
+<span class="sourceLineNo">1506</span><a name="line.1506"></a>
+<span class="sourceLineNo">1507</span> public long overflow() {<a name="line.1507"></a>
+<span class="sourceLineNo">1508</span> return totalSize - bucketSize;<a name="line.1508"></a>
+<span class="sourceLineNo">1509</span> }<a name="line.1509"></a>
+<span class="sourceLineNo">1510</span><a name="line.1510"></a>
+<span class="sourceLineNo">1511</span> public long totalSize() {<a name="line.1511"></a>
+<span class="sourceLineNo">1512</span> return totalSize;<a name="line.1512"></a>
+<span class="sourceLineNo">1513</span> }<a name="line.1513"></a>
+<span class="sourceLineNo">1514</span> }<a name="line.1514"></a>
+<span class="sourceLineNo">1515</span><a name="line.1515"></a>
+<span class="sourceLineNo">1516</span> /**<a name="line.1516"></a>
+<span class="sourceLineNo">1517</span> * Block Entry stored in the memory with key,data and so on<a name="line.1517"></a>
+<span class="sourceLineNo">1518</span> */<a name="line.1518"></a>
+<span class="sourceLineNo">1519</span> static class RAMQueueEntry {<a name="line.1519"></a>
+<span class="sourceLineNo">1520</span> private final BlockCacheKey key;<a name="line.1520"></a>
+<span class="sourceLineNo">1521</span> private final Cacheable data;<a name="line.1521"></a>
+<span class="sourceLineNo">1522</span> private long accessCounter;<a name="line.1522"></a>
+<span class="sourceLineNo">1523</span> private boolean inMemory;<a name="line.1523"></a>
+<span class="sourceLineNo">1524</span><a name="line.1524"></a>
+<span class="sourceLineNo">1525</span> RAMQueueEntry(BlockCacheKey bck, Cacheable data, long accessCounter, boolean inMemory) {<a name="line.1525"></a>
+<span class="sourceLineNo">1526</span> this.key = bck;<a name="line.1526"></a>
+<span class="sourceLineNo">1527</span> this.data = data;<a name="line.1527"></a>
+<span class="sourceLineNo">1528</span> this.accessCounter = accessCounter;<a name="line.1528"></a>
+<span class="sourceLineNo">1529</span> this.inMemory = inMemory;<a name="line.1529"></a>
+<span class="sourceLineNo">1530</span> }<a name="line.1530"></a>
+<span class="sourceLineNo">1531</span><a name="line.1531"></a>
+<span class="sourceLineNo">1532</span> public Cacheable getData() {<a name="line.1532"></a>
+<span class="sourceLineNo">1533</span> return data;<a name="line.1533"></a>
+<span class="sourceLineNo">1534</span> }<a name="line.1534"></a>
+<span class="sourceLineNo">1535</span><a name="line.1535"></a>
+<span class="sourceLineNo">1536</span> public BlockCacheKey getKey() {<a name="line.1536"></a>
+<span class="sourceLineNo">1537</span> return key;<a name="line.1537"></a>
+<span class="sourceLineNo">1538</span> }<a name="line.1538"></a>
+<span class="sourceLineNo">1539</span><a name="line.1539"></a>
+<span class="sourceLineNo">1540</span> public void access(long accessCounter) {<a name="line.1540"></a>
+<span class="sourceLineNo">1541</span> this.accessCounter = accessCounter;<a name="line.1541"></a>
+<span class="sourceLineNo">1542</span> }<a name="line.1542"></a>
+<span class="sourceLineNo">1543</span><a name="line.1543"></a>
+<span class="sourceLineNo">1544</span> private ByteBuffAllocator getByteBuffAllocator() {<a name="line.1544"></a>
+<span class="sourceLineNo">1545</span> if (data instanceof HFileBlock) {<a name="line.1545"></a>
+<span class="sourceLineNo">1546</span> return ((HFileBlock) data).getByteBuffAllocator();<a name="line.1546"></a>
+<span class="sourceLineNo">1547</span> }<a name="line.1547"></a>
+<span class="sourceLineNo">1548</span> return ByteBuffAllocator.HEAP;<a name="line.1548"></a>
+<span class="sourceLineNo">1549</span> }<a name="line.1549"></a>
+<span class="sourceLineNo">1550</span><a name="line.1550"></a>
+<span class="sourceLineNo">1551</span> public BucketEntry writeToCache(final IOEngine ioEngine, final BucketAllocator alloc,<a name="line.1551"></a>
+<span class="sourceLineNo">1552</span> final LongAdder realCacheSize, Function<BucketEntry, Recycler> createRecycler,<a name="line.1552"></a>
+<span class="sourceLineNo">1553</span> ByteBuffer metaBuff) throws IOException {<a name="line.1553"></a>
+<span class="sourceLineNo">1554</span> int len = data.getSerializedLength();<a name="line.1554"></a>
+<span class="sourceLineNo">1555</span> // This cacheable thing can't be serialized<a name="line.1555"></a>
+<span class="sourceLineNo">1556</span> if (len == 0) {<a name="line.1556"></a>
+<span class="sourceLineNo">1557</span> return null;<a name="line.1557"></a>
+<span class="sourceLineNo">1558</span> }<a name="line.1558"></a>
+<span class="sourceLineNo">1559</span> long offset = alloc.allocateBlock(len);<a name="line.1559"></a>
+<span class="sourceLineNo">1560</span> boolean succ = false;<a name="line.1560"></a>
+<span class="sourceLineNo">1561</span> BucketEntry bucketEntry = null;<a name="line.1561"></a>
+<span class="sourceLineNo">1562</span> try {<a name="line.1562"></a>
+<span class="sourceLineNo">1563</span> bucketEntry = new BucketEntry(offset, len, accessCounter, inMemory, createRecycler,<a name="line.1563"></a>
+<span class="sourceLineNo">1564</span> getByteBuffAllocator());<a name="line.1564"></a>
+<span class="sourceLineNo">1565</span> bucketEntry.setDeserializerReference(data.getDeserializer());<a name="line.1565"></a>
+<span class="sourceLineNo">1566</span> if (data instanceof HFileBlock) {<a name="line.1566"></a>
+<span class="sourceLineNo">1567</span> // If an instance of HFileBlock, save on some allocations.<a name="line.1567"></a>
+<span class="sourceLineNo">1568</span> HFileBlock block = (HFileBlock) data;<a name="line.1568"></a>
+<span class="sourceLineNo">1569</span> ByteBuff sliceBuf = block.getBufferReadOnly();<a name="line.1569"></a>
+<span class="sourceLineNo">1570</span> block.getMetaData(metaBuff);<a name="line.1570"></a>
+<span class="sourceLineNo">1571</span> ioEngine.write(sliceBuf, offset);<a name="line.1571"></a>
+<span class="sourceLineNo">1572</span> ioEngine.write(metaBuff, offset + len - metaBuff.limit());<a name="line.1572"></a>
+<span class="sourceLineNo">1573</span> } else {<a name="line.1573"></a>
+<span class="sourceLineNo">1574</span> // Only used for testing.<a name="line.1574"></a>
+<span class="sourceLineNo">1575</span> ByteBuffer bb = ByteBuffer.allocate(len);<a name="line.1575"></a>
+<span class="sourceLineNo">1576</span> data.serialize(bb, true);<a name="line.1576"></a>
+<span class="sourceLineNo">1577</span> ioEngine.write(bb, offset);<a name="line.1577"></a>
+<span class="sourceLineNo">1578</span> }<a name="line.1578"></a>
+<span class="sourceLineNo">1579</span> succ = true;<a name="line.1579"></a>
+<span class="sourceLineNo">1580</span> } finally {<a name="line.1580"></a>
+<span class="sourceLineNo">1581</span> if (!succ) {<a name="line.1581"></a>
+<span class="sourceLineNo">1582</span> alloc.freeBlock(offset, len);<a name="line.1582"></a>
+<span class="sourceLineNo">1583</span> }<a name="line.1583"></a>
+<span class="sourceLineNo">1584</span> }<a name="line.1584"></a>
+<span class="sourceLineNo">1585</span> realCacheSize.add(len);<a name="line.1585"></a>
+<span class="sourceLineNo">1586</span> return bucketEntry;<a name="line.1586"></a>
+<span class="sourceLineNo">1587</span> }<a name="line.1587"></a>
+<span class="sourceLineNo">1588</span> }<a name="line.1588"></a>
+<span class="sourceLineNo">1589</span><a name="line.1589"></a>
+<span class="sourceLineNo">1590</span> /**<a name="line.1590"></a>
+<span class="sourceLineNo">1591</span> * Only used in test<a name="line.1591"></a>
+<span class="sourceLineNo">1592</span> */<a name="line.1592"></a>
+<span class="sourceLineNo">1593</span> void stopWriterThreads() throws InterruptedException {<a name="line.1593"></a>
+<span class="sourceLineNo">1594</span> for (WriterThread writerThread : writerThreads) {<a name="line.1594"></a>
+<span class="sourceLineNo">1595</span> writerThread.disableWriter();<a name="line.1595"></a>
+<span class="sourceLineNo">1596</span> writerThread.interrupt();<a name="line.1596"></a>
+<span class="sourceLineNo">1597</span> writerThread.join();<a name="line.1597"></a>
+<span class="sourceLineNo">1598</span> }<a name="line.1598"></a>
+<span class="sourceLineNo">1599</span> }<a name="line.1599"></a>
+<span class="sourceLineNo">1600</span><a name="line.1600"></a>
+<span class="sourceLineNo">1601</span> @Override<a name="line.1601"></a>
+<span class="sourceLineNo">1602</span> public Iterator<CachedBlock> iterator() {<a name="line.1602"></a>
+<span class="sourceLineNo">1603</span> // Don't bother with ramcache since stuff is in here only a little while.<a name="line.1603"></a>
+<span class="sourceLineNo">1604</span> final Iterator<Map.Entry<BlockCacheKey, BucketEntry>> i = this.backingMap.entrySet().iterator();<a name="line.1604"></a>
+<span class="sourceLineNo">1605</span> return new Iterator<CachedBlock>() {<a name="line.1605"></a>
+<span class="sourceLineNo">1606</span> private final long now = System.nanoTime();<a name="line.1606"></a>
+<span class="sourceLineNo">1607</span><a name="line.1607"></a>
+<span class="sourceLineNo">1608</span> @Override<a name="line.1608"></a>
+<span class="sourceLineNo">1609</span> public boolean hasNext() {<a name="line.1609"></a>
+<span class="sourceLineNo">1610</span> return i.hasNext();<a name="line.1610"></a>
+<span class="sourceLineNo">1611</span> }<a name="line.1611"></a>
+<span class="sourceLineNo">1612</span><a name="line.1612"></a>
+<span class="sourceLineNo">1613</span> @Override<a name="line.1613"></a>
+<span class="sourceLineNo">1614</span> public CachedBlock next() {<a name="line.1614"></a>
+<span class="sourceLineNo">1615</span> final Map.Entry<BlockCacheKey, BucketEntry> e = i.next();<a name="line.1615"></a>
+<span class="sourceLineNo">1616</span> return new CachedBlock() {<a name="line.1616"></a>
+<span class="sourceLineNo">1617</span> @Override<a name="line.1617"></a>
+<span class="sourceLineNo">1618</span> public String toString() {<a name="line.1618"></a>
+<span class="sourceLineNo">1619</span> return BlockCacheUtil.toString(this, now);<a name="line.1619"></a>
+<span class="sourceLineNo">1620</span> }<a name="line.1620"></a>
+<span class="sourceLineNo">1621</span><a name="line.1621"></a>
+<span class="sourceLineNo">1622</span> @Override<a name="line.1622"></a>
+<span class="sourceLineNo">1623</span> public BlockPriority getBlockPriority() {<a name="line.1623"></a>
+<span class="sourceLineNo">1624</span> return e.getValue().getPriority();<a name="line.1624"></a>
<span class="sourceLineNo">1625</span> }<a name="line.1625"></a>
<span class="sourceLineNo">1626</span><a name="line.1626"></a>
<span class="sourceLineNo">1627</span> @Override<a name="line.1627"></a>
-<span class="sourceLineNo">1628</span> public long getOffset() {<a name="line.1628"></a>
-<span class="sourceLineNo">1629</span> return e.getKey().getOffset();<a name="line.1629"></a>
-<span class="sourceLineNo">1630</span> }<a name="line.1630"></a>
-<span class="sourceLineNo">1631</span><a name="line.1631"></a>
-<span class="sourceLineNo">1632</span> @Override<a name="line.1632"></a>
-<span class="sourceLineNo">1633</span> public long getSize() {<a name="line.1633"></a>
-<span class="sourceLineNo">1634</span> return e.getValue().getLength();<a name="line.1634"></a>
-<span class="sourceLineNo">1635</span> }<a name="line.1635"></a>
-<span class="sourceLineNo">1636</span><a name="line.1636"></a>
-<span class="sourceLineNo">1637</span> @Override<a name="line.1637"></a>
-<span class="sourceLineNo">1638</span> public long getCachedTime() {<a name="line.1638"></a>
-<span class="sourceLineNo">1639</span> return e.getValue().getCachedTime();<a name="line.1639"></a>
-<span class="sourceLineNo">1640</span> }<a name="line.1640"></a>
-<span class="sourceLineNo">1641</span><a name="line.1641"></a>
-<span class="sourceLineNo">1642</span> @Override<a name="line.1642"></a>
-<span class="sourceLineNo">1643</span> public String getFilename() {<a name="line.1643"></a>
-<span class="sourceLineNo">1644</span> return e.getKey().getHfileName();<a name="line.1644"></a>
-<span class="sourceLineNo">1645</span> }<a name="line.1645"></a>
-<span class="sourceLineNo">1646</span><a name="line.1646"></a>
-<span class="sourceLineNo">1647</span> @Override<a name="line.1647"></a>
-<span class="sourceLineNo">1648</span> public int compareTo(CachedBlock other) {<a name="line.1648"></a>
-<span class="sourceLineNo">1649</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1649"></a>
-<span class="sourceLineNo">1650</span> if (diff != 0) return diff;<a name="line.1650"></a>
-<span class="sourceLineNo">1651</span><a name="line.1651"></a>
-<span class="sourceLineNo">1652</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1652"></a>
-<span class="sourceLineNo">1653</span> if (diff != 0) return diff;<a name="line.1653"></a>
-<span class="sourceLineNo">1654</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1654"></a>
-<span class="sourceLineNo">1655</span> throw new IllegalStateException(<a name="line.1655"></a>
-<span class="sourceLineNo">1656</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1656"></a>
-<span class="sourceLineNo">1657</span> }<a name="line.1657"></a>
-<span class="sourceLineNo">1658</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1658"></a>
-<span class="sourceLineNo">1659</span> }<a name="line.1659"></a>
-<span class="sourceLineNo">1660</span><a name="line.1660"></a>
-<span class="sourceLineNo">1661</span> @Override<a name="line.1661"></a>
-<span class="sourceLineNo">1662</span> public int hashCode() {<a name="line.1662"></a>
-<span class="sourceLineNo">1663</span> return e.getKey().hashCode();<a name="line.1663"></a>
-<span class="sourceLineNo">1664</span> }<a name="line.1664"></a>
-<span class="sourceLineNo">1665</span><a name="line.1665"></a>
-<span class="sourceLineNo">1666</span> @Override<a name="line.1666"></a>
-<span class="sourceLineNo">1667</span> public boolean equals(Object obj) {<a name="line.1667"></a>
-<span class="sourceLineNo">1668</span> if (obj instanceof CachedBlock) {<a name="line.1668"></a>
-<span class="sourceLineNo">1669</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1669"></a>
-<span class="sourceLineNo">1670</span> return compareTo(cb) == 0;<a name="line.1670"></a>
-<span class="sourceLineNo">1671</span> } else {<a name="line.1671"></a>
-<span class="sourceLineNo">1672</span> return false;<a name="line.1672"></a>
-<span class="sourceLineNo">1673</span> }<a name="line.1673"></a>
-<span class="sourceLineNo">1674</span> }<a name="line.1674"></a>
-<span class="sourceLineNo">1675</span> };<a name="line.1675"></a>
-<span class="sourceLineNo">1676</span> }<a name="line.1676"></a>
-<span class="sourceLineNo">1677</span><a name="line.1677"></a>
-<span class="sourceLineNo">1678</span> @Override<a name="line.1678"></a>
-<span class="sourceLineNo">1679</span> public void remove() {<a name="line.1679"></a>
-<span class="sourceLineNo">1680</span> throw new UnsupportedOperationException();<a name="line.1680"></a>
-<span class="sourceLineNo">1681</span> }<a name="line.1681"></a>
-<span class="sourceLineNo">1682</span> };<a name="line.1682"></a>
-<span class="sourceLineNo">1683</span> }<a name="line.1683"></a>
-<span class="sourceLineNo">1684</span><a name="line.1684"></a>
-<span class="sourceLineNo">1685</span> @Override<a name="line.1685"></a>
-<span class="sourceLineNo">1686</span> public BlockCache[] getBlockCaches() {<a name="line.1686"></a>
-<span class="sourceLineNo">1687</span> return null;<a name="line.1687"></a>
-<span class="sourceLineNo">1688</span> }<a name="line.1688"></a>
-<span class="sourceLineNo">1689</span><a name="line.1689"></a>
-<span class="sourceLineNo">1690</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1690"></a>
-<span class="sourceLineNo">1691</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1691"></a>
-<span class="sourceLineNo">1692</span> if (bucketEntry != null) {<a name="line.1692"></a>
-<span class="sourceLineNo">1693</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1693"></a>
-<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
-<span class="sourceLineNo">1695</span> return 0;<a name="line.1695"></a>
-<span class="sourceLineNo">1696</span> }<a name="line.1696"></a>
-<span class="sourceLineNo">1697</span><a name="line.1697"></a>
-<span class="sourceLineNo">1698</span> float getAcceptableFactor() {<a name="line.1698"></a>
-<span class="sourceLineNo">1699</span> return acceptableFactor;<a name="line.1699"></a>
-<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
-<span class="sourceLineNo">1701</span><a name="line.1701"></a>
-<span class="sourceLineNo">1702</span> float getMinFactor() {<a name="line.1702"></a>
-<span class="sourceLineNo">1703</span> return minFactor;<a name="line.1703"></a>
-<span class="sourceLineNo">1704</span> }<a name="line.1704"></a>
-<span class="sourceLineNo">1705</span><a name="line.1705"></a>
-<span class="sourceLineNo">1706</span> float getExtraFreeFactor() {<a name="line.1706"></a>
-<span class="sourceLineNo">1707</span> return extraFreeFactor;<a name="line.1707"></a>
-<span class="sourceLineNo">1708</span> }<a name="line.1708"></a>
-<span class="sourceLineNo">1709</span><a name="line.1709"></a>
-<span class="sourceLineNo">1710</span> float getSingleFactor() {<a name="line.1710"></a>
-<span class="sourceLineNo">1711</span> return singleFactor;<a name="line.1711"></a>
-<span class="sourceLineNo">1712</span> }<a name="line.1712"></a>
-<span class="sourceLineNo">1713</span><a name="line.1713"></a>
-<span class="sourceLineNo">1714</span> float getMultiFactor() {<a name="line.1714"></a>
-<span class="sourceLineNo">1715</span> return multiFactor;<a name="line.1715"></a>
-<span class="sourceLineNo">1716</span> }<a name="line.1716"></a>
-<span class="sourceLineNo">1717</span><a name="line.1717"></a>
-<span class="sourceLineNo">1718</span> float getMemoryFactor() {<a name="line.1718"></a>
-<span class="sourceLineNo">1719</span> return memoryFactor;<a name="line.1719"></a>
-<span class="sourceLineNo">1720</span> }<a name="line.1720"></a>
-<span class="sourceLineNo">1721</span><a name="line.1721"></a>
-<span class="sourceLineNo">1722</span> /**<a name="line.1722"></a>
-<span class="sourceLineNo">1723</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1723"></a>
-<span class="sourceLineNo">1724</span> */<a name="line.1724"></a>
-<span class="sourceLineNo">1725</span> static class RAMCache {<a name="line.1725"></a>
-<span class="sourceLineNo">1726</span> /**<a name="line.1726"></a>
-<span class="sourceLineNo">1727</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1727"></a>
-<span class="sourceLineNo">1728</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1728"></a>
-<span class="sourceLineNo">1729</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1729"></a>
-<span class="sourceLineNo">1730</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1730"></a>
-<span class="sourceLineNo">1731</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1731"></a>
-<span class="sourceLineNo">1732</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1732"></a>
-<span class="sourceLineNo">1733</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1733"></a>
-<span class="sourceLineNo">1734</span> */<a name="line.1734"></a>
-<span class="sourceLineNo">1735</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1735"></a>
-<span class="sourceLineNo">1736</span><a name="line.1736"></a>
-<span class="sourceLineNo">1737</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1737"></a>
-<span class="sourceLineNo">1738</span> return delegate.containsKey(key);<a name="line.1738"></a>
-<span class="sourceLineNo">1739</span> }<a name="line.1739"></a>
-<span class="sourceLineNo">1740</span><a name="line.1740"></a>
-<span class="sourceLineNo">1741</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1741"></a>
-<span class="sourceLineNo">1742</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1742"></a>
-<span class="sourceLineNo">1743</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1743"></a>
-<span class="sourceLineNo">1744</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1744"></a>
-<span class="sourceLineNo">1745</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1745"></a>
-<span class="sourceLineNo">1746</span> re.getData().retain();<a name="line.1746"></a>
-<span class="sourceLineNo">1747</span> return re;<a name="line.1747"></a>
-<span class="sourceLineNo">1748</span> });<a name="line.1748"></a>
-<span class="sourceLineNo">1749</span> }<a name="line.1749"></a>
-<span class="sourceLineNo">1750</span><a name="line.1750"></a>
-<span class="sourceLineNo">1751</span> /**<a name="line.1751"></a>
-<span class="sourceLineNo">1752</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1752"></a>
-<span class="sourceLineNo">1753</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1753"></a>
-<span class="sourceLineNo">1754</span> */<a name="line.1754"></a>
-<span class="sourceLineNo">1755</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1755"></a>
-<span class="sourceLineNo">1756</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1756"></a>
-<span class="sourceLineNo">1757</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1757"></a>
-<span class="sourceLineNo">1758</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1758"></a>
-<span class="sourceLineNo">1759</span> entry.getData().retain();<a name="line.1759"></a>
-<span class="sourceLineNo">1760</span> absent.set(true);<a name="line.1760"></a>
-<span class="sourceLineNo">1761</span> return entry;<a name="line.1761"></a>
-<span class="sourceLineNo">1762</span> });<a name="line.1762"></a>
-<span class="sourceLineNo">1763</span> return absent.get() ? null : re;<a name="line.1763"></a>
-<span class="sourceLineNo">1764</span> }<a name="line.1764"></a>
-<span class="sourceLineNo">1765</span><a name="line.1765"></a>
-<span class="sourceLineNo">1766</span> public boolean remove(BlockCacheKey key) {<a name="line.1766"></a>
-<span class="sourceLineNo">1767</span> return remove(key, re -> {<a name="line.1767"></a>
+<span class="sourceLineNo">1628</span> public BlockType getBlockType() {<a name="line.1628"></a>
+<span class="sourceLineNo">1629</span> // Not held by BucketEntry. Could add it if wanted on BucketEntry creation.<a name="line.1629"></a>
+<span class="sourceLineNo">1630</span> return null;<a name="line.1630"></a>
+<span class="sourceLineNo">1631</span> }<a name="line.1631"></a>
+<span class="sourceLineNo">1632</span><a name="line.1632"></a>
+<span class="sourceLineNo">1633</span> @Override<a name="line.1633"></a>
+<span class="sourceLineNo">1634</span> public long getOffset() {<a name="line.1634"></a>
+<span class="sourceLineNo">1635</span> return e.getKey().getOffset();<a name="line.1635"></a>
+<span class="sourceLineNo">1636</span> }<a name="line.1636"></a>
+<span class="sourceLineNo">1637</span><a name="line.1637"></a>
+<span class="sourceLineNo">1638</span> @Override<a name="line.1638"></a>
+<span class="sourceLineNo">1639</span> public long getSize() {<a name="line.1639"></a>
+<span class="sourceLineNo">1640</span> return e.getValue().getLength();<a name="line.1640"></a>
+<span class="sourceLineNo">1641</span> }<a name="line.1641"></a>
+<span class="sourceLineNo">1642</span><a name="line.1642"></a>
+<span class="sourceLineNo">1643</span> @Override<a name="line.1643"></a>
+<span class="sourceLineNo">1644</span> public long getCachedTime() {<a name="line.1644"></a>
+<span class="sourceLineNo">1645</span> return e.getValue().getCachedTime();<a name="line.1645"></a>
+<span class="sourceLineNo">1646</span> }<a name="line.1646"></a>
+<span class="sourceLineNo">1647</span><a name="line.1647"></a>
+<span class="sourceLineNo">1648</span> @Override<a name="line.1648"></a>
+<span class="sourceLineNo">1649</span> public String getFilename() {<a name="line.1649"></a>
+<span class="sourceLineNo">1650</span> return e.getKey().getHfileName();<a name="line.1650"></a>
+<span class="sourceLineNo">1651</span> }<a name="line.1651"></a>
+<span class="sourceLineNo">1652</span><a name="line.1652"></a>
+<span class="sourceLineNo">1653</span> @Override<a name="line.1653"></a>
+<span class="sourceLineNo">1654</span> public int compareTo(CachedBlock other) {<a name="line.1654"></a>
+<span class="sourceLineNo">1655</span> int diff = this.getFilename().compareTo(other.getFilename());<a name="line.1655"></a>
+<span class="sourceLineNo">1656</span> if (diff != 0) return diff;<a name="line.1656"></a>
+<span class="sourceLineNo">1657</span><a name="line.1657"></a>
+<span class="sourceLineNo">1658</span> diff = Long.compare(this.getOffset(), other.getOffset());<a name="line.1658"></a>
+<span class="sourceLineNo">1659</span> if (diff != 0) return diff;<a name="line.1659"></a>
+<span class="sourceLineNo">1660</span> if (other.getCachedTime() < 0 || this.getCachedTime() < 0) {<a name="line.1660"></a>
+<span class="sourceLineNo">1661</span> throw new IllegalStateException(<a name="line.1661"></a>
+<span class="sourceLineNo">1662</span> "" + this.getCachedTime() + ", " + other.getCachedTime());<a name="line.1662"></a>
+<span class="sourceLineNo">1663</span> }<a name="line.1663"></a>
+<span class="sourceLineNo">1664</span> return Long.compare(other.getCachedTime(), this.getCachedTime());<a name="line.1664"></a>
+<span class="sourceLineNo">1665</span> }<a name="line.1665"></a>
+<span class="sourceLineNo">1666</span><a name="line.1666"></a>
+<span class="sourceLineNo">1667</span> @Override<a name="line.1667"></a>
+<span class="sourceLineNo">1668</span> public int hashCode() {<a name="line.1668"></a>
+<span class="sourceLineNo">1669</span> return e.getKey().hashCode();<a name="line.1669"></a>
+<span class="sourceLineNo">1670</span> }<a name="line.1670"></a>
+<span class="sourceLineNo">1671</span><a name="line.1671"></a>
+<span class="sourceLineNo">1672</span> @Override<a name="line.1672"></a>
+<span class="sourceLineNo">1673</span> public boolean equals(Object obj) {<a name="line.1673"></a>
+<span class="sourceLineNo">1674</span> if (obj instanceof CachedBlock) {<a name="line.1674"></a>
+<span class="sourceLineNo">1675</span> CachedBlock cb = (CachedBlock) obj;<a name="line.1675"></a>
+<span class="sourceLineNo">1676</span> return compareTo(cb) == 0;<a name="line.1676"></a>
+<span class="sourceLineNo">1677</span> } else {<a name="line.1677"></a>
+<span class="sourceLineNo">1678</span> return false;<a name="line.1678"></a>
+<span class="sourceLineNo">1679</span> }<a name="line.1679"></a>
+<span class="sourceLineNo">1680</span> }<a name="line.1680"></a>
+<span class="sourceLineNo">1681</span> };<a name="line.1681"></a>
+<span class="sourceLineNo">1682</span> }<a name="line.1682"></a>
+<span class="sourceLineNo">1683</span><a name="line.1683"></a>
+<span class="sourceLineNo">1684</span> @Override<a name="line.1684"></a>
+<span class="sourceLineNo">1685</span> public void remove() {<a name="line.1685"></a>
+<span class="sourceLineNo">1686</span> throw new UnsupportedOperationException();<a name="line.1686"></a>
+<span class="sourceLineNo">1687</span> }<a name="line.1687"></a>
+<span class="sourceLineNo">1688</span> };<a name="line.1688"></a>
+<span class="sourceLineNo">1689</span> }<a name="line.1689"></a>
+<span class="sourceLineNo">1690</span><a name="line.1690"></a>
+<span class="sourceLineNo">1691</span> @Override<a name="line.1691"></a>
+<span class="sourceLineNo">1692</span> public BlockCache[] getBlockCaches() {<a name="line.1692"></a>
+<span class="sourceLineNo">1693</span> return null;<a name="line.1693"></a>
+<span class="sourceLineNo">1694</span> }<a name="line.1694"></a>
+<span class="sourceLineNo">1695</span><a name="line.1695"></a>
+<span class="sourceLineNo">1696</span> public int getRpcRefCount(BlockCacheKey cacheKey) {<a name="line.1696"></a>
+<span class="sourceLineNo">1697</span> BucketEntry bucketEntry = backingMap.get(cacheKey);<a name="line.1697"></a>
+<span class="sourceLineNo">1698</span> if (bucketEntry != null) {<a name="line.1698"></a>
+<span class="sourceLineNo">1699</span> return bucketEntry.refCnt() - (bucketEntry.markedAsEvicted.get() ? 0 : 1);<a name="line.1699"></a>
+<span class="sourceLineNo">1700</span> }<a name="line.1700"></a>
+<span class="sourceLineNo">1701</span> return 0;<a name="line.1701"></a>
+<span class="sourceLineNo">1702</span> }<a name="line.1702"></a>
+<span class="sourceLineNo">1703</span><a name="line.1703"></a>
+<span class="sourceLineNo">1704</span> float getAcceptableFactor() {<a name="line.1704"></a>
+<span class="sourceLineNo">1705</span> return acceptableFactor;<a name="line.1705"></a>
+<span class="sourceLineNo">1706</span> }<a name="line.1706"></a>
+<span class="sourceLineNo">1707</span><a name="line.1707"></a>
+<span class="sourceLineNo">1708</span> float getMinFactor() {<a name="line.1708"></a>
+<span class="sourceLineNo">1709</span> return minFactor;<a name="line.1709"></a>
+<span class="sourceLineNo">1710</span> }<a name="line.1710"></a>
+<span class="sourceLineNo">1711</span><a name="line.1711"></a>
+<span class="sourceLineNo">1712</span> float getExtraFreeFactor() {<a name="line.1712"></a>
+<span class="sourceLineNo">1713</span> return extraFreeFactor;<a name="line.1713"></a>
+<span class="sourceLineNo">1714</span> }<a name="line.1714"></a>
+<span class="sourceLineNo">1715</span><a name="line.1715"></a>
+<span class="sourceLineNo">1716</span> float getSingleFactor() {<a name="line.1716"></a>
+<span class="sourceLineNo">1717</span> return singleFactor;<a name="line.1717"></a>
+<span class="sourceLineNo">1718</span> }<a name="line.1718"></a>
+<span class="sourceLineNo">1719</span><a name="line.1719"></a>
+<span class="sourceLineNo">1720</span> float getMultiFactor() {<a name="line.1720"></a>
+<span class="sourceLineNo">1721</span> return multiFactor;<a name="line.1721"></a>
+<span class="sourceLineNo">1722</span> }<a name="line.1722"></a>
+<span class="sourceLineNo">1723</span><a name="line.1723"></a>
+<span class="sourceLineNo">1724</span> float getMemoryFactor() {<a name="line.1724"></a>
+<span class="sourceLineNo">1725</span> return memoryFactor;<a name="line.1725"></a>
+<span class="sourceLineNo">1726</span> }<a name="line.1726"></a>
+<span class="sourceLineNo">1727</span><a name="line.1727"></a>
+<span class="sourceLineNo">1728</span> /**<a name="line.1728"></a>
+<span class="sourceLineNo">1729</span> * Wrapped the delegate ConcurrentMap with maintaining its block's reference count.<a name="line.1729"></a>
+<span class="sourceLineNo">1730</span> */<a name="line.1730"></a>
+<span class="sourceLineNo">1731</span> static class RAMCache {<a name="line.1731"></a>
+<span class="sourceLineNo">1732</span> /**<a name="line.1732"></a>
+<span class="sourceLineNo">1733</span> * Defined the map as {@link ConcurrentHashMap} explicitly here, because in<a name="line.1733"></a>
+<span class="sourceLineNo">1734</span> * {@link RAMCache#get(BlockCacheKey)} and<a name="line.1734"></a>
+<span class="sourceLineNo">1735</span> * {@link RAMCache#putIfAbsent(BlockCacheKey, BucketCache.RAMQueueEntry)} , we need to guarantee<a name="line.1735"></a>
+<span class="sourceLineNo">1736</span> * the atomicity of map#computeIfPresent(key, func) and map#putIfAbsent(key, func). Besides, the<a name="line.1736"></a>
+<span class="sourceLineNo">1737</span> * func method can execute exactly once only when the key is present(or absent) and under the<a name="line.1737"></a>
+<span class="sourceLineNo">1738</span> * lock context. Otherwise, the reference count of block will be messed up. Notice that the<a name="line.1738"></a>
+<span class="sourceLineNo">1739</span> * {@link java.util.concurrent.ConcurrentSkipListMap} can not guarantee that.<a name="line.1739"></a>
+<span class="sourceLineNo">1740</span> */<a name="line.1740"></a>
+<span class="sourceLineNo">1741</span> final ConcurrentHashMap<BlockCacheKey, RAMQueueEntry> delegate = new ConcurrentHashMap<>();<a name="line.1741"></a>
+<span class="sourceLineNo">1742</span><a name="line.1742"></a>
+<span class="sourceLineNo">1743</span> public boolean containsKey(BlockCacheKey key) {<a name="line.1743"></a>
+<span class="sourceLineNo">1744</span> return delegate.containsKey(key);<a name="line.1744"></a>
+<span class="sourceLineNo">1745</span> }<a name="line.1745"></a>
+<span class="sourceLineNo">1746</span><a name="line.1746"></a>
+<span class="sourceLineNo">1747</span> public RAMQueueEntry get(BlockCacheKey key) {<a name="line.1747"></a>
+<span class="sourceLineNo">1748</span> return delegate.computeIfPresent(key, (k, re) -> {<a name="line.1748"></a>
+<span class="sourceLineNo">1749</span> // It'll be referenced by RPC, so retain atomically here. if the get and retain is not<a name="line.1749"></a>
+<span class="sourceLineNo">1750</span> // atomic, another thread may remove and release the block, when retaining in this thread we<a name="line.1750"></a>
+<span class="sourceLineNo">1751</span> // may retain a block with refCnt=0 which is disallowed. (see HBASE-22422)<a name="line.1751"></a>
+<span class="sourceLineNo">1752</span> re.getData().retain();<a name="line.1752"></a>
+<span class="sourceLineNo">1753</span> return re;<a name="line.1753"></a>
+<span class="sourceLineNo">1754</span> });<a name="line.1754"></a>
+<span class="sourceLineNo">1755</span> }<a name="line.1755"></a>
+<span class="sourceLineNo">1756</span><a name="line.1756"></a>
+<span class="sourceLineNo">1757</span> /**<a name="line.1757"></a>
+<span class="sourceLineNo">1758</span> * Return the previous associated value, or null if absent. It has the same meaning as<a name="line.1758"></a>
+<span class="sourceLineNo">1759</span> * {@link ConcurrentMap#putIfAbsent(Object, Object)}<a name="line.1759"></a>
+<span class="sourceLineNo">1760</span> */<a name="line.1760"></a>
+<span class="sourceLineNo">1761</span> public RAMQueueEntry putIfAbsent(BlockCacheKey key, RAMQueueEntry entry) {<a name="line.1761"></a>
+<span class="sourceLineNo">1762</span> AtomicBoolean absent = new AtomicBoolean(false);<a name="line.1762"></a>
+<span class="sourceLineNo">1763</span> RAMQueueEntry re = delegate.computeIfAbsent(key, k -> {<a name="line.1763"></a>
+<span class="sourceLineNo">1764</span> // The RAMCache reference to this entry, so reference count should be increment.<a name="line.1764"></a>
+<span class="sourceLineNo">1765</span> entry.getData().retain();<a name="line.1765"></a>
+<span class="sourceLineNo">1766</span> absent.set(true);<a name="line.1766"></a>
+<span class="sourceLineNo">1767</span> return entry;<a name="line.1767"></a>
<span class="sourceLineNo">1768</span> });<a name="line.1768"></a>
-<span class="sourceLineNo">1769</span> }<a name="line.1769"></a>
-<span class="sourceLineNo">1770</span><a name="line.1770"></a>
-<span class="sourceLineNo">1771</span> /**<a name="line.1771"></a>
-<span class="sourceLineNo">1772</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1772"></a>
-<span class="sourceLineNo">1773</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1773"></a>
-<span class="sourceLineNo">1774</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1774"></a>
-<span class="sourceLineNo">1775</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1775"></a>
-<span class="sourceLineNo">1776</span> */<a name="line.1776"></a>
-<span class="sourceLineNo">1777</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1777"></a>
-<span class="sourceLineNo">1778</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1778"></a>
-<span class="sourceLineNo">1779</span> action.accept(previous);<a name="line.1779"></a>
-<span class="sourceLineNo">1780</span> if (previous != null) {<a name="line.1780"></a>
-<span class="sourceLineNo">1781</span> previous.getData().release();<a name="line.1781"></a>
-<span class="sourceLineNo">1782</span> }<a name="line.1782"></a>
-<span class="sourceLineNo">1783</span> return previous != null;<a name="line.1783"></a>
-<span class="sourceLineNo">1784</span> }<a name="line.1784"></a>
-<span class="sourceLineNo">1785</span><a name="line.1785"></a>
-<span class="sourceLineNo">1786</span> public boolean isEmpty() {<a name="line.1786"></a>
-<span class="sourceLineNo">1787</span> return delegate.isEmpty();<a name="line.1787"></a>
-<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
-<span class="sourceLineNo">1789</span><a name="line.1789"></a>
-<span class="sourceLineNo">1790</span> public void clear() {<a name="line.1790"></a>
-<span class="sourceLineNo">1791</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1791"></a>
-<span class="sourceLineNo">1792</span> while (it.hasNext()) {<a name="line.1792"></a>
-<span class="sourceLineNo">1793</span> RAMQueueEntry re = it.next().getValue();<a name="line.1793"></a>
-<span class="sourceLineNo">1794</span> it.remove();<a name="line.1794"></a>
-<span class="sourceLineNo">1795</span> re.getData().release();<a name="line.1795"></a>
-<span class="sourceLineNo">1796</span> }<a name="line.1796"></a>
-<span class="sourceLineNo">1797</span> }<a name="line.1797"></a>
-<span class="sourceLineNo">1798</span> }<a name="line.1798"></a>
-<span class="sourceLineNo">1799</span>}<a name="line.1799"></a>
+<span class="sourceLineNo">1769</span> return absent.get() ? null : re;<a name="line.1769"></a>
+<span class="sourceLineNo">1770</span> }<a name="line.1770"></a>
+<span class="sourceLineNo">1771</span><a name="line.1771"></a>
+<span class="sourceLineNo">1772</span> public boolean remove(BlockCacheKey key) {<a name="line.1772"></a>
+<span class="sourceLineNo">1773</span> return remove(key, re -> {<a name="line.1773"></a>
+<span class="sourceLineNo">1774</span> });<a name="line.1774"></a>
+<span class="sourceLineNo">1775</span> }<a name="line.1775"></a>
+<span class="sourceLineNo">1776</span><a name="line.1776"></a>
+<span class="sourceLineNo">1777</span> /**<a name="line.1777"></a>
+<span class="sourceLineNo">1778</span> * Defined an {@link Consumer} here, because once the removed entry release its reference count,<a name="line.1778"></a>
+<span class="sourceLineNo">1779</span> * then it's ByteBuffers may be recycled and accessing it outside this method will be thrown an<a name="line.1779"></a>
+<span class="sourceLineNo">1780</span> * exception. the consumer will access entry to remove before release its reference count.<a name="line.1780"></a>
+<span class="sourceLineNo">1781</span> * Notice, don't change its reference count in the {@link Consumer}<a name="line.1781"></a>
+<span class="sourceLineNo">1782</span> */<a name="line.1782"></a>
+<span class="sourceLineNo">1783</span> public boolean remove(BlockCacheKey key, Consumer<RAMQueueEntry> action) {<a name="line.1783"></a>
+<span class="sourceLineNo">1784</span> RAMQueueEntry previous = delegate.remove(key);<a name="line.1784"></a>
+<span class="sourceLineNo">1785</span> action.accept(previous);<a name="line.1785"></a>
+<span class="sourceLineNo">1786</span> if (previous != null) {<a name="line.1786"></a>
+<span class="sourceLineNo">1787</span> previous.getData().release();<a name="line.1787"></a>
+<span class="sourceLineNo">1788</span> }<a name="line.1788"></a>
+<span class="sourceLineNo">1789</span> return previous != null;<a name="line.1789"></a>
+<span class="sourceLineNo">1790</span> }<a name="line.1790"></a>
+<span class="sourceLineNo">1791</span><a name="line.1791"></a>
+<span class="sourceLineNo">1792</span> public boolean isEmpty() {<a name="line.1792"></a>
+<span class="sourceLineNo">1793</span> return delegate.isEmpty();<a name="line.1793"></a>
+<span class="sourceLineNo">1794</span> }<a name="line.1794"></a>
+<span class="sourceLineNo">1795</span><a name="line.1795"></a>
+<span class="sourceLineNo">1796</span> public void clear() {<a name="line.1796"></a>
+<span class="sourceLineNo">1797</span> Iterator<Map.Entry<BlockCacheKey, RAMQueueEntry>> it = delegate.entrySet().iterator();<a name="line.1797"></a>
+<span class="sourceLineNo">1798</span> while (it.hasNext()) {<a name="line.1798"></a>
+<span class="sourceLineNo">1799</span> RAMQueueEntry re = it.next().getValue();<a name="line.1799"></a>
+<span class="sourceLineNo">1800</span> it.remove();<a name="line.1800"></a>
+<span class="sourceLineNo">1801</span> re.getData().release();<a name="line.1801"></a>
+<span class="sourceLineNo">1802</span> }<a name="line.1802"></a>
+<span class="sourceLineNo">1803</span> }<a name="line.1803"></a>
+<span class="sourceLineNo">1804</span> }<a name="line.1804"></a>
+<span class="sourceLineNo">1805</span>}<a name="line.1805"></a>
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html b/devapidocs/src-html/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html
index a4ae8306487..1fa138eb623 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/master/cleaner/HFileLinkCleaner.html
@@ -98,41 +98,54 @@
<span class="sourceLineNo">090</span> }<a name="line.90"></a>
<span class="sourceLineNo">091</span><a name="line.91"></a>
<span class="sourceLineNo">092</span> // HFile is deletable only if has no links<a name="line.92"></a>
-<span class="sourceLineNo">093</span> Path backRefDir = null;<a name="line.93"></a>
+<span class="sourceLineNo">093</span> Path backRefDir = HFileLink.getBackReferencesDir(parentDir, filePath.getName());<a name="line.93"></a>
<span class="sourceLineNo">094</span> try {<a name="line.94"></a>
-<span class="sourceLineNo">095</span> backRefDir = HFileLink.getBackReferencesDir(parentDir, filePath.getName());<a name="line.95"></a>
-<span class="sourceLineNo">096</span> return CommonFSUtils.listStatus(fs, backRefDir) == null;<a name="line.96"></a>
-<span class="sourceLineNo">097</span> } catch (IOException e) {<a name="line.97"></a>
-<span class="sourceLineNo">098</span> if (LOG.isDebugEnabled()) {<a name="line.98"></a>
-<span class="sourceLineNo">099</span> LOG.debug("Couldn't get the references, not deleting file, just in case. filePath="<a name="line.99"></a>
-<span class="sourceLineNo">100</span> + filePath + ", backRefDir=" + backRefDir);<a name="line.100"></a>
-<span class="sourceLineNo">101</span> }<a name="line.101"></a>
-<span class="sourceLineNo">102</span> return false;<a name="line.102"></a>
-<span class="sourceLineNo">103</span> }<a name="line.103"></a>
-<span class="sourceLineNo">104</span> } finally {<a name="line.104"></a>
-<span class="sourceLineNo">105</span> lock.readLock().unlock();<a name="line.105"></a>
-<span class="sourceLineNo">106</span> }<a name="line.106"></a>
-<span class="sourceLineNo">107</span> }<a name="line.107"></a>
-<span class="sourceLineNo">108</span><a name="line.108"></a>
-<span class="sourceLineNo">109</span> @Override<a name="line.109"></a>
-<span class="sourceLineNo">110</span> public void setConf(Configuration conf) {<a name="line.110"></a>
-<span class="sourceLineNo">111</span> super.setConf(conf);<a name="line.111"></a>
-<span class="sourceLineNo">112</span><a name="line.112"></a>
-<span class="sourceLineNo">113</span> // setup filesystem<a name="line.113"></a>
-<span class="sourceLineNo">114</span> lock.writeLock().lock();<a name="line.114"></a>
-<span class="sourceLineNo">115</span> try {<a name="line.115"></a>
-<span class="sourceLineNo">116</span> this.fs = FileSystem.get(this.getConf());<a name="line.116"></a>
-<span class="sourceLineNo">117</span> } catch (IOException e) {<a name="line.117"></a>
-<span class="sourceLineNo">118</span> if (LOG.isDebugEnabled()) {<a name="line.118"></a>
-<span class="sourceLineNo">119</span> LOG.debug("Couldn't instantiate the file system, not deleting file, just in case. "<a name="line.119"></a>
-<span class="sourceLineNo">120</span> + FileSystem.FS_DEFAULT_NAME_KEY + "="<a name="line.120"></a>
-<span class="sourceLineNo">121</span> + getConf().get(FileSystem.FS_DEFAULT_NAME_KEY, FileSystem.DEFAULT_FS));<a name="line.121"></a>
-<span class="sourceLineNo">122</span> }<a name="line.122"></a>
-<span class="sourceLineNo">123</span> } finally {<a name="line.123"></a>
-<span class="sourceLineNo">124</span> lock.writeLock().unlock();<a name="line.124"></a>
-<span class="sourceLineNo">125</span> }<a name="line.125"></a>
-<span class="sourceLineNo">126</span> }<a name="line.126"></a>
-<span class="sourceLineNo">127</span>}<a name="line.127"></a>
+<span class="sourceLineNo">095</span> FileStatus[] fileStatuses = CommonFSUtils.listStatus(fs, backRefDir);<a name="line.95"></a>
+<span class="sourceLineNo">096</span> // for empty reference directory, retain the logic to be deletable<a name="line.96"></a>
+<span class="sourceLineNo">097</span> if (fileStatuses == null) {<a name="line.97"></a>
+<span class="sourceLineNo">098</span> return true;<a name="line.98"></a>
+<span class="sourceLineNo">099</span> }<a name="line.99"></a>
+<span class="sourceLineNo">100</span> // reuse the found back reference files, check if the forward reference exists.<a name="line.100"></a>
+<span class="sourceLineNo">101</span> // with this optimization, the chore could save one round compute time if we're visiting<a name="line.101"></a>
+<span class="sourceLineNo">102</span> // the archive HFile earlier than the HFile Link<a name="line.102"></a>
+<span class="sourceLineNo">103</span> for (FileStatus fileStatus : fileStatuses) {<a name="line.103"></a>
+<span class="sourceLineNo">104</span> if (!isFileDeletable(fileStatus)) {<a name="line.104"></a>
+<span class="sourceLineNo">105</span> return false;<a name="line.105"></a>
+<span class="sourceLineNo">106</span> }<a name="line.106"></a>
+<span class="sourceLineNo">107</span> }<a name="line.107"></a>
+<span class="sourceLineNo">108</span> // all the found back reference files are clear, we can delete it.<a name="line.108"></a>
+<span class="sourceLineNo">109</span> return true;<a name="line.109"></a>
+<span class="sourceLineNo">110</span> } catch (IOException e) {<a name="line.110"></a>
+<span class="sourceLineNo">111</span> if (LOG.isDebugEnabled()) {<a name="line.111"></a>
+<span class="sourceLineNo">112</span> LOG.debug("Couldn't get the references, not deleting file, just in case. filePath="<a name="line.112"></a>
+<span class="sourceLineNo">113</span> + filePath + ", backRefDir=" + backRefDir);<a name="line.113"></a>
+<span class="sourceLineNo">114</span> }<a name="line.114"></a>
+<span class="sourceLineNo">115</span> return false;<a name="line.115"></a>
+<span class="sourceLineNo">116</span> }<a name="line.116"></a>
+<span class="sourceLineNo">117</span> } finally {<a name="line.117"></a>
+<span class="sourceLineNo">118</span> lock.readLock().unlock();<a name="line.118"></a>
+<span class="sourceLineNo">119</span> }<a name="line.119"></a>
+<span class="sourceLineNo">120</span> }<a name="line.120"></a>
+<span class="sourceLineNo">121</span><a name="line.121"></a>
+<span class="sourceLineNo">122</span> @Override<a name="line.122"></a>
+<span class="sourceLineNo">123</span> public void setConf(Configuration conf) {<a name="line.123"></a>
+<span class="sourceLineNo">124</span> super.setConf(conf);<a name="line.124"></a>
+<span class="sourceLineNo">125</span><a name="line.125"></a>
+<span class="sourceLineNo">126</span> // setup filesystem<a name="line.126"></a>
+<span class="sourceLineNo">127</span> lock.writeLock().lock();<a name="line.127"></a>
+<span class="sourceLineNo">128</span> try {<a name="line.128"></a>
+<span class="sourceLineNo">129</span> this.fs = FileSystem.get(this.getConf());<a name="line.129"></a>
+<span class="sourceLineNo">130</span> } catch (IOException e) {<a name="line.130"></a>
+<span class="sourceLineNo">131</span> if (LOG.isDebugEnabled()) {<a name="line.131"></a>
+<span class="sourceLineNo">132</span> LOG.debug("Couldn't instantiate the file system, not deleting file, just in case. "<a name="line.132"></a>
+<span class="sourceLineNo">133</span> + FileSystem.FS_DEFAULT_NAME_KEY + "="<a name="line.133"></a>
+<span class="sourceLineNo">134</span> + getConf().get(FileSystem.FS_DEFAULT_NAME_KEY, FileSystem.DEFAULT_FS));<a name="line.134"></a>
+<span class="sourceLineNo">135</span> }<a name="line.135"></a>
+<span class="sourceLineNo">136</span> } finally {<a name="line.136"></a>
+<span class="sourceLineNo">137</span> lock.writeLock().unlock();<a name="line.137"></a>
+<span class="sourceLineNo">138</span> }<a name="line.138"></a>
+<span class="sourceLineNo">139</span> }<a name="line.139"></a>
+<span class="sourceLineNo">140</span>}<a name="line.140"></a>
diff --git a/downloads.html b/downloads.html
index ddd2edeb862..e4dd7ed4b8d 100644
--- a/downloads.html
+++ b/downloads.html
@@ -413,7 +413,7 @@
<div class="row">
<p>Copyright ©2007–2022
<a href="https://www.apache.org/">The Apache Software Foundation</a>.
-All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-18</li>
+All rights reserved. <li id="publishDate" class="pull-right">Last Published: 2022-11-21</li>
</p>
</div>
<p id="poweredBy" class="pull-right"><a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"><img class="builtBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /></a>
... 1776 lines suppressed ...