# Java SDK的获取与安装
#### 获取DLI SDK
在"[DLI SDK DOWNLOAD](https://uquery-sdk.obs-website.cn-north-1.myhuaweicloud.com/)"页面，单击选择所需的SDK链接，即可获取对应的SDK安装包。
建议您同时下载SDK安装包中的.sha256文件，该文件可用于验证SDK包的完整性。验证方法请参考[验证SDK包的完整性]。
表1目录结构 
| 名称                   | 说明                      |
|:---|:---|
| jars                 | SDK及其依赖的jar包。           |
| maven-install        | 安装至本地Maven仓库的脚本及对应jar包。 |
| dli-sdk-java.version | Java SDK版本说明。           |
   
 #### 验证SDK包的完整性
下载SDK安装包时，您需要同时下载.sha256文件，用于验证SDK包的完整性。本节介绍使用.sha256文件验证SDK包的完整性的操作步骤。
1. **下载文件**
   1. 在SDK安装包的下载页面找到对应的.sha256文件的下载链接。 通常.sha256文件的名称会与SDK安装包的名称相关联，例如SDK安装包名为"dli-sdk-java-x.x.x"，对应的.sha256文件可能是"dli-sdk-java-x.x.x.sha256"。
      
   
   2. 分别下载SDK安装包和.sha256文件到本地主机，确保两个文件保存在同一个文件夹中。
    
2. **查询SDK安装包的SHA - 256哈希值**
   - **在Windows系统中**
     1. 在开始菜单中搜索"cmd"打开命令窗口。
     
     2. 使用cd命令切换到保存SDK安装包的文件夹目录。 例如：SDK安装包保存在D盘的"SDK"文件夹中，输入**cd D:\\SDK**。
        
     
     3. 执行以下命令 **certutil -hashfile *SDK安装包文件名* SHA256**
        将"SDK安装包文件名"替换为实际的SDK安装包文件名，如**certutil -hashfile sdk - package.zip SHA256**。
        
     
     4. 命令执行后，命令提示符会输出SDK安装包的SHA - 256哈希值。
      
   
   
   
   - **在Linux系统中**
     1. 使用cd命令切换到保存SDK安装包的文件夹目录。 例如，如果SDK安装包保存在用户主目录下的"SDK"文件夹中，输入**cd \~/SDK**。
        
     
     2. 输入查询命令： **sha256sum** ***SDK安装包文件名***
        将"SDK安装包文件名"替换为实际的SDK安装包文件名，如**sha256sum sdk - package.zip**。
        
     
     3. 命令执行后，终端会输出SDK安装包的SHA - 256哈希值。
      
    
3. **对比哈希值**
   1. 使用文本编辑器打开下载的.sha256文件。
   
   2. 在.sha256文件中找到SDK安装包的SHA - 256哈希值。 通常是一个长字符串，例如"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6xxxxxxxxxxxxxxxxxxxxxxxx"。
      
   
   3. 将步骤[2.查询SDK安装包的SHA - 256哈希值]得到的SDK安装包的SHA - 256哈希值与.sha256文件中的哈希值进行对比。
      - 如果两个哈希值完全一致，说明SDK安装包在下载过程中没有被篡改，文件是完整的。
      
      - 如果哈希值不一致，这可能意味着SDK安装包在下载过程中出现了错误，或者文件被恶意修改。 此时，建议重新下载SDK安装包和对应的.sha256文件，然后再次进行验证。
        
       
    
 
#### 安装SDK
- **方式一：使用Maven中央库来添加SDK**
  [Maven中央库](https://mvnrepository.com/artifact/com.huawei.dli/huaweicloud-dli-jdbc)是Apache Maven项目的一部分，提供了Java库和框架。
  在不指定SDK获取方式的情况下，默认使用Maven中央库的方式来添加SDK驱动。
  使用maven构加入huaweicloud-dli-sdk依赖的maven配置项为（此为默认操作无需单独配置。）
  ```
  <dependency>
      <groupId>com.huawei.dli</groupId>
      <artifactId>huaweicloud-dli-sdk-java</artifactId>
      <version>x.x.x</version>
   </dependency>
  ```
  
- **方式二：通过Maven配置华为镜像源来获取SDK**
  在使用Maven管理项目依赖时，可以通过修改settings.xml文件来配置华为镜像源以获取SDK。
  ```
  <mirror>
      <id>huaweicloud</id>
      <mirrorOf>*</mirrorOf>
      <url>https://mirrors.huaweicloud.com/repository/maven/</url>
  </mirror>
  ```
  
- **方式三：** **在DLI管理控制台下载JDBC驱动文件**
  1. 登录DLI管理控制台。
  
  2. 单击总览页右侧"常用链接"中的"[SDK下载](https://uquery-sdk.obs-website.cn-north-1.myhuaweicloud.com/)"。
  
  3. 在"DLI SDK DOWNLOAD"页面，选择相应驱动下载。 单击"huaweicloud-dli-sdk-java-x.x.x"即可下载对应版本的JDBC驱动包。
     ![](https://support.huaweicloud.com/sdkreference-dli/public_sys-resources/note_3.0-zh-cn.png)
     JDBC驱动包命名为"huaweicloud-dli-sdk-java-\<version\>.zip"，支持在所有平台（Linux、Windows等）所有版本中使用，且依赖JDK 1.7及以上版本。
     
  
  4. 下载的JDBC驱动包中包含了.bat（Windows）或.sh（Linux/Mac）脚本，这些脚本用于自动化安装SDK驱动到本地Maven仓库。
     您可以根据操作系统运行相应的脚本安装JDBC驱动
     - Windows：双击.bat文件或在命令行中运行。
     
     - Linux/Mac：运行.sh脚本。