↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

不受支持的版本: 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本PostgreSQL 7.4 已于 2010 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本手册首页。

第 31 章 JDBC 接口

JDBC 是 Java 1.1 及更高版本的核心 API。 它为兼容 SQL 的数据库提供了一组标准 接口。

PostgreSQL 提供一个 4 类(type 4) JDBC 驱动。4 类(type 4)表示 该驱动用纯 Java 编写,并使用数据库系统自己的网络协议 通信。因此,该驱动是平台无关的;一旦编译完成,就可以在任何 系统上使用。

本章并不是一份完整的 JDBC 编程 指南,但应该能帮助你入门。更多信息请参阅标准的 JDBC API 文档。 另外,也可以看看源码中附带的例子。

31.1. 设置 JDBC 驱动 #

本节描述在编写或运行使用 JDBC 接口的程序之前需要 做的准备工作。

31.1.1. 获取驱动 #

可以从 PostgreSQL JDBC 网站 下载预编译版本的驱动。

你也可以从源码构建驱动,但只有在你修改源代码时才需要 这样做。详情请参阅 PostgreSQL 安装说明。 安装之后,驱动应该位于 PREFIX/share/java/postgresql.jar。 构建出的驱动将针对你正在使用的 Java 版本构建。如果你用 1.1 版 JDK 构建,会得到一个支持 JDBC 1 规范的 版本;如果用 1.2 或 1.3 版 JDK 构建,会得到一个支持 JDBC 2 规范的版本;最后,如果用 1.4 版 JDK 构建,会得到一个支持 JDBC 3 规范的版本。

31.1.2. 设置类路径 #

要使用该驱动,需要把 JAR 归档(如果你是从源码构建的,它名为 postgresql.jar,否则它可能名为 pg7.4jdbc1.jar、 pg7.4jdbc2.jar 或 pg7.4jdbc3.jar,分别对应 JDBC 1、 JDBC 2 和 JDBC 3 版本) 包含在类路径中,可以把它放入 CLASSPATH 环境变量,或者在 java 命令行上使用相应的标志。

例如,假设我们有一个应用程序使用 JDBC 驱动访问数据库,并且该 应用程序安装在 /usr/local/lib/myapp.jar。PostgreSQL JDBC 驱动安装为 /usr/local/pgsql/share/java/postgresql.jar。要运行 该应用程序,我们可以使用:

export CLASSPATH=/usr/local/lib/myapp.jar:/usr/local/pgsql/share/java/postgresql.jar:.
java MyApp

在应用程序内载入驱动的内容在 第 31.2 节 中介绍。

31.1.3. 为 JDBC 准备数据库服务器 #

由于 Java 只使用 TCP/IP 连接,必须把 PostgreSQL 服务器配置为 接受 TCP/IP 连接。这可以通过在 postgresql.conf 文件中设置 tcpip_socket = true,或者在启动 postmaster 时提供 -i 选项标志来完成。

另外,可能还需要配置 pg_hba.conf 文件中的客户端认证设置。 详情请参阅 第 19 章。 JDBC 驱动支持 trust、 ident、password、md5 和 crypt 认证方法。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。