http://git-wip-us.apache.org/repos/asf/hbase-site/blob/78d8c5d7/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftHttpServer.html
----------------------------------------------------------------------
diff --git 
a/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftHttpServer.html
 
b/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftHttpServer.html
index e105517..d6439f8 100644
--- 
a/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftHttpServer.html
+++ 
b/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftHttpServer.html
@@ -66,181 +66,182 @@
 <span class="sourceLineNo">058</span> */<a name="line.58"></a>
 <span class="sourceLineNo">059</span>@Category({ClientTests.class, 
LargeTests.class})<a name="line.59"></a>
 <span class="sourceLineNo">060</span>public class TestThriftHttpServer {<a 
name="line.60"></a>
-<span class="sourceLineNo">061</span><a name="line.61"></a>
-<span class="sourceLineNo">062</span>  @ClassRule<a name="line.62"></a>
-<span class="sourceLineNo">063</span>  public static final HBaseClassTestRule 
CLASS_RULE =<a name="line.63"></a>
-<span class="sourceLineNo">064</span>      
HBaseClassTestRule.forClass(TestThriftHttpServer.class);<a name="line.64"></a>
-<span class="sourceLineNo">065</span><a name="line.65"></a>
-<span class="sourceLineNo">066</span>  private static final Logger LOG =<a 
name="line.66"></a>
-<span class="sourceLineNo">067</span>      
LoggerFactory.getLogger(TestThriftHttpServer.class);<a name="line.67"></a>
-<span class="sourceLineNo">068</span><a name="line.68"></a>
-<span class="sourceLineNo">069</span>  private static final 
HBaseTestingUtility TEST_UTIL =<a name="line.69"></a>
-<span class="sourceLineNo">070</span>      new HBaseTestingUtility();<a 
name="line.70"></a>
-<span class="sourceLineNo">071</span><a name="line.71"></a>
-<span class="sourceLineNo">072</span>  private Thread httpServerThread;<a 
name="line.72"></a>
-<span class="sourceLineNo">073</span>  private volatile Exception 
httpServerException;<a name="line.73"></a>
+<span class="sourceLineNo">061</span>  @ClassRule<a name="line.61"></a>
+<span class="sourceLineNo">062</span>  public static final HBaseClassTestRule 
CLASS_RULE =<a name="line.62"></a>
+<span class="sourceLineNo">063</span>      
HBaseClassTestRule.forClass(TestThriftHttpServer.class);<a name="line.63"></a>
+<span class="sourceLineNo">064</span><a name="line.64"></a>
+<span class="sourceLineNo">065</span>  private static final Logger LOG =<a 
name="line.65"></a>
+<span class="sourceLineNo">066</span>      
LoggerFactory.getLogger(TestThriftHttpServer.class);<a name="line.66"></a>
+<span class="sourceLineNo">067</span><a name="line.67"></a>
+<span class="sourceLineNo">068</span>  static final HBaseTestingUtility 
TEST_UTIL = new HBaseTestingUtility();<a name="line.68"></a>
+<span class="sourceLineNo">069</span><a name="line.69"></a>
+<span class="sourceLineNo">070</span>  private Thread httpServerThread;<a 
name="line.70"></a>
+<span class="sourceLineNo">071</span>  private volatile Exception 
httpServerException;<a name="line.71"></a>
+<span class="sourceLineNo">072</span><a name="line.72"></a>
+<span class="sourceLineNo">073</span>  private Exception 
clientSideException;<a name="line.73"></a>
 <span class="sourceLineNo">074</span><a name="line.74"></a>
-<span class="sourceLineNo">075</span>  private Exception 
clientSideException;<a name="line.75"></a>
-<span class="sourceLineNo">076</span><a name="line.76"></a>
-<span class="sourceLineNo">077</span>  private ThriftServer thriftServer;<a 
name="line.77"></a>
-<span class="sourceLineNo">078</span>  private int port;<a name="line.78"></a>
-<span class="sourceLineNo">079</span><a name="line.79"></a>
-<span class="sourceLineNo">080</span>  @BeforeClass<a name="line.80"></a>
-<span class="sourceLineNo">081</span>  public static void setUpBeforeClass() 
throws Exception {<a name="line.81"></a>
-<span class="sourceLineNo">082</span>    
TEST_UTIL.getConfiguration().setBoolean("hbase.regionserver.thrift.http", 
true);<a name="line.82"></a>
-<span class="sourceLineNo">083</span>    
TEST_UTIL.getConfiguration().setBoolean("hbase.table.sanity.checks", false);<a 
name="line.83"></a>
-<span class="sourceLineNo">084</span>    TEST_UTIL.startMiniCluster();<a 
name="line.84"></a>
-<span class="sourceLineNo">085</span>    //ensure that server time increments 
every time we do an operation, otherwise<a name="line.85"></a>
-<span class="sourceLineNo">086</span>    //successive puts having the same 
timestamp will override each other<a name="line.86"></a>
-<span class="sourceLineNo">087</span>    
EnvironmentEdgeManagerTestHelper.injectEdge(new 
IncrementingEnvironmentEdge());<a name="line.87"></a>
-<span class="sourceLineNo">088</span>  }<a name="line.88"></a>
-<span class="sourceLineNo">089</span><a name="line.89"></a>
-<span class="sourceLineNo">090</span>  @AfterClass<a name="line.90"></a>
-<span class="sourceLineNo">091</span>  public static void tearDownAfterClass() 
throws Exception {<a name="line.91"></a>
-<span class="sourceLineNo">092</span>    TEST_UTIL.shutdownMiniCluster();<a 
name="line.92"></a>
-<span class="sourceLineNo">093</span>    EnvironmentEdgeManager.reset();<a 
name="line.93"></a>
-<span class="sourceLineNo">094</span>  }<a name="line.94"></a>
-<span class="sourceLineNo">095</span><a name="line.95"></a>
-<span class="sourceLineNo">096</span>  @Test<a name="line.96"></a>
-<span class="sourceLineNo">097</span>  public void 
testExceptionThrownWhenMisConfigured() throws Exception {<a name="line.97"></a>
-<span class="sourceLineNo">098</span>    Configuration conf = new 
Configuration(TEST_UTIL.getConfiguration());<a name="line.98"></a>
-<span class="sourceLineNo">099</span>    conf.set("hbase.thrift.security.qop", 
"privacy");<a name="line.99"></a>
-<span class="sourceLineNo">100</span>    
conf.setBoolean("hbase.thrift.ssl.enabled", false);<a name="line.100"></a>
-<span class="sourceLineNo">101</span><a name="line.101"></a>
-<span class="sourceLineNo">102</span>    ThriftServerRunner runner = null;<a 
name="line.102"></a>
-<span class="sourceLineNo">103</span>    ExpectedException thrown = 
ExpectedException.none();<a name="line.103"></a>
-<span class="sourceLineNo">104</span>    try {<a name="line.104"></a>
-<span class="sourceLineNo">105</span>      
thrown.expect(IllegalArgumentException.class);<a name="line.105"></a>
-<span class="sourceLineNo">106</span>      thrown.expectMessage("Thrift HTTP 
Server's QoP is privacy, " +<a name="line.106"></a>
-<span class="sourceLineNo">107</span>          "but hbase.thrift.ssl.enabled 
is false");<a name="line.107"></a>
-<span class="sourceLineNo">108</span>      runner = new 
ThriftServerRunner(conf);<a name="line.108"></a>
-<span class="sourceLineNo">109</span>      fail("Thrift HTTP Server starts up 
even with wrong security configurations.");<a name="line.109"></a>
-<span class="sourceLineNo">110</span>    } catch (Exception e) {<a 
name="line.110"></a>
-<span class="sourceLineNo">111</span>    }<a name="line.111"></a>
-<span class="sourceLineNo">112</span><a name="line.112"></a>
-<span class="sourceLineNo">113</span>    assertNull(runner);<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>  private void 
startHttpServerThread(final String[] args) {<a name="line.116"></a>
-<span class="sourceLineNo">117</span>    LOG.info("Starting HBase Thrift 
server with HTTP server: " + Joiner.on(" ").join(args));<a name="line.117"></a>
-<span class="sourceLineNo">118</span><a name="line.118"></a>
-<span class="sourceLineNo">119</span>    httpServerException = null;<a 
name="line.119"></a>
-<span class="sourceLineNo">120</span>    httpServerThread = new Thread(() 
-&gt; {<a name="line.120"></a>
-<span class="sourceLineNo">121</span>      try {<a name="line.121"></a>
-<span class="sourceLineNo">122</span>        thriftServer.doMain(args);<a 
name="line.122"></a>
-<span class="sourceLineNo">123</span>      } catch (Exception e) {<a 
name="line.123"></a>
-<span class="sourceLineNo">124</span>        httpServerException = e;<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>    
httpServerThread.setName(ThriftServer.class.getSimpleName() + "-httpServer");<a 
name="line.127"></a>
-<span class="sourceLineNo">128</span>    httpServerThread.start();<a 
name="line.128"></a>
-<span class="sourceLineNo">129</span>  }<a name="line.129"></a>
-<span class="sourceLineNo">130</span><a name="line.130"></a>
-<span class="sourceLineNo">131</span>  @Rule<a name="line.131"></a>
-<span class="sourceLineNo">132</span>  public ExpectedException exception = 
ExpectedException.none();<a name="line.132"></a>
-<span class="sourceLineNo">133</span><a name="line.133"></a>
-<span class="sourceLineNo">134</span>  @Test<a name="line.134"></a>
-<span class="sourceLineNo">135</span>  public void 
testRunThriftServerWithHeaderBufferLength() throws Exception {<a 
name="line.135"></a>
-<span class="sourceLineNo">136</span><a name="line.136"></a>
-<span class="sourceLineNo">137</span>    // Test thrift server with HTTP 
header length less than 64k<a name="line.137"></a>
-<span class="sourceLineNo">138</span>    try {<a name="line.138"></a>
-<span class="sourceLineNo">139</span>      runThriftServer(1024 * 63);<a 
name="line.139"></a>
-<span class="sourceLineNo">140</span>    } catch (TTransportException tex) {<a 
name="line.140"></a>
-<span class="sourceLineNo">141</span>      
assertFalse(tex.getMessage().equals("HTTP Response code: 431"));<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>    // Test thrift server with HTTP 
header length more than 64k, expect an exception<a name="line.144"></a>
-<span class="sourceLineNo">145</span>    
exception.expect(TTransportException.class);<a name="line.145"></a>
-<span class="sourceLineNo">146</span>    exception.expectMessage("HTTP 
Response code: 431");<a name="line.146"></a>
-<span class="sourceLineNo">147</span>    runThriftServer(1024 * 64);<a 
name="line.147"></a>
-<span class="sourceLineNo">148</span>  }<a name="line.148"></a>
-<span class="sourceLineNo">149</span><a name="line.149"></a>
-<span class="sourceLineNo">150</span>  @Test<a name="line.150"></a>
-<span class="sourceLineNo">151</span>  public void testRunThriftServer() 
throws Exception {<a name="line.151"></a>
-<span class="sourceLineNo">152</span>    runThriftServer(0);<a 
name="line.152"></a>
-<span class="sourceLineNo">153</span>  }<a name="line.153"></a>
-<span class="sourceLineNo">154</span><a name="line.154"></a>
-<span class="sourceLineNo">155</span>  private void runThriftServer(int 
customHeaderSize) throws Exception {<a name="line.155"></a>
-<span class="sourceLineNo">156</span>    List&lt;String&gt; args = new 
ArrayList&lt;&gt;(3);<a name="line.156"></a>
-<span class="sourceLineNo">157</span>    port = 
HBaseTestingUtility.randomFreePort();<a name="line.157"></a>
-<span class="sourceLineNo">158</span>    args.add("-" + 
ThriftServer.PORT_OPTION);<a name="line.158"></a>
-<span class="sourceLineNo">159</span>    args.add(String.valueOf(port));<a 
name="line.159"></a>
-<span class="sourceLineNo">160</span>    args.add("start");<a 
name="line.160"></a>
-<span class="sourceLineNo">161</span><a name="line.161"></a>
-<span class="sourceLineNo">162</span>    thriftServer = new 
ThriftServer(TEST_UTIL.getConfiguration());<a name="line.162"></a>
-<span class="sourceLineNo">163</span>    
startHttpServerThread(args.toArray(new String[args.size()]));<a 
name="line.163"></a>
-<span class="sourceLineNo">164</span><a name="line.164"></a>
-<span class="sourceLineNo">165</span>    // wait up to 10s for the server to 
start<a name="line.165"></a>
-<span class="sourceLineNo">166</span>    
HBaseTestingUtility.waitForHostPort(HConstants.LOCALHOST, port);<a 
name="line.166"></a>
-<span class="sourceLineNo">167</span><a name="line.167"></a>
-<span class="sourceLineNo">168</span>    String url = "http://"; + 
HConstants.LOCALHOST + ":" + port;<a name="line.168"></a>
-<span class="sourceLineNo">169</span>    try {<a name="line.169"></a>
-<span class="sourceLineNo">170</span>      checkHttpMethods(url);<a 
name="line.170"></a>
-<span class="sourceLineNo">171</span>      talkToThriftServer(url, 
customHeaderSize);<a name="line.171"></a>
-<span class="sourceLineNo">172</span>    } catch (Exception ex) {<a 
name="line.172"></a>
-<span class="sourceLineNo">173</span>      clientSideException = ex;<a 
name="line.173"></a>
-<span class="sourceLineNo">174</span>    } finally {<a name="line.174"></a>
-<span class="sourceLineNo">175</span>      stopHttpServerThread();<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>    if (clientSideException != null) {<a 
name="line.178"></a>
-<span class="sourceLineNo">179</span>      LOG.error("Thrift client threw an 
exception " + clientSideException);<a name="line.179"></a>
-<span class="sourceLineNo">180</span>      if (clientSideException instanceof 
TTransportException) {<a name="line.180"></a>
-<span class="sourceLineNo">181</span>        throw clientSideException;<a 
name="line.181"></a>
-<span class="sourceLineNo">182</span>      } else {<a name="line.182"></a>
-<span class="sourceLineNo">183</span>        throw new 
Exception(clientSideException);<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><a name="line.187"></a>
-<span class="sourceLineNo">188</span>  private void checkHttpMethods(String 
url) throws Exception {<a name="line.188"></a>
-<span class="sourceLineNo">189</span>    // HTTP TRACE method should be 
disabled for security<a name="line.189"></a>
-<span class="sourceLineNo">190</span>    // See 
https://www.owasp.org/index.php/Cross_Site_Tracing<a name="line.190"></a>
-<span class="sourceLineNo">191</span>    HttpURLConnection conn = 
(HttpURLConnection) new URL(url).openConnection();<a name="line.191"></a>
-<span class="sourceLineNo">192</span>    conn.setRequestMethod("TRACE");<a 
name="line.192"></a>
-<span class="sourceLineNo">193</span>    conn.connect();<a name="line.193"></a>
-<span class="sourceLineNo">194</span>    
Assert.assertEquals(HttpURLConnection.HTTP_FORBIDDEN, 
conn.getResponseCode());<a name="line.194"></a>
-<span class="sourceLineNo">195</span>  }<a name="line.195"></a>
-<span class="sourceLineNo">196</span><a name="line.196"></a>
-<span class="sourceLineNo">197</span>  private static volatile boolean 
tableCreated = false;<a name="line.197"></a>
-<span class="sourceLineNo">198</span><a name="line.198"></a>
-<span class="sourceLineNo">199</span>  private void talkToThriftServer(String 
url, int customHeaderSize) throws Exception {<a name="line.199"></a>
-<span class="sourceLineNo">200</span>    THttpClient httpClient = new 
THttpClient(url);<a name="line.200"></a>
-<span class="sourceLineNo">201</span>    httpClient.open();<a 
name="line.201"></a>
-<span class="sourceLineNo">202</span><a name="line.202"></a>
-<span class="sourceLineNo">203</span>    if (customHeaderSize &gt; 0) {<a 
name="line.203"></a>
-<span class="sourceLineNo">204</span>      StringBuilder sb = new 
StringBuilder();<a name="line.204"></a>
-<span class="sourceLineNo">205</span>      for (int i = 0; i &lt; 
customHeaderSize; i++) {<a name="line.205"></a>
-<span class="sourceLineNo">206</span>        sb.append("a");<a 
name="line.206"></a>
-<span class="sourceLineNo">207</span>      }<a name="line.207"></a>
-<span class="sourceLineNo">208</span>      
httpClient.setCustomHeader("User-Agent", sb.toString());<a name="line.208"></a>
-<span class="sourceLineNo">209</span>    }<a name="line.209"></a>
-<span class="sourceLineNo">210</span><a name="line.210"></a>
-<span class="sourceLineNo">211</span>    try {<a name="line.211"></a>
-<span class="sourceLineNo">212</span>      TProtocol prot;<a 
name="line.212"></a>
-<span class="sourceLineNo">213</span>      prot = new 
TBinaryProtocol(httpClient);<a name="line.213"></a>
-<span class="sourceLineNo">214</span>      Hbase.Client client = new 
Hbase.Client(prot);<a name="line.214"></a>
-<span class="sourceLineNo">215</span>      if (!tableCreated){<a 
name="line.215"></a>
-<span class="sourceLineNo">216</span>        
TestThriftServer.createTestTables(client);<a name="line.216"></a>
-<span class="sourceLineNo">217</span>        tableCreated = true;<a 
name="line.217"></a>
-<span class="sourceLineNo">218</span>      }<a name="line.218"></a>
-<span class="sourceLineNo">219</span>      
TestThriftServer.checkTableList(client);<a name="line.219"></a>
-<span class="sourceLineNo">220</span>    } finally {<a name="line.220"></a>
-<span class="sourceLineNo">221</span>      httpClient.close();<a 
name="line.221"></a>
-<span class="sourceLineNo">222</span>    }<a name="line.222"></a>
-<span class="sourceLineNo">223</span>  }<a name="line.223"></a>
-<span class="sourceLineNo">224</span><a name="line.224"></a>
-<span class="sourceLineNo">225</span>  private void stopHttpServerThread() 
throws Exception {<a name="line.225"></a>
-<span class="sourceLineNo">226</span>    LOG.debug("Stopping " + " Thrift HTTP 
server");<a name="line.226"></a>
-<span class="sourceLineNo">227</span>    thriftServer.stop();<a 
name="line.227"></a>
-<span class="sourceLineNo">228</span>    httpServerThread.join();<a 
name="line.228"></a>
-<span class="sourceLineNo">229</span>    if (httpServerException != null) {<a 
name="line.229"></a>
-<span class="sourceLineNo">230</span>      LOG.error("Command-line invocation 
of HBase Thrift server threw an " +<a name="line.230"></a>
-<span class="sourceLineNo">231</span>          "exception", 
httpServerException);<a name="line.231"></a>
-<span class="sourceLineNo">232</span>      throw new 
Exception(httpServerException);<a name="line.232"></a>
-<span class="sourceLineNo">233</span>    }<a name="line.233"></a>
-<span class="sourceLineNo">234</span>  }<a name="line.234"></a>
-<span class="sourceLineNo">235</span>}<a name="line.235"></a>
+<span class="sourceLineNo">075</span>  private ThriftServer thriftServer;<a 
name="line.75"></a>
+<span class="sourceLineNo">076</span>  int port;<a name="line.76"></a>
+<span class="sourceLineNo">077</span><a name="line.77"></a>
+<span class="sourceLineNo">078</span>  @BeforeClass<a name="line.78"></a>
+<span class="sourceLineNo">079</span>  public static void setUpBeforeClass() 
throws Exception {<a name="line.79"></a>
+<span class="sourceLineNo">080</span>    
TEST_UTIL.getConfiguration().setBoolean("hbase.regionserver.thrift.http", 
true);<a name="line.80"></a>
+<span class="sourceLineNo">081</span>    
TEST_UTIL.getConfiguration().setBoolean("hbase.table.sanity.checks", false);<a 
name="line.81"></a>
+<span class="sourceLineNo">082</span>    TEST_UTIL.startMiniCluster();<a 
name="line.82"></a>
+<span class="sourceLineNo">083</span>    //ensure that server time increments 
every time we do an operation, otherwise<a name="line.83"></a>
+<span class="sourceLineNo">084</span>    //successive puts having the same 
timestamp will override each other<a name="line.84"></a>
+<span class="sourceLineNo">085</span>    
EnvironmentEdgeManagerTestHelper.injectEdge(new 
IncrementingEnvironmentEdge());<a name="line.85"></a>
+<span class="sourceLineNo">086</span>  }<a name="line.86"></a>
+<span class="sourceLineNo">087</span><a name="line.87"></a>
+<span class="sourceLineNo">088</span>  @AfterClass<a name="line.88"></a>
+<span class="sourceLineNo">089</span>  public static void tearDownAfterClass() 
throws Exception {<a name="line.89"></a>
+<span class="sourceLineNo">090</span>    TEST_UTIL.shutdownMiniCluster();<a 
name="line.90"></a>
+<span class="sourceLineNo">091</span>    EnvironmentEdgeManager.reset();<a 
name="line.91"></a>
+<span class="sourceLineNo">092</span>  }<a name="line.92"></a>
+<span class="sourceLineNo">093</span><a name="line.93"></a>
+<span class="sourceLineNo">094</span>  @Test<a name="line.94"></a>
+<span class="sourceLineNo">095</span>  public void 
testExceptionThrownWhenMisConfigured() throws Exception {<a name="line.95"></a>
+<span class="sourceLineNo">096</span>    Configuration conf = new 
Configuration(TEST_UTIL.getConfiguration());<a name="line.96"></a>
+<span class="sourceLineNo">097</span>    conf.set("hbase.thrift.security.qop", 
"privacy");<a name="line.97"></a>
+<span class="sourceLineNo">098</span>    
conf.setBoolean("hbase.thrift.ssl.enabled", false);<a name="line.98"></a>
+<span class="sourceLineNo">099</span><a name="line.99"></a>
+<span class="sourceLineNo">100</span>    ThriftServerRunner runner = null;<a 
name="line.100"></a>
+<span class="sourceLineNo">101</span>    ExpectedException thrown = 
ExpectedException.none();<a name="line.101"></a>
+<span class="sourceLineNo">102</span>    try {<a name="line.102"></a>
+<span class="sourceLineNo">103</span>      
thrown.expect(IllegalArgumentException.class);<a name="line.103"></a>
+<span class="sourceLineNo">104</span>      thrown.expectMessage("Thrift HTTP 
Server's QoP is privacy, " +<a name="line.104"></a>
+<span class="sourceLineNo">105</span>          "but hbase.thrift.ssl.enabled 
is false");<a name="line.105"></a>
+<span class="sourceLineNo">106</span>      runner = new 
ThriftServerRunner(conf);<a name="line.106"></a>
+<span class="sourceLineNo">107</span>      fail("Thrift HTTP Server starts up 
even with wrong security configurations.");<a name="line.107"></a>
+<span class="sourceLineNo">108</span>    } catch (Exception 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>    assertNull(runner);<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>  private void 
startHttpServerThread(final String[] args) {<a name="line.114"></a>
+<span class="sourceLineNo">115</span>    LOG.info("Starting HBase Thrift 
server with HTTP server: " + Joiner.on(" ").join(args));<a name="line.115"></a>
+<span class="sourceLineNo">116</span><a name="line.116"></a>
+<span class="sourceLineNo">117</span>    httpServerException = null;<a 
name="line.117"></a>
+<span class="sourceLineNo">118</span>    httpServerThread = new Thread(() 
-&gt; {<a name="line.118"></a>
+<span class="sourceLineNo">119</span>      try {<a name="line.119"></a>
+<span class="sourceLineNo">120</span>        thriftServer.doMain(args);<a 
name="line.120"></a>
+<span class="sourceLineNo">121</span>      } catch (Exception e) {<a 
name="line.121"></a>
+<span class="sourceLineNo">122</span>        httpServerException = e;<a 
name="line.122"></a>
+<span class="sourceLineNo">123</span>      }<a name="line.123"></a>
+<span class="sourceLineNo">124</span>    });<a name="line.124"></a>
+<span class="sourceLineNo">125</span>    
httpServerThread.setName(ThriftServer.class.getSimpleName() + "-httpServer");<a 
name="line.125"></a>
+<span class="sourceLineNo">126</span>    httpServerThread.start();<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>  @Rule<a name="line.129"></a>
+<span class="sourceLineNo">130</span>  public ExpectedException exception = 
ExpectedException.none();<a name="line.130"></a>
+<span class="sourceLineNo">131</span><a name="line.131"></a>
+<span class="sourceLineNo">132</span>  @Test<a name="line.132"></a>
+<span class="sourceLineNo">133</span>  public void 
testRunThriftServerWithHeaderBufferLength() throws Exception {<a 
name="line.133"></a>
+<span class="sourceLineNo">134</span><a name="line.134"></a>
+<span class="sourceLineNo">135</span>    // Test thrift server with HTTP 
header length less than 64k<a name="line.135"></a>
+<span class="sourceLineNo">136</span>    try {<a name="line.136"></a>
+<span class="sourceLineNo">137</span>      runThriftServer(1024 * 63);<a 
name="line.137"></a>
+<span class="sourceLineNo">138</span>    } catch (TTransportException tex) {<a 
name="line.138"></a>
+<span class="sourceLineNo">139</span>      
assertFalse(tex.getMessage().equals("HTTP Response code: 431"));<a 
name="line.139"></a>
+<span class="sourceLineNo">140</span>    }<a name="line.140"></a>
+<span class="sourceLineNo">141</span><a name="line.141"></a>
+<span class="sourceLineNo">142</span>    // Test thrift server with HTTP 
header length more than 64k, expect an exception<a name="line.142"></a>
+<span class="sourceLineNo">143</span>    
exception.expect(TTransportException.class);<a name="line.143"></a>
+<span class="sourceLineNo">144</span>    exception.expectMessage("HTTP 
Response code: 431");<a name="line.144"></a>
+<span class="sourceLineNo">145</span>    runThriftServer(1024 * 64);<a 
name="line.145"></a>
+<span class="sourceLineNo">146</span>  }<a name="line.146"></a>
+<span class="sourceLineNo">147</span><a name="line.147"></a>
+<span class="sourceLineNo">148</span>  @Test<a name="line.148"></a>
+<span class="sourceLineNo">149</span>  public void testRunThriftServer() 
throws Exception {<a name="line.149"></a>
+<span class="sourceLineNo">150</span>    runThriftServer(0);<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>  void runThriftServer(int 
customHeaderSize) throws Exception {<a name="line.153"></a>
+<span class="sourceLineNo">154</span>    List&lt;String&gt; args = new 
ArrayList&lt;&gt;(3);<a name="line.154"></a>
+<span class="sourceLineNo">155</span>    port = 
HBaseTestingUtility.randomFreePort();<a name="line.155"></a>
+<span class="sourceLineNo">156</span>    args.add("-" + 
ThriftServer.PORT_OPTION);<a name="line.156"></a>
+<span class="sourceLineNo">157</span>    args.add(String.valueOf(port));<a 
name="line.157"></a>
+<span class="sourceLineNo">158</span>    args.add("-" + 
ThriftServer.INFOPORT_OPTION);<a name="line.158"></a>
+<span class="sourceLineNo">159</span>    int infoPort = 
HBaseTestingUtility.randomFreePort();<a name="line.159"></a>
+<span class="sourceLineNo">160</span>    args.add(String.valueOf(infoPort));<a 
name="line.160"></a>
+<span class="sourceLineNo">161</span>    args.add("start");<a 
name="line.161"></a>
+<span class="sourceLineNo">162</span><a name="line.162"></a>
+<span class="sourceLineNo">163</span>    thriftServer = new 
ThriftServer(TEST_UTIL.getConfiguration());<a name="line.163"></a>
+<span class="sourceLineNo">164</span>    
startHttpServerThread(args.toArray(new String[args.size()]));<a 
name="line.164"></a>
+<span class="sourceLineNo">165</span><a name="line.165"></a>
+<span class="sourceLineNo">166</span>    // wait up to 10s for the server to 
start<a name="line.166"></a>
+<span class="sourceLineNo">167</span>    
HBaseTestingUtility.waitForHostPort(HConstants.LOCALHOST, port);<a 
name="line.167"></a>
+<span class="sourceLineNo">168</span><a name="line.168"></a>
+<span class="sourceLineNo">169</span>    String url = "http://"; + 
HConstants.LOCALHOST + ":" + port;<a name="line.169"></a>
+<span class="sourceLineNo">170</span>    try {<a name="line.170"></a>
+<span class="sourceLineNo">171</span>      checkHttpMethods(url);<a 
name="line.171"></a>
+<span class="sourceLineNo">172</span>      talkToThriftServer(url, 
customHeaderSize);<a name="line.172"></a>
+<span class="sourceLineNo">173</span>    } catch (Exception ex) {<a 
name="line.173"></a>
+<span class="sourceLineNo">174</span>      clientSideException = ex;<a 
name="line.174"></a>
+<span class="sourceLineNo">175</span>    } finally {<a name="line.175"></a>
+<span class="sourceLineNo">176</span>      stopHttpServerThread();<a 
name="line.176"></a>
+<span class="sourceLineNo">177</span>    }<a name="line.177"></a>
+<span class="sourceLineNo">178</span><a name="line.178"></a>
+<span class="sourceLineNo">179</span>    if (clientSideException != null) {<a 
name="line.179"></a>
+<span class="sourceLineNo">180</span>      LOG.error("Thrift client threw an 
exception " + clientSideException);<a name="line.180"></a>
+<span class="sourceLineNo">181</span>      if (clientSideException instanceof 
TTransportException) {<a name="line.181"></a>
+<span class="sourceLineNo">182</span>        throw clientSideException;<a 
name="line.182"></a>
+<span class="sourceLineNo">183</span>      } else {<a name="line.183"></a>
+<span class="sourceLineNo">184</span>        throw new 
Exception(clientSideException);<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><a name="line.188"></a>
+<span class="sourceLineNo">189</span>  private void checkHttpMethods(String 
url) throws Exception {<a name="line.189"></a>
+<span class="sourceLineNo">190</span>    // HTTP TRACE method should be 
disabled for security<a name="line.190"></a>
+<span class="sourceLineNo">191</span>    // See 
https://www.owasp.org/index.php/Cross_Site_Tracing<a name="line.191"></a>
+<span class="sourceLineNo">192</span>    HttpURLConnection conn = 
(HttpURLConnection) new URL(url).openConnection();<a name="line.192"></a>
+<span class="sourceLineNo">193</span>    conn.setRequestMethod("TRACE");<a 
name="line.193"></a>
+<span class="sourceLineNo">194</span>    conn.connect();<a name="line.194"></a>
+<span class="sourceLineNo">195</span>    
Assert.assertEquals(HttpURLConnection.HTTP_FORBIDDEN, 
conn.getResponseCode());<a name="line.195"></a>
+<span class="sourceLineNo">196</span>  }<a name="line.196"></a>
+<span class="sourceLineNo">197</span><a name="line.197"></a>
+<span class="sourceLineNo">198</span>  static volatile boolean tableCreated = 
false;<a name="line.198"></a>
+<span class="sourceLineNo">199</span><a name="line.199"></a>
+<span class="sourceLineNo">200</span>  void talkToThriftServer(String url, int 
customHeaderSize) throws Exception {<a name="line.200"></a>
+<span class="sourceLineNo">201</span>    THttpClient httpClient = new 
THttpClient(url);<a name="line.201"></a>
+<span class="sourceLineNo">202</span>    httpClient.open();<a 
name="line.202"></a>
+<span class="sourceLineNo">203</span><a name="line.203"></a>
+<span class="sourceLineNo">204</span>    if (customHeaderSize &gt; 0) {<a 
name="line.204"></a>
+<span class="sourceLineNo">205</span>      StringBuilder sb = new 
StringBuilder();<a name="line.205"></a>
+<span class="sourceLineNo">206</span>      for (int i = 0; i &lt; 
customHeaderSize; i++) {<a name="line.206"></a>
+<span class="sourceLineNo">207</span>        sb.append("a");<a 
name="line.207"></a>
+<span class="sourceLineNo">208</span>      }<a name="line.208"></a>
+<span class="sourceLineNo">209</span>      
httpClient.setCustomHeader("User-Agent", sb.toString());<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>    try {<a name="line.212"></a>
+<span class="sourceLineNo">213</span>      TProtocol prot;<a 
name="line.213"></a>
+<span class="sourceLineNo">214</span>      prot = new 
TBinaryProtocol(httpClient);<a name="line.214"></a>
+<span class="sourceLineNo">215</span>      Hbase.Client client = new 
Hbase.Client(prot);<a name="line.215"></a>
+<span class="sourceLineNo">216</span>      if (!tableCreated){<a 
name="line.216"></a>
+<span class="sourceLineNo">217</span>        
TestThriftServer.createTestTables(client);<a name="line.217"></a>
+<span class="sourceLineNo">218</span>        tableCreated = true;<a 
name="line.218"></a>
+<span class="sourceLineNo">219</span>      }<a name="line.219"></a>
+<span class="sourceLineNo">220</span>      
TestThriftServer.checkTableList(client);<a name="line.220"></a>
+<span class="sourceLineNo">221</span>    } finally {<a name="line.221"></a>
+<span class="sourceLineNo">222</span>      httpClient.close();<a 
name="line.222"></a>
+<span class="sourceLineNo">223</span>    }<a name="line.223"></a>
+<span class="sourceLineNo">224</span>  }<a name="line.224"></a>
+<span class="sourceLineNo">225</span><a name="line.225"></a>
+<span class="sourceLineNo">226</span>  private void stopHttpServerThread() 
throws Exception {<a name="line.226"></a>
+<span class="sourceLineNo">227</span>    LOG.debug("Stopping " + " Thrift HTTP 
server");<a name="line.227"></a>
+<span class="sourceLineNo">228</span>    thriftServer.stop();<a 
name="line.228"></a>
+<span class="sourceLineNo">229</span>    httpServerThread.join();<a 
name="line.229"></a>
+<span class="sourceLineNo">230</span>    if (httpServerException != null) {<a 
name="line.230"></a>
+<span class="sourceLineNo">231</span>      LOG.error("Command-line invocation 
of HBase Thrift server threw an " +<a name="line.231"></a>
+<span class="sourceLineNo">232</span>          "exception", 
httpServerException);<a name="line.232"></a>
+<span class="sourceLineNo">233</span>      throw new 
Exception(httpServerException);<a name="line.233"></a>
+<span class="sourceLineNo">234</span>    }<a name="line.234"></a>
+<span class="sourceLineNo">235</span>  }<a name="line.235"></a>
+<span class="sourceLineNo">236</span>}<a name="line.236"></a>
 
 
 

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/78d8c5d7/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftServerCmdLine.html
----------------------------------------------------------------------
diff --git 
a/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftServerCmdLine.html
 
b/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftServerCmdLine.html
index 86c2075..54b2f1c 100644
--- 
a/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftServerCmdLine.html
+++ 
b/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftServerCmdLine.html
@@ -173,7 +173,7 @@
 <span class="sourceLineNo">165</span>    port = 
HBaseTestingUtility.randomFreePort();<a name="line.165"></a>
 <span class="sourceLineNo">166</span>    args.add("-" + 
ThriftServer.PORT_OPTION);<a name="line.166"></a>
 <span class="sourceLineNo">167</span>    args.add(String.valueOf(port));<a 
name="line.167"></a>
-<span class="sourceLineNo">168</span>    args.add("-infoport");<a 
name="line.168"></a>
+<span class="sourceLineNo">168</span>    args.add("-" + 
ThriftServer.INFOPORT_OPTION);<a name="line.168"></a>
 <span class="sourceLineNo">169</span>    int infoPort = 
HBaseTestingUtility.randomFreePort();<a name="line.169"></a>
 <span class="sourceLineNo">170</span>    args.add(String.valueOf(infoPort));<a 
name="line.170"></a>
 <span class="sourceLineNo">171</span><a name="line.171"></a>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/78d8c5d7/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftSpnegoHttpServer.html
----------------------------------------------------------------------
diff --git 
a/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftSpnegoHttpServer.html
 
b/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftSpnegoHttpServer.html
new file mode 100644
index 0000000..453d724
--- /dev/null
+++ 
b/testdevapidocs/src-html/org/apache/hadoop/hbase/thrift/TestThriftSpnegoHttpServer.html
@@ -0,0 +1,352 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<html lang="en">
+<head>
+<title>Source code</title>
+<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" 
title="Style">
+</head>
+<body>
+<div class="sourceContainer">
+<pre><span class="sourceLineNo">001</span>/*<a name="line.1"></a>
+<span class="sourceLineNo">002</span> * Copyright The Apache Software 
Foundation<a name="line.2"></a>
+<span class="sourceLineNo">003</span> *<a name="line.3"></a>
+<span class="sourceLineNo">004</span> * Licensed to the Apache Software 
Foundation (ASF) under one or more<a name="line.4"></a>
+<span class="sourceLineNo">005</span> * contributor license agreements. See 
the NOTICE file distributed with this<a name="line.5"></a>
+<span class="sourceLineNo">006</span> * work for additional information 
regarding copyright ownership. The ASF<a name="line.6"></a>
+<span class="sourceLineNo">007</span> * licenses this file to you under the 
Apache License, Version 2.0 (the<a name="line.7"></a>
+<span class="sourceLineNo">008</span> * "License"); you may not use this file 
except in compliance with the License.<a name="line.8"></a>
+<span class="sourceLineNo">009</span> * You may obtain a copy of the License 
at<a name="line.9"></a>
+<span class="sourceLineNo">010</span> *<a name="line.10"></a>
+<span class="sourceLineNo">011</span> * 
http://www.apache.org/licenses/LICENSE-2.0<a name="line.11"></a>
+<span class="sourceLineNo">012</span> *<a name="line.12"></a>
+<span class="sourceLineNo">013</span> * Unless required by applicable law or 
agreed to in writing, software<a name="line.13"></a>
+<span class="sourceLineNo">014</span> * distributed under the License is 
distributed on an "AS IS" BASIS, WITHOUT<a name="line.14"></a>
+<span class="sourceLineNo">015</span> * WARRANTIES OR CONDITIONS OF ANY KIND, 
either express or implied. See the<a name="line.15"></a>
+<span class="sourceLineNo">016</span> * License for the specific language 
governing permissions and limitations<a name="line.16"></a>
+<span class="sourceLineNo">017</span> * under the License.<a 
name="line.17"></a>
+<span class="sourceLineNo">018</span> */<a name="line.18"></a>
+<span class="sourceLineNo">019</span>package org.apache.hadoop.hbase.thrift;<a 
name="line.19"></a>
+<span class="sourceLineNo">020</span><a name="line.20"></a>
+<span class="sourceLineNo">021</span>import static 
org.apache.hadoop.hbase.thrift.ThriftServerRunner.THRIFT_KERBEROS_PRINCIPAL_KEY;<a
 name="line.21"></a>
+<span class="sourceLineNo">022</span>import static 
org.apache.hadoop.hbase.thrift.ThriftServerRunner.THRIFT_KEYTAB_FILE_KEY;<a 
name="line.22"></a>
+<span class="sourceLineNo">023</span>import static 
org.apache.hadoop.hbase.thrift.ThriftServerRunner.THRIFT_SPNEGO_KEYTAB_FILE_KEY;<a
 name="line.23"></a>
+<span class="sourceLineNo">024</span>import static 
org.apache.hadoop.hbase.thrift.ThriftServerRunner.THRIFT_SPNEGO_PRINCIPAL_KEY;<a
 name="line.24"></a>
+<span class="sourceLineNo">025</span>import static 
org.apache.hadoop.hbase.thrift.ThriftServerRunner.THRIFT_SUPPORT_PROXYUSER_KEY;<a
 name="line.25"></a>
+<span class="sourceLineNo">026</span>import static 
org.apache.hadoop.hbase.thrift.ThriftServerRunner.USE_HTTP_CONF_KEY;<a 
name="line.26"></a>
+<span class="sourceLineNo">027</span>import static 
org.junit.Assert.assertFalse;<a name="line.27"></a>
+<span class="sourceLineNo">028</span>import static 
org.junit.Assert.assertNotNull;<a name="line.28"></a>
+<span class="sourceLineNo">029</span>import static 
org.junit.Assert.assertTrue;<a name="line.29"></a>
+<span class="sourceLineNo">030</span><a name="line.30"></a>
+<span class="sourceLineNo">031</span>import java.io.File;<a name="line.31"></a>
+<span class="sourceLineNo">032</span>import java.security.Principal;<a 
name="line.32"></a>
+<span class="sourceLineNo">033</span>import 
java.security.PrivilegedExceptionAction;<a name="line.33"></a>
+<span class="sourceLineNo">034</span>import java.util.Set;<a 
name="line.34"></a>
+<span class="sourceLineNo">035</span><a name="line.35"></a>
+<span class="sourceLineNo">036</span>import javax.security.auth.Subject;<a 
name="line.36"></a>
+<span class="sourceLineNo">037</span>import 
javax.security.auth.kerberos.KerberosTicket;<a name="line.37"></a>
+<span class="sourceLineNo">038</span><a name="line.38"></a>
+<span class="sourceLineNo">039</span>import org.apache.commons.io.FileUtils;<a 
name="line.39"></a>
+<span class="sourceLineNo">040</span>import 
org.apache.hadoop.conf.Configuration;<a name="line.40"></a>
+<span class="sourceLineNo">041</span>import 
org.apache.hadoop.hbase.HBaseClassTestRule;<a name="line.41"></a>
+<span class="sourceLineNo">042</span>import 
org.apache.hadoop.hbase.HBaseTestingUtility;<a name="line.42"></a>
+<span class="sourceLineNo">043</span>import 
org.apache.hadoop.hbase.HConstants;<a name="line.43"></a>
+<span class="sourceLineNo">044</span>import 
org.apache.hadoop.hbase.security.HBaseKerberosUtils;<a name="line.44"></a>
+<span class="sourceLineNo">045</span>import 
org.apache.hadoop.hbase.testclassification.ClientTests;<a name="line.45"></a>
+<span class="sourceLineNo">046</span>import 
org.apache.hadoop.hbase.testclassification.LargeTests;<a name="line.46"></a>
+<span class="sourceLineNo">047</span>import 
org.apache.hadoop.hbase.thrift.generated.Hbase;<a name="line.47"></a>
+<span class="sourceLineNo">048</span>import 
org.apache.hadoop.hdfs.DFSConfigKeys;<a name="line.48"></a>
+<span class="sourceLineNo">049</span>import 
org.apache.hadoop.security.authentication.util.KerberosName;<a 
name="line.49"></a>
+<span class="sourceLineNo">050</span>import org.apache.http.HttpHeaders;<a 
name="line.50"></a>
+<span class="sourceLineNo">051</span>import 
org.apache.http.auth.AuthSchemeProvider;<a name="line.51"></a>
+<span class="sourceLineNo">052</span>import org.apache.http.auth.AuthScope;<a 
name="line.52"></a>
+<span class="sourceLineNo">053</span>import 
org.apache.http.auth.KerberosCredentials;<a name="line.53"></a>
+<span class="sourceLineNo">054</span>import 
org.apache.http.client.config.AuthSchemes;<a name="line.54"></a>
+<span class="sourceLineNo">055</span>import org.apache.http.config.Lookup;<a 
name="line.55"></a>
+<span class="sourceLineNo">056</span>import 
org.apache.http.config.RegistryBuilder;<a name="line.56"></a>
+<span class="sourceLineNo">057</span>import 
org.apache.http.impl.auth.SPNegoSchemeFactory;<a name="line.57"></a>
+<span class="sourceLineNo">058</span>import 
org.apache.http.impl.client.BasicCredentialsProvider;<a name="line.58"></a>
+<span class="sourceLineNo">059</span>import 
org.apache.http.impl.client.CloseableHttpClient;<a name="line.59"></a>
+<span class="sourceLineNo">060</span>import 
org.apache.http.impl.client.HttpClients;<a name="line.60"></a>
+<span class="sourceLineNo">061</span>import 
org.apache.kerby.kerberos.kerb.KrbException;<a name="line.61"></a>
+<span class="sourceLineNo">062</span>import 
org.apache.kerby.kerberos.kerb.client.JaasKrbUtil;<a name="line.62"></a>
+<span class="sourceLineNo">063</span>import 
org.apache.kerby.kerberos.kerb.server.SimpleKdcServer;<a name="line.63"></a>
+<span class="sourceLineNo">064</span>import 
org.apache.thrift.protocol.TBinaryProtocol;<a name="line.64"></a>
+<span class="sourceLineNo">065</span>import 
org.apache.thrift.protocol.TProtocol;<a name="line.65"></a>
+<span class="sourceLineNo">066</span>import 
org.apache.thrift.transport.THttpClient;<a name="line.66"></a>
+<span class="sourceLineNo">067</span>import org.ietf.jgss.GSSCredential;<a 
name="line.67"></a>
+<span class="sourceLineNo">068</span>import org.ietf.jgss.GSSManager;<a 
name="line.68"></a>
+<span class="sourceLineNo">069</span>import org.ietf.jgss.GSSName;<a 
name="line.69"></a>
+<span class="sourceLineNo">070</span>import org.ietf.jgss.Oid;<a 
name="line.70"></a>
+<span class="sourceLineNo">071</span>import org.junit.AfterClass;<a 
name="line.71"></a>
+<span class="sourceLineNo">072</span>import org.junit.BeforeClass;<a 
name="line.72"></a>
+<span class="sourceLineNo">073</span>import org.junit.ClassRule;<a 
name="line.73"></a>
+<span class="sourceLineNo">074</span>import 
org.junit.experimental.categories.Category;<a name="line.74"></a>
+<span class="sourceLineNo">075</span>import org.slf4j.Logger;<a 
name="line.75"></a>
+<span class="sourceLineNo">076</span>import org.slf4j.LoggerFactory;<a 
name="line.76"></a>
+<span class="sourceLineNo">077</span><a name="line.77"></a>
+<span class="sourceLineNo">078</span>/**<a name="line.78"></a>
+<span class="sourceLineNo">079</span> * Start the HBase Thrift HTTP server on 
a random port through the command-line<a name="line.79"></a>
+<span class="sourceLineNo">080</span> * interface and talk to it from client 
side with SPNEGO security enabled.<a name="line.80"></a>
+<span class="sourceLineNo">081</span> */<a name="line.81"></a>
+<span class="sourceLineNo">082</span>@Category({ClientTests.class, 
LargeTests.class})<a name="line.82"></a>
+<span class="sourceLineNo">083</span>public class TestThriftSpnegoHttpServer 
extends TestThriftHttpServer {<a name="line.83"></a>
+<span class="sourceLineNo">084</span>  @ClassRule<a name="line.84"></a>
+<span class="sourceLineNo">085</span>  public static final HBaseClassTestRule 
CLASS_RULE =<a name="line.85"></a>
+<span class="sourceLineNo">086</span>    
HBaseClassTestRule.forClass(TestThriftSpnegoHttpServer.class);<a 
name="line.86"></a>
+<span class="sourceLineNo">087</span><a name="line.87"></a>
+<span class="sourceLineNo">088</span>  private static final Logger LOG =<a 
name="line.88"></a>
+<span class="sourceLineNo">089</span>    
LoggerFactory.getLogger(TestThriftSpnegoHttpServer.class);<a name="line.89"></a>
+<span class="sourceLineNo">090</span><a name="line.90"></a>
+<span class="sourceLineNo">091</span>  private static SimpleKdcServer kdc;<a 
name="line.91"></a>
+<span class="sourceLineNo">092</span>  private static File serverKeytab;<a 
name="line.92"></a>
+<span class="sourceLineNo">093</span>  private static File 
spnegoServerKeytab;<a name="line.93"></a>
+<span class="sourceLineNo">094</span>  private static File clientKeytab;<a 
name="line.94"></a>
+<span class="sourceLineNo">095</span><a name="line.95"></a>
+<span class="sourceLineNo">096</span>  private static String 
clientPrincipal;<a name="line.96"></a>
+<span class="sourceLineNo">097</span>  private static String 
serverPrincipal;<a name="line.97"></a>
+<span class="sourceLineNo">098</span>  private static String 
spnegoServerPrincipal;<a name="line.98"></a>
+<span class="sourceLineNo">099</span><a name="line.99"></a>
+<span class="sourceLineNo">100</span>  private static void 
setupUser(SimpleKdcServer kdc, File keytab, String principal)<a 
name="line.100"></a>
+<span class="sourceLineNo">101</span>      throws KrbException {<a 
name="line.101"></a>
+<span class="sourceLineNo">102</span>    kdc.createPrincipal(principal);<a 
name="line.102"></a>
+<span class="sourceLineNo">103</span>    kdc.exportPrincipal(principal, 
keytab);<a name="line.103"></a>
+<span class="sourceLineNo">104</span>  }<a name="line.104"></a>
+<span class="sourceLineNo">105</span><a name="line.105"></a>
+<span class="sourceLineNo">106</span>  private static SimpleKdcServer 
buildMiniKdc() throws Exception {<a name="line.106"></a>
+<span class="sourceLineNo">107</span>    SimpleKdcServer kdc = new 
SimpleKdcServer();<a name="line.107"></a>
+<span class="sourceLineNo">108</span><a name="line.108"></a>
+<span class="sourceLineNo">109</span>    final File target = new 
File(System.getProperty("user.dir"), "target");<a name="line.109"></a>
+<span class="sourceLineNo">110</span>    File kdcDir = new File(target, 
TestThriftSpnegoHttpServer.class.getSimpleName());<a name="line.110"></a>
+<span class="sourceLineNo">111</span>    if (kdcDir.exists()) {<a 
name="line.111"></a>
+<span class="sourceLineNo">112</span>      
FileUtils.deleteDirectory(kdcDir);<a name="line.112"></a>
+<span class="sourceLineNo">113</span>    }<a name="line.113"></a>
+<span class="sourceLineNo">114</span>    kdcDir.mkdirs();<a 
name="line.114"></a>
+<span class="sourceLineNo">115</span>    kdc.setWorkDir(kdcDir);<a 
name="line.115"></a>
+<span class="sourceLineNo">116</span><a name="line.116"></a>
+<span class="sourceLineNo">117</span>    
kdc.setKdcHost(HConstants.LOCALHOST);<a name="line.117"></a>
+<span class="sourceLineNo">118</span>    int kdcPort = 
HBaseTestingUtility.randomFreePort();<a name="line.118"></a>
+<span class="sourceLineNo">119</span>    kdc.setAllowTcp(true);<a 
name="line.119"></a>
+<span class="sourceLineNo">120</span>    kdc.setAllowUdp(false);<a 
name="line.120"></a>
+<span class="sourceLineNo">121</span>    kdc.setKdcTcpPort(kdcPort);<a 
name="line.121"></a>
+<span class="sourceLineNo">122</span><a name="line.122"></a>
+<span class="sourceLineNo">123</span>    LOG.info("Starting KDC server at " + 
HConstants.LOCALHOST + ":" + kdcPort);<a name="line.123"></a>
+<span class="sourceLineNo">124</span><a name="line.124"></a>
+<span class="sourceLineNo">125</span>    kdc.init();<a name="line.125"></a>
+<span class="sourceLineNo">126</span><a name="line.126"></a>
+<span class="sourceLineNo">127</span>    return kdc;<a name="line.127"></a>
+<span class="sourceLineNo">128</span>  }<a name="line.128"></a>
+<span class="sourceLineNo">129</span><a name="line.129"></a>
+<span class="sourceLineNo">130</span>  private static void 
addSecurityConfigurations(Configuration conf) {<a name="line.130"></a>
+<span class="sourceLineNo">131</span>    KerberosName.setRules("DEFAULT");<a 
name="line.131"></a>
+<span class="sourceLineNo">132</span><a name="line.132"></a>
+<span class="sourceLineNo">133</span>    
HBaseKerberosUtils.setKeytabFileForTesting(serverKeytab.getAbsolutePath());<a 
name="line.133"></a>
+<span class="sourceLineNo">134</span>    
HBaseKerberosUtils.setPrincipalForTesting(serverPrincipal);<a 
name="line.134"></a>
+<span class="sourceLineNo">135</span>    
HBaseKerberosUtils.setSecuredConfiguration(conf);<a name="line.135"></a>
+<span class="sourceLineNo">136</span><a name="line.136"></a>
+<span class="sourceLineNo">137</span>    // if we drop support for 
hadoop-2.4.0 and hadoop-2.4.1,<a name="line.137"></a>
+<span class="sourceLineNo">138</span>    // the following key should be 
changed.<a name="line.138"></a>
+<span class="sourceLineNo">139</span>    // 1) DFS_NAMENODE_USER_NAME_KEY 
-&gt; DFS_NAMENODE_KERBEROS_PRINCIPAL_KEY<a name="line.139"></a>
+<span class="sourceLineNo">140</span>    // 2) DFS_DATANODE_USER_NAME_KEY 
-&gt; DFS_DATANODE_KERBEROS_PRINCIPAL_KEY<a name="line.140"></a>
+<span class="sourceLineNo">141</span>    
conf.set(DFSConfigKeys.DFS_NAMENODE_USER_NAME_KEY, serverPrincipal);<a 
name="line.141"></a>
+<span class="sourceLineNo">142</span>    
conf.set(DFSConfigKeys.DFS_NAMENODE_KEYTAB_FILE_KEY, 
serverKeytab.getAbsolutePath());<a name="line.142"></a>
+<span class="sourceLineNo">143</span>    
conf.set(DFSConfigKeys.DFS_DATANODE_USER_NAME_KEY, serverPrincipal);<a 
name="line.143"></a>
+<span class="sourceLineNo">144</span>    
conf.set(DFSConfigKeys.DFS_DATANODE_KEYTAB_FILE_KEY, 
serverKeytab.getAbsolutePath());<a name="line.144"></a>
+<span class="sourceLineNo">145</span><a name="line.145"></a>
+<span class="sourceLineNo">146</span>    
conf.setBoolean(DFSConfigKeys.DFS_BLOCK_ACCESS_TOKEN_ENABLE_KEY, true);<a 
name="line.146"></a>
+<span class="sourceLineNo">147</span><a name="line.147"></a>
+<span class="sourceLineNo">148</span>    
conf.set(DFSConfigKeys.DFS_WEB_AUTHENTICATION_KERBEROS_PRINCIPAL_KEY, 
spnegoServerPrincipal);<a name="line.148"></a>
+<span class="sourceLineNo">149</span>    
conf.set(DFSConfigKeys.DFS_WEB_AUTHENTICATION_KERBEROS_KEYTAB_KEY,<a 
name="line.149"></a>
+<span class="sourceLineNo">150</span>        
spnegoServerKeytab.getAbsolutePath());<a name="line.150"></a>
+<span class="sourceLineNo">151</span><a name="line.151"></a>
+<span class="sourceLineNo">152</span>    
conf.setBoolean("ignore.secure.ports.for.testing", true);<a name="line.152"></a>
+<span class="sourceLineNo">153</span><a name="line.153"></a>
+<span class="sourceLineNo">154</span>    
conf.setBoolean(THRIFT_SUPPORT_PROXYUSER_KEY, true);<a name="line.154"></a>
+<span class="sourceLineNo">155</span>    conf.setBoolean(USE_HTTP_CONF_KEY, 
true);<a name="line.155"></a>
+<span class="sourceLineNo">156</span>    
conf.set("hadoop.proxyuser.hbase.hosts", "*");<a name="line.156"></a>
+<span class="sourceLineNo">157</span>    
conf.set("hadoop.proxyuser.hbase.groups", "*");<a name="line.157"></a>
+<span class="sourceLineNo">158</span><a name="line.158"></a>
+<span class="sourceLineNo">159</span>    
conf.set(THRIFT_KERBEROS_PRINCIPAL_KEY, serverPrincipal);<a name="line.159"></a>
+<span class="sourceLineNo">160</span>    conf.set(THRIFT_KEYTAB_FILE_KEY, 
serverKeytab.getAbsolutePath());<a name="line.160"></a>
+<span class="sourceLineNo">161</span>    conf.set(THRIFT_SPNEGO_PRINCIPAL_KEY, 
spnegoServerPrincipal);<a name="line.161"></a>
+<span class="sourceLineNo">162</span>    
conf.set(THRIFT_SPNEGO_KEYTAB_FILE_KEY, 
spnegoServerKeytab.getAbsolutePath());<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>  @BeforeClass<a name="line.165"></a>
+<span class="sourceLineNo">166</span>  public static void setUpBeforeClass() 
throws Exception {<a name="line.166"></a>
+<span class="sourceLineNo">167</span>    final File target = new 
File(System.getProperty("user.dir"), "target");<a name="line.167"></a>
+<span class="sourceLineNo">168</span>    assertTrue(target.exists());<a 
name="line.168"></a>
+<span class="sourceLineNo">169</span><a name="line.169"></a>
+<span class="sourceLineNo">170</span>    File keytabDir = new File(target, 
TestThriftSpnegoHttpServer.class.getSimpleName() +<a name="line.170"></a>
+<span class="sourceLineNo">171</span>      "_keytabs");<a name="line.171"></a>
+<span class="sourceLineNo">172</span>    if (keytabDir.exists()) {<a 
name="line.172"></a>
+<span class="sourceLineNo">173</span>      
FileUtils.deleteDirectory(keytabDir);<a name="line.173"></a>
+<span class="sourceLineNo">174</span>    }<a name="line.174"></a>
+<span class="sourceLineNo">175</span>    keytabDir.mkdirs();<a 
name="line.175"></a>
+<span class="sourceLineNo">176</span><a name="line.176"></a>
+<span class="sourceLineNo">177</span>    kdc = buildMiniKdc();<a 
name="line.177"></a>
+<span class="sourceLineNo">178</span>    kdc.start();<a name="line.178"></a>
+<span class="sourceLineNo">179</span><a name="line.179"></a>
+<span class="sourceLineNo">180</span>    clientPrincipal = "client@" + 
kdc.getKdcConfig().getKdcRealm();<a name="line.180"></a>
+<span class="sourceLineNo">181</span>    clientKeytab = new File(keytabDir, 
clientPrincipal + ".keytab");<a name="line.181"></a>
+<span class="sourceLineNo">182</span>    setupUser(kdc, clientKeytab, 
clientPrincipal);<a name="line.182"></a>
+<span class="sourceLineNo">183</span><a name="line.183"></a>
+<span class="sourceLineNo">184</span>    serverPrincipal = "hbase/" + 
HConstants.LOCALHOST + "@" + kdc.getKdcConfig().getKdcRealm();<a 
name="line.184"></a>
+<span class="sourceLineNo">185</span>    serverKeytab = new File(keytabDir, 
serverPrincipal.replace('/', '_') + ".keytab");<a name="line.185"></a>
+<span class="sourceLineNo">186</span>    setupUser(kdc, serverKeytab, 
serverPrincipal);<a name="line.186"></a>
+<span class="sourceLineNo">187</span><a name="line.187"></a>
+<span class="sourceLineNo">188</span>    spnegoServerPrincipal = "HTTP/" + 
HConstants.LOCALHOST + "@" + kdc.getKdcConfig().getKdcRealm();<a 
name="line.188"></a>
+<span class="sourceLineNo">189</span>    spnegoServerKeytab = new 
File(keytabDir, spnegoServerPrincipal.replace('/', '_') + ".keytab");<a 
name="line.189"></a>
+<span class="sourceLineNo">190</span>    setupUser(kdc, spnegoServerKeytab, 
spnegoServerPrincipal);<a name="line.190"></a>
+<span class="sourceLineNo">191</span><a name="line.191"></a>
+<span class="sourceLineNo">192</span>    
TEST_UTIL.getConfiguration().setBoolean(USE_HTTP_CONF_KEY, true);<a 
name="line.192"></a>
+<span class="sourceLineNo">193</span>    
TEST_UTIL.getConfiguration().setBoolean("hbase.table.sanity.checks", false);<a 
name="line.193"></a>
+<span class="sourceLineNo">194</span>    
addSecurityConfigurations(TEST_UTIL.getConfiguration());<a name="line.194"></a>
+<span class="sourceLineNo">195</span><a name="line.195"></a>
+<span class="sourceLineNo">196</span>    
TestThriftHttpServer.setUpBeforeClass();<a name="line.196"></a>
+<span class="sourceLineNo">197</span>  }<a name="line.197"></a>
+<span class="sourceLineNo">198</span><a name="line.198"></a>
+<span class="sourceLineNo">199</span>  @AfterClass<a name="line.199"></a>
+<span class="sourceLineNo">200</span>  public static void tearDownAfterClass() 
throws Exception {<a name="line.200"></a>
+<span class="sourceLineNo">201</span>    
TestThriftHttpServer.tearDownAfterClass();<a name="line.201"></a>
+<span class="sourceLineNo">202</span><a name="line.202"></a>
+<span class="sourceLineNo">203</span>    try {<a name="line.203"></a>
+<span class="sourceLineNo">204</span>      if (null != kdc) {<a 
name="line.204"></a>
+<span class="sourceLineNo">205</span>        kdc.stop();<a name="line.205"></a>
+<span class="sourceLineNo">206</span>      }<a name="line.206"></a>
+<span class="sourceLineNo">207</span>    } catch (Exception e) {<a 
name="line.207"></a>
+<span class="sourceLineNo">208</span>      LOG.info("Failed to stop mini KDC", 
e);<a name="line.208"></a>
+<span class="sourceLineNo">209</span>    }<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>  @Override<a name="line.212"></a>
+<span class="sourceLineNo">213</span>  void talkToThriftServer(String url, int 
customHeaderSize) throws Exception {<a name="line.213"></a>
+<span class="sourceLineNo">214</span>    // Close httpClient and THttpClient 
automatically on any failures<a name="line.214"></a>
+<span class="sourceLineNo">215</span>    try (<a name="line.215"></a>
+<span class="sourceLineNo">216</span>        CloseableHttpClient httpClient = 
createHttpClient();<a name="line.216"></a>
+<span class="sourceLineNo">217</span>        THttpClient tHttpClient = new 
THttpClient(url, httpClient)<a name="line.217"></a>
+<span class="sourceLineNo">218</span>    ) {<a name="line.218"></a>
+<span class="sourceLineNo">219</span>      tHttpClient.open();<a 
name="line.219"></a>
+<span class="sourceLineNo">220</span>      if (customHeaderSize &gt; 0) {<a 
name="line.220"></a>
+<span class="sourceLineNo">221</span>        StringBuilder sb = new 
StringBuilder();<a name="line.221"></a>
+<span class="sourceLineNo">222</span>        for (int i = 0; i &lt; 
customHeaderSize; i++) {<a name="line.222"></a>
+<span class="sourceLineNo">223</span>          sb.append("a");<a 
name="line.223"></a>
+<span class="sourceLineNo">224</span>        }<a name="line.224"></a>
+<span class="sourceLineNo">225</span>        
tHttpClient.setCustomHeader(HttpHeaders.USER_AGENT, sb.toString());<a 
name="line.225"></a>
+<span class="sourceLineNo">226</span>      }<a name="line.226"></a>
+<span class="sourceLineNo">227</span><a name="line.227"></a>
+<span class="sourceLineNo">228</span>      TProtocol prot = new 
TBinaryProtocol(tHttpClient);<a name="line.228"></a>
+<span class="sourceLineNo">229</span>      Hbase.Client client = new 
Hbase.Client(prot);<a name="line.229"></a>
+<span class="sourceLineNo">230</span>      if (!tableCreated) {<a 
name="line.230"></a>
+<span class="sourceLineNo">231</span>        
TestThriftServer.createTestTables(client);<a name="line.231"></a>
+<span class="sourceLineNo">232</span>        tableCreated = true;<a 
name="line.232"></a>
+<span class="sourceLineNo">233</span>      }<a name="line.233"></a>
+<span class="sourceLineNo">234</span>      
TestThriftServer.checkTableList(client);<a name="line.234"></a>
+<span class="sourceLineNo">235</span>    }<a name="line.235"></a>
+<span class="sourceLineNo">236</span>  }<a name="line.236"></a>
+<span class="sourceLineNo">237</span><a name="line.237"></a>
+<span class="sourceLineNo">238</span>  private CloseableHttpClient 
createHttpClient() throws Exception {<a name="line.238"></a>
+<span class="sourceLineNo">239</span>    final Subject clientSubject = 
JaasKrbUtil.loginUsingKeytab(clientPrincipal, clientKeytab);<a 
name="line.239"></a>
+<span class="sourceLineNo">240</span>    final Set&lt;Principal&gt; 
clientPrincipals = clientSubject.getPrincipals();<a name="line.240"></a>
+<span class="sourceLineNo">241</span>    // Make sure the subject has a 
principal<a name="line.241"></a>
+<span class="sourceLineNo">242</span>    
assertFalse(clientPrincipals.isEmpty());<a name="line.242"></a>
+<span class="sourceLineNo">243</span><a name="line.243"></a>
+<span class="sourceLineNo">244</span>    // Get a TGT for the subject (might 
have many, different encryption types). The first should<a name="line.244"></a>
+<span class="sourceLineNo">245</span>    // be the default encryption type.<a 
name="line.245"></a>
+<span class="sourceLineNo">246</span>    Set&lt;KerberosTicket&gt; 
privateCredentials =<a name="line.246"></a>
+<span class="sourceLineNo">247</span>        
clientSubject.getPrivateCredentials(KerberosTicket.class);<a 
name="line.247"></a>
+<span class="sourceLineNo">248</span>    
assertFalse(privateCredentials.isEmpty());<a name="line.248"></a>
+<span class="sourceLineNo">249</span>    KerberosTicket tgt = 
privateCredentials.iterator().next();<a name="line.249"></a>
+<span class="sourceLineNo">250</span>    assertNotNull(tgt);<a 
name="line.250"></a>
+<span class="sourceLineNo">251</span><a name="line.251"></a>
+<span class="sourceLineNo">252</span>    // The name of the principal<a 
name="line.252"></a>
+<span class="sourceLineNo">253</span>    final String clientPrincipalName = 
clientPrincipals.iterator().next().getName();<a name="line.253"></a>
+<span class="sourceLineNo">254</span><a name="line.254"></a>
+<span class="sourceLineNo">255</span>    return Subject.doAs(clientSubject, 
new PrivilegedExceptionAction&lt;CloseableHttpClient&gt;() {<a 
name="line.255"></a>
+<span class="sourceLineNo">256</span>      @Override<a name="line.256"></a>
+<span class="sourceLineNo">257</span>      public CloseableHttpClient run() 
throws Exception {<a name="line.257"></a>
+<span class="sourceLineNo">258</span>        // Logs in with Kerberos via 
GSS<a name="line.258"></a>
+<span class="sourceLineNo">259</span>        GSSManager gssManager = 
GSSManager.getInstance();<a name="line.259"></a>
+<span class="sourceLineNo">260</span>        // jGSS Kerberos login constant<a 
name="line.260"></a>
+<span class="sourceLineNo">261</span>        Oid oid = new 
Oid("1.2.840.113554.1.2.2");<a name="line.261"></a>
+<span class="sourceLineNo">262</span>        GSSName gssClient = 
gssManager.createName(clientPrincipalName, GSSName.NT_USER_NAME);<a 
name="line.262"></a>
+<span class="sourceLineNo">263</span>        GSSCredential credential = 
gssManager.createCredential(gssClient,<a name="line.263"></a>
+<span class="sourceLineNo">264</span>            
GSSCredential.DEFAULT_LIFETIME, oid, GSSCredential.INITIATE_ONLY);<a 
name="line.264"></a>
+<span class="sourceLineNo">265</span><a name="line.265"></a>
+<span class="sourceLineNo">266</span>        Lookup&lt;AuthSchemeProvider&gt; 
authRegistry = RegistryBuilder.&lt;AuthSchemeProvider&gt;create()<a 
name="line.266"></a>
+<span class="sourceLineNo">267</span>            .register(AuthSchemes.SPNEGO, 
new SPNegoSchemeFactory(true, true))<a name="line.267"></a>
+<span class="sourceLineNo">268</span>            .build();<a 
name="line.268"></a>
+<span class="sourceLineNo">269</span><a name="line.269"></a>
+<span class="sourceLineNo">270</span>        BasicCredentialsProvider 
credentialsProvider = new BasicCredentialsProvider();<a name="line.270"></a>
+<span class="sourceLineNo">271</span>        
credentialsProvider.setCredentials(AuthScope.ANY, new 
KerberosCredentials(credential));<a name="line.271"></a>
+<span class="sourceLineNo">272</span><a name="line.272"></a>
+<span class="sourceLineNo">273</span>        return HttpClients.custom()<a 
name="line.273"></a>
+<span class="sourceLineNo">274</span>            
.setDefaultAuthSchemeRegistry(authRegistry)<a name="line.274"></a>
+<span class="sourceLineNo">275</span>            
.setDefaultCredentialsProvider(credentialsProvider)<a name="line.275"></a>
+<span class="sourceLineNo">276</span>            .build();<a 
name="line.276"></a>
+<span class="sourceLineNo">277</span>      }<a name="line.277"></a>
+<span class="sourceLineNo">278</span>    });<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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</pre>
+</div>
+</body>
+</html>

http://git-wip-us.apache.org/repos/asf/hbase-site/blob/78d8c5d7/testdevapidocs/src-html/org/apache/hadoop/hbase/tool/coprocessor/CoprocessorValidatorTest.MissingClass.html
----------------------------------------------------------------------
diff --git 
a/testdevapidocs/src-html/org/apache/hadoop/hbase/tool/coprocessor/CoprocessorValidatorTest.MissingClass.html
 
b/testdevapidocs/src-html/org/apache/hadoop/hbase/tool/coprocessor/CoprocessorValidatorTest.MissingClass.html
new file mode 100644
index 0000000..7896c2f
--- /dev/null
+++ 
b/testdevapidocs/src-html/org/apache/hadoop/hbase/tool/coprocessor/CoprocessorValidatorTest.MissingClass.html
@@ -0,0 +1,249 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd";>
+<html lang="en">
+<head>
+<title>Source code</title>
+<link rel="stylesheet" type="text/css" 
href="../../../../../../../stylesheet.css" title="Style">
+</head>
+<body>
+<div class="sourceContainer">
+<pre><span class="sourceLineNo">001</span>/**<a name="line.1"></a>
+<span class="sourceLineNo">002</span> * Licensed to the Apache Software 
Foundation (ASF) under one<a name="line.2"></a>
+<span class="sourceLineNo">003</span> * or more contributor license 
agreements.  See the NOTICE file<a name="line.3"></a>
+<span class="sourceLineNo">004</span> * distributed with this work for 
additional information<a name="line.4"></a>
+<span class="sourceLineNo">005</span> * regarding copyright ownership.  The 
ASF licenses this file<a name="line.5"></a>
+<span class="sourceLineNo">006</span> * to you under the Apache License, 
Version 2.0 (the<a name="line.6"></a>
+<span class="sourceLineNo">007</span> * "License"); you may not use this file 
except in compliance<a name="line.7"></a>
+<span class="sourceLineNo">008</span> * with the License.  You may obtain a 
copy of the License at<a name="line.8"></a>
+<span class="sourceLineNo">009</span> *<a name="line.9"></a>
+<span class="sourceLineNo">010</span> *     
http://www.apache.org/licenses/LICENSE-2.0<a name="line.10"></a>
+<span class="sourceLineNo">011</span> *<a name="line.11"></a>
+<span class="sourceLineNo">012</span> * Unless required by applicable law or 
agreed to in writing, software<a name="line.12"></a>
+<span class="sourceLineNo">013</span> * distributed under the License is 
distributed on an "AS IS" BASIS,<a name="line.13"></a>
+<span class="sourceLineNo">014</span> * WITHOUT WARRANTIES OR CONDITIONS OF 
ANY KIND, either express or implied.<a name="line.14"></a>
+<span class="sourceLineNo">015</span> * See the License for the specific 
language governing permissions and<a name="line.15"></a>
+<span class="sourceLineNo">016</span> * limitations under the License.<a 
name="line.16"></a>
+<span class="sourceLineNo">017</span> */<a name="line.17"></a>
+<span class="sourceLineNo">018</span><a name="line.18"></a>
+<span class="sourceLineNo">019</span>package 
org.apache.hadoop.hbase.tool.coprocessor;<a name="line.19"></a>
+<span class="sourceLineNo">020</span><a name="line.20"></a>
+<span class="sourceLineNo">021</span>import static 
org.junit.Assert.assertEquals;<a name="line.21"></a>
+<span class="sourceLineNo">022</span>import static 
org.junit.Assert.assertTrue;<a name="line.22"></a>
+<span class="sourceLineNo">023</span><a name="line.23"></a>
+<span class="sourceLineNo">024</span>import java.io.IOException;<a 
name="line.24"></a>
+<span class="sourceLineNo">025</span>import java.util.List;<a 
name="line.25"></a>
+<span class="sourceLineNo">026</span><a name="line.26"></a>
+<span class="sourceLineNo">027</span>import 
org.apache.hadoop.hbase.Coprocessor;<a name="line.27"></a>
+<span class="sourceLineNo">028</span>import 
org.apache.hadoop.hbase.CoprocessorEnvironment;<a name="line.28"></a>
+<span class="sourceLineNo">029</span>import 
org.apache.hadoop.hbase.HBaseClassTestRule;<a name="line.29"></a>
+<span class="sourceLineNo">030</span>import 
org.apache.hadoop.hbase.HRegionInfo;<a name="line.30"></a>
+<span class="sourceLineNo">031</span>import 
org.apache.hadoop.hbase.HTableDescriptor;<a name="line.31"></a>
+<span class="sourceLineNo">032</span>import 
org.apache.hadoop.hbase.coprocessor.MasterCoprocessorEnvironment;<a 
name="line.32"></a>
+<span class="sourceLineNo">033</span>import 
org.apache.hadoop.hbase.coprocessor.ObserverContext;<a name="line.33"></a>
+<span class="sourceLineNo">034</span>import 
org.apache.hadoop.hbase.testclassification.SmallTests;<a name="line.34"></a>
+<span class="sourceLineNo">035</span>import 
org.apache.hadoop.hbase.tool.coprocessor.CoprocessorViolation.Severity;<a 
name="line.35"></a>
+<span class="sourceLineNo">036</span>import org.junit.ClassRule;<a 
name="line.36"></a>
+<span class="sourceLineNo">037</span>import org.junit.Test;<a 
name="line.37"></a>
+<span class="sourceLineNo">038</span>import 
org.junit.experimental.categories.Category;<a name="line.38"></a>
+<span class="sourceLineNo">039</span><a name="line.39"></a>
+<span class="sourceLineNo">040</span>import 
org.apache.hbase.thirdparty.com.google.common.collect.Lists;<a 
name="line.40"></a>
+<span class="sourceLineNo">041</span><a name="line.41"></a>
+<span class="sourceLineNo">042</span>@Category({ SmallTests.class })<a 
name="line.42"></a>
+<span class="sourceLineNo">043</span>@SuppressWarnings("deprecation")<a 
name="line.43"></a>
+<span class="sourceLineNo">044</span>public class CoprocessorValidatorTest {<a 
name="line.44"></a>
+<span class="sourceLineNo">045</span>  @ClassRule<a name="line.45"></a>
+<span class="sourceLineNo">046</span>  public static final HBaseClassTestRule 
CLASS_RULE =<a name="line.46"></a>
+<span class="sourceLineNo">047</span>      
HBaseClassTestRule.forClass(CoprocessorValidatorTest.class);<a 
name="line.47"></a>
+<span class="sourceLineNo">048</span><a name="line.48"></a>
+<span class="sourceLineNo">049</span>  private CoprocessorValidator 
validator;<a name="line.49"></a>
+<span class="sourceLineNo">050</span><a name="line.50"></a>
+<span class="sourceLineNo">051</span>  public CoprocessorValidatorTest() {<a 
name="line.51"></a>
+<span class="sourceLineNo">052</span>    validator = new 
CoprocessorValidator();<a name="line.52"></a>
+<span class="sourceLineNo">053</span>  }<a name="line.53"></a>
+<span class="sourceLineNo">054</span><a name="line.54"></a>
+<span class="sourceLineNo">055</span>  private static ClassLoader 
getClassLoader() {<a name="line.55"></a>
+<span class="sourceLineNo">056</span>    return 
CoprocessorValidatorTest.class.getClassLoader();<a name="line.56"></a>
+<span class="sourceLineNo">057</span>  }<a name="line.57"></a>
+<span class="sourceLineNo">058</span><a name="line.58"></a>
+<span class="sourceLineNo">059</span>  private static String 
getFullClassName(String className) {<a name="line.59"></a>
+<span class="sourceLineNo">060</span>    return 
CoprocessorValidatorTest.class.getName() + "$" + className;<a 
name="line.60"></a>
+<span class="sourceLineNo">061</span>  }<a name="line.61"></a>
+<span class="sourceLineNo">062</span><a name="line.62"></a>
+<span class="sourceLineNo">063</span>  @SuppressWarnings({"rawtypes", 
"unused"})<a name="line.63"></a>
+<span class="sourceLineNo">064</span>  private static class TestObserver 
implements Coprocessor {<a name="line.64"></a>
+<span class="sourceLineNo">065</span>    @Override<a name="line.65"></a>
+<span class="sourceLineNo">066</span>    public void 
start(CoprocessorEnvironment env) throws IOException {<a name="line.66"></a>
+<span class="sourceLineNo">067</span>    }<a name="line.67"></a>
+<span class="sourceLineNo">068</span><a name="line.68"></a>
+<span class="sourceLineNo">069</span>    @Override<a name="line.69"></a>
+<span class="sourceLineNo">070</span>    public void 
stop(CoprocessorEnvironment env) throws IOException {<a name="line.70"></a>
+<span class="sourceLineNo">071</span>    }<a name="line.71"></a>
+<span class="sourceLineNo">072</span>  }<a name="line.72"></a>
+<span class="sourceLineNo">073</span><a name="line.73"></a>
+<span class="sourceLineNo">074</span>  @Test<a name="line.74"></a>
+<span class="sourceLineNo">075</span>  public void testFilterObservers() 
throws Exception {<a name="line.75"></a>
+<span class="sourceLineNo">076</span>    String filterObservers = 
getFullClassName("TestObserver");<a name="line.76"></a>
+<span class="sourceLineNo">077</span>    List&lt;String&gt; classNames = 
Lists.newArrayList(<a name="line.77"></a>
+<span class="sourceLineNo">078</span>        filterObservers, 
getClass().getName());<a name="line.78"></a>
+<span class="sourceLineNo">079</span>    List&lt;String&gt; filteredClassNames 
= validator.filterObservers(getClassLoader(), classNames);<a name="line.79"></a>
+<span class="sourceLineNo">080</span><a name="line.80"></a>
+<span class="sourceLineNo">081</span>    assertEquals(1, 
filteredClassNames.size());<a name="line.81"></a>
+<span class="sourceLineNo">082</span>    assertEquals(filterObservers, 
filteredClassNames.get(0));<a name="line.82"></a>
+<span class="sourceLineNo">083</span>  }<a name="line.83"></a>
+<span class="sourceLineNo">084</span><a name="line.84"></a>
+<span class="sourceLineNo">085</span>  private 
List&lt;CoprocessorViolation&gt; validate(String className) {<a 
name="line.85"></a>
+<span class="sourceLineNo">086</span>    ClassLoader classLoader = 
getClass().getClassLoader();<a name="line.86"></a>
+<span class="sourceLineNo">087</span>    return validate(classLoader, 
className);<a name="line.87"></a>
+<span class="sourceLineNo">088</span>  }<a name="line.88"></a>
+<span class="sourceLineNo">089</span><a name="line.89"></a>
+<span class="sourceLineNo">090</span>  private 
List&lt;CoprocessorViolation&gt; validate(ClassLoader classLoader, String 
className) {<a name="line.90"></a>
+<span class="sourceLineNo">091</span>    List&lt;String&gt; classNames = 
Lists.newArrayList(getClass().getName() + "$" + className);<a 
name="line.91"></a>
+<span class="sourceLineNo">092</span>    return 
validator.validate(classLoader, classNames);<a name="line.92"></a>
+<span class="sourceLineNo">093</span>  }<a name="line.93"></a>
+<span class="sourceLineNo">094</span><a name="line.94"></a>
+<span class="sourceLineNo">095</span>  /*<a name="line.95"></a>
+<span class="sourceLineNo">096</span>   * In this test case, we are try to 
load a not-existent class.<a name="line.96"></a>
+<span class="sourceLineNo">097</span>   */<a name="line.97"></a>
+<span class="sourceLineNo">098</span>  @Test<a name="line.98"></a>
+<span class="sourceLineNo">099</span>  public void testNoSuchClass() throws 
IOException {<a name="line.99"></a>
+<span class="sourceLineNo">100</span>    List&lt;CoprocessorViolation&gt; 
violations = validate("NoSuchClass");<a name="line.100"></a>
+<span class="sourceLineNo">101</span>    assertEquals(1, violations.size());<a 
name="line.101"></a>
+<span class="sourceLineNo">102</span><a name="line.102"></a>
+<span class="sourceLineNo">103</span>    CoprocessorViolation violation = 
violations.get(0);<a name="line.103"></a>
+<span class="sourceLineNo">104</span>    assertEquals(Severity.ERROR, 
violation.getSeverity());<a name="line.104"></a>
+<span class="sourceLineNo">105</span>    
assertTrue(violation.getMessage().contains(<a name="line.105"></a>
+<span class="sourceLineNo">106</span>        
"java.lang.ClassNotFoundException: " +<a name="line.106"></a>
+<span class="sourceLineNo">107</span>        
"org.apache.hadoop.hbase.tool.coprocessor.CoprocessorValidatorTest$NoSuchClass"));<a
 name="line.107"></a>
+<span class="sourceLineNo">108</span>  }<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>   * In this test case, we are validating 
MissingClass coprocessor, which<a name="line.111"></a>
+<span class="sourceLineNo">112</span>   * references a missing class. With a 
special classloader, we prevent that<a name="line.112"></a>
+<span class="sourceLineNo">113</span>   * class to be loaded at runtime. It 
simulates similar cases where a class<a name="line.113"></a>
+<span class="sourceLineNo">114</span>   * is no more on our classpath.<a 
name="line.114"></a>
+<span class="sourceLineNo">115</span>   * E.g. 
org.apache.hadoop.hbase.regionserver.wal.WALEdit was moved to<a 
name="line.115"></a>
+<span class="sourceLineNo">116</span>   * org.apache.hadoop.hbase.wal, so 
class loading will fail on 2.0.<a name="line.116"></a>
+<span class="sourceLineNo">117</span>   */<a name="line.117"></a>
+<span class="sourceLineNo">118</span>  private static class MissingClass {<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>  @SuppressWarnings("unused")<a 
name="line.121"></a>
+<span class="sourceLineNo">122</span>  private static class 
MissingClassObserver {<a name="line.122"></a>
+<span class="sourceLineNo">123</span>    public void method(MissingClass 
missingClass) {<a name="line.123"></a>
+<span class="sourceLineNo">124</span>    }<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>  private static class 
MissingClassClassLoader extends ClassLoader {<a name="line.127"></a>
+<span class="sourceLineNo">128</span>    public MissingClassClassLoader() {<a 
name="line.128"></a>
+<span class="sourceLineNo">129</span>      super(getClassLoader());<a 
name="line.129"></a>
+<span class="sourceLineNo">130</span>    }<a name="line.130"></a>
+<span class="sourceLineNo">131</span><a name="line.131"></a>
+<span class="sourceLineNo">132</span>    @Override<a name="line.132"></a>
+<span class="sourceLineNo">133</span>    public Class&lt;?&gt; 
loadClass(String name) throws ClassNotFoundException {<a name="line.133"></a>
+<span class="sourceLineNo">134</span>      if 
(name.equals(getFullClassName("MissingClass"))) {<a name="line.134"></a>
+<span class="sourceLineNo">135</span>        throw new 
ClassNotFoundException(name);<a name="line.135"></a>
+<span class="sourceLineNo">136</span>      }<a name="line.136"></a>
+<span class="sourceLineNo">137</span><a name="line.137"></a>
+<span class="sourceLineNo">138</span>      return super.findClass(name);<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>
+<span class="sourceLineNo">141</span><a name="line.141"></a>
+<span class="sourceLineNo">142</span>  @Test<a name="line.142"></a>
+<span class="sourceLineNo">143</span>  public void testMissingClass() throws 
IOException {<a name="line.143"></a>
+<span class="sourceLineNo">144</span>    MissingClassClassLoader 
missingClassClassLoader = new MissingClassClassLoader();<a name="line.144"></a>
+<span class="sourceLineNo">145</span>    List&lt;CoprocessorViolation&gt; 
violations = validate(missingClassClassLoader,<a name="line.145"></a>
+<span class="sourceLineNo">146</span>        "MissingClassObserver");<a 
name="line.146"></a>
+<span class="sourceLineNo">147</span>    assertEquals(1, violations.size());<a 
name="line.147"></a>
+<span class="sourceLineNo">148</span><a name="line.148"></a>
+<span class="sourceLineNo">149</span>    CoprocessorViolation violation = 
violations.get(0);<a name="line.149"></a>
+<span class="sourceLineNo">150</span>    assertEquals(Severity.ERROR, 
violation.getSeverity());<a name="line.150"></a>
+<span class="sourceLineNo">151</span>    
assertTrue(violation.getMessage().contains(<a name="line.151"></a>
+<span class="sourceLineNo">152</span>        
"java.lang.ClassNotFoundException: " +<a name="line.152"></a>
+<span class="sourceLineNo">153</span>        
"org.apache.hadoop.hbase.tool.coprocessor.CoprocessorValidatorTest$MissingClass"));<a
 name="line.153"></a>
+<span class="sourceLineNo">154</span>  }<a name="line.154"></a>
+<span class="sourceLineNo">155</span><a name="line.155"></a>
+<span class="sourceLineNo">156</span>  /*<a name="line.156"></a>
+<span class="sourceLineNo">157</span>   * ObsoleteMethod coprocessor 
implements preCreateTable method which has<a name="line.157"></a>
+<span class="sourceLineNo">158</span>   * HRegionInfo parameters. In our 
current implementation, we pass only<a name="line.158"></a>
+<span class="sourceLineNo">159</span>   * RegionInfo parameters, so this 
method won't be called by HBase at all.<a name="line.159"></a>
+<span class="sourceLineNo">160</span>   */<a name="line.160"></a>
+<span class="sourceLineNo">161</span>  @SuppressWarnings("unused")<a 
name="line.161"></a>
+<span class="sourceLineNo">162</span>  private static class 
ObsoleteMethodObserver /* implements MasterObserver */ {<a name="line.162"></a>
+<span class="sourceLineNo">163</span>    public void 
preCreateTable(ObserverContext&lt;MasterCoprocessorEnvironment&gt; ctx,<a 
name="line.163"></a>
+<span class="sourceLineNo">164</span>        HTableDescriptor desc, 
HRegionInfo[] regions) throws IOException {<a name="line.164"></a>
+<span class="sourceLineNo">165</span>    }<a name="line.165"></a>
+<span class="sourceLineNo">166</span>  }<a name="line.166"></a>
+<span class="sourceLineNo">167</span><a name="line.167"></a>
+<span class="sourceLineNo">168</span>  @Test<a name="line.168"></a>
+<span class="sourceLineNo">169</span>  public void testObsoleteMethod() throws 
IOException {<a name="line.169"></a>
+<span class="sourceLineNo">170</span>    List&lt;CoprocessorViolation&gt; 
violations = validate("ObsoleteMethodObserver");<a name="line.170"></a>
+<span class="sourceLineNo">171</span>    assertEquals(1, violations.size());<a 
name="line.171"></a>
+<span class="sourceLineNo">172</span><a name="line.172"></a>
+<span class="sourceLineNo">173</span>    CoprocessorViolation violation = 
violations.get(0);<a name="line.173"></a>
+<span class="sourceLineNo">174</span>    assertEquals(Severity.WARNING, 
violation.getSeverity());<a name="line.174"></a>
+<span class="sourceLineNo">175</span>    
assertTrue(violation.getMessage().contains("was removed from new coprocessor 
API"));<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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+</pre>
+</div>
+</body>
+</html>

Reply via email to