文档首页/ MapReduce服务 MRS/ 开发指南（LTS版）/ HetuEngine开发指南（安全模式）/ 准备HetuEngine应用开发环境/ 导入并配置HetuEngine样例工程
更新时间：2025-12-16 GMT+08:00
查看PDF
分享

导入并配置HetuEngine样例工程

操作场景

客户端安装程序目录中包含了HetuEngine开发样例工程，将从工程导入样例开始学习，本文以IntelliJ IDEA 2020.1.3 (Community Edition)为例。

前提条件

确保本地PC的时间与集群的时间差要小于5分钟，若无法确定，请联系系统管理员。集群的时间可通过Manager页面右下角查看。

操作步骤

  1. 参考获取MRS应用开发样例工程，获取样例代码解压目录中“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”。

      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的编码格式

  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”。

    3. 单击“Apply”后单击“OK”。
    4. 在IntelliJ IDEA的菜单栏中，选择“File > Project Structure...”，弹出“Project Structure”窗口。
    5. 选择“SDKs”，单击加号选择“JDK”。

    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”。

    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”。

      在“Dependencies”页面，修改“Module SDK”为“SDKs”中添加的JDK。

    11. 单击“Apply”，单击“OK”。

  5. MRS 3.6.0-LTS及之后版本，配置Maven。

    1. 参考配置华为开源镜像仓章节描述，增加开源镜像仓地址等配置信息到本地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”文件放置目录
    3. 单击“Maven home directory”右侧的下拉菜单，选择Maven的安装路径。
    4. 单击“Apply”并单击“OK”。

相关文档