http://git-wip-us.apache.org/repos/asf/hbase-site/blob/e5c3dcd1/devapidocs/src-html/org/apache/hadoop/hbase/ipc/AbstractRpcClient.html
----------------------------------------------------------------------
diff --git
a/devapidocs/src-html/org/apache/hadoop/hbase/ipc/AbstractRpcClient.html
b/devapidocs/src-html/org/apache/hadoop/hbase/ipc/AbstractRpcClient.html
index 5a41d78..f9da92e 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/ipc/AbstractRpcClient.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/ipc/AbstractRpcClient.html
@@ -32,278 +32,309 @@
<span class="sourceLineNo">024</span>import com.google.protobuf.Message;<a
name="line.24"></a>
<span class="sourceLineNo">025</span>import
com.google.protobuf.RpcController;<a name="line.25"></a>
<span class="sourceLineNo">026</span>import
com.google.protobuf.ServiceException;<a name="line.26"></a>
-<span class="sourceLineNo">027</span>import org.apache.commons.logging.Log;<a
name="line.27"></a>
-<span class="sourceLineNo">028</span>import
org.apache.commons.logging.LogFactory;<a name="line.28"></a>
-<span class="sourceLineNo">029</span>import
org.apache.hadoop.conf.Configuration;<a name="line.29"></a>
-<span class="sourceLineNo">030</span>import
org.apache.hadoop.hbase.CellScanner;<a name="line.30"></a>
-<span class="sourceLineNo">031</span>import
org.apache.hadoop.hbase.HConstants;<a name="line.31"></a>
-<span class="sourceLineNo">032</span>import
org.apache.hadoop.hbase.ServerName;<a name="line.32"></a>
-<span class="sourceLineNo">033</span>import
org.apache.hadoop.hbase.classification.InterfaceAudience;<a name="line.33"></a>
-<span class="sourceLineNo">034</span>import
org.apache.hadoop.hbase.client.MetricsConnection;<a name="line.34"></a>
-<span class="sourceLineNo">035</span>import
org.apache.hadoop.hbase.codec.Codec;<a name="line.35"></a>
-<span class="sourceLineNo">036</span>import
org.apache.hadoop.hbase.codec.KeyValueCodec;<a name="line.36"></a>
-<span class="sourceLineNo">037</span>import
org.apache.hadoop.hbase.security.User;<a name="line.37"></a>
-<span class="sourceLineNo">038</span>import
org.apache.hadoop.hbase.security.UserProvider;<a name="line.38"></a>
-<span class="sourceLineNo">039</span>import
org.apache.hadoop.hbase.util.EnvironmentEdgeManager;<a name="line.39"></a>
-<span class="sourceLineNo">040</span>import
org.apache.hadoop.hbase.util.Pair;<a name="line.40"></a>
-<span class="sourceLineNo">041</span>import
org.apache.hadoop.hbase.util.PoolMap;<a name="line.41"></a>
-<span class="sourceLineNo">042</span>import
org.apache.hadoop.io.compress.CompressionCodec;<a name="line.42"></a>
-<span class="sourceLineNo">043</span><a name="line.43"></a>
-<span class="sourceLineNo">044</span>import java.io.IOException;<a
name="line.44"></a>
-<span class="sourceLineNo">045</span>import java.net.InetSocketAddress;<a
name="line.45"></a>
-<span class="sourceLineNo">046</span>import java.net.SocketAddress;<a
name="line.46"></a>
-<span class="sourceLineNo">047</span><a name="line.47"></a>
-<span class="sourceLineNo">048</span>/**<a name="line.48"></a>
-<span class="sourceLineNo">049</span> * Provides the basics for a RpcClient
implementation like configuration and Logging.<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>public abstract class AbstractRpcClient
implements RpcClient {<a name="line.52"></a>
-<span class="sourceLineNo">053</span> // Log level is being changed in
tests<a name="line.53"></a>
-<span class="sourceLineNo">054</span> public static final Log LOG =
LogFactory.getLog(AbstractRpcClient.class);<a name="line.54"></a>
-<span class="sourceLineNo">055</span><a name="line.55"></a>
-<span class="sourceLineNo">056</span> protected final Configuration conf;<a
name="line.56"></a>
-<span class="sourceLineNo">057</span> protected String clusterId;<a
name="line.57"></a>
-<span class="sourceLineNo">058</span> protected final SocketAddress
localAddr;<a name="line.58"></a>
-<span class="sourceLineNo">059</span> protected final MetricsConnection
metrics;<a name="line.59"></a>
-<span class="sourceLineNo">060</span><a name="line.60"></a>
-<span class="sourceLineNo">061</span> protected UserProvider userProvider;<a
name="line.61"></a>
-<span class="sourceLineNo">062</span> protected final IPCUtil ipcUtil;<a
name="line.62"></a>
-<span class="sourceLineNo">063</span><a name="line.63"></a>
-<span class="sourceLineNo">064</span> protected final int
minIdleTimeBeforeClose; // if the connection is idle for more than this<a
name="line.64"></a>
-<span class="sourceLineNo">065</span> // time (in ms), it will be closed at
any moment.<a name="line.65"></a>
-<span class="sourceLineNo">066</span> protected final int maxRetries; //the
max. no. of retries for socket connections<a name="line.66"></a>
-<span class="sourceLineNo">067</span> protected final long failureSleep; //
Time to sleep before retry on failure.<a name="line.67"></a>
-<span class="sourceLineNo">068</span> protected final boolean tcpNoDelay; //
if T then disable Nagle's Algorithm<a name="line.68"></a>
-<span class="sourceLineNo">069</span> protected final boolean tcpKeepAlive;
// if T then use keepalives<a name="line.69"></a>
-<span class="sourceLineNo">070</span> protected final Codec codec;<a
name="line.70"></a>
-<span class="sourceLineNo">071</span> protected final CompressionCodec
compressor;<a name="line.71"></a>
-<span class="sourceLineNo">072</span> protected final boolean
fallbackAllowed;<a name="line.72"></a>
-<span class="sourceLineNo">073</span><a name="line.73"></a>
-<span class="sourceLineNo">074</span> protected final int connectTO;<a
name="line.74"></a>
-<span class="sourceLineNo">075</span> protected final int readTO;<a
name="line.75"></a>
-<span class="sourceLineNo">076</span> protected final int writeTO;<a
name="line.76"></a>
+<span class="sourceLineNo">027</span><a name="line.27"></a>
+<span class="sourceLineNo">028</span>import java.io.IOException;<a
name="line.28"></a>
+<span class="sourceLineNo">029</span>import java.net.ConnectException;<a
name="line.29"></a>
+<span class="sourceLineNo">030</span>import java.net.InetSocketAddress;<a
name="line.30"></a>
+<span class="sourceLineNo">031</span>import java.net.SocketAddress;<a
name="line.31"></a>
+<span class="sourceLineNo">032</span>import java.net.SocketTimeoutException;<a
name="line.32"></a>
+<span class="sourceLineNo">033</span><a name="line.33"></a>
+<span class="sourceLineNo">034</span>import org.apache.commons.logging.Log;<a
name="line.34"></a>
+<span class="sourceLineNo">035</span>import
org.apache.commons.logging.LogFactory;<a name="line.35"></a>
+<span class="sourceLineNo">036</span>import
org.apache.hadoop.conf.Configuration;<a name="line.36"></a>
+<span class="sourceLineNo">037</span>import
org.apache.hadoop.hbase.CellScanner;<a name="line.37"></a>
+<span class="sourceLineNo">038</span>import
org.apache.hadoop.hbase.HConstants;<a name="line.38"></a>
+<span class="sourceLineNo">039</span>import
org.apache.hadoop.hbase.ServerName;<a name="line.39"></a>
+<span class="sourceLineNo">040</span>import
org.apache.hadoop.hbase.classification.InterfaceAudience;<a name="line.40"></a>
+<span class="sourceLineNo">041</span>import
org.apache.hadoop.hbase.client.MetricsConnection;<a name="line.41"></a>
+<span class="sourceLineNo">042</span>import
org.apache.hadoop.hbase.codec.Codec;<a name="line.42"></a>
+<span class="sourceLineNo">043</span>import
org.apache.hadoop.hbase.codec.KeyValueCodec;<a name="line.43"></a>
+<span class="sourceLineNo">044</span>import
org.apache.hadoop.hbase.exceptions.ConnectionClosingException;<a
name="line.44"></a>
+<span class="sourceLineNo">045</span>import
org.apache.hadoop.hbase.security.User;<a name="line.45"></a>
+<span class="sourceLineNo">046</span>import
org.apache.hadoop.hbase.security.UserProvider;<a name="line.46"></a>
+<span class="sourceLineNo">047</span>import
org.apache.hadoop.hbase.util.EnvironmentEdgeManager;<a name="line.47"></a>
+<span class="sourceLineNo">048</span>import
org.apache.hadoop.hbase.util.Pair;<a name="line.48"></a>
+<span class="sourceLineNo">049</span>import
org.apache.hadoop.hbase.util.PoolMap;<a name="line.49"></a>
+<span class="sourceLineNo">050</span>import
org.apache.hadoop.io.compress.CompressionCodec;<a name="line.50"></a>
+<span class="sourceLineNo">051</span><a name="line.51"></a>
+<span class="sourceLineNo">052</span>/**<a name="line.52"></a>
+<span class="sourceLineNo">053</span> * Provides the basics for a RpcClient
implementation like configuration and Logging.<a name="line.53"></a>
+<span class="sourceLineNo">054</span> */<a name="line.54"></a>
+<span class="sourceLineNo">055</span>@InterfaceAudience.Private<a
name="line.55"></a>
+<span class="sourceLineNo">056</span>public abstract class AbstractRpcClient
implements RpcClient {<a name="line.56"></a>
+<span class="sourceLineNo">057</span> // Log level is being changed in
tests<a name="line.57"></a>
+<span class="sourceLineNo">058</span> public static final Log LOG =
LogFactory.getLog(AbstractRpcClient.class);<a name="line.58"></a>
+<span class="sourceLineNo">059</span><a name="line.59"></a>
+<span class="sourceLineNo">060</span> protected final Configuration conf;<a
name="line.60"></a>
+<span class="sourceLineNo">061</span> protected String clusterId;<a
name="line.61"></a>
+<span class="sourceLineNo">062</span> protected final SocketAddress
localAddr;<a name="line.62"></a>
+<span class="sourceLineNo">063</span> protected final MetricsConnection
metrics;<a name="line.63"></a>
+<span class="sourceLineNo">064</span><a name="line.64"></a>
+<span class="sourceLineNo">065</span> protected UserProvider userProvider;<a
name="line.65"></a>
+<span class="sourceLineNo">066</span> protected final IPCUtil ipcUtil;<a
name="line.66"></a>
+<span class="sourceLineNo">067</span><a name="line.67"></a>
+<span class="sourceLineNo">068</span> protected final int
minIdleTimeBeforeClose; // if the connection is idle for more than this<a
name="line.68"></a>
+<span class="sourceLineNo">069</span> // time (in ms), it will be closed at
any moment.<a name="line.69"></a>
+<span class="sourceLineNo">070</span> protected final int maxRetries; //the
max. no. of retries for socket connections<a name="line.70"></a>
+<span class="sourceLineNo">071</span> protected final long failureSleep; //
Time to sleep before retry on failure.<a name="line.71"></a>
+<span class="sourceLineNo">072</span> protected final boolean tcpNoDelay; //
if T then disable Nagle's Algorithm<a name="line.72"></a>
+<span class="sourceLineNo">073</span> protected final boolean tcpKeepAlive;
// if T then use keepalives<a name="line.73"></a>
+<span class="sourceLineNo">074</span> protected final Codec codec;<a
name="line.74"></a>
+<span class="sourceLineNo">075</span> protected final CompressionCodec
compressor;<a name="line.75"></a>
+<span class="sourceLineNo">076</span> protected final boolean
fallbackAllowed;<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> * Construct an IPC client for the
cluster <code>clusterId</code><a name="line.79"></a>
-<span class="sourceLineNo">080</span> *<a name="line.80"></a>
-<span class="sourceLineNo">081</span> * @param conf configuration<a
name="line.81"></a>
-<span class="sourceLineNo">082</span> * @param clusterId the cluster id<a
name="line.82"></a>
-<span class="sourceLineNo">083</span> * @param localAddr client socket bind
address.<a name="line.83"></a>
-<span class="sourceLineNo">084</span> * @param metrics the connection
metrics<a name="line.84"></a>
-<span class="sourceLineNo">085</span> */<a name="line.85"></a>
-<span class="sourceLineNo">086</span> public AbstractRpcClient(Configuration
conf, String clusterId, SocketAddress localAddr,<a name="line.86"></a>
-<span class="sourceLineNo">087</span> MetricsConnection metrics) {<a
name="line.87"></a>
-<span class="sourceLineNo">088</span> this.userProvider =
UserProvider.instantiate(conf);<a name="line.88"></a>
-<span class="sourceLineNo">089</span> this.localAddr = localAddr;<a
name="line.89"></a>
-<span class="sourceLineNo">090</span> this.tcpKeepAlive =
conf.getBoolean("hbase.ipc.client.tcpkeepalive", true);<a name="line.90"></a>
-<span class="sourceLineNo">091</span> this.clusterId = clusterId != null ?
clusterId : HConstants.CLUSTER_ID_DEFAULT;<a name="line.91"></a>
-<span class="sourceLineNo">092</span> this.failureSleep =
conf.getLong(HConstants.HBASE_CLIENT_PAUSE,<a name="line.92"></a>
-<span class="sourceLineNo">093</span>
HConstants.DEFAULT_HBASE_CLIENT_PAUSE);<a name="line.93"></a>
-<span class="sourceLineNo">094</span> this.maxRetries =
conf.getInt("hbase.ipc.client.connect.max.retries", 0);<a name="line.94"></a>
-<span class="sourceLineNo">095</span> this.tcpNoDelay =
conf.getBoolean("hbase.ipc.client.tcpnodelay", true);<a name="line.95"></a>
-<span class="sourceLineNo">096</span> this.ipcUtil = new IPCUtil(conf);<a
name="line.96"></a>
-<span class="sourceLineNo">097</span><a name="line.97"></a>
-<span class="sourceLineNo">098</span> this.minIdleTimeBeforeClose =
conf.getInt(IDLE_TIME, 120000); // 2 minutes<a name="line.98"></a>
-<span class="sourceLineNo">099</span> this.conf = conf;<a
name="line.99"></a>
-<span class="sourceLineNo">100</span> this.codec = getCodec();<a
name="line.100"></a>
-<span class="sourceLineNo">101</span> this.compressor =
getCompressor(conf);<a name="line.101"></a>
-<span class="sourceLineNo">102</span> this.fallbackAllowed =
conf.getBoolean(IPC_CLIENT_FALLBACK_TO_SIMPLE_AUTH_ALLOWED_KEY,<a
name="line.102"></a>
-<span class="sourceLineNo">103</span>
IPC_CLIENT_FALLBACK_TO_SIMPLE_AUTH_ALLOWED_DEFAULT);<a name="line.103"></a>
-<span class="sourceLineNo">104</span> this.connectTO =
conf.getInt(SOCKET_TIMEOUT_CONNECT, DEFAULT_SOCKET_TIMEOUT_CONNECT);<a
name="line.104"></a>
-<span class="sourceLineNo">105</span> this.readTO =
conf.getInt(SOCKET_TIMEOUT_READ, DEFAULT_SOCKET_TIMEOUT_READ);<a
name="line.105"></a>
-<span class="sourceLineNo">106</span> this.writeTO =
conf.getInt(SOCKET_TIMEOUT_WRITE, DEFAULT_SOCKET_TIMEOUT_WRITE);<a
name="line.106"></a>
-<span class="sourceLineNo">107</span> this.metrics = metrics;<a
name="line.107"></a>
-<span class="sourceLineNo">108</span><a name="line.108"></a>
-<span class="sourceLineNo">109</span> // login the server principal (if
using secure Hadoop)<a name="line.109"></a>
-<span class="sourceLineNo">110</span> if (LOG.isDebugEnabled()) {<a
name="line.110"></a>
-<span class="sourceLineNo">111</span> LOG.debug("Codec=" + this.codec +
", compressor=" + this.compressor +<a name="line.111"></a>
-<span class="sourceLineNo">112</span> ", tcpKeepAlive=" +
this.tcpKeepAlive +<a name="line.112"></a>
-<span class="sourceLineNo">113</span> ", tcpNoDelay=" +
this.tcpNoDelay +<a name="line.113"></a>
-<span class="sourceLineNo">114</span> ", connectTO=" + this.connectTO
+<a name="line.114"></a>
-<span class="sourceLineNo">115</span> ", readTO=" + this.readTO +<a
name="line.115"></a>
-<span class="sourceLineNo">116</span> ", writeTO=" + this.writeTO +<a
name="line.116"></a>
-<span class="sourceLineNo">117</span> ", minIdleTimeBeforeClose=" +
this.minIdleTimeBeforeClose +<a name="line.117"></a>
-<span class="sourceLineNo">118</span> ", maxRetries=" +
this.maxRetries +<a name="line.118"></a>
-<span class="sourceLineNo">119</span> ", fallbackAllowed=" +
this.fallbackAllowed +<a name="line.119"></a>
-<span class="sourceLineNo">120</span> ", bind address=" +
(this.localAddr != null ? this.localAddr : "null"));<a name="line.120"></a>
-<span class="sourceLineNo">121</span> }<a name="line.121"></a>
-<span class="sourceLineNo">122</span> }<a name="line.122"></a>
-<span class="sourceLineNo">123</span><a name="line.123"></a>
-<span class="sourceLineNo">124</span> @VisibleForTesting<a
name="line.124"></a>
-<span class="sourceLineNo">125</span> public static String
getDefaultCodec(final Configuration c) {<a name="line.125"></a>
-<span class="sourceLineNo">126</span> // If
"hbase.client.default.rpc.codec" is empty string -- you can't set it to null
because<a name="line.126"></a>
-<span class="sourceLineNo">127</span> // Configuration will complain --
then no default codec (and we'll pb everything). Else<a name="line.127"></a>
-<span class="sourceLineNo">128</span> // default is KeyValueCodec<a
name="line.128"></a>
-<span class="sourceLineNo">129</span> return c.get(DEFAULT_CODEC_CLASS,
KeyValueCodec.class.getCanonicalName());<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> /**<a name="line.132"></a>
-<span class="sourceLineNo">133</span> * Encapsulate the ugly casting and
RuntimeException conversion in private method.<a name="line.133"></a>
-<span class="sourceLineNo">134</span> * @return Codec to use on this
client.<a name="line.134"></a>
-<span class="sourceLineNo">135</span> */<a name="line.135"></a>
-<span class="sourceLineNo">136</span> Codec getCodec() {<a
name="line.136"></a>
-<span class="sourceLineNo">137</span> // For NO CODEC,
"hbase.client.rpc.codec" must be configured with empty string AND<a
name="line.137"></a>
-<span class="sourceLineNo">138</span> // "hbase.client.default.rpc.codec"
also -- because default is to do cell block encoding.<a name="line.138"></a>
-<span class="sourceLineNo">139</span> String className =
conf.get(HConstants.RPC_CODEC_CONF_KEY, getDefaultCodec(this.conf));<a
name="line.139"></a>
-<span class="sourceLineNo">140</span> if (className == null ||
className.length() == 0) return null;<a name="line.140"></a>
-<span class="sourceLineNo">141</span> try {<a name="line.141"></a>
-<span class="sourceLineNo">142</span> return
(Codec)Class.forName(className).newInstance();<a name="line.142"></a>
-<span class="sourceLineNo">143</span> } catch (Exception e) {<a
name="line.143"></a>
-<span class="sourceLineNo">144</span> throw new RuntimeException("Failed
getting codec " + className, e);<a name="line.144"></a>
-<span class="sourceLineNo">145</span> }<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> /**<a name="line.148"></a>
-<span class="sourceLineNo">149</span> * Encapsulate the ugly casting and
RuntimeException conversion in private method.<a name="line.149"></a>
-<span class="sourceLineNo">150</span> * @param conf configuration<a
name="line.150"></a>
-<span class="sourceLineNo">151</span> * @return The compressor to use on
this client.<a name="line.151"></a>
-<span class="sourceLineNo">152</span> */<a name="line.152"></a>
-<span class="sourceLineNo">153</span> private static CompressionCodec
getCompressor(final Configuration conf) {<a name="line.153"></a>
-<span class="sourceLineNo">154</span> String className =
conf.get("hbase.client.rpc.compressor", null);<a name="line.154"></a>
-<span class="sourceLineNo">155</span> if (className == null ||
className.isEmpty()) return null;<a name="line.155"></a>
-<span class="sourceLineNo">156</span> try {<a name="line.156"></a>
-<span class="sourceLineNo">157</span> return
(CompressionCodec)Class.forName(className).newInstance();<a name="line.157"></a>
-<span class="sourceLineNo">158</span> } catch (Exception e) {<a
name="line.158"></a>
-<span class="sourceLineNo">159</span> throw new RuntimeException("Failed
getting compressor " + className, e);<a name="line.159"></a>
-<span class="sourceLineNo">160</span> }<a name="line.160"></a>
-<span class="sourceLineNo">161</span> }<a name="line.161"></a>
-<span class="sourceLineNo">162</span><a name="line.162"></a>
-<span class="sourceLineNo">163</span> /**<a name="line.163"></a>
-<span class="sourceLineNo">164</span> * Return the pool type specified in
the configuration, which must be set to<a name="line.164"></a>
-<span class="sourceLineNo">165</span> * either {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#RoundRobin} or<a
name="line.165"></a>
-<span class="sourceLineNo">166</span> * {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#ThreadLocal},<a
name="line.166"></a>
-<span class="sourceLineNo">167</span> * otherwise default to the former.<a
name="line.167"></a>
-<span class="sourceLineNo">168</span> *<a name="line.168"></a>
-<span class="sourceLineNo">169</span> * For applications with many user
threads, use a small round-robin pool. For<a name="line.169"></a>
-<span class="sourceLineNo">170</span> * applications with few user threads,
you may want to try using a<a name="line.170"></a>
-<span class="sourceLineNo">171</span> * thread-local pool. In any case, the
number of {@link org.apache.hadoop.hbase.ipc.RpcClient}<a name="line.171"></a>
-<span class="sourceLineNo">172</span> * instances should not exceed the
operating system's hard limit on the number of<a name="line.172"></a>
-<span class="sourceLineNo">173</span> * connections.<a name="line.173"></a>
-<span class="sourceLineNo">174</span> *<a name="line.174"></a>
-<span class="sourceLineNo">175</span> * @param config configuration<a
name="line.175"></a>
-<span class="sourceLineNo">176</span> * @return either a {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#RoundRobin} or<a
name="line.176"></a>
-<span class="sourceLineNo">177</span> * {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#ThreadLocal}<a
name="line.177"></a>
-<span class="sourceLineNo">178</span> */<a name="line.178"></a>
-<span class="sourceLineNo">179</span> protected static PoolMap.PoolType
getPoolType(Configuration config) {<a name="line.179"></a>
-<span class="sourceLineNo">180</span> return PoolMap.PoolType<a
name="line.180"></a>
-<span class="sourceLineNo">181</span>
.valueOf(config.get(HConstants.HBASE_CLIENT_IPC_POOL_TYPE),
PoolMap.PoolType.RoundRobin,<a name="line.181"></a>
-<span class="sourceLineNo">182</span>
PoolMap.PoolType.ThreadLocal);<a name="line.182"></a>
-<span class="sourceLineNo">183</span> }<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> * Return the pool size specified in
the configuration, which is applicable only if<a name="line.186"></a>
-<span class="sourceLineNo">187</span> * the pool type is {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#RoundRobin}.<a
name="line.187"></a>
-<span class="sourceLineNo">188</span> *<a name="line.188"></a>
-<span class="sourceLineNo">189</span> * @param config configuration<a
name="line.189"></a>
-<span class="sourceLineNo">190</span> * @return the maximum pool size<a
name="line.190"></a>
-<span class="sourceLineNo">191</span> */<a name="line.191"></a>
-<span class="sourceLineNo">192</span> protected static int
getPoolSize(Configuration config) {<a name="line.192"></a>
-<span class="sourceLineNo">193</span> return
config.getInt(HConstants.HBASE_CLIENT_IPC_POOL_SIZE, 1);<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> /**<a name="line.196"></a>
-<span class="sourceLineNo">197</span> * Make a blocking call. Throws
exceptions if there are network problems or if the remote code<a
name="line.197"></a>
-<span class="sourceLineNo">198</span> * threw an exception.<a
name="line.198"></a>
-<span class="sourceLineNo">199</span> *<a name="line.199"></a>
-<span class="sourceLineNo">200</span> * @param ticket Be careful which
ticket you pass. A new user will mean a new Connection.<a name="line.200"></a>
-<span class="sourceLineNo">201</span> * {@link
UserProvider#getCurrent()} makes a new instance of User each time so<a
name="line.201"></a>
-<span class="sourceLineNo">202</span> * will be a<a
name="line.202"></a>
-<span class="sourceLineNo">203</span> * new Connection each
time.<a name="line.203"></a>
-<span class="sourceLineNo">204</span> * @return A pair with the Message
response and the Cell data (if any).<a name="line.204"></a>
-<span class="sourceLineNo">205</span> */<a name="line.205"></a>
-<span class="sourceLineNo">206</span> Message
callBlockingMethod(Descriptors.MethodDescriptor md,
PayloadCarryingRpcController pcrc,<a name="line.206"></a>
-<span class="sourceLineNo">207</span> Message param, Message returnType,
final User ticket, final InetSocketAddress isa)<a name="line.207"></a>
-<span class="sourceLineNo">208</span> throws ServiceException {<a
name="line.208"></a>
-<span class="sourceLineNo">209</span> if (pcrc == null) {<a
name="line.209"></a>
-<span class="sourceLineNo">210</span> pcrc = new
PayloadCarryingRpcController();<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> Pair<Message, CellScanner>
val;<a name="line.213"></a>
-<span class="sourceLineNo">214</span> try {<a name="line.214"></a>
-<span class="sourceLineNo">215</span> final MetricsConnection.CallStats
cs = MetricsConnection.newCallStats();<a name="line.215"></a>
-<span class="sourceLineNo">216</span>
cs.setStartTime(EnvironmentEdgeManager.currentTime());<a name="line.216"></a>
-<span class="sourceLineNo">217</span> val = call(pcrc, md, param,
returnType, ticket, isa, cs);<a name="line.217"></a>
-<span class="sourceLineNo">218</span> // Shove the results into
controller so can be carried across the proxy/pb service void.<a
name="line.218"></a>
-<span class="sourceLineNo">219</span>
pcrc.setCellScanner(val.getSecond());<a name="line.219"></a>
-<span class="sourceLineNo">220</span><a name="line.220"></a>
-<span class="sourceLineNo">221</span>
cs.setCallTimeMs(EnvironmentEdgeManager.currentTime() - cs.getStartTime());<a
name="line.221"></a>
-<span class="sourceLineNo">222</span> if (metrics != null) {<a
name="line.222"></a>
-<span class="sourceLineNo">223</span> metrics.updateRpc(md, param,
cs);<a name="line.223"></a>
-<span class="sourceLineNo">224</span> }<a name="line.224"></a>
-<span class="sourceLineNo">225</span> if (LOG.isTraceEnabled()) {<a
name="line.225"></a>
-<span class="sourceLineNo">226</span> LOG.trace("Call: " + md.getName()
+ ", callTime: " + cs.getCallTimeMs() + "ms");<a name="line.226"></a>
-<span class="sourceLineNo">227</span> }<a name="line.227"></a>
-<span class="sourceLineNo">228</span> return val.getFirst();<a
name="line.228"></a>
-<span class="sourceLineNo">229</span> } catch (Throwable e) {<a
name="line.229"></a>
-<span class="sourceLineNo">230</span> throw new ServiceException(e);<a
name="line.230"></a>
-<span class="sourceLineNo">231</span> }<a name="line.231"></a>
-<span class="sourceLineNo">232</span> }<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> * Make a call, passing
<code>param</code>, to the IPC server running at<a
name="line.235"></a>
-<span class="sourceLineNo">236</span> * <code>address</code>
which is servicing the <code>protocol</code> protocol,<a
name="line.236"></a>
-<span class="sourceLineNo">237</span> * with the
<code>ticket</code> credentials, returning the value.<a
name="line.237"></a>
-<span class="sourceLineNo">238</span> * Throws exceptions if there are
network problems or if the remote code<a name="line.238"></a>
-<span class="sourceLineNo">239</span> * threw an exception.<a
name="line.239"></a>
-<span class="sourceLineNo">240</span> *<a name="line.240"></a>
-<span class="sourceLineNo">241</span> * @param ticket Be careful which
ticket you pass. A new user will mean a new Connection.<a name="line.241"></a>
-<span class="sourceLineNo">242</span> * {@link
UserProvider#getCurrent()} makes a new instance of User each time so<a
name="line.242"></a>
-<span class="sourceLineNo">243</span> * will be a<a
name="line.243"></a>
-<span class="sourceLineNo">244</span> * new Connection each
time.<a name="line.244"></a>
-<span class="sourceLineNo">245</span> * @return A pair with the Message
response and the Cell data (if any).<a name="line.245"></a>
-<span class="sourceLineNo">246</span> * @throws InterruptedException<a
name="line.246"></a>
-<span class="sourceLineNo">247</span> * @throws java.io.IOException<a
name="line.247"></a>
-<span class="sourceLineNo">248</span> */<a name="line.248"></a>
-<span class="sourceLineNo">249</span> protected abstract Pair<Message,
CellScanner> call(PayloadCarryingRpcController pcrc,<a name="line.249"></a>
-<span class="sourceLineNo">250</span> Descriptors.MethodDescriptor md,
Message param, Message returnType, User ticket,<a name="line.250"></a>
-<span class="sourceLineNo">251</span> InetSocketAddress isa,
MetricsConnection.CallStats callStats)<a name="line.251"></a>
-<span class="sourceLineNo">252</span> throws IOException,
InterruptedException;<a name="line.252"></a>
-<span class="sourceLineNo">253</span><a name="line.253"></a>
-<span class="sourceLineNo">254</span> @Override<a name="line.254"></a>
-<span class="sourceLineNo">255</span> public BlockingRpcChannel
createBlockingRpcChannel(final ServerName sn, final User ticket,<a
name="line.255"></a>
-<span class="sourceLineNo">256</span> int defaultOperationTimeout) {<a
name="line.256"></a>
-<span class="sourceLineNo">257</span> return new
BlockingRpcChannelImplementation(this, sn, ticket, defaultOperationTimeout);<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> /**<a name="line.260"></a>
-<span class="sourceLineNo">261</span> * Blocking rpc channel that goes via
hbase rpc.<a name="line.261"></a>
-<span class="sourceLineNo">262</span> */<a name="line.262"></a>
-<span class="sourceLineNo">263</span> @VisibleForTesting<a
name="line.263"></a>
-<span class="sourceLineNo">264</span> public static class
BlockingRpcChannelImplementation implements BlockingRpcChannel {<a
name="line.264"></a>
-<span class="sourceLineNo">265</span> private final InetSocketAddress
isa;<a name="line.265"></a>
-<span class="sourceLineNo">266</span> private final AbstractRpcClient
rpcClient;<a name="line.266"></a>
-<span class="sourceLineNo">267</span> private final User ticket;<a
name="line.267"></a>
-<span class="sourceLineNo">268</span> private final int
channelOperationTimeout;<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> * @param channelOperationTimeout -
the default timeout when no timeout is given<a name="line.271"></a>
-<span class="sourceLineNo">272</span> */<a name="line.272"></a>
-<span class="sourceLineNo">273</span> protected
BlockingRpcChannelImplementation(final AbstractRpcClient rpcClient,<a
name="line.273"></a>
-<span class="sourceLineNo">274</span> final ServerName sn, final User
ticket, int channelOperationTimeout) {<a name="line.274"></a>
-<span class="sourceLineNo">275</span> this.isa = new
InetSocketAddress(sn.getHostname(), sn.getPort());<a name="line.275"></a>
-<span class="sourceLineNo">276</span> this.rpcClient = rpcClient;<a
name="line.276"></a>
-<span class="sourceLineNo">277</span> this.ticket = ticket;<a
name="line.277"></a>
-<span class="sourceLineNo">278</span> this.channelOperationTimeout =
channelOperationTimeout;<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> @Override<a name="line.281"></a>
-<span class="sourceLineNo">282</span> public Message
callBlockingMethod(Descriptors.MethodDescriptor md, RpcController controller,<a
name="line.282"></a>
-<span class="sourceLineNo">283</span> Message param, Message
returnType) throws ServiceException {<a name="line.283"></a>
-<span class="sourceLineNo">284</span> PayloadCarryingRpcController
pcrc;<a name="line.284"></a>
-<span class="sourceLineNo">285</span> if (controller != null) {<a
name="line.285"></a>
-<span class="sourceLineNo">286</span> pcrc =
(PayloadCarryingRpcController) controller;<a name="line.286"></a>
-<span class="sourceLineNo">287</span> if (!pcrc.hasCallTimeout()) {<a
name="line.287"></a>
-<span class="sourceLineNo">288</span>
pcrc.setCallTimeout(channelOperationTimeout);<a name="line.288"></a>
-<span class="sourceLineNo">289</span> }<a name="line.289"></a>
-<span class="sourceLineNo">290</span> } else {<a name="line.290"></a>
-<span class="sourceLineNo">291</span> pcrc = new
PayloadCarryingRpcController();<a name="line.291"></a>
-<span class="sourceLineNo">292</span>
pcrc.setCallTimeout(channelOperationTimeout);<a name="line.292"></a>
-<span class="sourceLineNo">293</span> }<a name="line.293"></a>
-<span class="sourceLineNo">294</span><a name="line.294"></a>
-<span class="sourceLineNo">295</span> return
this.rpcClient.callBlockingMethod(md, pcrc, param, returnType, this.ticket,
this.isa);<a name="line.295"></a>
-<span class="sourceLineNo">296</span> }<a name="line.296"></a>
-<span class="sourceLineNo">297</span> }<a name="line.297"></a>
-<span class="sourceLineNo">298</span>}<a name="line.298"></a>
+<span class="sourceLineNo">078</span> protected final int connectTO;<a
name="line.78"></a>
+<span class="sourceLineNo">079</span> protected final int readTO;<a
name="line.79"></a>
+<span class="sourceLineNo">080</span> protected final int writeTO;<a
name="line.80"></a>
+<span class="sourceLineNo">081</span><a name="line.81"></a>
+<span class="sourceLineNo">082</span> /**<a name="line.82"></a>
+<span class="sourceLineNo">083</span> * Construct an IPC client for the
cluster <code>clusterId</code><a name="line.83"></a>
+<span class="sourceLineNo">084</span> *<a name="line.84"></a>
+<span class="sourceLineNo">085</span> * @param conf configuration<a
name="line.85"></a>
+<span class="sourceLineNo">086</span> * @param clusterId the cluster id<a
name="line.86"></a>
+<span class="sourceLineNo">087</span> * @param localAddr client socket bind
address.<a name="line.87"></a>
+<span class="sourceLineNo">088</span> * @param metrics the connection
metrics<a name="line.88"></a>
+<span class="sourceLineNo">089</span> */<a name="line.89"></a>
+<span class="sourceLineNo">090</span> public AbstractRpcClient(Configuration
conf, String clusterId, SocketAddress localAddr,<a name="line.90"></a>
+<span class="sourceLineNo">091</span> MetricsConnection metrics) {<a
name="line.91"></a>
+<span class="sourceLineNo">092</span> this.userProvider =
UserProvider.instantiate(conf);<a name="line.92"></a>
+<span class="sourceLineNo">093</span> this.localAddr = localAddr;<a
name="line.93"></a>
+<span class="sourceLineNo">094</span> this.tcpKeepAlive =
conf.getBoolean("hbase.ipc.client.tcpkeepalive", true);<a name="line.94"></a>
+<span class="sourceLineNo">095</span> this.clusterId = clusterId != null ?
clusterId : HConstants.CLUSTER_ID_DEFAULT;<a name="line.95"></a>
+<span class="sourceLineNo">096</span> this.failureSleep =
conf.getLong(HConstants.HBASE_CLIENT_PAUSE,<a name="line.96"></a>
+<span class="sourceLineNo">097</span>
HConstants.DEFAULT_HBASE_CLIENT_PAUSE);<a name="line.97"></a>
+<span class="sourceLineNo">098</span> this.maxRetries =
conf.getInt("hbase.ipc.client.connect.max.retries", 0);<a name="line.98"></a>
+<span class="sourceLineNo">099</span> this.tcpNoDelay =
conf.getBoolean("hbase.ipc.client.tcpnodelay", true);<a name="line.99"></a>
+<span class="sourceLineNo">100</span> this.ipcUtil = new IPCUtil(conf);<a
name="line.100"></a>
+<span class="sourceLineNo">101</span><a name="line.101"></a>
+<span class="sourceLineNo">102</span> this.minIdleTimeBeforeClose =
conf.getInt(IDLE_TIME, 120000); // 2 minutes<a name="line.102"></a>
+<span class="sourceLineNo">103</span> this.conf = conf;<a
name="line.103"></a>
+<span class="sourceLineNo">104</span> this.codec = getCodec();<a
name="line.104"></a>
+<span class="sourceLineNo">105</span> this.compressor =
getCompressor(conf);<a name="line.105"></a>
+<span class="sourceLineNo">106</span> this.fallbackAllowed =
conf.getBoolean(IPC_CLIENT_FALLBACK_TO_SIMPLE_AUTH_ALLOWED_KEY,<a
name="line.106"></a>
+<span class="sourceLineNo">107</span>
IPC_CLIENT_FALLBACK_TO_SIMPLE_AUTH_ALLOWED_DEFAULT);<a name="line.107"></a>
+<span class="sourceLineNo">108</span> this.connectTO =
conf.getInt(SOCKET_TIMEOUT_CONNECT, DEFAULT_SOCKET_TIMEOUT_CONNECT);<a
name="line.108"></a>
+<span class="sourceLineNo">109</span> this.readTO =
conf.getInt(SOCKET_TIMEOUT_READ, DEFAULT_SOCKET_TIMEOUT_READ);<a
name="line.109"></a>
+<span class="sourceLineNo">110</span> this.writeTO =
conf.getInt(SOCKET_TIMEOUT_WRITE, DEFAULT_SOCKET_TIMEOUT_WRITE);<a
name="line.110"></a>
+<span class="sourceLineNo">111</span> this.metrics = metrics;<a
name="line.111"></a>
+<span class="sourceLineNo">112</span><a name="line.112"></a>
+<span class="sourceLineNo">113</span> // login the server principal (if
using secure Hadoop)<a name="line.113"></a>
+<span class="sourceLineNo">114</span> if (LOG.isDebugEnabled()) {<a
name="line.114"></a>
+<span class="sourceLineNo">115</span> LOG.debug("Codec=" + this.codec +
", compressor=" + this.compressor +<a name="line.115"></a>
+<span class="sourceLineNo">116</span> ", tcpKeepAlive=" +
this.tcpKeepAlive +<a name="line.116"></a>
+<span class="sourceLineNo">117</span> ", tcpNoDelay=" +
this.tcpNoDelay +<a name="line.117"></a>
+<span class="sourceLineNo">118</span> ", connectTO=" + this.connectTO
+<a name="line.118"></a>
+<span class="sourceLineNo">119</span> ", readTO=" + this.readTO +<a
name="line.119"></a>
+<span class="sourceLineNo">120</span> ", writeTO=" + this.writeTO +<a
name="line.120"></a>
+<span class="sourceLineNo">121</span> ", minIdleTimeBeforeClose=" +
this.minIdleTimeBeforeClose +<a name="line.121"></a>
+<span class="sourceLineNo">122</span> ", maxRetries=" +
this.maxRetries +<a name="line.122"></a>
+<span class="sourceLineNo">123</span> ", fallbackAllowed=" +
this.fallbackAllowed +<a name="line.123"></a>
+<span class="sourceLineNo">124</span> ", bind address=" +
(this.localAddr != null ? this.localAddr : "null"));<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> @VisibleForTesting<a
name="line.128"></a>
+<span class="sourceLineNo">129</span> public static String
getDefaultCodec(final Configuration c) {<a name="line.129"></a>
+<span class="sourceLineNo">130</span> // If
"hbase.client.default.rpc.codec" is empty string -- you can't set it to null
because<a name="line.130"></a>
+<span class="sourceLineNo">131</span> // Configuration will complain --
then no default codec (and we'll pb everything). Else<a name="line.131"></a>
+<span class="sourceLineNo">132</span> // default is KeyValueCodec<a
name="line.132"></a>
+<span class="sourceLineNo">133</span> return c.get(DEFAULT_CODEC_CLASS,
KeyValueCodec.class.getCanonicalName());<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> * Encapsulate the ugly casting and
RuntimeException conversion in private method.<a name="line.137"></a>
+<span class="sourceLineNo">138</span> * @return Codec to use on this
client.<a name="line.138"></a>
+<span class="sourceLineNo">139</span> */<a name="line.139"></a>
+<span class="sourceLineNo">140</span> Codec getCodec() {<a
name="line.140"></a>
+<span class="sourceLineNo">141</span> // For NO CODEC,
"hbase.client.rpc.codec" must be configured with empty string AND<a
name="line.141"></a>
+<span class="sourceLineNo">142</span> // "hbase.client.default.rpc.codec"
also -- because default is to do cell block encoding.<a name="line.142"></a>
+<span class="sourceLineNo">143</span> String className =
conf.get(HConstants.RPC_CODEC_CONF_KEY, getDefaultCodec(this.conf));<a
name="line.143"></a>
+<span class="sourceLineNo">144</span> if (className == null ||
className.length() == 0) return null;<a name="line.144"></a>
+<span class="sourceLineNo">145</span> try {<a name="line.145"></a>
+<span class="sourceLineNo">146</span> return
(Codec)Class.forName(className).newInstance();<a name="line.146"></a>
+<span class="sourceLineNo">147</span> } catch (Exception e) {<a
name="line.147"></a>
+<span class="sourceLineNo">148</span> throw new RuntimeException("Failed
getting codec " + className, e);<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> /**<a name="line.152"></a>
+<span class="sourceLineNo">153</span> * Encapsulate the ugly casting and
RuntimeException conversion in private method.<a name="line.153"></a>
+<span class="sourceLineNo">154</span> * @param conf configuration<a
name="line.154"></a>
+<span class="sourceLineNo">155</span> * @return The compressor to use on
this client.<a name="line.155"></a>
+<span class="sourceLineNo">156</span> */<a name="line.156"></a>
+<span class="sourceLineNo">157</span> private static CompressionCodec
getCompressor(final Configuration conf) {<a name="line.157"></a>
+<span class="sourceLineNo">158</span> String className =
conf.get("hbase.client.rpc.compressor", null);<a name="line.158"></a>
+<span class="sourceLineNo">159</span> if (className == null ||
className.isEmpty()) return null;<a name="line.159"></a>
+<span class="sourceLineNo">160</span> try {<a name="line.160"></a>
+<span class="sourceLineNo">161</span> return
(CompressionCodec)Class.forName(className).newInstance();<a name="line.161"></a>
+<span class="sourceLineNo">162</span> } catch (Exception e) {<a
name="line.162"></a>
+<span class="sourceLineNo">163</span> throw new RuntimeException("Failed
getting compressor " + className, e);<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><a name="line.166"></a>
+<span class="sourceLineNo">167</span> /**<a name="line.167"></a>
+<span class="sourceLineNo">168</span> * Return the pool type specified in
the configuration, which must be set to<a name="line.168"></a>
+<span class="sourceLineNo">169</span> * either {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#RoundRobin} or<a
name="line.169"></a>
+<span class="sourceLineNo">170</span> * {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#ThreadLocal},<a
name="line.170"></a>
+<span class="sourceLineNo">171</span> * otherwise default to the former.<a
name="line.171"></a>
+<span class="sourceLineNo">172</span> *<a name="line.172"></a>
+<span class="sourceLineNo">173</span> * For applications with many user
threads, use a small round-robin pool. For<a name="line.173"></a>
+<span class="sourceLineNo">174</span> * applications with few user threads,
you may want to try using a<a name="line.174"></a>
+<span class="sourceLineNo">175</span> * thread-local pool. In any case, the
number of {@link org.apache.hadoop.hbase.ipc.RpcClient}<a name="line.175"></a>
+<span class="sourceLineNo">176</span> * instances should not exceed the
operating system's hard limit on the number of<a name="line.176"></a>
+<span class="sourceLineNo">177</span> * connections.<a name="line.177"></a>
+<span class="sourceLineNo">178</span> *<a name="line.178"></a>
+<span class="sourceLineNo">179</span> * @param config configuration<a
name="line.179"></a>
+<span class="sourceLineNo">180</span> * @return either a {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#RoundRobin} or<a
name="line.180"></a>
+<span class="sourceLineNo">181</span> * {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#ThreadLocal}<a
name="line.181"></a>
+<span class="sourceLineNo">182</span> */<a name="line.182"></a>
+<span class="sourceLineNo">183</span> protected static PoolMap.PoolType
getPoolType(Configuration config) {<a name="line.183"></a>
+<span class="sourceLineNo">184</span> return PoolMap.PoolType<a
name="line.184"></a>
+<span class="sourceLineNo">185</span>
.valueOf(config.get(HConstants.HBASE_CLIENT_IPC_POOL_TYPE),
PoolMap.PoolType.RoundRobin,<a name="line.185"></a>
+<span class="sourceLineNo">186</span>
PoolMap.PoolType.ThreadLocal);<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> /**<a name="line.189"></a>
+<span class="sourceLineNo">190</span> * Return the pool size specified in
the configuration, which is applicable only if<a name="line.190"></a>
+<span class="sourceLineNo">191</span> * the pool type is {@link
org.apache.hadoop.hbase.util.PoolMap.PoolType#RoundRobin}.<a
name="line.191"></a>
+<span class="sourceLineNo">192</span> *<a name="line.192"></a>
+<span class="sourceLineNo">193</span> * @param config configuration<a
name="line.193"></a>
+<span class="sourceLineNo">194</span> * @return the maximum pool size<a
name="line.194"></a>
+<span class="sourceLineNo">195</span> */<a name="line.195"></a>
+<span class="sourceLineNo">196</span> protected static int
getPoolSize(Configuration config) {<a name="line.196"></a>
+<span class="sourceLineNo">197</span> return
config.getInt(HConstants.HBASE_CLIENT_IPC_POOL_SIZE, 1);<a name="line.197"></a>
+<span class="sourceLineNo">198</span> }<a name="line.198"></a>
+<span class="sourceLineNo">199</span><a name="line.199"></a>
+<span class="sourceLineNo">200</span> /**<a name="line.200"></a>
+<span class="sourceLineNo">201</span> * Make a blocking call. Throws
exceptions if there are network problems or if the remote code<a
name="line.201"></a>
+<span class="sourceLineNo">202</span> * threw an exception.<a
name="line.202"></a>
+<span class="sourceLineNo">203</span> *<a name="line.203"></a>
+<span class="sourceLineNo">204</span> * @param ticket Be careful which
ticket you pass. A new user will mean a new Connection.<a name="line.204"></a>
+<span class="sourceLineNo">205</span> * {@link
UserProvider#getCurrent()} makes a new instance of User each time so<a
name="line.205"></a>
+<span class="sourceLineNo">206</span> * will be a<a
name="line.206"></a>
+<span class="sourceLineNo">207</span> * new Connection each
time.<a name="line.207"></a>
+<span class="sourceLineNo">208</span> * @return A pair with the Message
response and the Cell data (if any).<a name="line.208"></a>
+<span class="sourceLineNo">209</span> */<a name="line.209"></a>
+<span class="sourceLineNo">210</span> Message
callBlockingMethod(Descriptors.MethodDescriptor md,
PayloadCarryingRpcController pcrc,<a name="line.210"></a>
+<span class="sourceLineNo">211</span> Message param, Message returnType,
final User ticket, final InetSocketAddress isa)<a name="line.211"></a>
+<span class="sourceLineNo">212</span> throws ServiceException {<a
name="line.212"></a>
+<span class="sourceLineNo">213</span> if (pcrc == null) {<a
name="line.213"></a>
+<span class="sourceLineNo">214</span> pcrc = new
PayloadCarryingRpcController();<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> Pair<Message, CellScanner>
val;<a name="line.217"></a>
+<span class="sourceLineNo">218</span> try {<a name="line.218"></a>
+<span class="sourceLineNo">219</span> final MetricsConnection.CallStats
cs = MetricsConnection.newCallStats();<a name="line.219"></a>
+<span class="sourceLineNo">220</span>
cs.setStartTime(EnvironmentEdgeManager.currentTime());<a name="line.220"></a>
+<span class="sourceLineNo">221</span> val = call(pcrc, md, param,
returnType, ticket, isa, cs);<a name="line.221"></a>
+<span class="sourceLineNo">222</span> // Shove the results into
controller so can be carried across the proxy/pb service void.<a
name="line.222"></a>
+<span class="sourceLineNo">223</span>
pcrc.setCellScanner(val.getSecond());<a name="line.223"></a>
+<span class="sourceLineNo">224</span><a name="line.224"></a>
+<span class="sourceLineNo">225</span>
cs.setCallTimeMs(EnvironmentEdgeManager.currentTime() - cs.getStartTime());<a
name="line.225"></a>
+<span class="sourceLineNo">226</span> if (metrics != null) {<a
name="line.226"></a>
+<span class="sourceLineNo">227</span> metrics.updateRpc(md, param,
cs);<a name="line.227"></a>
+<span class="sourceLineNo">228</span> }<a name="line.228"></a>
+<span class="sourceLineNo">229</span> if (LOG.isTraceEnabled()) {<a
name="line.229"></a>
+<span class="sourceLineNo">230</span> LOG.trace("Call: " + md.getName()
+ ", callTime: " + cs.getCallTimeMs() + "ms");<a name="line.230"></a>
+<span class="sourceLineNo">231</span> }<a name="line.231"></a>
+<span class="sourceLineNo">232</span> return val.getFirst();<a
name="line.232"></a>
+<span class="sourceLineNo">233</span> } catch (Throwable e) {<a
name="line.233"></a>
+<span class="sourceLineNo">234</span> throw new ServiceException(e);<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> /**<a name="line.238"></a>
+<span class="sourceLineNo">239</span> * Make a call, passing
<code>param</code>, to the IPC server running at<a
name="line.239"></a>
+<span class="sourceLineNo">240</span> * <code>address</code>
which is servicing the <code>protocol</code> protocol,<a
name="line.240"></a>
+<span class="sourceLineNo">241</span> * with the
<code>ticket</code> credentials, returning the value.<a
name="line.241"></a>
+<span class="sourceLineNo">242</span> * Throws exceptions if there are
network problems or if the remote code<a name="line.242"></a>
+<span class="sourceLineNo">243</span> * threw an exception.<a
name="line.243"></a>
+<span class="sourceLineNo">244</span> *<a name="line.244"></a>
+<span class="sourceLineNo">245</span> * @param ticket Be careful which
ticket you pass. A new user will mean a new Connection.<a name="line.245"></a>
+<span class="sourceLineNo">246</span> * {@link
UserProvider#getCurrent()} makes a new instance of User each time so<a
name="line.246"></a>
+<span class="sourceLineNo">247</span> * will be a<a
name="line.247"></a>
+<span class="sourceLineNo">248</span> * new Connection each
time.<a name="line.248"></a>
+<span class="sourceLineNo">249</span> * @return A pair with the Message
response and the Cell data (if any).<a name="line.249"></a>
+<span class="sourceLineNo">250</span> * @throws InterruptedException<a
name="line.250"></a>
+<span class="sourceLineNo">251</span> * @throws java.io.IOException<a
name="line.251"></a>
+<span class="sourceLineNo">252</span> */<a name="line.252"></a>
+<span class="sourceLineNo">253</span> protected abstract Pair<Message,
CellScanner> call(PayloadCarryingRpcController pcrc,<a name="line.253"></a>
+<span class="sourceLineNo">254</span> Descriptors.MethodDescriptor md,
Message param, Message returnType, User ticket,<a name="line.254"></a>
+<span class="sourceLineNo">255</span> InetSocketAddress isa,
MetricsConnection.CallStats callStats)<a name="line.255"></a>
+<span class="sourceLineNo">256</span> throws IOException,
InterruptedException;<a name="line.256"></a>
+<span class="sourceLineNo">257</span><a name="line.257"></a>
+<span class="sourceLineNo">258</span> @Override<a name="line.258"></a>
+<span class="sourceLineNo">259</span> public BlockingRpcChannel
createBlockingRpcChannel(final ServerName sn, final User ticket,<a
name="line.259"></a>
+<span class="sourceLineNo">260</span> int defaultOperationTimeout) {<a
name="line.260"></a>
+<span class="sourceLineNo">261</span> return new
BlockingRpcChannelImplementation(this, sn, ticket, defaultOperationTimeout);<a
name="line.261"></a>
+<span class="sourceLineNo">262</span> }<a name="line.262"></a>
+<span class="sourceLineNo">263</span><a name="line.263"></a>
+<span class="sourceLineNo">264</span> /**<a name="line.264"></a>
+<span class="sourceLineNo">265</span> * Takes an Exception and the address
we were trying to connect to and return an IOException with<a
name="line.265"></a>
+<span class="sourceLineNo">266</span> * the input exception as the cause.
The new exception provides the stack trace of the place where<a
name="line.266"></a>
+<span class="sourceLineNo">267</span> * the exception is thrown and some
extra diagnostics information. If the exception is<a name="line.267"></a>
+<span class="sourceLineNo">268</span> * ConnectException or
SocketTimeoutException, return a new one of the same type; Otherwise return<a
name="line.268"></a>
+<span class="sourceLineNo">269</span> * an IOException.<a
name="line.269"></a>
+<span class="sourceLineNo">270</span> * @param addr target address<a
name="line.270"></a>
+<span class="sourceLineNo">271</span> * @param exception the relevant
exception<a name="line.271"></a>
+<span class="sourceLineNo">272</span> * @return an exception to throw<a
name="line.272"></a>
+<span class="sourceLineNo">273</span> */<a name="line.273"></a>
+<span class="sourceLineNo">274</span> protected IOException
wrapException(InetSocketAddress addr, Exception exception) {<a
name="line.274"></a>
+<span class="sourceLineNo">275</span> if (exception instanceof
ConnectException) {<a name="line.275"></a>
+<span class="sourceLineNo">276</span> // connection refused; include the
host:port in the error<a name="line.276"></a>
+<span class="sourceLineNo">277</span> return (ConnectException) new
ConnectException("Call to " + addr<a name="line.277"></a>
+<span class="sourceLineNo">278</span> + " failed on connection
exception: " + exception).initCause(exception);<a name="line.278"></a>
+<span class="sourceLineNo">279</span> } else if (exception instanceof
SocketTimeoutException) {<a name="line.279"></a>
+<span class="sourceLineNo">280</span> return (SocketTimeoutException) new
SocketTimeoutException("Call to " + addr<a name="line.280"></a>
+<span class="sourceLineNo">281</span> + " failed because " +
exception).initCause(exception);<a name="line.281"></a>
+<span class="sourceLineNo">282</span> } else if (exception instanceof
ConnectionClosingException) {<a name="line.282"></a>
+<span class="sourceLineNo">283</span> return (ConnectionClosingException)
new ConnectionClosingException("Call to " + addr<a name="line.283"></a>
+<span class="sourceLineNo">284</span> + " failed on local exception:
" + exception).initCause(exception);<a name="line.284"></a>
+<span class="sourceLineNo">285</span> } else {<a name="line.285"></a>
+<span class="sourceLineNo">286</span> return (IOException) new
IOException("Call to " + addr + " failed on local exception: "<a
name="line.286"></a>
+<span class="sourceLineNo">287</span> +
exception).initCause(exception);<a name="line.287"></a>
+<span class="sourceLineNo">288</span> }<a name="line.288"></a>
+<span class="sourceLineNo">289</span> }<a name="line.289"></a>
+<span class="sourceLineNo">290</span><a name="line.290"></a>
+<span class="sourceLineNo">291</span> /**<a name="line.291"></a>
+<span class="sourceLineNo">292</span> * Blocking rpc channel that goes via
hbase rpc.<a name="line.292"></a>
+<span class="sourceLineNo">293</span> */<a name="line.293"></a>
+<span class="sourceLineNo">294</span> @VisibleForTesting<a
name="line.294"></a>
+<span class="sourceLineNo">295</span> public static class
BlockingRpcChannelImplementation implements BlockingRpcChannel {<a
name="line.295"></a>
+<span class="sourceLineNo">296</span> private final InetSocketAddress
isa;<a name="line.296"></a>
+<span class="sourceLineNo">297</span> private final AbstractRpcClient
rpcClient;<a name="line.297"></a>
+<span class="sourceLineNo">298</span> private final User ticket;<a
name="line.298"></a>
+<span class="sourceLineNo">299</span> private final int
channelOperationTimeout;<a name="line.299"></a>
+<span class="sourceLineNo">300</span><a name="line.300"></a>
+<span class="sourceLineNo">301</span> /**<a name="line.301"></a>
+<span class="sourceLineNo">302</span> * @param channelOperationTimeout -
the default timeout when no timeout is given<a name="line.302"></a>
+<span class="sourceLineNo">303</span> */<a name="line.303"></a>
+<span class="sourceLineNo">304</span> protected
BlockingRpcChannelImplementation(final AbstractRpcClient rpcClient,<a
name="line.304"></a>
+<span class="sourceLineNo">305</span> final ServerName sn, final User
ticket, int channelOperationTimeout) {<a name="line.305"></a>
+<span class="sourceLineNo">306</span> this.isa = new
InetSocketAddress(sn.getHostname(), sn.getPort());<a name="line.306"></a>
+<span class="sourceLineNo">307</span> this.rpcClient = rpcClient;<a
name="line.307"></a>
+<span class="sourceLineNo">308</span> this.ticket = ticket;<a
name="line.308"></a>
+<span class="sourceLineNo">309</span> this.channelOperationTimeout =
channelOperationTimeout;<a name="line.309"></a>
+<span class="sourceLineNo">310</span> }<a name="line.310"></a>
+<span class="sourceLineNo">311</span><a name="line.311"></a>
+<span class="sourceLineNo">312</span> @Override<a name="line.312"></a>
+<span class="sourceLineNo">313</span> public Message
callBlockingMethod(Descriptors.MethodDescriptor md, RpcController controller,<a
name="line.313"></a>
+<span class="sourceLineNo">314</span> Message param, Message
returnType) throws ServiceException {<a name="line.314"></a>
+<span class="sourceLineNo">315</span> PayloadCarryingRpcController
pcrc;<a name="line.315"></a>
+<span class="sourceLineNo">316</span> if (controller != null) {<a
name="line.316"></a>
+<span class="sourceLineNo">317</span> pcrc =
(PayloadCarryingRpcController) controller;<a name="line.317"></a>
+<span class="sourceLineNo">318</span> if (!pcrc.hasCallTimeout()) {<a
name="line.318"></a>
+<span class="sourceLineNo">319</span>
pcrc.setCallTimeout(channelOperationTimeout);<a name="line.319"></a>
+<span class="sourceLineNo">320</span> }<a name="line.320"></a>
+<span class="sourceLineNo">321</span> } else {<a name="line.321"></a>
+<span class="sourceLineNo">322</span> pcrc = new
PayloadCarryingRpcController();<a name="line.322"></a>
+<span class="sourceLineNo">323</span>
pcrc.setCallTimeout(channelOperationTimeout);<a name="line.323"></a>
+<span class="sourceLineNo">324</span> }<a name="line.324"></a>
+<span class="sourceLineNo">325</span><a name="line.325"></a>
+<span class="sourceLineNo">326</span> return
this.rpcClient.callBlockingMethod(md, pcrc, param, returnType, this.ticket,
this.isa);<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>}<a name="line.329"></a>