检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
使用swagger进行在线API文档配置 文档配置 spring-boot-starter-huawei添加了swagger2和swagger3包的依赖，API在线文档使用springdoc-openapi-ui。
成长地图 | 华为云 Astro企业应用 Astro企业应用（Astro Pro，简称AstroPro）是Astro面向企业数字化转型提供的元数据驱动的企业应用一站式构建平台。为企业SaaS应用提供端到端开发管理平台，沉淀通用能力，加快应用构建，差异场景灵活扩展，助力业务创新。 产品介绍
为了便于您更好的了解AstroPro，本指南中操作及截图均以专业版/企业版实例为例进行介绍。 购买基础版实例 进入购买Astro企业应用实例页面。 “实例规格”选择“基础版”，设置购买时长，单击“立即购买”。 图1 选择购买规格 确认订单无误后，单击“去支付”。
登录页面设计开发示例 业务场景及设计流程说明 应用可以由一个或多个页面组成一个完整的业务系统。 本入门为创建一个简单的登录页面，帮助您快速上手AstroPro前端应用开发。登录页面中包括图片、文本、输入框和按钮四个基础组件，且用到Box布局容器组件，便于整体排版布局。在AstroPro
登录AstroPro界面 前提条件 已参考购买基础版实例、购买专业版实例或购买企业版实例中操作，购买AstroPro实例。 登录AstroPro界面 使用华为账号，登录华为云网站。 在顶部导航栏右侧单击“控制台”，进入华为云控制台。 在“产品”中，选择“开发与运维 > 低代码平台
标识作用于表中字段，可使标识字段数据类型在模型中修改为标识类型。
Value Object 功能介绍 Value Object是一个值对象，不能单独存在，需要和业务对象建立聚合的关系。 图1 和业务对象建立聚合关系 聚合后，Value Object中的主键和BO中的主键，共同构成了一个联合的主键。 图2 BO中的字段 图3 联合主键 属性说明 在业务设计页面
为了便于您更好的了解AstroPro，本指南中操作及截图均以专业版实例为例进行介绍。 前提条件 确保账户有充足的费用。如何为账户充值，请参见账户充值。 购买实例 进入购买Astro企业应用实例页面。 “实例规格”选择“专业版”，其他参数按需进行设置，单击“立即购买”。
通过导入swagger文件实现业务设计 Swagger文件是一个用于描述RESTful API的规范，它可以用来导入设计业务，确保 API 的设计符合业务需求。 前提条件 根据业务模型，完成swagger文件设计，swagger标签使用可参考swagger标签使用指南 导入swagger
了解构建流程 在AstroPro中，用户通过业务建模，可生成高可用、高可靠、以及安全稳定的企业级IT应用框架。业务建模是指通过业务设计，将实际业务涉及的对象和行为转换为元数据中的对象、对象关系、服务依赖等构成的模型，通过模型生成服务，实现业务需求。 使用AstroPro创建企业核心应用的流程
DDD “代码风格 > 工程目录”设置为“DDD”时，和“单Module”一样，仅会生成“src”一个模块，如图1所示。 图1 DDD 代码结构说明 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 com.astropro
添加全局变量 使用说明 全局变量是在整个应用中都可访问的变量。它们的作用域是全局的，可以在应用的任何一个页面调用。 操作步骤 参考登录AstroPro界面中操作，登录AstroPro界面。 在左侧导航栏中，选择“前端开发平台 > 前端应用”。 单击待编辑应用模块内的“开发应用”，进入设计器
整体结构介绍 压缩包命名规则 在AstroPro中完成服务的开发后，会生成一个服务代码压缩包，命名为“服务名称+唯一ID”。假设服务名称为Servicedemo，则生成的代码压缩包名称，如图1所示。 图1 代码压缩包名称 了解代码结构 在AstroPro中编辑服务时，可在“生成策略
找不到createMultiZonClient的bean 问题描述 当使用缓存功能，并且缓存组件使用的redis时，报如图所示的异常。 图1 报错异常 解决方案 使用devspore-dcs连接redis。 devspore-dcs会默认创建一个bean名称为createMultiZoneClient
聚合 什么是聚合 聚合关系本质上也是一种一对多关系，唯一不同的是聚合中次要方必须依赖首要方，任何对于次要方的操作首先要经过首要方才能继续往下操作。 图1 聚合和一对多的差异 关系属性设置 在业务设计页面，拖入两个BO业务对象（命名为Bo1、Bo2）单击“relations”中的“聚合
服务在线文档生成工具：swagger(v2,v3)，springdoc-openapi-ui(jdk8)，springdoc-openapi-starter-webmvc-ui(jdk17)，有了这些工具后可以为服务接口字段生成openapi在线文档。
继承 什么是继承 在继承关系中，业务对象可以继承抽象对象中的所有字段。例如，业务对象Role和抽象对象Abstract，抽象对象中存在name和value两个字段。建立继承关系后，抽象对象Abstract中的字段会被业务对象Role完全继承，如图2。 图1 抽象对象Abstract
配置说明 日志配置 使用swagger进行在线API文档配置 父主题： spring-boot-huawei使用指南
单Module 工程目录结构 “代码风格 > 工程目录”设置为“单Module”，仅会生成“src”一个模块，如图1所示。 图1 单Module 代码结构说明 代码结构说明中的“{biz}”，为在AstroPro的业务设计中定义的对象，如BO、Abstract BO等。 com.astropro
在项目启动时报NPE问题 问题描述 在项目启动时，报如图1所示问题。 图1 NPE报错 解决方案 用户需要排查是否在项目启动时使用到了clientcontrol的功能，如在启动时使用了clientcontrol的功能，需要保证clientcontrol要优先初始化。可以在使用到clientcontrol
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
