io.ebean.config.DatabaseConfigProvider Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ebean-api Show documentation

ebean api

There is a newer version: 15.8.0

package io.ebean.config;

import io.ebean.DatabaseBuilder;

/**
 * Provides a ServiceLoader based mechanism to configure a DatabaseConfig.
 * 
 * Provide an implementation and register it via the standard Java ServiceLoader mechanism
 * via a file at META-INF/services/io.ebean.config.DatabaseConfigProvider.
 * 
 * 
 * If you are using a DI container like Spring or Guice you are unlikely to use this but instead use a
 * spring specific configuration.  When we are not using a DI container we may use this mechanism to
 * explicitly register the entity beans and avoid classpath scanning.
 * 
 * {@code
 *
 * public class EbeanConfigProvider implements DatabaseConfigProvider {
 *
 *   @Override
 *   public void apply(DatabaseConfig config) {
 *
 *     // register the entity bean classes explicitly
 *     config.addClass(Customer.class);
 *     config.addClass(User.class);
 *     ...
 *   }
 * }
 *
 * }
 */
public interface DatabaseConfigProvider {

  /**
   * Apply the configuration to the DatabaseConfig.
   * 
   * Typically we explicitly register entity bean classes and thus avoid classpath scanning.
   * 
   */
  void apply(DatabaseBuilder config);
}