架构源码解析
1、架构讲解
Mybatis的功能架构分为三层:
API接口层:提供给外部使用的接口API,开发人员通过这些本地API来操纵数据库。接口层一接收到调用请求就会调用数据处理层来完成具体的数据处理。
数据处理层:负责具体的SQL查找、SQL解析、SQL执行和执行结果映射处理等。它主要的目的是根据调用的请求完成一次数据库操作。
基础支撑层:负责最基础的功能支撑,包括连接管理、事务管理、配置加载和缓存处理,这些都是共用的东西,将他们抽取出来作为最基础的组件。为上层的数据处理层提供最基础的支撑。
2、核心成员:
- Configuration:MyBatis所有的配置信息都保存在Configuration对象之中,配置文件中的大部分配置都会存储到该类中
- SqlSession:作为MyBatis工作的主要顶层API,表示和数据库交互时的会话,完成必要数据库增删改查功能
- Executor:MyBatis执行器,是MyBatis 调度的核心,负责SQL语句的生成和查询缓存的维护
- StatementHandler:封装了JDBC Statement操作,负责对JDBC statement 的操作,如设置参数等
- ParameterHandler:负责对用户传递的参数转换成JDBC Statement 所对应的数据类型
- ResultSetHandler:负责将JDBC返回的ResultSet结果集对象转换成List类型的集合
- TypeHandler:负责java数据类型和jdbc数据类型(也可以说是数据表列类型)之间的映射和转换
- MappedStatement:MappedStatement维护一条<select|update|delete|insert>节点的封装
- SqlSource:负责根据用户传递的parameterObject,动态地生成SQL语句,将信息封装到BoundSql对象中,并返回
- BoundSql:表示动态生成的SQL语句以及相应的参数信息
3、源码解读
(1)构建session工厂
java
// 1、创建一个SqlSessionFactory的 建造者 ,用于创建SqlSessionFactory
// SqlSessionFactoryBuilder中有大量的重载的build方法,可以根据不同的入参,进行构建
// 极大的提高了灵活性,此处使用【创建者设计模式】
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
这是一个创建者设计模式的经典应用:
less
// 使用builder构建一个sqlSessionFactory,此处我们基于一个xml配置文件
// 此过程会进行xml文件的解析,过程相对比较复杂
SqlSessionFactory sqlSessionFactory = builder.build(Thread.currentThread().getContextClassLoader().getResourceAsStream("mybatis-config.xml"));
源码部分:这里有众多的重载build方法,我们调用的build方法,会是如下大流程
typescript
public SqlSessionFactory build(InputStream inputStream) {
return build(inputStream, null, null);
}
typescript
public SqlSessionFactory build(InputStream inputStream, String environment, Properties properties) {
try {
XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
return build(parser.parse());
} catch (Exception e) {
....
}
从上边的return看,其实核心的代码又回归到了build(parser.parse())
这个构造器。
arduino
public SqlSessionFactory build(Configuration config) {
return new DefaultSqlSessionFactory(config);
}
其实,本质上,无论你做了多少工作,你使用xml也好,不使用xml也好,最终都是需要一个Configuration实例,这里保存了所有的配置项。
当然我们可以独立去使用Configuration类构造实例,不使用xml。
例如:
ini
Configuration configuration = new Configuration();
// 创建一个数据源
PooledDataSource pooledDataSource = new PooledDataSource();
pooledDataSource.setDriver("com.mysql.cj.jdbc.Driver");
pooledDataSource.setUrl("jdbc:mysql://127.0.0.1:3306/ydlclass?characterEncoding=utf8&serverTimezone=Asia/Shanghai");
pooledDataSource.setUsername("root");
pooledDataSource.setPassword("root");
Environment environment = new Environment("env",new JdbcTransactionFactory(),new PooledDataSource());
configuration.setEnvironment(environment);
等同于:
ini
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://127.0.0.1:3306/ydlclass?characterEncoding=utf8&serverTimezone=Asia/Shanghai"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
</configuration>
xml的解析过程就是将xml文件转化为Configuration对象,它在启动的时候执行,也就意味着修改配置文件就要重启。所以本环节的重点就到了。
(2)配置文件的解析
parser.parse()
这个方法了,这就是在解析xml配置文件。
在build方法中我们看到了如下代码:
ini
XMLConfigBuilder parser = new XMLConfigBuilder(inputStream, environment, properties);
这一步就是构造一个解析器,根据我们的入参构建一个文档解析器。使用了sax进行xml的解析,我们在讲JavaEE的时候讲过。
当然,我们要把重点放在parse()方法上:
csharp
public Configuration parse() {
...省略不重要的代码
//此处就是解析的核心代码
parseConfiguration(parser.evalNode("/configuration"));
return configuration;
}
咱们进入这个方法,慢慢分析,其中的内容很多,很明显看到这个方法就是在解析每一个标签。
scss
private void parseConfiguration(XNode root) {
try {
// 处理properties标签
propertiesElement(root.evalNode("properties"));
Properties settings = settingsAsProperties(root.evalNode("settings"));
loadCustomVfs(settings);
loadCustomLogImpl(settings);
// 处理别名的标签
typeAliasesElement(root.evalNode("typeAliases"));
pluginElement(root.evalNode("plugins"));
objectFactoryElement(root.evalNode("objectFactory"));
objectWrapperFactoryElement(root.evalNode("objectWrapperFactory"));
reflectorFactoryElement(root.evalNode("reflectorFactory"));
settingsElement(settings);
// read it after objectFactory and objectWrapperFactory issue #631
// 处理environments标签
environmentsElement(root.evalNode("environments"));
databaseIdProviderElement(root.evalNode("databaseIdProvider"));
typeHandlerElement(root.evalNode("typeHandlers"));
// 处理mappers标签
mapperElement(root.evalNode("mappers"));
} catch (Exception e) {
throw new BuilderException("Error parsing SQL Mapper Configuration. Cause: " + e, e);
}
}
其实我们看到这里就大致明白了MyBatis解析xml的时机和方法了。从这里我们也能基本看出来一个配置文件内能使用的标签,以及书写标签的顺序,因为这个解析过程也是有顺序的,我们随便列出几个标签看看配置文件长什么样子:
xml
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<properties>
<property name="username" value="root"/>
</properties>
<settings>
<setting name="" value=""/>
</settings>
<typeAliases>
<typeAlias type="com.ydlclass.User" alias="user"/>
</typeAliases>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://127.0.0.1:3306/ydlclass?characterEncoding=utf8&serverTimezone=Asia/Shanghai"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="userMapper.xml"/>
</mappers>
</configuration>
(3)mapper文件的解析过程
我们暂且忽略掉其他标签的处理,以mappers
标签为例继续深入探索:
ini
private void mapperElement(XNode parent) throws Exception {
if (parent != null) {
// 循环遍历他的孩子节点
for (XNode child : parent.getChildren()) {
if ("package".equals(child.getName())) {
// <package name="com.ydlclass"/>
String mapperPackage = child.getStringAttribute("name");
// 直接将包名加入配置项
configuration.addMappers(mapperPackage);
} else {
String resource = child.getStringAttribute("resource");
String url = child.getStringAttribute("url");
String mapperClass = child.getStringAttribute("class");
// 如果是resource属性,就通过resource获取资源并解析<mapper resource="userMapper.xml"/>
if (resource != null && url == null && mapperClass == null) {
ErrorContext.instance().resource(resource);
InputStream inputStream = Resources.getResourceAsStream(resource);
XMLMapperBuilder mapperParser = new XMLMapperBuilder(inputStream, configuration, resource, configuration.getSqlFragments());
mapperParser.parse();
// 如果是url属性,就通过url获取资源并解析 <mapper url="http://www.ydlclass.com/UserMapper.xml"/>
} else if (resource == null && url != null && mapperClass == null) {
ErrorContext.instance().resource(url);
InputStream inputStream = Resources.getUrlAsStream(url);
XMLMapperBuilder mapperParser = new XMLMapperBuilder(inputStream, configuration, url, configuration.getSqlFragments());
mapperParser.parse();
// 如果是url属性,就通过url获取资源并解析 <mapper class="com.ydlclass.UserMapper"/>
} else if (resource == null && url == null && mapperClass != null) {
Class<?> mapperInterface = Resources.classForName(mapperClass);
// 注册一个mapper
configuration.addMapper(mapperInterface);
} else {
throw new BuilderException("A mapper element may only specify a url, resource or class, but not more than one.");
}
}
}
}
}
这里就是想尽办法,获取mapper的配置信息,然后做下一步处理,其实无论是哪一种方式都是会在Configuration的mapperRegistry (mapper注册器中)中注册一个mapper。其实就是将mapper的class信息放在一个名为knownMappers的hashmap中,以便后续使用。当然他的值一个一个代理工厂,这玩意能帮我们获取一个mapper的代理对象,更详细的后续说。
swift
private final Map<Class<?>, MapperProxyFactory<?>> knownMappers = new HashMap<>();
对于package属性
直接将包名注册到配置中,然后调用MapperRegistry的addMappers方法,通过扫描文件的方式将这个包底下的class添加进kownMappers中。
typescript
public void addMappers(String packageName) {
mapperRegistry.addMappers(packageName);
}
typescript
public void addMappers(String packageName) {
addMappers(packageName, Object.class);
}
vbnet
public void addMappers(String packageName, Class<?> superType) {
ResolverUtil<Class<?>> resolverUtil = new ResolverUtil<>();
resolverUtil.find(new ResolverUtil.IsA(superType), packageName);
Set<Class<? extends Class<?>>> mapperSet = resolverUtil.getClasses();
for (Class<?> mapperClass : mapperSet) {
addMapper(mapperClass);
}
}
typescript
public <T> void addMapper(Class<T> type) {
mapperRegistry.addMapper(type);
}
我们可以从MapperRegistry中看到,addMapper的整个过程。
typescript
public <T> void addMapper(Class<T> type) {
if (type.isInterface()) {
if (hasMapper(type)) {
throw new BindingException("Type " + type + " is already known to the MapperRegistry.");
}
boolean loadCompleted = false;
try {
knownMappers.put(type, new MapperProxyFactory<>(type));
...省略不重要的代码
}
}
我们不妨把MapperProxyFactory的代码粘贴出来看看,里边维护了一个接口和方法缓存(这个后边会讲,目前他是一个空的Map),这个代理工厂确实有方法帮我们生成代理对象(newInstance)。我们看到了代理设计模式。
typescript
public class MapperProxyFactory<T> {
private final Class<T> mapperInterface;
private final Map<Method, MapperMethodInvoker> methodCache = new ConcurrentHashMap<>();
public MapperProxyFactory(Class<T> mapperInterface) {
this.mapperInterface = mapperInterface;
}
public Class<T> getMapperInterface() {
return mapperInterface;
}
public Map<Method, MapperMethodInvoker> getMethodCache() {
return methodCache;
}
@SuppressWarnings("unchecked")
protected T newInstance(MapperProxy<T> mapperProxy) {
return (T) Proxy.newProxyInstance(mapperInterface.getClassLoader(), new Class[] { mapperInterface }, mapperProxy);
}
public T newInstance(SqlSession sqlSession) {
final MapperProxy<T> mapperProxy = new MapperProxy<>(sqlSession, mapperInterface, methodCache);
return newInstance(mapperProxy);
}
}
对与class属性的处理
这个属性我们配置的是一个class,<mapper class="com.ydlclass.UserMapper"/>
,对一class将来肯定要从注解中解析信息,直接把他的class信息注册进去就好了。
resource属性以及url属性的处理
在resource属性以及url属性中没有看到configuration.addMapper()这个方法的影子,这两个属性都是以配置文件的方式加载,自然要解析mapper配置文件了。
我们看到了XMLMapperBuilder
这个类的parse()方法。很明显这个方法configurationElement是用来解析配置文件的。
scss
public void parse() {
if (!configuration.isResourceLoaded(resource)) {
configurationElement(parser.evalNode("/mapper"));
configuration.addLoadedResource(resource);
bindMapperForNamespace();
}
parsePendingResultMaps();
parsePendingCacheRefs();
parsePendingStatements();
}
而在这个方法中bindMapperForNamespace我们看到了注册mapper的代码:
csharp
private void bindMapperForNamespace() {
...其他代码省略
configuration.addLoadedResource("namespace:" + namespace);
configuration.addMapper(boundType);
}
}
}
mapper的具体解析
创建一个解析器:
ini
XMLMapperBuilder mapperParser = new XMLMapperBuilder(inputStream, configuration, resource, configuration.getSqlFragments());
这个方法就是对每一个标签的解析:
csharp
private void configurationElement(XNode context) {
try {
String namespace = context.getStringAttribute("namespace");
if (namespace == null || namespace.isEmpty()) {
throw new BuilderException("Mapper's namespace cannot be empty");
}
builderAssistant.setCurrentNamespace(namespace);
cacheRefElement(context.evalNode("cache-ref"));
cacheElement(context.evalNode("cache"));
parameterMapElement(context.evalNodes("/mapper/parameterMap"));
resultMapElements(context.evalNodes("/mapper/resultMap"));
sqlElement(context.evalNodes("/mapper/sql"));
buildStatementFromContext(context.evalNodes("select|insert|update|delete"));
} catch (Exception e) {
throw new BuilderException("Error parsing Mapper XML. The XML location is '" + resource + "'. Cause: " + e, e);
}
}
(4)通过sqlSession获取一个代理对象
ini
通过sqlSessionFactory获取另一个session,此处使用【工厂设计模式】
SqlSession sqlSession = sqlSessionFactory.openSession();
接下来就要研究mapper的代理对象生成的过程了,此处使用【代理设计模式】
ini
// 4、通过sqlSession获取一个代理对象,此处使用【代理设计模式】
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
我们可以走到DefaultSqlSession,这是SqlSession的一个子类,从open方法中我们能看到默认创建的sqlSession是他的子类DefaultSqlSession
typescript
private SqlSession openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) {
...省略不重要的代码
return new DefaultSqlSession(configuration, executor, autoCommit);
}
从实现类的getMapper中得知:
typescript
public <T> T getMapper(Class<T> type) {
return configuration.getMapper(type, this);
}
typescript
public <T> T getMapper(Class<T> type, SqlSession sqlSession) {
return mapperRegistry.getMapper(type, sqlSession);
}
从注册器中获取mapper工厂,并创建代理对象:
typescript
public <T> T getMapper(Class<T> type, SqlSession sqlSession) {
final MapperProxyFactory<T> mapperProxyFactory = (MapperProxyFactory<T>) knownMappers.get(type);
if (mapperProxyFactory == null) {
throw new BindingException("Type " + type + " is not known to the MapperRegistry.");
}
try {
// 创建代理对象:
return mapperProxyFactory.newInstance(sqlSession);
} catch (Exception e) {
throw new BindingException("Error getting mapper instance. Cause: " + e, e);
}
}
那我们可以聊一聊MapperProxyFactory这个类了,它持有一个接口和一个methodCache,这个接口当然是为了生成代理对象使用的类。
swift
public class MapperProxyFactory<T> {
private final Class<T> mapperInterface;
private final Map<Method, MapperMethodInvoker> methodCache = new ConcurrentHashMap<>();
}
在创建对象的时候创建了一个MapperProxy:
arduino
public T newInstance(SqlSession sqlSession) {
final MapperProxy<T> mapperProxy = new MapperProxy<>(sqlSession, mapperInterface, methodCache);
return newInstance(mapperProxy);
}
MapperProxy就是我们的InvocationHandler,也是创建代理对象必须的,其中的核心方法是invoke,会在调用代理对象的方法时调用:
java
public class MapperProxy<T> implements InvocationHandler, Serializable {
private static final long serialVersionUID = -4724728412955527868L;
private static final int ALLOWED_MODES = MethodHandles.Lookup.PRIVATE | MethodHandles.Lookup.PROTECTED
| MethodHandles.Lookup.PACKAGE | MethodHandles.Lookup.PUBLIC;
private static final Constructor<Lookup> lookupConstructor;
private static final Method privateLookupInMethod;
private final SqlSession sqlSession;
private final Class<T> mapperInterface;
private final Map<Method, MapperMethodInvoker> methodCache;
public MapperProxy(SqlSession sqlSession, Class<T> mapperInterface, Map<Method, MapperMethodInvoker> methodCache) {
this.sqlSession = sqlSession;
this.mapperInterface = mapperInterface;
this.methodCache = methodCache;
}
@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
try {
if (Object.class.equals(method.getDeclaringClass())) {
return method.invoke(this, args);
} else {
return cachedInvoker(method).invoke(proxy, method, args, sqlSession);
}
} catch (Throwable t) {
throw ExceptionUtil.unwrapThrowable(t);
}
}
核心方法当然是invoke了,将来调用代理对象的方法,其实就是在执行此方法。
(5)方法调用
当我们执行代理的对象的方法时:
ini
List<User> allUser = mapper.findAllUser(12);
invoke方法会被调用,这里会判断它调用的是继承自Object的方法还是实现的接口的方法,我们的重点放在:
scss
cachedInvoker(method).invoke(proxy, method, args, sqlSession);
java
private MapperMethodInvoker cachedInvoker(Method method) throws Throwable {
try {
// 这里就知道了methodCache的左右了,方法存在缓存里避免频繁的创建
MapperMethodInvoker invoker = methodCache.get(method);
if (invoker != null) {
return invoker;
}
// 缓存没有就创建一个
return methodCache.computeIfAbsent(method, m -> {
// 这里是处理接口的默认方法
if (m.isDefault()) {
try {
if (privateLookupInMethod == null) {
return new DefaultMethodInvoker(getMethodHandleJava8(method));
} else {
return new DefaultMethodInvoker(getMethodHandleJava9(method));
}
} catch (IllegalAccessException | InstantiationException | InvocationTargetException
| NoSuchMethodException e) {
throw new RuntimeException(e);
}
// 核心代码在这里
} else {
return new PlainMethodInvoker(new MapperMethod(mapperInterface, method, sqlSession.getConfiguration()));
}
});
} catch (RuntimeException re) {
Throwable cause = re.getCause();
throw cause == null ? re : cause;
}
}
核心是(普通的方法调用者):
sql
new PlainMethodInvoker(new MapperMethod(mapperInterface, method, sqlSession.getConfiguration()));
在PlainMethodInvoker传入了一个MapperMethod(方法的包装类),根据接口、方法签名和我们的配置生成一个方法的包装,这里有SqlCommand(用来执行sql),还有我们的方法签名。
arduino
public class MapperMethod {
private final SqlCommand command;
private final MethodSignature method;
public MapperMethod(Class<?> mapperInterface, Method method, Configuration config) {
this.command = new SqlCommand(config, mapperInterface, method);
this.method = new MethodSignature(config, mapperInterface, method);
}
}
它还有个核心方法,就是执行具体的sql啦!
ini
public Object execute(SqlSession sqlSession, Object[] args) {
Object result;
switch (command.getType()) {
case INSERT: {
Object param = method.convertArgsToSqlCommandParam(args);
result = rowCountResult(sqlSession.insert(command.getName(), param));
break;
}
case UPDATE: {
Object param = method.convertArgsToSqlCommandParam(args);
result = rowCountResult(sqlSession.update(command.getName(), param));
break;
}
case DELETE: {
Object param = method.convertArgsToSqlCommandParam(args);
result = rowCountResult(sqlSession.delete(command.getName(), param));
break;
}
case SELECT:
if (method.returnsVoid() && method.hasResultHandler()) {
executeWithResultHandler(sqlSession, args);
result = null;
} else if (method.returnsMany()) {
result = executeForMany(sqlSession, args);
// 一下部分省略
return result;
}
回头看:
scss
cachedInvoker(method).invoke(proxy, method, args, sqlSession);
本质调用的就是PlainMethodInvoker这个子类的invoke方法,而它确实调用mapperMethod.execute方法。到此就明白了整个流程
java
private static class PlainMethodInvoker implements MapperMethodInvoker {
private final MapperMethod mapperMethod;
public PlainMethodInvoker(MapperMethod mapperMethod) {
super();
this.mapperMethod = mapperMethod;
}
@Override
public Object invoke(Object proxy, Method method, Object[] args, SqlSession sqlSession) throws Throwable {
return mapperMethod.execute(sqlSession, args);
}
}
(6)继续了解
一级缓存
我们不妨在excute方法中随机找一个select语句深入挖掘:
scss
result = executeForMany(sqlSession, args);executeForMany(sqlSession, args);
看方法:
ini
private <E> Object executeForMany(SqlSession sqlSession, Object[] args) {
List<E> result;
...省略其他代码
result = sqlSession.selectList(command.getName(), param);
return result;
}
这里就能看到本质上使用的是sqlSession.selectList(command.getName(), param);
这距离我们熟悉的越来越近了:
typescript
@Override
public <E> List<E> selectList(String statement, Object parameter, RowBounds rowBounds) {
try {
// MappedStatement,使用执行器执行sql
MappedStatement ms = configuration.getMappedStatement(statement);
return executor.query(ms, wrapCollection(parameter), rowBounds, Executor.NO_RESULT_HANDLER);
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error querying database. Cause: " + e, e);
} finally {
ErrorContext.instance().reset();
}
}
MappedStatement其实就是我们mapper.xml的解析结果,放了很多的信息:
vbnet
public final class MappedStatement {
private String resource;
private Configuration configuration;
private String id;
private Integer fetchSize;
private Integer timeout;
private StatementType statementType;
private ResultSetType resultSetType;
private SqlSource sqlSource;
private Cache cache;
private ParameterMap parameterMap;
private List<ResultMap> resultMaps;
private boolean flushCacheRequired;
private boolean useCache;
private boolean resultOrdered;
private SqlCommandType sqlCommandType;
...省略
executor是真正执行sql的一个执行器,它是一个接口,有具体的实现比如抽象类BaseExecutor,实现SimpleExecutor:
java
public interface Executor {
int update(MappedStatement ms, Object parameter) throws SQLException;
<E> List<E> query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey cacheKey, BoundSql boundSql) throws SQLException;
<E> List<E> query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler) throws SQLException;
<E> Cursor<E> queryCursor(MappedStatement ms, Object parameter, RowBounds rowBounds) throws SQLException;
List<BatchResult> flushStatements() throws SQLException;
void commit(boolean required) throws SQLException;
void rollback(boolean required) throws SQLException;
...省略
}
我们继续看 executor.query,在抽象类BaseExecutor它是这么实现的:
java
public abstract class BaseExecutor implements Executor
java
@Override
public <E> List<E> query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler) throws SQLException {
BoundSql boundSql = ms.getBoundSql(parameter);
// 请注意这里创建了key
CacheKey key = createCacheKey(ms, parameter, rowBounds, boundSql);
return query(ms, parameter, rowBounds, resultHandler, key, boundSql);
}
这里有一个核心方法queryFromDatabase
scss
@Override
public <E> List<E> query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey key, BoundSql boundSql) throws SQLException {
ErrorContext.instance().resource(ms.getResource()).activity("executing a query").object(ms.getId());
if (closed) {
throw new ExecutorException("Executor was closed.");
}
if (queryStack == 0 && ms.isFlushCacheRequired()) {
clearLocalCache();
}
List<E> list;
try {
queryStack++;
// 这里有【一级缓存】的影子,优先去缓存中取
list = resultHandler == null ? (List<E>) localCache.getObject(key) : null;
if (list != null) {
handleLocallyCachedOutputParameters(ms, key, parameter, boundSql);
} else {
list = queryFromDatabase(ms, parameter, rowBounds, resultHandler, key, boundSql);
}
} finally {
queryStack--;
}
if (queryStack == 0) {
for (DeferredLoad deferredLoad : deferredLoads) {
deferredLoad.load();
}
// issue #601
deferredLoads.clear();
if (configuration.getLocalCacheScope() == LocalCacheScope.STATEMENT) {
// issue #482
clearLocalCache();
}
}
return list;
}
从这里我们能看到【以及缓存的影子了】localCache,通过doQuery查询的结果,会放在localCache中。
scss
private <E> List<E> queryFromDatabase(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey key, BoundSql boundSql) throws SQLException {
List<E> list;
localCache.putObject(key, EXECUTION_PLACEHOLDER);
try {
// 核心方法
list = doQuery(ms, parameter, rowBounds, resultHandler, boundSql);
} finally {
localCache.removeObject(key);
}
localCache.putObject(key, list);
if (ms.getStatementType() == StatementType.CALLABLE) {
localOutputParameterCache.putObject(key, parameter);
}
return list;
}
原生的jdbc
我们继续看实现:
scala
public class SimpleExecutor extends BaseExecutor
我们进入上边提及的doQuery,这里看到一下原生jdbc的影子了,比如stmt;
ini
@Override
public <E> List<E> doQuery(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, BoundSql boundSql) throws SQLException {
Statement stmt = null;
try {
Configuration configuration = ms.getConfiguration();
StatementHandler handler = configuration.newStatementHandler(wrapper, ms, parameter, rowBounds, resultHandler, boundSql);
// 获取prepareStatement
stmt = prepareStatement(handler, ms.getStatementLog());
return handler.query(stmt, resultHandler);
} finally {
closeStatement(stmt);
}
}
这里有几个方法:
获取prepareStatement,这里看到了Connection:
ini
private Statement prepareStatement(StatementHandler handler, Log statementLog) throws SQLException {
Statement stmt;
Connection connection = getConnection(statementLog);
// 创建PreparedStatement
stmt = handler.prepare(connection, transaction.getTimeout());
// 填充占位符
handler.parameterize(stmt);
return stmt;
}
继续深入:
java
public abstract class BaseStatementHandler implements StatementHandler
scss
@Override
public Statement prepare(Connection connection, Integer transactionTimeout) throws SQLException {
ErrorContext.instance().sql(boundSql.getSql());
Statement statement = null;
try {
// 创建PreparedStatement
statement = instantiateStatement(connection);
setStatementTimeout(statement, transactionTimeout);
setFetchSize(statement);
return statement;
} catch (SQLException e) {
closeStatement(statement);
throw e;
} catch (Exception e) {
closeStatement(statement);
throw new ExecutorException("Error preparing statement. Cause: " + e, e);
}
}
继续深入,我们看到了熟悉的connection.prepareStatement(sql):
scala
public class PreparedStatementHandler extends BaseStatementHandler
java
@Override
protected Statement instantiateStatement(Connection connection) throws SQLException {
String sql = boundSql.getSql();
... 省略
} else if (mappedStatement.getResultSetType() == ResultSetType.DEFAULT) {
return connection.prepareStatement(sql);
} else {
return connection.prepareStatement(sql, mappedStatement.getResultSetType().getValue(), ResultSet.CONCUR_READ_ONLY);
}
}
这里就是对占位符进行替换
java
@Override
public void parameterize(Statement statement) throws SQLException {
parameterHandler.setParameters((PreparedStatement) statement);
}
ini
@Override
public void setParameters(PreparedStatement ps) {
ErrorContext.instance().activity("setting parameters").object(mappedStatement.getParameterMap().getId());
List<ParameterMapping> parameterMappings = boundSql.getParameterMappings();
if (parameterMappings != null) {
for (int i = 0; i < parameterMappings.size(); i++) {
ParameterMapping parameterMapping = parameterMappings.get(i);
if (parameterMapping.getMode() != ParameterMode.OUT) {
Object value;
String propertyName = parameterMapping.getProperty();
if (boundSql.hasAdditionalParameter(propertyName)) { // issue #448 ask first for additional params
value = boundSql.getAdditionalParameter(propertyName);
} else if (parameterObject == null) {
value = null;
} else if (typeHandlerRegistry.hasTypeHandler(parameterObject.getClass())) {
value = parameterObject;
} else {
MetaObject metaObject = configuration.newMetaObject(parameterObject);
value = metaObject.getValue(propertyName);
}
TypeHandler typeHandler = parameterMapping.getTypeHandler();
JdbcType jdbcType = parameterMapping.getJdbcType();
if (value == null && jdbcType == null) {
jdbcType = configuration.getJdbcTypeForNull();
}
try {
typeHandler.setParameter(ps, i + 1, value, jdbcType);
} catch (TypeException | SQLException e) {
throw new TypeException("Could not set parameters for mapping: " + parameterMapping + ". Cause: " + e, e);
}
}
}
}
}
当前位置我们已经从头对MyBatis的源码撸了一遍,有帮助三连。
4、别名系统
思考:
csharp
<select id="getUsersByParams" parameterType="java.util.HashMap">
select id,username,password from user where username = #{name}
</select>
resultType写成java.util.HashMap也行,写成map也行,说明MyBatis内置很多别名,包括我们的配置中:
ini
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
其中为什么写一个POOLED就能代表我们使用了什么数据库连接池,其实这也是别名,简单理解就是可以用一个简单的短小的名字替代很长的类的权限定名称。
其实:在构造Configuration类时,注册了如下的别名。
csharp
public Configuration() {
typeAliasRegistry.registerAlias("JDBC", JdbcTransactionFactory.class);
typeAliasRegistry.registerAlias("MANAGED", ManagedTransactionFactory.class);
typeAliasRegistry.registerAlias("JNDI", JndiDataSourceFactory.class);
typeAliasRegistry.registerAlias("POOLED", PooledDataSourceFactory.class);
typeAliasRegistry.registerAlias("UNPOOLED", UnpooledDataSourceFactory.class);
typeAliasRegistry.registerAlias("PERPETUAL", PerpetualCache.class);
typeAliasRegistry.registerAlias("FIFO", FifoCache.class);
typeAliasRegistry.registerAlias("LRU", LruCache.class);
typeAliasRegistry.registerAlias("SOFT", SoftCache.class);
typeAliasRegistry.registerAlias("WEAK", WeakCache.class);
typeAliasRegistry.registerAlias("DB_VENDOR", VendorDatabaseIdProvider.class);
typeAliasRegistry.registerAlias("XML", XMLLanguageDriver.class);
typeAliasRegistry.registerAlias("RAW", RawLanguageDriver.class);
typeAliasRegistry.registerAlias("SLF4J", Slf4jImpl.class);
typeAliasRegistry.registerAlias("COMMONS_LOGGING", JakartaCommonsLoggingImpl.class);
typeAliasRegistry.registerAlias("LOG4J", Log4jImpl.class);
typeAliasRegistry.registerAlias("LOG4J2", Log4j2Impl.class);
typeAliasRegistry.registerAlias("JDK_LOGGING", Jdk14LoggingImpl.class);
typeAliasRegistry.registerAlias("STDOUT_LOGGING", StdOutImpl.class);
typeAliasRegistry.registerAlias("NO_LOGGING", NoLoggingImpl.class);
typeAliasRegistry.registerAlias("CGLIB", CglibProxyFactory.class);
typeAliasRegistry.registerAlias("JAVASSIST", JavassistProxyFactory.class);
languageRegistry.setDefaultDriverClass(XMLLanguageDriver.class);
languageRegistry.register(RawLanguageDriver.class);
}
在构造TypeAliasRegistry注册了如下的别名,我们可以在配置文件中使用以下的别名来代替这些类的权限定名。
scss
public class TypeAliasRegistry {
private final Map<String, Class<?>> typeAliases = new HashMap<>();
public TypeAliasRegistry() {
registerAlias("string", String.class);
registerAlias("byte", Byte.class);
registerAlias("long", Long.class);
registerAlias("short", Short.class);
registerAlias("int", Integer.class);
registerAlias("integer", Integer.class);
registerAlias("double", Double.class);
registerAlias("float", Float.class);
registerAlias("boolean", Boolean.class);
registerAlias("byte[]", Byte[].class);
registerAlias("long[]", Long[].class);
registerAlias("short[]", Short[].class);
registerAlias("int[]", Integer[].class);
registerAlias("integer[]", Integer[].class);
registerAlias("double[]", Double[].class);
registerAlias("float[]", Float[].class);
registerAlias("boolean[]", Boolean[].class);
registerAlias("_byte", byte.class);
registerAlias("_long", long.class);
registerAlias("_short", short.class);
registerAlias("_int", int.class);
registerAlias("_integer", int.class);
registerAlias("_double", double.class);
registerAlias("_float", float.class);
registerAlias("_boolean", boolean.class);
registerAlias("_byte[]", byte[].class);
registerAlias("_long[]", long[].class);
registerAlias("_short[]", short[].class);
registerAlias("_int[]", int[].class);
registerAlias("_integer[]", int[].class);
registerAlias("_double[]", double[].class);
registerAlias("_float[]", float[].class);
registerAlias("_boolean[]", boolean[].class);
registerAlias("date", Date.class);
registerAlias("decimal", BigDecimal.class);
registerAlias("bigdecimal", BigDecimal.class);
registerAlias("biginteger", BigInteger.class);
registerAlias("object", Object.class);
registerAlias("date[]", Date[].class);
registerAlias("decimal[]", BigDecimal[].class);
registerAlias("bigdecimal[]", BigDecimal[].class);
registerAlias("biginteger[]", BigInteger[].class);
registerAlias("object[]", Object[].class);
registerAlias("map", Map.class);
registerAlias("hashmap", HashMap.class);
registerAlias("list", List.class);
registerAlias("arraylist", ArrayList.class);
registerAlias("collection", Collection.class);
registerAlias("iterator", Iterator.class);
registerAlias("ResultSet", ResultSet.class);
}
当然我们可以给写的类定义别名:
给自己类设定别名
在核心配置文件中加入
bash
<typeAliases>
<typeAlias type="com.ydlclass.entity.User" alias="user"/>
</typeAliases>
<typeAlias>
标签中 有 type
和 alias
两个属性
type
填写 实体类的全类名,alias
可以不填,不填的话,默认是类名,不区分大小写,
alias
填了的话就以 alias里的值为准。
xml
<typeAiases>
<package name=""/>
</typeAliases>
<package>
标签 为某个包下的所有类起别名; name
属性填写包名。 别名默认是类名,不区分大小写。
less
@Alias` 注解 加在实体类上,为某个类起别名;例:`@Alias("User")
七、resultMap详解
如果数据库字段和实体的字段是一一对应,那么MyBatis会【自动映射】,但是如果不一致,比如一个叫user一个叫username,那么就需要我们手动的建立一一映射的关系了。
有时候我们的数据库和字段和实例的字段可能不是一一对应,
1、Java中的实体类设计
arduino
public class User {
private int id; //id
private String name; //姓名,数据库为username
private String password; //密码,一致
//构造
//set/get
//toString()
}
3、mapper
arduino
//根据id查询用户
User selectUserById(int id);
4、mapper映射文件
csharp
<select id="selectUserById" resultType="user">
select * from user where id = #{id}
</select>
5、测试
ini
@Test
public void testSelectUserById() {
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectUserById(1);
System.out.println(user);
session.close();
}
结果:
- User
- 查询出来发现 name为空 . 说明出现了问题!
分析:
-
select * from user where id = #{id} 可以看做
select id,username,password from user where id = #
-
mybatis会根据这些查询的列名(会将列名转化为小写,数据库不区分大小写) , 利用反射去对应的实体类中查找相应列名的set方法设值 ,当然找不到username
解决方案
方案一:为列名指定别名 , 别名和java实体类的属性名一致 .
csharp
<select id="selectUserById" resultType="User">
select id , username as name ,password from user where id = #{id}
</select>
方案二:使用结果集映射->ResultMap 【推荐】
xml
<resultMap id="UserMap" type="User">
<!-- id为主键 -->
<id column="id" property="id"/>
<!-- column是数据库表的列名 , property是对应实体类的属性名 -->
<result column="username" property="name"/>
<result column="password" property="password"/>
</resultMap>
<select id="selectUserById" resultMap="UserMap">
select id , username , password from user where id = #{id}
</select>
结论:
这个地方我们手动调整了映射关系,称之为【手动映射】。
但如果不调整呢? MyBatis当然会按照约定自动映射。
有了映射这种牛逼的事情之后:
我们的:
vbscript
prepareStatement.setInt(1,21);
prepareStatement.setString(2,"IT楠老师");
还用写吗?两个字【牛逼】!
当然约定的最基本的操作就是全部都一样,还有就是下划线和驼峰命名的自动转化
xml
<settings>
<!--开启驼峰命名规则-->
<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
自定义数据源
typescript
public class MyDataSource implements DataSourceFactory {
private Properties properties;
@Override
public void setProperties(Properties properties) {
this.properties = properties;
}
@Override
public DataSource getDataSource() {
HikariConfig hikariConfig = new HikariConfig(properties);
return new HikariDataSource(hikariConfig);
}
}
ini
username=root
password=root
jdbcUrl=jdbc:mysql://127.0.0.1:3306/ssm?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false
driverClassName=com.mysql.cj.jdbc.Driver
八、动态sql-很重要
1、 概述
MyBatis提供了对SQL语句动态的组装能力,大量的判断都可以在 MyBatis的映射XML文件里面配置,以达到许多我们需要大量代码才能实现的功能,大大减少了我们编写代码的工作量。
动态SQL的元素
元素 | 作用 | 备注 |
---|---|---|
if | 判断语句 | 单条件分支判断 |
choose、when、otherwise | 相当于Java中的 case when语句 | 多条件分支判断 |
trim、where、set | 辅助元素 | 用于处理一些SQL拼装问题 |
foreach | 循环语句 | 在in语句等列举条件常用 |
2、if元素(非常常用)
if元素相当于Java中的if语句,它常常与test属性联合使用。现在我们要根据name去查找学生,但是name是可选的,如下所示:
bash
<select id="findUserById" resultType="com.ydlclass.entity.User">
select id,username,password from user
where 1 =1
<if test="id != null">
AND id = #{id}
</if>
<if test="username != null and username != ''">
AND username = #{username}
</if>
<if test="password != null and password != ''">
AND password = #{password}
</if>
</select>
3、where元素
上面的select语句我们加了一个1=1
的绝对true的语句,目的是为了防止语句错误,变成SELECT * FROM student WHERE
这样where后没有内容的错误语句。这样会有点奇怪,此时可以使用<where>
元素。
bash
<select id="findUserById" resultType="com.ydlclass.entity.User">
select id,username,password from user
<where>
<if test="id != null">
AND id = #{id}
</if>
<if test="username != null and username != ''">
AND username = #{username}
</if>
<if test="password != null and password != ''">
AND password = #{password}
</if>
</where>
</select>
4、trim元素
有时候我们要去掉一些特殊的SQL语法,比如常见的and、or,此时可以使用trim元素。trim元素意味着我们需要去掉一些特殊的字符串,prefix代表的是语句的前缀,而prefixOverrides代表的是你需要去掉的那种字符串,suffix表示语句的后缀,suffixOverrides代表去掉的后缀字符串。
bash
<select id="select" resultType="com.ydlclass.entity.User">
SELECT * FROM user
<trim prefix="WHERE" prefixOverrides="AND">
<if test="username != null and username != ''">
AND username LIKE concat('%', #{username}, '%')
</if>
<if test="id != null">
AND id = #{id}
</if>
</trim>
</select>
5、choose、when、otherwise元素
选一个
有些时候我们还需要多种条件的选择,在Java中我们可以使用switch、case、default语句,而在映射器的动态语句中可以使用choose、when、otherwise元素。
xml
<!-- 有name的时候使用name搜索,没有的时候使用id搜索 -->
<select id="select" resultType="com.ydlclass.entity.User">
SELECT * FROM user
WHERE 1=1
<choose>
<when test="name != null and name != ''">
AND username LIKE concat('%', #{username}, '%')
</when>
<when test="id != null">
AND id = #{id}
</when>
</choose>
</select>
6、set元素
在update语句中,如果我们只想更新某几个字段的值,这个时候可以使用set元素配合if元素来完成。注意:set元素遇到,会自动把,去掉。
bash
<update id="update">
UPDATE user
<set>
<if test="username != null and username != ''">
username = #{username},
</if>
<if test="password != null and password != ''">
password = #{password}
</if>
</set>
WHERE id = #{id}
</update>
7、foreach元素
foreach元素是一个循环语句,它的作用是遍历集合,可以支持数组、List、Set接口。
sql
<select id="select" resultType="com.ydlclass.entity.User">
SELECT * FROM user
WHERE id IN
<foreach collection="ids" open="(" close=")" separator="," item="id">
#{id}
</foreach>
</select>
- collection配置的是传递进来的参数名称。
- item配置的是循环中当前的元素。
- index配置的是当前元素在集合的位置下标。
- open和 close配置的是以什么符号将这些集合元素包装起来。
- separator是各个元素的间隔符。
8、foreach批量插入
sql
<insert id="batchInsert" parameterType="list">
insert into `user`( user_name, pass)
values
<foreach collection="users" item="user" separator=",">
(#{user.username}, #{user.password})
</foreach>
</insert>
9、SQL片段
有时候可能某个 sql 语句我们用的特别多,为了增加代码的重用性,简化代码,我们需要将这些代码抽取出来,然后使用时直接调用。
提取SQL片段:
bash
<sql id="if-title-author">
<if test="title != null">
title = #{title}
</if>
<if test="author != null">
and author = #{author}
</if>
</sql>
引用SQL片段:
xml
<select id="queryBlogIf" parameterType="map" resultType="blog">
select * from blog
<where>
<!-- 引用 sql 片段,如果refid 指定的不在本文件中,那么需要在前面加上 namespace -->
<include refid="if-title-author"></include>
<!-- 在这里还可以引用其他的 sql 片段 -->
</where>
</select>
九、数据关系处理
- 部门和员工的关系,一个部门多个员工,一个员工属于一个部门
- 那我们可以采取两种方式来维护关系,一种在一的一方,一种在多的一方!
数据库设计
sql
CREATE TABLE `dept` (
`id` INT(10) NOT NULL,
`name` VARCHAR(30) DEFAULT NULL,
PRIMARY KEY (`id`)
);
INSERT INTO dept VALUES (1, '元动力学习一组'),(2, '元动力学习二组');
CREATE TABLE `employee` (
`id` INT(10) NOT NULL,
`name` VARCHAR(30) DEFAULT NULL,
`did` INT(10) DEFAULT NULL,
PRIMARY KEY (`id`),
CONSTRAINT `fk_did` FOREIGN KEY (`did`) REFERENCES `dept` (`id`)
) ;
INSERT INTO employee VALUES (1, '邸智伟', 1),(2, '成虹', 2),(3, '康永亮', 1),(4, '杨春旺', 2),(5, '陈建强', 1);
1、通过员工级联部门
1、编写实体类
java
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Dept implements Serializable{
private static final Long serialVersionUID = 1L;
private int id;
private String name;
}
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Employee implements Serializable {
private static final Long serialVersionUID = 1L;
private int id;
private String name;
//维护关系
private Dept dept;
}
2、编写实体类对应的Mapper接口
kotlin
public interface DeptMapper {
}
public interface EmployeeMapper {
}
3、编写Mapper接口对应的 mapper.xml配置文件
xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.dao.DeptMapper">
</mapper>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.dao.EmployeeMapper">
</mapper>
4、将mapper进行注册、去mybatis-config文件中配置
ini
<mapper resource="com/ydlclass/dao/DeptMapper.xml"/>
<mapper resource="com/ydlclass/dao/EmployeeMapper.xml"/>
(1)按查询嵌套
这种方式是一种级联查询的方式,会产生多个sql语句,第一个sql的查询语句结果会触发第二个查询语句。
1、写方法
scss
List<Employee> select(Employee employee);
2、mapper处理
xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.mapper.EmployeeMapper">
<resultMap id="employeeMap" type="employee">
<id column="id" property="id" />
<result column="name" property="name"/>
<association property="dept" column="did" javaType="dept"
select="com.ydlclass.mapper.DeptMapper.select">
<id column="id" property="id"/>
<result column="name" property="name"/>
</association>
</resultMap>
<sql id="sql">
`id`,`name`,`did`
</sql>
<select id="select" resultMap="employeeMap">
select <include refid="sql" />
from employee
</select>
</mapper>
xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.mapper.DeptMapper">
<resultMap id="deptMap" type="dept">
<id column="id" property="id"/>
<result column="name" property="name"/>
<collection property="employees" javaType="list" ofType="employee"
column="id" select="com.ydlclass.mapper.EmployeeMapper.selectByDid">
<id column="eid" property="id"/>
<result column="ename" property="name"/>
</collection>
</resultMap>
<sql id="sql">
`id`
,`name`
</sql>
<select id="select" resultMap="deptMap">
select
<include refid="sql"/>
from dept where id = #{id}
</select>
</mapper>
3、编写完毕去Mybatis配置文件中,注册Mapper
4、测试
csharp
@Test
public void testSelect() {
try (SqlSession session = sqlSessionFactory.openSession(true)) {
// statement是sql的申明
EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
List<Employee> employees = mapper.select(new Employee());
log.debug("The employees are [{}]",employees);
}
}
结果:
(2)按结果嵌套
结果嵌套是使用复杂查询,在根据结果的字段进行对象的封装,本质只会发送一个sql。
1、接口方法编写
scss
List<Employee> select2(Employee employee);
2、编写对应的mapper文件
xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.mapper.EmployeeMapper">
<resultMap id="employeeMap2" type="employee">
<id column="eid" property="id" />
<result column="ename" property="name"/>
<association property="dept" javaType="dept" >
<id column="did" property="id"/>
<result column="dname" property="name"/>
</association>
</resultMap>
<select id="select2" resultMap="employeeMap2" >
select e.id eid,e.name ename, d.id did,d.name dname
from employee e left join dept d
on d.id = e.did
</select>
</mapper>
4、测试
ini
@Test
public void testFindAllEmployees2() {
EmployeeMapper mapper = session.getMapper(EmployeeMapper.class);
List<Employee> allEmployees = mapper.findAllEmployees2();
for (Employee allEmployee : allEmployees) {
System.out.println(allEmployee);
}
}
2、通过部门级联用户
在部门处维护关系,此处可以联想订单和订单详情。
修改实体类:
arduino
@Data
public class Dept {
private int id;
private String name;
//用于关系维护
List<Employee> employees;
}
@Data
public class Employee {
private int id;
private String name;
}
(1)按结果嵌套处理
1、写方法
csharp
public interface DeptMapper {
List<Dept> select(Dept dept);
}
2、写配置文件
xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.mapper.DeptMapper">
<resultMap id="deptMap" type="dept">
<id column="id" property="id"/>
<result column="name" property="name"/>
<collection property="employees" javaType="list" ofType="employee"
column="id" select="com.ydlclass.mapper.EmployeeMapper.selectByDid">
<id column="eid" property="id"/>
<result column="ename" property="name"/>
</collection>
</resultMap>
<sql id="sql">
`id`,`name`
</sql>
<select id="select" resultMap="deptMap">
select
<include refid="sql"/>
from dept where id = #{id}
</select>
</mapper>
在EmployeeMapper中添加select进行级联查询
xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.mapper.EmployeeMapper">
<resultMap id="employeeMap" type="employee">
<id column="id" property="id" />
<result column="name" property="name"/>
<association property="dept" column="did" javaType="dept"
select="com.ydlclass.mapper.DeptMapper.select">
<id column="id" property="id"/>
<result column="name" property="name"/>
</association>
</resultMap>
<resultMap id="employeeMap2" type="employee">
<id column="eid" property="id" />
<result column="ename" property="name"/>
<association property="dept" javaType="dept" >
<id column="did" property="id"/>
<result column="dname" property="name"/>
</association>
</resultMap>
<select id="selectByDid" resultMap="employeeMap2" >
select id eid,name ename from employee where did=#{did}
</select>
</mapper>
3、测试
csharp
@Test
public void testSelect() {
try (SqlSession session = sqlSessionFactory.openSession(true)) {
// statement是sql的申明
DeptMapper mapper = session.getMapper(DeptMapper.class);
List<Dept> depts = mapper.select(null);
log.debug("The depts are [{}]", depts);
}
}
(2)按查询嵌套处理
1、TeacherMapper接口编写方法
scss
List<Dept> select2(Dept dept);
2、编写接口对应的Mapper配置文件
xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.mapper.DeptMapper">
<resultMap id="deptMap2" type="dept">
<id column="did" property="id"/>
<result column="dname" property="name"/>
<collection property="employees" javaType="list" ofType="employee">
<id column="eid" property="id"/>
<result column="ename" property="name"/>
</collection>
</resultMap>
<sql id="sql">
`id`,`name`
</sql>
<select id="select2" resultMap="deptMap2">
select d.id did, d.name dname, e.id eid, e.name ename
from dept d
left join employee e on d.id = e.did
</select>
</mapper>
3、测试
ini
@Test
public void testSelect2() {
try (SqlSession session = sqlSessionFactory.openSession(true)) {
// statement是sql的申明
DeptMapper mapper = session.getMapper(DeptMapper.class);
List<Dept> depts = mapper.select2(null);
log.debug("The depts are [{}]", depts);
}
}
结果:
3、小知识:
(1)懒加载
通俗的讲就是按需加载,我们需要什么的时候再去进行什么操作。而且先从单表查询,需要时再从关联表去关联查询,能大大提高数据库性能,因为查询单表要比关联查询多张表速度要快。
在mybatis中,resultMap可以实现高级映射(使用association、collection实现一对一及一对多映射),association、collection具备延迟加载功能。
xml
<!-- 开启懒加载配置 -->
<settings>
<!-- 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 -->
<setting name="lazyLoadingEnabled" value="true"/>
<!-- 开启时,任一方法的调用都会加载该对象的所有延迟加载属性。 否则,每个延迟加载属性会按需加载 -->
<setting name="aggressiveLazyLoading" value="false"/>
</settings>
(2)Mybatis 获取自增主键的方式
使用 xml
直接在标签属性上添加 useGeneratedKeys(是否是自增长,必须设置 true) 和 keyProperty(实体类主键属性名称) 、keyColumn(数据库主键字段名称)
sql
<insert id="insert" useGeneratedKeys="true" keyColumn="id" keyProperty="id">
insert into `user`(id, username, password)
values (#{id}, #{username}, #{password})
</insert>
注解方式 useGeneratedKeys(是否是自增长,必须设置 true) 和 keyProperty(实体类主键属性名称) 、keyColumn(数据库主键字段名称)
less
@Insert("INSERT INTO user(name,age) VALUES(#{user.name},#{user.age})")
@Options(useGeneratedKeys=true, keyProperty="user.id",keyColumn="id" )
public int insert(@Param("user")User user);
也可以全局设置
ini
<setting name="useGeneratedKeys" value="true"/>
十、Mybatis缓存
1、为什么要用缓存?
- 如果缓存中有数据,就不用从数据库获取,大大提高系统性能。
- MyBatis提供一级缓存和二级缓存
2、一级缓存:
一级缓存是sqlsession级别的缓存
- 在操作数据库时,需要构造sqlsession对象,在对象中有一个数据结构(HashMap)用于存储缓存数据
- 不同的sqlsession之间的缓存区域是互相不影响的。
一级缓存工作原理:
图解:
- 第一次发起查询sql查询用户id为1的用户,先去找缓存中是否有id为1的用户,如果没有,再去数据库查询用户信息。得到用户信息,将用户信息存储到一级缓存中。
- 如果sqlsession执行了commit操作(插入,更新,删除),会清空sqlsession中的一级缓存,避免脏读
- 第二次发起查询id为1的用户,缓存中如果找到了,直接从缓存中获取用户信息
- MyBatis默认支持并开启一级缓存。
一级缓存演示
1、必须配置日志,要不看不见
2、编写接口方法
less
//根据id查询用户
User findUserById(@Param("id") int id);
3、接口对应的Mapper文件
csharp
<select id="findUserById" resultType="com.ydlclass.entity.User">
select * from user where id = #{id}
</select>
4、测试
ini
@Test
public void testFindUserById(){
UserMapper mapper = session.getMapper(UserMapper.class);
User user1 = mapper.findUserById(1);
System.out.println(user1);
User user2 = mapper.findUserById(3);
System.out.println(user2);
User user3 = mapper.findUserById(1);
System.out.println(user3);
}
5、通过日志分析
ini
[com.ydlclass.dao.UserMapper.findUserById]-==> Preparing: select id,username,password from user where id = ?
[com.ydlclass.dao.UserMapper.findUserById]-==> Parameters: 1(Integer)
[com.ydlclass.dao.UserMapper.findUserById]-<== Total: 1
User{id=1, username='楠哥', password='123456'} ---->ID为1,第一次有sql
[com.ydlclass.dao.UserMapper.findUserById]-==> Preparing: select id,username,password from user where id = ?
[com.ydlclass.dao.UserMapper.findUserById]-==> Parameters: 3(Integer)
[com.ydlclass.dao.UserMapper.findUserById]-<== Total: 1
User{id=3, username='磊哥', password='987654'} ---->ID为3,第一次有sql
User{id=1, username='楠哥', password='123456'} ---->ID为1,第二次无sql,走缓存
一级缓存失效
- sqlSession不同
- 当sqlSession对象相同的时候,查询的条件不同,原因是第一次查询时候,一级缓存中没有第二次查询所需要的数据
- 当sqlSession对象相同,两次查询之间进行了插入的操作
- 当sqlSession对象相同,手动清除了一级缓存中的数据
一级缓存生命周期
- MyBatis在开启一个数据库会话时,会创建一个新的SqlSession对象,SqlSession对象中会有一个新的Executor对象,Executor对象中持有一个新的PerpetualCache对象;当会话结束时,SqlSession对象及其内部的Executor对象还有PerpetualCache对象也一并释放掉。
- 如果SqlSession调用了close()方法,会释放掉一级缓存PerpetualCache对象,一级缓存将不可用。
- 如果SqlSession调用了clearCache(),会清空PerpetualCache对象中的数据,但是该对象仍可使用。
- SqlSession中执行了任何一个update操作(update()、delete()、insert()) ,都会清空PerpetualCache对象的数据,但是该对象可以继续使用。
3、二级缓存:
二级缓存是mapper级别的缓存
- 多个sqlsession去操作同一个mapper的sql语句,多个sqlsession可以共用二级缓存,所得到的数据会存在二级缓存区域
- 二级缓存是跨sqlsession的
- 二级缓存相比一级缓存的范围更大(按namespace来划分),多个sqlsession可以共享一个二级缓存
二级缓存实现原理
首先要手动开启MyBatis二级缓存。
在config.xml设置二级缓存开关 , 还要在具体的mapper.xml开启二级缓存
xml
<settings>
<!--开启二级缓存-->
<setting name="cacheEnabled" value="true"/>
</settings>
<!-- 需要将映射的javabean类实现序列化 -->
class Student implements Serializable{}
xml
<!--开启本Mapper的namespace下的二级缓存-->
<cache eviction="LRU" flushInterval="100000"/>
1)cache属性的简介:
eviction回收策略(缓存满了的淘汰机制),目前MyBatis提供以下策略。
- LRU(Least Recently Used),最近最少使用的,最长时间不用的对象
- FIFO(First In First Out),先进先出,按对象进入缓存的顺序来移除他们
- SOFT,软引用,移除基于垃圾回收器状态和软引用规则的对象,当内存不足,会触发JVM的GC,如果GC后,内存还是不足,就会把软引用的包裹的对象给干掉,也就是只有内存不足,JVM才会回收该对象。
- WEAK,弱引用,更积极的移除基于垃圾收集器状态和弱引用规则的对象。弱引用的特点是不管内存是否足够,只要发生GC,都会被回收。
flushInterval:刷新间隔时间,单位为毫秒,
- 这里配置的是100秒刷新,如果你不配置它,那么当SQL被执行的时候才会去刷新缓存。
size:引用数目,
-
一个正整数,代表缓存最多可以存储多少个对象,不宜设置过大。设置过大会导致内存溢出。
这里配置的是1024个对象
**readOnly:**只读,
-
意味着缓存数据只能读取而不能修改,这样设置的好处是我们可以快速读取缓存,缺点是我们没有
办法修改缓存,它的默认值是false,不允许我们修改
(2)操作过程:
sqlsession1查询用户id为1的信息,查询到之后,会将查询数据存储到二级缓存中。
如果sqlsession3去执行相同mapper下sql,执行commit提交,会清空该mapper下的二级缓存区域的数据
sqlsession2查询用户id为1的信息, 去缓存找是否存在缓存,如果存在直接从缓存中取数据
禁用二级缓存:
在statement中可以设置useCache=false,禁用当前select语句的二级缓存,默认情况为true
ini
<select id="getStudentById" parameterType="java.lang.Integer" resultType="Student" useCache="false">
在实际开发中,针对每次查询都需要最新的数据sql,要设置为useCache="false" ,禁用二级缓存
flushCache标签:刷新缓存(清空缓存)
ini
<select id="getStudentById" parameterType="java.lang.Integer" resultType="Student" flushCache="true">
一般下执行完commit操作都需要刷新缓存,flushCache="true 表示刷新缓存,可以避免脏读
二级缓存应用场景
对于访问多的查询请求并且用户对查询结果实时性要求不高的情况下,可采用MyBatis二级缓存,降低数据库访问量,提高访问速度,如电话账单查询
根据需求设置相应的flushInterval:刷新间隔时间,比如三十分钟,24小时等。
二级缓存局限性:
MyBatis二级缓存对细粒度的数据级别的缓存实现不好,比如如下需求:对商品信息进行缓存,由于商品信息查询访问量大,但是要求用户每次都能查询最新的商品信息,此时如果使用MyBatis的二级缓存就无法实现当一个商品变化时只刷新该商品的缓存信息而不刷新其它商品的信息,因为MyBatis的二级缓存区域以mapper为单位划分,当一个商品信息变化会将所有商品信息的缓存数据全部清空。解决此类问题需要在业务层根据需求对数据有针对性缓存。
二级缓存演示
先不进行配置
ini
@Test
public void testFindUserCache() throws Exception {
//使用不同的mapper
UserMapper mapper1 = session.getMapper(UserMapper.class);
User user1 = mapper1.findUserById(1);
System.out.println(user1);
//提交了就会刷到二级缓存,要不还在一级缓存,一定要注意
session.commit();
UserMapper mapper2 = session.getMapper(UserMapper.class);
User user2 = mapper2.findUserById(1);
System.out.println(user2);
System.out.println(user1 == user2);
}
结果:
ini
[com.ydlclass.dao.UserMapper.findUserById]-==> Preparing: select id,username,password from user where id = ?
[com.ydlclass.dao.UserMapper.findUserById]-==> Parameters: 1(Integer)
[com.ydlclass.dao.UserMapper.findUserById]-<== Total: 1
User{id=1, username='楠哥', password='123456'}
[com.ydlclass.dao.UserMapper.findUserById]-==> Preparing: select id,username,password from user where id = ?
[com.ydlclass.dao.UserMapper.findUserById]-==> Parameters: 1(Integer)
[com.ydlclass.dao.UserMapper.findUserById]-<== Total: 1
User{id=1, username='楠哥', password='123456'}
false ---->两个对象不是一个,发了两个sql,说明缓存没有起作用
可以看见两次同样的sql,却都进库进行了查询。说明二级缓存没开。
配置二级缓存
1、开启全局缓存
ini
<setting name="cacheEnabled" value="true"/>
2、使用二级缓存,这个写在mapper里
xml
<!--开启本Mapper的namespace下的二级缓存-->
<cache eviction="LRU" flushInterval="100000" size="512" readOnly="true"></cache>
<!--
创建了一个 LRU 最少使用清除缓存,每隔 100 秒刷新,最多可以存储 512 个对象,返回的对象是只读的。
-->
3、测试执行
ini
[com.ydlclass.dao.UserMapper.findUserById]-==> Preparing: select id,username,password from user where id = ?
[com.ydlclass.dao.UserMapper.findUserById]-==> Parameters: 1(Integer)
[com.ydlclass.dao.UserMapper.findUserById]-<== Total: 1
User{id=1, username='楠哥', password='123456'}
[com.ydlclass.dao.UserMapper]-Cache Hit Ratio [com.ydlclass.dao.UserMapper]: 0.5
User{id=1, username='楠哥', password='123456'}
true ---->两个对象一样了,就发了一个sql,说明缓存起了作用
4、第三方缓存--EhCache充当二级缓存
此外还有很多第三方缓存组件,最常用的比如ehcache,Memcached、redis等,我们以比较简单的ehcache为例。
1、引入依赖
xml
<!-- https://mvnrepository.com/artifact/org.mybatis.caches/mybatis-ehcache -->
<dependency>
<groupId>org.mybatis.caches</groupId>
<artifactId>mybatis-ehcache</artifactId>
<version>1.2.1</version>
</dependency>
2、修改mapper.xml中使用对应的缓存
ini
<mapper namespace = "com.ydlclass.entity.User" >
<cache type="org.mybatis.caches.ehcache.EhcacheCache" eviction="LRU" flushInterval="10000" size="1024" readOnly="true"/>
</mapper>
3、添加ehcache.xml文件,ehcache配置文件,具体配置自行百度
xml
<?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd"
updateCheck="false">
<!--
diskStore:为缓存路径,ehcache分为内存和磁盘两级,此属性定义磁盘的缓存位置。参数解释如下:
user.home -- 用户主目录
user.dir -- 用户当前工作目录
java.io.tmpdir -- 默认临时文件路径
-->
<diskStore path="./tmpdir/Tmp_EhCache"/>
<defaultCache
eternal="false"
maxElementsInMemory="10000"
overflowToDisk="false"
diskPersistent="false"
timeToIdleSeconds="1800"
timeToLiveSeconds="259200"
memoryStoreEvictionPolicy="LRU"/>
</ehcache>
<!--
name:缓存名称。
maxElementsInMemory:缓存最大个数。
eternal:对象是否永久有效,一但设置了,timeout将不起作用。
timeToIdleSeconds:设置对象在失效前的允许闲置时间(单位:秒)。仅当eternal=false对象不是永久有效时使用,可选属性,默认值是0,也就是可闲置时间无穷大。
timeToLiveSeconds:设置对象在失效前允许存活时间(单位:秒)。最大时间介于创建时间和失效时间之间。仅当eternal=false对象不是永久有效时使用,默认是0.,也就是对象存活时间无穷大。
overflowToDisk:当内存中对象数量达到maxElementsInMemory时,Ehcache将会对象写到磁盘中。
diskSpoolBufferSizeMB:这个参数设置DiskStore(磁盘缓存)的缓存区大小。默认是30MB。每个Cache都应该有自己的一个缓冲区。
maxElementsOnDisk:硬盘最大缓存个数。
diskPersistent:是否在磁盘上持久化。指重启jvm后,数据是否有效。默认为false。
memoryStoreEvictionPolicy:当达到maxElementsInMemory限制时,Ehcache将会根据指定的策略去清理内存。默认策略是LRU(最近最少使用)。你可以设置为FIFO(先进先出)或是LFU(较少使用)。
clearOnFlush:内存数量最大时是否清除。
-->
3、测试
5、使用缓存独立控制
其实我们更加常见的是使用第三方的缓存进行存储,并且自由控制
xml
<dependency>
<groupId>net.sf.ehcache</groupId>
<artifactId>ehcache</artifactId>
<version>2.10.3</version>
</dependency>
测试一下
ini
final CacheManager cacheManager = new CacheManager(this.getClass().getClassLoader().getResourceAsStream("ehcache.xml"));
// create the cache called "hello-world"
String[] cacheNames = cacheManager.getCacheNames();
for (String cacheName : cacheNames) {
System.out.println(cacheName);
}
Cache userDao = cacheManager.getCache("userDao");
Element element = new Element("testFindUserById_1",new User(1,"q","d"));
userDao.put(element);
Element element1 = userDao.get("testFindUserById_1");
User user = (User)element1.getObjectValue();
System.out.println(user);
创建工具类
vbnet
/**
* @author zn
* @date 2021/1/28
*/
public class CacheUtil {
private static CacheManager cacheManager = new CacheManager(CacheUtil.class.getClassLoader().getResourceAsStream("ehcache.xml"));
public static void put(String cacheName,String key,Object value){
Cache cache = cacheManager.getCache(cacheName);
Element element = new Element(key,value);
cache.put(element);
}
public static Object get(String cacheName,String key){
Cache cache = cacheManager.getCache(cacheName);
return cache.get(key).getObjectValue();
}
public static boolean delete(String cacheName,String key){
Cache cache = cacheManager.getCache(cacheName);
return cache.remove(key);
}
}
测试
ini
@Test
public void selectDeptsTest(){
Map<String,Object> cache = new HashMap<>(8);
// 执行方法
List<Dept> depts = deptMapper.selectDepts();
CacheUtil.put("dept","selectUserByIdTest",depts);
System.out.println(depts);
session.commit();
session = sqlSessionFactory.openSession();
// 去缓存拿,如果有就拿出来
List<Dept> newDepts = null;
Object object = CacheUtil.get("dept", "selectUserByIdTest");
if(object == null){
// 去数据库查询
DeptMapper mapper = session.getMapper(DeptMapper.class);
newDepts = mapper.selectDepts();
} else {
newDepts = (List<Dept>) object;
}
System.out.println(newDepts);
}
十一、配置文件
MyBatis的配置文件分为核心配置文件和mapper配置文件
- mybatis-config.xml 系统核心配置文件
- 核心配置文件主要配置Mybatis一些基础组件和加载资源,核心配置文件中的元素常常能影响Mybatis的整个运行过程。
- 能配置的内容如下,顺序不能乱:
matlab
1.properties是一个配置属性的元素
2.settings设置,mybatis最为复杂的配置也是最重要的,会改变mybatis运行时候的行为
3.typeAliases别名(在TypeAliasRegistry中可以看到mybatis提供了许多的系统别名)
4.typeHandlers 类型处理器(比如在预处理语句中设置一个参数或者从结果集中获取一个参数时候,都会用到类型处理器,在TypeHandlerRegistry中定义了很多的类型处理器)
5.objectFactory 对象工厂(myabtis在构建一个结果返回的时候,会使用一个ObjectFactory去构建pojo)
6.plugins 插件
7.environments 环境变量
environment 环境变量
transactionManager 事务管理器
dataSource 数据源
databaseIdProvider 数据库厂商标识
8.mappers 映射器
找几个重要的讲解一下
1、environments元素
environments可以为mybatis配置多环境运行,将SQL映射到多个不同的数据库上,必须指定其中一个为默认运行环境(通过default指定),如果想切换环境修改default的值即可。
最常见的就是,生产环境和开发环境,两个环境切换必将导致数据库的切换。
ini
<environments default="development">
<environment id="development">
<transactionManager type="JDBC">
<property name="..." value="..."/>
</transactionManager>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
<environment id="product">
<transactionManager type="JDBC">
<property name="..." value="..."/>
</transactionManager>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
-
dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。
-
数据源是必须配置的。
-
有三种内建的数据源类型
difftype="[UNPOOLED|POOLED|JNDI]") - unpooled:这个数据源的实现只是每次被请求时打开和关闭连接。 - pooled:这种数据源的实现利用"池"的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。 - jndi:这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。
-
数据源也有很多第三方的实现,比如druid,hikari,dbcp,c3p0等等....
-
这两种事务管理器类型都不需要设置任何属性。
-
具体的一套环境,通过设置id进行区别,id保证唯一!
-
子元素节点:transactionManager - [ 事务管理器 ]
xml<!-- 语法 --> <transactionManager type="[ JDBC | MANAGED ]"/>
-
子元素节点:数据源(dataSource)
2、mappers元素
mappers的存在就是要对写好的mapper和xml进行统一管理
要不然系统怎么知道我写了哪些mapper
通常这么引入
xml
<mappers>
<!-- 使用相对于类路径的资源引用 -->
<mapper resource="com/ydlclass/dao/userMapper.xml"/>
<!-- 面向注解时使用全类名 -->
<mapper class="com.ydlclass.dao.AdminMapper"/>
</mappers>
。。。还有其他的方式
Mapper文件
xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ydlclass.mapper.UserMapper">
</mapper>
- namespace中文意思:命名空间,作用如下:
- namespace的命名必须跟某个接口同名,这才能找的到啊!
3、Properties元素
数据库连接信息我们最好放在一个单独的文件中。
1、 在资源目录下新建一个db.properties
ini
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/ssm?useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
password=root
2、 将文件导入properties 配置文件
xml
<configuration>
<!--导入properties文件-->
<properties resource="db.properties"/>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="mapper/UserMapper.xml"/>
</mappers>
</configuration>
4、其他配置浏览
settings能对我的一些核心功能进行配置,如懒加载、日志实现、缓存开启关闭等
简单参数说明
| 设置参数 | 描述 | 有效值 | 默认值 |
|--------------------------|---------------------------------------------------------------------------------|----------------------|----------------|--------|-------------|-----------------|----------------|------------|---------|
| cacheEnabled | 该配置影响的所有映射器中配置的缓存的全局开关。 | true | false | true |
| lazyLoadingEnabled | 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态。 | true | false | false |
| useColumnLabel | 使用列标签代替列名。不同的驱动在这方面会有不同的表现,具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。 | true | false | true |
| useGeneratedKeys | 允许 JDBC 支持自动生成主键,需要驱动兼容。如果设置为 true 则这个设置强制使用自动生成主键,尽管一些驱动不能兼容但仍可正常工作(比如 Derby)。 | true | false | False |
| defaultStatementTimeout | 设置超时时间,它决定驱动等待数据库响应的秒数。 | Any positive integer | Not Set (null) |
| mapUnderscoreToCamelCase | 是否开启自动驼峰命名规则(camel case)映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。 | true | false | False |
| logPrefix | 指定 MyBatis 增加到日志名称的前缀。 | Any String | Not set |
| logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | Not set |
完整的 settings 元素,有很多可以配置的选项,需要大家慢慢自己学习:
xml
<settings>
<!---->
<setting name="cacheEnabled" value="true"/>
<!---->
<setting name="lazyLoadingEnabled" value="true"/>
<!---->
<setting name="multipleResultSetsEnabled" value="true"/>
<setting name="useColumnLabel" value="true"/>
<setting name="useGeneratedKeys" value="false"/>
<setting name="autoMappingBehavior" value="PARTIAL"/>
<setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
<setting name="defaultExecutorType" value="SIMPLE"/>
<setting name="defaultStatementTimeout" value="25"/>
<setting name="defaultFetchSize" value="100"/>
<setting name="safeRowBoundsEnabled" value="false"/>
<setting name="mapUnderscoreToCamelCase" value="false"/>
<setting name="localCacheScope" value="SESSION"/>
<setting name="jdbcTypeForNull" value="OTHER"/>
<setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>