#11 - ENH: Add isOnline() and shutdown(); (without the deregister driver option)

Author: rbygrave

src/main/java/io/ebean/datasource/DataSourcePool.java

@@ -18,6 +18,13 @@ public interface DataSourcePool extends DataSource {
    */
   boolean isAutoCommit();
 
+  /**
+   * Return true if the DataSource is online.
+   * <p>
+   * Effectively the same as (synonym for) {@link #isDataSourceUp()}.
+   */
+  boolean isOnline();
+
   /**
    * Bring the DataSource online ensuring min connections and start heart beat checking.
    */
@@ -28,6 +35,15 @@ public interface DataSourcePool extends DataSource {
    */
   void offline();
 
+  /**
+   * Shutdown the pool.
+   * <p>
+   * This is functionally the same as {@link #offline()} but generally we expect to only
+   * shutdown the pool once where as we can expect to making many calls to offline() and
+   * online().
+   */
+  void shutdown();
+
   /**
    * Shutdown the pool with the option to deregister the driver.
    */
@@ -55,6 +71,8 @@ public interface DataSourcePool extends DataSource {
 
   /**
    * Returns false when the dataSource is down.
+   * <p>
+   * Effectively the same as (synonym for) {@link #isOnline()}.
    */
   boolean isDataSourceUp();