Package org.apache.ibatis.session
Class Configuration
- java.lang.Object
 - 
- org.apache.ibatis.session.Configuration
 
 
- 
public class Configuration extends Object
- Author:
 - Clinton Begin
 
 
- 
- 
Nested Class Summary
Nested Classes Modifier and Type Class Description protected static classConfiguration.StrictMap<V> 
- 
Field Summary
 
- 
Constructor Summary
Constructors Constructor Description Configuration()Configuration(Environment environment) 
- 
Method Summary
 
 - 
 
- 
- 
Field Detail
- 
environment
protected Environment environment
 
- 
safeRowBoundsEnabled
protected boolean safeRowBoundsEnabled
 
- 
safeResultHandlerEnabled
protected boolean safeResultHandlerEnabled
 
- 
mapUnderscoreToCamelCase
protected boolean mapUnderscoreToCamelCase
 
- 
aggressiveLazyLoading
protected boolean aggressiveLazyLoading
 
- 
multipleResultSetsEnabled
protected boolean multipleResultSetsEnabled
 
- 
useGeneratedKeys
protected boolean useGeneratedKeys
 
- 
useColumnLabel
protected boolean useColumnLabel
 
- 
cacheEnabled
protected boolean cacheEnabled
 
- 
callSettersOnNulls
protected boolean callSettersOnNulls
 
- 
useActualParamName
protected boolean useActualParamName
 
- 
returnInstanceForEmptyRow
protected boolean returnInstanceForEmptyRow
 
- 
shrinkWhitespacesInSql
protected boolean shrinkWhitespacesInSql
 
- 
nullableOnForEach
protected boolean nullableOnForEach
 
- 
argNameBasedConstructorAutoMapping
protected boolean argNameBasedConstructorAutoMapping
 
- 
logPrefix
protected String logPrefix
 
- 
defaultSqlProviderType
protected Class<?> defaultSqlProviderType
 
- 
localCacheScope
protected LocalCacheScope localCacheScope
 
- 
jdbcTypeForNull
protected JdbcType jdbcTypeForNull
 
- 
defaultStatementTimeout
protected Integer defaultStatementTimeout
 
- 
defaultFetchSize
protected Integer defaultFetchSize
 
- 
defaultResultSetType
protected ResultSetType defaultResultSetType
 
- 
defaultExecutorType
protected ExecutorType defaultExecutorType
 
- 
autoMappingBehavior
protected AutoMappingBehavior autoMappingBehavior
 
- 
autoMappingUnknownColumnBehavior
protected AutoMappingUnknownColumnBehavior autoMappingUnknownColumnBehavior
 
- 
variables
protected Properties variables
 
- 
reflectorFactory
protected ReflectorFactory reflectorFactory
 
- 
objectFactory
protected ObjectFactory objectFactory
 
- 
objectWrapperFactory
protected ObjectWrapperFactory objectWrapperFactory
 
- 
lazyLoadingEnabled
protected boolean lazyLoadingEnabled
 
- 
proxyFactory
protected ProxyFactory proxyFactory
 
- 
databaseId
protected String databaseId
 
- 
configurationFactory
protected Class<?> configurationFactory
Configuration factory class. Used to create Configuration for loading deserialized unread properties.- See Also:
 - Issue 300 (google code)
 
 
- 
mapperRegistry
protected final MapperRegistry mapperRegistry
 
- 
interceptorChain
protected final InterceptorChain interceptorChain
 
- 
typeHandlerRegistry
protected final TypeHandlerRegistry typeHandlerRegistry
 
- 
typeAliasRegistry
protected final TypeAliasRegistry typeAliasRegistry
 
- 
languageRegistry
protected final LanguageDriverRegistry languageRegistry
 
- 
mappedStatements
protected final Map<String,MappedStatement> mappedStatements
 
- 
parameterMaps
protected final Map<String,ParameterMap> parameterMaps
 
- 
keyGenerators
protected final Map<String,KeyGenerator> keyGenerators
 
- 
incompleteStatements
protected final Collection<XMLStatementBuilder> incompleteStatements
 
- 
incompleteCacheRefs
protected final Collection<CacheRefResolver> incompleteCacheRefs
 
- 
incompleteResultMaps
protected final Collection<ResultMapResolver> incompleteResultMaps
 
- 
incompleteMethods
protected final Collection<MethodResolver> incompleteMethods
 
 - 
 
- 
Constructor Detail
- 
Configuration
public Configuration(Environment environment)
 
- 
Configuration
public Configuration()
 
 - 
 
- 
Method Detail
- 
getLogPrefix
public String getLogPrefix()
 
- 
setLogPrefix
public void setLogPrefix(String logPrefix)
 
- 
getDefaultSqlProviderType
public Class<?> getDefaultSqlProviderType()
Gets an applying type when omit a type on sql provider annotation(e.g.SelectProvider).- Returns:
 - the default type for sql provider annotation
 - Since:
 - 3.5.6
 
 
- 
setDefaultSqlProviderType
public void setDefaultSqlProviderType(Class<?> defaultSqlProviderType)
Sets an applying type when omit a type on sql provider annotation(e.g.SelectProvider).- Parameters:
 defaultSqlProviderType- the default type for sql provider annotation- Since:
 - 3.5.6
 
 
- 
isCallSettersOnNulls
public boolean isCallSettersOnNulls()
 
- 
setCallSettersOnNulls
public void setCallSettersOnNulls(boolean callSettersOnNulls)
 
- 
isUseActualParamName
public boolean isUseActualParamName()
 
- 
setUseActualParamName
public void setUseActualParamName(boolean useActualParamName)
 
- 
isReturnInstanceForEmptyRow
public boolean isReturnInstanceForEmptyRow()
 
- 
setReturnInstanceForEmptyRow
public void setReturnInstanceForEmptyRow(boolean returnEmptyInstance)
 
- 
isShrinkWhitespacesInSql
public boolean isShrinkWhitespacesInSql()
 
- 
setShrinkWhitespacesInSql
public void setShrinkWhitespacesInSql(boolean shrinkWhitespacesInSql)
 
- 
setNullableOnForEach
public void setNullableOnForEach(boolean nullableOnForEach)
Sets the default value of 'nullable' attribute on 'foreach' tag.- Parameters:
 nullableOnForEach- If nullable, set totrue- Since:
 - 3.5.9
 
 
- 
isNullableOnForEach
public boolean isNullableOnForEach()
Returns the default value of 'nullable' attribute on 'foreach' tag.Default is
false.- Returns:
 - If nullable, set to 
true - Since:
 - 3.5.9
 
 
- 
isArgNameBasedConstructorAutoMapping
public boolean isArgNameBasedConstructorAutoMapping()
 
- 
setArgNameBasedConstructorAutoMapping
public void setArgNameBasedConstructorAutoMapping(boolean argNameBasedConstructorAutoMapping)
 
- 
getDatabaseId
public String getDatabaseId()
 
- 
setDatabaseId
public void setDatabaseId(String databaseId)
 
- 
getConfigurationFactory
public Class<?> getConfigurationFactory()
 
- 
setConfigurationFactory
public void setConfigurationFactory(Class<?> configurationFactory)
 
- 
isSafeResultHandlerEnabled
public boolean isSafeResultHandlerEnabled()
 
- 
setSafeResultHandlerEnabled
public void setSafeResultHandlerEnabled(boolean safeResultHandlerEnabled)
 
- 
isSafeRowBoundsEnabled
public boolean isSafeRowBoundsEnabled()
 
- 
setSafeRowBoundsEnabled
public void setSafeRowBoundsEnabled(boolean safeRowBoundsEnabled)
 
- 
isMapUnderscoreToCamelCase
public boolean isMapUnderscoreToCamelCase()
 
- 
setMapUnderscoreToCamelCase
public void setMapUnderscoreToCamelCase(boolean mapUnderscoreToCamelCase)
 
- 
addLoadedResource
public void addLoadedResource(String resource)
 
- 
isResourceLoaded
public boolean isResourceLoaded(String resource)
 
- 
getEnvironment
public Environment getEnvironment()
 
- 
setEnvironment
public void setEnvironment(Environment environment)
 
- 
getAutoMappingBehavior
public AutoMappingBehavior getAutoMappingBehavior()
 
- 
setAutoMappingBehavior
public void setAutoMappingBehavior(AutoMappingBehavior autoMappingBehavior)
 
- 
getAutoMappingUnknownColumnBehavior
public AutoMappingUnknownColumnBehavior getAutoMappingUnknownColumnBehavior()
Gets the auto mapping unknown column behavior.- Returns:
 - the auto mapping unknown column behavior
 - Since:
 - 3.4.0
 
 
- 
setAutoMappingUnknownColumnBehavior
public void setAutoMappingUnknownColumnBehavior(AutoMappingUnknownColumnBehavior autoMappingUnknownColumnBehavior)
Sets the auto mapping unknown column behavior.- Parameters:
 autoMappingUnknownColumnBehavior- the new auto mapping unknown column behavior- Since:
 - 3.4.0
 
 
- 
isLazyLoadingEnabled
public boolean isLazyLoadingEnabled()
 
- 
setLazyLoadingEnabled
public void setLazyLoadingEnabled(boolean lazyLoadingEnabled)
 
- 
getProxyFactory
public ProxyFactory getProxyFactory()
 
- 
setProxyFactory
public void setProxyFactory(ProxyFactory proxyFactory)
 
- 
isAggressiveLazyLoading
public boolean isAggressiveLazyLoading()
 
- 
setAggressiveLazyLoading
public void setAggressiveLazyLoading(boolean aggressiveLazyLoading)
 
- 
isMultipleResultSetsEnabled
public boolean isMultipleResultSetsEnabled()
 
- 
setMultipleResultSetsEnabled
public void setMultipleResultSetsEnabled(boolean multipleResultSetsEnabled)
 
- 
setLazyLoadTriggerMethods
public void setLazyLoadTriggerMethods(Set<String> lazyLoadTriggerMethods)
 
- 
isUseGeneratedKeys
public boolean isUseGeneratedKeys()
 
- 
setUseGeneratedKeys
public void setUseGeneratedKeys(boolean useGeneratedKeys)
 
- 
getDefaultExecutorType
public ExecutorType getDefaultExecutorType()
 
- 
setDefaultExecutorType
public void setDefaultExecutorType(ExecutorType defaultExecutorType)
 
- 
isCacheEnabled
public boolean isCacheEnabled()
 
- 
setCacheEnabled
public void setCacheEnabled(boolean cacheEnabled)
 
- 
getDefaultStatementTimeout
public Integer getDefaultStatementTimeout()
 
- 
setDefaultStatementTimeout
public void setDefaultStatementTimeout(Integer defaultStatementTimeout)
 
- 
getDefaultFetchSize
public Integer getDefaultFetchSize()
Gets the default fetch size.- Returns:
 - the default fetch size
 - Since:
 - 3.3.0
 
 
- 
setDefaultFetchSize
public void setDefaultFetchSize(Integer defaultFetchSize)
Sets the default fetch size.- Parameters:
 defaultFetchSize- the new default fetch size- Since:
 - 3.3.0
 
 
- 
getDefaultResultSetType
public ResultSetType getDefaultResultSetType()
Gets the default result set type.- Returns:
 - the default result set type
 - Since:
 - 3.5.2
 
 
- 
setDefaultResultSetType
public void setDefaultResultSetType(ResultSetType defaultResultSetType)
Sets the default result set type.- Parameters:
 defaultResultSetType- the new default result set type- Since:
 - 3.5.2
 
 
- 
isUseColumnLabel
public boolean isUseColumnLabel()
 
- 
setUseColumnLabel
public void setUseColumnLabel(boolean useColumnLabel)
 
- 
getLocalCacheScope
public LocalCacheScope getLocalCacheScope()
 
- 
setLocalCacheScope
public void setLocalCacheScope(LocalCacheScope localCacheScope)
 
- 
getJdbcTypeForNull
public JdbcType getJdbcTypeForNull()
 
- 
setJdbcTypeForNull
public void setJdbcTypeForNull(JdbcType jdbcTypeForNull)
 
- 
getVariables
public Properties getVariables()
 
- 
setVariables
public void setVariables(Properties variables)
 
- 
getTypeHandlerRegistry
public TypeHandlerRegistry getTypeHandlerRegistry()
 
- 
setDefaultEnumTypeHandler
public void setDefaultEnumTypeHandler(Class<? extends TypeHandler> typeHandler)
- Parameters:
 typeHandler- a type handler class forEnum- Since:
 - 3.4.5
 
 
- 
getTypeAliasRegistry
public TypeAliasRegistry getTypeAliasRegistry()
 
- 
getMapperRegistry
public MapperRegistry getMapperRegistry()
Gets the mapper registry.- Returns:
 - the mapper registry
 - Since:
 - 3.2.2
 
 
- 
getReflectorFactory
public ReflectorFactory getReflectorFactory()
 
- 
setReflectorFactory
public void setReflectorFactory(ReflectorFactory reflectorFactory)
 
- 
getObjectFactory
public ObjectFactory getObjectFactory()
 
- 
setObjectFactory
public void setObjectFactory(ObjectFactory objectFactory)
 
- 
getObjectWrapperFactory
public ObjectWrapperFactory getObjectWrapperFactory()
 
- 
setObjectWrapperFactory
public void setObjectWrapperFactory(ObjectWrapperFactory objectWrapperFactory)
 
- 
getInterceptors
public List<Interceptor> getInterceptors()
Gets the interceptors.- Returns:
 - the interceptors
 - Since:
 - 3.2.2
 
 
- 
getLanguageRegistry
public LanguageDriverRegistry getLanguageRegistry()
 
- 
setDefaultScriptingLanguage
public void setDefaultScriptingLanguage(Class<? extends LanguageDriver> driver)
 
- 
getDefaultScriptingLanguageInstance
public LanguageDriver getDefaultScriptingLanguageInstance()
 
- 
getLanguageDriver
public LanguageDriver getLanguageDriver(Class<? extends LanguageDriver> langClass)
Gets the language driver.- Parameters:
 langClass- the lang class- Returns:
 - the language driver
 - Since:
 - 3.5.1
 
 
- 
getDefaultScriptingLanuageInstance
@Deprecated public LanguageDriver getDefaultScriptingLanuageInstance()
Deprecated.Gets the default scripting language instance.- Returns:
 - the default scripting language instance
 
 
- 
newMetaObject
public MetaObject newMetaObject(Object object)
 
- 
newParameterHandler
public ParameterHandler newParameterHandler(MappedStatement mappedStatement, Object parameterObject, BoundSql boundSql)
 
- 
newResultSetHandler
public ResultSetHandler newResultSetHandler(Executor executor, MappedStatement mappedStatement, RowBounds rowBounds, ParameterHandler parameterHandler, ResultHandler resultHandler, BoundSql boundSql)
 
- 
newStatementHandler
public StatementHandler newStatementHandler(Executor executor, MappedStatement mappedStatement, Object parameterObject, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql)
 
- 
newExecutor
public Executor newExecutor(Transaction transaction)
 
- 
newExecutor
public Executor newExecutor(Transaction transaction, ExecutorType executorType)
 
- 
addKeyGenerator
public void addKeyGenerator(String id, KeyGenerator keyGenerator)
 
- 
getKeyGeneratorNames
public Collection<String> getKeyGeneratorNames()
 
- 
getKeyGenerators
public Collection<KeyGenerator> getKeyGenerators()
 
- 
getKeyGenerator
public KeyGenerator getKeyGenerator(String id)
 
- 
hasKeyGenerator
public boolean hasKeyGenerator(String id)
 
- 
addCache
public void addCache(Cache cache)
 
- 
getCacheNames
public Collection<String> getCacheNames()
 
- 
getCaches
public Collection<Cache> getCaches()
 
- 
hasCache
public boolean hasCache(String id)
 
- 
addResultMap
public void addResultMap(ResultMap rm)
 
- 
getResultMapNames
public Collection<String> getResultMapNames()
 
- 
getResultMaps
public Collection<ResultMap> getResultMaps()
 
- 
hasResultMap
public boolean hasResultMap(String id)
 
- 
addParameterMap
public void addParameterMap(ParameterMap pm)
 
- 
getParameterMapNames
public Collection<String> getParameterMapNames()
 
- 
getParameterMaps
public Collection<ParameterMap> getParameterMaps()
 
- 
getParameterMap
public ParameterMap getParameterMap(String id)
 
- 
hasParameterMap
public boolean hasParameterMap(String id)
 
- 
addMappedStatement
public void addMappedStatement(MappedStatement ms)
 
- 
getMappedStatementNames
public Collection<String> getMappedStatementNames()
 
- 
getMappedStatements
public Collection<MappedStatement> getMappedStatements()
 
- 
getIncompleteStatements
public Collection<XMLStatementBuilder> getIncompleteStatements()
 
- 
addIncompleteStatement
public void addIncompleteStatement(XMLStatementBuilder incompleteStatement)
 
- 
getIncompleteCacheRefs
public Collection<CacheRefResolver> getIncompleteCacheRefs()
 
- 
addIncompleteCacheRef
public void addIncompleteCacheRef(CacheRefResolver incompleteCacheRef)
 
- 
getIncompleteResultMaps
public Collection<ResultMapResolver> getIncompleteResultMaps()
 
- 
addIncompleteResultMap
public void addIncompleteResultMap(ResultMapResolver resultMapResolver)
 
- 
addIncompleteMethod
public void addIncompleteMethod(MethodResolver builder)
 
- 
getIncompleteMethods
public Collection<MethodResolver> getIncompleteMethods()
 
- 
getMappedStatement
public MappedStatement getMappedStatement(String id)
 
- 
getMappedStatement
public MappedStatement getMappedStatement(String id, boolean validateIncompleteStatements)
 
- 
addInterceptor
public void addInterceptor(Interceptor interceptor)
 
- 
addMappers
public void addMappers(String packageName)
 
- 
addMapper
public <T> void addMapper(Class<T> type)
 
- 
getMapper
public <T> T getMapper(Class<T> type, SqlSession sqlSession)
 
- 
hasMapper
public boolean hasMapper(Class<?> type)
 
- 
hasStatement
public boolean hasStatement(String statementName)
 
- 
hasStatement
public boolean hasStatement(String statementName, boolean validateIncompleteStatements)
 
- 
buildAllStatements
protected void buildAllStatements()
 
- 
extractNamespace
protected String extractNamespace(String statementId)
Extracts namespace from fully qualified statement id.- Parameters:
 statementId- the statement id- Returns:
 - namespace or null when id does not contain period.
 
 
- 
checkGloballyForDiscriminatedNestedResultMaps
protected void checkGloballyForDiscriminatedNestedResultMaps(ResultMap rm)
 
- 
checkLocallyForDiscriminatedNestedResultMaps
protected void checkLocallyForDiscriminatedNestedResultMaps(ResultMap rm)
 
 - 
 
 -