# 调测SpringBoot样例程序
#### 操作场景
程序代码开发完成后，通过Windows环境进行编译生成Jar包。该Jar包既可在本地Windows环境进行调测，也可部署至Linux环境执行调测。如果本地与集群业务平面网络互通时，可直接在本地进行调测。
#### 约束与限制
MRS 3.6.0-LTS.1及之后版本，"hetu-rest-client-example"样例代码仅支持JDK 17和JDK 21版本。
本章节仅适用于MRS 3.6.0-LTS及之后版本。
#### 操作步骤
1. 配置SpringBoot样例程序连接HetuEngine所需的属性信息，在配置文件"springboot\\hetu-examples\\src\\main\\resources\\application.yml"中配置如下参数。 
   表1配置HetuEngine信息 
   | 参数       | 是否必须 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   |:---|:---|:---|
   | host     | 是    | HetuEngine服务的HSFabric地址列表，格式为：HSFabric_IP1:HSFabric_Port,HSFabric_IP2:HSFabric_Port,HSFabric_IP3:HSFabric_Port。 登录Manager页面，选择"集群 \> 服务 \> HetuEngine \> 实例"，获取HSFabric所有实例的业务IP；在"配置"页签，搜索"gateway.port"，获取HSFabric的端口号。                                                                                                                                                                     |
   | catalog  | 是    | HetuEngine计算实例Catalog名称。                                                                                                                                                                                                                                                                                                                                                                                                                                  |
   | schema   | 是    | HetuEngine计算实例Schema名称。                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | user     | 是    | HetuEngine计算实例连接用户名。                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | password | 是    | HetuEngine计算实例连接用户的密码。 普通模式集群配置为空。                                                                                                                                                                                                                                                                                                                                                          |
   | ssl      | 是    | 是否使用SSL连接HetuEngine计算实例。 - 安全模式集群："true"。  - 普通模式集群："false"。   |
   | tenant   | 是    | 任务执行时所使用的队列。                                                                                                                                                                                                                                                                                                                                                                                                                                              |
      
   
   
2. 在IDEA界面左下方单击"Terminal"进入终端，执行如下命令进行编译。
   
   **mvn clean package**
   图1执行编译命令   
   ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001898125805.png "点击放大")
   当输出"BUILD SUCCESS"时表示编译成功。编译成功后将会在样例工程的"target"下生成含有"hetu-rest-client-example"字段的Jar包。
   图2编译成功   
   ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001898127189.png "点击放大")
   
   
3. 在系统中创建一个目录作为运行目录，并将[2]中生成的含有"hetu-rest-client-example"字段的Jar包放进该路径下。
   
   - 在Windows上创建目录，如"D:\\hetu-rest-client-example"。
   
   - 在Linux上创建目录，如"/opt/hetu-rest-client-example"。
   
   
   
   
4. 执行以下命令启动SpringBoot服务。 
   - 在Windows环境下执行： 以管理员身份打开cmd窗口。
     执行**d:**
     **cd hetu-rest-client-example**
     **java -jar hetu-rest-client-example-** **\*** **-SNAPSHOT.jar**
     
   
   - Windows下使用JDK编译的包，在Linux使用对应版本的JDK运行：
     - 指定JDK 17运行样例：客户端安装路径/JDK17/jdk/bin/java -classpath hetu-rest-client-example-\*.jar。
     
     - 指定JDK 21运行样例：客户端安装路径/JDK21/jdk/bin/java -classpath hetu-rest-client-example-\*.jar。
      
   
   
   ![](https://support.huaweicloud.com/devg-lts-mrs/public_sys-resources/note_3.0-zh-cn.png)
   以上Jar包名称仅供参考，具体名称以实际生成为准。
   
   
5. 调用HetuEngine的SpringBoot样例接口触发样例代码运行。 
   - Windows环境运行方式： 打开浏览器，输入：http://localhost:8080/hetu/example/executesql。
     
   
   - Linux环境下运行方式： 在[3]中存放Jar包的节点上执行**curl http://localhost:8080/hetu/example/executesql**。
     
   
   
   
   
6. 查看样例代码中的SQL所查询出的结果。 
   图3查询结果   
   ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001898019333.png "点击放大")