# 配置连接器
#### 应用场景
通过连接器生成客户端，可以将已有服务的接口抽象和封装为一套标准化的客户端库。这样，其他服务可以通过这些客户端库以统一和简化的方式调用已有服务的接口，无需关心服务的具体实现细节。生成的客户端库可以作为服务间通信的标准工具，减少了重复的代码编写，提高了开发效率和代码的可重用性。
#### 约束与限制
配置连接器为Astro Pro企业版功能，如果您需要使用此功能，请[升级Astro Pro实例版本](https://support.huaweicloud.com/usermanual-astropro/astropro_05_0167.html)。
#### 创建连接器
1. 参考[登录AstroPro界面](https://support.huaweicloud.com/usermanual-astropro/astropro_05_0004.html)中操作，登录AstroPro界面。
2. 在左侧导航栏中，选择"后端开发平台 \> 资产库 \> 连接器"。
3. 在连接器页面，单击"新建连接器"。
4. 参考[表1]配置连接器基本信息。
   
    表1基本信息参数说明 
   | 参数    | 说明                                                                                               |
   |:---|:---|
   | 连接器名称 | 输入连接器名称，即最终生成客户端服务名称。 连接器名称只能包含字母（大小写）、数字、连字符（-）、下划线（_）和句点（.）。 |
   | 描述    | 输入连接器补充描述信息。                                                                                     |
      
   图1新建连接器   
   ![](https://support.huaweicloud.com/usermanual-astropro/zh-cn_image_0000002098646973.png)
   
   
5. 单击"确定"，完成连接器创建。 
   创建成功后，可在连接器列表中查看已创建的连接器，并可进行编辑及删除操作。
   
   
 
#### 编辑连接器
1. 参考[登录AstroPro界面](https://support.huaweicloud.com/usermanual-astropro/astropro_05_0004.html)中操作，登录AstroPro界面。
2. 在左侧导航栏中，选择"后端开发平台 \> 资产库 \> 连接器"。
3. 在连接器列表中选择待操作的连接器，单击"操作"列"编辑"。
4. 在连接器编辑页面，配置连接器基本信息。 
   表2编辑连接器参数说明 
   | 参数          | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   |:---|:---|
   | 连接器名称       | 默认为创建连接器时输入的名称，不可修改。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | swagger信息   | 单击导入swagger，导入swagger文件。导入的swagger文件须符合OpenApi规范。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | 云服务         | 提供调用接口的云服务名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   | Package     | 设置生成代码的顶层包名。默认值为com.huawei.cloud，可自定义。 填写一个或多个片段，每个片段由小写字母开头，由小写字母和数字组成，片段之间用点号（.）连接，且禁止使用Java关键字。                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | Group ID    | 设置连接器的默认组名。默认值为com.huawei.tools，可自定义。 只能包含大小写字母、数字、连字符（-）、下划线（_）和点号（.）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | Artifact ID | 构件ID，只能包含字母（大小写）、数字和连字符（-）。 建议和连接器名称保持一致。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | 版本          | 设置连接器的版本号，默认值为0.0.1-SNAPSHOT，可自定义。 只能包含大小写字母、数字、连字符（-）、下划线（_）和点号（.）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | 框架          | 选择微服务使用的开发框架，支持DEVSPORE(JDK 8 + SpringBoot 2)和DEVSPORE(JDK 17 + SpringBoot 3)。 - DEVSPORE(JDK 8 + SpringBoot 2)：生成JDK8+SpringBoot2的代码框架。  - DEVSPORE(JDK 17 + SpringBoot 3)：生成JDK17+SpringBoot3的代码框架。                                                                                                                                                                                                                       |
   | 注册发现/配置中心   | 注册发现/配置中心。 - 不启用：不对接配置管理服务。  - CSE：使用微服务引擎服务CSE作为配置管理服务。CSE是微服务应用的云中间件，为用户提供了注册发现、服务治理、配置管理等高性能和高韧性的企业级云服务能力，可无缝兼容Spring Cloud、ServiceComb等开源生态，用户也可以结合其他云服务，快速构建云原生微服务体系，实现微服务应用的快速开发和高可用运维。更多关于CSE的介绍，请参见[微服务引擎CSE](https://support.huaweicloud.com/cse/index.html)。  - NACOS：使用NACOS作为配置管理服务。NACOS提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。   |
      
   图2编辑连接器   
   ![](https://support.huaweicloud.com/usermanual-astropro/zh-cn_image_0000002098662217.png)
   
   
5. 单击"确定"，完成连接器编辑。 
   系统开始生成该客户端代码，并下载到本地。
   图3生成该客户端代码并下载   
   ![](https://support.huaweicloud.com/usermanual-astropro/zh-cn_image_0000002098839249.png)
   
   
 
#### 单个删除连接器
1. 参考[登录AstroPro界面](https://support.huaweicloud.com/usermanual-astropro/astropro_05_0004.html)中操作，登录AstroPro界面。
2. 在左侧导航栏中，选择"后端开发平台 \> 资产库 \> 连接器"。
3. 在连接器列表中选择待操作的连接器，单击"操作"列"删除"。
4. 在弹框中单击"确认"，完成连接器单个删除。 
   连接器删除后不可恢复，请谨慎操作。
   
   
 
#### 批量删除连接器
1. 参考[登录AstroPro界面](https://support.huaweicloud.com/usermanual-astropro/astropro_05_0004.html)中操作，登录AstroPro界面。
2. 在左侧导航栏中，选择"后端开发平台 \> 资产库 \> 连接器"。
3. 在连接器列表中勾选待删除的连接器，单击"批量删除"。
4. 在弹出的确认框中，单击"确认"，即可批量删除连接器。 
   连接器删除后不可恢复，请谨慎操作。