#安装YashanDB JDBC驱动

# JVM环境安装

通用Java应用程序连接YashanDB JDBC驱动需要先安装JDK，YashanDB JDBC驱动对JDK版本兼容信息如下：

• JDK：1.8及以上

• JRE：1.8及以上

通过Java官方路径下载上述版本的JDK并安装成功后，还需配置如下环境变量（以Windows 10环境为例）：

• JAVA_HOME：C:\Program Files\Java\jdk1.8.0_231（JDK目录路径）

• PATH：%JAVA_HOME%\bin;%PATH%

• CLASSPATH：.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar

配置完成后，通过运行java -version验证Java环境是否正常：

>java -version
java version "1.8.0_231"
Java(TM) SE Runtime Environment (build 1.8.0_231-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.231-b11, mixed mode)

# 通过Maven安装YashanDB JDBC驱动

在项目中使用Maven管理器配置yashandb-jdbc库。

yashandb-jdbc发表在The Maven (opens new window)上，具有以下Group ID和artifactId：

• Group ID：com.yashandb

• artifactId：yashandb-jdbc

在项目中的pom.xml文件中添加以下依赖项：

<dependency>
    <groupId>com.yashandb</groupId>
    <artifactId>yashandb-jdbc</artifactId>
    <version>x.y.z</version>
</dependency>

Note:

x.y.z表示可用的JDBC版本号，例如1.6.1。

# 离线安装YashanDB JDBC驱动

1. 参考YashanDB软件包清单获取YashanDB JDBC驱动安装包yasdb-jdbc-版本号.jar，例如yasdb-jdbc-23.2.jar。

2. 将jar文件下载到本地路径，例如/path/yasdb-jdbc-23.2.jar。

3. 将YashanDB JDBC驱动加入到JVM环境中：

   • 对于在命令行运行的Java应用程序（以Linux环境为例）

   # 预先加入方式
   export CLASSPATH=/path/yasdb-jdbc-23.2.jar:${CLASSPATH} 
   
   # JVM运行时加入方式，Jdbcexample为应用程序名称
   java -cp .:/path/yasdb-jdbc-23.2.jar Jdbcexample
   

   Copied!
   • 对于在IDE运行的Java应用程序

   每个IDE产品均会提供配置外部library的界面，根据提示将YashanDB JDBC驱动的jar文件添加到project。以IDEA为例：

   

4. 在Java应用程序中加载YashanDB JDBC驱动，驱动名称为com.yashandb.jdbc.Driver：

   # 方式一：在代码中创建连接之前任意位置隐含装载
   Class.forName("com.yashandb.jdbc.Driver");
   
   # 方式二：在JVM启动时参数传递，Jdbcexample为应用程序名称
   java -Djdbc.drivers=com.yashandb.jdbc.Driver Jdbcexample
   

   Copied!

   完成加载后，即可开始通过YashanDB JDBC驱动连接和操作数据库。