入门

本主题主要提供 GBase 8s JDBC Driver 和 JDBC API 的概述。

什么是 JDBC？

Java™ 数据库连接（JDBC）是标准应用系统编程接口（API）的 JavaSoft 规范，其允许 Java 程序访问数据库管理系统。JDBC API 由一系列以 Java 编程语言编写的接口和类组成。

使用这些标准接口和类，编程人员可编写连接至数据库的应用程序，发送以结构化查询语言（SQL）编写的查询，并处理结果。

由于 JDBC 是标准规范，因此，使用 JDBC API 的一个 Java 程序可连接至任何数据库管理系统（DBMS），只要存在该特定 DBMS 的驱动程序。

什么是 JDBC 驱动程序？

JDBC API 定义 Java™ 接口和类，编程人员使用其来连接至数据库，并发送查询。JDBC 驱动程序实现特定 DBMS 供应商这些接口和类。

在使用 JDBC API 的 Java 程序实际连接至数据库之前，它为特定 DBMS 加载指定的驱动程序。然后，JDBC DriverManager 类将所有 JDBC API 调用发送至加载了的驱动程序。

有四类 JDBC 驱动程序：

JDBC-ODBC 桥加 ODBC 驱动程序，也称为 Type 1 驱动程序

将 JDBC API 调用翻译为 Microsoft™ ODBC 调用，然后将其传至 ODBC 驱动程序

必须在使用此类驱动程序的每个客户机计算机上加载 ODBC 二进制代码。

ODBC 是“开放式数据库连接”的首字母缩略词。

本地 API，一定程度上的 Java 驱动程序，也称为 Type 2 驱动程序

将 JDBC API 调用转换为特定于 DBMS 的客户机 API 调用

像桥驱动程序一样，这类驱动程序要求在每一客户机计算机上加载某些二进制代码。

JDBC-Net，纯 Java 驱动程序，也称为 Type 3 驱动程序

将 JDBC API 调用发送至中间层服务器，其将这些调用翻译为特定于 DBMS 的网络协议

然后将翻译了的调用发送至特定的 DBMS。

本地协议，纯 Java 驱动程序，也称为 Type 4 驱动程序

直接将 JDBC API 调用转换为特定于 DBMS 的网络协议，而不经过中间层

此驱动程序允许客户机应用程序直接连接至数据库服务器。

GBase 8s JDBC 驱动程序概述

GBase 8s JDBC Driver 是本地协议，纯 Java 驱动程序（Type 4）。因此，使用 GBase 8s JDBC 驱动程序时，会话直接连接至数据库或数据库服务器，而不经过中间层。

GBase 8s JDBC 驱动程序中的文件

GBase 8s JDBC驱动程序为绿色免安装版，文件名称为 gbasedbtjdbc_xx.jar (xx代表版本号)，驱动中包含如下功能：

JDBC API 接口、类和方法的优化的实现
实用程序：ClassGenerator，轻量目录访问协议（LDAP）loader，及其他

以 javac 命令的 -O 选项来编译该文件。
驱动程序支持的所有消息文本的本地化版本
包括与 DataSource 相关的、与连接池相关的以及与 XA 相关的类文件的实现

包括 SQLJ 程序的运行时刻支持的类以 javac 命令的 -O 选项来编译该文件。

客户机和服务器 JDBC 驱动程序

GBase 8s JDBC Driver 存在两个版本：客户机侧驱动程序和服务器侧驱动程序。

客户机侧驱动程序 gbasedbtjdbc_xx.jar 用于客户机 Java™ 应用程序访问 GBase 8s 数据库服务器。

服务器侧驱动程序包括 jdbc.jar ，为数据库服务器自带的一部分。由于 jdbc.jar 派生自 gbasedbtjdbc_xx.jar，因此两个驱动程序有许多共同特性。

本指南主要关于客户机侧驱动程序；然而，共同特性的信息同时适用于服务器侧和客户机侧版本。

重要提示

请不要混淆或互换服务器侧与客户机侧版本。

取得 JDBC 驱动程序

从光盘 Setup 目录下取得 GBase 8s JDBC Driver 驱动程序 gbasedbtjdbc_xx.jar 。

安装 JDBC 驱动程序

gbasedbtjdbc_xx.jar 安装包采用免安装的方式，用户无须解压和安装，可直接使用。

在应用程序中使用驱动程序

要在应用程序中使用 GBase 8s JDBC Driver，您必须设置 CLASSPATH 环境变量来指向驱动程序文件。

UNIX™

设置 CLASSPATH 环境变量的方式：

将 gbasedbtjdbc_xx.jar 的完全路径名称添加至 CLASSPATH：

setenv CLASSPATH /jdbcdriv/lib/gbasedbtjdbc_xx.jar:$CLASSPATH

Windows™

设置 CLASSPATH 环境变量的方式：

将 gbasedbtjdbc_xx.jar 的完整路径名称添加至 CLASSPATH：

set CLASSPATH=c:\jdbcdriv\lib\gbasedbtjdbc_xx.jar;%CLASSPATH%

在 applet 中使用驱动程序

可在 applet 中使用 GBase 8s JDBC Driver，来从 web 浏览器连接至 GBase 8s 数据库。下列步骤展示如何指定 applet 中的 GBase 8s JDBC Driver，以及如何确保从 web 服务器正确地下载驱动程序。

要在 applet 中使用 GBase 8s JDBC Driver，请：

在与 applet 类文件相同的目录中，安装 gbasedbtjdbc_xx.jar。
在 HTML 文件中 APPLET 标记的 ARCHIVE 属性中，指定 gbasedbtjdbc_xx.jar，如下列示例所示：

<APPLET ARCHIVE=gbasedbtjdbc_xx.jar CODE=my_applet.class
CODEBASE=http://www.myhost.com WIDTH=460 HEIGHT=160>
</APPLET>

重要

有些浏览器不支持 APPLET 标记的 ARCHIVE 属性。如果您的浏览器就是这样，则请在 web 服务器的 root 目录中解包并安装 gbasedbtjdbc_xx.jar 文件。如果您的浏览器也不支持 JDBC API，则必须在 web 服务器的 root 目录中安装 java.sql 包中包括的类文件。要获取关于在 root 目录中安装文件的信息，请参阅您的 web 服务器资料。

由于出于安全的原因，未签名的 applet 不可访问某些系统资源，因此，对于未签名的 applet，下列 GBase 8s JDBC Driver 特性不起作用：

sqlhosts 文件和 LDAP 服务器访问。如果您正在直接地或通过 LDAP 服务器来引用 sqlhosts，则数据库 URL 中的 GBase 8s 数据库服务器的主机名称和端口号属性或服务名称是可选的。

然而，对于未签名的 applet，始终需要 GBase 8s 数据库服务器的主机名称和端口号或服务名称，除非您的 applet 正在使用 HTTP 代理服务器。要获取关于 HTTP 代理服务器的更多信息，请参阅 HTTP 代理服务器。
LOBCACHE=0。在数据库 URL 中将 LOBCACHE 环境变量设置为 0，来指定始终将智能大对象存储在文件中。对于未签名的 applet，不支持此设置。

提示

通过使用 Microsoft™ Internet Explorer，可以启用未签名 applet 的这些特性，其提供配置 applet 许可的选项。

要从 applet 访问不同主机上的或防火墙之后的数据库，您可使用中间层中的 GBase 8s HTTP proxy servlet。要获取更多信息，请参阅 HTTP 代理服务器。