检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何自定义DTO 使用说明 自定义DTO相当于数据传输对象,主要用于自定义API时添加参数或返回体。 自定义DTO 在业务设计页面,单击“自定义DTO”。 图1 自定义DTO 单击“新增”,添加一个自定义DTO。 图2 自定义一个Dto1 在自定义API的参数或返回体中,使用自定义DTO。
通过导入swagger文件实现业务设计 Swagger文件是一个用于描述RESTful API的规范,它可以用来导入设计业务,确保 API 的设计符合业务需求。 前提条件 根据业务模型,完成swagger文件设计,swagger标签使用可参考swagger标签使用指南 导入swagger文件
了解服务创建流程 什么是(微)服务 (微)服务是业务概念,即提供某种服务的某个进程。每一个服务都具有自主运行的业务功能,对外开放不受语言限制的API,多个(微)服务组成应用程序。 AstroPro是一个企业应用一站式构建平台,对于平台来说不需要过多的区分服务和微服务。 了解服务创建流程
升级API版本 使用说明 服务创建后,若需要修改服务的API版本号,可通过新增版本实现。 图1 API版本号 API版本对应服务metadata.json文件中,Service段的apiVersion字段,一般为v1、v2类型的值。 图2 查看apiVersion取值 操作步骤
DDD “代码风格 > 工程目录”设置为“DDD”时,和“单Module”一样,仅会生成“src”一个模块,如图1所示。 图1 DDD 代码结构说明 代码结构说明中的“{biz}”,为在AstroPro的业务设计中定义的对象,如BO、Abstract BO等。 com.astropro
账号是指当您首次使用华为云时注册的账号,该账号是您的华为云资源归属、资源使用计费的主体,对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。账号统一接收所有IAM用户进行资源操作时产生的费用账单。在一个账号下,您可以创建多个用户,账号和用户的关系如图1所示。如果您没有华为账号,可参考注
聚合 什么是聚合 聚合关系本质上也是一种一对多关系,唯一不同的是聚合中次要方必须依赖首要方,任何对于次要方的操作首先要经过首要方才能继续往下操作。 图1 聚合和一对多的差异 关系属性设置 在业务设计页面,拖入两个BO业务对象(命名为Bo1、Bo2)单击“relations”中的“
步骤3:添加服务 在AstroPro中,快速添加一个服务,新增服务中的配置均采用默认配置。此处新建服务的操作,相当于为服务搭建了一个框架。 在AstroPro界面的左侧导航栏中,选择“后端开发平台 > 服务管理 > 服务”。 选择已创建的项目和服务组,单击“新建服务”。 图1 新建服务
如何为对象自定义API 使用说明 当系统提供的基本操作无法满足需求时,可通过自定义API来实现 图1 查看操作类型 约束与限制 如果您的业务设置为聚合关系,则只能在主要方自定义API。 添加自定义API 在业务设计页面,选中某个业务对象。 单击BO属性操作中的“自定义API”,进入编辑自定义API页面。
使用模板创建服务 使用说明 您可以在“资产库”中自定义模板。当您的业务与模板中的场景相似度较高时,可以通过模板创建新的服务,减少重复开发,提高交付效率。 前提条件 已完成模板创建,具体操作请参考创建架构模板和创建业务对象模板。 已新建项目。 已创建服务组。 使用模板创建服务 参考
新增一个服务 使用说明 创建服务前,请确保已创建项目和服务组。如果待添加的服务有依赖其他服务,请先添加依赖的服务。添加被依赖服务时,必须开启“是否生成客户端”。 图1 开启“是否生成客户端” 前提条件 参考新建项目中操作,完成项目的创建。 参考新建服务组中操作,完成服务组的创建。
一对多 什么是一对多 一对多关系中,次要方可以不依赖于首要方,可以单独存在。删除一对多关系只代表两个对象之间的特定关系的结束,不会影响任何一个对象的生命周期。 图1 一对多和聚合的差异 创建一对多关系后,首要方不会做任何的改动,次要方的字段中会自动增加首要方的id,即primar
swagger标签使用指南 本章节为您介绍swagger的通用标签,帮助能更好的编辑swagger文件,完成业务设计。 1、x-query-param-body 作用: 图1 使用背景 此功能需要结合metadata.json使用,对应到metadata.json中的参数:generatorPolicy
步骤3:生成策略 生成策略和基本配置、框架配置一样,需要您根据实际情况进行勾选配置,不同的配置会呈现不同的效果。 API设置。 图1 API设置 Json序列化 小驼峰:序列化后的json属性名,采用驼峰格式。 下划线:序列化后的json属性名,采用下划线连接单词。 标准响应体:返回的响应体是否使用标准样式。
步骤1:基本配置 基本信息中配置的内容会呈现在代码中,需用户根据实际情况进行勾选配置。 在服务列表中,单击新增一个服务中已创建服务后的“编辑”。 在基本配置中,按需进行设置。 图1 基本配置 基本配置:若本地已有配置好的服务元数据,可通过单击“导入元数据”,直接导入。 微服务名称
BO 功能介绍 BO(Business Object)是一个业务对象,业务对象映射到服务中的一个实体,对应数据库中的一张表。 属性说明 在业务设计页面,从“business”中,拖拽“BO”对象至画布空白区域。选中对象,在右侧页面设置对象属性,如图1所示。 图1 BO 对象名称:
多对多 什么是多对多 多对多关系中,首要方和次要方都不会发生任何的变化。唯一的变化是在多对多连线上,会默认添加两个字段用来分别指向关系的两侧。也就是说,一对多和聚合关系是通过在次要方添加主键和外键来表示的,而多对多关系是通过单独创建的关系表来表示的。 和一对多关系一样,删除多对多
使用spring-boot-starter-huawei组件 spring-boot-starter-huawei组件具备开发一个基本的基于spring-boot的web项目的基本依赖,使用时只需将该组件的坐标添加到工程的pom文件中即可。 使用方式 直接作为dependency依赖引入(此步骤必须)。
服务管理 了解服务创建流程 新增一个服务 编辑服务 生成服务代码 查看服务详情 使用模板创建服务 升级API版本 重新编译服务 复制服务 删除服务 导出元数据 导入DDL 导入swagger 父主题: 后端应用管理
单Module 工程目录结构 “代码风格 > 工程目录”设置为“单Module”,仅会生成“src”一个模块,如图1所示。 图1 单Module 代码结构说明 代码结构说明中的“{biz}”,为在AstroPro的业务设计中定义的对象,如BO、Abstract BO等。 com.astropro