架构与系统设计 / 系统课时
Repository 实现怎样接入 MyBatis
Repository 实现怎样接入 MyBatis
这一节解决 DDD 项目里最常见的持久化落点:领域层只声明 Repository 能力,基础设施层用 MyBatis Mapper 完成 SQL,再把查询结果转换回领域对象。完成后,领域模型不需要知道表结构、Mapper 或 SqlSession。
学习目标
- 区分领域 Repository、Repository Implementation 与 MyBatis Mapper 的职责
- 建立领域对象与持久化对象之间的双向转换
- 判断哪些 MyBatis 细节应该留在基础设施层
Repository Implementation 是持久化适配器
领域层中的 UserRepository 表达“按标识查用户、保存用户”等业务需要,它不关心数据来自 MySQL、PostgreSQL 还是其他存储。MyBatis 的 UserMapper 则负责把方法调用落成 SQL,它属于技术实现。
因此,基础设施层通常再放一个 MyBatisUserRepository:它实现领域层的 Repository 接口,调用 Mapper,并负责在 User 与 UserRow 之间转换。这样数据库字段变化首先影响持久化模型,而不是直接冲击领域模型。

用 Mapper 和转换器完成实现
下面是片段示例,假设项目已经接入 Spring 与 MyBatis-Spring,并存在 users(user_id, display_name) 表。示例把 Mapper 返回值限制为持久化对象 UserRow,再由转换器恢复领域对象。
import java.util.Optional;
import org.apache.ibatis.annotations.Arg;
import org.apache.ibatis.annotations.ConstructorArgs;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;
import org.springframework.stereotype.Repository;
record UserId(long value) {}
record User(UserId id, String displayName) {}
interface UserRepository {
Optional<User> findById(UserId id);
void add(User user);
}
record UserRow(long userId, String displayName) {}
@Mapper
interface UserMapper {
@Select("SELECT user_id, display_name FROM users WHERE user_id = #{userId}")
@ConstructorArgs({
@Arg(column = "user_id", javaType = long.class, id = true),
@Arg(column = "display_name", javaType = String.class)
})
UserRow selectById(@Param("userId") long userId);
@Insert("INSERT INTO users(user_id, display_name) VALUES(#{userId}, #{displayName})")
int insert(UserRow row);
}
final class UserConverter {
static User toDomain(UserRow row) {
return new User(new UserId(row.userId()), row.displayName());
}
static UserRow toRow(User user) {
return new UserRow(user.id().value(), user.displayName());
}
}
@Repository
final class MyBatisUserRepository implements UserRepository {
private final UserMapper mapper;
MyBatisUserRepository(UserMapper mapper) {
this.mapper = mapper;
}
@Override
public Optional<User> findById(UserId id) {
return Optional.ofNullable(mapper.selectById(id.value()))
.map(UserConverter::toDomain);
}
@Override
public void add(User user) {
int affected = mapper.insert(UserConverter.toRow(user));
if (affected != 1) {
throw new IllegalStateException("expected one inserted row");
}
}
}预期结果:在已配置 Spring、MyBatis 与 users 表的项目中,集成测试先插入一条用户数据再调用 findById,Mapper 得到 UserRow,Repository Implementation 经过转换后只向上层返回 User。这段代码依赖项目运行环境,因此属于片段示例。
不要让 Mapper 取代领域 Repository
直接把 UserMapper 当成领域 Repository 看似省了一层代码,但会让 SQL 查询形状、字段命名和 MyBatis 注解进入领域边界。只要表结构与领域模型不是一一对应,这种耦合很快会暴露。
事务边界也不应因为使用 MyBatis 就下沉到领域对象内部。应用层决定一次用例需要原子提交哪些操作,基础设施层的 Repository Implementation 负责参与这个事务并完成持久化。
判断实现是否放对了位置
可以用一条简单标准检查:领域层只看得到 UserRepository、User、UserId 等业务类型;只有基础设施层看得到 UserMapper、SQL、表字段和 MyBatis 注解。满足这个依赖方向后,将 MyBatis 更换为其他持久化技术时,核心领域模型无需跟着重写。