手写 ORM 无法仅靠 @OneToMany 注解实现一次 JDBC 查询装配对象树，必须由框架自行完成 SQL 构建、结果解析与反射组装：通过 JOIN 扁平化查询、反射提取注解元信息、按主键分组填充集合。
Java 中手写 ORM 无法直接用 @OneToMany 实现“一次 JDBC 查询完成对象树装配”，因为标准 JPA 注解（如 @OneToMany）本身不参与 SQL 构建或结果映射，它只是元数据声明；真正执行查询、解析结果、递归装配对象树，必须由你手写的 ORM 框架逻辑来完成。核心在于：**用一条 SQL 查出所有关联数据（如主表 + 子表扁平化结果），再通过反射+主外键匹配，分组、实例化、组装成嵌套对象结构。**
一、SQL 层：用 JOIN 扁平化查出完整数据集
避免 N+1 查询，把一对多关系用 LEFT JOIN 一次性拉取。例如 User(1) → Order(N)，SQL 应返回：
SELECT u.id as u_id, u.name as u_name,
o.id as o_id, o.amount as o_amount, o.user_id as o_user_id
FROM user u
LEFT JOIN `order` o ON u.id = o.user_id关键点：
- 为避免字段名冲突，所有列都加别名，且用前缀区分（如
u_/o_） - 即使某 User 没有 Order，也要保留 User 行（用 LEFT JOIN），确保主对象不丢失
- 结果集是“宽表”形式，一行可能重复主表字段（User 信息重复多次）
二、反射层：根据注解提取映射元信息
扫描实体类，读取 @OneToMany 字段，获取：
- 主表实体类型（User）
- 子表字段名（如 orders）
- 关联目标类（Order.class）
- 外键字段（通过 @JoinColumn(name="user_id") 或约定推导）
- 主键字段（如 User.id）
示例反射提取逻辑片段：
立即学习“Java免费学习笔记（深入）”；
for (Field f : userClass.getDeclaredFields()) {
OneToMany oneToMany = f.getAnnotation(OneToMany.class);
if (oneToMany != null) {
String collectionName = f.getName();
Class<?> targetClass = resolveTargetClass(f); // 如 Order.class
String fkColumn = getJoinColumnName(f); // "user_id"
String pkColumn = getPrimaryKeyColumn(userClass); // "id"
}
}三、装配层：按主键分组 + 填充集合
遍历 ResultSet，用 Map 缓存已创建的主对象，并为每个主键维护子对象列表：
- 用
Map<Object, T>存主对象（key 是主键值，如user.id） - 用
Map<Object, List<S>>存子对象集合（key 同样是主键值） - 每行数据：先根据
u_id获取或创建 User 实例；再根据o_user_id将 Order 加入对应 User 的 orders 列表 - 最后遍历主对象 Map，用反射调用
setOrders()设置集合字段
注意：子对象为空时（LEFT JOIN 无匹配行），对应集合应为 new ArrayList<>()，而非 null。
四、限制与注意事项
这种方案虽高效，但有现实约束：
- 不能处理深度嵌套（如 User → Order → Item），需多级 JOIN + 更复杂分组逻辑
- 子表字段过多时，结果集膨胀严重，内存占用高
- 若子表有自身一对多（如 Order → OrderItem），单条 SQL 难以覆盖，通常需拆成两级查询
- 需手动处理懒加载、循环引用、泛型擦除（如
List<Order>反射中只能拿到 raw type）
不复杂但容易忽略。
