Foxnic-SQL (16) ——Foxnic-SQL的模型关联方法
概述
本节我们将用一个简单的例子，来说明对象之间的关联关系，以及 Foxnic-SQL 是如何处理这种关联关系的。首先，我们引入商城下单的简单业务模型，这个模型里面包括了商品、订单、订单明细以及收件人地址，这个模型足够简单，所以很容易分析出他们之间的关联关系。
本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 项目中找到。
业务分析
从下面这个ER图，我们可以看到四个表，订单(example_order)、订单明细(example_order_item)、商品(example_goods)、收件地址(example_address)，如果按常规逻辑，我们从订单开始入手，一个订单包含若干商品，并投第到一个地址上。
不难分析出他们之间的关系：一个订单只会有一个地址，所以他们是一对一的；把这个关系反一下，同一个地址可能会收到多个订单，所以他们是一对多的关系；通常来讲，订单和商品是属于多对多关系，因为一个商品可以属于不同的订单，一个订单也可以包含多个商品；同理可以推得，地址和商品也是多对多的关系。但是这样的关系分析似乎有点搞脑子。
Foxnic-SQL 将这种进行简化，只有一对一或一对多两种关系。即，如果我们将上述的四个表转换为实体类，当某一个类要持有对方时，它要为对方设置单一属性还是 List 属性来判断两者关系。
例如 Order 类要持有 Address 类时，它只需要定义一个属性 private Address address; 就可以了，这是 Order 对于 Address 就是一对一的关系；再如，Order 类要持有 Goods 则需要为其定义一个列表 private List<Goods> goodsList; 才可以，这时Order 对于 Goods 就是一对多的关系。
Foxnic-SQL 要求尽可能分析清楚这些实体之间的关系，并配置到系统中，最终形成一个实体关系的大地图，当我们定义清楚A持有B所需要的属性类型，我们同时也就是构建了一个全局的对象模型，如图所示：
下面，我们用下单的这个例子，来系统说明 Foxnic-SQL 是如何完成关系搭建与模型的 Join。
生成表结构元数据
要使表之间的关系可以在 Java 代码中可配置，那就必须可以在 Java 代码中可以引用到表。所以，第一步的工作就是将数据表对象化，Foxnic-SQL 的代码生成模块已经实现了这部分工作，我只要做一些简单的配置即可完成调用生成 Java 形式的表结构，代码如下：
1package com.leefj.foxnic.sql.demo.generator; 2 3import com.github.foxnic.dao.spec.DAO; 4import com.github.foxnic.generator.builder.constants.DBMetaClassFile; 5import com.leefj.foxnic.sql.demo.config.DBInstance; 6 7public class ExampleDBMetaGenerator { 8 /** 9* 运行main函数生成代码 10* */ 11 public static void main(String[] args) throws Exception { 12 ExampleDBMetaGenerator g = new ExampleDBMetaGenerator(); 13 g.buildDBMeta(); 14 } 15 /** 16* 生成DBMeta数据 17* */ 18 private void buildDBMeta() { 19 // 初始化 DAO 对象 20 DAO dao= DBInstance.DEFAULT.dao(); 21 // 初始化全局设置 22 GeneratorUtil.initGlobalSettings(); 23 // 初始化 DBMetaClassFile 构建器 24 DBMetaClassFile dbMetaBuilder=new DBMetaClassFile(dao,GeneratorUtil.getProject(), "com.leefj.foxnic.sql.demo.config","ExampleTables"); 25 // 过滤与排除不需要的表 26 dbMetaBuilder.setTableFilter(table->{ 27 table=table.toLowerCase(); 28 // 仅生成以 example_ 开头的表 29 if(table.startsWith("example_")) return true; 30 return false; 31 }); 32 // 保存为 Java 代码 33 dbMetaBuilder.save(true); 34 } 35}
运行 main 函数，将生成 com.leefj.foxnic.sql.demo.config.db.ExampleTables 类，这个类包含了相关业务表的表结构信息。由于代码较多此处不做展示，可签出完整项目 https://gitee.com/LeeFJ/foxnic-samples 查看。
生成基础实体
所谓生成基础实体就是完全按照表结构生成实体类，每个表按默认的命名转换器生成实体，对应的表字段则生成相应的类的成员属性。
1package com.leefj.foxnic.sql.demo.generator; 2 3import com.github.foxnic.commons.project.maven.MavenProject; 4import com.github.foxnic.dao.spec.DAO; 5import com.github.foxnic.generator.builder.model.PoClassFile; 6import com.github.foxnic.generator.config.ModuleContext; 7import com.github.foxnic.sql.meta.DBTable; 8import com.leefj.foxnic.sql.demo.config.DBInstance; 9import com.leefj.foxnic.sql.demo.config.db.ExampleTables; 10 11/** 12* 实体类生成器 13* */ 14public class EntityGenerator { 15 public static interface Config { 16 void config(PoClassFile poType); 17 } 18 19 private static final String BASE_PACKAGE = "com.leefj.foxnic.sql.demo.app"; 20 21 /** 22* 需要首先运行 ExampleDBMetaGenerator 生成 ExampleTables 类 23* */ 24 public static void main(String[] args) { 25 EntityGenerator generator = new EntityGenerator(); 26 // 生成商品实体类 27 generator.generate(ExampleTables.EXAMPLE_GOODS.$TABLE); 28 // 生成订单实体类 29 generator.generate(ExampleTables.EXAMPLE_ORDER.$TABLE); 30 // 生成订单明细实体类 31 generator.generate(ExampleTables.EXAMPLE_ORDER_ITEM.$TABLE); 32 // 生成地址实体类 33 generator.generate(ExampleTables.EXAMPLE_ADDRESS.$TABLE); 34 } 35 /** 36 * 按表生成 37 * */ 38 public void generate(DBTable table) { 39 generate(table,null); 40 } 41 /** 42 * 按表生成 43 * */ 44 public void generate(DBTable table,Config config) { 45 DAO dao = DBInstance.DEFAULT.dao(); 46 MavenProject project = GeneratorUtil.getProject(); 47 String pkg = table.name().split("_")[0]; 48 String prefix = pkg + "_"; 49 ModuleContext context = new ModuleContext(GeneratorUtil.initGlobalSettings(),table,prefix,BASE_PACKAGE + "." + pkg); 50 context.setDomainProject(project); 51 context.setServiceProject(project); 52 context.setDAO(dao); 53 if(config!=null) { 54 config.config(context.getPoClassFile()); 55 } 56 context.buildPo(); 57 context.buildVo(); 58 context.buildService(); 59 } 60}
运行 main 方法将生成实体类代码，以上代码生成 PO、VO 对象以及这些类型对应的元数据类型，代码生成后如图所示：
加入扩展属性
下面我们要为这些实体类加入扩展属性，正如我们刚刚在上文中分析的那样，Order 类要持有 Address 类时，需要定义一个属性 private Address address; Order 类要持有 Goods 则需要为其定义一个列表 private List<Goods> goodsList; 才可以。我们修改上一步中的 EntityGenerator 类，调整 main 方法如下：
1/** 2* 需要首先运行 ExampleDBMetaGenerator 生成 ExampleTables 类 3* */ 4public static void main(String[] args) { 5 EntityGenerator generator = new EntityGenerator(); 6 // 生成商品实体类 7 generator.generate(ExampleTables.EXAMPLE_GOODS.$TABLE, poType -> { 8 // Goods 对象 通过 orderList 属性持有 Order 9 poType.addListProperty(Goods.class,"orderList","订单明细商品","订单明细商品"); 10 // Goods 对象 通过 addressList 属性持有 Address 11 poType.addListProperty(Address.class,"addressList","收件地址","收件地址，包括收件人以及手机号码"); 12 // Goods 对象 通过 itemList 属性持有 OrderItem 13 poType.addListProperty(OrderItem.class,"itemList","订单明细","订单明细"); 14 }); 15 // 生成订单实体类 16 generator.generate(ExampleTables.EXAMPLE_ORDER.$TABLE , poType -> { 17 // Order 对象 通过 goodsList 属性持有 Goods 18 poType.addListProperty(Goods.class,"goodsList","订单明细商品","订单明细商品"); 19 // Order 对象 通过 address 属性持有 Address 20 poType.addSimpleProperty(Address.class,"address","收件地址","收件地址，包括收件人以及手机号码"); 21 // Order 对象 通过 itemList 属性持有 OrderItem 22 poType.addListProperty(OrderItem.class,"itemList","订单明细","订单明细"); 23 }); 24 // 生成订单明细实体类 25 generator.generate(ExampleTables.EXAMPLE_ORDER_ITEM.$TABLE, poType -> { 26 // OrderItem 对象 通过 goodsList 属性持有 Goods 27 poType.addSimpleProperty(Goods.class,"goods","订单明细商品","订单明细商品"); 28 // OrderItem 对象 通过 address 属性持有 Address 29 poType.addSimpleProperty(Address.class,"address","收件地址","收件地址，包括收件人以及手机号码"); 30 // OrderItem 对象 通过 order 属性持有 Order 31 poType.addListProperty(Order.class,"order","订单","订单"); 32 }); 33 // 生成地址实体类 34 generator.generate(ExampleTables.EXAMPLE_ADDRESS.$TABLE, poType -> { 35 // Address 对象 通过 goodsList属性 持有 Goods 36 poType.addListProperty(Goods.class,"goodsList","订单明细商品","订单明细商品"); 37 // Address 对象 通过 orderList 持有 Order 38 poType.addListProperty(Address.class,"orderList","收件地址","收件地址，包括收件人以及手机号码"); 39 // Address 对象 通过 itemList 持有 OrderItem 40 poType.addListProperty(OrderItem.class,"itemList","订单明细","订单明细"); 41 }); 42}
通过上面的代码，我们定义了任意对象如果要持有对方时需要定义的属性。当然，这些定义的属性中有部分没有实际的业务意义，我没这里仅仅是从技术角度来说明对象之间关联属性的定义方法。再次运行
注意，代码生成并非只是本文中展示的一种范式，小伙伴们可按需要自行实现。
配置关联关系
前面的步骤，我们生成了实体类以及实体类的扩展属性，有了扩展属性后我们要为这些扩展属性配置好关联关系。关联关系在 ExampleRelationManager 类中配置，如下代码所示：
1import com.github.foxnic.dao.relation.RelationManager; 2import com.leefj.foxnic.sql.demo.app.domain.example.meta.AddressMeta; 3import com.leefj.foxnic.sql.demo.app.domain.example.meta.GoodsMeta; 4import com.leefj.foxnic.sql.demo.app.domain.example.meta.OrderItemMeta; 5import com.leefj.foxnic.sql.demo.app.domain.example.meta.OrderMeta; 6import com.leefj.foxnic.sql.demo.config.db.ExampleTables; 7 8public class ExampleRelationManager extends RelationManager { 9 10 @Override 11 protected void config() { 12 this.setupOrder(); 13 } 14 15 public void setupOrder() { 16 // 以下是 Order 扩展属性的关联关系配置 17 // Order.address 属性通过 EXAMPLE_ORDER.ADDRESS_ID 字段关联到 EXAMPLE_ADDRESS.ID 字段 18 this.property(OrderMeta.ADDRESS_PROP) 19 .using(ExampleTables.EXAMPLE_ORDER.ADDRESS_ID).join(ExampleTables.EXAMPLE_ADDRESS.ID) 20 // 由于订单地址不常变动，可以开启缓存 21 .cache(true); 22 23 // Order.goodsList 属性通过 EXAMPLE_ORDER.ID 字段关联到 EXAMPLE_ORDER_ITEM.ORDER_ID 字段 24 // 再通过 EXAMPLE_ORDER_ITEM.GOODS_ID 字段关联到 EXAMPLE_GOODS.ID 字段 25 this.property(OrderMeta.GOODS_LIST_PROP) 26 .using(ExampleTables.EXAMPLE_ORDER.ID).join(ExampleTables.EXAMPLE_ORDER_ITEM.ORDER_ID) 27 .using(ExampleTables.EXAMPLE_ORDER_ITEM.GOODS_ID).join(ExampleTables.EXAMPLE_GOODS.ID) 28 // 订单一旦生成，订单明细不再变动，开启缓存 29 .cache(true); 30 31 // Order.itemList 属性通过 EXAMPLE_ORDER.ID 字段关联到 EXAMPLE_ORDER_ITEM.ORDER_ID 字段 32 this.property(OrderMeta.ITEM_LIST_PROP) 33 .using(ExampleTables.EXAMPLE_ORDER.ID).join(ExampleTables.EXAMPLE_ORDER_ITEM.ORDER_ID) 34 .cache(true); 35 36 // 以下是 OrderItem 扩展属性的关联关系配置 37 // OrderItem.order 属性通过 EXAMPLE_ORDER_ITEM.ORDER_ID 字段关联到 EXAMPLE_ORDER.ID 字段 38 this.property(OrderItemMeta.ORDER_PROP) 39 .using(ExampleTables.EXAMPLE_ORDER_ITEM.ORDER_ID).join(ExampleTables.EXAMPLE_ORDER.ID) 40 .cache(true); 41 42 // OrderItem.goods 属性通过 EXAMPLE_ORDER_ITEM.GOODS_ID 字段关联到 EXAMPLE_GOODS.ID 字段 43 this.property(OrderItemMeta.GOODS_PROP) 44 .using(ExampleTables.EXAMPLE_ORDER_ITEM.GOODS_ID).join(ExampleTables.EXAMPLE_GOODS.ID) 45 .cache(true); 46 47 48 // 以下是 Goods 扩展属性的关联关系配置 49 this.property(GoodsMeta.ORDER_LIST_PROP) 50 .using(ExampleTables.EXAMPLE_GOODS.ID).join(ExampleTables.EXAMPLE_ORDER_ITEM.GOODS_ID) 51 .using(ExampleTables.EXAMPLE_ORDER_ITEM.ORDER_ID).join(ExampleTables.EXAMPLE_ORDER.ID) 52 .cache(true); 53 54 this.property(GoodsMeta.ADDRESS_LIST_PROP) 55 .using(ExampleTables.EXAMPLE_GOODS.ID).join(ExampleTables.EXAMPLE_ORDER_ITEM.GOODS_ID) 56 .using(ExampleTables.EXAMPLE_ORDER_ITEM.ORDER_ID).join(ExampleTables.EXAMPLE_ORDER.ID) 57 .using(ExampleTables.EXAMPLE_ORDER.ADDRESS_ID).join(ExampleTables.EXAMPLE_ADDRESS.ID) 58 .cache(true); 59 60 this.property(GoodsMeta.ITEM_LIST_PROP) 61 .using(ExampleTables.EXAMPLE_GOODS.ID).join(ExampleTables.EXAMPLE_ORDER_ITEM.GOODS_ID) 62 .cache(true); 63 64 // 以下是 Address 扩展属性的关联关系配置 65 this.property(AddressMeta.ORDER_LIST_PROP) 66 .using(ExampleTables.EXAMPLE_ADDRESS.ID).join(ExampleTables.EXAMPLE_ORDER.ADDRESS_ID) 67 .cache(true); 68 69 this.property(AddressMeta.ITEM_LIST_PROP) 70 .using(ExampleTables.EXAMPLE_ADDRESS.ID).join(ExampleTables.EXAMPLE_ORDER.ADDRESS_ID) 71 .using(ExampleTables.EXAMPLE_ORDER.ID).join(ExampleTables.EXAMPLE_ORDER_ITEM.ORDER_ID) 72 .cache(true); 73 74 this.property(AddressMeta.GOODS_LIST_PROP) 75 .using(ExampleTables.EXAMPLE_ADDRESS.ID).join(ExampleTables.EXAMPLE_ORDER.ADDRESS_ID) 76 .using(ExampleTables.EXAMPLE_ORDER.ID).join(ExampleTables.EXAMPLE_ORDER_ITEM.ORDER_ID) 77 .using(ExampleTables.EXAMPLE_ORDER_ITEM.GOODS_ID).join(ExampleTables.EXAMPLE_GOODS.ID) 78 .cache(true); 79 } 80}
同样，我们在关系配置中几乎配置了所有的两两关系，当然某些关系并没有业务意义，仅做技术展示。关系配置时还可以有其它更多的控制，例如额外的条件、排序等，请小伙伴们自行探索。
通过Service拉取模型
通过之前的代码生成，不仅生成的PO、VO类，同时也生成了 Service 类，通过 DBInstance 可以拿到这个 Service 对象，若是在 Web 环境下，直接使用 Spring 的依赖注入即可拿到 Service 对象。通过 Service 拉取模型的示例代码如下：
1/** 2* 通过 Service 的 Join 方法完成属性数据的填充操作 3* */ 4@Test 5public void demo_1() { 6 // 获得 Service 7 IOrderService orderService=DBInstance.DEFAULT.getService(OrderServiceImpl.class); 8 // 查询所有订单 9 List<Order> orders= orderService.queryList(new Order()); 10 // 填充订单属性 11 orderService.join(orders, OrderMeta.ADDRESS,OrderMeta.ITEM_LIST,OrderMeta.GOODS_LIST); 12 // 输出填属性填充后的订单列表 13 System.out.println(JSONUtil.format(JSONUtil.toJSONArray(orders))); 14}
以上代码首先查询了订单列表，此时获得的订单列表并未填充扩展属性值，在调用 Service 的 join 方法，指定需要 Join 的属性名称即可。
Service 的 join 方法事实上是间接调用了 DAO 的 join 方法，本例中 join 了三个属性，这三个属性的查询与 join 过程并非顺序执行的，而是利用了 java 的 fork...join 框架进行了并行操作。join 过程中会有一个输出，如下所示：
JOIN(DATA) FORK(21):128 , el=7 >>>
Order :: List<Goods> goodsList , properties : id , route example_order to example_goods
example_order_item( goods_id ) = example_goods( id )
第一行的 JOIN(DATA) 是指当前的 join 操作是数据操作，另外还有一种 JOIN(SEARCH)，在数据搜索时用到，吗这里不做展开。FORK(21):128，其中 21 是指线程ID，128 是指 fork 时拆分的行数。这里是指如果 orders 的元素个数超过128，那么就按128的规格进行 frok 任务拆解。 el=7 是指当前 orders 实际数量是7个。
Order :: List<Goods> goodsList 是指当前正在处理 Order 类的 goodsList 属性， properties : id 是指关联的起始属性是 Order.id , route example_order to example_goods 是指从 example_order 表路由到 example_goods 表。example_order_item( goods_id ) = example_goods( id ) 展示了本次 join 的关联关系。这些关联关系我们在 ExampleRelationManager 类里做了配置。
最后，我们可以在 SQL 日志上看到 join 最终执行的SQL语句：
┏━━━━━ SQL [ SELECT t_0.* , t_1.order_id join_f0 , t_0.id join_fs_example_goods_sf_nioj_id ... ] ━━━━━
┣ 语句：SELECT t_0.* , t_1.order_id join_f0 , t_0.id join_fs_example_goods_sf_nioj_id , t_0.id pk_join_fs_example_goods_sf_nioj_id , t_1.goods_id join_fs_example_order_item_sf_nioj_goods_id , t_1.order_id join_fs_example_order_item_sf_nioj_order_id , t_1.id pk_join_fs_example_order_item_sf_nioj_id FROM (select * from example_goods WHERE ( deleted= ? ) ) t_0
join (select * from example_order_item WHERE ( deleted= ? ) ) t_1 on t_1.goods_id = t_0.id
WHERE t_1.order_id IN ( ? , ? , ? , ? , ? , ? , ? ) AND t_1.deleted= ?
┣ 参数：{"PARAM_1":0,"PARAM_9":"651345265944428544","PARAM_8":"651017423926853632","PARAM_10":0,"PARAM_7":"583188757629370368","PARAM_6":"651024562955223040","PARAM_5":"651017546694131712","PARAM_4":"583028022102200320","PARAM_3":"651024388312793088","PARAM_2":0}
┣ 执行：SELECT t_0.* , t_1.order_id join_f0 , t_0.id join_fs_example_goods_sf_nioj_id , t_0.id pk_join_fs_example_goods_sf_nioj_id , t_1.goods_id join_fs_example_order_item_sf_nioj_goods_id , t_1.order_id join_fs_example_order_item_sf_nioj_order_id , t_1.id pk_join_fs_example_order_item_sf_nioj_id FROM (select * from example_goods WHERE ( deleted= 0 ) ) t_0
join (select * from example_order_item WHERE ( deleted= 0 ) ) t_1 on t_1.goods_id = t_0.id
WHERE t_1.order_id IN ( '651024388312793088' , '583028022102200320' , '651017546694131712' , '651024562955223040' , '583188757629370368' , '651017423926853632' , '651345265944428544' ) AND t_1.deleted= 0
┣ 结果：
┣━ 耗时：84ms , start = 1672796438302
┣━ 返回：RcdSet,size=2
┣ TID：null
┗━━━━━ SQL [ SELECT t_0.* , t_1.order_id join_f0 , t_0.id join_fs_example_goods_sf_nioj_id ... ] ━━━━━
通过DAO拉取模型
DAO 本身也有 join 方法，用法和 Service 的 join 方法相似，这里不做展开。本例中，我们使用 DAO 的 fill...with 方法拉取模型。
1/** 2* 通过 DAO 对象的 fill...with 方法完成属性数据的填充 3* */ 4@Test 5public void demo_2() { 6 // 获得 Service 7 IOrderService orderService=DBInstance.DEFAULT.getService(OrderServiceImpl.class); 8 // 查询所有订单 9 List<Order> orders= orderService.queryList(new Order()); 10 DAO dao=orderService.dao(); 11 // 通过 dao 的 fill 方法填充 orders 列表里面元素的扩展属性 12 dao.fill(orders) 13 // 填充 orders 里面每个元素的 address 属性 14 .with(OrderMeta.ADDRESS) 15 // 填充 orders 里面每个元素的 itemList 属性 16 .with(OrderMeta.ITEM_LIST) 17 // 填充 orders 里面每个元素的 goodsList 属性 18 .with(OrderMeta.GOODS_LIST) 19 // 执行最终的 join 操作 20 .execute(); 21 // 输出填属性填充后的订单列表 22 System.out.println(JSONUtil.format(JSONUtil.toJSONArray(orders))); 23}
通过还可以进一步拉取级联模型：
1/** 2* 通过 DAO 对象的 fill...with 方法完成属性数据的级联填充 3* */ 4@Test 5public void demo_3() { 6 // 获得 Service 7 IOrderService orderService=DBInstance.DEFAULT.getService(OrderServiceImpl.class); 8 // 查询所有订单 9 List<Order> orders= orderService.queryList(new Order()); 10 DAO dao=orderService.dao(); 11 // 通过 dao 的 fill 方法填充 orders 列表里面元素的扩展属性 12 dao.fill(orders) 13 // 填充 orders 里面每个元素的 address 属性，并填充 address 属性的 orderList 属性 14 .with(OrderMeta.ADDRESS,AddressMeta.ORDER_LIST) 15 // 填充 orders 里面每个元素的 address 属性，并填充 address 属性的 goodsList 属性 16 .with(OrderMeta.ADDRESS,AddressMeta.GOODS_LIST) 17 // 填充 orders 里面每个元素的 itemList 属性 18 .with(OrderMeta.ITEM_LIST) 19 // 填充 orders 里面每个元素的 goodsList 属性 20 .with(OrderMeta.GOODS_LIST) 21 // 执行最终的 join 操作 22 .execute(); 23 // 输出填属性填充后的订单列表 24 System.out.println(JSONUtil.format(JSONUtil.toJSONArray(orders))); 25}
刻画模型
通过上面的两个示例，我们注意到，我们在拉取对象时，并未指定字段，这样就会拉出多余的字段，为了精确刻画需要拉取的模型字段，我们可以为 fill...with 指定 fields , 如下代码所示：
1/** 2* 通过 DAO 对象的 fill...with 方法完成属性数据的填充，并用 fields 指定查询字段 3* */ 4@Test 5public void demo_4() { 6 // 获得 Service 7 IOrderService orderService=DBInstance.DEFAULT.getService(OrderServiceImpl.class); 8 // 查询所有订单 9 List<Order> orders= orderService.queryList(new Order()); 10 DAO dao=orderService.dao(); 11 // 构建 Order 对象需要查询的字段 12 FieldsBuilder orderFields=FieldsBuilder.build(dao, ExampleTables.EXAMPLE_ORDER.$TABLE); 13 orderFields.addAll().removeDBTreatyFields(); 14 // 构建 address 对象需要的字段 15 FieldsBuilder addressFields=FieldsBuilder.build(dao, ExampleTables.EXAMPLE_ADDRESS.$TABLE); 16 addressFields.addAll().removeDBTreatyFields(); 17 // 通过 dao 的 fill 方法填充 orders 列表里面元素的扩展属性 18 dao.fill(orders) 19 // 填充 orders 里面每个元素的 address 属性 20 .with(OrderMeta.ADDRESS) 21 // 填充 orders 里面每个元素的 itemList 属性 22 .with(OrderMeta.ITEM_LIST) 23 // 填充 orders 里面每个元素的 goodsList 属性 24 .with(OrderMeta.GOODS_LIST) 25 // 指定字段 26 .fields(orderFields,addressFields) 27 // 执行最终的 join 操作 28 .execute(); 29 // 输出填属性填充后的订单列表 30 System.out.println(JSONUtil.format(JSONUtil.toJSONArray(orders))); 31}
模型装配的原则
从整个示例的过程，大家注意到，示例中的绝大多是代码是生成的，在代码生成的基础上，我们配置两个对象之间的引用关系和关联关系。
Foxnic-SQL 的模型构建过程是按需拉取的，不同接口需要不同的数据，开发人员通过 Service 的 join 方法或 DAO 的 fill...with 方法手动指定本次要拉取的属性范围，使拉取过程更加符合接口要求。
事实上，引用关系和关联关系在一个系统中一般都是固定的，唯一不同的是在不同的场合拉取模型的范围，这个由开发人员控制，更加灵活方便。
小结
本节主要介绍了在 Foxni-SQL 中使用 join 方法填充对象模型。基本步骤包括，生成数据库表元数据、生成 PO、VO、Service 代码、配置关联关系、使用 Service 或 DAO 完成模型装配。
相关项目
https://gitee.com/LeeFJ/foxnic
https://gitee.com/LeeFJ/foxnic-web
https://gitee.com/LeeFJ/foxnic-samples