MyBatis 的 代理开发方式(Mapper 接口代理)是其核心特性之一,通过动态代理技术,将 Mapper 接口的方法调用自动映射到 XML 或注解中定义的 SQL 语句。这种方式避免了手动编写 DAO 实现类,极大简化了持久层代码。
动态代理机制
MyBatis 在运行时通过 JDK 动态代理 为 Mapper 接口生成代理对象。当调用接口方法时,代理对象会根据方法名、参数和返回类型,找到对应的 SQL 并执行。
映射规则
标签的 id
匹配。@Select
、@Insert
等注解定义 SQL。核心组件
public interface UserMapper {
// 根据ID查询用户
User selectById(int id);
// 插入用户
int insert(User user);
// 更新用户
int update(User user);
// 删除用户
int delete(int id);
}
在resource/mapper/UserMapper.xml中编写SQL:
INSERT INTO user (name, age)
VALUES (#{name}, #{age})
UPDATE user SET name = #{name}, age = #{age}
WHERE id = #{id}
DELETE FROM user WHERE id = #{id}
在mybatis-config.xml中加载映射文件
INSERT INTO user (name, age)
VALUES (#{name}, #{age})
UPDATE user SET name = #{name}, age = #{age}
WHERE id = #{id}
DELETE FROM user WHERE id = #{id}
// 1. 获取 SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 2. 获取 Mapper 代理对象
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
// 3. 调用接口方法执行 SQL
User user = userMapper.selectById(1);
int rows = userMapper.insert(new User("Alice", 25));
// 4. 提交事务并关闭会话
sqlSession.commit();
sqlSession.close();
public interface UserMapper {
@Select("SELECT * FROM user WHERE id = #{id}")
User selectById(int id);
@Insert("INSERT INTO user (name, age) VALUES (#{name}, #{age})")
@Options(useGeneratedKeys = true, keyProperty = "id")
int insert(User user);
@Update("UPDATE user SET name = #{name}, age = #{age} WHERE id = #{id}")
int update(User user);
@Delete("DELETE FROM user WHERE id = #{id}")
int delete(int id);
}
在mybatis-config.xml中指定包接口路径
Mapper接口开发方法只需要编写Mapper接口(相当于DAO接口),由MyBatis框架根据接口定义创建接口的动态代理对象。
Mapper接口开发需要遵循以下规范: