http://www.avaje.org/java8-parent/ebean-datasource-api: For open source java artifacts.
  • Rob Bygrave 
package io.ebean.datasource;


Factory that creates DataSourcePool's.


    DataSourceFactory factory = DataSourceFactory.get();
    DataSourceConfig config = new DataSourceConfig();
    config.setDriver("org.h2.Driver");
    config.setUrl("jdbc:h2:mem:tests2");
    config.setUsername("sa");
    config.setPassword("");
    DataSourcePool pool = factory.createPool("test", config);
    Connection connection = pool.getConnection();



/**
 * Factory that creates DataSourcePool's.
 *
 * <pre>{@code
 *
 *     DataSourceFactory factory = DataSourceFactory.get();
 *
 *     DataSourceConfig config = new DataSourceConfig();
 *     config.setDriver("org.h2.Driver");
 *     config.setUrl("jdbc:h2:mem:tests2");
 *     config.setUsername("sa");
 *     config.setPassword("");
 *
 *     DataSourcePool pool = factory.createPool("test", config);
 *
 *     Connection connection = pool.getConnection();
 *
 * }</pre>
 */
public interface DataSourceFactory {

  
Create the DataSourcePool given the name and configuration.

/**
   * Create the DataSourcePool given the name and configuration.
   */
  static DataSourcePool create(String name, DataSourceConfig config) {
    return get().createPool(name, config);
  }

  
Return the DataSourceFactory.


The implementation is obtained via standard service loader mechanism requiring an
implementation to be in the classpath.



/**
   * Return the DataSourceFactory.
   * <p>
   * The implementation is obtained via standard service loader mechanism requiring an
   * implementation to be in the classpath.
   * </p>
   */
  static DataSourceFactory get() {
    return DSManager.get();
  }

  
Create the DataSourcePool with the given configuration.

Params:
  • name –   The name of the pool.
  • config – The configuration options.
Returns:The created DataSourcePool
/**
   * Create the DataSourcePool with the given configuration.
   *
   * @param name   The name of the pool.
   * @param config The configuration options.
   * @return The created DataSourcePool
   */
  DataSourcePool createPool(String name, DataSourceConfig config);
}