mysql MyBatis常用类有哪些_mysql映射关系说明

SqlSessionFactory 是单例工厂，SqlSession 需手动关闭且非线程安全，Mapper 接口与 XML 的 namespace 和 id 必须严格一致，ResultMap 通过 association/collection 处理嵌套映射并防 N +1。

SqlSessionFactory、SqlSession、Mapper 接口和 ResultMap 是 MyBatis 操作 MySQL 时最常打交道的四个核心类 / 配置项——它们不是“工具 类”，而是框架运行时真正承载数据映射逻辑的骨架。

SqlSessionFactory 是工厂，但别手动 new

它负责创建 SqlSession，通常只在应用启动时构建一次（比如通过 SqlSessionFactoryBuilder.build() 加载 mybatis-config.xml）。常见错误是每次查询都重建它：

SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(……); // ❌ 错误：重量级对象，不应频繁创建

正确做法是把它作为单例交给 Spring 管理，或用静态变量持有。否则会严重拖慢性能，还可能引发连接池耗尽。

SqlSession 是会话，用完必须 close

它是执行 SQL 的入口，提供 selectOne、insert、update、delete 等方法。关键点在于：

• 它不是线程安全的，不能共享
• 必须显式调用 close() 或用 try-with-resources 包裹，否则数据库连接不会释放
• 直接用它查关联数据（如一对多）时，需手动指定 resultMap ID，不能只靠 resultType

示例：

try (SqlSession session = sqlSessionFactory.openSession()) {User user = session.selectOne("com.example.mapper.UserMapper.selectUserWithOrders", 123);}

Mapper 接口本质是代理，namespace 和 id 必须严丝合缝

你写的接口（如 UserMapper）本身不实现逻辑，MyBatis 动态生成代理对象来绑定 XML 中的 SQL。这就要求：

• namespace 必须等于接口全限定名（如 com.example.mapper.UserMapper）
• 每个方法名必须与 XML 中 的 id 完全一致
• 参数类型、返回类型要能被 MyBatis 自动匹配（否则报 BindingException）

错一个字母，运行时报错就是：

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.example.mapper.UserMapper.selectUserById

ResultMap 是映射中枢，association 和 collection 决定嵌套结构能否展开

当查用户 + 地址（一对一）或用户 + 订单列表（一对多）时，resultType 不够用，必须写 resultMap。注意：

• 一对一用
• 一对多用
• 字段名与属性名不一致时，必须显式写 column 和 property，别指望驼峰自动转换覆盖所有场景
• 嵌套过深（如主表→子表→孙表）容易触发 N+1 查询，要用 fetchType="eager" 或改写为 JOIN 查询

真正卡住人的从来不是“有没有写 resultMap”，而是字段别名没对齐、ofType 写错类名、或者忘记在 SELECT 中把子表字段也 select 出来——这些地方一漏，返回对象里对应属性就是 null，还查不出错。