Lamp-Cloud项目多数据源配置与关联查询实践指南

多数据源配置方案

在Lamp-Cloud项目中，默认情况下所有服务模块都连接同一个lamp_column数据库。但在实际业务场景中，我们经常需要让特定服务连接独立的数据库实例。项目提供了灵活的配置方式来实现这一需求。

配置原理

Lamp-Cloud采用了Spring Boot的多层级配置机制，服务模块的私有配置可以覆盖公共配置。数据库连接配置遵循以下优先级：

1. 服务模块的私有配置（bootstrap.yml或application.yml）
2. 公共的mysql.yml配置

具体实现步骤

1. 定位配置文件：在需要独立数据库的服务模块中，找到src/main/resources目录下的bootstrap.yml或application.yml文件

2. 添加数据库配置：按照正确的YAML层级结构添加配置项

spring:
  datasource:
    druid:
      username: your_username
      password: your_password
      url: jdbc:p6spy:mysql://your_host:3306/your_database?serverTimezone=Asia/Shanghai&characterEncoding=utf8

3. 关键注意事项：

   • 必须确保配置层级正确，spring.datasource.druid是根路径
   • 每个层级使用2个空格缩进，不能使用Tab键
   • 修改配置后需要重启服务使配置生效

4. 配置验证：启动服务时观察日志，确认连接的是目标数据库而非默认的lamp_column

多表关联查询实现

Lamp-Cloud项目集成了MyBatis和MyBatis-Plus作为持久层框架，开发者可以直接使用这些框架提供的强大功能来实现复杂查询。

单表操作

对于单表CRUD操作，可以直接使用MyBatis-Plus提供的Wrapper构建查询条件：

QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("name", "张三")
       .between("age", 20, 30)
       .orderByDesc("create_time");
List<User> users = userMapper.selectList(wrapper);

多表关联查询

实现多表关联查询主要有两种方式：

1. XML映射文件方式：
   • 在mapper接口中定义方法
   • 编写对应的XML映射文件，使用JOIN语法实现关联查询
   • 定义ResultMap处理结果集映射

<select id="selectUserWithDepartment" resultMap="userWithDeptResult">
    SELECT u.*, d.name as dept_name 
    FROM user u LEFT JOIN department d ON u.dept_id = d.id
    WHERE u.status = 1
</select>

2. 注解方式：
   • 使用@Select注解直接编写SQL
   • 结合@Results注解定义结果映射

@Select("SELECT u.*, d.name as dept_name FROM user u LEFT JOIN department d ON u.dept_id = d.id WHERE u.id = #{id}")
@Results({
    @Result(property = "id", column = "id"),
    @Result(property = "deptName", column = "dept_name")
})
User selectUserWithDepartment(Long id);

分页查询

结合MyBatis-Plus的分页插件可以轻松实现分页查询：

Page<User> page = new Page<>(1, 10);
QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.eq("status", 1);

IPage<User> userPage = userMapper.selectPage(page, wrapper);
List<User> records = userPage.getRecords();
long total = userPage.getTotal();

对于关联查询的分页，可以使用自定义SQL配合分页参数：

@Select("SELECT u.*, d.name as dept_name FROM user u LEFT JOIN department d ON u.dept_id = d.id ${ew.customSqlSegment}")
IPage<User> selectUserDeptPage(Page<User> page, @Param(Constants.WRAPPER) Wrapper<User> wrapper);

最佳实践建议

1. 多数据源配置：

   • 建议将不同业务域的服务配置独立的数据库
   • 生产环境建议使用配置中心统一管理数据库连接信息
   • 注意数据库连接池参数的合理配置

2. 复杂查询优化：

   • 对于频繁使用的复杂查询，考虑使用MyBatis的二级缓存
   • 大数据量关联查询时注意索引优化
   • 可以考虑使用DTO对象而非实体类接收查询结果

3. 事务管理：

   • 跨数据源操作需要特别注意事务一致性
   • 考虑使用分布式事务解决方案处理跨库事务

通过合理利用Lamp-Cloud项目提供的这些功能，开发者可以构建出灵活、高效的数据访问层，满足各种复杂的业务需求。