更新 llms-full.txt

This commit is contained in:
oyo
2025-08-07 12:32:34 +08:00
parent b0d1c9e402
commit 35fc099370

View File

@@ -1070,7 +1070,7 @@ DateTime endTime //会议结束时间
}
```
- **代码产物和修改建议**
- **Service:**
- **BOService:**
* **生成产物:** 在对应的聚合服务BOService里生成一个函数
* **函数命名规则:** 和写方案同名
* **职责:** 按需对入参进行转换调用BaseBOService里的函数完成对聚合对象的操作, 实现对数据库的写操作;
@@ -1171,7 +1171,7 @@ DateTime endTime //会议结束时间
c. 如果流程过于复杂,优先考虑使用基本类型参数
#### **2.13 服务层方法 (RPC)**
- **定义与用途:** 在TOCO中RPC为服务层的方法。RPC按照可见性可以分为两种一种是公开RPC可以被其他模块订阅订阅后可以通过RPC适配器进行调用另一种是非公开RPC只能被当前模块调用。非公开RPC可以被公开从而被其他模块订阅并调用
- **如何创建/生成:** RPC有4种创建方式a.DTO创建后会自动创建RPCRPC的公开性与DTO的公开性保持一致b.返回DTO的读方案会根据分页情况、以及是否生成计数函数的配置自动生成非公开的RPC c.写方案创建后会自动生成非公开的RPC d.如果上述三种RPC无法满足需求则可以通过TOCO创建自定义RPC完整指定功能需指定具体的参数和返回值以及公开性等。
- **如何创建/生成:** RPC有4种创建方式a.DTO创建后会自动创建RPCRPC的公开性与DTO的公开性保持一致b.返回DTO的读方案会根据分页情况、以及是否生成计数函数的配置自动生成非公开的RPC c.写方案创建后会自动生成非公开的RPC,返回值为操作的聚合根实体记录的主键字段的值 d.如果上述三种RPC无法满足需求则可以通过TOCO创建自定义RPC完整指定功能需指定具体的参数和返回值以及公开性等。
- **优先复用:** 当用户需要创建一个RPC时如果用户有明确要求创建的方式则按照用户的要求来创建。如果没有明确要求则通常先判断是否可以通过创建读方案、写方案、DTO来使TOCO自动创建出对应的RPC最后再考虑通过TOCO创建自定义RPC
- **自定义RPC和代码中手写方法的关系** 二者都可以通过手动的方式实现一个服务层的方法应用场景的区别在于如果一个方法需要被其他模块订阅则通常使用自定义RPC如果一个方法只是某个API私有调用不需要给外部模块开放则可以使用代码手写方法
- **关键配置:** 类名(驼峰首字母大写以Service结尾)、是否公开、方法名(驼峰,首字母小写)、请求参数、返回值。注意如果一个RPC是分页查询且参数为Qto类型则Qto中已经包含了分页所需的from、size、scrollId等属性无需额外为RPC增加类似参数。