com.avaje.ebean.config

Class ServerConfig

java.lang.Object

com.avaje.ebean.config.ServerConfig

public class ServerConfig
extends Object

The configuration used for creating a EbeanServer.

Used to programmatically construct an EbeanServer and optionally register it with the Ebean singleton.

If you just use Ebean without this programmatic configuration Ebean will read the ebean.properties file and take the configuration from there. This usually includes searching the class path and automatically registering any entity classes and listeners etc.

ServerConfig c = new ServerConfig();
c.setName("ordh2");

// read the ebean.properties and load
// those settings into this serverConfig object
c.loadFromProperties();

// generate DDL and run it
c.setDdlGenerate(true);
c.setDdlRun(true);

// add any classes found in the app.data package
c.addPackage("app.data");

// add the names of Jars that contain entities
c.addJar("myJarContainingEntities.jar");
c.addJar("someOtherJarContainingEntities.jar");

// register as the 'Default' server
c.setDefaultServer(true);

EbeanServer server = EbeanServerFactory.create(c);

Author:

emcgreal, rbygrave

See Also:

EbeanServerFactory

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ServerConfig.DbUuid Specify how UUID is stored.

Constructor Summary

Constructors

Constructor and Description
ServerConfig() Construct a Server Configuration for programmatically creating an EbeanServer.

Method Summary

Modifier and Type	Method and Description
void	add(BeanPersistController beanPersistController) Register a BeanPersistController instance.
void	add(BeanPersistListener beanPersistListener) Register a BeanPersistListener instance.
void	add(BeanPostLoad postLoad) Register a BeanPostLoad instance.
void	add(BeanQueryAdapter beanQueryAdapter) Register a BeanQueryAdapter instance.
void	add(BulkTableEventListener bulkTableEventListener) Add a BulkTableEventListener
void	add(TransactionEventListener listener) Register a TransactionEventListener instance
void	addClass(Class<?> cls) Programmatically add classes (typically entities) that this server should use.
void	addJar(String jarName) Add the name of a Jar to search for entities via class path search.
void	addPackage(String packageName) Add a package to search for entities via class path search.
void	addServerConfigStartup(ServerConfigStartup configStartupListener) Add a ServerConfigStartup.
PersistBatch	appliedPersistBatchOnCascade() Return the PersistBatch mode to use for 'batchOnCascade' taking into account if the database platform supports getGeneratedKeys in batch mode.
String	getAsOfSysPeriod() Return the database column used to support history and 'As of' queries.
String	getAsOfViewSuffix() Return the suffix appended to the base table to derive the view that contains the union of the base table and the history table in order to support asOf queries.
AutoTuneConfig	getAutoTuneConfig() Return the configuration for AutoTune.
int	getBackgroundExecutorCorePoolSize() Return the Background executor core pool size.
int	getBackgroundExecutorIdleSecs() Return the Background executor idle seconds.
int	getBackgroundExecutorMaxPoolSize() Return the Background executor max pool size.
int	getBackgroundExecutorSchedulePoolSize() Return the Background executor schedule pool size.
int	getBackgroundExecutorShutdownSecs() Return the Background executor shutdown seconds.
List<BulkTableEventListener>	getBulkTableEventListeners() Return the list of BulkTableEventListener instances.
int	getCacheMaxIdleTime() Return the L2 cache default max idle time in seconds.
int	getCacheMaxSize() Return the L2 cache default max size.
int	getCacheMaxTimeToLive() Return the L2 cache default max time to live in seconds.
int	getCacheWarmingDelay() Return the cache warming delay in seconds.
ChangeLogListener	getChangeLogListener() Return the ChangeLogListener which actually performs the logging of change sets in the background.
ChangeLogPrepare	getChangeLogPrepare() Return the ChangeLogPrepare.
ChangeLogRegister	getChangeLogRegister() Return the ChangeLogRegister which controls which ChangeLogFilter is used for each bean type and in this way provide fine grained control over which persist requests are included in the change log.
List<Class<?>>	getClasses() Return the classes registered for this server.
String	getClassPathReaderClassName() Return the class name of a classPathReader implementation.
DbConstraintNaming	getConstraintNaming() Return the constraint naming convention used in DDL generation.
ContainerConfig	getContainerConfig() Return the container / clustering configuration.
CurrentUserProvider	getCurrentUserProvider() Return the CurrentUserProvider.
String	getDatabaseBooleanFalse() Return a value used to represent FALSE in the database.
String	getDatabaseBooleanTrue() Return a value used to represent TRUE in the database.
DatabasePlatform	getDatabasePlatform() Return the database platform to use for this server.
String	getDatabasePlatformName() Return the database platform name (can be null).
int	getDatabaseSequenceBatchSize() Return the number of DB sequence values that should be preallocated.
DataSource	getDataSource() Return the DataSource.
DataSourceConfig	getDataSourceConfig() Return the configuration to build a DataSource using Ebean's own DataSource implementation.
String	getDataSourceJndiName() Return the JNDI name of the DataSource to use.
DbEncrypt	getDbEncrypt() Return the DbEncrypt used to encrypt and decrypt properties.
ServerConfig.DbUuid	getDbUuid() Return the DB type used to store UUID.
EncryptDeployManager	getEncryptDeployManager() Return the EncryptDeployManager.
EncryptKeyManager	getEncryptKeyManager() Return the EncryptKeyManager.
Encryptor	getEncryptor() Return the Encryptor used to encrypt data on the java client side (as opposed to DB encryption functions).
ExternalTransactionManager	getExternalTransactionManager() Return the external transaction manager.
List<BeanFindController>	getFindControllers() Return the list of BeanFindController instances.
String	getHistoryTableSuffix() Return the history table suffix (defaults to _history).
List<String>	getJars() Return packages to search for entities via class path search.
JsonConfig.DateTime	getJsonDateTime() Return the JSON format used for DateTime types.
com.fasterxml.jackson.core.JsonFactory	getJsonFactory() Return the Jackson JsonFactory to use.
JsonConfig.Include	getJsonInclude() Return the JSON include mode used when writing JSON.
int	getLazyLoadBatchSize() Return the default batch size for lazy loading of beans and collections.
int	getMaxCallStack() Return the max call stack to use for origin location.
DbMigrationConfig	getMigrationConfig() Return the DB migration configuration.
String	getName() Return the name of the EbeanServer.
NamingConvention	getNamingConvention() Return the NamingConvention.
Object	getObjectMapper() Return the Jackson ObjectMapper.
List<String>	getPackages() Return packages to search for entities via class path search.
PersistBatch	getPersistBatch() Return the PersistBatch mode to use by default at the transaction level.
PersistBatch	getPersistBatchOnCascade() Return the JDBC batch mode to use per save(), delete(), insert() or update() request.
int	getPersistBatchSize() Return the batch size used for JDBC batching.
List<BeanPersistController>	getPersistControllers() Return the BeanPersistController instances.
PersistenceContextScope	getPersistenceContextScope() Return the default PersistenceContextScope to be used if one is not explicitly set on a query.
List<BeanPersistListener>	getPersistListeners() Return the BeanPersistListener instances.
List<BeanPostLoad>	getPostLoaders() Return the list of BeanPostLoader instances.
Properties	getProperties() Return the properties that we used for configuration and were set via a call to loadFromProperties().
List<BeanQueryAdapter>	getQueryAdapters() Return the BeanQueryAdapter instances.
int	getQueryBatchSize() Gets the query batch size.
int	getQueryCacheMaxIdleTime() Return the L2 query cache default max idle time in seconds.
int	getQueryCacheMaxSize() Return the L2 query cache default max size.
int	getQueryCacheMaxTimeToLive() Return the L2 query cache default max time to live in seconds.
ReadAuditLogger	getReadAuditLogger() Return the ReadAuditLogger to use.
ReadAuditPrepare	getReadAuditPrepare() Return the ReadAuditPrepare to use.
String	getResourceDirectory() Returns the resource directory.
ServerCacheFactory	getServerCacheFactory() Return the ServerCacheFactory.
ServerCacheManager	getServerCacheManager() Return the ServerCacheManager.
List<ServerConfigStartup>	getServerConfigStartupListeners() Return the list of ServerConfigStartup instances.
List<TransactionEventListener>	getTransactionEventListeners() Return the TransactionEventListener instances.
boolean	isAutoCommitMode() Return true if autoCommit mode is on.
boolean	isChangeLogIncludeInserts() Return true if inserts should be included in the change log by default.
boolean	isCollectQueryOrigins() Return true if query plans should also collect their 'origins'.
boolean	isCollectQueryStatsByNode() Return true if the ebeanServer should collection query statistics by ObjectGraphNode.
boolean	isDdlGenerate() Return true if the DDL should be generated.
boolean	isDdlRun() Return true if the DDL should be run.
boolean	isDefaultServer() Return true if this server should be registered as the "default" server with the Ebean singleton.
boolean	isDisableClasspathSearch() Return true if the class path search should be disabled.
boolean	isDurationWithNanos() Return true if Duration should be persisted with nanos precision (SQL DECIMAL).
boolean	isEagerFetchLobs() Return true if LOB's should default to fetch eager.
boolean	isExplicitTransactionBeginMode() Return true if transaction begin should be started with explicit statement.
boolean	isExpressionEqualsWithNullAsNoop() Return true if eq("someProperty", null) should to generate "1=1" rather than "is null" sql expression.
boolean	isLocalTimeWithNanos() Return true if LocalTime should be persisted with nanos precision.
boolean	isRegister() Return true if this server should be registered with the Ebean singleton when it is created.
boolean	isRegisterJmxMBeans() Return true if the server should register JMX MBeans.
boolean	isTransactionRollbackOnChecked() Return true if transactions should rollback on checked exceptions.
boolean	isUpdateAllPropertiesInBatch() Returns true if updates in JDBC batch default to include all properties by default.
boolean	isUpdateChangesOnly() Return true to only update changed properties.
boolean	isUpdatesDeleteMissingChildren() Return true if updates by default delete missing children when cascading save to a OneToMany or ManyToMany.
boolean	isUseJtaTransactionManager() Return true if we are running in a JTA Transaction manager.
protected void	loadAutoTuneSettings(PropertiesWrapper p) This is broken out for the same reason as above - preserve existing behaviour but let it be overridden.
protected void	loadDataSourceSettings(PropertiesWrapper p) loads the data source settings to preserve existing behaviour.
void	loadFromProperties() Load settings from ebean.properties.
void	loadFromProperties(Properties properties) Load the settings from the given properties
protected void	loadSettings(PropertiesWrapper p) Load the configuration settings from the properties file.
void	loadTestProperties() Load settings from test-ebean.properties and do nothing if the properties is not found.
void	setAsOfSysPeriod(String asOfSysPeriod) Set the database column used to support history and 'As of' queries.
void	setAsOfViewSuffix(String asOfViewSuffix) Set the suffix appended to the base table to derive the view that contains the union of the base table and the history table in order to support asOf queries.
void	setAutoCommitMode(boolean autoCommitMode) Set to true if autoCommit mode is on and Ebean should use autoCommit friendly Transactions and TransactionManager.
void	setAutoTuneConfig(AutoTuneConfig autoTuneConfig) Set the configuration for AutoTune.
void	setBackgroundExecutorCorePoolSize(int backgroundExecutorCorePoolSize) Set the Background executor core pool size.
void	setBackgroundExecutorIdleSecs(int backgroundExecutorIdleSecs) Set the Background executor idle seconds.
void	setBackgroundExecutorMaxPoolSize(int backgroundExecutorMaxPoolSize) Set the Background executor max pool size.
void	setBackgroundExecutorSchedulePoolSize(int backgroundExecutorSchedulePoolSize) Set the Background executor schedule pool size.
void	setBackgroundExecutorShutdownSecs(int backgroundExecutorShutdownSecs) Set the Background executor shutdown seconds.
void	setCacheMaxIdleTime(int cacheMaxIdleTime) Set the L2 cache default max idle time in seconds.
void	setCacheMaxSize(int cacheMaxSize) Set the L2 cache default max size.
void	setCacheMaxTimeToLive(int cacheMaxTimeToLive) Set the L2 cache default max time to live in seconds.
void	setCacheWarmingDelay(int cacheWarmingDelay) Set the cache warming delay in seconds.
void	setChangeLogIncludeInserts(boolean changeLogIncludeInserts) Set if inserts should be included in the change log by default.
void	setChangeLogListener(ChangeLogListener changeLogListener) Set the ChangeLogListener which actually performs the logging of change sets in the background.
void	setChangeLogPrepare(ChangeLogPrepare changeLogPrepare) Set the ChangeLogPrepare.
void	setChangeLogRegister(ChangeLogRegister changeLogRegister) Set the ChangeLogRegister which controls which ChangeLogFilter is used for each bean type and in this way provide fine grained control over which persist requests are included in the change log.
void	setClasses(List<Class<?>> classes) Set the list of classes (entities, listeners, scalarTypes etc) that should be used for this server.
void	setClassPathReaderClassName(String classPathReaderClassName) Set the class name of a classPathReader implementation.
void	setCollectQueryOrigins(boolean collectQueryOrigins) Set to true if query plans should collect their 'origin' points.
void	setCollectQueryStatsByNode(boolean collectQueryStatsByNode) Set to true to collection query execution statistics by ObjectGraphNode.
void	setConstraintNaming(DbConstraintNaming constraintNaming) Set the constraint naming convention used in DDL generation.
void	setContainerConfig(ContainerConfig containerConfig) Set the container / clustering configuration.
void	setCurrentUserProvider(CurrentUserProvider currentUserProvider) Set the CurrentUserProvider.
void	setDatabaseBooleanFalse(String databaseFalse) Set the value to represent FALSE in the database.
void	setDatabaseBooleanTrue(String databaseTrue) Set the value to represent TRUE in the database.
void	setDatabasePlatform(DatabasePlatform databasePlatform) Explicitly set the database platform to use.
void	setDatabasePlatformName(String databasePlatformName) Explicitly set the database platform name
void	setDatabaseSequenceBatch(int databaseSequenceBatchSize) Set the number of DB sequence values that should be preallocated and cached by Ebean.
void	setDatabaseSequenceBatchSize(int databaseSequenceBatchSize) Set the number of sequences to fetch/preallocate when using DB sequences.
void	setDataSource(DataSource dataSource) Set a DataSource.
void	setDataSourceConfig(DataSourceConfig dataSourceConfig) Set the configuration required to build a DataSource using Ebean's own DataSource implementation.
void	setDataSourceJndiName(String dataSourceJndiName) Set the JNDI name of the DataSource to use.
void	setDbEncrypt(DbEncrypt dbEncrypt) Set the DbEncrypt used to encrypt and decrypt properties.
void	setDbUuid(ServerConfig.DbUuid dbUuid) Set the DB type used to store UUID.
void	setDdlGenerate(boolean ddlGenerate) Set to true to run the DDL generation on startup.
void	setDdlRun(boolean ddlRun) Set to true to run the generated DDL on startup.
void	setDefaultServer(boolean defaultServer) Set true if this EbeanServer should be registered as the "default" server with the Ebean singleton.
void	setDisableClasspathSearch(boolean disableClasspathSearch) Set to true to disable the class path search even for the case where no entity bean classes have been registered.
void	setDurationWithNanos(boolean durationWithNanos) Set to true if Duration should be persisted with nanos precision (SQL DECIMAL).
void	setEagerFetchLobs(boolean eagerFetchLobs) Set to true if you want LOB's to be fetch eager by default.
void	setEncryptDeployManager(EncryptDeployManager encryptDeployManager) Set the EncryptDeployManager.
void	setEncryptKeyManager(EncryptKeyManager encryptKeyManager) Set the EncryptKeyManager.
void	setEncryptor(Encryptor encryptor) Set the Encryptor used to encrypt data on the java client side (as opposed to DB encryption functions).
void	setExplicitTransactionBeginMode(boolean explicitTransactionBeginMode) Set to true if transaction begin should be started with explicit statement.
void	setExpressionEqualsWithNullAsNoop(boolean expressionEqualsWithNullAsNoop) Set to true if you want eq("someProperty", null) to generate "1=1" rather than "is null" sql expression.
void	setExternalTransactionManager(ExternalTransactionManager externalTransactionManager) Set the external transaction manager.
void	setFindControllers(List<BeanFindController> findControllers) Set the list of BeanFindController instances.
void	setHistoryTableSuffix(String historyTableSuffix) Set the history table suffix.
void	setJars(List<String> searchJars) Set the names of Jars to search for entities via class path search.
void	setJsonDateTime(JsonConfig.DateTime jsonDateTime) Set the JSON format to use for DateTime types.
void	setJsonFactory(com.fasterxml.jackson.core.JsonFactory jsonFactory) Set the Jackson JsonFactory to use.
void	setJsonInclude(JsonConfig.Include jsonInclude) Set the JSON include mode used when writing JSON.
void	setLazyLoadBatchSize(int lazyLoadBatchSize) Set the default batch size for lazy loading.
void	setLocalTimeWithNanos(boolean localTimeWithNanos) Set to true if LocalTime should be persisted with nanos precision.
void	setMaxCallStack(int maxCallStack) Set the max call stack to use for origin location.
void	setMigrationConfig(DbMigrationConfig migrationConfig) Set the DB migration configuration.
void	setName(String name) Set the name of the EbeanServer.
void	setNamingConvention(NamingConvention namingConvention) Set the NamingConvention.
void	setObjectMapper(Object objectMapper) Set the Jackson ObjectMapper.
void	setPackages(List<String> packages) Set packages to search for entities via class path search.
void	setPersistBatch(PersistBatch persistBatch) Set the JDBC batch mode to use at the transaction level.
void	setPersistBatching(boolean persistBatching) Deprecated, please migrate to using setPersistBatch().
void	setPersistBatchOnCascade(PersistBatch persistBatchOnCascade) Set the JDBC batch mode to use per save(), delete(), insert() or update() request.
void	setPersistBatchSize(int persistBatchSize) Set the batch size used for JDBC batching.
void	setPersistControllers(List<BeanPersistController> persistControllers) Register all the BeanPersistController instances.
void	setPersistenceContextScope(PersistenceContextScope persistenceContextScope) Set the PersistenceContext scope to be used if one is not explicitly set on a query.
void	setPersistListeners(List<BeanPersistListener> persistListeners) Register all the BeanPersistListener instances.
void	setPostLoaders(List<BeanPostLoad> postLoaders) Set the list of BeanPostLoader instances.
void	setQueryAdapters(List<BeanQueryAdapter> queryAdapters) Register all the BeanQueryAdapter instances.
void	setQueryBatchSize(int queryBatchSize) Sets the query batch size.
void	setQueryCacheMaxIdleTime(int queryCacheMaxIdleTime) Set the L2 query cache default max idle time in seconds.
void	setQueryCacheMaxSize(int queryCacheMaxSize) Set the L2 query cache default max size.
void	setQueryCacheMaxTimeToLive(int queryCacheMaxTimeToLive) Set the L2 query cache default max time to live in seconds.
void	setReadAuditLogger(ReadAuditLogger readAuditLogger) Set the ReadAuditLogger to use.
void	setReadAuditPrepare(ReadAuditPrepare readAuditPrepare) Set the ReadAuditPrepare to use.
void	setRegister(boolean register) Set to false if you do not want this server to be registered with the Ebean singleton when it is created.
void	setRegisterJmxMBeans(boolean registerJmxMBeans) Set if the server should register JMX MBeans.
void	setResourceDirectory(String resourceDirectory) Sets the resource directory.
void	setServerCacheFactory(ServerCacheFactory serverCacheFactory) Set the ServerCacheFactory to use.
void	setServerCacheManager(ServerCacheManager serverCacheManager) Set the ServerCacheManager to use.
void	setTransactionEventListeners(List<TransactionEventListener> transactionEventListeners) Register all the TransactionEventListener instances.
void	setTransactionRollbackOnChecked(boolean transactionRollbackOnChecked) Set to true if transactions should by default rollback on checked exceptions.
void	setUpdateAllPropertiesInBatch(boolean updateAllPropertiesInBatch) Set to false if by default updates in JDBC batch should not include all properties.
void	setUpdateChangesOnly(boolean updateChangesOnly) Set to true to only update changed properties.
void	setUpdatesDeleteMissingChildren(boolean updatesDeleteMissingChildren) Set if updates by default delete missing children when cascading save to a OneToMany or ManyToMany.
void	setUseJtaTransactionManager(boolean useJtaTransactionManager) Set to true if we are running in a JTA Transaction manager.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServerConfig

public ServerConfig()

Construct a Server Configuration for programmatically creating an EbeanServer.

Method Detail

getJsonFactory

public com.fasterxml.jackson.core.JsonFactory getJsonFactory()

Return the Jackson JsonFactory to use.

If not set a default implementation will be used.

setJsonFactory

public void setJsonFactory(com.fasterxml.jackson.core.JsonFactory jsonFactory)

Set the Jackson JsonFactory to use.

If not set a default implementation will be used.

getJsonDateTime

public JsonConfig.DateTime getJsonDateTime()

Return the JSON format used for DateTime types.

setJsonDateTime

public void setJsonDateTime(JsonConfig.DateTime jsonDateTime)

Set the JSON format to use for DateTime types.

getJsonInclude

public JsonConfig.Include getJsonInclude()

Return the JSON include mode used when writing JSON.

setJsonInclude

public void setJsonInclude(JsonConfig.Include jsonInclude)

Set the JSON include mode used when writing JSON.

Set to NON_NULL or NON_EMPTY to suppress nulls or null & empty collections respectively.

getName

public String getName()

Return the name of the EbeanServer.

setName

public void setName(String name)

Set the name of the EbeanServer.

getContainerConfig

public ContainerConfig getContainerConfig()

Return the container / clustering configuration.

The container holds all the EbeanServer instances and provides clustering communication services to all the EbeanServer instances.

setContainerConfig

public void setContainerConfig(ContainerConfig containerConfig)

Set the container / clustering configuration.

The container holds all the EbeanServer instances and provides clustering communication services to all the EbeanServer instances.

isRegister

public boolean isRegister()

Return true if this server should be registered with the Ebean singleton when it is created.

By default this is set to true.

setRegister

public void setRegister(boolean register)

Set to false if you do not want this server to be registered with the Ebean singleton when it is created.

By default this is set to true.

isDefaultServer

public boolean isDefaultServer()

Return true if this server should be registered as the "default" server with the Ebean singleton.

This is only used when setRegister(boolean) is also true.

setDefaultServer

public void setDefaultServer(boolean defaultServer)

Set true if this EbeanServer should be registered as the "default" server with the Ebean singleton.

This is only used when setRegister(boolean) is also true.

getCurrentUserProvider

public CurrentUserProvider getCurrentUserProvider()

Return the CurrentUserProvider. This is used to populate @WhoCreated, @WhoModified and support other audit features (who executed a query etc).

setCurrentUserProvider

public void setCurrentUserProvider(CurrentUserProvider currentUserProvider)

Set the CurrentUserProvider. This is used to populate @WhoCreated, @WhoModified and support other audit features (who executed a query etc).

getPersistBatch

public PersistBatch getPersistBatch()

Return the PersistBatch mode to use by default at the transaction level.

When INSERT or ALL is used then save(), delete() etc do not execute immediately but instead go into a JDBC batch execute buffer that is flushed. The buffer is flushed if a query is executed, transaction ends or the batch size is meet.

setPersistBatch

public void setPersistBatch(PersistBatch persistBatch)

Set the JDBC batch mode to use at the transaction level.

When INSERT or ALL is used then save(), delete() etc do not execute immediately but instead go into a JDBC batch execute buffer that is flushed. The buffer is flushed if a query is executed, transaction ends or the batch size is meet.

getPersistBatchOnCascade

public PersistBatch getPersistBatchOnCascade()

Return the JDBC batch mode to use per save(), delete(), insert() or update() request.

This makes sense when a save() or delete() cascades and executes multiple child statements. The best case for this is when saving a master/parent bean this cascade inserts many detail/child beans.

This only takes effect when the persistBatch mode at the transaction level does not take effect.

setPersistBatchOnCascade

public void setPersistBatchOnCascade(PersistBatch persistBatchOnCascade)

Set the JDBC batch mode to use per save(), delete(), insert() or update() request.

This makes sense when a save() or delete() etc cascades and executes multiple child statements. The best caase for this is when saving a master/parent bean this cascade inserts many detail/child beans.

This only takes effect when the persistBatch mode at the transaction level does not take effect.

setPersistBatching

public void setPersistBatching(boolean persistBatching)

Deprecated, please migrate to using setPersistBatch().

Set to true if you what to use JDBC batching for persisting and deleting beans.

With this Ebean will batch up persist requests and use the JDBC batch api. This is a performance optimisation designed to reduce the network chatter.

When true this is equivalent to setPersistBatch(PersistBatch.ALL) or when false to setPersistBatch(PersistBatch.NONE)

getPersistBatchSize

public int getPersistBatchSize()

Return the batch size used for JDBC batching. This defaults to 20.

setPersistBatchSize

public void setPersistBatchSize(int persistBatchSize)

Set the batch size used for JDBC batching. If unset this defaults to 20.

You can also set the batch size on the transaction.

See Also:

Transaction.setBatchSize(int)

getQueryBatchSize

public int getQueryBatchSize()

Gets the query batch size. This defaults to 100.

Returns:

the query batch size

setQueryBatchSize

public void setQueryBatchSize(int queryBatchSize)

Sets the query batch size. This defaults to 100.

Parameters:

queryBatchSize - the new query batch size

getLazyLoadBatchSize

public int getLazyLoadBatchSize()

Return the default batch size for lazy loading of beans and collections.

setLazyLoadBatchSize

public void setLazyLoadBatchSize(int lazyLoadBatchSize)

Set the default batch size for lazy loading.

This is the number of beans or collections loaded when lazy loading is invoked by default.

The default value is for this is 10 (load 10 beans or collections).

You can explicitly control the lazy loading batch size for a given join on a query using +lazy(batchSize) or JoinConfig.

setDatabaseSequenceBatchSize

public void setDatabaseSequenceBatchSize(int databaseSequenceBatchSize)

Set the number of sequences to fetch/preallocate when using DB sequences.

This is a performance optimisation to reduce the number times Ebean requests a sequence to be used as an Id for a bean (aka reduce network chatter).

getChangeLogPrepare

public ChangeLogPrepare getChangeLogPrepare()

Return the ChangeLogPrepare.

This is used to set user context information to the ChangeSet in the foreground thread prior to the logging occurring in a background thread.

setChangeLogPrepare

public void setChangeLogPrepare(ChangeLogPrepare changeLogPrepare)

Set the ChangeLogPrepare.

This is used to set user context information to the ChangeSet in the foreground thread prior to the logging occurring in a background thread.

getChangeLogListener

public ChangeLogListener getChangeLogListener()

Return the ChangeLogListener which actually performs the logging of change sets in the background.

setChangeLogListener

public void setChangeLogListener(ChangeLogListener changeLogListener)

Set the ChangeLogListener which actually performs the logging of change sets in the background.

getChangeLogRegister

public ChangeLogRegister getChangeLogRegister()

Return the ChangeLogRegister which controls which ChangeLogFilter is used for each bean type and in this way provide fine grained control over which persist requests are included in the change log.

setChangeLogRegister

public void setChangeLogRegister(ChangeLogRegister changeLogRegister)

Set the ChangeLogRegister which controls which ChangeLogFilter is used for each bean type and in this way provide fine grained control over which persist requests are included in the change log.

isChangeLogIncludeInserts

public boolean isChangeLogIncludeInserts()

Return true if inserts should be included in the change log by default.

setChangeLogIncludeInserts

public void setChangeLogIncludeInserts(boolean changeLogIncludeInserts)

Set if inserts should be included in the change log by default.

getReadAuditLogger

public ReadAuditLogger getReadAuditLogger()

Return the ReadAuditLogger to use.

setReadAuditLogger

public void setReadAuditLogger(ReadAuditLogger readAuditLogger)

Set the ReadAuditLogger to use. If not set the default implementation is used which logs the read events in JSON format to a standard named SLF4J logger (which can be configured in say logback to log to a separate log file).

getReadAuditPrepare

public ReadAuditPrepare getReadAuditPrepare()

Return the ReadAuditPrepare to use.

setReadAuditPrepare

public void setReadAuditPrepare(ReadAuditPrepare readAuditPrepare)

Set the ReadAuditPrepare to use.

It is expected that an implementation is used that read user context information (user id, user ip address etc) and sets it on the ReadEvent bean before it is sent to the ReadAuditLogger.

getMigrationConfig

public DbMigrationConfig getMigrationConfig()

Return the DB migration configuration.

setMigrationConfig

public void setMigrationConfig(DbMigrationConfig migrationConfig)

Set the DB migration configuration.

getAsOfViewSuffix

public String getAsOfViewSuffix()

Return the suffix appended to the base table to derive the view that contains the union of the base table and the history table in order to support asOf queries.

setAsOfViewSuffix

public void setAsOfViewSuffix(String asOfViewSuffix)

Set the suffix appended to the base table to derive the view that contains the union of the base table and the history table in order to support asOf queries.

getAsOfSysPeriod

public String getAsOfSysPeriod()

Return the database column used to support history and 'As of' queries. This column is a timestamp range or equivalent.

setAsOfSysPeriod

public void setAsOfSysPeriod(String asOfSysPeriod)

Set the database column used to support history and 'As of' queries. This column is a timestamp range or equivalent.

getHistoryTableSuffix

public String getHistoryTableSuffix()

Return the history table suffix (defaults to _history).

setHistoryTableSuffix

public void setHistoryTableSuffix(String historyTableSuffix)

Set the history table suffix.

isUseJtaTransactionManager

public boolean isUseJtaTransactionManager()

Return true if we are running in a JTA Transaction manager.

setUseJtaTransactionManager

public void setUseJtaTransactionManager(boolean useJtaTransactionManager)

Set to true if we are running in a JTA Transaction manager.

getExternalTransactionManager

public ExternalTransactionManager getExternalTransactionManager()

Return the external transaction manager.

setExternalTransactionManager

public void setExternalTransactionManager(ExternalTransactionManager externalTransactionManager)

Set the external transaction manager.

getServerCacheFactory

public ServerCacheFactory getServerCacheFactory()

Return the ServerCacheFactory.

setServerCacheFactory

public void setServerCacheFactory(ServerCacheFactory serverCacheFactory)

Set the ServerCacheFactory to use.

getServerCacheManager

public ServerCacheManager getServerCacheManager()

Return the ServerCacheManager.

setServerCacheManager

public void setServerCacheManager(ServerCacheManager serverCacheManager)

Set the ServerCacheManager to use.

isEagerFetchLobs

public boolean isEagerFetchLobs()

Return true if LOB's should default to fetch eager. By default this is set to false and LOB's must be explicitly fetched.

setEagerFetchLobs

public void setEagerFetchLobs(boolean eagerFetchLobs)

Set to true if you want LOB's to be fetch eager by default. By default this is set to false and LOB's must be explicitly fetched.

getMaxCallStack

public int getMaxCallStack()

Return the max call stack to use for origin location.

setMaxCallStack

public void setMaxCallStack(int maxCallStack)

Set the max call stack to use for origin location.

isTransactionRollbackOnChecked

public boolean isTransactionRollbackOnChecked()

Return true if transactions should rollback on checked exceptions.

setTransactionRollbackOnChecked

public void setTransactionRollbackOnChecked(boolean transactionRollbackOnChecked)

Set to true if transactions should by default rollback on checked exceptions.

isRegisterJmxMBeans

public boolean isRegisterJmxMBeans()

Return true if the server should register JMX MBeans.

setRegisterJmxMBeans

public void setRegisterJmxMBeans(boolean registerJmxMBeans)

Set if the server should register JMX MBeans.

getBackgroundExecutorSchedulePoolSize

public int getBackgroundExecutorSchedulePoolSize()

Return the Background executor schedule pool size. Defaults to 1.

setBackgroundExecutorSchedulePoolSize

public void setBackgroundExecutorSchedulePoolSize(int backgroundExecutorSchedulePoolSize)

Set the Background executor schedule pool size.

getBackgroundExecutorCorePoolSize

public int getBackgroundExecutorCorePoolSize()

Return the Background executor core pool size.

setBackgroundExecutorCorePoolSize

public void setBackgroundExecutorCorePoolSize(int backgroundExecutorCorePoolSize)

Set the Background executor core pool size.

getBackgroundExecutorMaxPoolSize

public int getBackgroundExecutorMaxPoolSize()

Return the Background executor max pool size.

setBackgroundExecutorMaxPoolSize

public void setBackgroundExecutorMaxPoolSize(int backgroundExecutorMaxPoolSize)

Set the Background executor max pool size.

getBackgroundExecutorIdleSecs

public int getBackgroundExecutorIdleSecs()

Return the Background executor idle seconds.

setBackgroundExecutorIdleSecs

public void setBackgroundExecutorIdleSecs(int backgroundExecutorIdleSecs)

Set the Background executor idle seconds.

getBackgroundExecutorShutdownSecs

public int getBackgroundExecutorShutdownSecs()

Return the Background executor shutdown seconds. This is the time allowed for the pool to shutdown nicely before it is forced shutdown.

setBackgroundExecutorShutdownSecs

public void setBackgroundExecutorShutdownSecs(int backgroundExecutorShutdownSecs)

Set the Background executor shutdown seconds. This is the time allowed for the pool to shutdown nicely before it is forced shutdown.

getCacheWarmingDelay

public int getCacheWarmingDelay()

Return the cache warming delay in seconds.

setCacheWarmingDelay

public void setCacheWarmingDelay(int cacheWarmingDelay)

Set the cache warming delay in seconds.

getCacheMaxSize

public int getCacheMaxSize()

Return the L2 cache default max size.

setCacheMaxSize

public void setCacheMaxSize(int cacheMaxSize)

Set the L2 cache default max size.

getCacheMaxIdleTime

public int getCacheMaxIdleTime()

Return the L2 cache default max idle time in seconds.

setCacheMaxIdleTime

public void setCacheMaxIdleTime(int cacheMaxIdleTime)

Set the L2 cache default max idle time in seconds.

getCacheMaxTimeToLive

public int getCacheMaxTimeToLive()

Return the L2 cache default max time to live in seconds.

setCacheMaxTimeToLive

public void setCacheMaxTimeToLive(int cacheMaxTimeToLive)

Set the L2 cache default max time to live in seconds.

getQueryCacheMaxSize

public int getQueryCacheMaxSize()

Return the L2 query cache default max size.

setQueryCacheMaxSize

public void setQueryCacheMaxSize(int queryCacheMaxSize)

Set the L2 query cache default max size.

getQueryCacheMaxIdleTime

public int getQueryCacheMaxIdleTime()

Return the L2 query cache default max idle time in seconds.

setQueryCacheMaxIdleTime

public void setQueryCacheMaxIdleTime(int queryCacheMaxIdleTime)

Set the L2 query cache default max idle time in seconds.

getQueryCacheMaxTimeToLive

public int getQueryCacheMaxTimeToLive()

Return the L2 query cache default max time to live in seconds.

setQueryCacheMaxTimeToLive

public void setQueryCacheMaxTimeToLive(int queryCacheMaxTimeToLive)

Set the L2 query cache default max time to live in seconds.

getNamingConvention

public NamingConvention getNamingConvention()

Return the NamingConvention.

If none has been set the default UnderscoreNamingConvention is used.

setNamingConvention

public void setNamingConvention(NamingConvention namingConvention)

Set the NamingConvention.

If none is set the default UnderscoreNamingConvention is used.

getConstraintNaming

public DbConstraintNaming getConstraintNaming()

Return the constraint naming convention used in DDL generation.

setConstraintNaming

public void setConstraintNaming(DbConstraintNaming constraintNaming)

Set the constraint naming convention used in DDL generation.

getAutoTuneConfig

public AutoTuneConfig getAutoTuneConfig()

Return the configuration for AutoTune.

setAutoTuneConfig

public void setAutoTuneConfig(AutoTuneConfig autoTuneConfig)

Set the configuration for AutoTune.

getDataSource

public DataSource getDataSource()

Return the DataSource.

setDataSource

public void setDataSource(DataSource dataSource)

Set a DataSource.

getDataSourceConfig

public DataSourceConfig getDataSourceConfig()

Return the configuration to build a DataSource using Ebean's own DataSource implementation.

setDataSourceConfig

public void setDataSourceConfig(DataSourceConfig dataSourceConfig)

Set the configuration required to build a DataSource using Ebean's own DataSource implementation.

getDataSourceJndiName

public String getDataSourceJndiName()

Return the JNDI name of the DataSource to use.

setDataSourceJndiName

public void setDataSourceJndiName(String dataSourceJndiName)

Set the JNDI name of the DataSource to use.

By default a prefix of "java:comp/env/jdbc/" is used to lookup the DataSource. This prefix is not used if dataSourceJndiName starts with "java:".

isAutoCommitMode

public boolean isAutoCommitMode()

Return true if autoCommit mode is on. This indicates to Ebean to use autoCommit friendly Transactions and TransactionManager.

setAutoCommitMode

public void setAutoCommitMode(boolean autoCommitMode)

Set to true if autoCommit mode is on and Ebean should use autoCommit friendly Transactions and TransactionManager.

isExplicitTransactionBeginMode

public boolean isExplicitTransactionBeginMode()

Return true if transaction begin should be started with explicit statement.

setExplicitTransactionBeginMode

public void setExplicitTransactionBeginMode(boolean explicitTransactionBeginMode)

Set to true if transaction begin should be started with explicit statement.

This works for H2 and Postgres but not for Oracle - only use this if you first name is Daryl or you have explicitly talked to Rob about this feature.

This is generally not expected to be turned on but instead allow transactions to start implicitly which is generally the standard approach.

getDatabaseBooleanTrue

public String getDatabaseBooleanTrue()

Return a value used to represent TRUE in the database.

This is used for databases that do not support boolean natively.

The value returned is either a Integer or a String (e.g. "1", or "T").

setDatabaseBooleanTrue

public void setDatabaseBooleanTrue(String databaseTrue)

Set the value to represent TRUE in the database.

This is used for databases that do not support boolean natively.

The value set is either a Integer or a String (e.g. "1", or "T").

getDatabaseBooleanFalse

public String getDatabaseBooleanFalse()

Return a value used to represent FALSE in the database.

This is used for databases that do not support boolean natively.

The value returned is either a Integer or a String (e.g. "0", or "F").

setDatabaseBooleanFalse

public void setDatabaseBooleanFalse(String databaseFalse)

Set the value to represent FALSE in the database.

This is used for databases that do not support boolean natively.

The value set is either a Integer or a String (e.g. "0", or "F").

getDatabaseSequenceBatchSize

public int getDatabaseSequenceBatchSize()

Return the number of DB sequence values that should be preallocated.

setDatabaseSequenceBatch

public void setDatabaseSequenceBatch(int databaseSequenceBatchSize)

Set the number of DB sequence values that should be preallocated and cached by Ebean.

This is only used for DB's that use sequences and is a performance optimisation. This reduces the number of times Ebean needs to get a sequence value from the Database reducing network chatter.

By default this value is 10 so when we need another Id (and don't have one in our cache) Ebean will fetch 10 id's from the database. Note that when the cache drops to have full (which is 5 by default) Ebean will fetch another batch of Id's in a background thread.

getDatabasePlatformName

public String getDatabasePlatformName()

Return the database platform name (can be null).

If null then the platform is determined automatically via the JDBC driver information.

setDatabasePlatformName

public void setDatabasePlatformName(String databasePlatformName)

Explicitly set the database platform name

If none is set then the platform is determined automatically via the JDBC driver information.

This can be used when the Database Platform can not be automatically detected from the JDBC driver (possibly 3rd party JDBC driver). It is also useful when you want to do offline DDL generation for a database platform that you don't have access to.

Values are oracle, h2, postgres, mysql, mssqlserver2005.

See Also:

DataSourceConfig.setOffline(boolean)

getDatabasePlatform

public DatabasePlatform getDatabasePlatform()

Return the database platform to use for this server.

setDatabasePlatform

public void setDatabasePlatform(DatabasePlatform databasePlatform)

Explicitly set the database platform to use.

If none is set then the platform is determined via the databasePlatformName or automatically via the JDBC driver information.

getEncryptKeyManager

public EncryptKeyManager getEncryptKeyManager()

Return the EncryptKeyManager.

setEncryptKeyManager

public void setEncryptKeyManager(EncryptKeyManager encryptKeyManager)

Set the EncryptKeyManager.

This is required when you want to use encrypted properties.

You can also set this in ebean.proprerties:

# set via ebean.properties

ebean.encryptKeyManager=com.avaje.tests.basic.encrypt.BasicEncyptKeyManager

getEncryptDeployManager

public EncryptDeployManager getEncryptDeployManager()

Return the EncryptDeployManager.

This is optionally used to programmatically define which columns are encrypted instead of using the Encrypted Annotation.

setEncryptDeployManager

public void setEncryptDeployManager(EncryptDeployManager encryptDeployManager)

Set the EncryptDeployManager.

This is optionally used to programmatically define which columns are encrypted instead of using the Encrypted Annotation.

getEncryptor

public Encryptor getEncryptor()

Return the Encryptor used to encrypt data on the java client side (as opposed to DB encryption functions).

setEncryptor

public void setEncryptor(Encryptor encryptor)

Set the Encryptor used to encrypt data on the java client side (as opposed to DB encryption functions).

Ebean has a default implementation that it will use if you do not set your own Encryptor implementation.

getDbEncrypt

public DbEncrypt getDbEncrypt()

Return the DbEncrypt used to encrypt and decrypt properties.

Note that if this is not set then the DbPlatform may already have a DbEncrypt set and that will be used.

setDbEncrypt

public void setDbEncrypt(DbEncrypt dbEncrypt)

Set the DbEncrypt used to encrypt and decrypt properties.

Note that if this is not set then the DbPlatform may already have a DbEncrypt set (H2, MySql, Postgres and Oracle platforms have a DbEncrypt)

getDbUuid

public ServerConfig.DbUuid getDbUuid()

Return the DB type used to store UUID.

setDbUuid

public void setDbUuid(ServerConfig.DbUuid dbUuid)

Set the DB type used to store UUID.

isLocalTimeWithNanos

public boolean isLocalTimeWithNanos()

Return true if LocalTime should be persisted with nanos precision.

setLocalTimeWithNanos

public void setLocalTimeWithNanos(boolean localTimeWithNanos)

Set to true if LocalTime should be persisted with nanos precision.

Otherwise it is persisted using java.sql.Time which is seconds precision.

isDurationWithNanos

public boolean isDurationWithNanos()

Return true if Duration should be persisted with nanos precision (SQL DECIMAL).

Otherwise it is persisted with second precision (SQL INTEGER).

setDurationWithNanos

public void setDurationWithNanos(boolean durationWithNanos)

Set to true if Duration should be persisted with nanos precision (SQL DECIMAL).

Otherwise it is persisted with second precision (SQL INTEGER).

setDdlGenerate

public void setDdlGenerate(boolean ddlGenerate)

Set to true to run the DDL generation on startup.

setDdlRun

public void setDdlRun(boolean ddlRun)

Set to true to run the generated DDL on startup.

isDdlGenerate

public boolean isDdlGenerate()

Return true if the DDL should be generated.

isDdlRun

public boolean isDdlRun()

Return true if the DDL should be run.

isDisableClasspathSearch

public boolean isDisableClasspathSearch()

Return true if the class path search should be disabled.

setDisableClasspathSearch

public void setDisableClasspathSearch(boolean disableClasspathSearch)

Set to true to disable the class path search even for the case where no entity bean classes have been registered. This can be used to start an EbeanServer instance just to use the SQL functions such as SqlQuery, SqlUpdate etc.

addClass

public void addClass(Class<?> cls)

Programmatically add classes (typically entities) that this server should use.

The class can be an Entity, Embedded type, ScalarType, BeanPersistListener, BeanFinder or BeanPersistController.

If no classes are specified then the classes are found automatically via searching the class path.

Alternatively the classes can be added via setClasses(List).

Parameters:

cls - the entity type (or other type) that should be registered by this server.

addPackage

public void addPackage(String packageName)

Add a package to search for entities via class path search.

This is only used if classes have not been explicitly specified.

getPackages

public List<String> getPackages()

Return packages to search for entities via class path search.

This is only used if classes have not been explicitly specified.

setPackages

public void setPackages(List<String> packages)

Set packages to search for entities via class path search.

This is only used if classes have not been explicitly specified.

addJar

public void addJar(String jarName)

Add the name of a Jar to search for entities via class path search.

This is only used if classes have not been explicitly specified.

If you are using ebean.properties you can specify jars to search by setting a ebean.search.jars property.

# EBean will search through classes for entities, but will not search jar files 
# unless you tell it to do so, for performance reasons.  Set this value to a 
# comma-delimited list of jar files you want ebean to search.
ebean.search.jars=example.jar

getJars

public List<String> getJars()

Return packages to search for entities via class path search.

This is only used if classes have not been explicitly specified.

setJars

public void setJars(List<String> searchJars)

Set the names of Jars to search for entities via class path search.

This is only used if classes have not been explicitly specified.

getClassPathReaderClassName

public String getClassPathReaderClassName()

Return the class name of a classPathReader implementation.

setClassPathReaderClassName

public void setClassPathReaderClassName(String classPathReaderClassName)

Set the class name of a classPathReader implementation. Refer to server.util.ClassPathReader, this should really by a plugin but doing this for now to be relatively compatible with current implementation.

setClasses

public void setClasses(List<Class<?>> classes)

Set the list of classes (entities, listeners, scalarTypes etc) that should be used for this server.

If no classes are specified then the classes are found automatically via searching the class path.

Alternatively the classes can contain added via addClass(Class).

getClasses

public List<Class<?>> getClasses()

Return the classes registered for this server. Typically this includes entities and perhaps listeners.

isUpdateChangesOnly

public boolean isUpdateChangesOnly()

Return true to only update changed properties.

setUpdateChangesOnly

public void setUpdateChangesOnly(boolean updateChangesOnly)

Set to true to only update changed properties.

isUpdateAllPropertiesInBatch

public boolean isUpdateAllPropertiesInBatch()

Returns true if updates in JDBC batch default to include all properties by default.

setUpdateAllPropertiesInBatch

public void setUpdateAllPropertiesInBatch(boolean updateAllPropertiesInBatch)

Set to false if by default updates in JDBC batch should not include all properties.

This mode can be explicitly set per transaction.

See Also:

Transaction.setUpdateAllLoadedProperties(boolean)

isUpdatesDeleteMissingChildren

public boolean isUpdatesDeleteMissingChildren()

Return true if updates by default delete missing children when cascading save to a OneToMany or ManyToMany. When not set this defaults to true.

setUpdatesDeleteMissingChildren

public void setUpdatesDeleteMissingChildren(boolean updatesDeleteMissingChildren)

Set if updates by default delete missing children when cascading save to a OneToMany or ManyToMany. When not set this defaults to true.

isCollectQueryStatsByNode

public boolean isCollectQueryStatsByNode()

Return true if the ebeanServer should collection query statistics by ObjectGraphNode.

setCollectQueryStatsByNode

public void setCollectQueryStatsByNode(boolean collectQueryStatsByNode)

Set to true to collection query execution statistics by ObjectGraphNode.

These statistics can be used to highlight code/query 'origin points' that result in lots of lazy loading.

It is considered safe/fine to have this set to true for production.

This information can be later retrieved via MetaInfoManager.

See Also:

MetaInfoManager

isCollectQueryOrigins

public boolean isCollectQueryOrigins()

Return true if query plans should also collect their 'origins'. This means for a given query plan you can identify the code/origin points where this query resulted from including lazy loading origins.

setCollectQueryOrigins

public void setCollectQueryOrigins(boolean collectQueryOrigins)

Set to true if query plans should collect their 'origin' points. This means for a given query plan you can identify the code/origin points where this query resulted from including lazy loading origins.

This information can be later retrieved via MetaInfoManager.

See Also:

MetaInfoManager

getResourceDirectory

public String getResourceDirectory()

Returns the resource directory.

setResourceDirectory

public void setResourceDirectory(String resourceDirectory)

Sets the resource directory.

add

public void add(BeanQueryAdapter beanQueryAdapter)

Register a BeanQueryAdapter instance.

Note alternatively you can use setQueryAdapters(List) to set all the BeanQueryAdapter instances.

getQueryAdapters

public List<BeanQueryAdapter> getQueryAdapters()

Return the BeanQueryAdapter instances.

setQueryAdapters

public void setQueryAdapters(List<BeanQueryAdapter> queryAdapters)

Register all the BeanQueryAdapter instances.

Note alternatively you can use add(BeanQueryAdapter) to add BeanQueryAdapter instances one at a time.

add

public void add(BeanPersistController beanPersistController)

Register a BeanPersistController instance.

Note alternatively you can use setPersistControllers(List) to set all the BeanPersistController instances.

add

public void add(BeanPostLoad postLoad)

Register a BeanPostLoad instance.

Note alternatively you can use setPostLoaders(List) to set all the BeanPostLoad instances.

getFindControllers

public List<BeanFindController> getFindControllers()

Return the list of BeanFindController instances.

setFindControllers

public void setFindControllers(List<BeanFindController> findControllers)

Set the list of BeanFindController instances.

getPostLoaders

public List<BeanPostLoad> getPostLoaders()

Return the list of BeanPostLoader instances.

setPostLoaders

public void setPostLoaders(List<BeanPostLoad> postLoaders)

Set the list of BeanPostLoader instances.

getPersistControllers

public List<BeanPersistController> getPersistControllers()

Return the BeanPersistController instances.

setPersistControllers

public void setPersistControllers(List<BeanPersistController> persistControllers)

Register all the BeanPersistController instances.

Note alternatively you can use add(BeanPersistController) to add BeanPersistController instances one at a time.

add

public void add(TransactionEventListener listener)

Register a TransactionEventListener instance

Note alternatively you can use setTransactionEventListeners(List) to set all the TransactionEventListener instances.

getTransactionEventListeners

public List<TransactionEventListener> getTransactionEventListeners()

Return the TransactionEventListener instances.

setTransactionEventListeners

public void setTransactionEventListeners(List<TransactionEventListener> transactionEventListeners)

Register all the TransactionEventListener instances.

Note alternatively you can use add(TransactionEventListener) to add TransactionEventListener instances one at a time.

add

public void add(BeanPersistListener beanPersistListener)

Register a BeanPersistListener instance.

Note alternatively you can use setPersistListeners(List) to set all the BeanPersistListener instances.

getPersistListeners

public List<BeanPersistListener> getPersistListeners()

Return the BeanPersistListener instances.

add

public void add(BulkTableEventListener bulkTableEventListener)

Add a BulkTableEventListener

getBulkTableEventListeners

public List<BulkTableEventListener> getBulkTableEventListeners()

Return the list of BulkTableEventListener instances.

addServerConfigStartup

public void addServerConfigStartup(ServerConfigStartup configStartupListener)

Add a ServerConfigStartup.

getServerConfigStartupListeners

public List<ServerConfigStartup> getServerConfigStartupListeners()

Return the list of ServerConfigStartup instances.

setPersistListeners

public void setPersistListeners(List<BeanPersistListener> persistListeners)

Register all the BeanPersistListener instances.

Note alternatively you can use add(BeanPersistListener) to add BeanPersistListener instances one at a time.

getPersistenceContextScope

public PersistenceContextScope getPersistenceContextScope()

Return the default PersistenceContextScope to be used if one is not explicitly set on a query.

The PersistenceContextScope can specified on each query via .Query#setPersistenceContextScope(com.avaje.ebean.PersistenceContextScope). If it is not set on the query this default scope is used.

See Also:

Query.setPersistenceContextScope(com.avaje.ebean.PersistenceContextScope)

setPersistenceContextScope

public void setPersistenceContextScope(PersistenceContextScope persistenceContextScope)

Set the PersistenceContext scope to be used if one is not explicitly set on a query.

This defaults to PersistenceContextScope.TRANSACTION.

The PersistenceContextScope can specified on each query via .Query#setPersistenceContextScope(com.avaje.ebean.PersistenceContextScope). If it is not set on the query this scope is used.

See Also:

Query.setPersistenceContextScope(com.avaje.ebean.PersistenceContextScope)

loadFromProperties

public void loadFromProperties()

Load settings from ebean.properties.

loadFromProperties

public void loadFromProperties(Properties properties)

Load the settings from the given properties

loadTestProperties

public void loadTestProperties()

Load settings from test-ebean.properties and do nothing if the properties is not found.

This is typically used when test-ebean.properties is put into the test class path and used to configure Ebean for running tests.

getProperties

public Properties getProperties()

Return the properties that we used for configuration and were set via a call to loadFromProperties().

loadDataSourceSettings

protected void loadDataSourceSettings(PropertiesWrapper p)

loads the data source settings to preserve existing behaviour. IMHO, if someone has set the datasource config already, they don't want the settings to be reloaded and reset. This allows a descending class to override this behaviour and prevent it from happening.

Parameters:

p - - The defined property source passed to load settings

loadAutoTuneSettings

protected void loadAutoTuneSettings(PropertiesWrapper p)

This is broken out for the same reason as above - preserve existing behaviour but let it be overridden.

loadSettings

protected void loadSettings(PropertiesWrapper p)

Load the configuration settings from the properties file.

appliedPersistBatchOnCascade

public PersistBatch appliedPersistBatchOnCascade()

Return the PersistBatch mode to use for 'batchOnCascade' taking into account if the database platform supports getGeneratedKeys in batch mode.

Used to effectively turn off batchOnCascade for SQL Server - still allows explicit batch mode.

getObjectMapper

public Object getObjectMapper()

Return the Jackson ObjectMapper.

Note that this is not strongly typed as Jackson ObjectMapper is an optional dependency.

setObjectMapper

public void setObjectMapper(Object objectMapper)

Set the Jackson ObjectMapper.

Note that this is not strongly typed as Jackson ObjectMapper is an optional dependency.

isExpressionEqualsWithNullAsNoop

public boolean isExpressionEqualsWithNullAsNoop()

Return true if eq("someProperty", null) should to generate "1=1" rather than "is null" sql expression.

setExpressionEqualsWithNullAsNoop

public void setExpressionEqualsWithNullAsNoop(boolean expressionEqualsWithNullAsNoop)

Set to true if you want eq("someProperty", null) to generate "1=1" rather than "is null" sql expression.

Setting this to true has the effect that eq(propertyName, value), ieq(propertyName, value) and ne(propertyName, value) have no effect when the value is null. The expression factory adds a NoopExpression which will add "1=1" into the SQL rather than "is null".