public interface JDBCConfiguration extends OpenJPAConfiguration
Modifier and Type | Field and Description |
---|---|
static String |
LOG_DIAG
Name of the logger for additional jdbc messages:
openjpa.jdbc.DIAG . |
static String |
LOG_JDBC
Name of the logger for JDBC-related messages:
openjpa.jdbc.JDBC . |
static String |
LOG_SCHEMA
Name of the logger for schema-related messages:
openjpa.jdbc.Schema . |
static String |
LOG_SQL
Name of the logger for SQL execution messages:
openjpa.jdbc.SQL . |
LOG_DATACACHE, LOG_ENHANCE, LOG_METADATA, LOG_QUERY, LOG_RUNTIME, LOG_TOOL, OPTION_DATASTORE_CONNECTION, OPTION_EMBEDDED_COLLECTION_RELATION, OPTION_EMBEDDED_MAP_RELATION, OPTION_EMBEDDED_RELATION, OPTION_ID_APPLICATION, OPTION_ID_DATASTORE, OPTION_INC_FLUSH, OPTION_JDBC_CONNECTION, OPTION_NONTRANS_READ, OPTION_NULL_CONTAINER, OPTION_OPTIMISTIC, OPTION_POSTLOAD_ON_MERGE, OPTION_QUERY_SQL, OPTION_TYPE_ARRAY, OPTION_TYPE_COLLECTION, OPTION_TYPE_MAP, OPTION_USE_TCCL_IN_SELECT_NEW, OPTION_VALUE_AUTOASSIGN, OPTION_VALUE_INCREMENT
ATTRIBUTE_ALLOWED_VALUES, ATTRIBUTE_CATEGORY, ATTRIBUTE_INTERFACE, ATTRIBUTE_ORDER, ATTRIBUTE_TYPE, ATTRIBUTE_XML, INIT_STATE_FREEZING, INIT_STATE_FROZEN, INIT_STATE_LIQUID
ICON_COLOR_16x16, ICON_COLOR_32x32, ICON_MONO_16x16, ICON_MONO_32x32
Modifier and Type | Method and Description |
---|---|
ConnectionDecorator[] |
getConnectionDecoratorInstances()
The
ConnectionDecorator s to use. |
String |
getConnectionDecorators()
A comma-separated list of the
ConnectionDecorator for adding
functionality to JDBC connections. |
DataSource |
getDataSource(StoreContext ctx)
Return the primary data source to use.
|
DataSource |
getDataSource2(StoreContext ctx)
Return the non-enlisted data source to use.
|
String |
getDBDictionary()
The
DBDictionary to use to define the RDBMS SQL information. |
DBDictionary |
getDBDictionaryInstance()
The
DBDictionary to use. |
String |
getDriverDataSource()
|
String |
getEagerFetchMode()
Specifies the default eager fetch mode to use.
|
int |
getEagerFetchModeConstant()
Return the eager fetch mode as one of the following symbolic constants:
EagerFetchModes.EAGER_NONE
EagerFetchModes.EAGER_JOIN
EagerFetchModes.EAGER_PARALLEL
|
String |
getFetchDirection()
The JDBC fetch direction.
|
int |
getFetchDirectionConstant()
Return the result set constant for the fetch direction.
|
String |
getIdentifierUtil()
Gets the String constant that matches the
IdentifierUtil |
DBIdentifierUtil |
getIdentifierUtilInstance()
Gets the
DBIdentifierUtil |
JDBCListener[] |
getJDBCListenerInstances()
The
JDBCListener s to use. |
String |
getJDBCListeners()
A comma-separated list of the
JDBCListener plugins for
listening to JDBCEvent s. |
String |
getLRSSize()
How to obtain the size of large result sets.
|
int |
getLRSSizeConstant()
Return the
LRSSizes constant for the large result set size
setting. |
String |
getMappingDefaults()
A plugin string describing the
MappingDefaults to use. |
MappingDefaults |
getMappingDefaultsInstance()
The
MappingDefaults to use with a repository. |
String |
getMappingFactory()
A plugin string describing the
MetaDataFactory to use for
loading and storing object-relational mapping data. |
MappingRepository |
getMappingRepositoryInstance()
Return the mapping repository.
|
String |
getResultSetType()
The JDBC result set type.
|
int |
getResultSetTypeConstant()
Return the result set constant for the result set type.
|
String |
getSchema()
Default schema for unqualified tables.
|
String |
getSchemaFactory()
The plugin string for the
SchemaFactory to use to provide
schema information during system initialization. |
SchemaFactory |
getSchemaFactoryInstance()
The
SchemaFactory to use for schema information. |
String |
getSchemas()
Comma-separated list of modifiable schemas for persistent instances.
|
String[] |
getSchemasList()
Modificable schema components.
|
String |
getSQLFactory()
The SQL factory to use for SQL constructs.
|
SQLFactory |
getSQLFactoryInstance()
The SQL factory to use for SQL constructs.
|
String |
getSubclassFetchMode()
Specifies the default subclass fetch mode to use.
|
int |
getSubclassFetchModeConstant()
Return the subclass fetch mode as one of the following symbolic
constants:
EagerFetchModes.EAGER_NONE
EagerFetchModes.EAGER_JOIN
EagerFetchModes.EAGER_PARALLEL
|
String |
getSynchronizeMappings()
Whether OpenJPA should try to automatically refresh O/R mapping
information and the database schema.
|
String |
getTransactionIsolation()
The transaction isolation level to use at the database level.
|
int |
getTransactionIsolationConstant()
Return the proper transaction isolation level constant from
Connection , or -1 for the default level. |
String |
getUpdateManager()
The
UpdateManager to use for managing SQL updates. |
UpdateManager |
getUpdateManagerInstance()
The
UpdateManager for runtime data store interaction. |
DriverDataSource |
newDriverDataSourceInstance()
|
MappingRepository |
newMappingRepositoryInstance()
Return a new empty mapping repository of the configured type.
|
void |
setConnectionDecorators(ConnectionDecorator[] decorators)
The
ConnectionDecorator s to use. |
void |
setConnectionDecorators(String decorators)
A comma-separated list of the
ConnectionDecorator for
adding functionality to JDBC connections. |
void |
setDBDictionary(DBDictionary dbdictionary)
The
DBDictionary to use. |
void |
setDBDictionary(String dbdictionary)
The
DBDictionary to use to define the RDBMS SQL information. |
void |
setDriverDataSource(String driverDataSource)
|
void |
setEagerFetchMode(int eagerFetchMode)
Set the eager fetch mode as one of the following symbolic constants:
EagerFetchModes.EAGER_NONE
EagerFetchModes.EAGER_JOIN
EagerFetchModes.EAGER_PARALLEL
|
void |
setEagerFetchMode(String mode)
Specifies the default eager fetch mode to use.
|
void |
setFetchDirection(int direction)
Set the result set fetch direction constant.
|
void |
setFetchDirection(String direction)
The JDBC fetch direction.
|
void |
setIdentifierUtil(DBIdentifierUtil util)
Sets the
DBIdentifierUtil |
void |
setJDBCListeners(JDBCListener[] jdbcListeners)
The
JDBCListener s to use. |
void |
setJDBCListeners(String jdbcListeners)
A comma-separated list of the
JDBCListener plugins for
listening to JDBCEvent s. |
void |
setLRSSize(int size)
Set the fetch configuration large result set size constant.
|
void |
setLRSSize(String lrsSize)
How to obtain the size of large result sets.
|
void |
setMappingDefaults(MappingDefaults map)
The
MappingDefaults to use with a repository. |
void |
setMappingDefaults(String map)
A plugin string describing the
MappingDefaults to use. |
void |
setMappingFactory(String mappingFactory)
A plugin string describing the
MetaDataFactory to use for
loading and storing object-relational mapping data. |
void |
setResultSetType(int type)
Set the result set constant type.
|
void |
setResultSetType(String type)
The JDBC result set type.
|
void |
setSchema(String schema)
Default schema for unqualified tables.
|
void |
setSchemaFactory(SchemaFactory schemaFactory)
The
SchemaFactory to use for schema information. |
void |
setSchemaFactory(String schemaFactory)
The plugin string for the
SchemaFactory to use to provide
schema information during system initialization. |
void |
setSchemas(String schemas)
Comma-separated list of modifiable schemas for persistent instances.
|
void |
setSchemas(String[] schemas)
Modifiable schema components.
|
void |
setSQLFactory(SQLFactory sqlFactory)
The SQL factory to use for SQL constructs.
|
void |
setSQLFactory(String sqlFactory)
The SQL factory to use for SQL constructs.
|
void |
setSubclassFetchMode(int subclassFetchMode)
Set the subclass fetch mode as one of the following symbolic constants:
EagerFetchModes.EAGER_NONE
EagerFetchModes.EAGER_JOIN
EagerFetchModes.EAGER_PARALLEL
|
void |
setSubclassFetchMode(String mode)
Specifies the default subclass fetch mode to use.
|
void |
setSynchronizeMappings(String synchronizeMappings)
Whether OpenJPA should try to automatically refresh O/R mapping
information and the database schema.
|
void |
setTransactionIsolation(int level)
Set the proper transaction isolation level constant from
Connection , or -1 for the default level. |
void |
setTransactionIsolation(String level)
The transaction isolation level to use at the database level.
|
void |
setUpdateManager(String updateManager)
The
UpdateManager to use for managing SQL updates. |
void |
setUpdateManager(UpdateManager updateManager)
The
UpdateManager for runtime data store interaction. |
getAggregateListenerInstances, getAggregateListeners, getAuditor, getAuditorInstance, getAutoClear, getAutoClearConstant, getAutoDetach, getAutoDetachConstant, getBrokerFactory, getBrokerFactoryEventManager, getBrokerImpl, getCacheDistributionPolicy, getCacheDistributionPolicyInstance, getCacheMarshallerInstances, getCacheMarshallers, getCallbackOptions, getCallbackOptionsInstance, getClassResolver, getClassResolverInstance, getCompatibility, getCompatibilityInstance, getConnection2DriverName, getConnection2Password, getConnection2Properties, getConnection2URL, getConnection2UserName, getConnectionDriverName, getConnectionFactory, getConnectionFactory2, getConnectionFactory2Name, getConnectionFactory2Properties, getConnectionFactoryMode, getConnectionFactoryName, getConnectionFactoryProperties, getConnectionPassword, getConnectionProperties, getConnectionRetainMode, getConnectionRetainModeConstant, getConnectionURL, getConnectionUserName, getDataCache, getDataCacheManager, getDataCacheManagerInstance, getDataCacheMode, getDataCacheTimeout, getDetachStateInstance, getDynamicDataStructs, getDynamicEnhancementAgent, getEncryptionProvider, getFetchBatchSize, getFetchGroups, getFetchGroupsList, getFilterListenerInstances, getFilterListeners, getFinderCache, getFinderCacheInstance, getFlushBeforeQueries, getFlushBeforeQueriesConstant, getIgnoreChanges, getInstrumentation, getInstrumentationManagerInstance, getInverseManager, getLifecycleEventManager, getLifecycleEventManagerInstance, getLockManager, getLockTimeout, getManagedRuntime, getManagedRuntimeInstance, getMapping, getMaxFetchDepth, getMetaDataFactory, getMetaDataRepository, getMetaDataRepositoryInstance, getMultithreaded, getNontransactionalRead, getNontransactionalWrite, getOptimistic, getOptimizeIdCopy, getOrphanedKeyAction, getOrphanedKeyActionInstance, getPostLoadOnMerge, getProxyManager, getProxyManagerInstance, getQueryCache, getQueryCompilationCache, getQueryCompilationCacheInstance, getQuerySQLCache, getQuerySQLCacheInstance, getQueryTimeout, getReadLockLevel, getReadLockLevelConstant, getRefreshFromDataCache, getRemoteCommitEventManager, getRemoteCommitProvider, getRestoreState, getRestoreStateConstant, getRetainState, getRetryClassRegistration, getRuntimeUnenhancedClasses, getRuntimeUnenhancedClassesConstant, getSavepointManager, getSavepointManagerInstance, getSequence, getSequenceInstance, getSpecification, getSpecificationInstance, getStoreFacadeTypeRegistry, getTransactionMode, getUseTCCLinSelectNew, getValidationFactoryInstance, getValidationGroupPrePersist, getValidationGroupPreRemove, getValidationGroupPreUpdate, getValidationMode, getValidatorInstance, getWriteLockLevel, getWriteLockLevelConstant, isConnectionFactoryModeManaged, isInitializeEagerly, isTransactionModeManaged, metaDataRepositoryAvailable, newBrokerInstance, newInverseManagerInstance, newLockManagerInstance, newMetaDataFactoryInstance, newMetaDataRepositoryInstance, newRemoteCommitProviderInstance, setAggregateListeners, setAggregateListeners, setAuditor, setAuditorInstance, setAutoClear, setAutoClear, setAutoDetach, setAutoDetach, setBrokerFactory, setBrokerImpl, setCacheDistributionPolicy, setCacheDistributionPolicyInstance, setCacheMarshallers, setCallbackOptions, setClassResolver, setClassResolver, setCompatibility, setConnection2DriverName, setConnection2Password, setConnection2Properties, setConnection2URL, setConnection2UserName, setConnectionDriverName, setConnectionFactory, setConnectionFactory2, setConnectionFactory2Name, setConnectionFactory2Properties, setConnectionFactoryMode, setConnectionFactoryModeManaged, setConnectionFactoryName, setConnectionFactoryProperties, setConnectionPassword, setConnectionProperties, setConnectionRetainMode, setConnectionRetainMode, setConnectionURL, setConnectionUserName, setDataCache, setDataCacheManager, setDataCacheManager, setDataCacheMode, setDataCacheTimeout, setDataCacheTimeout, setDetachState, setDetachState, setDynamicDataStructs, setDynamicDataStructs, setDynamicEnhancementAgent, setEncryptionProvider, setFetchBatchSize, setFetchBatchSize, setFetchGroups, setFetchGroups, setFilterListeners, setFilterListeners, setFinderCache, setFlushBeforeQueries, setFlushBeforeQueries, setIgnoreChanges, setIgnoreChanges, setInitializeEagerly, setInstrumentation, setInverseManager, setLifecycleEventManager, setLockManager, setLockTimeout, setLockTimeout, setManagedRuntime, setManagedRuntime, setMapping, setMaxFetchDepth, setMaxFetchDepth, setMetaDataFactory, setMetaDataRepository, setMetaDataRepository, setMultithreaded, setMultithreaded, setNontransactionalRead, setNontransactionalRead, setNontransactionalWrite, setNontransactionalWrite, setOptimistic, setOptimistic, setOptimizeIdCopy, setOptimizeIdCopy, setOrphanedKeyAction, setOrphanedKeyAction, setPostLoadOnMerge, setPostLoadOnMerge, setProxyManager, setProxyManager, setQueryCache, setQueryCompilationCache, setQuerySQLCache, setQuerySQLCache, setQueryTimeout, setReadLockLevel, setReadLockLevel, setRefreshFromDataCache, setRefreshFromDataCache, setRemoteCommitEventManager, setRemoteCommitProvider, setRestoreState, setRestoreState, setRetainState, setRetainState, setRetryClassRegistration, setRetryClassRegistration, setRuntimeUnenhancedClasses, setRuntimeUnenhancedClasses, setSavepointManager, setSequence, setSequence, setSpecification, setSpecification, setTransactionMode, setTransactionModeManaged, setUseTCCLinSelectNew, setUseTCCLinSelectNew, setValidationFactory, setValidationGroupPrePersist, setValidationGroupPreRemove, setValidationGroupPreUpdate, setValidationMode, setValidatorInstance, setWriteLockLevel, setWriteLockLevel, supportedOptions
addPropertyChangeListener, addValue, clone, close, fromProperties, getConfigurationLog, getId, getLog, getLog, getLogFactory, getProductName, getPropertyKeys, getPropertyKeys, getUserClassLoader, getValue, getValues, instantiateAll, isReadOnly, removePropertyChangeListener, removeValue, setId, setLog, setLogFactory, setProductName, setReadOnly, setUserClassLoader, toProperties
getAdditionalBeanInfo, getBeanDescriptor, getDefaultEventIndex, getDefaultPropertyIndex, getEventSetDescriptors, getIcon, getMethodDescriptors, getPropertyDescriptors
static final String LOG_SQL
openjpa.jdbc.SQL
.static final String LOG_DIAG
openjpa.jdbc.DIAG
.static final String LOG_JDBC
openjpa.jdbc.JDBC
.static final String LOG_SCHEMA
openjpa.jdbc.Schema
.String getSchema()
void setSchema(String schema)
String getSchemas()
void setSchemas(String schemas)
String[] getSchemasList()
void setSchemas(String[] schemas)
String getTransactionIsolation()
default
: The JDBC driver's default isolation level.none
: The standard JDBC
Connection.TRANSACTION_NONE
level.read-committed
: The standard JDBC
Connection.TRANSACTION_READ_COMMITTED
level.read-uncommitted
: The standard JDBC
Connection.TRANSACTION_READ_UNCOMMITTED
level.repeatable-read
: The standard JDBC
Connection.TRANSACTION_REPEATABLE_READ
level.serializable
: The standard JDBC
Connection.TRANSACTION_SERIALIZABLE
level.void setTransactionIsolation(String level)
default
: The JDBC driver's default isolation level.none
: The standard JDBC
Connection.TRANSACTION_NONE
level.read-committed
: The standard JDBC
Connection.TRANSACTION_READ_COMMITTED
level.read-uncommitted
: The standard JDBC
Connection.TRANSACTION_READ_UNCOMMITTED
level.repeatable-read
: The standard JDBC
Connection.TRANSACTION_REPEATABLE_READ
level.serializable
: The standard JDBC
Connection.TRANSACTION_SERIALIZABLE
level.int getTransactionIsolationConstant()
Connection
, or -1 for the default level.void setTransactionIsolation(int level)
Connection
, or -1 for the default level.String getResultSetType()
forward-only
.
forward-only
: The standard JDBC
ResultSet.TYPE_FORWARD_ONLY
type.scroll-sensitive
: The standard JDBC
ResultSet.TYPE_SCROLL_SENSITIVE
type.scroll-insensitive
: The standard JDBC
ResultSet.TYPE_SCROLL_INSENSITIVE
type.int getResultSetTypeConstant()
void setResultSetType(String type)
forward-only
.
forward-only
: The standard JDBC
ResultSet.TYPE_FORWARD_ONLY
type.scroll-sensitive
: The standard JDBC
ResultSet.TYPE_SCROLL_SENSITIVE
type.scroll-insensitive
: The standard JDBC
ResultSet.TYPE_SCROLL_INSENSITIVE
type.void setResultSetType(int type)
String getFetchDirection()
forward
.
forward
: The standard JDBC
ResultSet.FETCH_FORWARD
direction.reverse
: The standard JDBC
ResultSet.FETCH_REVERSE
direction.unknown
: The standard JDBC
ResultSet.FETCH_UNKNOWN
direction.int getFetchDirectionConstant()
void setFetchDirection(String direction)
forward
.
forward
: The standard JDBC
ResultSet.FETCH_FORWARD
direction.reverse
: The standard JDBC
ResultSet.FETCH_REVERSE
direction.unknown
: The standard JDBC
ResultSet.FETCH_UNKNOWN
direction.void setFetchDirection(int direction)
String getEagerFetchMode()
parallel
unless the query is by-oid. Possible values are:
none
: When querying for an object, do not try to
select for related objects at the same time.join
: When querying for objects, also select for
1-1 relations in the configured fetch groups using joins.parallel
: When querying for objects, also select for
both 1-1 relations using joins and to-many relations using batched
selects.void setEagerFetchMode(String mode)
parallel
unless the query is by-oid. Possible values are:
none
: When querying for an object, do not try to
select for related objects at the same time.join
: When querying for objects, also select for
1-1 relations in the configured fetch groups using joins.parallel
: When querying for objects, also select for
both 1-1 relations using joins and to-many relations using batched
selects.int getEagerFetchModeConstant()
void setEagerFetchMode(int eagerFetchMode)
String getSubclassFetchMode()
join
unless the query is by-oid. Possible values are:
none
: Only select base class data.join
: Select both base class and all possible subclass
data using joins.parallel
: Select for each possible subclass
separately.void setSubclassFetchMode(String mode)
join
unless the query is by-oid. Possible values are:
none
: Only select base class data.join
: Select both base class and all possible subclass
data using joins.parallel
: Select for each possible subclass
separately.int getSubclassFetchModeConstant()
void setSubclassFetchMode(int subclassFetchMode)
String getLRSSize()
unknown
.
unknown
: Do not attempt to calculate the size of
large result sets; return Integer.MAX_VALUE
.last
: For result sets that support random access,
calculate the size using ResultSet.last()
.query
: Use a separate COUNT query to calculate the
size of the results.int getLRSSizeConstant()
LRSSizes
constant for the large result set size
setting.void setLRSSize(String lrsSize)
unknown
.
unknown
: Do not attempt to calculate the size of
large result sets; return Integer.MAX_VALUE
.last
: For result sets that support random access,
calculate the size using ResultSet.last()
.query
: Use a separate COUNT query to calculate the
size of the results.void setLRSSize(int size)
String getSynchronizeMappings()
void setSynchronizeMappings(String synchronizeMappings)
String getJDBCListeners()
JDBCListener
plugins for
listening to JDBCEvent
s.void setJDBCListeners(String jdbcListeners)
JDBCListener
plugins for
listening to JDBCEvent
s.JDBCListener[] getJDBCListenerInstances()
JDBCListener
s to use.void setJDBCListeners(JDBCListener[] jdbcListeners)
JDBCListener
s to use.String getConnectionDecorators()
ConnectionDecorator
for adding
functionality to JDBC connections.void setConnectionDecorators(String decorators)
ConnectionDecorator
for
adding functionality to JDBC connections.ConnectionDecorator[] getConnectionDecoratorInstances()
ConnectionDecorator
s to use.void setConnectionDecorators(ConnectionDecorator[] decorators)
ConnectionDecorator
s to use.String getDBDictionary()
DBDictionary
to use to define the RDBMS SQL information.void setDBDictionary(String dbdictionary)
DBDictionary
to use to define the RDBMS SQL information.DBDictionary getDBDictionaryInstance()
DBDictionary
to use.void setDBDictionary(DBDictionary dbdictionary)
DBDictionary
to use.String getUpdateManager()
UpdateManager
to use for managing SQL updates.void setUpdateManager(String updateManager)
UpdateManager
to use for managing SQL updates.UpdateManager getUpdateManagerInstance()
UpdateManager
for runtime data store interaction.void setUpdateManager(UpdateManager updateManager)
UpdateManager
for runtime data store interaction.String getDriverDataSource()
void setDriverDataSource(String driverDataSource)
DriverDataSource newDriverDataSourceInstance()
String getSchemaFactory()
SchemaFactory
to use to provide
schema information during system initialization.void setSchemaFactory(String schemaFactory)
SchemaFactory
to use to provide
schema information during system initialization.SchemaFactory getSchemaFactoryInstance()
SchemaFactory
to use for schema information.void setSchemaFactory(SchemaFactory schemaFactory)
SchemaFactory
to use for schema information.String getSQLFactory()
SQLFactory getSQLFactoryInstance()
void setSQLFactory(String sqlFactory)
void setSQLFactory(SQLFactory sqlFactory)
String getMappingFactory()
MetaDataFactory
to use for
loading and storing object-relational mapping data.void setMappingFactory(String mappingFactory)
MetaDataFactory
to use for
loading and storing object-relational mapping data.String getMappingDefaults()
MappingDefaults
to use.void setMappingDefaults(String map)
MappingDefaults
to use.MappingDefaults getMappingDefaultsInstance()
MappingDefaults
to use with a repository.void setMappingDefaults(MappingDefaults map)
MappingDefaults
to use with a repository.MappingRepository getMappingRepositoryInstance()
MappingRepository newMappingRepositoryInstance()
DataSource getDataSource(StoreContext ctx)
DataSource.getConnection()
. If the given context is null, the
data source will use the configuration's default connection user name
and password. If those too are null and the first context has been
obtained already, then the user name and password for that context
will be used, as we know they represent a valid combination. This
method avoids casting the result of
OpenJPAConfiguration.getConnectionFactory()
, and avoids having to
pass in the user name and password to obtain connections.DataSource getDataSource2(StoreContext ctx)
DataSource.getConnection()
will be the specified connection 2
user name and password. If those are null and the given context is
non-null, its user name password will be used instead. If the context
is null too, then the user name and password used to retrieve the first
context will be used. If there is no second connection factory the
primary connection factory is used.String getIdentifierUtil()
IdentifierUtil
IdentifierUtil
DBIdentifierUtil getIdentifierUtilInstance()
DBIdentifierUtil
void setIdentifierUtil(DBIdentifierUtil util)
DBIdentifierUtil
util
- instance of the identifier utilityCopyright © 2006–2017 Apache Software Foundation. All rights reserved.