检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用swagger进行在线API文档配置 文档配置 spring-boot-starter-huawei添加了swagger2和swagger3包的依赖,API在线文档使用springdoc-openapi-ui。springdoc基本配置较为简单,如下所示: springdoc:
配置连接器 应用场景 通过连接器生成客户端,可以将已有服务的接口抽象和封装为一套标准化的客户端库。这样,其他服务可以通过这些客户端库以统一和简化的方式调用已有服务的接口,无需关心服务的具体实现细节。生成的客户端库可以作为服务间通信的标准工具,减少了重复的代码编写,提高了开发效率和代码的可重用性。
初识应用设计器 AstroPro设计器可以分为顶部工具栏、左侧插件栏、中间画布区和右侧属性设置面板四个主要界面模块。 图1 AstroPRO设计器 顶部工具栏 设计器顶部的工具栏从左到右包括: :撤销上一步的操作。 :恢复上次撤销的内容。 :保存当前页面数据。 :发布页面模板。 :清空当前画布内容。
使用状态选择器 使用说明 在样式选择器右侧,还提供了一个状态选择器的下拉框。可以选择hover、focused、pressed、disabled等状态。选择之后,您此时编辑样式面板,就是相当于在编辑该类名对应状态的样式。 操作步骤 参考登录AstroPro界面中操作,登录AstroPro界面。
> 前端应用”。 单击待编辑应用模块内的“开发应用”,进入设计器。 添加变量,例如:bgcolor,用来控制背景颜色;color,用来控制字体颜色,具体操作请参考添加页面变量。 图1 添加变量 画布中选中组件,在组件属性设置面板选择“样式”。 单击行内样式的编辑框后的。 在弹框中进行变量绑定。
执行框架转换 应用场景 针对企业中使用Dubbo等其他API框架的存量服务,AstroPro支持将代码统一转换为Spring MVC + OpenAPI的主流框架。转换后的框架将统一化,这有助于简化技术栈,降低技术多样性带来的复杂性,同时提高开发和运维团队的效率。 约束与限制 框架转换为Astro
粘性定位:组件在滚动时“粘”在某个位置,直到达到某个条件才会离开这个位置。粘性定位可以让页面在滚动时保持某些组件的可见性。 图4 设置定位 文本:设置文本的字号、字体、行高、字重、颜色、对齐方式、风格及修饰。 图5 设置文本 背景:设置组件背景,背景图、渐变类型、颜色及裁剪方式。 图6 设置背景 边框:
自定义dto(禁止改动) |-- converter # bean转换器,用于BO和DTO转换 {biz}Converter.java # 与BO是一一对应关系
如何为对象自定义API 使用说明 当系统提供的基本操作无法满足需求时,可通过自定义API来实现 图1 查看操作类型 约束与限制 如果您的业务设置为聚合关系,则只能在主要方自定义API。 添加自定义API 在业务设计页面,选中某个业务对象。 单击右侧属性配置中的“自定义API”,进入编辑自定义API页面。
bind等。 服务在线文档生成工具:swagger(v2,v3),springdoc-openapi-ui(jdk8),springdoc-openapi-starter-webmvc-ui(jdk17),有了这些工具后可以为服务接口字段生成openapi在线文档。 yaml文件
国际化资源管理 使用说明 同一个项目,可能需要同时支持多个语言,设计器提供了中英文切换,能够一键切换语言,提升开发效率与开发体验。 国际化是应用级别的,在任何一个页面都可以访问。 注意的是国际化只针对画布中的项目,不针对设计器本身。 添加国际化词条 参考登录AstroPro界面中操作,登录AstroPro界面。
配置说明 日志配置 使用swagger进行在线API文档配置 父主题: spring-boot-huawei使用指南
swagger标签使用指南 本章节为您介绍swagger的通用标签,帮助能更好的编辑swagger文件,完成业务设计。 1、x-query-param-body 作用: 图1 使用背景 此功能需要结合metadata.json使用,对应到metadata.json中的参数:generatorPolicy
按钮组件:在右侧属性设置面板选择“样式”,设置尺寸宽为100%,高度为30px,字体颜色为白色,背景颜色为蓝色;在右侧属性设置面板选择“属性”,文本输入“登录”。 Text组件2:在右侧属性设置面板选择“样式”,设置字体颜色为蓝色,字号10px;在右侧属性设置面板选择“属性”,文本输入“设置/忘记密码”。
熔断器打开,导致方法调用失败 问题描述 熔断器打开,导致方法调用失败。 解决方案 在没有使用自定义降级方法和缓存的时候,原方法如果调用失败会抛出方法原始出的错误。 如果使用了自定义降级方法。 熔断前:自定义降级方法中添加的最后一个异常的参数封装的就是原方法的异常。 熔断后:最后一个异常参数会固定抛出“io
后端应用管理 创建企业核心应用 后端开发视频指导 项目管理 角色管理 服务组管理 服务管理 服务依赖管理 对象详解 应用管理 子域管理 应用服务管理 配置服务SLA 资产库管理 执行框架转换
配置客户端流控策略 客户端流控策略通常是指在客户端应用中实施的流量控制机制,目的是为了管理客户端与服务器之间的数据传输速率,防止过量的请求对服务器造成压力,同时也保证客户端应用的流畅性,提升用户体验。您可以使用系统预置的流控策略,还可以根据自己的需求自定义创建。 本章节为您介绍如何自定义创建及使用客户端流控策略。
redis缓存不存在的属性反序列化 问题描述 redis在存入的时候,如果对象中存在is开头的方法,但是又没有具体的属性。那么在存入的时候,会将auth转换为一个属性存入缓存当中,在反序列化的时候就会报反序列化失败。 public boolean isAuth(){ return
了解构建流程 在AstroPro中,用户通过业务建模,可生成高可用、高可靠、以及安全稳定的企业级IT应用框架。业务建模是指通过业务设计,将实际业务涉及的对象和行为转换为元数据中的对象、对象关系、服务依赖等构成的模型,通过模型生成服务,实现业务需求。 使用AstroPro创建企业核心应用的流程,如图1所示。
使用数据源 使用说明 设计器提供数据源来配合画布上的组件渲染。 本章节以应用于表格组件的表格列为例,为您介绍如何使用数据源。 创建数据源 参考登录AstroPro界面中操作,登录AstroPro界面。 在左侧导航栏中,选择“前端开发平台 > 前端应用”。 单击应用模块内的“开发应用”,进入设计器。