检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
服务开发框架详解 整体结构介绍 单Module base/service DDD 父主题: AstroPro学堂
redis-connection-factory-bean-name: redisConnectionFactory # 当使用redis的时候,需要将redis的连接工厂的bean的名称配置在这里 rules: fallbackTest: # 此处配置的是一个别名,用户可自定义,具体使用地方是在注解上
新增一个服务 使用说明 创建服务前,请确保已创建项目和服务组。如果待添加的服务有依赖其他服务,请先添加依赖的服务。添加被依赖服务时,必须开启“是否生成客户端”。 图1 开启“是否生成客户端” 前提条件 参考新建项目中操作,完成项目的创建。 参考新建服务组中操作,完成服务组的创建。
redis-connection-factory-bean-name: redisConnectionFactory # 当使用redis的时候,需要将redis的连接工厂的bean的名称配置在这里 rules: fallbackTest: # 此处配置的是一个别名,用户可自定义,具体使用地方是在注解上
不支持 不支持 支持 服务SLA 不支持 不支持 支持 资产库 自定义字段类型 不支持 支持 支持 客户端流控策略 不支持 不支持 支持 连接器 不支持 不支持 支持 前端开发 前端应用 支持 支持 支持 模板管理 不支持 支持 支持 物料中心 不支持 不支持 支持
步骤5:生成服务代码 根据配置的业务模型生成该服务的基本代码。代码生成后,会提供一个压缩包,供您使用。关于压缩包中代码的详细介绍,请参见服务开发框架详解。 在服务依赖页面,单击“创建”。 图1 创建服务 输入变更日志描述信息,单击“创建”。 系统开始创建服务,并生成该服务的基本代
(可选)步骤2:创建服务组 服务组用于对项目中的服务进行分组,一般一个分组对应一个研发团队。创建项目后,默认会创建一个和项目同名的服务组,所有新建服务默认在此分组下。您也可以不使用默认的服务组,直接新建一个服务组。 参考步骤1:创建项目中操作,创建一个项目。 项目创建后,在左侧导航栏中,选择“后端开发平台
在架构模板页面,单击“新建架构模板”。 配置模板信息后,单击“下一步”。 模板名称:输入模板名称,名称仅允许以英文字母开头,包含英文字母和数字,一般采用驼峰格式或“-”连接,长度最低为两位。 模板类型:默认为架构模板,暂不支持修改。 模板范围:根据3选择的项目,确认模板范围。 图2 配置模板基本信息 设置模板基本配置后,单击“下一步”。
在业务基础模板页面,单击“新建业务对象模板”。 配置模板信息后,单击“下一步”。 模板名称:输入模板名称,名称仅允许以英文字母开头,包含英文字母和数字,一般采用驼峰格式或“-”连接,长度最低为两位。 模板类型:默认为业务对象模板,暂不支持修改。 模板范围:根据3选择的项目,确认模板范围。 图1 配置业务对象模板基本信息
自定义插件服务鉴权开发指南 开启自定义鉴权功能 用户自定义鉴权使用 父主题: 应用开发指南
x-pom-gav在Swagger文件中的位置可以是类级别、方法级别、参数级别,groupId、artifactId、version按照顺序用:连接,全局有一个地方定义即可,不需要重复定义。 使用示例 swagger: "2.0" info: description: "" version:
步骤2:框架配置 框架配置和基本配置一样,需要您根据实际情况进行勾选配置,不同的配置会呈现不同的效果。 是否启用模板,默认不启用,如需启用,在下拉框中选择已创建的模板。创建模板具体操作请参考创建架构模板。 选择模板后,模板配置将自动带入包括“框架配置”和“生成策略”。 选择参考框架。
步骤1:基本配置 基本信息中配置的内容会呈现在代码中,需用户根据实际情况进行勾选配置。 在服务列表中,单击新增一个服务中已创建服务后的“编辑”。 在基本配置中,按需进行设置。 图1 基本配置 基本配置:若本地已有配置好的服务元数据,可通过单击“导入元数据”,直接导入。 微服务名称
步骤4:业务设计 步骤1:基本配置、步骤2:框架配置和步骤3:生成策略中参数,只需要用户根据自身业务直接在界面进行勾选配置。而业务设计需要用户根据实际的需求,进行业务模型的设计和配置。 例如,创建一个简单的订单系统,订单系统中包括用户(User)、订单(Order)和订单详情(O
升级API版本 使用说明 服务创建后,若需要修改服务的API版本号,可通过新增版本实现。 图1 API版本号 API版本对应服务metadata.json文件中,Service段的apiVersion字段,一般为v1、v2类型的值。 图2 查看apiVersion取值 操作步骤
导出元数据 使用说明 服务创建后,支持导出服务的元数据。元数据导出后,在创建类似服务时,可通过“导入元数据”,直接导入使用。 图1 导入元数据 操作步骤 参考登录AstroPro界面中操作,登录AstroPro界面。 在左侧导航栏中,选择“后端开发平台 > 服务管理 > 服务”。
DDD “代码风格 > 工程目录”设置为“DDD”时,和“单Module”一样,仅会生成“src”一个模块,如图1所示。 图1 DDD 代码结构说明 代码结构说明中的“{biz}”,为在AstroPro的业务设计中定义的对象,如BO、Abstract BO等。 com.astropro
国际化资源管理 使用说明 同一个项目,可能需要同时支持多个语言,设计器提供了中英文切换,能够一键切换语言,提升开发效率与开发体验。 国际化是应用级别的,在任何一个页面都可以访问。 注意的是国际化只针对画布中的项目,不针对设计器本身。 添加国际化词条 参考登录AstroPro界面中操作,登录AstroPro界面。
单Module 工程目录结构 “代码风格 > 工程目录”设置为“单Module”,仅会生成“src”一个模块,如图1所示。 图1 单Module 代码结构说明 代码结构说明中的“{biz}”,为在AstroPro的业务设计中定义的对象,如BO、Abstract BO等。 com.astropro
整体结构介绍 压缩包命名规则 在AstroPro中完成服务的开发后,会生成一个服务代码压缩包,命名为“服务名称+唯一ID”。假设服务名称为Servicedemo,则生成的代码压缩包名称,如图1所示。 图1 代码压缩包名称 了解代码结构 在AstroPro中编辑服务时,可在“生成策略