华为云用户手册

顶部工具栏 设计器顶部的工具栏从左到右包括： ：撤销上一步的操作。 ：恢复上次撤销的内容。 ：保存当前页面数据。 ：发布页面模板。 ：清空当前画布内容。 ：刷新当前页面数据，如果页面未保存，页面配置将恢复到上一次保存的状态。 ：单击后可展开左侧插件栏的设置插件，设置当前页面属性。 ：单击可进行画布中英文切换。 ：多终端工具切换，可切换画布宽度。 ：页面预览，打开新Tab预览当前页面。 下载源码：将当前页面数据转换并下载代码到本地。

操作步骤 进入购买Astro企业应用实例页面。 “实例规格”选择“基础版”，设置购买时长，单击“立即购买”。 图1 选择购买规格 确认订单无误后，单击“去支付”。 图2 确认订单 选择支付方式，单击“确认付款”，完成支付。 订单支付成功后，单击“返回Astro企业应用控制台”。 在Astro企业应用控制台中，可以查看到Astro企业应用的实例状态。当“实例状态”变为“运行中”时，说明实例已安装好，可以正常使用Astro企业应用。 图3 查看实例状态

代码结构说明 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 com.astropro |-- api # API层代码，定义向外部服务暴露的接口（必填项） {biz}Api.java # swagger注解 {biz}Controller.java # 输入参数非业务校验 |-- app # 应用层（必填项） |-- service # 应用服务层（必填项） I{biz}AppService.java # 应用服务接口定义（禁止改动） |-- impl {biz}Service.java # 返回值转换为dto |-- dto # 数据传输对象，用于接口层返回（必填项） {biz}Dto.java # 与BO一一对应 {customDto}.java # 自定义dto（禁止改动） |-- converter # bean转换器，用于BO和DTO转换 {biz}Converter.java # 与BO是一一对应关系 |-- consumer # 消费者（可选项） I{biz}Consumer.java {biz2}Handler.java |-- producer # 生产者（可选项） I{biz}Producer.java |-- scheduler # 定时任务（可选项） |-- domain # 领域层，包含基本的业务和业务聚合（必填项） |-- service I{biz}RepositoryService.java # 领域服务接口定义（devspore生成的持久化服务,禁止修改） I{biz}GatewayService.java # 网关服务接口 |-- impl {biz}DomainService.java # 自定义的领域服务实现 |-- entity # 该聚合下所有的实体、值对象 {biz}.java |-- model # qo、nested、cartesian |-- enums # 枚举类 |-- event # 领域事件实体定义 {xxx}Event.java |-- infra # 基础设施层 |-- repository # 数据操作聚合层，包含基类和继承类（必填项） |-- base # 数据操作聚合层基类代码（必填项） {biz}BaseRepository.java {biz}Repository.java # 数据操作聚合层继承类代码，并实现对应的domainService |-- mapper # 数据原子操作层。mapper层目录，包含基本接口和继承接口（必填项） |-- criteria # mybatis查询对象 |-- base # mapper层基本接口代码（必填项） {biz}BaseMapper.java {biz}Mapper.java # mapper层继承接口代码。用户可在此类中覆写基本接口中的方法或者增加自定义的方法 |-- integration # 防腐层，集成第三方服务（跨进程的外部服务），隔离外部系统的影响（可选项） GatewayService.java # 与领域服务层的I{biz}GatewayService.java一一对应 |-- mq # mq的具体实现，如kafka、rocketmq |-- common # 通用包 |-- config # 配置类（必填项） |-- utils # 工具类（必填项） |-- exception # 异常类（必填项） |-- filter # 过滤器（可选项） |-- interceptor

资源目录说明 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 resources |-- mapper # 开源组件mybatis的mapper.xml文件存放目录 |-- base # 该目录下的文件禁止用户改动 {biz}BaseMapper.xml {biz}Mapper.xml # 只在初次代码生成，用户可在此文件中实现自定义的方法 |-- openapi # swagger.yaml存放目录 swagger.yaml # swagger.yaml文件 application.yml # SpringBoot全局配置文件 banner.txt # 应用程序的banner文件 log4j2.xml # log4j2日志配置文件 metadata.json # 元数据配置文件

操作步骤 在业务设计页面，单击“脱敏规则”。 图1 选择脱敏规则 单击“新增”，添加一个脱敏规则。 例如，将移动电话的第2位到第5位数字进行脱敏处理。 图2 自定义脱敏规则 在对象的字段中，使用脱敏规则。 从“business”中，拖拽“BO”对象至画布空白区域。 选中BO对象，在对象属性中，单击“编辑字段”。 单击“新增”，添加一个phone字段，并将脱敏规则设置为2中定义的内容。 设置后，返回的值将进行脱敏处理，如1****123456。 图3 引用脱敏规则

使用说明 AstroPro为每个项目预置了项目管理员、架构师和开发者三种类型的角色。 项目管理员 可以增删改査项目下的所有资源。 可以为项目下的所有角色分配用户（仅限于同账号下的用户，如图1中的 IAM 用户1、IAM用户2）。 图1 华为账号与IAM用户 架构师 可以新建服务。 可以删除本人创建的服务，不能删除其他人创建的服务。 可以对项目下的所有服务进行编辑。 开发者 可以查看项目下的所有资源。 可以重新编译有权限项目下的服务并下载代码。

前提条件 只有工作空间管理员或项目管理员，才能为其他用户添加项目级角色。不同的是具备工作空间管理员权限的用户，可以为用户添加工作空间下所有项目的权限。而项目管理员只能为用户添加其所在项目的角色权限。 待添加的IAM用户已创建（如IAM用户2）。如何创建IAM用户，请参见创建IAM用户。 IAM用户（如IAM用户1）必须已添加到用户组admin或group。加入用户组后，用户才会具备用户组的权限。若不加入用户组，登录AstroPro服务时，会提示您没有当前服务的访问权限。 admin：缺省用户组，具有所有云服务资源的操作权限。将用户加入该用户组后，用户可以操作并使用所有云服务资源。如果您创建的IAM用户是管理员，才需要将其加入默认用户组“admin”中。 group：自定义的用户组，如何创建一个用户组，请参见创建用户组并授权。自定义用户组时，必须为用户组添加“Astro Pro FullAccess”和“Astro Pro InstanceManagement”系统策略，如图3。 图2 通过用户组为用户授权 图3 自定义用户组必须具备权限

前提条件 只有具备工作空间管理员权限的用户，才能为其他用户添加工作空间级角色。 待添加的IAM用户已创建（如IAM用户1）。如何创建IAM用户，请参见创建IAM用户。 IAM用户（如IAM用户1）必须已添加到用户组admin或group。加入用户组后，用户才会具备用户组的权限。若不加入用户组，登录AstroPro服务时，会提示您没有当前服务的访问权限。 admin：缺省用户组，具有所有云服务资源的操作权限。将用户加入该用户组后，用户可以操作并使用所有云服务资源。如果您创建的IAM用户是管理员，才需要将其加入默认用户组“admin”中。 group：自定义的用户组，如何创建一个用户组，请参见创建用户组并授权。自定义用户组时，必须为用户组添加“Astro Pro FullAccess”和“Astro Pro InstanceManagement”系统策略，如图2。 图1 通过用户组为用户授权 图2 自定义用户组必须具备权限

工作空间管理员 账号登录AstroPro后会自动开通工作空间，每个账号只能开通一个工作空间，开通工作空间的账号默认为此空间的工作空间管理员。工作空间管理员对本工作空间下的所有资源具有增删改查权限，可以为本账号下用户分配项目下的角色。每个工作空间至少拥有一个工作空间管理员。 账号是指当您首次使用华为云时注册的账号，该账号是您的华为云资源归属、资源使用计费的主体，对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。账号统一接收所有IAM用户进行资源操作时产生的费用账单。在一个账号下，您可以创建多个用户，账号和用户的关系如图1所示。如果您没有华为账号，可参考 注册华为账号 并开通华为云中操作注册。如何在账号中添加用户，请参见创建IAM用户。 账号下的用户，如果没有分配任何AstroPro中的角色，则只能查看工作空间下的所有资源，不具备其他权限。 例如，给“IAM用户1”赋予工作空间管理员权限，给“IAM用户2”赋予项目A中的项目管理员权限，则“IAM用户1”可以增删改查本工作空间下的所有资源，“IAM用户2”仅可对工作空间中的项目A执行增删改査等操作，而“IAM用户3”未赋予任何角色，则只能查看本工作空间下的资源。

AstroPro角色说明 不同的角色，操作权限有所不同，AstroPro常用操作与角色之间的关系如表1所示，您可以按需申请您的角色权限。 如果您申请的新权限低于您当前的权限级别，系统将只保留一个角色权限，即新申请的权限会覆盖现有的权限。因此，在您决定更换权限之前，建议您仔细了解并比较您当前的权限设置与新申请权限之间的具体差异。 表1 AstroPro常用操作与角色之间的关系 操作 工作空间管理员 项目管理员 架构师 开发者 其他（未授权） 新增项目 √ x x x x 编辑项目 √ x x x x 删除项目 √ x x x x 新增服务组 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 编辑服务组 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 删除服务组 √（工作空间中所有项目） √（工作空间中指定项目内） √（只允许删除自己创建的服务组） x x 新增服务 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 编辑服务 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 新增服务版本 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 复制服务 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 删除服务 √（工作空间中所有项目） √（工作空间中指定项目内） √（只允许删除自己创建的服务） x x 新增服务依赖 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 删除服务依赖 √（工作空间中所有项目） √（工作空间中指定项目内） √（仅自己创建的服务依赖） x x 重新生成代码并下载 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） √（工作空间中指定项目内） x 查看服务详情 √ √ √ √ √ 查看变更记录 √ √ √ √ √ 申请角色 √ √ √ √ √ 撤回申请 √（仅撤回自己的申请） √（仅撤回自己的申请） √（仅撤回自己的申请） √（仅撤回自己的申请） √（仅撤回自己的申请） 审批角色 √（工作空间中所有项目） √（工作空间中指定项目内） x x x 删除角色 √（工作空间中所有项目） √（工作空间中指定项目内） x x x 创建前台应用 √ √ √ √ x 开发前台应用 √ √ √ √ x 删除前台应用 √ √ √ √ x 下载前端业务代码 √ √ √ √ √ 查看前台应用 √ √ √ √ √ 发布页面模板 √ √ √ √ x 删除页面模板 √ √ √ √ x 新增架构模板 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 修改架构模板 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 删除架构模板 √（工作空间级及所有项目） √（工作空间中指定项目） √（只允许删除自己创建的模板） x x 查看架构模板 √ √ √ √ √ 新增业务对象模板 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 修改业务对象模板 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 删除业务对象模板 √（工作空间级及所有项目） √（工作空间中指定项目） √（只允许删除自己创建的模板） x x 查看业务对象模板 √ √ √ √ √ 新增业务模块 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 修改业务模块 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 删除业务模块 √（工作空间级及所有项目） √（工作空间中指定项目） √（只允许删除自己创建的模块） x x 查看业务模块 √ √ √ √ √ 新增自定义字段 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 修改自定义字段 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 删除自定义字段 √（工作空间级及所有项目） √（工作空间中指定项目） √（只允许删除自己创建的自定义字段） x x 查看自定义字段 √ √ √ √ √ 新增流控策略 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 修改流控策略 √（工作空间级及所有项目） √（工作空间中指定项目） √（工作空间中指定项目） x x 删除流控策略 √（工作空间级及所有项目） √（工作空间中指定项目） √（只允许删除自己创建的流控策略） x x 查看流控策略 √ √ √ √ √ 新增应用 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 修改应用 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 同步应用 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 删除应用 √（工作空间中所有项目） √（工作空间中指定项目内） √（只允许删除自己创建的应用） x x 查看应用 √ √ √ √ √ 新增子域 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 修改子域 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 删除子域 √（工作空间中所有项目） √（工作空间中指定项目内） √（只允许删除自己创建的子域） x x 查看子域 √ √ √ √ √ 新增应用服务 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 修改应用服务 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 删除应用服务 √（工作空间中所有项目） √（工作空间中指定项目内） √（只允许删除自己创建的子域） x x 关联服务 √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 查看应用服务 √ √ √ √ √ 编辑服务SLA √（工作空间中所有项目） √（工作空间中指定项目内） √（工作空间中指定项目内） x x 查看服务SLA √ √ √ √ √ 导入物料包 √ √ √ √ x 更新物料包 √ √ √ √ x 下载物料包 √ √ √ √ x 查看物料包 √ √ √ √ √

项目级角色 除了工作空间级角色外，AstroPro还为每个项目预置了项目管理员、架构师和开发者三种类型的角色。 项目管理员 可以增删改査项目下的所有资源。 可以为项目下的所有角色分配用户（仅限于同账号下的用户，如图1中的IAM用户1、IAM用户2）。 架构师 可以新建服务。 可以删除自己创建的服务，不能删除其他人创建的服务。 可以对项目下的所有服务进行编辑。 开发者 可以查看项目下的所有资源。 可以重新编译有权限项目下的服务并下载代码。

service层代码结构 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 com.astropro |-- service # 承接API直接调用，基本的业务判断逻辑和分发。service层目录，只包含实现层，用户可自定义实现service层逻辑（必填项） {biz}Service.java # service实现代码（必填项） |-- repository # 数据操作聚合层（必填项） {biz}Repository.java # 数据操作聚合层继承类代码。用户可在此类中覆写基类中的方法或者增加自定义的方法 |-- mapper # 数据原子操作层，mapper层目录（必填项） {biz}CustomMapper.java # mapper层用户自定义mapper接口代码，用户可在此类中用户可在此类中实现自定义mapper接口 |-- enums # 枚举类（必填项） |-- config # 配置类（必填项） |-- utils # 工具类（必填项） |-- exception # 异常类（必填项） |-- integration # 集成第三方服务，隔离外部系统的影响，起防腐作用（可选项） |-- event # 事件层（可选项） |-- publish # 发布事件的Package，存放事件发布的工具类与发布的事件对象，屏蔽技术组件对应用业务的侵入 |-- subscribe # 订阅事件的Package，存放listener与消费的事件对象，listener只做数据的监听与数据格式的转换

service层资源目录结构 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 resources # 资源目录结构 |-- mapper # 开源组件mybatis的mapper.xml文件存放目录 {biz}CustomMapper.xml # 用户可在此文件中实现自定义的方法 |-- openapi # swagger.yaml存放目录 swagger.yaml # swagger.yaml文件 application.yml # SpringBoot全局配置文件 banner.txt # 应用程序的banner文件 log4j2.xml # log4j2日志配置文件 metadata.json # 元数据配置文件

base代码目录结构 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 com.astropro |-- controller # API层代码，定义向外部服务暴露的接口（必填项） {biz}Api.java {biz}Controller.java |-- service # 承接API直接调用，基本的业务判断逻辑和分发。service层目录，包含接口层（必填项） I{biz}Service.java # service接口层代码 |-- repository # 数据操作聚合层（必填项） Abstract{biz}Repository.java # 数据操作聚合层代码。 |-- mapper # 数据原子操作层。mapper层目录，包含基本接口（必填项） {biz}Mapper.java # mapper层接口代码 |-- model # 业务对象层，包含实体类、枚举类、查询对象和mybatis查询条件对象 {biz}.java # 实体类（可选项） {xxx}Enum.java # 枚举类（可选项） {biz}Qo.java # 查询对象（可选项） {biz}Criteria.java # mybatis查询条件对象（可选项） |-- dto # 数据传输对象，do组合对象（可选项） |-- nested # 根据业务对象的关系自动关联生成，嵌套复杂对象（可选项） |-- cartesian # 根据业务对象的关系自动关联生成，正交的笛卡尔积对象（可选项） |-- {customDto}.java # 用户预先定义好的数据传输对象（可选项） |-- utils # 工具类（必填项） |-- resources # 资源目录结构 |-- mapper # 开源组件mybatis的mapper.xml文件存放目录 {biz}Mapper.xml # 该目录下的文件禁止用户改动

base资源目录结构 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 resources # 资源目录结构 |-- mapper # 开源组件mybatis的mapper.xml文件存放目录 {biz}Mapper.xml # 该目录下的文件禁止用户改动

resources目录结构说明 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 resources |-- mapper # 开源组件mybatis的mapper.xml文件存放目录 |-- base # 该目录下的文件禁止用户改动 {biz}BaseMapper.xml {biz}Mapper.xml # 只在初次代码生成，用户可在此文件中实现自定义的方法 |-- openapi # swagger.yaml存放目录 swagger.yaml # swagger.yaml文件 application.yml # SpringBoot全局配置文件 banner.txt # 应用程序的banner文件 log4j2.xml # log4j2日志配置文件 metadata.json # 元数据配置文件

代码结构说明 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 com.astropro |-- api # API层代码，定义向外部服务暴露的接口（必填项） {biz}Api.java {biz}Controller.java |-- service # 承接API直接调用，基本的业务判断逻辑和分发。service层目录，包含接口层和实现层 (必须) |-- impl # service实现代码（必填项） |-- {biz}Service.java I{biz}Service.java # service接口层代码。 |-- domain # 领域层，包含基本的业务和业务聚合（必填项） {biz}Domain.java |-- repository # 数据操作聚合层。包含基类和继承类 （必填项） |-- base # 数据操作聚合层基类代码（必填项） {biz}BaseRepository.java {biz}Repository.java # 数据操作聚合层继承类代码。用户可在此类中覆写基类中的方法或者增加自定义的方法 |-- mapper # 数据原子操作层。mapper层目录，包含基本接口和继承接口（必填项） |-- base # mapper层基本接口代码（必填项） {biz}BaseMapper.java {biz}Mapper.java # mapper层继承接口代码。用户可在此类中覆写基本接口中的方法或者增加自定义的方法 |-- model |-- entity # 实体类（必填项） |-- enums # 枚举类（可选项） |-- qo # 查询对象（可选项） |-- criteria # mybatis查询条件对象（可选项） |-- dto # 数据传输对象，do组合对象（可选项） |-- nested # 根据业务对象的关系自动关联生成，嵌套复杂对象（可选项） |-- cartesian # 根据业务对象的关系自动关联生成，正交的笛卡尔积对象（可选项） |-- {customDto}.java # 用户预先定义好的数据传输对象（可选项） |-- config # 配置类（必填项） |-- utils # 工具类（必填项） |-- exception # 异常类（必填项） |-- integration # 集成第三方服务，隔离外部系统的影响，起防腐作用（可选项） |-- event # 事件层（可选项） |-- publish # 发布事件的Package，存放事件发布的工具类 与 发布的事件对象，屏蔽技术组件对应用业务的侵入 |-- subscribe # 订阅事件的Package，存放listener与消费的事件对象，listener只做数据的监听与数据格式的转换

添加自定义API 在业务设计页面，选中某个业务对象。 单击BO属性操作中的“自定义API”，进入编辑自定义API页面。 单击“新增”，按需添加所需的API。 实例级别：定义API实例的级别，如类型、实例。 动作名称：设置API的动作名称。 请求方法：HTTP请求方法（也称为操作或动作），用于告诉服务您正在请求什么类型的操作。 get：请求服务器返回指定资源。 put：请求服务器更新指定资源。 post：请求服务器新增资源或执行特殊操作。 delete：请求服务器删除指定资源。 请求对象：单击“添加请求对象”，可添加请求对象，即API请求的输入参数。 返回对象：请求发送后，您会收到的响应，如状态码。 路径：单击“输入path”，添加API的路径，格式为变量放到“{}”中，单词用“_”连接，非变量单词用“-”连接。例如：/meta-bo1s/{meta_bo1_id}/test-action。 当您没有自定义API路径，且“实例级别”选择“实例”时，生成的API路径上会拼接一个{MetaBo}_id的路径，同时方法上会多生成一个当前MetaBo主键的参数，如图2所示。 图2 API路径 描述：输入自定义API的描述信息。 设置代码生成层，参数设置与代码生成关系请参考表1。 表1 设置代码生成层组合说明 接口层 应用层 数据访问层 代码生成 x √ x 仅在应用层生成代码。 x x √ 仅在数据访问层生成代码。 √ √ x 在接口层和应用层生成代码。 x √ √ 在应用层和数据访问层生成代码。 √ √ √ 在接口层、应用层和数据访问层皆生成代码。 图3 设置代码生成层 设置完成后，单击“保存”。

示例 创建服务时“Package”设置为“com.astropro”。在业务设计中添加自定义API，动作名称为action1，请求方式为GET，返回对象为200，代码生成层勾选接口层和应用层，则代码生成时，将在接口层和应用层生成对应API的代码，如图6所示。 图4 设置打包路径 图5 添加自定义API 图6 查看生成代码 表2 不同目录结构下实际影响代码路径说明 目录结构 接口层 应用层 数据访问层 DDD {package}.api.xxx {package}.app.xxx {package}.infrastructure.repository.base.xxx Single {package}.api.xxx {package}.service.xxx {package}.repository.base.xxx base/service {package}.api.xxx {package}.service.xxx {package}.repository.base.xxx package为创建服务时定义的打包路径。

关系属性设置 在业务设计页面，拖入一个BO业务对象和一个Abstract BO对象（命名为Role、Abstract），单击“relations”中的“继承”，为对象建立继承关系。选中已创建的关系，在右侧页面即可设置关系属性，如图3所示。 图3 继承关系 关系名称：设置继承关系的名称。 关系类型：根据创建的继承关系自动生成。 关系首要方：根据创建的继承关系自动生成。 关系次要方：根据创建的继承关系自动生成。

关系属性设置 在业务设计页面，拖入一个BO业务对象（命名为Bo5）单击“relations”中的“树递归”，为对象建立树递归关系。选中已创建的关系，在右侧页面即可设置关系属性，如图2所示。 图2 树递归 关系名称：设置树递归关系的名称。 关系类型：根据创建的树递归关系自动生成。 关系首要方：根据创建的树递归关系自动生成。 关系次要方：根据创建的树递归关系自动生成。 关系操作：对象关系可执行哪些操作，如新增、删除、查询、批量新增、批量删除和批量查询。 每个Bo5可以包含多少个子Bo5：一个首要方（父节点）和次要方（子节点）建立关联的数量上限。 每个父节点能有多少子节点上限预警值：首要方（父节点）一条数据最多关联次要方（子节点）多少条数据报出告警。

关系属性设置 在业务设计页面，拖入两个BO业务对象（命名为Bo1、Bo2）单击“relations”中的“聚合”，为对象建立聚合关系。选中已创建的关系，在右侧页面即可设置关系属性，如图2所示。 图2 聚合 关系名称：设置聚合关系的名称。 关系类型：根据创建的聚合关系自动生成。 关系首要方：根据创建的聚合关系自动生成。 关系次要方：根据创建的聚合关系自动生成。 DTO暴露方式 - NESTED：是否设置DTO的NESTED（嵌套）能力。默认为生成DTO读写API。 不设置：不生成NESTED。 只生成DTO：只生成NESTED对象的类。 生成DTO读API：只会生成一个get接口。 生成DTO读写API：除了生成一个get接口，还会生成一个插入接口。 DTO暴露方式 - CARTESIAN：设置DTO的CARTESIAN（笛卡尔积）能力。 不设置：不生成CARTESIAN。 只生成DTO：只生成CARTESIAN对象的类。 生成DTO读API：只会生成一个get接口。 每个Bo1关联最大Bo2数：一个首要方和次要方建立关联的数量上限。 每个Bo1最大关联Bo2数：一个次要方和首要方建立关联的数量上限。 每个Bo1关联最大Bo2维度上限预警值：首要方一条数据最多关联次要方多少条数据报出告警。

关系属性设置 在业务设计页面，拖入两个BO业务对象（命名为Bo3、Bo4），单击“relations”中的“多对多”，为对象建立多对多关系。选中已创建的关系，在右侧页面即可设置关系属性，如图2所示。 图2 多对多关系 关系名称：设置多对多关系的名称。 关系类型：根据创建的多对多关系自动生成。 关系首要方：根据创建的多对多关系自动生成。 关系次要方：根据创建的多对多关系自动生成。 表名：设置关系表的名称，请按需自定义。在多对多关系中，会建立关系表用来保存首要方和次要方id的关系。 DTO暴露方式 - NESTED：是否设置DTO的NESTED（嵌套）能力。默认为不设置。 不设置：不生成NESTED。 只生成DTO：只生成NESTED对象的类。 生成DTO读API：只会生成一个get接口。 生成DTO读写API：除了生成一个get接口，还会生成一个插入接口。 DTO暴露方式 - CARTESIAN：设置DTO的CARTESIAN（笛卡尔积）能力。 不设置：不生成CARTESIAN。 只生成DTO：只生成CARTESIAN对象的类。 生成DTO读API：只会生成一个get接口。 关系操作：对象关系可执行哪些操作，如新增、删除、查询、批量新增、批量删除和批量查询。 每个Bo3关联最大Bo4数：一个首要方和次要方建立关联的数量上限。 每个Bo4关联最大Bo3数：一个次要方和首要方建立关联的数量上限。 每个Bo3关联最大Bo4维度上限预警值：首要方一条数据最多关联次要方多少条数据报出告警。 每个Bo4最大关联Bo3维度上限预警值：次要方一条数据最多关联首要方多少条数据报出告警 编辑字段：多对多的关系是通过一个关系表来表示的。单击“编辑字段”，可为关系表添加字段。

关系属性设置 在业务设计页面，拖入两个BO业务对象（命名为Primary、Secondary），单击“relations”中的“一对多”，为对象建立一对多关系。选中已创建的关系，在右侧页面即可设置关系属性，如图2所示。 图2 一对多关系 关系名称：设置一对多关系的名称。 关系类型：根据创建的一对多关系自动生成。 关系首要方：根据创建的一对多关系自动生成。 关系次要方：根据创建的一对多关系自动生成。 DTO暴露方式 - NESTED：是否设置DTO的NESTED（嵌套）能力。默认为不设置。 不设置：不生成NESTED。 只生成DTO：只生成NESTED对象的类。 生成DTO读API：只会生成一个get接口。 生成DTO读写API：除了生成一个get接口，还会生成一个插入接口。 DTO暴露方式 - CARTESIAN：设置DTO的CARTESIAN（笛卡尔积）能力。 不设置：不生成CARTESIAN。 只生成DTO：只生成CARTESIAN对象的类。 生成DTO读API：只会生成一个get接口。 每个Primary关联最大Secondary数：一个首要方和次要方建立关联的数量上限。 每个Secondary最大关联Primary数：一个次要方和首要方建立关联的数量上限。 每个Primary关联最大Secondary维度上限预警值：首要方一条数据最多关联次要方多少条数据报出告警。

属性说明 在业务设计页面，从“business”中，拖拽“Value Object”对象至画布空白区域。选中对象，在右侧页面设置对象属性，如图4所示。 图4 Value Object 对象名称：设置对象的名称，必须使用大驼峰格式，不允许存在连续的大写字母。 中文名：设置对象的中文名称。 BO属性操作：单击“编辑字段”，可以为对象添加所需的字段。 软删除策略：开启软删除策略后，数据删除时执行逻辑删除，数据仍然保留在数据库中。关闭软删除策略后，数据删除为物理删除，即直接从数据库中删除，不可恢复。 购买AstroPro企业版实例时，才会显示“软删除策略”这个配置项。 恢复软删除：当开启“软删除策略”时可配置。开启恢复软删除，则支持将软删除的数据恢复。 支持BO多租：BO是否支持多租。开启BO多租时，请确保“多租模型”已开启。 购买AstroPro专业版及企业版实例时，才会显示“支持BO多租”配置项。 图5 开通多租模型 不允许修改：对象是否支持修改。 操作：对新建的对象可执行哪些操作，如新增、更新、删除、查询、批量新增、批量更新、批量查询、批量删除和自定义查询。默认值为新增、更新、删除、查询和批量查询。 对象版本化：通过版本号的机制实现的乐观锁功能。开启此功能时，会在表中自动添加一个devspore_verion的字段来记录版本。在更新操作时会检查当前版本号和DB中的版本号是否一致，一致则更新数据并增加版本号，如果不同则说明数据已被其他事务修改，更新失败。 购买AstroPro企业版实例时，才会显示“对象版本化”配置项。 对象描述：对象的描述信息。

操作步骤 在业务设计页面，单击“自定义DTO”。 图1 自定义DTO 单击“新增”，添加一个自定义DTO。 图2 自定义一个Dto1 在自定义API的参数或返回体中，使用自定义DTO。 从“business”中，拖拽“BO”对象至画布空白区域。 选中BO对象，在对象属性中，单击“自定义API”。 图3 自定义API 单击“新增”，添加一个自定义API。 图4 自定义一个API 在请求对象或返回对象的参数中，使用自定义DTO。 图5 在自定义API中使用自定义DTO

功能介绍 Abstract BO是一个抽象对象，不能单独存在，没有数据库表，需要和业务对象建立继承的关系。建立继承关系后，业务对象会继承抽象对象中的字段。例如，抽象对象Abstract和业务对象Role存在继承关系，在抽象对象Abstract中，新建一个name字段，该字段会被Role自动继承。 图1 和业务对象Role建立继承关系 图2 在Abstract BO中新建一个name字段 图3 Role中继承name字段

属性说明 在业务设计页面，从“business”中，拖拽“Abstract BO”对象至画布空白区域。选中对象，在右侧页面设置对象属性，如图4所示。 图4 Abstract BO 对象名称：设置对象的名称，必须使用大驼峰格式，不允许存在连续的大写字母。 中文名：设置对象的中文名称。 BO属性操作：单击“编辑字段”，可以为对象添加所需的字段。 软删除策略：开启软删除策略后，数据删除时执行逻辑删除，数据仍然保留在数据库中。关闭软删除策略后，数据删除为物理删除，即直接从数据库中删除，不可恢复。 购买AstroPro企业版实例时，才会显示“软删除策略”配置项。 恢复软删除：当开启“软删除策略”时可配置。开启恢复软删除，则支持将软删除的数据恢复。 操作：对新建的对象可执行哪些操作，如新增、更新、删除、查询、批量新增、批量更新、批量查询、批量删除和自定义查询。默认值为新增、更新、删除、查询和批量查询。 对象版本化：通过版本号的机制实现的乐观锁功能。开启此功能时，会在表中自动添加一个devspore_verion的字段来记录版本。在更新操作时会检查当前版本号和DB中的版本号是否一致，一致则更新数据并增加版本号，如果不同则说明数据已被其他事务修改，更新失败。 购买AstroPro企业版实例时，才会显示“对象版本化”配置项。 对象描述：对象的描述信息。

属性说明 在业务设计页面，从“business”中，拖拽“BO”对象至画布空白区域。选中对象，在右侧页面设置对象属性，如图1所示。 图1 BO 对象名称：设置对象的名称，必须使用大驼峰格式，不允许存在连续的大写字母。 中文名：设置BO对象的中文名称。 分库逻辑：设置BO数据分库（sharding）策略。 广播对象（BROADCASTING）：不需要进行分库，数据在所有数据分库实例上复制，一般是包含配置信息或者维度数据的小表。 根对象（ROOTED）：分库的根对象，每个服务只能有一个。支持的主键类型有UUID和雪花算法，其中雪花算法支持逻辑数据库水平扩展。 分库对象（SHARDING）：需要进行分库，所有对象实例必须有字段关联的ROOTED BO（AstroPro会自动创建ROOTED表引用字段，并创建外键关联ROOTED表），SHARDING表的分库策略和ROOTED必须保持一致。 单库对象（SINGLE）：单表，不进行分库，也不是广播表，仅在一个数据库实例中存在。 表名：设置BO对象在数据库中的表名。 BO属性操作：设置对象的属性操作。 编辑字段：编辑对象的字段。单击“编辑字段”，进入编辑对象字段页面，可为对象添加字段和索引。其中，“NORMAL”为一般类型索引，使用B+树类型存储；“UNIQUE”为唯一索引。 图2 新增字段 图3 添加索引 自定义API：当系统预置的增删改查操作不能满足需求时，您可以通过自定义API来实现某个操作。如何为对象自定义API，请参见如何为对象自定义API。 软删除策略：开启软删除策略后，数据删除时执行逻辑删除，数据仍然保留在数据库中。关闭软删除策略后，数据删除为物理删除，即直接从数据库中删除，不可恢复。 购买AstroPro企业版实例时，才会显示“软删除策略”配置项。 恢复软删除：当开启“软删除策略”时可配置。开启恢复软删除，则支持将软删除的数据恢复。 支持BO多租：BO是否支持多租。开启BO多租时，请确保“多租模型”已开启。 购买AstroPro专业版及企业版实例时，才会显示“支持BO多租”配置项。 图4 开通多租模型 不允许修改：对象是否支持修改。 操作：对新建的对象可执行哪些操作，如新增、更新、删除、查询、批量新增、批量更新、批量查询、批量删除和自定义查询。默认值为新增、更新、删除、查询和批量查询。 对象版本化：通过版本号机制实现的乐观锁功能。开启此功能时，会在表中自动添加一个devspore_verion的字段来记录版本。在更新操作时会检查当前版本号和DB中的版本号是否一致，如果一致则更新数据并增加版本号，如果不一致则说明数据已被其他事务修改，更新失败。 购买AstroPro企业版实例时，才会显示“对象版本化”配置项。 对象描述：对象的描述信息。

步骤5：服务依赖 通常情况下，一个应用不是一个单独的服务，可能由多个服务共同组成。这些服务之间可能存在一些跨服务的调用，此时就需要通过添加依赖服务，把这些服务的客户端集成过来。添加依赖服务前，请确保依赖服务的“是否生成客户端”按钮已启用。 图1 开启“是否生成客户端”配置 在服务依赖中，选择当前服务依赖的服务。 图2 选择依赖的服务 选择依赖服务的版本号。 在依赖强弱中，选择strong（强）或weak（弱），单击“添加”，完成依赖服务的添加。 图3 完成依赖服务的添加 选择客户端的依赖类型，支持“SDK”和“METHOD”两种类型，可按需选择。 （可选）添加客户端流控策略。 选择SDK类型时，无须配置流控策略。 选择“METHOD”类型后，单击“编辑”，可为对象方法配置流控策略。例如：为User对象的addOder添加一个Retry的流控策略，如图4所示。 您可以选择系统预置的流控策略，也可以选择自定义流控策略。选择自定义流控策略需提前在资产库中创建客户端流控策略。 单击“保存”，完成流控策略配置。 图4 为对象添加方法的流控策略 父主题： 编辑服务