检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
升级API版本 使用说明 服务创建后,若需要修改服务的API版本号,可通过新增版本实现。 图1 API版本号 API版本对应服务metadata.json文件中,Service段的apiVersion字段,一般为v1、v2类型的值。 图2 查看apiVersion取值 操作步骤 参考登录
如何为对象自定义API 使用说明 当系统提供的基本操作无法满足需求时,可通过自定义API来实现 图1 查看操作类型 约束与限制 如果您的业务设置为聚合关系,则只能在主要方自定义API。 添加自定义API 在业务设计页面,选中某个业务对象。 单击右侧属性配置中的“自定义API”,进入编辑自定义
配置连接器 应用场景 通过连接器生成客户端,可以将已有服务的接口抽象和封装为一套标准化的客户端库。这样,其他服务可以通过这些客户端库以统一和简化的方式调用已有服务的接口,无需关心服务的具体实现细节。
DevSpore-SDK使用指南 devspore-auth使用指南 devspore-security使用指南 devspore-probe使用指南 devspore-clientcontrol使用指南 spring-boot-huawei使用指南 AstroPro-SDK版本变更与下载
使用swagger进行在线API文档配置 文档配置 spring-boot-starter-huawei添加了swagger2和swagger3包的依赖,API在线文档使用springdoc-openapi-ui。springdoc基本配置较为简单,如下所示: springdoc:
参数校验 内置标准参数校验规则。 开发能力要求 您需具备以下开发能力: 熟悉Java语言,并有Java程序开发经验。 熟悉Maven。 基础开发环境准备 安装的工具包括JDK、Maven、Eclipse和IDEA ,配置对应的环境变量,确保本地开发环境可用。
标准响应体:返回的响应体是否使用标准样式。
配置自定义字段类型 使用说明 标准化的字段类型有时无法完全满足特定应用场景下的个性化需求,因此,需要创建自定义字段类型,从而提供更加精准和高效的数据处理能力。
Java Spring基础上增强标准日志、依赖管理、参数校验等功能,大幅提升存量服务改造效率。
应用通用基础能力 提供标准通用基础能力,包括标准三方件及依赖管理可快速解决版本漏洞、安全特性及日志跟踪等能力。
如何自定义DTO 使用说明 自定义DTO相当于数据传输对象,主要用于自定义API时添加参数或返回体。 自定义DTO 在业务设计页面,单击“自定义DTO”。 图1 自定义DTO 单击“新增”,添加一个自定义DTO。 图2 自定义一个Dto1 在自定义API的参数或返回体中,使用自定义
功能介绍 支持注解形式自定义监控指标 监控数据自动上报AOM平台 父主题: devspore-probe使用指南
自定义认证开发指南 开启自定义认证功能 用户自定义认证使用 父主题: 应用开发指南
参数配置说明 表1 参数配置说明 参数名称 是否必选 参数类型 取值范围 描述 bizPool 否 ThreadPoolConfig 参考表2。 线程池配置。 caches 否 Map of CacheConfig key为userdefine1,userdefine2......
常见问题 clientcontrol中ttl和performanceTtl的具体含义是什么 无法获取本地线程变量 redis缓存不存在的属性反序列化 找不到createMultiZonClient的bean 自定义缓存key读取失败 访问熔断状态的方法时报错异常 clientcontrol
解决方案 此报错是因为使用了自定义缓存key的功能,注解中配置了@clientcontrol(rules='xxxx', key='xxxxxx')此处key的解析使用的是标准的spring的spel表达式的解析,如果报了如上错误,需要自行排查el表达式的写法是否正确。
使用场景 使用超时功能 使用重试功能 使用熔断降级功能 父主题: devspore-clientcontrol使用指南
标准响应体:返回的响应体是否使用标准样式。
通过导入swagger文件实现业务设计 Swagger文件是一个用于描述RESTful API的规范,它可以用来导入设计业务,确保 API 的设计符合业务需求。 前提条件 根据业务模型,完成swagger文件设计,swagger标签使用可参考swagger标签使用指南 导入swagger
执行框架转换 应用场景 针对企业中使用Dubbo等其他API框架的存量服务,AstroPro支持将代码统一转换为Spring MVC + OpenAPI的主流框架。转换后的框架将统一化,这有助于简化技术栈,降低技术多样性带来的复杂性,同时提高开发和运维团队的效率。 约束与限制 框架转换为