toco/docs
Archived
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新 llms-full.txt

Browse Source
This commit is contained in:
ycl
2025-07-22 15:53:22 +08:00
parent 8e6968c27c
commit 2e396f0100
1 changed files with 2 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
llms-full.txt
View File

@@ -1340,8 +1340,9 @@ requestParams为请求参数列表，response为返回结构，requestParams中
- 根据**设计元素到代码的映射规则及修改建议**，在约读代码的时候，你可以识别出对应的TOCO设计元素，通过工具获取TOCO设计元素信息，辅助理解代码语义，特别是对于ReadPlan，WritePlan的设计元素 - 根据**设计元素到代码的映射规则及修改建议**，在约读代码的时候，你可以识别出对应的TOCO设计元素，通过工具获取TOCO设计元素信息，辅助理解代码语义，特别是对于ReadPlan，WritePlan的设计元素
- 读取类文件时，应该同时读取继承的基类文件（但注意不要去阅读BaseBOService里的代码） - 读取类文件时，应该同时读取继承的基类文件（但注意不要去阅读BaseBOService里的代码）
- 不要去读VoConverter、DtoConverter、 BaseDtoConverter、BaseVoConverter的代码 - 不要去读VoConverter、DtoConverter、 BaseDtoConverter、BaseVoConverter的代码
- 如果一个类或者一个函数上面有@AutoGenerate的注解，说明该函数、该类是由TOCO设计元素生成的，你需要使用工具`getItemDefinition`获取设计元素，辅助理解代码含义
#### 5.2 代码编写 #### 5.2 代码编写
- 遇到任何代码修改需求时，必须先检查是否为TOCO生成代码，如果是，则禁止直接修改源码内容，而必须通过修改TOCO设计元素完成 - 遇到任何代码修改需求时，必须先检查是否为TOCO生成的代码，如果是，则禁止直接修改源码内容，必须通过修改TOCO设计元素完成
- 对于校验规则，先判断是否为业务不变性规则，如果是，则将代码写在BO对象的聚合校验函数中即可实现校验功能，不需要在Controller或Service中单独调用校验方法。聚合校验函数中适合做内存中数据的规则校验，不适合做很重的外部存储数据的获取或RPC调用，乐观锁字段由系统维护，无需校验 - 对于校验规则，先判断是否为业务不变性规则，如果是，则将代码写在BO对象的聚合校验函数中即可实现校验功能，不需要在Controller或Service中单独调用校验方法。聚合校验函数中适合做内存中数据的规则校验，不适合做很重的外部存储数据的获取或RPC调用，乐观锁字段由系统维护，无需校验
- 编写代码前需仔细分析当前代码所属模块和其中需要调用的方法是否属于同一模块，特别注意**跨模块方法调用必须通过XxxRpcAdapterInXxx**，**禁止**直接使用其他模块的类名来调用，其通过@Resource注入的变量名必须为类名的首字母小写，如@Resource private UserServiceRpcAdapterInMeeting userServiceRpcAdapterInMeeting - 编写代码前需仔细分析当前代码所属模块和其中需要调用的方法是否属于同一模块，特别注意**跨模块方法调用必须通过XxxRpcAdapterInXxx**，**禁止**直接使用其他模块的类名来调用，其通过@Resource注入的变量名必须为类名的首字母小写，如@Resource private UserServiceRpcAdapterInMeeting userServiceRpcAdapterInMeeting
- 需要着重考虑单一职责原则、复用性，如Controller中更适合做参数校验及简单的不可复用的逻辑分支处理，不适合实现复杂的或通用的业务逻辑 - 需要着重考虑单一职责原则、复用性，如Controller中更适合做参数校验及简单的不可复用的逻辑分支处理，不适合实现复杂的或通用的业务逻辑