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 2017/07/18 22:07:30 UTC

[04/11] hbase-site git commit: Published site at 82d554e3783372cc6b05489452c815b57c06f6cd.

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/devapidocs/src-html/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.html
----------------------------------------------------------------------
diff --git a/devapidocs/src-html/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.html b/devapidocs/src-html/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.html
index 03b72df..745d53a 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/replication/regionserver/WALEntryStream.html
@@ -49,374 +49,382 @@
 <span class="sourceLineNo">041</span>import org.apache.hadoop.hbase.wal.WAL.Entry;<a name="line.41"></a>
 <span class="sourceLineNo">042</span>import org.apache.hadoop.hbase.wal.WAL.Reader;<a name="line.42"></a>
 <span class="sourceLineNo">043</span>import org.apache.hadoop.hbase.wal.WALFactory;<a name="line.43"></a>
-<span class="sourceLineNo">044</span><a name="line.44"></a>
-<span class="sourceLineNo">045</span>/**<a name="line.45"></a>
-<span class="sourceLineNo">046</span> * Streaming access to WAL entries. This class is given a queue of WAL {@link Path}, and continually<a name="line.46"></a>
-<span class="sourceLineNo">047</span> * iterates through all the WAL {@link Entry} in the queue. When it's done reading from a Path, it<a name="line.47"></a>
-<span class="sourceLineNo">048</span> * dequeues it and starts reading from the next.<a name="line.48"></a>
-<span class="sourceLineNo">049</span> */<a name="line.49"></a>
-<span class="sourceLineNo">050</span>@InterfaceAudience.Private<a name="line.50"></a>
-<span class="sourceLineNo">051</span>@InterfaceStability.Evolving<a name="line.51"></a>
-<span class="sourceLineNo">052</span>public class WALEntryStream implements Iterator&lt;Entry&gt;, Closeable, Iterable&lt;Entry&gt; {<a name="line.52"></a>
-<span class="sourceLineNo">053</span>  private static final Log LOG = LogFactory.getLog(WALEntryStream.class);<a name="line.53"></a>
-<span class="sourceLineNo">054</span><a name="line.54"></a>
-<span class="sourceLineNo">055</span>  private Reader reader;<a name="line.55"></a>
-<span class="sourceLineNo">056</span>  private Path currentPath;<a name="line.56"></a>
-<span class="sourceLineNo">057</span>  // cache of next entry for hasNext()<a name="line.57"></a>
-<span class="sourceLineNo">058</span>  private Entry currentEntry;<a name="line.58"></a>
-<span class="sourceLineNo">059</span>  // position after reading current entry<a name="line.59"></a>
-<span class="sourceLineNo">060</span>  private long currentPosition = 0;<a name="line.60"></a>
-<span class="sourceLineNo">061</span>  private PriorityBlockingQueue&lt;Path&gt; logQueue;<a name="line.61"></a>
-<span class="sourceLineNo">062</span>  private FileSystem fs;<a name="line.62"></a>
-<span class="sourceLineNo">063</span>  private Configuration conf;<a name="line.63"></a>
-<span class="sourceLineNo">064</span>  private MetricsSource metrics;<a name="line.64"></a>
-<span class="sourceLineNo">065</span><a name="line.65"></a>
-<span class="sourceLineNo">066</span>  /**<a name="line.66"></a>
-<span class="sourceLineNo">067</span>   * Create an entry stream over the given queue<a name="line.67"></a>
-<span class="sourceLineNo">068</span>   * @param logQueue the queue of WAL paths<a name="line.68"></a>
-<span class="sourceLineNo">069</span>   * @param fs {@link FileSystem} to use to create {@link Reader} for this stream<a name="line.69"></a>
-<span class="sourceLineNo">070</span>   * @param conf {@link Configuration} to use to create {@link Reader} for this stream<a name="line.70"></a>
-<span class="sourceLineNo">071</span>   * @param metrics replication metrics<a name="line.71"></a>
-<span class="sourceLineNo">072</span>   * @throws IOException<a name="line.72"></a>
-<span class="sourceLineNo">073</span>   */<a name="line.73"></a>
-<span class="sourceLineNo">074</span>  public WALEntryStream(PriorityBlockingQueue&lt;Path&gt; logQueue, FileSystem fs, Configuration conf,<a name="line.74"></a>
-<span class="sourceLineNo">075</span>      MetricsSource metrics)<a name="line.75"></a>
-<span class="sourceLineNo">076</span>      throws IOException {<a name="line.76"></a>
-<span class="sourceLineNo">077</span>    this(logQueue, fs, conf, 0, metrics);<a name="line.77"></a>
-<span class="sourceLineNo">078</span>  }<a name="line.78"></a>
-<span class="sourceLineNo">079</span><a name="line.79"></a>
-<span class="sourceLineNo">080</span>  /**<a name="line.80"></a>
-<span class="sourceLineNo">081</span>   * Create an entry stream over the given queue at the given start position<a name="line.81"></a>
-<span class="sourceLineNo">082</span>   * @param logQueue the queue of WAL paths<a name="line.82"></a>
-<span class="sourceLineNo">083</span>   * @param fs {@link FileSystem} to use to create {@link Reader} for this stream<a name="line.83"></a>
-<span class="sourceLineNo">084</span>   * @param conf {@link Configuration} to use to create {@link Reader} for this stream<a name="line.84"></a>
-<span class="sourceLineNo">085</span>   * @param startPosition the position in the first WAL to start reading at<a name="line.85"></a>
-<span class="sourceLineNo">086</span>   * @param metrics replication metrics<a name="line.86"></a>
-<span class="sourceLineNo">087</span>   * @throws IOException<a name="line.87"></a>
-<span class="sourceLineNo">088</span>   */<a name="line.88"></a>
-<span class="sourceLineNo">089</span>  public WALEntryStream(PriorityBlockingQueue&lt;Path&gt; logQueue, FileSystem fs, Configuration conf,<a name="line.89"></a>
-<span class="sourceLineNo">090</span>      long startPosition, MetricsSource metrics) throws IOException {<a name="line.90"></a>
-<span class="sourceLineNo">091</span>    this.logQueue = logQueue;<a name="line.91"></a>
-<span class="sourceLineNo">092</span>    this.fs = fs;<a name="line.92"></a>
-<span class="sourceLineNo">093</span>    this.conf = conf;<a name="line.93"></a>
-<span class="sourceLineNo">094</span>    this.currentPosition = startPosition;<a name="line.94"></a>
-<span class="sourceLineNo">095</span>    this.metrics = metrics;<a name="line.95"></a>
-<span class="sourceLineNo">096</span>  }<a name="line.96"></a>
-<span class="sourceLineNo">097</span><a name="line.97"></a>
-<span class="sourceLineNo">098</span>  /**<a name="line.98"></a>
-<span class="sourceLineNo">099</span>   * @return true if there is another WAL {@link Entry}<a name="line.99"></a>
-<span class="sourceLineNo">100</span>   * @throws WALEntryStreamRuntimeException if there was an Exception while reading<a name="line.100"></a>
-<span class="sourceLineNo">101</span>   */<a name="line.101"></a>
-<span class="sourceLineNo">102</span>  @Override<a name="line.102"></a>
-<span class="sourceLineNo">103</span>  public boolean hasNext() {<a name="line.103"></a>
-<span class="sourceLineNo">104</span>    if (currentEntry == null) {<a name="line.104"></a>
-<span class="sourceLineNo">105</span>      try {<a name="line.105"></a>
-<span class="sourceLineNo">106</span>        tryAdvanceEntry();<a name="line.106"></a>
-<span class="sourceLineNo">107</span>      } catch (Exception e) {<a name="line.107"></a>
-<span class="sourceLineNo">108</span>        throw new WALEntryStreamRuntimeException(e);<a name="line.108"></a>
-<span class="sourceLineNo">109</span>      }<a name="line.109"></a>
-<span class="sourceLineNo">110</span>    }<a name="line.110"></a>
-<span class="sourceLineNo">111</span>    return currentEntry != null;<a name="line.111"></a>
-<span class="sourceLineNo">112</span>  }<a name="line.112"></a>
-<span class="sourceLineNo">113</span><a name="line.113"></a>
-<span class="sourceLineNo">114</span>  /**<a name="line.114"></a>
-<span class="sourceLineNo">115</span>   * @return the next WAL entry in this stream<a name="line.115"></a>
-<span class="sourceLineNo">116</span>   * @throws WALEntryStreamRuntimeException if there was an IOException<a name="line.116"></a>
-<span class="sourceLineNo">117</span>   * @throws NoSuchElementException if no more entries in the stream.<a name="line.117"></a>
-<span class="sourceLineNo">118</span>   */<a name="line.118"></a>
-<span class="sourceLineNo">119</span>  @Override<a name="line.119"></a>
-<span class="sourceLineNo">120</span>  public Entry next() {<a name="line.120"></a>
-<span class="sourceLineNo">121</span>    if (!hasNext()) throw new NoSuchElementException();<a name="line.121"></a>
-<span class="sourceLineNo">122</span>    Entry save = currentEntry;<a name="line.122"></a>
-<span class="sourceLineNo">123</span>    currentEntry = null; // gets reloaded by hasNext()<a name="line.123"></a>
-<span class="sourceLineNo">124</span>    return save;<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">128</span>   * Not supported.<a name="line.128"></a>
-<span class="sourceLineNo">129</span>   */<a name="line.129"></a>
-<span class="sourceLineNo">130</span>  @Override<a name="line.130"></a>
-<span class="sourceLineNo">131</span>  public void remove() {<a name="line.131"></a>
-<span class="sourceLineNo">132</span>    throw new UnsupportedOperationException();<a name="line.132"></a>
-<span class="sourceLineNo">133</span>  }<a name="line.133"></a>
-<span class="sourceLineNo">134</span><a name="line.134"></a>
-<span class="sourceLineNo">135</span>  /**<a name="line.135"></a>
-<span class="sourceLineNo">136</span>   * {@inheritDoc}<a name="line.136"></a>
-<span class="sourceLineNo">137</span>   */<a name="line.137"></a>
-<span class="sourceLineNo">138</span>  @Override<a name="line.138"></a>
-<span class="sourceLineNo">139</span>  public void close() throws IOException {<a name="line.139"></a>
-<span class="sourceLineNo">140</span>    closeReader();<a name="line.140"></a>
-<span class="sourceLineNo">141</span>  }<a name="line.141"></a>
-<span class="sourceLineNo">142</span><a name="line.142"></a>
-<span class="sourceLineNo">143</span>  /**<a name="line.143"></a>
-<span class="sourceLineNo">144</span>   * @return the iterator over WAL entries in the queue.<a name="line.144"></a>
-<span class="sourceLineNo">145</span>   */<a name="line.145"></a>
-<span class="sourceLineNo">146</span>  @Override<a name="line.146"></a>
-<span class="sourceLineNo">147</span>  public Iterator&lt;Entry&gt; iterator() {<a name="line.147"></a>
-<span class="sourceLineNo">148</span>    return this;<a name="line.148"></a>
-<span class="sourceLineNo">149</span>  }<a name="line.149"></a>
-<span class="sourceLineNo">150</span><a name="line.150"></a>
-<span class="sourceLineNo">151</span>  /**<a name="line.151"></a>
-<span class="sourceLineNo">152</span>   * @return the position of the last Entry returned by next()<a name="line.152"></a>
-<span class="sourceLineNo">153</span>   */<a name="line.153"></a>
-<span class="sourceLineNo">154</span>  public long getPosition() {<a name="line.154"></a>
-<span class="sourceLineNo">155</span>    return currentPosition;<a name="line.155"></a>
-<span class="sourceLineNo">156</span>  }<a name="line.156"></a>
-<span class="sourceLineNo">157</span><a name="line.157"></a>
-<span class="sourceLineNo">158</span>  /**<a name="line.158"></a>
-<span class="sourceLineNo">159</span>   * @return the {@link Path} of the current WAL<a name="line.159"></a>
-<span class="sourceLineNo">160</span>   */<a name="line.160"></a>
-<span class="sourceLineNo">161</span>  public Path getCurrentPath() {<a name="line.161"></a>
-<span class="sourceLineNo">162</span>    return currentPath;<a name="line.162"></a>
-<span class="sourceLineNo">163</span>  }<a name="line.163"></a>
-<span class="sourceLineNo">164</span><a name="line.164"></a>
-<span class="sourceLineNo">165</span>  private String getCurrentPathStat() {<a name="line.165"></a>
-<span class="sourceLineNo">166</span>    StringBuilder sb = new StringBuilder();<a name="line.166"></a>
-<span class="sourceLineNo">167</span>    if (currentPath != null) {<a name="line.167"></a>
-<span class="sourceLineNo">168</span>      sb.append("currently replicating from: ").append(currentPath).append(" at position: ")<a name="line.168"></a>
-<span class="sourceLineNo">169</span>          .append(currentPosition).append("\n");<a name="line.169"></a>
-<span class="sourceLineNo">170</span>    } else {<a name="line.170"></a>
-<span class="sourceLineNo">171</span>      sb.append("no replication ongoing, waiting for new log");<a name="line.171"></a>
-<span class="sourceLineNo">172</span>    }<a name="line.172"></a>
-<span class="sourceLineNo">173</span>    return sb.toString();<a name="line.173"></a>
-<span class="sourceLineNo">174</span>  }<a name="line.174"></a>
-<span class="sourceLineNo">175</span><a name="line.175"></a>
-<span class="sourceLineNo">176</span>  /**<a name="line.176"></a>
-<span class="sourceLineNo">177</span>   * Should be called if the stream is to be reused (i.e. used again after hasNext() has returned<a name="line.177"></a>
-<span class="sourceLineNo">178</span>   * false)<a name="line.178"></a>
-<span class="sourceLineNo">179</span>   * @throws IOException<a name="line.179"></a>
-<span class="sourceLineNo">180</span>   */<a name="line.180"></a>
-<span class="sourceLineNo">181</span>  public void reset() throws IOException {<a name="line.181"></a>
-<span class="sourceLineNo">182</span>    if (reader != null &amp;&amp; currentPath != null) {<a name="line.182"></a>
-<span class="sourceLineNo">183</span>      resetReader();<a name="line.183"></a>
-<span class="sourceLineNo">184</span>    }<a name="line.184"></a>
-<span class="sourceLineNo">185</span>  }<a name="line.185"></a>
-<span class="sourceLineNo">186</span><a name="line.186"></a>
-<span class="sourceLineNo">187</span>  private void setPosition(long position) {<a name="line.187"></a>
-<span class="sourceLineNo">188</span>    currentPosition = position;<a name="line.188"></a>
-<span class="sourceLineNo">189</span>  }<a name="line.189"></a>
-<span class="sourceLineNo">190</span><a name="line.190"></a>
-<span class="sourceLineNo">191</span>  private void setCurrentPath(Path path) {<a name="line.191"></a>
-<span class="sourceLineNo">192</span>    this.currentPath = path;<a name="line.192"></a>
-<span class="sourceLineNo">193</span>  }<a name="line.193"></a>
-<span class="sourceLineNo">194</span><a name="line.194"></a>
-<span class="sourceLineNo">195</span>  private void tryAdvanceEntry() throws IOException {<a name="line.195"></a>
-<span class="sourceLineNo">196</span>    if (checkReader()) {<a name="line.196"></a>
-<span class="sourceLineNo">197</span>      readNextEntryAndSetPosition();<a name="line.197"></a>
-<span class="sourceLineNo">198</span>      if (currentEntry == null) { // no more entries in this log file - see if log was rolled<a name="line.198"></a>
-<span class="sourceLineNo">199</span>        if (logQueue.size() &gt; 1) { // log was rolled<a name="line.199"></a>
-<span class="sourceLineNo">200</span>          // Before dequeueing, we should always get one more attempt at reading.<a name="line.200"></a>
-<span class="sourceLineNo">201</span>          // This is in case more entries came in after we opened the reader,<a name="line.201"></a>
-<span class="sourceLineNo">202</span>          // and a new log was enqueued while we were reading. See HBASE-6758<a name="line.202"></a>
-<span class="sourceLineNo">203</span>          resetReader();<a name="line.203"></a>
-<span class="sourceLineNo">204</span>          readNextEntryAndSetPosition();<a name="line.204"></a>
-<span class="sourceLineNo">205</span>          if (currentEntry == null) {<a name="line.205"></a>
-<span class="sourceLineNo">206</span>            if (checkAllBytesParsed()) { // now we're certain we're done with this log file<a name="line.206"></a>
-<span class="sourceLineNo">207</span>              dequeueCurrentLog();<a name="line.207"></a>
-<span class="sourceLineNo">208</span>              if (openNextLog()) {<a name="line.208"></a>
-<span class="sourceLineNo">209</span>                readNextEntryAndSetPosition();<a name="line.209"></a>
-<span class="sourceLineNo">210</span>              }<a name="line.210"></a>
-<span class="sourceLineNo">211</span>            }<a name="line.211"></a>
-<span class="sourceLineNo">212</span>          }<a name="line.212"></a>
-<span class="sourceLineNo">213</span>        } // no other logs, we've simply hit the end of the current open log. Do nothing<a name="line.213"></a>
-<span class="sourceLineNo">214</span>      }<a name="line.214"></a>
-<span class="sourceLineNo">215</span>    }<a name="line.215"></a>
-<span class="sourceLineNo">216</span>    // do nothing if we don't have a WAL Reader (e.g. if there's no logs in queue)<a name="line.216"></a>
-<span class="sourceLineNo">217</span>  }<a name="line.217"></a>
-<span class="sourceLineNo">218</span><a name="line.218"></a>
-<span class="sourceLineNo">219</span>  // HBASE-15984 check to see we have in fact parsed all data in a cleanly closed file<a name="line.219"></a>
-<span class="sourceLineNo">220</span>  private boolean checkAllBytesParsed() throws IOException {<a name="line.220"></a>
-<span class="sourceLineNo">221</span>    // -1 means the wal wasn't closed cleanly.<a name="line.221"></a>
-<span class="sourceLineNo">222</span>    final long trailerSize = currentTrailerSize();<a name="line.222"></a>
-<span class="sourceLineNo">223</span>    FileStatus stat = null;<a name="line.223"></a>
-<span class="sourceLineNo">224</span>    try {<a name="line.224"></a>
-<span class="sourceLineNo">225</span>      stat = fs.getFileStatus(this.currentPath);<a name="line.225"></a>
-<span class="sourceLineNo">226</span>    } catch (IOException exception) {<a name="line.226"></a>
-<span class="sourceLineNo">227</span>      LOG.warn("Couldn't get file length information about log " + this.currentPath + ", it "<a name="line.227"></a>
-<span class="sourceLineNo">228</span>          + (trailerSize &lt; 0 ? "was not" : "was") + " closed cleanly " + getCurrentPathStat());<a name="line.228"></a>
-<span class="sourceLineNo">229</span>      metrics.incrUnknownFileLengthForClosedWAL();<a name="line.229"></a>
-<span class="sourceLineNo">230</span>    }<a name="line.230"></a>
-<span class="sourceLineNo">231</span>    if (stat != null) {<a name="line.231"></a>
-<span class="sourceLineNo">232</span>      if (trailerSize &lt; 0) {<a name="line.232"></a>
-<span class="sourceLineNo">233</span>        if (currentPosition &lt; stat.getLen()) {<a name="line.233"></a>
-<span class="sourceLineNo">234</span>          final long skippedBytes = stat.getLen() - currentPosition;<a name="line.234"></a>
-<span class="sourceLineNo">235</span>          LOG.info("Reached the end of WAL file '" + currentPath<a name="line.235"></a>
-<span class="sourceLineNo">236</span>              + "'. It was not closed cleanly, so we did not parse " + skippedBytes<a name="line.236"></a>
-<span class="sourceLineNo">237</span>              + " bytes of data.");<a name="line.237"></a>
-<span class="sourceLineNo">238</span>          metrics.incrUncleanlyClosedWALs();<a name="line.238"></a>
-<span class="sourceLineNo">239</span>          metrics.incrBytesSkippedInUncleanlyClosedWALs(skippedBytes);<a name="line.239"></a>
-<span class="sourceLineNo">240</span>        }<a name="line.240"></a>
-<span class="sourceLineNo">241</span>      } else if (currentPosition + trailerSize &lt; stat.getLen()) {<a name="line.241"></a>
-<span class="sourceLineNo">242</span>        LOG.warn("Processing end of WAL file '" + currentPath + "'. At position " + currentPosition<a name="line.242"></a>
-<span class="sourceLineNo">243</span>            + ", which is too far away from reported file length " + stat.getLen()<a name="line.243"></a>
-<span class="sourceLineNo">244</span>            + ". Restarting WAL reading (see HBASE-15983 for details). " + getCurrentPathStat());<a name="line.244"></a>
-<span class="sourceLineNo">245</span>        setPosition(0);<a name="line.245"></a>
-<span class="sourceLineNo">246</span>        resetReader();<a name="line.246"></a>
-<span class="sourceLineNo">247</span>        metrics.incrRestartedWALReading();<a name="line.247"></a>
-<span class="sourceLineNo">248</span>        metrics.incrRepeatedFileBytes(currentPosition);<a name="line.248"></a>
-<span class="sourceLineNo">249</span>        return false;<a name="line.249"></a>
-<span class="sourceLineNo">250</span>      }<a name="line.250"></a>
-<span class="sourceLineNo">251</span>    }<a name="line.251"></a>
-<span class="sourceLineNo">252</span>    if (LOG.isTraceEnabled()) {<a name="line.252"></a>
-<span class="sourceLineNo">253</span>      LOG.trace("Reached the end of log " + this.currentPath + ", and the length of the file is "<a name="line.253"></a>
-<span class="sourceLineNo">254</span>          + (stat == null ? "N/A" : stat.getLen()));<a name="line.254"></a>
-<span class="sourceLineNo">255</span>    }<a name="line.255"></a>
-<span class="sourceLineNo">256</span>    metrics.incrCompletedWAL();<a name="line.256"></a>
-<span class="sourceLineNo">257</span>    return true;<a name="line.257"></a>
-<span class="sourceLineNo">258</span>  }<a name="line.258"></a>
-<span class="sourceLineNo">259</span><a name="line.259"></a>
-<span class="sourceLineNo">260</span>  private void dequeueCurrentLog() throws IOException {<a name="line.260"></a>
-<span class="sourceLineNo">261</span>    if (LOG.isDebugEnabled()) {<a name="line.261"></a>
-<span class="sourceLineNo">262</span>      LOG.debug("Reached the end of log " + currentPath);<a name="line.262"></a>
-<span class="sourceLineNo">263</span>    }<a name="line.263"></a>
-<span class="sourceLineNo">264</span>    closeReader();<a name="line.264"></a>
-<span class="sourceLineNo">265</span>    logQueue.remove();<a name="line.265"></a>
-<span class="sourceLineNo">266</span>    setPosition(0);<a name="line.266"></a>
-<span class="sourceLineNo">267</span>    metrics.decrSizeOfLogQueue();<a name="line.267"></a>
-<span class="sourceLineNo">268</span>  }<a name="line.268"></a>
-<span class="sourceLineNo">269</span><a name="line.269"></a>
-<span class="sourceLineNo">270</span>  private void readNextEntryAndSetPosition() throws IOException {<a name="line.270"></a>
-<span class="sourceLineNo">271</span>    Entry readEntry = reader.next();<a name="line.271"></a>
-<span class="sourceLineNo">272</span>    long readerPos = reader.getPosition();<a name="line.272"></a>
-<span class="sourceLineNo">273</span>    if (readEntry != null) {<a name="line.273"></a>
-<span class="sourceLineNo">274</span>      metrics.incrLogEditsRead();<a name="line.274"></a>
-<span class="sourceLineNo">275</span>      metrics.incrLogReadInBytes(readerPos - currentPosition);<a name="line.275"></a>
-<span class="sourceLineNo">276</span>    }<a name="line.276"></a>
-<span class="sourceLineNo">277</span>    currentEntry = readEntry; // could be null<a name="line.277"></a>
-<span class="sourceLineNo">278</span>    setPosition(readerPos);<a name="line.278"></a>
-<span class="sourceLineNo">279</span>  }<a name="line.279"></a>
-<span class="sourceLineNo">280</span><a name="line.280"></a>
-<span class="sourceLineNo">281</span>  private void closeReader() throws IOException {<a name="line.281"></a>
-<span class="sourceLineNo">282</span>    if (reader != null) {<a name="line.282"></a>
-<span class="sourceLineNo">283</span>      reader.close();<a name="line.283"></a>
-<span class="sourceLineNo">284</span>      reader = null;<a name="line.284"></a>
-<span class="sourceLineNo">285</span>    }<a name="line.285"></a>
-<span class="sourceLineNo">286</span>  }<a name="line.286"></a>
-<span class="sourceLineNo">287</span><a name="line.287"></a>
-<span class="sourceLineNo">288</span>  // if we don't have a reader, open a reader on the next log<a name="line.288"></a>
-<span class="sourceLineNo">289</span>  private boolean checkReader() throws IOException {<a name="line.289"></a>
-<span class="sourceLineNo">290</span>    if (reader == null) {<a name="line.290"></a>
-<span class="sourceLineNo">291</span>      return openNextLog();<a name="line.291"></a>
-<span class="sourceLineNo">292</span>    }<a name="line.292"></a>
-<span class="sourceLineNo">293</span>    return true;<a name="line.293"></a>
-<span class="sourceLineNo">294</span>  }<a name="line.294"></a>
-<span class="sourceLineNo">295</span><a name="line.295"></a>
-<span class="sourceLineNo">296</span>  // open a reader on the next log in queue<a name="line.296"></a>
-<span class="sourceLineNo">297</span>  private boolean openNextLog() throws IOException {<a name="line.297"></a>
-<span class="sourceLineNo">298</span>    Path nextPath = logQueue.peek();<a name="line.298"></a>
-<span class="sourceLineNo">299</span>    if (nextPath != null) {<a name="line.299"></a>
-<span class="sourceLineNo">300</span>      openReader(nextPath);<a name="line.300"></a>
-<span class="sourceLineNo">301</span>      if (reader != null) return true;<a name="line.301"></a>
-<span class="sourceLineNo">302</span>    }<a name="line.302"></a>
-<span class="sourceLineNo">303</span>    return false;<a name="line.303"></a>
-<span class="sourceLineNo">304</span>  }<a name="line.304"></a>
-<span class="sourceLineNo">305</span><a name="line.305"></a>
-<span class="sourceLineNo">306</span>  private Path getArchivedLog(Path path) throws IOException {<a name="line.306"></a>
-<span class="sourceLineNo">307</span>    Path rootDir = FSUtils.getRootDir(conf);<a name="line.307"></a>
-<span class="sourceLineNo">308</span>    Path oldLogDir = new Path(rootDir, HConstants.HREGION_OLDLOGDIR_NAME);<a name="line.308"></a>
-<span class="sourceLineNo">309</span>    Path archivedLogLocation = new Path(oldLogDir, path.getName());<a name="line.309"></a>
-<span class="sourceLineNo">310</span>    if (fs.exists(archivedLogLocation)) {<a name="line.310"></a>
-<span class="sourceLineNo">311</span>      LOG.info("Log " + path + " was moved to " + archivedLogLocation);<a name="line.311"></a>
-<span class="sourceLineNo">312</span>      return archivedLogLocation;<a name="line.312"></a>
-<span class="sourceLineNo">313</span>    } else {<a name="line.313"></a>
-<span class="sourceLineNo">314</span>      LOG.error("Couldn't locate log: " + path);<a name="line.314"></a>
-<span class="sourceLineNo">315</span>      return path;<a name="line.315"></a>
-<span class="sourceLineNo">316</span>    }<a name="line.316"></a>
-<span class="sourceLineNo">317</span>  }<a name="line.317"></a>
-<span class="sourceLineNo">318</span><a name="line.318"></a>
-<span class="sourceLineNo">319</span>  private void openReader(Path path) throws IOException {<a name="line.319"></a>
-<span class="sourceLineNo">320</span>    try {<a name="line.320"></a>
-<span class="sourceLineNo">321</span>      // Detect if this is a new file, if so get a new reader else<a name="line.321"></a>
-<span class="sourceLineNo">322</span>      // reset the current reader so that we see the new data<a name="line.322"></a>
-<span class="sourceLineNo">323</span>      if (reader == null || !getCurrentPath().equals(path)) {<a name="line.323"></a>
-<span class="sourceLineNo">324</span>        closeReader();<a name="line.324"></a>
-<span class="sourceLineNo">325</span>        reader = WALFactory.createReader(fs, path, conf);<a name="line.325"></a>
-<span class="sourceLineNo">326</span>        seek();<a name="line.326"></a>
-<span class="sourceLineNo">327</span>        setCurrentPath(path);<a name="line.327"></a>
-<span class="sourceLineNo">328</span>      } else {<a name="line.328"></a>
-<span class="sourceLineNo">329</span>        resetReader();<a name="line.329"></a>
-<span class="sourceLineNo">330</span>      }<a name="line.330"></a>
-<span class="sourceLineNo">331</span>    } catch (FileNotFoundException fnfe) {<a name="line.331"></a>
-<span class="sourceLineNo">332</span>      // If the log was archived, continue reading from there<a name="line.332"></a>
-<span class="sourceLineNo">333</span>      Path archivedLog = getArchivedLog(path);<a name="line.333"></a>
-<span class="sourceLineNo">334</span>      if (!path.equals(archivedLog)) {<a name="line.334"></a>
-<span class="sourceLineNo">335</span>        openReader(archivedLog);<a name="line.335"></a>
-<span class="sourceLineNo">336</span>      } else {<a name="line.336"></a>
-<span class="sourceLineNo">337</span>        throw fnfe;<a name="line.337"></a>
-<span class="sourceLineNo">338</span>      }<a name="line.338"></a>
-<span class="sourceLineNo">339</span>    } catch (LeaseNotRecoveredException lnre) {<a name="line.339"></a>
-<span class="sourceLineNo">340</span>      // HBASE-15019 the WAL was not closed due to some hiccup.<a name="line.340"></a>
-<span class="sourceLineNo">341</span>      LOG.warn("Try to recover the WAL lease " + currentPath, lnre);<a name="line.341"></a>
-<span class="sourceLineNo">342</span>      recoverLease(conf, currentPath);<a name="line.342"></a>
-<span class="sourceLineNo">343</span>      reader = null;<a name="line.343"></a>
-<span class="sourceLineNo">344</span>    } catch (NullPointerException npe) {<a name="line.344"></a>
-<span class="sourceLineNo">345</span>      // Workaround for race condition in HDFS-4380<a name="line.345"></a>
-<span class="sourceLineNo">346</span>      // which throws a NPE if we open a file before any data node has the most recent block<a name="line.346"></a>
-<span class="sourceLineNo">347</span>      // Just sleep and retry. Will require re-reading compressed WALs for compressionContext.<a name="line.347"></a>
-<span class="sourceLineNo">348</span>      LOG.warn("Got NPE opening reader, will retry.");<a name="line.348"></a>
-<span class="sourceLineNo">349</span>      reader = null;<a name="line.349"></a>
-<span class="sourceLineNo">350</span>    }<a name="line.350"></a>
-<span class="sourceLineNo">351</span>  }<a name="line.351"></a>
-<span class="sourceLineNo">352</span><a name="line.352"></a>
-<span class="sourceLineNo">353</span>  // For HBASE-15019<a name="line.353"></a>
-<span class="sourceLineNo">354</span>  private void recoverLease(final Configuration conf, final Path path) {<a name="line.354"></a>
-<span class="sourceLineNo">355</span>    try {<a name="line.355"></a>
-<span class="sourceLineNo">356</span>      final FileSystem dfs = FSUtils.getCurrentFileSystem(conf);<a name="line.356"></a>
-<span class="sourceLineNo">357</span>      FSUtils fsUtils = FSUtils.getInstance(dfs, conf);<a name="line.357"></a>
-<span class="sourceLineNo">358</span>      fsUtils.recoverFileLease(dfs, path, conf, new CancelableProgressable() {<a name="line.358"></a>
-<span class="sourceLineNo">359</span>        @Override<a name="line.359"></a>
-<span class="sourceLineNo">360</span>        public boolean progress() {<a name="line.360"></a>
-<span class="sourceLineNo">361</span>          LOG.debug("recover WAL lease: " + path);<a name="line.361"></a>
-<span class="sourceLineNo">362</span>          return true;<a name="line.362"></a>
-<span class="sourceLineNo">363</span>        }<a name="line.363"></a>
-<span class="sourceLineNo">364</span>      });<a name="line.364"></a>
-<span class="sourceLineNo">365</span>    } catch (IOException e) {<a name="line.365"></a>
-<span class="sourceLineNo">366</span>      LOG.warn("unable to recover lease for WAL: " + path, e);<a name="line.366"></a>
-<span class="sourceLineNo">367</span>    }<a name="line.367"></a>
-<span class="sourceLineNo">368</span>  }<a name="line.368"></a>
-<span class="sourceLineNo">369</span><a name="line.369"></a>
-<span class="sourceLineNo">370</span>  private void resetReader() throws IOException {<a name="line.370"></a>
-<span class="sourceLineNo">371</span>    try {<a name="line.371"></a>
-<span class="sourceLineNo">372</span>      reader.reset();<a name="line.372"></a>
-<span class="sourceLineNo">373</span>      seek();<a name="line.373"></a>
-<span class="sourceLineNo">374</span>    } catch (FileNotFoundException fnfe) {<a name="line.374"></a>
-<span class="sourceLineNo">375</span>      // If the log was archived, continue reading from there<a name="line.375"></a>
-<span class="sourceLineNo">376</span>      Path archivedLog = getArchivedLog(currentPath);<a name="line.376"></a>
-<span class="sourceLineNo">377</span>      if (!currentPath.equals(archivedLog)) {<a name="line.377"></a>
-<span class="sourceLineNo">378</span>        openReader(archivedLog);<a name="line.378"></a>
-<span class="sourceLineNo">379</span>      } else {<a name="line.379"></a>
-<span class="sourceLineNo">380</span>        throw fnfe;<a name="line.380"></a>
-<span class="sourceLineNo">381</span>      }<a name="line.381"></a>
-<span class="sourceLineNo">382</span>    } catch (NullPointerException npe) {<a name="line.382"></a>
-<span class="sourceLineNo">383</span>      throw new IOException("NPE resetting reader, likely HDFS-4380", npe);<a name="line.383"></a>
-<span class="sourceLineNo">384</span>    }<a name="line.384"></a>
-<span class="sourceLineNo">385</span>  }<a name="line.385"></a>
-<span class="sourceLineNo">386</span><a name="line.386"></a>
-<span class="sourceLineNo">387</span>  private void seek() throws IOException {<a name="line.387"></a>
-<span class="sourceLineNo">388</span>    if (currentPosition != 0) {<a name="line.388"></a>
-<span class="sourceLineNo">389</span>      reader.seek(currentPosition);<a name="line.389"></a>
-<span class="sourceLineNo">390</span>    }<a name="line.390"></a>
-<span class="sourceLineNo">391</span>  }<a name="line.391"></a>
-<span class="sourceLineNo">392</span><a name="line.392"></a>
-<span class="sourceLineNo">393</span>  private long currentTrailerSize() {<a name="line.393"></a>
-<span class="sourceLineNo">394</span>    long size = -1L;<a name="line.394"></a>
-<span class="sourceLineNo">395</span>    if (reader instanceof ProtobufLogReader) {<a name="line.395"></a>
-<span class="sourceLineNo">396</span>      final ProtobufLogReader pblr = (ProtobufLogReader) reader;<a name="line.396"></a>
-<span class="sourceLineNo">397</span>      size = pblr.trailerSize();<a name="line.397"></a>
+<span class="sourceLineNo">044</span>import org.apache.hadoop.ipc.RemoteException;<a name="line.44"></a>
+<span class="sourceLineNo">045</span><a name="line.45"></a>
+<span class="sourceLineNo">046</span>/**<a name="line.46"></a>
+<span class="sourceLineNo">047</span> * Streaming access to WAL entries. This class is given a queue of WAL {@link Path}, and continually<a name="line.47"></a>
+<span class="sourceLineNo">048</span> * iterates through all the WAL {@link Entry} in the queue. When it's done reading from a Path, it<a name="line.48"></a>
+<span class="sourceLineNo">049</span> * dequeues it and starts reading from the next.<a name="line.49"></a>
+<span class="sourceLineNo">050</span> */<a name="line.50"></a>
+<span class="sourceLineNo">051</span>@InterfaceAudience.Private<a name="line.51"></a>
+<span class="sourceLineNo">052</span>@InterfaceStability.Evolving<a name="line.52"></a>
+<span class="sourceLineNo">053</span>public class WALEntryStream implements Iterator&lt;Entry&gt;, Closeable, Iterable&lt;Entry&gt; {<a name="line.53"></a>
+<span class="sourceLineNo">054</span>  private static final Log LOG = LogFactory.getLog(WALEntryStream.class);<a name="line.54"></a>
+<span class="sourceLineNo">055</span><a name="line.55"></a>
+<span class="sourceLineNo">056</span>  private Reader reader;<a name="line.56"></a>
+<span class="sourceLineNo">057</span>  private Path currentPath;<a name="line.57"></a>
+<span class="sourceLineNo">058</span>  // cache of next entry for hasNext()<a name="line.58"></a>
+<span class="sourceLineNo">059</span>  private Entry currentEntry;<a name="line.59"></a>
+<span class="sourceLineNo">060</span>  // position after reading current entry<a name="line.60"></a>
+<span class="sourceLineNo">061</span>  private long currentPosition = 0;<a name="line.61"></a>
+<span class="sourceLineNo">062</span>  private PriorityBlockingQueue&lt;Path&gt; logQueue;<a name="line.62"></a>
+<span class="sourceLineNo">063</span>  private FileSystem fs;<a name="line.63"></a>
+<span class="sourceLineNo">064</span>  private Configuration conf;<a name="line.64"></a>
+<span class="sourceLineNo">065</span>  private MetricsSource metrics;<a name="line.65"></a>
+<span class="sourceLineNo">066</span><a name="line.66"></a>
+<span class="sourceLineNo">067</span>  /**<a name="line.67"></a>
+<span class="sourceLineNo">068</span>   * Create an entry stream over the given queue<a name="line.68"></a>
+<span class="sourceLineNo">069</span>   * @param logQueue the queue of WAL paths<a name="line.69"></a>
+<span class="sourceLineNo">070</span>   * @param fs {@link FileSystem} to use to create {@link Reader} for this stream<a name="line.70"></a>
+<span class="sourceLineNo">071</span>   * @param conf {@link Configuration} to use to create {@link Reader} for this stream<a name="line.71"></a>
+<span class="sourceLineNo">072</span>   * @param metrics replication metrics<a name="line.72"></a>
+<span class="sourceLineNo">073</span>   * @throws IOException<a name="line.73"></a>
+<span class="sourceLineNo">074</span>   */<a name="line.74"></a>
+<span class="sourceLineNo">075</span>  public WALEntryStream(PriorityBlockingQueue&lt;Path&gt; logQueue, FileSystem fs, Configuration conf,<a name="line.75"></a>
+<span class="sourceLineNo">076</span>      MetricsSource metrics)<a name="line.76"></a>
+<span class="sourceLineNo">077</span>      throws IOException {<a name="line.77"></a>
+<span class="sourceLineNo">078</span>    this(logQueue, fs, conf, 0, metrics);<a name="line.78"></a>
+<span class="sourceLineNo">079</span>  }<a name="line.79"></a>
+<span class="sourceLineNo">080</span><a name="line.80"></a>
+<span class="sourceLineNo">081</span>  /**<a name="line.81"></a>
+<span class="sourceLineNo">082</span>   * Create an entry stream over the given queue at the given start position<a name="line.82"></a>
+<span class="sourceLineNo">083</span>   * @param logQueue the queue of WAL paths<a name="line.83"></a>
+<span class="sourceLineNo">084</span>   * @param fs {@link FileSystem} to use to create {@link Reader} for this stream<a name="line.84"></a>
+<span class="sourceLineNo">085</span>   * @param conf {@link Configuration} to use to create {@link Reader} for this stream<a name="line.85"></a>
+<span class="sourceLineNo">086</span>   * @param startPosition the position in the first WAL to start reading at<a name="line.86"></a>
+<span class="sourceLineNo">087</span>   * @param metrics replication metrics<a name="line.87"></a>
+<span class="sourceLineNo">088</span>   * @throws IOException<a name="line.88"></a>
+<span class="sourceLineNo">089</span>   */<a name="line.89"></a>
+<span class="sourceLineNo">090</span>  public WALEntryStream(PriorityBlockingQueue&lt;Path&gt; logQueue, FileSystem fs, Configuration conf,<a name="line.90"></a>
+<span class="sourceLineNo">091</span>      long startPosition, MetricsSource metrics) throws IOException {<a name="line.91"></a>
+<span class="sourceLineNo">092</span>    this.logQueue = logQueue;<a name="line.92"></a>
+<span class="sourceLineNo">093</span>    this.fs = fs;<a name="line.93"></a>
+<span class="sourceLineNo">094</span>    this.conf = conf;<a name="line.94"></a>
+<span class="sourceLineNo">095</span>    this.currentPosition = startPosition;<a name="line.95"></a>
+<span class="sourceLineNo">096</span>    this.metrics = metrics;<a name="line.96"></a>
+<span class="sourceLineNo">097</span>  }<a name="line.97"></a>
+<span class="sourceLineNo">098</span><a name="line.98"></a>
+<span class="sourceLineNo">099</span>  /**<a name="line.99"></a>
+<span class="sourceLineNo">100</span>   * @return true if there is another WAL {@link Entry}<a name="line.100"></a>
+<span class="sourceLineNo">101</span>   * @throws WALEntryStreamRuntimeException if there was an Exception while reading<a name="line.101"></a>
+<span class="sourceLineNo">102</span>   */<a name="line.102"></a>
+<span class="sourceLineNo">103</span>  @Override<a name="line.103"></a>
+<span class="sourceLineNo">104</span>  public boolean hasNext() {<a name="line.104"></a>
+<span class="sourceLineNo">105</span>    if (currentEntry == null) {<a name="line.105"></a>
+<span class="sourceLineNo">106</span>      try {<a name="line.106"></a>
+<span class="sourceLineNo">107</span>        tryAdvanceEntry();<a name="line.107"></a>
+<span class="sourceLineNo">108</span>      } catch (Exception e) {<a name="line.108"></a>
+<span class="sourceLineNo">109</span>        throw new WALEntryStreamRuntimeException(e);<a name="line.109"></a>
+<span class="sourceLineNo">110</span>      }<a name="line.110"></a>
+<span class="sourceLineNo">111</span>    }<a name="line.111"></a>
+<span class="sourceLineNo">112</span>    return currentEntry != null;<a name="line.112"></a>
+<span class="sourceLineNo">113</span>  }<a name="line.113"></a>
+<span class="sourceLineNo">114</span><a name="line.114"></a>
+<span class="sourceLineNo">115</span>  /**<a name="line.115"></a>
+<span class="sourceLineNo">116</span>   * @return the next WAL entry in this stream<a name="line.116"></a>
+<span class="sourceLineNo">117</span>   * @throws WALEntryStreamRuntimeException if there was an IOException<a name="line.117"></a>
+<span class="sourceLineNo">118</span>   * @throws NoSuchElementException if no more entries in the stream.<a name="line.118"></a>
+<span class="sourceLineNo">119</span>   */<a name="line.119"></a>
+<span class="sourceLineNo">120</span>  @Override<a name="line.120"></a>
+<span class="sourceLineNo">121</span>  public Entry next() {<a name="line.121"></a>
+<span class="sourceLineNo">122</span>    if (!hasNext()) throw new NoSuchElementException();<a name="line.122"></a>
+<span class="sourceLineNo">123</span>    Entry save = currentEntry;<a name="line.123"></a>
+<span class="sourceLineNo">124</span>    currentEntry = null; // gets reloaded by hasNext()<a name="line.124"></a>
+<span class="sourceLineNo">125</span>    return save;<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">128</span>  /**<a name="line.128"></a>
+<span class="sourceLineNo">129</span>   * Not supported.<a name="line.129"></a>
+<span class="sourceLineNo">130</span>   */<a name="line.130"></a>
+<span class="sourceLineNo">131</span>  @Override<a name="line.131"></a>
+<span class="sourceLineNo">132</span>  public void remove() {<a name="line.132"></a>
+<span class="sourceLineNo">133</span>    throw new UnsupportedOperationException();<a name="line.133"></a>
+<span class="sourceLineNo">134</span>  }<a name="line.134"></a>
+<span class="sourceLineNo">135</span><a name="line.135"></a>
+<span class="sourceLineNo">136</span>  /**<a name="line.136"></a>
+<span class="sourceLineNo">137</span>   * {@inheritDoc}<a name="line.137"></a>
+<span class="sourceLineNo">138</span>   */<a name="line.138"></a>
+<span class="sourceLineNo">139</span>  @Override<a name="line.139"></a>
+<span class="sourceLineNo">140</span>  public void close() throws IOException {<a name="line.140"></a>
+<span class="sourceLineNo">141</span>    closeReader();<a name="line.141"></a>
+<span class="sourceLineNo">142</span>  }<a name="line.142"></a>
+<span class="sourceLineNo">143</span><a name="line.143"></a>
+<span class="sourceLineNo">144</span>  /**<a name="line.144"></a>
+<span class="sourceLineNo">145</span>   * @return the iterator over WAL entries in the queue.<a name="line.145"></a>
+<span class="sourceLineNo">146</span>   */<a name="line.146"></a>
+<span class="sourceLineNo">147</span>  @Override<a name="line.147"></a>
+<span class="sourceLineNo">148</span>  public Iterator&lt;Entry&gt; iterator() {<a name="line.148"></a>
+<span class="sourceLineNo">149</span>    return this;<a name="line.149"></a>
+<span class="sourceLineNo">150</span>  }<a name="line.150"></a>
+<span class="sourceLineNo">151</span><a name="line.151"></a>
+<span class="sourceLineNo">152</span>  /**<a name="line.152"></a>
+<span class="sourceLineNo">153</span>   * @return the position of the last Entry returned by next()<a name="line.153"></a>
+<span class="sourceLineNo">154</span>   */<a name="line.154"></a>
+<span class="sourceLineNo">155</span>  public long getPosition() {<a name="line.155"></a>
+<span class="sourceLineNo">156</span>    return currentPosition;<a name="line.156"></a>
+<span class="sourceLineNo">157</span>  }<a name="line.157"></a>
+<span class="sourceLineNo">158</span><a name="line.158"></a>
+<span class="sourceLineNo">159</span>  /**<a name="line.159"></a>
+<span class="sourceLineNo">160</span>   * @return the {@link Path} of the current WAL<a name="line.160"></a>
+<span class="sourceLineNo">161</span>   */<a name="line.161"></a>
+<span class="sourceLineNo">162</span>  public Path getCurrentPath() {<a name="line.162"></a>
+<span class="sourceLineNo">163</span>    return currentPath;<a name="line.163"></a>
+<span class="sourceLineNo">164</span>  }<a name="line.164"></a>
+<span class="sourceLineNo">165</span><a name="line.165"></a>
+<span class="sourceLineNo">166</span>  private String getCurrentPathStat() {<a name="line.166"></a>
+<span class="sourceLineNo">167</span>    StringBuilder sb = new StringBuilder();<a name="line.167"></a>
+<span class="sourceLineNo">168</span>    if (currentPath != null) {<a name="line.168"></a>
+<span class="sourceLineNo">169</span>      sb.append("currently replicating from: ").append(currentPath).append(" at position: ")<a name="line.169"></a>
+<span class="sourceLineNo">170</span>          .append(currentPosition).append("\n");<a name="line.170"></a>
+<span class="sourceLineNo">171</span>    } else {<a name="line.171"></a>
+<span class="sourceLineNo">172</span>      sb.append("no replication ongoing, waiting for new log");<a name="line.172"></a>
+<span class="sourceLineNo">173</span>    }<a name="line.173"></a>
+<span class="sourceLineNo">174</span>    return sb.toString();<a name="line.174"></a>
+<span class="sourceLineNo">175</span>  }<a name="line.175"></a>
+<span class="sourceLineNo">176</span><a name="line.176"></a>
+<span class="sourceLineNo">177</span>  /**<a name="line.177"></a>
+<span class="sourceLineNo">178</span>   * Should be called if the stream is to be reused (i.e. used again after hasNext() has returned<a name="line.178"></a>
+<span class="sourceLineNo">179</span>   * false)<a name="line.179"></a>
+<span class="sourceLineNo">180</span>   * @throws IOException<a name="line.180"></a>
+<span class="sourceLineNo">181</span>   */<a name="line.181"></a>
+<span class="sourceLineNo">182</span>  public void reset() throws IOException {<a name="line.182"></a>
+<span class="sourceLineNo">183</span>    if (reader != null &amp;&amp; currentPath != null) {<a name="line.183"></a>
+<span class="sourceLineNo">184</span>      resetReader();<a name="line.184"></a>
+<span class="sourceLineNo">185</span>    }<a name="line.185"></a>
+<span class="sourceLineNo">186</span>  }<a name="line.186"></a>
+<span class="sourceLineNo">187</span><a name="line.187"></a>
+<span class="sourceLineNo">188</span>  private void setPosition(long position) {<a name="line.188"></a>
+<span class="sourceLineNo">189</span>    currentPosition = position;<a name="line.189"></a>
+<span class="sourceLineNo">190</span>  }<a name="line.190"></a>
+<span class="sourceLineNo">191</span><a name="line.191"></a>
+<span class="sourceLineNo">192</span>  private void setCurrentPath(Path path) {<a name="line.192"></a>
+<span class="sourceLineNo">193</span>    this.currentPath = path;<a name="line.193"></a>
+<span class="sourceLineNo">194</span>  }<a name="line.194"></a>
+<span class="sourceLineNo">195</span><a name="line.195"></a>
+<span class="sourceLineNo">196</span>  private void tryAdvanceEntry() throws IOException {<a name="line.196"></a>
+<span class="sourceLineNo">197</span>    if (checkReader()) {<a name="line.197"></a>
+<span class="sourceLineNo">198</span>      readNextEntryAndSetPosition();<a name="line.198"></a>
+<span class="sourceLineNo">199</span>      if (currentEntry == null) { // no more entries in this log file - see if log was rolled<a name="line.199"></a>
+<span class="sourceLineNo">200</span>        if (logQueue.size() &gt; 1) { // log was rolled<a name="line.200"></a>
+<span class="sourceLineNo">201</span>          // Before dequeueing, we should always get one more attempt at reading.<a name="line.201"></a>
+<span class="sourceLineNo">202</span>          // This is in case more entries came in after we opened the reader,<a name="line.202"></a>
+<span class="sourceLineNo">203</span>          // and a new log was enqueued while we were reading. See HBASE-6758<a name="line.203"></a>
+<span class="sourceLineNo">204</span>          resetReader();<a name="line.204"></a>
+<span class="sourceLineNo">205</span>          readNextEntryAndSetPosition();<a name="line.205"></a>
+<span class="sourceLineNo">206</span>          if (currentEntry == null) {<a name="line.206"></a>
+<span class="sourceLineNo">207</span>            if (checkAllBytesParsed()) { // now we're certain we're done with this log file<a name="line.207"></a>
+<span class="sourceLineNo">208</span>              dequeueCurrentLog();<a name="line.208"></a>
+<span class="sourceLineNo">209</span>              if (openNextLog()) {<a name="line.209"></a>
+<span class="sourceLineNo">210</span>                readNextEntryAndSetPosition();<a name="line.210"></a>
+<span class="sourceLineNo">211</span>              }<a name="line.211"></a>
+<span class="sourceLineNo">212</span>            }<a name="line.212"></a>
+<span class="sourceLineNo">213</span>          }<a name="line.213"></a>
+<span class="sourceLineNo">214</span>        } // no other logs, we've simply hit the end of the current open log. Do nothing<a name="line.214"></a>
+<span class="sourceLineNo">215</span>      }<a name="line.215"></a>
+<span class="sourceLineNo">216</span>    }<a name="line.216"></a>
+<span class="sourceLineNo">217</span>    // do nothing if we don't have a WAL Reader (e.g. if there's no logs in queue)<a name="line.217"></a>
+<span class="sourceLineNo">218</span>  }<a name="line.218"></a>
+<span class="sourceLineNo">219</span><a name="line.219"></a>
+<span class="sourceLineNo">220</span>  // HBASE-15984 check to see we have in fact parsed all data in a cleanly closed file<a name="line.220"></a>
+<span class="sourceLineNo">221</span>  private boolean checkAllBytesParsed() throws IOException {<a name="line.221"></a>
+<span class="sourceLineNo">222</span>    // -1 means the wal wasn't closed cleanly.<a name="line.222"></a>
+<span class="sourceLineNo">223</span>    final long trailerSize = currentTrailerSize();<a name="line.223"></a>
+<span class="sourceLineNo">224</span>    FileStatus stat = null;<a name="line.224"></a>
+<span class="sourceLineNo">225</span>    try {<a name="line.225"></a>
+<span class="sourceLineNo">226</span>      stat = fs.getFileStatus(this.currentPath);<a name="line.226"></a>
+<span class="sourceLineNo">227</span>    } catch (IOException exception) {<a name="line.227"></a>
+<span class="sourceLineNo">228</span>      LOG.warn("Couldn't get file length information about log " + this.currentPath + ", it "<a name="line.228"></a>
+<span class="sourceLineNo">229</span>          + (trailerSize &lt; 0 ? "was not" : "was") + " closed cleanly " + getCurrentPathStat());<a name="line.229"></a>
+<span class="sourceLineNo">230</span>      metrics.incrUnknownFileLengthForClosedWAL();<a name="line.230"></a>
+<span class="sourceLineNo">231</span>    }<a name="line.231"></a>
+<span class="sourceLineNo">232</span>    if (stat != null) {<a name="line.232"></a>
+<span class="sourceLineNo">233</span>      if (trailerSize &lt; 0) {<a name="line.233"></a>
+<span class="sourceLineNo">234</span>        if (currentPosition &lt; stat.getLen()) {<a name="line.234"></a>
+<span class="sourceLineNo">235</span>          final long skippedBytes = stat.getLen() - currentPosition;<a name="line.235"></a>
+<span class="sourceLineNo">236</span>          LOG.info("Reached the end of WAL file '" + currentPath<a name="line.236"></a>
+<span class="sourceLineNo">237</span>              + "'. It was not closed cleanly, so we did not parse " + skippedBytes<a name="line.237"></a>
+<span class="sourceLineNo">238</span>              + " bytes of data.");<a name="line.238"></a>
+<span class="sourceLineNo">239</span>          metrics.incrUncleanlyClosedWALs();<a name="line.239"></a>
+<span class="sourceLineNo">240</span>          metrics.incrBytesSkippedInUncleanlyClosedWALs(skippedBytes);<a name="line.240"></a>
+<span class="sourceLineNo">241</span>        }<a name="line.241"></a>
+<span class="sourceLineNo">242</span>      } else if (currentPosition + trailerSize &lt; stat.getLen()) {<a name="line.242"></a>
+<span class="sourceLineNo">243</span>        LOG.warn("Processing end of WAL file '" + currentPath + "'. At position " + currentPosition<a name="line.243"></a>
+<span class="sourceLineNo">244</span>            + ", which is too far away from reported file length " + stat.getLen()<a name="line.244"></a>
+<span class="sourceLineNo">245</span>            + ". Restarting WAL reading (see HBASE-15983 for details). " + getCurrentPathStat());<a name="line.245"></a>
+<span class="sourceLineNo">246</span>        setPosition(0);<a name="line.246"></a>
+<span class="sourceLineNo">247</span>        resetReader();<a name="line.247"></a>
+<span class="sourceLineNo">248</span>        metrics.incrRestartedWALReading();<a name="line.248"></a>
+<span class="sourceLineNo">249</span>        metrics.incrRepeatedFileBytes(currentPosition);<a name="line.249"></a>
+<span class="sourceLineNo">250</span>        return false;<a name="line.250"></a>
+<span class="sourceLineNo">251</span>      }<a name="line.251"></a>
+<span class="sourceLineNo">252</span>    }<a name="line.252"></a>
+<span class="sourceLineNo">253</span>    if (LOG.isTraceEnabled()) {<a name="line.253"></a>
+<span class="sourceLineNo">254</span>      LOG.trace("Reached the end of log " + this.currentPath + ", and the length of the file is "<a name="line.254"></a>
+<span class="sourceLineNo">255</span>          + (stat == null ? "N/A" : stat.getLen()));<a name="line.255"></a>
+<span class="sourceLineNo">256</span>    }<a name="line.256"></a>
+<span class="sourceLineNo">257</span>    metrics.incrCompletedWAL();<a name="line.257"></a>
+<span class="sourceLineNo">258</span>    return true;<a name="line.258"></a>
+<span class="sourceLineNo">259</span>  }<a name="line.259"></a>
+<span class="sourceLineNo">260</span><a name="line.260"></a>
+<span class="sourceLineNo">261</span>  private void dequeueCurrentLog() throws IOException {<a name="line.261"></a>
+<span class="sourceLineNo">262</span>    if (LOG.isDebugEnabled()) {<a name="line.262"></a>
+<span class="sourceLineNo">263</span>      LOG.debug("Reached the end of log " + currentPath);<a name="line.263"></a>
+<span class="sourceLineNo">264</span>    }<a name="line.264"></a>
+<span class="sourceLineNo">265</span>    closeReader();<a name="line.265"></a>
+<span class="sourceLineNo">266</span>    logQueue.remove();<a name="line.266"></a>
+<span class="sourceLineNo">267</span>    setPosition(0);<a name="line.267"></a>
+<span class="sourceLineNo">268</span>    metrics.decrSizeOfLogQueue();<a name="line.268"></a>
+<span class="sourceLineNo">269</span>  }<a name="line.269"></a>
+<span class="sourceLineNo">270</span><a name="line.270"></a>
+<span class="sourceLineNo">271</span>  private void readNextEntryAndSetPosition() throws IOException {<a name="line.271"></a>
+<span class="sourceLineNo">272</span>    Entry readEntry = reader.next();<a name="line.272"></a>
+<span class="sourceLineNo">273</span>    long readerPos = reader.getPosition();<a name="line.273"></a>
+<span class="sourceLineNo">274</span>    if (readEntry != null) {<a name="line.274"></a>
+<span class="sourceLineNo">275</span>      metrics.incrLogEditsRead();<a name="line.275"></a>
+<span class="sourceLineNo">276</span>      metrics.incrLogReadInBytes(readerPos - currentPosition);<a name="line.276"></a>
+<span class="sourceLineNo">277</span>    }<a name="line.277"></a>
+<span class="sourceLineNo">278</span>    currentEntry = readEntry; // could be null<a name="line.278"></a>
+<span class="sourceLineNo">279</span>    setPosition(readerPos);<a name="line.279"></a>
+<span class="sourceLineNo">280</span>  }<a name="line.280"></a>
+<span class="sourceLineNo">281</span><a name="line.281"></a>
+<span class="sourceLineNo">282</span>  private void closeReader() throws IOException {<a name="line.282"></a>
+<span class="sourceLineNo">283</span>    if (reader != null) {<a name="line.283"></a>
+<span class="sourceLineNo">284</span>      reader.close();<a name="line.284"></a>
+<span class="sourceLineNo">285</span>      reader = null;<a name="line.285"></a>
+<span class="sourceLineNo">286</span>    }<a name="line.286"></a>
+<span class="sourceLineNo">287</span>  }<a name="line.287"></a>
+<span class="sourceLineNo">288</span><a name="line.288"></a>
+<span class="sourceLineNo">289</span>  // if we don't have a reader, open a reader on the next log<a name="line.289"></a>
+<span class="sourceLineNo">290</span>  private boolean checkReader() throws IOException {<a name="line.290"></a>
+<span class="sourceLineNo">291</span>    if (reader == null) {<a name="line.291"></a>
+<span class="sourceLineNo">292</span>      return openNextLog();<a name="line.292"></a>
+<span class="sourceLineNo">293</span>    }<a name="line.293"></a>
+<span class="sourceLineNo">294</span>    return true;<a name="line.294"></a>
+<span class="sourceLineNo">295</span>  }<a name="line.295"></a>
+<span class="sourceLineNo">296</span><a name="line.296"></a>
+<span class="sourceLineNo">297</span>  // open a reader on the next log in queue<a name="line.297"></a>
+<span class="sourceLineNo">298</span>  private boolean openNextLog() throws IOException {<a name="line.298"></a>
+<span class="sourceLineNo">299</span>    Path nextPath = logQueue.peek();<a name="line.299"></a>
+<span class="sourceLineNo">300</span>    if (nextPath != null) {<a name="line.300"></a>
+<span class="sourceLineNo">301</span>      openReader(nextPath);<a name="line.301"></a>
+<span class="sourceLineNo">302</span>      if (reader != null) return true;<a name="line.302"></a>
+<span class="sourceLineNo">303</span>    }<a name="line.303"></a>
+<span class="sourceLineNo">304</span>    return false;<a name="line.304"></a>
+<span class="sourceLineNo">305</span>  }<a name="line.305"></a>
+<span class="sourceLineNo">306</span><a name="line.306"></a>
+<span class="sourceLineNo">307</span>  private Path getArchivedLog(Path path) throws IOException {<a name="line.307"></a>
+<span class="sourceLineNo">308</span>    Path rootDir = FSUtils.getRootDir(conf);<a name="line.308"></a>
+<span class="sourceLineNo">309</span>    Path oldLogDir = new Path(rootDir, HConstants.HREGION_OLDLOGDIR_NAME);<a name="line.309"></a>
+<span class="sourceLineNo">310</span>    Path archivedLogLocation = new Path(oldLogDir, path.getName());<a name="line.310"></a>
+<span class="sourceLineNo">311</span>    if (fs.exists(archivedLogLocation)) {<a name="line.311"></a>
+<span class="sourceLineNo">312</span>      LOG.info("Log " + path + " was moved to " + archivedLogLocation);<a name="line.312"></a>
+<span class="sourceLineNo">313</span>      return archivedLogLocation;<a name="line.313"></a>
+<span class="sourceLineNo">314</span>    } else {<a name="line.314"></a>
+<span class="sourceLineNo">315</span>      LOG.error("Couldn't locate log: " + path);<a name="line.315"></a>
+<span class="sourceLineNo">316</span>      return path;<a name="line.316"></a>
+<span class="sourceLineNo">317</span>    }<a name="line.317"></a>
+<span class="sourceLineNo">318</span>  }<a name="line.318"></a>
+<span class="sourceLineNo">319</span><a name="line.319"></a>
+<span class="sourceLineNo">320</span>  private void handleFileNotFound(Path path, FileNotFoundException fnfe) throws IOException {<a name="line.320"></a>
+<span class="sourceLineNo">321</span>    // If the log was archived, continue reading from there<a name="line.321"></a>
+<span class="sourceLineNo">322</span>    Path archivedLog = getArchivedLog(path);<a name="line.322"></a>
+<span class="sourceLineNo">323</span>    if (!path.equals(archivedLog)) {<a name="line.323"></a>
+<span class="sourceLineNo">324</span>      openReader(archivedLog);<a name="line.324"></a>
+<span class="sourceLineNo">325</span>    } else {<a name="line.325"></a>
+<span class="sourceLineNo">326</span>      throw fnfe;<a name="line.326"></a>
+<span class="sourceLineNo">327</span>    }<a name="line.327"></a>
+<span class="sourceLineNo">328</span>  }<a name="line.328"></a>
+<span class="sourceLineNo">329</span>  private void openReader(Path path) throws IOException {<a name="line.329"></a>
+<span class="sourceLineNo">330</span>    try {<a name="line.330"></a>
+<span class="sourceLineNo">331</span>      // Detect if this is a new file, if so get a new reader else<a name="line.331"></a>
+<span class="sourceLineNo">332</span>      // reset the current reader so that we see the new data<a name="line.332"></a>
+<span class="sourceLineNo">333</span>      if (reader == null || !getCurrentPath().equals(path)) {<a name="line.333"></a>
+<span class="sourceLineNo">334</span>        closeReader();<a name="line.334"></a>
+<span class="sourceLineNo">335</span>        reader = WALFactory.createReader(fs, path, conf);<a name="line.335"></a>
+<span class="sourceLineNo">336</span>        seek();<a name="line.336"></a>
+<span class="sourceLineNo">337</span>        setCurrentPath(path);<a name="line.337"></a>
+<span class="sourceLineNo">338</span>      } else {<a name="line.338"></a>
+<span class="sourceLineNo">339</span>        resetReader();<a name="line.339"></a>
+<span class="sourceLineNo">340</span>      }<a name="line.340"></a>
+<span class="sourceLineNo">341</span>    } catch (FileNotFoundException fnfe) {<a name="line.341"></a>
+<span class="sourceLineNo">342</span>      handleFileNotFound(path, fnfe);<a name="line.342"></a>
+<span class="sourceLineNo">343</span>    }  catch (RemoteException re) {<a name="line.343"></a>
+<span class="sourceLineNo">344</span>      IOException ioe = re.unwrapRemoteException(FileNotFoundException.class);<a name="line.344"></a>
+<span class="sourceLineNo">345</span>      if (!(ioe instanceof FileNotFoundException)) throw ioe;<a name="line.345"></a>
+<span class="sourceLineNo">346</span>      handleFileNotFound(path, (FileNotFoundException)ioe);<a name="line.346"></a>
+<span class="sourceLineNo">347</span>    } catch (LeaseNotRecoveredException lnre) {<a name="line.347"></a>
+<span class="sourceLineNo">348</span>      // HBASE-15019 the WAL was not closed due to some hiccup.<a name="line.348"></a>
+<span class="sourceLineNo">349</span>      LOG.warn("Try to recover the WAL lease " + currentPath, lnre);<a name="line.349"></a>
+<span class="sourceLineNo">350</span>      recoverLease(conf, currentPath);<a name="line.350"></a>
+<span class="sourceLineNo">351</span>      reader = null;<a name="line.351"></a>
+<span class="sourceLineNo">352</span>    } catch (NullPointerException npe) {<a name="line.352"></a>
+<span class="sourceLineNo">353</span>      // Workaround for race condition in HDFS-4380<a name="line.353"></a>
+<span class="sourceLineNo">354</span>      // which throws a NPE if we open a file before any data node has the most recent block<a name="line.354"></a>
+<span class="sourceLineNo">355</span>      // Just sleep and retry. Will require re-reading compressed WALs for compressionContext.<a name="line.355"></a>
+<span class="sourceLineNo">356</span>      LOG.warn("Got NPE opening reader, will retry.");<a name="line.356"></a>
+<span class="sourceLineNo">357</span>      reader = null;<a name="line.357"></a>
+<span class="sourceLineNo">358</span>    }<a name="line.358"></a>
+<span class="sourceLineNo">359</span>  }<a name="line.359"></a>
+<span class="sourceLineNo">360</span><a name="line.360"></a>
+<span class="sourceLineNo">361</span>  // For HBASE-15019<a name="line.361"></a>
+<span class="sourceLineNo">362</span>  private void recoverLease(final Configuration conf, final Path path) {<a name="line.362"></a>
+<span class="sourceLineNo">363</span>    try {<a name="line.363"></a>
+<span class="sourceLineNo">364</span>      final FileSystem dfs = FSUtils.getCurrentFileSystem(conf);<a name="line.364"></a>
+<span class="sourceLineNo">365</span>      FSUtils fsUtils = FSUtils.getInstance(dfs, conf);<a name="line.365"></a>
+<span class="sourceLineNo">366</span>      fsUtils.recoverFileLease(dfs, path, conf, new CancelableProgressable() {<a name="line.366"></a>
+<span class="sourceLineNo">367</span>        @Override<a name="line.367"></a>
+<span class="sourceLineNo">368</span>        public boolean progress() {<a name="line.368"></a>
+<span class="sourceLineNo">369</span>          LOG.debug("recover WAL lease: " + path);<a name="line.369"></a>
+<span class="sourceLineNo">370</span>          return true;<a name="line.370"></a>
+<span class="sourceLineNo">371</span>        }<a name="line.371"></a>
+<span class="sourceLineNo">372</span>      });<a name="line.372"></a>
+<span class="sourceLineNo">373</span>    } catch (IOException e) {<a name="line.373"></a>
+<span class="sourceLineNo">374</span>      LOG.warn("unable to recover lease for WAL: " + path, e);<a name="line.374"></a>
+<span class="sourceLineNo">375</span>    }<a name="line.375"></a>
+<span class="sourceLineNo">376</span>  }<a name="line.376"></a>
+<span class="sourceLineNo">377</span><a name="line.377"></a>
+<span class="sourceLineNo">378</span>  private void resetReader() throws IOException {<a name="line.378"></a>
+<span class="sourceLineNo">379</span>    try {<a name="line.379"></a>
+<span class="sourceLineNo">380</span>      reader.reset();<a name="line.380"></a>
+<span class="sourceLineNo">381</span>      seek();<a name="line.381"></a>
+<span class="sourceLineNo">382</span>    } catch (FileNotFoundException fnfe) {<a name="line.382"></a>
+<span class="sourceLineNo">383</span>      // If the log was archived, continue reading from there<a name="line.383"></a>
+<span class="sourceLineNo">384</span>      Path archivedLog = getArchivedLog(currentPath);<a name="line.384"></a>
+<span class="sourceLineNo">385</span>      if (!currentPath.equals(archivedLog)) {<a name="line.385"></a>
+<span class="sourceLineNo">386</span>        openReader(archivedLog);<a name="line.386"></a>
+<span class="sourceLineNo">387</span>      } else {<a name="line.387"></a>
+<span class="sourceLineNo">388</span>        throw fnfe;<a name="line.388"></a>
+<span class="sourceLineNo">389</span>      }<a name="line.389"></a>
+<span class="sourceLineNo">390</span>    } catch (NullPointerException npe) {<a name="line.390"></a>
+<span class="sourceLineNo">391</span>      throw new IOException("NPE resetting reader, likely HDFS-4380", npe);<a name="line.391"></a>
+<span class="sourceLineNo">392</span>    }<a name="line.392"></a>
+<span class="sourceLineNo">393</span>  }<a name="line.393"></a>
+<span class="sourceLineNo">394</span><a name="line.394"></a>
+<span class="sourceLineNo">395</span>  private void seek() throws IOException {<a name="line.395"></a>
+<span class="sourceLineNo">396</span>    if (currentPosition != 0) {<a name="line.396"></a>
+<span class="sourceLineNo">397</span>      reader.seek(currentPosition);<a name="line.397"></a>
 <span class="sourceLineNo">398</span>    }<a name="line.398"></a>
-<span class="sourceLineNo">399</span>    return size;<a name="line.399"></a>
-<span class="sourceLineNo">400</span>  }<a name="line.400"></a>
-<span class="sourceLineNo">401</span><a name="line.401"></a>
-<span class="sourceLineNo">402</span>  @InterfaceAudience.Private<a name="line.402"></a>
-<span class="sourceLineNo">403</span>  public static class WALEntryStreamRuntimeException extends RuntimeException {<a name="line.403"></a>
-<span class="sourceLineNo">404</span>    private static final long serialVersionUID = -6298201811259982568L;<a name="line.404"></a>
-<span class="sourceLineNo">405</span><a name="line.405"></a>
-<span class="sourceLineNo">406</span>    public WALEntryStreamRuntimeException(Exception e) {<a name="line.406"></a>
-<span class="sourceLineNo">407</span>      super(e);<a name="line.407"></a>
-<span class="sourceLineNo">408</span>    }<a name="line.408"></a>
-<span class="sourceLineNo">409</span>  }<a name="line.409"></a>
-<span class="sourceLineNo">410</span><a name="line.410"></a>
-<span class="sourceLineNo">411</span>}<a name="line.411"></a>
+<span class="sourceLineNo">399</span>  }<a name="line.399"></a>
+<span class="sourceLineNo">400</span><a name="line.400"></a>
+<span class="sourceLineNo">401</span>  private long currentTrailerSize() {<a name="line.401"></a>
+<span class="sourceLineNo">402</span>    long size = -1L;<a name="line.402"></a>
+<span class="sourceLineNo">403</span>    if (reader instanceof ProtobufLogReader) {<a name="line.403"></a>
+<span class="sourceLineNo">404</span>      final ProtobufLogReader pblr = (ProtobufLogReader) reader;<a name="line.404"></a>
+<span class="sourceLineNo">405</span>      size = pblr.trailerSize();<a name="line.405"></a>
+<span class="sourceLineNo">406</span>    }<a name="line.406"></a>
+<span class="sourceLineNo">407</span>    return size;<a name="line.407"></a>
+<span class="sourceLineNo">408</span>  }<a name="line.408"></a>
+<span class="sourceLineNo">409</span><a name="line.409"></a>
+<span class="sourceLineNo">410</span>  @InterfaceAudience.Private<a name="line.410"></a>
+<span class="sourceLineNo">411</span>  public static class WALEntryStreamRuntimeException extends RuntimeException {<a name="line.411"></a>
+<span class="sourceLineNo">412</span>    private static final long serialVersionUID = -6298201811259982568L;<a name="line.412"></a>
+<span class="sourceLineNo">413</span><a name="line.413"></a>
+<span class="sourceLineNo">414</span>    public WALEntryStreamRuntimeException(Exception e) {<a name="line.414"></a>
+<span class="sourceLineNo">415</span>      super(e);<a name="line.415"></a>
+<span class="sourceLineNo">416</span>    }<a name="line.416"></a>
+<span class="sourceLineNo">417</span>  }<a name="line.417"></a>
+<span class="sourceLineNo">418</span><a name="line.418"></a>
+<span class="sourceLineNo">419</span>}<a name="line.419"></a>
 
 
 

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/export_control.html
----------------------------------------------------------------------
diff --git a/export_control.html b/export_control.html
index dfc5e11..c4259e4 100644
--- a/export_control.html
+++ b/export_control.html
@@ -7,7 +7,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache HBase &#x2013; 
       Export Control
@@ -336,7 +336,7 @@ for more details.</p>
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.      
                     
-                  <li id="publishDate" class="pull-right">Last Published: 2017-07-16</li>
+                  <li id="publishDate" class="pull-right">Last Published: 2017-07-18</li>
             </p>
                 </div>
 

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/checkstyle.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/checkstyle.html b/hbase-annotations/checkstyle.html
index 445789c..814e066 100644
--- a/hbase-annotations/checkstyle.html
+++ b/hbase-annotations/checkstyle.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/dependencies.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/dependencies.html b/hbase-annotations/dependencies.html
index a3860b2..bddb27a 100644
--- a/hbase-annotations/dependencies.html
+++ b/hbase-annotations/dependencies.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/dependency-convergence.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/dependency-convergence.html b/hbase-annotations/dependency-convergence.html
index 54d270c..1f5a8b1 100644
--- a/hbase-annotations/dependency-convergence.html
+++ b/hbase-annotations/dependency-convergence.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/dependency-info.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/dependency-info.html b/hbase-annotations/dependency-info.html
index 0643aaf..22008ca 100644
--- a/hbase-annotations/dependency-info.html
+++ b/hbase-annotations/dependency-info.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/dependency-management.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/dependency-management.html b/hbase-annotations/dependency-management.html
index 1ce7e28..687d730 100644
--- a/hbase-annotations/dependency-management.html
+++ b/hbase-annotations/dependency-management.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/index.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/index.html b/hbase-annotations/index.html
index 89dece5..65819f8 100644
--- a/hbase-annotations/index.html
+++ b/hbase-annotations/index.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/integration.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/integration.html b/hbase-annotations/integration.html
index dc479c4..d5b4b6f 100644
--- a/hbase-annotations/integration.html
+++ b/hbase-annotations/integration.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/issue-tracking.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/issue-tracking.html b/hbase-annotations/issue-tracking.html
index 8de9fcd..02c8cfc 100644
--- a/hbase-annotations/issue-tracking.html
+++ b/hbase-annotations/issue-tracking.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/license.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/license.html b/hbase-annotations/license.html
index fb7156b..4c12a57 100644
--- a/hbase-annotations/license.html
+++ b/hbase-annotations/license.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/mail-lists.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/mail-lists.html b/hbase-annotations/mail-lists.html
index 222e8b0..b96f754 100644
--- a/hbase-annotations/mail-lists.html
+++ b/hbase-annotations/mail-lists.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/1576543b/hbase-annotations/plugin-management.html
----------------------------------------------------------------------
diff --git a/hbase-annotations/plugin-management.html b/hbase-annotations/plugin-management.html
index 2f068d8..1cb3f56 100644
--- a/hbase-annotations/plugin-management.html
+++ b/hbase-annotations/plugin-management.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-16 -->
+<!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 2017-07-18 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -10,7 +10,7 @@
       @import url("./css/site.css");
     </style>
     <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20170716" />
+    <meta name="Date-Revision-yyyymmdd" content="20170718" />
     <meta http-equiv="Content-Language" content="en" />
         
         </head>
@@ -27,7 +27,7 @@
             
                     
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-07-16</span>
+        <span id="publishDate">Last Published: 2017-07-18</span>
                   &nbsp;| <span id="projectVersion">Version: 3.0.0-SNAPSHOT</span>
                       </div>
             <div class="xright">                    <a href="./" title="Apache HBase - Annotations">Apache HBase - Annotations</a>