From de30f67e50400a85a564e333aee8acb80af6cd6b Mon Sep 17 00:00:00 2001 From: oyo Date: Mon, 11 Aug 2025 18:19:46 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20llms-full.txt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- llms-full.txt | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/llms-full.txt b/llms-full.txt index afbfc2d..a2258bc 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -42,11 +42,11 @@ * **唯一标识符位置：** 其对应的唯一标志在类注解@AutoGenerated中指定 ,uuid规则: ${Enum在TOCO中的uuid}|ENUM|DEFINITION - **生成代码：** Enum会在common层生成Enum文件，如StatusEnum - **修改建议：** 不建议修改 -#### **2.3 值对象 (Eo)** +#### **2.3 值对象 (EO)** - **定义与用途:** EO为一种POJO对象结构，可被其他模块使用，可被用来做为实体字段的类型。 - **关键属性/配置:** 名称(以_eo结尾,全局唯一)。EO的字段类型只能为基本类型（含List）、EO、Enum，其他类型不允许。 -- **与其他元素关系:** 可以作为其他对象（Entity、Dto、Vo、Bto、Qto)的字段类型使用，同时一个Eo中可以嵌套其他EO作为字段类型。 -- **Eo设计元素的表达:** +- **与其他元素关系:** 可以作为其他对象（Entity、Dto、Vo、Bto、Qto)的字段类型使用，同时一个EO中可以嵌套其他EO作为字段类型。 +- **EO设计元素的表达:** - 以Json格式表达，Json Schema定义及如下 ```json { @@ -57,7 +57,7 @@ "uuid":{ "type": "string", "description": "该设计在TOCO中的唯一标识符，在创建EO的时候，该字段为空; 在更新时，该字段不能为空"}, "moduleName":{ "type": "string", "description": "指定该设计元素所属的模块，在创建的时候该字段不能为空，在更新的时候，该字段可以为空"}, "fieldList":{ - "type":"array", "description": "定义Eo的属性字段列表", + "type":"array", "description": "定义EO的属性字段列表", "items":{ "type": "object", "properties":{ @@ -1154,7 +1154,7 @@ DateTime endTime； //会议结束时间 #### **2.12 业务变更传输对象(BTO)** - **定义与用途:** 在TOCO中，BTO为写方案自动生成的参数结构，每个写方案会生成一个BTO。BTO为写方案选定的操作实体根据关系形成的树形集合，最外层为聚合根。写方案调用方按照BTO的结构向写方案生成的RPC方法传入需要操作的实体字段值，完成对数据库的写操作 -- **如何创建/生成:** 在创建写方案后，TOCO会自动生成一个BTO作为该写方案传入的参数结构，无需通过TOCO创建。 +- **如何创建/生成:** BTO只能由写方案自动创建，不能单独新建任何BTO。在创建写方案后，TOCO会自动生成一个BTO作为该写方案传入的参数结构。 - **关键配置:** 名称（${WritePlanName}Bto，驼峰展示），嵌套的树形实体和字段列表，BTO内部的字段全部都来自Entity。以下为一个示例： ``` class CreateUserBto { //对应实体user @@ -1168,8 +1168,8 @@ DateTime endTime； //会议结束时间 ``` - **与API的关系:** BTO通常可作为API的参数，API接收到参数后可直接透传给内部的RPC进行调用，注意BTO只用作写操作的参数，**禁止用作查询参数结构** - **复杂场景处理：** 对于涉及多个写方案的复杂API，可以： - a. 如果接口有一个主要的写场景，则创建一个主要的写方案，让其自动生成的BTO作为API入参，然后再增加其他基本类型的参数或EO - b. 使用基本类型参数或EO，在接口执行流程中将基本类型参数转换为各个写方案自动生成的BTO + a. 如果接口有一个主要的写场景，则创建一个主要的写方案，让其自动生成的BTO作为API参数，然后再增加其他基本类型的参数或EO + b. 使用基本类型参数或EO作为参数，在接口执行流程中将基本类型参数转换为各个写方案自动生成的BTO，再调用多个写方案 c. 如果流程过于复杂，优先考虑使用基本类型参数或EO #### **2.13 服务层方法 (RPC)** - **定义与用途:** 在TOCO中，RPC为服务层的方法。RPC按照可见性可以分为两种，一种是公开RPC，可以被其他模块订阅，订阅后可以通过RPC适配器进行调用；另一种是非公开RPC，只能被当前模块调用。非公开RPC可以被公开，从而被其他模块订阅并调用