http://git-wip-us.apache.org/repos/asf/hbase-site/blob/d41f56fe/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 91366eb..d16480e 100644
--- a/devapidocs/src-html/org/apache/hadoop/hbase/ipc/AbstractRpcClient.html
+++ b/devapidocs/src-html/org/apache/hadoop/hbase/ipc/AbstractRpcClient.html
@@ -424,185 +424,186 @@
<span class="sourceLineNo">416</span> if (count >
maxConcurrentCallsPerServer) {<a name="line.416"></a>
<span class="sourceLineNo">417</span> throw new
ServerTooBusyException(addr, count);<a name="line.417"></a>
<span class="sourceLineNo">418</span> }<a name="line.418"></a>
-<span class="sourceLineNo">419</span> T connection =
getConnection(remoteId);<a name="line.419"></a>
-<span class="sourceLineNo">420</span> connection.sendRequest(call,
hrc);<a name="line.420"></a>
-<span class="sourceLineNo">421</span> } catch (Exception e) {<a
name="line.421"></a>
-<span class="sourceLineNo">422</span> call.setException(toIOE(e));<a
name="line.422"></a>
-<span class="sourceLineNo">423</span> }<a name="line.423"></a>
-<span class="sourceLineNo">424</span> }<a name="line.424"></a>
-<span class="sourceLineNo">425</span><a name="line.425"></a>
-<span class="sourceLineNo">426</span> private InetSocketAddress
createAddr(ServerName sn) throws UnknownHostException {<a name="line.426"></a>
-<span class="sourceLineNo">427</span> InetSocketAddress addr = new
InetSocketAddress(sn.getHostname(), sn.getPort());<a name="line.427"></a>
-<span class="sourceLineNo">428</span> if (addr.isUnresolved()) {<a
name="line.428"></a>
-<span class="sourceLineNo">429</span> throw new UnknownHostException("can
not resolve " + sn.getServerName());<a name="line.429"></a>
-<span class="sourceLineNo">430</span> }<a name="line.430"></a>
-<span class="sourceLineNo">431</span> return addr;<a name="line.431"></a>
-<span class="sourceLineNo">432</span> }<a name="line.432"></a>
-<span class="sourceLineNo">433</span><a name="line.433"></a>
-<span class="sourceLineNo">434</span> /**<a name="line.434"></a>
-<span class="sourceLineNo">435</span> * Interrupt the connections to the
given ip:port server. This should be called if the server is<a
name="line.435"></a>
-<span class="sourceLineNo">436</span> * known as actually dead. This will
not prevent current operation to be retried, and, depending<a
name="line.436"></a>
-<span class="sourceLineNo">437</span> * on their own behavior, they may
retry on the same server. This can be a feature, for example at<a
name="line.437"></a>
-<span class="sourceLineNo">438</span> * startup. In any case, they're likely
to get connection refused (if the process died) or no<a name="line.438"></a>
-<span class="sourceLineNo">439</span> * route to host: i.e. their next
retries should be faster and with a safe exception.<a name="line.439"></a>
-<span class="sourceLineNo">440</span> */<a name="line.440"></a>
-<span class="sourceLineNo">441</span> @Override<a name="line.441"></a>
-<span class="sourceLineNo">442</span> public void
cancelConnections(ServerName sn) {<a name="line.442"></a>
-<span class="sourceLineNo">443</span> synchronized (connections) {<a
name="line.443"></a>
-<span class="sourceLineNo">444</span> for (T connection :
connections.values()) {<a name="line.444"></a>
-<span class="sourceLineNo">445</span> ConnectionId remoteId =
connection.remoteId();<a name="line.445"></a>
-<span class="sourceLineNo">446</span> if (remoteId.address.getPort() ==
sn.getPort()<a name="line.446"></a>
-<span class="sourceLineNo">447</span> &&
remoteId.address.getHostName().equals(sn.getHostname())) {<a
name="line.447"></a>
-<span class="sourceLineNo">448</span> LOG.info("The server on " +
sn.toString() + " is dead - stopping the connection "<a name="line.448"></a>
-<span class="sourceLineNo">449</span> + connection.remoteId);<a
name="line.449"></a>
-<span class="sourceLineNo">450</span>
connections.removeValue(remoteId, connection);<a name="line.450"></a>
-<span class="sourceLineNo">451</span> connection.shutdown();<a
name="line.451"></a>
-<span class="sourceLineNo">452</span> }<a name="line.452"></a>
-<span class="sourceLineNo">453</span> }<a name="line.453"></a>
-<span class="sourceLineNo">454</span> }<a name="line.454"></a>
-<span class="sourceLineNo">455</span> }<a name="line.455"></a>
-<span class="sourceLineNo">456</span> /**<a name="line.456"></a>
-<span class="sourceLineNo">457</span> * Configure an hbase rpccontroller<a
name="line.457"></a>
-<span class="sourceLineNo">458</span> * @param controller to configure<a
name="line.458"></a>
-<span class="sourceLineNo">459</span> * @param channelOperationTimeout
timeout for operation<a name="line.459"></a>
-<span class="sourceLineNo">460</span> * @return configured controller<a
name="line.460"></a>
-<span class="sourceLineNo">461</span> */<a name="line.461"></a>
-<span class="sourceLineNo">462</span> static HBaseRpcController
configureHBaseRpcController(<a name="line.462"></a>
-<span class="sourceLineNo">463</span> RpcController controller, int
channelOperationTimeout) {<a name="line.463"></a>
-<span class="sourceLineNo">464</span> HBaseRpcController hrc;<a
name="line.464"></a>
-<span class="sourceLineNo">465</span> if (controller != null &&
controller instanceof HBaseRpcController) {<a name="line.465"></a>
-<span class="sourceLineNo">466</span> hrc = (HBaseRpcController)
controller;<a name="line.466"></a>
-<span class="sourceLineNo">467</span> if (!hrc.hasCallTimeout()) {<a
name="line.467"></a>
-<span class="sourceLineNo">468</span>
hrc.setCallTimeout(channelOperationTimeout);<a name="line.468"></a>
-<span class="sourceLineNo">469</span> }<a name="line.469"></a>
-<span class="sourceLineNo">470</span> } else {<a name="line.470"></a>
-<span class="sourceLineNo">471</span> hrc = new
HBaseRpcControllerImpl();<a name="line.471"></a>
-<span class="sourceLineNo">472</span>
hrc.setCallTimeout(channelOperationTimeout);<a name="line.472"></a>
-<span class="sourceLineNo">473</span> }<a name="line.473"></a>
-<span class="sourceLineNo">474</span> return hrc;<a name="line.474"></a>
-<span class="sourceLineNo">475</span> }<a name="line.475"></a>
-<span class="sourceLineNo">476</span><a name="line.476"></a>
-<span class="sourceLineNo">477</span> protected abstract void
closeInternal();<a name="line.477"></a>
-<span class="sourceLineNo">478</span><a name="line.478"></a>
-<span class="sourceLineNo">479</span> @Override<a name="line.479"></a>
-<span class="sourceLineNo">480</span> public void close() {<a
name="line.480"></a>
-<span class="sourceLineNo">481</span> if (LOG.isDebugEnabled()) {<a
name="line.481"></a>
-<span class="sourceLineNo">482</span> LOG.debug("Stopping rpc client");<a
name="line.482"></a>
-<span class="sourceLineNo">483</span> }<a name="line.483"></a>
-<span class="sourceLineNo">484</span> Collection<T> connToClose;<a
name="line.484"></a>
-<span class="sourceLineNo">485</span> synchronized (connections) {<a
name="line.485"></a>
-<span class="sourceLineNo">486</span> if (!running) {<a
name="line.486"></a>
-<span class="sourceLineNo">487</span> return;<a name="line.487"></a>
-<span class="sourceLineNo">488</span> }<a name="line.488"></a>
-<span class="sourceLineNo">489</span> running = false;<a
name="line.489"></a>
-<span class="sourceLineNo">490</span> connToClose =
connections.values();<a name="line.490"></a>
-<span class="sourceLineNo">491</span> connections.clear();<a
name="line.491"></a>
-<span class="sourceLineNo">492</span> }<a name="line.492"></a>
-<span class="sourceLineNo">493</span>
cleanupIdleConnectionTask.cancel(true);<a name="line.493"></a>
-<span class="sourceLineNo">494</span> for (T conn : connToClose) {<a
name="line.494"></a>
-<span class="sourceLineNo">495</span> conn.shutdown();<a
name="line.495"></a>
-<span class="sourceLineNo">496</span> }<a name="line.496"></a>
-<span class="sourceLineNo">497</span> closeInternal();<a
name="line.497"></a>
-<span class="sourceLineNo">498</span> for (T conn : connToClose) {<a
name="line.498"></a>
-<span class="sourceLineNo">499</span> conn.cleanupConnection();<a
name="line.499"></a>
-<span class="sourceLineNo">500</span> }<a name="line.500"></a>
-<span class="sourceLineNo">501</span> }<a name="line.501"></a>
-<span class="sourceLineNo">502</span><a name="line.502"></a>
-<span class="sourceLineNo">503</span> @Override<a name="line.503"></a>
-<span class="sourceLineNo">504</span> public BlockingRpcChannel
createBlockingRpcChannel(final ServerName sn, final User ticket,<a
name="line.504"></a>
-<span class="sourceLineNo">505</span> int rpcTimeout) throws
UnknownHostException {<a name="line.505"></a>
-<span class="sourceLineNo">506</span> return new
BlockingRpcChannelImplementation(this, createAddr(sn), ticket, rpcTimeout);<a
name="line.506"></a>
-<span class="sourceLineNo">507</span> }<a name="line.507"></a>
-<span class="sourceLineNo">508</span><a name="line.508"></a>
-<span class="sourceLineNo">509</span> @Override<a name="line.509"></a>
-<span class="sourceLineNo">510</span> public RpcChannel
createRpcChannel(ServerName sn, User user, int rpcTimeout)<a
name="line.510"></a>
-<span class="sourceLineNo">511</span> throws UnknownHostException {<a
name="line.511"></a>
-<span class="sourceLineNo">512</span> return new
RpcChannelImplementation(this, createAddr(sn), user, rpcTimeout);<a
name="line.512"></a>
-<span class="sourceLineNo">513</span> }<a name="line.513"></a>
-<span class="sourceLineNo">514</span><a name="line.514"></a>
-<span class="sourceLineNo">515</span> private static class AbstractRpcChannel
{<a name="line.515"></a>
-<span class="sourceLineNo">516</span><a name="line.516"></a>
-<span class="sourceLineNo">517</span> protected final InetSocketAddress
addr;<a name="line.517"></a>
-<span class="sourceLineNo">518</span><a name="line.518"></a>
-<span class="sourceLineNo">519</span> protected final
AbstractRpcClient<?> rpcClient;<a name="line.519"></a>
-<span class="sourceLineNo">520</span><a name="line.520"></a>
-<span class="sourceLineNo">521</span> protected final User ticket;<a
name="line.521"></a>
-<span class="sourceLineNo">522</span><a name="line.522"></a>
-<span class="sourceLineNo">523</span> protected final int rpcTimeout;<a
name="line.523"></a>
-<span class="sourceLineNo">524</span><a name="line.524"></a>
-<span class="sourceLineNo">525</span> protected
AbstractRpcChannel(AbstractRpcClient<?> rpcClient, InetSocketAddress
addr,<a name="line.525"></a>
-<span class="sourceLineNo">526</span> User ticket, int rpcTimeout) {<a
name="line.526"></a>
-<span class="sourceLineNo">527</span> this.addr = addr;<a
name="line.527"></a>
-<span class="sourceLineNo">528</span> this.rpcClient = rpcClient;<a
name="line.528"></a>
-<span class="sourceLineNo">529</span> this.ticket = ticket;<a
name="line.529"></a>
-<span class="sourceLineNo">530</span> this.rpcTimeout = rpcTimeout;<a
name="line.530"></a>
-<span class="sourceLineNo">531</span> }<a name="line.531"></a>
-<span class="sourceLineNo">532</span><a name="line.532"></a>
-<span class="sourceLineNo">533</span> /**<a name="line.533"></a>
-<span class="sourceLineNo">534</span> * Configure an rpc controller<a
name="line.534"></a>
-<span class="sourceLineNo">535</span> * @param controller to configure<a
name="line.535"></a>
-<span class="sourceLineNo">536</span> * @return configured rpc
controller<a name="line.536"></a>
-<span class="sourceLineNo">537</span> */<a name="line.537"></a>
-<span class="sourceLineNo">538</span> protected HBaseRpcController
configureRpcController(RpcController controller) {<a name="line.538"></a>
-<span class="sourceLineNo">539</span> HBaseRpcController hrc;<a
name="line.539"></a>
-<span class="sourceLineNo">540</span> // TODO: Ideally we should not use
an RpcController other than HBaseRpcController at client<a name="line.540"></a>
-<span class="sourceLineNo">541</span> // side. And now we may use
ServerRpcController.<a name="line.541"></a>
-<span class="sourceLineNo">542</span> if (controller != null &&
controller instanceof HBaseRpcController) {<a name="line.542"></a>
-<span class="sourceLineNo">543</span> hrc = (HBaseRpcController)
controller;<a name="line.543"></a>
-<span class="sourceLineNo">544</span> if (!hrc.hasCallTimeout()) {<a
name="line.544"></a>
-<span class="sourceLineNo">545</span>
hrc.setCallTimeout(rpcTimeout);<a name="line.545"></a>
-<span class="sourceLineNo">546</span> }<a name="line.546"></a>
-<span class="sourceLineNo">547</span> } else {<a name="line.547"></a>
-<span class="sourceLineNo">548</span> hrc = new
HBaseRpcControllerImpl();<a name="line.548"></a>
-<span class="sourceLineNo">549</span> hrc.setCallTimeout(rpcTimeout);<a
name="line.549"></a>
-<span class="sourceLineNo">550</span> }<a name="line.550"></a>
-<span class="sourceLineNo">551</span> return hrc;<a name="line.551"></a>
-<span class="sourceLineNo">552</span> }<a name="line.552"></a>
-<span class="sourceLineNo">553</span> }<a name="line.553"></a>
-<span class="sourceLineNo">554</span><a name="line.554"></a>
-<span class="sourceLineNo">555</span> /**<a name="line.555"></a>
-<span class="sourceLineNo">556</span> * Blocking rpc channel that goes via
hbase rpc.<a name="line.556"></a>
-<span class="sourceLineNo">557</span> */<a name="line.557"></a>
-<span class="sourceLineNo">558</span> @VisibleForTesting<a
name="line.558"></a>
-<span class="sourceLineNo">559</span> public static class
BlockingRpcChannelImplementation extends AbstractRpcChannel<a
name="line.559"></a>
-<span class="sourceLineNo">560</span> implements BlockingRpcChannel {<a
name="line.560"></a>
-<span class="sourceLineNo">561</span><a name="line.561"></a>
-<span class="sourceLineNo">562</span> protected
BlockingRpcChannelImplementation(AbstractRpcClient<?> rpcClient,<a
name="line.562"></a>
-<span class="sourceLineNo">563</span> InetSocketAddress addr, User
ticket, int rpcTimeout) {<a name="line.563"></a>
-<span class="sourceLineNo">564</span> super(rpcClient, addr, ticket,
rpcTimeout);<a name="line.564"></a>
-<span class="sourceLineNo">565</span> }<a name="line.565"></a>
-<span class="sourceLineNo">566</span><a name="line.566"></a>
-<span class="sourceLineNo">567</span> @Override<a name="line.567"></a>
-<span class="sourceLineNo">568</span> public Message
callBlockingMethod(Descriptors.MethodDescriptor md, RpcController controller,<a
name="line.568"></a>
-<span class="sourceLineNo">569</span> Message param, Message
returnType) throws ServiceException {<a name="line.569"></a>
-<span class="sourceLineNo">570</span> return
rpcClient.callBlockingMethod(md, configureRpcController(controller),<a
name="line.570"></a>
-<span class="sourceLineNo">571</span> param, returnType, ticket,
addr);<a name="line.571"></a>
-<span class="sourceLineNo">572</span> }<a name="line.572"></a>
-<span class="sourceLineNo">573</span> }<a name="line.573"></a>
-<span class="sourceLineNo">574</span><a name="line.574"></a>
-<span class="sourceLineNo">575</span> /**<a name="line.575"></a>
-<span class="sourceLineNo">576</span> * Async rpc channel that goes via
hbase rpc.<a name="line.576"></a>
-<span class="sourceLineNo">577</span> */<a name="line.577"></a>
-<span class="sourceLineNo">578</span> public static class
RpcChannelImplementation extends AbstractRpcChannel implements<a
name="line.578"></a>
-<span class="sourceLineNo">579</span> RpcChannel {<a name="line.579"></a>
-<span class="sourceLineNo">580</span><a name="line.580"></a>
-<span class="sourceLineNo">581</span> protected
RpcChannelImplementation(AbstractRpcClient<?> rpcClient,
InetSocketAddress addr,<a name="line.581"></a>
-<span class="sourceLineNo">582</span> User ticket, int rpcTimeout)
throws UnknownHostException {<a name="line.582"></a>
-<span class="sourceLineNo">583</span> super(rpcClient, addr, ticket,
rpcTimeout);<a name="line.583"></a>
-<span class="sourceLineNo">584</span> }<a name="line.584"></a>
-<span class="sourceLineNo">585</span><a name="line.585"></a>
-<span class="sourceLineNo">586</span> @Override<a name="line.586"></a>
-<span class="sourceLineNo">587</span> public void
callMethod(Descriptors.MethodDescriptor md, RpcController controller,<a
name="line.587"></a>
-<span class="sourceLineNo">588</span> Message param, Message
returnType, RpcCallback<Message> done) {<a name="line.588"></a>
-<span class="sourceLineNo">589</span> // This method does not throw any
exceptions, so the caller must provide a<a name="line.589"></a>
-<span class="sourceLineNo">590</span> // HBaseRpcController which is used
to pass the exceptions.<a name="line.590"></a>
-<span class="sourceLineNo">591</span> this.rpcClient.callMethod(md,<a
name="line.591"></a>
-<span class="sourceLineNo">592</span>
configureRpcController(Preconditions.checkNotNull(controller,<a
name="line.592"></a>
-<span class="sourceLineNo">593</span> "RpcController can not be null
for async rpc call")),<a name="line.593"></a>
-<span class="sourceLineNo">594</span> param, returnType, ticket, addr,
done);<a name="line.594"></a>
-<span class="sourceLineNo">595</span> }<a name="line.595"></a>
-<span class="sourceLineNo">596</span> }<a name="line.596"></a>
-<span class="sourceLineNo">597</span>}<a name="line.597"></a>
+<span class="sourceLineNo">419</span>
cs.setConcurrentCallsPerServer(count);<a name="line.419"></a>
+<span class="sourceLineNo">420</span> T connection =
getConnection(remoteId);<a name="line.420"></a>
+<span class="sourceLineNo">421</span> connection.sendRequest(call,
hrc);<a name="line.421"></a>
+<span class="sourceLineNo">422</span> } catch (Exception e) {<a
name="line.422"></a>
+<span class="sourceLineNo">423</span> call.setException(toIOE(e));<a
name="line.423"></a>
+<span class="sourceLineNo">424</span> }<a name="line.424"></a>
+<span class="sourceLineNo">425</span> }<a name="line.425"></a>
+<span class="sourceLineNo">426</span><a name="line.426"></a>
+<span class="sourceLineNo">427</span> private InetSocketAddress
createAddr(ServerName sn) throws UnknownHostException {<a name="line.427"></a>
+<span class="sourceLineNo">428</span> InetSocketAddress addr = new
InetSocketAddress(sn.getHostname(), sn.getPort());<a name="line.428"></a>
+<span class="sourceLineNo">429</span> if (addr.isUnresolved()) {<a
name="line.429"></a>
+<span class="sourceLineNo">430</span> throw new UnknownHostException("can
not resolve " + sn.getServerName());<a name="line.430"></a>
+<span class="sourceLineNo">431</span> }<a name="line.431"></a>
+<span class="sourceLineNo">432</span> return addr;<a name="line.432"></a>
+<span class="sourceLineNo">433</span> }<a name="line.433"></a>
+<span class="sourceLineNo">434</span><a name="line.434"></a>
+<span class="sourceLineNo">435</span> /**<a name="line.435"></a>
+<span class="sourceLineNo">436</span> * Interrupt the connections to the
given ip:port server. This should be called if the server is<a
name="line.436"></a>
+<span class="sourceLineNo">437</span> * known as actually dead. This will
not prevent current operation to be retried, and, depending<a
name="line.437"></a>
+<span class="sourceLineNo">438</span> * on their own behavior, they may
retry on the same server. This can be a feature, for example at<a
name="line.438"></a>
+<span class="sourceLineNo">439</span> * startup. In any case, they're likely
to get connection refused (if the process died) or no<a name="line.439"></a>
+<span class="sourceLineNo">440</span> * route to host: i.e. their next
retries should be faster and with a safe exception.<a name="line.440"></a>
+<span class="sourceLineNo">441</span> */<a name="line.441"></a>
+<span class="sourceLineNo">442</span> @Override<a name="line.442"></a>
+<span class="sourceLineNo">443</span> public void
cancelConnections(ServerName sn) {<a name="line.443"></a>
+<span class="sourceLineNo">444</span> synchronized (connections) {<a
name="line.444"></a>
+<span class="sourceLineNo">445</span> for (T connection :
connections.values()) {<a name="line.445"></a>
+<span class="sourceLineNo">446</span> ConnectionId remoteId =
connection.remoteId();<a name="line.446"></a>
+<span class="sourceLineNo">447</span> if (remoteId.address.getPort() ==
sn.getPort()<a name="line.447"></a>
+<span class="sourceLineNo">448</span> &&
remoteId.address.getHostName().equals(sn.getHostname())) {<a
name="line.448"></a>
+<span class="sourceLineNo">449</span> LOG.info("The server on " +
sn.toString() + " is dead - stopping the connection "<a name="line.449"></a>
+<span class="sourceLineNo">450</span> + connection.remoteId);<a
name="line.450"></a>
+<span class="sourceLineNo">451</span>
connections.removeValue(remoteId, connection);<a name="line.451"></a>
+<span class="sourceLineNo">452</span> connection.shutdown();<a
name="line.452"></a>
+<span class="sourceLineNo">453</span> }<a name="line.453"></a>
+<span class="sourceLineNo">454</span> }<a name="line.454"></a>
+<span class="sourceLineNo">455</span> }<a name="line.455"></a>
+<span class="sourceLineNo">456</span> }<a name="line.456"></a>
+<span class="sourceLineNo">457</span> /**<a name="line.457"></a>
+<span class="sourceLineNo">458</span> * Configure an hbase rpccontroller<a
name="line.458"></a>
+<span class="sourceLineNo">459</span> * @param controller to configure<a
name="line.459"></a>
+<span class="sourceLineNo">460</span> * @param channelOperationTimeout
timeout for operation<a name="line.460"></a>
+<span class="sourceLineNo">461</span> * @return configured controller<a
name="line.461"></a>
+<span class="sourceLineNo">462</span> */<a name="line.462"></a>
+<span class="sourceLineNo">463</span> static HBaseRpcController
configureHBaseRpcController(<a name="line.463"></a>
+<span class="sourceLineNo">464</span> RpcController controller, int
channelOperationTimeout) {<a name="line.464"></a>
+<span class="sourceLineNo">465</span> HBaseRpcController hrc;<a
name="line.465"></a>
+<span class="sourceLineNo">466</span> if (controller != null &&
controller instanceof HBaseRpcController) {<a name="line.466"></a>
+<span class="sourceLineNo">467</span> hrc = (HBaseRpcController)
controller;<a name="line.467"></a>
+<span class="sourceLineNo">468</span> if (!hrc.hasCallTimeout()) {<a
name="line.468"></a>
+<span class="sourceLineNo">469</span>
hrc.setCallTimeout(channelOperationTimeout);<a name="line.469"></a>
+<span class="sourceLineNo">470</span> }<a name="line.470"></a>
+<span class="sourceLineNo">471</span> } else {<a name="line.471"></a>
+<span class="sourceLineNo">472</span> hrc = new
HBaseRpcControllerImpl();<a name="line.472"></a>
+<span class="sourceLineNo">473</span>
hrc.setCallTimeout(channelOperationTimeout);<a name="line.473"></a>
+<span class="sourceLineNo">474</span> }<a name="line.474"></a>
+<span class="sourceLineNo">475</span> return hrc;<a name="line.475"></a>
+<span class="sourceLineNo">476</span> }<a name="line.476"></a>
+<span class="sourceLineNo">477</span><a name="line.477"></a>
+<span class="sourceLineNo">478</span> protected abstract void
closeInternal();<a name="line.478"></a>
+<span class="sourceLineNo">479</span><a name="line.479"></a>
+<span class="sourceLineNo">480</span> @Override<a name="line.480"></a>
+<span class="sourceLineNo">481</span> public void close() {<a
name="line.481"></a>
+<span class="sourceLineNo">482</span> if (LOG.isDebugEnabled()) {<a
name="line.482"></a>
+<span class="sourceLineNo">483</span> LOG.debug("Stopping rpc client");<a
name="line.483"></a>
+<span class="sourceLineNo">484</span> }<a name="line.484"></a>
+<span class="sourceLineNo">485</span> Collection<T> connToClose;<a
name="line.485"></a>
+<span class="sourceLineNo">486</span> synchronized (connections) {<a
name="line.486"></a>
+<span class="sourceLineNo">487</span> if (!running) {<a
name="line.487"></a>
+<span class="sourceLineNo">488</span> return;<a name="line.488"></a>
+<span class="sourceLineNo">489</span> }<a name="line.489"></a>
+<span class="sourceLineNo">490</span> running = false;<a
name="line.490"></a>
+<span class="sourceLineNo">491</span> connToClose =
connections.values();<a name="line.491"></a>
+<span class="sourceLineNo">492</span> connections.clear();<a
name="line.492"></a>
+<span class="sourceLineNo">493</span> }<a name="line.493"></a>
+<span class="sourceLineNo">494</span>
cleanupIdleConnectionTask.cancel(true);<a name="line.494"></a>
+<span class="sourceLineNo">495</span> for (T conn : connToClose) {<a
name="line.495"></a>
+<span class="sourceLineNo">496</span> conn.shutdown();<a
name="line.496"></a>
+<span class="sourceLineNo">497</span> }<a name="line.497"></a>
+<span class="sourceLineNo">498</span> closeInternal();<a
name="line.498"></a>
+<span class="sourceLineNo">499</span> for (T conn : connToClose) {<a
name="line.499"></a>
+<span class="sourceLineNo">500</span> conn.cleanupConnection();<a
name="line.500"></a>
+<span class="sourceLineNo">501</span> }<a name="line.501"></a>
+<span class="sourceLineNo">502</span> }<a name="line.502"></a>
+<span class="sourceLineNo">503</span><a name="line.503"></a>
+<span class="sourceLineNo">504</span> @Override<a name="line.504"></a>
+<span class="sourceLineNo">505</span> public BlockingRpcChannel
createBlockingRpcChannel(final ServerName sn, final User ticket,<a
name="line.505"></a>
+<span class="sourceLineNo">506</span> int rpcTimeout) throws
UnknownHostException {<a name="line.506"></a>
+<span class="sourceLineNo">507</span> return new
BlockingRpcChannelImplementation(this, createAddr(sn), ticket, rpcTimeout);<a
name="line.507"></a>
+<span class="sourceLineNo">508</span> }<a name="line.508"></a>
+<span class="sourceLineNo">509</span><a name="line.509"></a>
+<span class="sourceLineNo">510</span> @Override<a name="line.510"></a>
+<span class="sourceLineNo">511</span> public RpcChannel
createRpcChannel(ServerName sn, User user, int rpcTimeout)<a
name="line.511"></a>
+<span class="sourceLineNo">512</span> throws UnknownHostException {<a
name="line.512"></a>
+<span class="sourceLineNo">513</span> return new
RpcChannelImplementation(this, createAddr(sn), user, rpcTimeout);<a
name="line.513"></a>
+<span class="sourceLineNo">514</span> }<a name="line.514"></a>
+<span class="sourceLineNo">515</span><a name="line.515"></a>
+<span class="sourceLineNo">516</span> private static class AbstractRpcChannel
{<a name="line.516"></a>
+<span class="sourceLineNo">517</span><a name="line.517"></a>
+<span class="sourceLineNo">518</span> protected final InetSocketAddress
addr;<a name="line.518"></a>
+<span class="sourceLineNo">519</span><a name="line.519"></a>
+<span class="sourceLineNo">520</span> protected final
AbstractRpcClient<?> rpcClient;<a name="line.520"></a>
+<span class="sourceLineNo">521</span><a name="line.521"></a>
+<span class="sourceLineNo">522</span> protected final User ticket;<a
name="line.522"></a>
+<span class="sourceLineNo">523</span><a name="line.523"></a>
+<span class="sourceLineNo">524</span> protected final int rpcTimeout;<a
name="line.524"></a>
+<span class="sourceLineNo">525</span><a name="line.525"></a>
+<span class="sourceLineNo">526</span> protected
AbstractRpcChannel(AbstractRpcClient<?> rpcClient, InetSocketAddress
addr,<a name="line.526"></a>
+<span class="sourceLineNo">527</span> User ticket, int rpcTimeout) {<a
name="line.527"></a>
+<span class="sourceLineNo">528</span> this.addr = addr;<a
name="line.528"></a>
+<span class="sourceLineNo">529</span> this.rpcClient = rpcClient;<a
name="line.529"></a>
+<span class="sourceLineNo">530</span> this.ticket = ticket;<a
name="line.530"></a>
+<span class="sourceLineNo">531</span> this.rpcTimeout = rpcTimeout;<a
name="line.531"></a>
+<span class="sourceLineNo">532</span> }<a name="line.532"></a>
+<span class="sourceLineNo">533</span><a name="line.533"></a>
+<span class="sourceLineNo">534</span> /**<a name="line.534"></a>
+<span class="sourceLineNo">535</span> * Configure an rpc controller<a
name="line.535"></a>
+<span class="sourceLineNo">536</span> * @param controller to configure<a
name="line.536"></a>
+<span class="sourceLineNo">537</span> * @return configured rpc
controller<a name="line.537"></a>
+<span class="sourceLineNo">538</span> */<a name="line.538"></a>
+<span class="sourceLineNo">539</span> protected HBaseRpcController
configureRpcController(RpcController controller) {<a name="line.539"></a>
+<span class="sourceLineNo">540</span> HBaseRpcController hrc;<a
name="line.540"></a>
+<span class="sourceLineNo">541</span> // TODO: Ideally we should not use
an RpcController other than HBaseRpcController at client<a name="line.541"></a>
+<span class="sourceLineNo">542</span> // side. And now we may use
ServerRpcController.<a name="line.542"></a>
+<span class="sourceLineNo">543</span> if (controller != null &&
controller instanceof HBaseRpcController) {<a name="line.543"></a>
+<span class="sourceLineNo">544</span> hrc = (HBaseRpcController)
controller;<a name="line.544"></a>
+<span class="sourceLineNo">545</span> if (!hrc.hasCallTimeout()) {<a
name="line.545"></a>
+<span class="sourceLineNo">546</span>
hrc.setCallTimeout(rpcTimeout);<a name="line.546"></a>
+<span class="sourceLineNo">547</span> }<a name="line.547"></a>
+<span class="sourceLineNo">548</span> } else {<a name="line.548"></a>
+<span class="sourceLineNo">549</span> hrc = new
HBaseRpcControllerImpl();<a name="line.549"></a>
+<span class="sourceLineNo">550</span> hrc.setCallTimeout(rpcTimeout);<a
name="line.550"></a>
+<span class="sourceLineNo">551</span> }<a name="line.551"></a>
+<span class="sourceLineNo">552</span> return hrc;<a name="line.552"></a>
+<span class="sourceLineNo">553</span> }<a name="line.553"></a>
+<span class="sourceLineNo">554</span> }<a name="line.554"></a>
+<span class="sourceLineNo">555</span><a name="line.555"></a>
+<span class="sourceLineNo">556</span> /**<a name="line.556"></a>
+<span class="sourceLineNo">557</span> * Blocking rpc channel that goes via
hbase rpc.<a name="line.557"></a>
+<span class="sourceLineNo">558</span> */<a name="line.558"></a>
+<span class="sourceLineNo">559</span> @VisibleForTesting<a
name="line.559"></a>
+<span class="sourceLineNo">560</span> public static class
BlockingRpcChannelImplementation extends AbstractRpcChannel<a
name="line.560"></a>
+<span class="sourceLineNo">561</span> implements BlockingRpcChannel {<a
name="line.561"></a>
+<span class="sourceLineNo">562</span><a name="line.562"></a>
+<span class="sourceLineNo">563</span> protected
BlockingRpcChannelImplementation(AbstractRpcClient<?> rpcClient,<a
name="line.563"></a>
+<span class="sourceLineNo">564</span> InetSocketAddress addr, User
ticket, int rpcTimeout) {<a name="line.564"></a>
+<span class="sourceLineNo">565</span> super(rpcClient, addr, ticket,
rpcTimeout);<a name="line.565"></a>
+<span class="sourceLineNo">566</span> }<a name="line.566"></a>
+<span class="sourceLineNo">567</span><a name="line.567"></a>
+<span class="sourceLineNo">568</span> @Override<a name="line.568"></a>
+<span class="sourceLineNo">569</span> public Message
callBlockingMethod(Descriptors.MethodDescriptor md, RpcController controller,<a
name="line.569"></a>
+<span class="sourceLineNo">570</span> Message param, Message
returnType) throws ServiceException {<a name="line.570"></a>
+<span class="sourceLineNo">571</span> return
rpcClient.callBlockingMethod(md, configureRpcController(controller),<a
name="line.571"></a>
+<span class="sourceLineNo">572</span> param, returnType, ticket,
addr);<a name="line.572"></a>
+<span class="sourceLineNo">573</span> }<a name="line.573"></a>
+<span class="sourceLineNo">574</span> }<a name="line.574"></a>
+<span class="sourceLineNo">575</span><a name="line.575"></a>
+<span class="sourceLineNo">576</span> /**<a name="line.576"></a>
+<span class="sourceLineNo">577</span> * Async rpc channel that goes via
hbase rpc.<a name="line.577"></a>
+<span class="sourceLineNo">578</span> */<a name="line.578"></a>
+<span class="sourceLineNo">579</span> public static class
RpcChannelImplementation extends AbstractRpcChannel implements<a
name="line.579"></a>
+<span class="sourceLineNo">580</span> RpcChannel {<a name="line.580"></a>
+<span class="sourceLineNo">581</span><a name="line.581"></a>
+<span class="sourceLineNo">582</span> protected
RpcChannelImplementation(AbstractRpcClient<?> rpcClient,
InetSocketAddress addr,<a name="line.582"></a>
+<span class="sourceLineNo">583</span> User ticket, int rpcTimeout)
throws UnknownHostException {<a name="line.583"></a>
+<span class="sourceLineNo">584</span> super(rpcClient, addr, ticket,
rpcTimeout);<a name="line.584"></a>
+<span class="sourceLineNo">585</span> }<a name="line.585"></a>
+<span class="sourceLineNo">586</span><a name="line.586"></a>
+<span class="sourceLineNo">587</span> @Override<a name="line.587"></a>
+<span class="sourceLineNo">588</span> public void
callMethod(Descriptors.MethodDescriptor md, RpcController controller,<a
name="line.588"></a>
+<span class="sourceLineNo">589</span> Message param, Message
returnType, RpcCallback<Message> done) {<a name="line.589"></a>
+<span class="sourceLineNo">590</span> // This method does not throw any
exceptions, so the caller must provide a<a name="line.590"></a>
+<span class="sourceLineNo">591</span> // HBaseRpcController which is used
to pass the exceptions.<a name="line.591"></a>
+<span class="sourceLineNo">592</span> this.rpcClient.callMethod(md,<a
name="line.592"></a>
+<span class="sourceLineNo">593</span>
configureRpcController(Preconditions.checkNotNull(controller,<a
name="line.593"></a>
+<span class="sourceLineNo">594</span> "RpcController can not be null
for async rpc call")),<a name="line.594"></a>
+<span class="sourceLineNo">595</span> param, returnType, ticket, addr,
done);<a name="line.595"></a>
+<span class="sourceLineNo">596</span> }<a name="line.596"></a>
+<span class="sourceLineNo">597</span> }<a name="line.597"></a>
+<span class="sourceLineNo">598</span>}<a name="line.598"></a>
