检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用swagger进行在线API文档配置 文档配置 spring-boot-starter-huawei添加了swagger2和swagger3包的依赖,API在线文档使用springdoc-openapi-ui。springdoc基本配置较为简单,如下所示: springdoc:
通过导入swagger文件实现业务设计 Swagger文件是一个用于描述RESTful API的规范,它可以用来导入设计业务,确保 API 的设计符合业务需求。 前提条件 根据业务模型,完成swagger文件设计,swagger标签使用可参考swagger标签使用指南 导入swagger文件
通过导入DDL文件实现业务设计 本章节指导您如何通过导入DDL文件来实现业务设计。DDL文件不仅定义了数据库的结构,还确保了数据的完整性和一致性,为业务应用提供了坚实的基础。 DDL文件设计 根据业务模型,完成DDL文件设计,DDL标签使用可参考DDL标签使用指南。 示例: CREATE
注意:上传的物料包名称不能与已有的物料包名称重复。 配置物料包基本信息。 表1 基本信息参数说明 参数 说明 物料包名称 自动识别物料包带入信息,无须手动填写。 物料包版本 自动识别物料包带入信息,无须手动填写。 描述 输入物料包补充描述说明。 物料包封面 选择物料包封面,默认为导入时选择的封面。
步骤5:生成服务代码 根据配置的业务模型生成该服务的基本代码。代码生成后,会提供一个压缩包,供您使用。关于压缩包中代码的详细介绍,请参见服务开发框架详解。 在服务依赖页面,单击“创建”。 图1 创建服务 输入变更日志描述信息,单击“创建”。 系统开始创建服务,并生成该服务的基本代
使用模板创建页面 使用已创建的模板,一键生成页面,轻松实现个性化网站构建,节省时间,提高效率。 参考登录AstroPro界面中操作,登录AstroPro界面。 在左侧导航栏中,选择“前端开发平台 > 前端应用”。 单击应用模块内的“开发应用”,进入设计器。 在左侧插件栏中,单击,进入“页面管理”页面。
创建子域 使用说明 子域有助于将复杂的业务领域分解为更小、更易于管理和理解的部分。通过识别和创建子域,组织可以更有效地开发和维护应用,同时确保每个子域都能满足其特定的业务需求。 约束与限制 应用管理为Astro Pro企业版功能,如果您需要使用此功能,请升级Astro Pro实例版本。
生成业务代码 使用说明 页面设计完成后,您可以根据配置生成应用的基本代码。代码生成后,会下载至本地,供您使用。 操作步骤 参考登录AstroPro界面中操作,登录AstroPro界面。 在左侧导航栏中,选择“前端开发平台 > 前端应用”。 选择待操作应用,单击模块内的“开发应用”,进入设计器。
查询参数阈值:设置查询参数阈值,值为“0”时不生效。当查询参数大于该阈值时,将多个查询参数转换为对象。 设置代码风格。 图9 设置代码风格 配置文件格式:配置spring boot properties文件格式。 yaml :配置文件使用yaml格式。 properties :配置文件使用properties格式。
配置说明 日志配置 使用swagger进行在线API文档配置 父主题: spring-boot-huawei使用指南
设计前端应用流程 前端应用可以由一个或多个页面组成一个完整的业务系统。在AstroPro中,通过创建应用、(可选)创建文件夹、创建页面、页面设计和生成应用代码五步,即可快速完成前端应用设计,具体流程如图1所示。 图1 创建应用 步骤一:新建一个应用 参考登录AstroPro界面中操作,登录AstroPro界面。
步骤3:添加服务 在AstroPro中,快速添加一个服务,新增服务中的配置均采用默认配置。此处新建服务的操作,相当于为服务搭建了一个框架。 在AstroPro界面的左侧导航栏中,选择“后端开发平台 > 服务管理 > 服务”。 选择已创建的项目和服务组,单击“新建服务”。 图1 新建服务
自定义组件开发指南 在这个快速发展的前端开发时代中,组件化是构建可维护和可扩展应用程序的关键。 本章节帮助您了解自定义模板结构及开发流程。 模板结构介绍 public文件夹通常是用来存放Web应用程序的静态资源。 src文件夹是用来存放源代码文件,它包含assets和components两个子文件夹。
页面管理 页面管理插件可以管理该应用下的全部页面,可以新增页面,可以新增文件夹,以及对页面或者文件的增删改操作。 假如有一个前端工程: - project - views |_ Index.vue - Page2.vue
"@Controller" # 此处会将 @Controller识别为一个字符串添加到api接口类上,并不会导入相应的包,需要使用 x-imports标签手动导入相应的包 - "@Transactional" # 此处会将 @Transactional识别为一个字符串添加到api接口类上,并不会导入相应的包,需要使用
使用指南 如何使用devspore-probe 引入Maven依赖,在项目的pom.xml中添加下面的依赖,version应使用最新版本。 <dependency> <groupId>com.huaweicloud.devspore</groupId> <artifactId
查询参数阈值:设置查询参数阈值,值为“0”时不生效。当查询参数大于该阈值时,将多个查询参数转换为对象。 设置代码风格。 图2 设置代码风格 配置文件格式:配置spring boot properties文件格式。 yaml :配置文件使用yaml格式。 properties :配置文件使用properties格式。
新增类名 使用说明 当选中一个组件,还没有自动生成类名时,您可以单击输入框手动输入类名,然后继续编辑样式面板的样式。 此时,组件会自动绑定您输入的类名,然后将在样式面板编辑的样式生成代码,写入到全局样式中。 新增类名 参考登录AstroPro界面中操作,登录AstroPro界面。
使用超时功能 clientcontrol提供了超时功能,当目标业务方法执行超过执行时间后,会终止代码的执行,具体使用方式如下: pom文件添加依赖。 配置文件,参考下面配置样例。 devspore: client-control: biz-pool: prioritized:
bind等。 服务在线文档生成工具:swagger(v2,v3),springdoc-openapi-ui(jdk8),springdoc-openapi-starter-webmvc-ui(jdk17),有了这些工具后可以为服务接口字段生成openapi在线文档。 yaml文件