# 导入并配置IoTDB样例工程
#### 背景信息
获取IoTDB开发样例工程，将工程导入到IntelliJ IDEA开始样例学习。
#### 操作步骤
1. 参考[获取MRS应用开发样例工程](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_010002.html)，获取样例代码解压目录中"src/iotdb-examples"目录下的样例工程，可根据实际业务场景选择对应的样例，相关样例介绍请参见[IoTDB样例工程介绍](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_500002.html#mrs_07_500002__section23791728143918)。
2. 若需要在本地Windows调测iotdb-flink-example、iotdb-jdbc-example、iotdb-kafka-example或iotdb-session-example样例代码，需进行以下操作： 
   - 需放置[准备集群认证用户信息](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_500049.html#mrs_07_500049__section10916205214313)获取到的认证文件"user.keytab"和"krb5.conf"及SSL证书文件"truststore.jks"到各样例工程的"..\\src\\main\\resources"目录下。
   
   - 配置各样例工程的"..\\src\\main\\resources"目录下"com.huawei.bigdata.iotdb.IoTDBProperties"类，修改该类的**IoTDBProperties()** 方法的proPath的值为"iotdb-example.properties"文件所在的绝对路径。
     图1配置proPath参数值   
     ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001820009188.png "点击放大") 
   
   
   
   
3. 修改各样例工程"..\\src\\main\\resources"目录下的"iotdb-example.properties"文件： 
   ```
   iotdb_ssl_enable=true
   jdbc_url=jdbc:iotdb://IoTDBServer实例IP地址:IoTDBServer RPC端口
   # 进行认证的用户名
   username=developuser
   # 进行认证的用户密码，该密码建议密文存放，使用时解密，确保安全。
   password=xxx
   # 下载的认证凭据中“krb5.conf”文件的位置，Linux环境下建议使用已上传到“IoTDB客户端安装目录/IoTDB/iotdb/conf”目录下的krb5.conf文件，Windows环境下使用“\\”，填写文件绝对路径。
   krb5_conf_dest=IoTDB客户端安装目录/IoTDB/iotdb/conf/krb5.conf
   # 下载的认证凭据中“user.keytab”文件的位置，Linux环境下建议使用已上传到“IoTDB客户端安装目录/IoTDB/iotdb/conf”目录下的user.keytab文件，Windows环境下使用“\\”，填写文件绝对路径。
   key_tab_dest=IoTDB客户端安装目录/IoTDB/iotdb/conf/user.keytab
   # 对应user.keytab的用户名@HADOOP.COM
   client_principal=developuser@HADOOP.COM
   # truststore文件路径，Linux环境下建议使用已上传到“IoTDB客户端安装目录/IoTDB/iotdb/conf”目录下的truststore.jks文件，Windows环境下使用“\\”，填写文件绝对路径。
   iotdb_ssl_truststore=IoTDB客户端安装目录/IoTDB/iotdb/conf/truststore.jks
   ```
   
   
4. 安装IntelliJ IDEA和JDK工具后，需要在IntelliJ IDEA配置JDK。 
   1. 打开IntelliJ IDEA，选择"Configure"。
      图2Quick Start   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001120744244.png "点击放大") 
   
   2. 在下拉框中选择"Structure for New Projects"。
      图3Configure   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001120904146.png) 
   
   3. 在弹出的"Project Structure for New Projects"页面中，选择"SDKs"，单击加号添加JDK。
      图4Project Structure for New Projects   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001120904154.png "点击放大") 
   
   4. 在弹出的"Select Home Directory for JDK"窗口，选择对应的JDK目录，然后单击"OK"。
      图5Select Home Directory for JDK   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001167623933.png "点击放大") 
   
   5. 完成JDK选择后，单击"OK"完成配置。
      图6完成JDK配置   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001120904152.png "点击放大")
      ![](https://support.huaweicloud.com/devg-lts-mrs/public_sys-resources/note_3.0-zh-cn.png)
      不同的IDEA版本的操作步骤可能存在差异，以实际版本的界面操作为准。
      
   
   
   
   
5. 导入样例工程到IntelliJ IDEA开发环境。 
   1. 打开IntelliJ IDEA，在"Quick Start"页面选择"Open or Import"。 另外，针对已使用过的IDEA工具，可以从主界面选择"File \> Import project..."导入样例工程。
      图7Open or Import（Quick Start页面）   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001167783905.png "点击放大") 
   
   2. 选择样例工程文件夹"iotdb-examples"下的"iotdb-jdbc-example"的pom.xml文件，然后单击"OK"。 ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001120744250.png "点击放大")
      选择"Open as Project"
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001167783903.png)
      
   
   3. 导入结束，IDEA主页显示导入的样例工程。
      图8导入样例工程成功   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001641840860.png "点击放大") 
   
   
   
   
6. 设置项目使用的Maven版本。 
   1. 在IntelliJ IDEA的菜单栏中，选择"File \> Settings..."
      图9Settings   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001167783911.png "点击放大") 
   
   2. 选择"Build,Execution,Deployment \> Maven"，选择Maven home directory为本地安装的Maven版本。
      然后根据实际情况设置好"User settings file"和"Local repository"参数。
      图10选择本地Maven安装目录   
      ![](https://support.huaweicloud.com/devg-lts-mrs/zh-cn_image_0000001120744252.png "点击放大") 
   
   3. 然后单击"Apply"和"OK"，完成配置。