WordPress 基础配置与 Spring Boot + MyBatis-Plus 实战

3. Service 层

@Service
@RequiredArgsConstructor
public class FriendServiceImpl implements FriendService {
    private final UserMapper userMapper;
    private final FriendRelationMapper relationMapper;

    @Override
    @Transactional
    public boolean addFriend(Integer userId, Integer friendId) {
        checkUserExists(userId);
        checkUserExists(friendId);
        if (relationMapper.existsRelation(userId, friendId)) {
            return false;
        }
        relationMapper.insert(new FriendRelation(userId, friendId));
        relationMapper.insert(new FriendRelation(friendId, userId));
        return true;
    }

    @Override
    @Transactional
    public boolean deleteFriend(Integer userId, Integer friendId) {
        relationMapper.deleteRelation(userId, friendId);
        relationMapper.deleteRelation(friendId, userId);
        return true;
    }

    @Override
    public List<FriendDTO> getFriends(Integer userId) {
        return relationMapper.selectFriendList(userId).stream()
                .map(user -> new FriendDTO(user.getId(), user.getNickname(), user.getAvatar()))
                .collect(Collectors.toList());
    }

    @Override
    public boolean isFriend(Integer userId, Integer friendId) {
        return relationMapper.existsRelation(userId, friendId);
    }

    private void checkUserExists(Integer userId) {
        if (userMapper.selectById(userId) == null) {
            throw new BusinessException("用户不存在");
        }
    }
}

4. Mapper 层（MyBatis-Plus）

实体类定义：

@Data
@TableName("user_friend_relation")
public class FriendRelation {
    @TableId(type = IdType.AUTO)
    private Long id;
    private Integer userId;
    private Integer friendId;
    private LocalDateTime createTime;
}

Mapper 接口：

public interface FriendRelationMapper extends BaseMapper<FriendRelation> {
    @Select("SELECT COUNT(1) FROM user_friend_relation " +
            "WHERE user_id = #{userId} AND friend_id = #{friendId}")
    boolean existsRelation(@Param("userId") Integer userId, @Param("friendId") Integer friendId);

    @Delete("DELETE FROM user_friend_relation " +
            "WHERE user_id = #{userId} AND friend_id = #{friendId}")
    int deleteRelation(@Param("userId") Integer userId, @Param("friendId") Integer friendId);

    @Select("SELECT u.* FROM user u " +
            "JOIN user_friend_relation r ON u.id = r.friend_id " +
            "WHERE r.user_id = #{userId}")
    List<User> selectFriendList(Integer userId);
}

5. 统一返回结构

@Data
public class Result<T> {
    private int code;
    private String msg;
    private T data;

    public static <T> Result<T> success(T data) {
        Result<T> result = new Result<>();
        result.setCode(200);
        result.setMsg("success");
        result.setData(data);
        return result;
    }
}

6. 关键设计说明

• 事务控制：增删操作必须加 @Transactional 保证数据一致性。
• 参数校验：使用 @Valid 配合 @NotNull 注解拦截非法请求。
• 性能优化：通过 JOIN 查询减少 N+1 问题，建议在 (user_id, friend_id) 上建立联合索引。

数据库索引优化实践

为 email 字段建立索引是提升查询效率的关键手段。

1. 提高查询性能：将查找复杂度从 O(n) 降至 O(log n)，加速登录或密码重置流程。
2. 保证唯一性：创建唯一索引可防止重复注册。

   CREATE UNIQUE INDEX idx_email ON users(email);
   

3. 注意事项：索引会略微降低写入速度，但读取频繁的场景下利大于弊。对于长字符串，可考虑前缀索引以节省空间。

前端 OpenAPI 工具链问题排查

运行 npm run openapi 时报错 Cannot find module 'tslib'，这是 TypeScript 运行时库缺失导致的。

解决方案

1. 手动安装依赖：

   npm install tslib --save
   # 或使用 Yarn
   yarn add tslib
   

2. 验证依赖结构：检查 node_modules/tslib 目录是否存在。
3. 检查 package.json：确保 dependencies 中包含 tslib 条目。
4. 重新运行：修复后再次执行命令即可正常生成代码。

总结

通过实际项目演练，掌握 RESTful 接口设计规范与 MyBatis-Plus 核心用法。在工程实践中，注重环境配置的规范性与代码原理的理解，借助工具提升效率的同时保持对技术细节的把控。