检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用swagger进行在线API文档配置 文档配置 spring-boot-starter-huawei添加了swagger2和swagger3包的依赖,API在线文档使用springdoc-openapi-ui。springdoc基本配置较为简单,如下所示: springdoc:
步骤3:生成策略 生成策略和基本配置、框架配置一样,需要您根据实际情况进行勾选配置,不同的配置会呈现不同的效果。 API设置。 图1 API设置 Json序列化 小驼峰:序列化后的json属性名,采用驼峰格式。 下划线:序列化后的json属性名,采用下划线连接单词。 标准响应体:返回的响应体是否使用标准样式。
步骤5:生成服务代码 根据配置的业务模型生成该服务的基本代码。代码生成后,会提供一个压缩包,供您使用。关于压缩包中代码的详细介绍,请参见服务开发框架详解。 在服务依赖页面,单击“创建”。 图1 创建服务 输入变更日志描述信息,单击“创建”。 系统开始创建服务,并生成该服务的基本代
生成服务代码 使用说明 根据配置的业务模型,生成服务的基本代码。代码生成后,会提供一个压缩包,供您使用。关于代码结构的详细介绍,请参见服务开发框架详解。 操作步骤 参考编辑服务中操作,完成业务模型的配置。 在服务依赖中,单击“创建”。 输入变更日志描述信息,单击“创建”。 系统开始创建服务,并生成该服务的代码。
生成业务代码 使用说明 页面设计完成后,您可以根据配置生成应用的基本代码。代码生成后,会下载至本地,供您使用。 操作步骤 参考登录AstroPro界面中操作,登录AstroPro界面。 在左侧导航栏中,选择“前端开发平台 > 前端应用”。 选择待操作应用,单击模块内的“开发应用”,进入设计器。
使用效果: 使用前:api类中不生成org.springframework.stereotype.Controller; 和org.springframework.transaction.annotation.Transactional;引用。 使用后:api类中生成如下引用。 import
bind等。 服务在线文档生成工具:swagger(v2,v3),springdoc-openapi-ui(jdk8),springdoc-openapi-starter-webmvc-ui(jdk17),有了这些工具后可以为服务接口字段生成openapi在线文档。 yaml文件
DDD “代码风格 > 工程目录”设置为“DDD”时,和“单Module”一样,仅会生成“src”一个模块,如图1所示。 图1 DDD 代码结构说明 代码结构说明中的“{biz}”,为在AstroPro的业务设计中定义的对象,如BO、Abstract BO等。 com.astropro
获取数据源远程字段 使用说明 您可以通过已有的远程Http接口,快速地生成数据源的字段。 操作步骤 参考登录AstroPro界面中操作,登录AstroPro界面。 在左侧导航栏中,选择“前端开发平台 > 前端应用”。 单击应用模块内的“开发应用”,进入设计器。 在左侧插件栏中,单击,展开数据源管理页面。
工程目录”设置为“base/service”时,会生成base、service和client(如servicedemo-client)三个模块。其中,client为客户端模块,在AstroPro中添加服务时,开启“是否生成客户端”配置后才会生成。 base:AstroPro自动生成出来的,用户不可以修改。
新增类名 使用说明 当选中一个组件,还没有自动生成类名时,您可以单击输入框手动输入类名,然后继续编辑样式面板的样式。 此时,组件会自动绑定您输入的类名,然后将在样式面板编辑的样式生成代码,写入到全局样式中。 新增类名 参考登录AstroPro界面中操作,登录AstroPro界面。
配置说明 日志配置 使用swagger进行在线API文档配置 父主题: spring-boot-huawei使用指南
在所属服务组模块中,单击“编辑”,可修改服务组的名称和描述信息。 在服务信息模块中,单击“编辑”,可对服务进行再次编辑。 在服务信息模块中,单击“重新生成”,可再次生成服务的代码。 在服务信息模块中,单击,选择“新增版本”,可修改服务的API版本。 在服务信息模块中,单击,选择“复制服务”,可基于当前服务配置复制一个新的服务。
在设计器中可根据您的需求设计前端页面,可参考设计前端应用流程进行开发。 单击顶部工具栏的“下载源码”按钮,可根据配置的页面设计,生成应用的基本代码。 代码生成后,会下载至本地,供您使用。 删除前端应用 参考登录AstroPro界面中操作,登录AstroPro界面。 在左侧导航栏中,选择“前端开发平台
服务创建编译完成后,支持再次编译服务并生成新的代码压缩包。 操作步骤 参考登录AstroPro界面中操作,登录AstroPro界面。 在左侧导航栏中,选择“后端开发平台 > 服务管理 > 服务”。 在服务列表中,单击已创建服务后的“更多 > 重新生成”,即可重新生成服务的代码。 图1 重新生成服务代码 单
配置说明 表1 参数配置说明 参数名称 是否必选 功能 devspore.auth.in-header false token是否在header中,默认true。 devspore.auth.token-name false token在header中的参数名,inHeader设
的对metaBO(以及对应的RO)操作前鉴权、认证,metaBO变动后消息发送、审计等功能的组件。配置horizon后,generator生成的项目的repository中相关操作上会带有@Extension注解。 // 普通增删改查接口 @Extension(operation
# 根据业务对象的关系自动关联生成,嵌套复杂对象(可选项) |-- cartesian # 根据业务对象的关系自动关联生成,正交的笛卡尔积对象(可选项) |-- {customDto}
领域驱动设计,根据业务模型创建业务应用 领域驱动设计,创建业务应用,用户通过业务建模,可生成高可用、高可靠、以及安全稳定的企业级IT应用框架。 支持领域驱动设计的建模,以及复杂关系建模,生成架构规范的代码框架,降低开发门槛。 安全可靠,内置稳定的安全防护能力。 内置业界优秀开发规
在AstroPro中完成服务的开发后,会生成一个服务代码压缩包,命名为“服务名称+唯一ID”。假设服务名称为Servicedemo,则生成的代码压缩包名称,如图1所示。 图1 代码压缩包名称 了解代码结构 在AstroPro中编辑服务时,可在“生成策略 > 代码风格”中定义生成代码的工程目录结构,如图2、图3。