# 导入并配置HetuEngine样例工程
#### 操作场景
客户端安装程序目录中包含了HetuEngine开发样例工程，将从工程导入样例开始学习，本文以IntelliJ IDEA 2020.1.3 (Community Edition)为例。
#### 前提条件
确保本地PC的时间与集群的时间差要小于5分钟，若无法确定，请联系系统管理员。集群的时间可通过Manager页面右下角查看。
#### 操作步骤
1. 参考[获取MRS应用开发样例工程](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_010002.html)，获取样例代码解压目录中"src"目录下的样例工程文件夹"hetu-examples\\hetu-examples-security"和"hetu-examples\\hetu-examples-rest-security"，分别对应jdbc请求样例代码和HetuEngine的HSConsole的API调用样例代码（MRS 3.6.0-LTS及之后版本）。
2. 在应用开发环境中，导入样例工程到IntelliJ IDEA开发环境。 
   1. 打开IntelliJ IDEA，选择"File \> New \> General \> Project from Existing Sources \> Select File or Directory to Import"，将显示"浏览文件夹"对话框。
   
   2. 选择样例工程文件夹，在"Import"时选择"Import project from external model \> Maven"，单击"Next"，直到"Finish"。
      ![](https://support.huaweicloud.com/devg-lts-mrs/public_sys-resources/note_3.0-zh-cn.png)
      MRS 3.6.0-LTS之前版本，样例代码为Maven工程，可以根据实际需要进行工程配置调整。
      
   
   
   
   
3. MRS 3.6.0-LTS及之后版本，设置IntelliJ IDEA的文本文件编码格式，解决乱码显示问题。 
   1. 在IntelliJ IDEA的菜单栏中，选择"File \> Settings"，弹出"Settings"窗口。
   
   2. 在左边导航上选择"Editor \> File Encodings"，在"Project Encoding"和"Global Encoding"区域，设置参数值为"UTF-8"，单击"Apply"后，单击"OK"。
      图1设置IntelliJ IDEA的编码格式   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000002392324636.png "点击放大") 
   
   
   
   
4. MRS 3.6.0-LTS及之后版本，设置工程JDK。 
   1. 在IntelliJ IDEA的菜单栏中，选择"File \> Settings"，弹出"Settings"窗口。
   
   2. 选择"Build, Execution, Deployment \> Compiler \> Java Compiler"，确认样例代码运行使用的JDK版本。
      - 若使用JDK 8运行，在"Project bytecode version"右侧的下拉菜单中，选择"8"。修改对应"Module"的"Target bytecode version"为"8"。
      
      - 若使用JDK 17运行，在"Project bytecode version"右侧的下拉菜单中，选择"17"。修改对应"Module"的"Target bytecode version"为"17"。
      
      - 若使用JDK 21运行，在"Project bytecode version"右侧的下拉菜单中，选择"21"。修改对应"Module"的"Target bytecode version"为"21"。
      
      
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000002392164760.png "点击放大")
      
   
   3. 单击"Apply"后单击"OK"。
   
   4. 在IntelliJ IDEA的菜单栏中，选择"File \> Project Structure..."，弹出"Project Structure"窗口。
   
   5. 选择"SDKs"，单击加号选择"JDK"。 ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000002425844477.png)
      
   
   6. 在弹出的"Select Home Directory for JDK"窗口，选择对应的JDK目录，然后单击"OK"。
   
   7. 完成JDK选择后，单击"Apply"。
   
   8. 选择"Project"，在"Project SDK"下的下拉菜单中选择在"SDKs"中添加的JDK，在"Project language level"下的下拉菜单中选择"8 - Lambdas, type annotations etc."；如果选择的JDK版本是17，请选择"17 - Sealed types, always-strict floating-point semantics"；如果选择的JDK版本是21，请选择"21 - Record patterns, pattern matching for switch"。 ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000002425764625.png "点击放大")
      
   
   9. 单击"Apply"。
   
   10. 选择"Modules"，在"Source"页面，修改"Language level"为"8 - Lambdas, type annotations etc."；如果选择的JDK版本是17，则修改"Language level"为"17 - Sealed types, always-strict floating-point semantics"；如果选择的JDK版本是21，请选择"21 - Record patterns, pattern matching for switch"。 ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000002392324640.png "点击放大")
       在"Dependencies"页面，修改"Module SDK"为"SDKs"中添加的JDK。
       ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000002392164764.png "点击放大")
       
   
   11. 单击"Apply"，单击"OK"。
   
   
   
   
5. MRS 3.6.0-LTS及之后版本，配置Maven。 
   1. 参考[配置华为开源镜像仓](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_010002.html#mrs_07_010002__zh-cn_topic_0000001918070240_zh-cn_topic_0000001298931189_section13196125861611)章节描述，增加开源镜像仓地址等配置信息到本地Maven的"setting.xml"配置文件。
   
   2. 修改完成后，在IntelliJ IDEA选择"File \> Settings \> Build, Execution, Deployment \> Build Tools \> Maven"，勾选"User settings file"右侧的"Override"，并修改"User settings file"的值为当前"settings.xml"文件放置目录，确保该目录为"*\<本地Maven安装目录\>* \\conf\\settings.xml"。
      图2"settings.xml"文件放置目录   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000002425844481.png "点击放大") 
   
   3. 单击"Maven home directory"右侧的下拉菜单，选择Maven的安装路径。
   
   4. 单击"Apply"并单击"OK"。