连接池 HikariPool （二） - 获取及关闭连接

获取数据库连接是通过DataSource发起的，如果应用使用HikariPool作为连接池的话，需要配置DataSource为HikariDataSource，应用通过调用HikariDataSource的getConnection方法获取数据库连接。

关闭数据库连接是直接调用获取到的数据库连接对象（Connection对象）的close方法完成的。

今天要研究的课题：获取及关闭数据库连接，获取数据库连接其实就是从HikariDataSource的getConnection方法入手，直到getConnection方法获取到数据库连接对象。然后再研究数据库连接对象的close方法。

#### 获取数据库连接
直接看HikariDataSource的getConnection方法：
```
 public Connection getConnection() throws SQLException
   {
      if (isClosed()) {
         throw new SQLException("HikariDataSource " + this + " has been closed.");
      }

      if (fastPathPool != null) {
         return fastPathPool.getConnection();
      }

      // See http://en.wikipedia.org/wiki/Double-checked_locking#Usage_in_Java
      HikariPool result = pool;
      if (result == null) {
         synchronized (this) {
            result = pool;
            if (result == null) {
               validate();
               LOGGER.info("{} - Starting...", getPoolName());
               try {
                  pool = result = new HikariPool(this);
                  this.seal();
               }
               catch (PoolInitializationException pie) {
                  if (pie.getCause() instanceof SQLException) {
                     throw (SQLException) pie.getCause();
                  }
                  else {
                     throw pie;
                  }
               }
               LOGGER.info("{} - Start completed.", getPoolName());
            }
         }
      }

```

fastPathPool在HikariDataSource实例化的时候被初始化为HikariPool对象。如果fastPathPool在getConnection方法调用的时候尚未初始化，就在getConnection方法内完成初始化。之后再调用HikariPool对象的getConnection方法。

#### HikariPool#getConnection方法
直接看代码：
```
       public Connection getConnection() throws SQLException
   {
      return getConnection(connectionTimeout);
   }

```
直接调用了getConnection(connectionTimeout)方法：
```
public Connection getConnection(final long hardTimeout) throws SQLException
   {
      suspendResumeLock.acquire();
      final long startTime = currentTime();

      try {
         long timeout = hardTimeout;
         do {
            PoolEntry poolEntry = connectionBag.borrow(timeout, MILLISECONDS);
            if (poolEntry == null) {
               break; // We timed out... break and throw exception
            }

            final long now = currentTime();
            if (poolEntry.isMarkedEvicted() || (elapsedMillis(poolEntry.lastAccessed, now) > aliveBypassWindowMs && !isConnectionAlive(poolEntry.connection))) {
               closeConnection(poolEntry, poolEntry.isMarkedEvicted() ? EVICTED_CONNECTION_MESSAGE : DEAD_CONNECTION_MESSAGE);
               timeout = hardTimeout - elapsedMillis(startTime);
            }
            else {
               metricsTracker.recordBorrowStats(poolEntry, startTime);
               return poolEntry.createProxyConnection(leakTaskFactory.schedule(poolEntry), now);
            }
         } while (timeout > 0L);

         metricsTracker.recordBorrowTimeoutStats(startTime);
         throw createTimeoutException(startTime);
      }
      catch (InterruptedException e) {
         Thread.currentThread().interrupt();
         throw new SQLException(poolName + " - Interrupted during connection acquisition", e);
      }
      finally {
         suspendResumeLock.release();
      }
   }
```
首先调用suspendResumeLock.acquire();方法，suspendResumeLock的主要作用是限流，初始化的时候设置最大并发线程数为MAX_PERMITS = 10000，如果同时获取连接的线程未超过限制数量的话，允许获取连接，否则，挂起、排队（内部通过Semaphore类实现，Semaphore是AQS的扩展实现）等待其他线程获取到连接、释放suspendResumeLock之后，才能继续获取到数据库连接。    

然后调用connectionBag的borrow方法（稍后分析源码），从数据库连接池中获取连接。

如果没能从数据库连接池获取到连接的话，抛异常。

检查从连接池获取到的连接，如果连接被标记为Evicted（该连接由于超时或其他原因应该被回收），或者最后一次访问时间到当前时间之间的时间差超过了aliveBypassWindowMs的设置并且尝试后发现该连接已经失效（连不上了），则关闭该连接，timeout尚未超时的话重新调用connectionBag的borrow方法获取连接，直到超时或获取到可用的连接。

如果连接可用，则调用metricsTracker.recordBorrowStats，之后返回：

```
  return poolEntry.createProxyConnection(leakTaskFactory.schedule(poolEntry), now); 
```

***注意最终返回的并不是java.sql.Connection对象，而是通过poolEnry.createProxyConnection方法创建的代理对象！***

***最终通过JavassistProxyFactory创建代理对象HikariProxyConnection。***

返回代理数据库连接对象的同时，创建leakTask。leakTask对象的作用是：如果leakDetectionThreshold不为0的话，创建一个leakTask任务，在leakDetectionThreshold时长之后执行该任务抛出数据库连接泄露异常。该任务不被执行（不发生数据库泄露异常）的唯一条件就是在leakDetectionThreshold时长范围内，数据库连接成功执行完SQL语句后通过调用代理Connection对象的close方法取消该任务。

OK，getConnection方法源码分析完成了，目前为止，我们知道：
1. 通过connectionBag.borrow方法从连接池获取连接数据库连接的封装对象poolEntry
2. 最终获取到的数据库连接是代理对象HikariProxyConnection

下面我们首先分析一下connectionBag.borrow方法，borrow方法才是从连接池获取连接的关键。

#### connectionBag#borrow方法
上代码，分段分析，先看第一部分：
```
public T borrow(long timeout, final TimeUnit timeUnit) throws InterruptedException
   {
      // Try the thread-local list first
      final List