架构与系统设计 / 系统课时

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 之间转换。这样数据库字段变化首先影响持久化模型,而不是直接冲击领域模型。

Repository Implementation 接入 MyBatis 的分层数据流

用 Mapper 和转换器完成实现

下面是片段示例,假设项目已经接入 Spring 与 MyBatis-Spring,并存在 users(user_id, display_name) 表。示例把 Mapper 返回值限制为持久化对象 UserRow,再由转换器恢复领域对象。

java
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 更换为其他持久化技术时,核心领域模型无需跟着重写。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Repository 实现怎样接入 MyBatis

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通