Mybatis Mapper接口动态代理实现原理

最新推荐文章于 2025-07-19 21:22:02 发布

一枝会思想的芦苇

最新推荐文章于 2025-07-19 21:22:02 发布

阅读量3.4k

点赞数 3

分类专栏：电商项目实战

电商项目实战专栏收录该内容

7 篇文章

订阅专栏

本文围绕MyBatis中Mapper接口无实现类却能正常调用的问题展开，介绍了MyBatis在Mapper接口上使用的动态代理非常规用法。通过Java动态代理创建代理类，说明如何将接口和XML文件中的方法关联，虽MyBatis内部实现更复杂，但此实现让接口使用更便捷。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

摘自《Mybatis从入门到精通》（刘增辉）

通过上面的学习，大家可能会有一个疑问，为什么 Mapper 接口没有实现类却能被正常调用呢？
这是因为 MyBaits 在 Mapper 接口上使用了动态代理的一种非常规的用法，熟悉这种动态代理的用法不仅有利于理解 MyBatis 接口和 XML 的关系，还能开阔思路。接下来提取出这种动态代理的主要思路，用代码来为大家说明。
假设有一个如下的 Mapper 接口。

public interface UserMapper {
	List<SysUser> selectAll();
}

这里使用 Java 动态代理方式创建一个代理类，代码如下。

public class MyMapperProxy<T> implements InvocationHandler {
	private Class<T> mapperInterface;
	private SqlSession sqlSession;
	
	public MyMapperProxy(Class<T> mapperInterface, SqlSession sqlSession) {
			this.mapperInterface = mapperInterface;
			this.sqlSession = sqlSession;
	}

	@Override
	public Object invoke(Object proxy , Method method , Object[] args)
			throws Throwable {
		//针对不同的 sql 类型，需要调用sqlSession不同的方法
		//接口方法中的参数也有很多情况 ，这里只考虑没有有参数的情况
		List<T> list= sqlSession.selectList(
				mapperInterface.getCanonicalName() + ”.” + method.getName());
		//返回位也有很多情况，这里不做处理直接返回
		return list;
	}
}

测试代码如下：

//获取sqlSession
SqlSession sqlSession = getSqlSession();
//获取 UserMapper 接口
MyMapperProxy userMapperProxy = new MyMapperProxy(
		UserMapper.class , sqlSession) ;
UserMapper userMapper = (UserMapper) Proxy.newProxyinstance (
		Thread.currentThread().getContextClassLoader(),
		new Class[ ] {UserMapper.class},
		userMapperProxy) ;
//调 用 selectAll 方 法
List<SysUser> user= userMapper.selectAll();

从代理类中可以看到，当调用一个接口的方法时，会先通过接口的全限定名称和当前调用的方法名的组合得到一个方法 id，这个 id 的值就是映射 XML 中 namespace 和具体方法 id 的组合。所以可以在代理方法中使用 sqlSession 以命名空间的方式调用方法。通过这种方式可以将接口和 XML 文件中的方法关联起来。这种代理方式和常规代理的不同之处在于，这里没有对某个具体类进行代理，而是通过代理转化成了对其他代码的调用。
由于方法参数和返回值存在很多种情况，因此 MyBatis 的内部实现会比上面的逻辑复杂得多，正是因为 MyBatis 对接口动态代理的实现，我们在使用接口方式的时候才会如此容易。