检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 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”，进入编辑自定义API页面。
使用swagger进行在线API文档配置 文档配置 spring-boot-starter-huawei添加了swagger2和swagger3包的依赖，API在线文档使用springdoc-openapi-ui。springdoc基本配置较为简单，如下所示： springdoc: api-docs:
rvice段的apiVersion字段，一般为v1、v2类型的值。 描述：设置服务的描述信息。 单击“确定”，即可完成服务的创建。此处创建服务的操作，相当于为服务搭建了一个框架。您需要根据自身业务的需求继续编辑服务。 在服务列表中，单击已创建服务后的“编辑”。 设置服务基本配置、详细配置及客户端配置。
doFilterInternal在token解析成功后将解析出的用户信息通过SPI方式调用UserStore的实现类（DefaultUserStore，用户可自定义）存储用户信息供后续业务代码使用。 约束与限制 TokenParser实现类与UserStore实现类，均需注册成bean，并完
开启自定义鉴权功能 自定义鉴权功能在微服务架构、API管理、企业内部系统集成等方面发挥着重要作用，它提供了灵活性和可扩展性，以满足不同业务场景下的安全需求。 开启自定义鉴权功能前，请确保依赖服务的“是否启用扩展拦截”按钮已启用。 图1 开启“是否启用扩展拦截”配置 登录Astro
代码结构说明 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 com.astropro |-- api # API层代码，定义向外部服务暴露的接口（必填项）
发布事件的Package，存放事件发布的工具类与发布的事件对象，屏蔽技术组件对应用业务的侵入 |-- subscribe # 订阅事件的Package，存放listener与消费的事件对象，listener只做数据的监听与数据格式的转换 service层资源目录结构
针对企业中使用Dubbo等其他API框架的存量服务，AstroPro支持将代码统一转换为Spring MVC + OpenAPI的主流框架。转换后的框架将统一化，这有助于简化技术栈，降低技术多样性带来的复杂性，同时提高开发和运维团队的效率。 约束与限制 框架转换为Astro Pr
不设置：不生成NESTED。 只生成DTO：只生成NESTED对象的类。 生成DTO读API：只会生成一个get接口。 生成DTO读写API：除了生成一个get接口，还会生成一个插入接口。 DTO暴露方式 - CARTESIAN：设置DTO的CARTESIAN（笛卡尔积）能力。 不设置：不生成CARTESIAN。
@Controller识别为一个字符串添加到api接口类上，并不会导入相应的包，需要使用 x-imports标签手动导入相应的包 - "@Transactional" # 此处会将 @Transactional识别为一个字符串添加到api接口类上，并不会导入相应的包，需要使用 x-imports标签手动导入相应的包
# 发布事件的Package，存放事件发布的工具类 与 发布的事件对象，屏蔽技术组件对应用业务的侵入 |-- subscribe # 订阅事件的Package，存放listener与消费的事件对象，lis
至画布空白区域。 选中BO对象，在对象属性中，单击“自定义API”。 图3 自定义API 单击“新增”，添加一个自定义API。 图4 自定义一个API 在请求对象或返回对象的参数中，使用自定义DTO。 图5 在自定义API中使用自定义DTO 父主题： AstroPro学堂
ul API的规范，它可以用来导入设计业务，确保 API 的设计符合业务需求。 前提条件 根据业务模型，完成swagger文件设计，swagger标签使用可参考swagger标签使用指南 导入swagger文件 在业务设计页面，单击“导入swagger”。 选择已编辑好的swagger文件。
HTTP-FLV等协议构建的云应用提供性能测试的服务，支持快速模拟大规模并发用户的业务高峰场景，可以很好的支持报文内容和时序自定义、多事务组合的复杂场景测试，测试完成后会为您提供专业的测试报告呈现您的服务质量。更多关于CodeArts PerfTest的介绍，请参见性能测试CodeArts
取值范围 描述 match 否 String - 正则表达式，用于与requestMapping中的url匹配。 module 否 FallbackOrder RetryFirst/CircuitBreakerFisrt二选一的枚举类。 RetryFirst重试次数不计入断路器/Circ
骤4：编辑服务中编辑元数据时，可进行修改。 API版本：指定服务的API版本，对应服务metadata.json文件中，Service段的apiVersion字段，一般为v1、v2类型的值。 图4 apiVersion 描述：设置服务的描述信息。 父主题： 创建企业核心应用
熔断器打开，导致方法调用失败。 解决方案 在没有使用自定义降级方法和缓存的时候，原方法如果调用失败会抛出方法原始出的错误。 如果使用了自定义降级方法。 熔断前：自定义降级方法中添加的最后一个异常的参数封装的就是原方法的异常。 熔断后：最后一个异常参数会固定抛出“io.github.resilience4j
metrics.api-description-tags false boolean 是否开启http_server_request指标添加description标签功能，如开启，会自动添加@ApiOperation注解的value字段或@Operation注解的summary字段作为description值。
组件纳管的依赖包和版本 组件纳管的依赖包 spring-boot-starter-huawei包含的依赖包（代码中pom可不引入相关依赖）。 表1 spring-boot-starter-huawei包含的依赖包 包名groupId:artifactId 备注 org.sprin
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
