发 行 公 告 jconnect for JDBC 7.0 文 档 ID:DC74874-01-0700-01 最 后 修 订 日 期 :2010 年 3 月 2 日 主 题 页 码 1. 访 问 最 新 发 行 公 告 信 息 2 2. 产 品 摘 要 2 3. 特 殊 安 装 说 明 2 3.1 查 看 您 的 jconnect 版 本 3 4. 特 殊 升 级 指 导 3 4.1 迁 移 3 4.2 版 本 设 置 3 4.3 JDK 6 4 5. 此 版 本 中 的 功 能 更 改 4 6. 已 知 问 题 4 6.1 缺 少 sql_asa10.sql 和 sql_asa11.sql 脚 本 4 6.2 不 支 持 的 JDBC 功 能 4 6.3 从 JDBC 客 户 端 中 执 行 的 存 储 过 程 5 6.4 setbinarystream 中 出 现 IOException 5 6.5 带 有 错 误 的 查 询 的 输 出 5 6.6 alltablesareselectable 方 法 返 回 的 信 息 不 正 确 5 6.7 处 理 作 为 警 告 返 回 的 数 字 错 误 5 7. 文 档 更 新 和 说 明 7 7.1 JDK 版 本 7 7.2 配 置 Kerberos 7 8. 技 术 支 持 部 门 7 9. 其 它 信 息 来 源 7 9.1 Web 上 的 Sybase 认 证 8 9.2 Sybase EBF 和 软 件 维 护 9 10. 辅 助 功 能 特 性 9 版 权 所 有 2010 Sybase, Inc. 保 留 所 有 权 利 可 在 位 于 http://www.sybase.com/detail?id=1011207 的 Sybase 商 标 页 (Sybase trademarks page) 处 查 看 Sybase 商 标 Sybase 和 列 出 的 标 记 均 是 Sybase, Inc. 的 商 标 表 示 已 在 美 国 注 册 Java 和 所 有 基 于 Java 的 标 记 都 是 Sun Microsystems, Inc. 在 美 国 和 其 它 国 家 / 地 区 的 商 标 或 注 册 商 标 Unicode 和 Unicode 徽 标 是 Unicode, Inc. 的 注 册 商 标 提 到 的 所 有 其 它 公 司 和 产 品 名 均 可 能 是 与 之 相 关 的 各 自 公 司 的 商 标
1. 访 问 最 新 发 行 公 告 信 息 jconnect for JDBC 7.0 1. 访 问 最 新 发 行 公 告 信 息 最 新 版 本 的 发 行 公 告 可 以 从 网 上 获 得 若 要 查 找 在 本 产 品 发 布 后 增 加 的 重 要 产 品 或 文 档 信 息, 请 访 问 Sybase Product Manuals Web 站 点 访 问 Sybase Product Manuals Web 站 点 上 的 发 行 公 告 1 访 问 位 于 http://www.sybase.com/support/manuals/ 的 产 品 手 册 (Product Manuals) 2 选 择 一 种 产 品 和 语 言 并 单 击 查 找 (Go) 3 从 文 档 集 (Document Set) 列 表 中 选 择 一 种 产 品 版 本 4 选 择 发 行 公 告 (Release Bulletins) 链 接 5 从 列 出 的 各 文 档 中, 选 择 您 所 用 平 台 的 发 行 公 告 对 应 的 链 接 既 可 以 下 载 文 档 的 PDF 版 本, 也 可 以 在 线 浏 览 文 档 2. 产 品 摘 要 所 附 产 品 为 Sybase jconnect for JDBC 7.0 版 jconnect for JDBC 是 Sybase 对 Java JDBC 标 准 的 执 行 它 在 多 层 和 异 构 环 境 中 为 Java 开 发 人 员 提 供 本 机 数 据 库 访 问 您 无 须 事 先 安 装 客 户 端 程 序 就 能 快 速 下 载 jconnect, 将 它 与 瘦 客 户 端 Java 应 用 程 序 一 起 使 用 jconnect 不 仅 提 供 了 卓 越 的 性 能, 而 且 还 可 以 直 接 访 问 所 有 Sybase 系 列 产 品, 包 括 Adaptive Server Enterprise SQL Anywhere Sybase IQ 和 Replication Server 若 要 详 细 了 解 jconnect 7.0 及 其 功 能, 请 参 见 jconnect for JDBC 7.0 程 序 员 参 考 3. 特 殊 安 装 说 明 有 关 jconnect 的 最 新 版 本, 请 参 见 位 于 http://www.sybase.com/products/allproductsaz/softwaredeveloperkit/jconnect 的 针 对 jconnect for JDBC 的 Sybase 下 载 站 点 2 发 行 公 告
jconnect for JDBC 7.0 4. 特 殊 升 级 指 导 3.1 查 看 您 的 jconnect 版 本 若 要 查 看 现 有 jconnect 安 装 的 确 切 内 部 版 本 号, 请 从 $JDBC_HOME/classes (UNIX) 或 %JDBC_HOME%\classes (Windows) 执 行 以 下 命 令 : java -jar jconn4.jar 此 命 令 输 出 类 似 如 下 内 容 的 版 本 字 符 串 : jconnect (TM) for JDBC(TM)/7.00(Build 26464)/P/ EBF17270/JDK16/Sun Oct 11 7:47:00 2009 此 处 的 版 本 号 为 7.0 字 母 EBF 之 后 的 5 位 数 字 表 示 确 切 的 jconnect 版 本 此 编 号 随 后 续 EBF 的 发 行 而 增 长 请 下 载 并 使 用 最 新 的 版 本 4. 特 殊 升 级 指 导 若 要 升 级 到 jconnect for JDBC 7.0, 请 阅 读 本 节 内 容 有 关 详 细 信 息, 请 参 见 jconnect for JDBC 程 序 员 参 考 4.1 迁 移 jconnect 7.0 的 驱 动 程 序 代 码 驻 留 在 jconn4.jar 中 应 用 程 序 CLASSPATH 变 量 应 指 向 jconnect-7_0/classes/jconn4.jar 如 果 要 从 jconnect 5.x 或 6.x 进 行 升 级, 并 希 望 将 jconnect 7.0 驱 动 程 序 与 现 有 应 用 程 序 一 起 使 用, 您 可 能 还 需 要 更 改 应 用 程 序 代 码 请 参 见 jconnect for JDBC 程 序 员 参 考 中 的 迁 移 jconnect 应 用 程 序 4.2 版 本 设 置 jconnect 7.0 驱 动 程 序 的 缺 省 版 本 设 置 将 JCONNECT_VERSION 属 性 设 置 为 7.0 如 果 对 现 有 应 用 程 序 使 用 jconn4.jar, 可 能 会 遇 到 不 想 要 的 行 为 更 改 若 要 使 用 jconnect 7.0 但 仍 保 留 6.05 版 的 行 为, 请 将 JCONNECT_VERSION 属 性 设 置 为 6.05 注 释 如 果 在 jconnect 7.0 中 将 JCONNECT_VERSION 属 性 设 置 为 6.05, 则 无 法 使 用 jconnect 7.0 或 所 连 接 的 数 据 库 服 务 器 的 全 部 功 能 发 行 公 告 3
5. 此 版 本 中 的 功 能 更 改 jconnect for JDBC 7.0 4.3 JDK 6 若 要 使 用 jconnect 7.0 来 执 行 应 用 程 序, 请 使 用 JDK 6 或 更 高 版 本 5. 此 版 本 中 的 功 能 更 改 在 Open Server and SDK New Features for Windows, UNIX, Linux, and Mac OS X( 适 用 于 Windows UNIX Linux 和 Mac OS X 的 Open Server 和 SDK 新 增 功 能 ) 中, 可 以 找 到 jconnect 7.0 中 的 新 功 能 的 说 明 6. 已 知 问 题 本 节 介 绍 jconnect 中 的 已 知 问 题 6.1 缺 少 sql_asa10.sql 和 sql_asa11.sql 脚 本 软 件 开 发 工 具 包 (SDK) 15.5 和 jconnect 7.0 中 不 包 含 sql_asa10.sql 和 sql_asa11.sql, 这 两 个 文 件 分 别 用 于 创 建 能 让 jconnect 访 问 SQL Anywhere 10 和 SQL Anywhere 11 的 元 数 据 的 存 储 过 程 元 数 据 能 让 jconnect 和 SQL Anywhere 一 起 正 常 工 作 解 决 方 法 : 要 获 取 sql_asa10.sql 或 sql_asa11.sql 的 副 本, 请 下 载 并 安 装 jconnect 7.0 ESD #1 或 者, 可 以 使 用 jcatalog.sql, 它 位 于 SQL Anywhere 目 录 $SA_ROOT/scripts/ 中 6.2 不 支 持 的 JDBC 功 能 以 下 功 能 不 受 支 持, 将 会 引 发 NotImplemented Exception 例 外 在 将 来 的 ESD 版 本 中, 将 逐 步 增 加 对 这 些 功 能 的 支 持 : 对 于 JDBC 2.0: Connection.getTypeMap(); Connection.setTypeMap(java.util.Map typemap); PreparedStatement.setNull(int index, int sqltype, String typename); CallableStatement.getObject(int index, java.util.map typemap); CallableStatement.getObject(String parametername, java.util.map typemap); ResultSet.getObject(int index, java.util.map typemap); ResultSet.getObject(String columnname, java.util.map typemap) ResultSet.isLast(); 4 发 行 公 告
jconnect for JDBC 7.0 6. 已 知 问 题 对 于 JDBC 3.0: CallableStatement.setURL (String parametername, URL val) DatabaseMetaData.supportsStatementPooling(); PreparedStatement.setURL (int parameterindex, URL x) ResultSet.getURL(int index); ResultSet.getURL(String columnname); 对 于 JDBC 4.0, 请 参 见 jconnect for JDBC 7.0 程 序 员 参 考 6.3 从 JDBC 客 户 端 中 执 行 的 存 储 过 程 [CR #39647] 如 果 从 JDBC 客 户 端 中 执 行 某 个 存 储 过 程, 并 且 该 存 储 过 程 返 回 输 出 参 数 并 调 用 Transact-SQL 函 数 tsequal, 则 无 法 确 定 结 果 解 决 方 法 : 将 JCONNECT_VERSION 设 置 为 5 或 更 低 版 本 6.4 setbinarystream 中 出 现 IOException [CR #343354] 如 果 预 准 备 语 句 的 setbinarystream 方 法 调 用 中 指 定 的 输 入 流 出 现 IOException, 则 在 清 除 连 接 时, 如 果 操 作 不 当, 可 能 会 导 致 后 续 命 令 出 现 错 误 6.5 带 有 错 误 的 查 询 的 输 出 [CR #342782] 如 此 导 致 错 误 的 查 询 不 返 回 输 出, 即 使 此 查 询 有 结 果 也 是 6.6 alltablesareselectable 方 法 返 回 的 信 息 不 正 确 [CR #202606] DatabaseMetaData 类 的 alltablesareselectable 方 法 对 Adaptive Server 始 终 返 回 0, 对 SQL Anywhere 始 终 返 回 1 6.7 处 理 作 为 警 告 返 回 的 数 字 错 误 在 Adaptive Server 12.0 到 12.5 中, 缺 省 情 况 下, 将 数 字 错 误 作 为 严 重 级 10 进 行 处 理 严 重 级 为 10 的 消 息 归 类 为 状 态 提 示 性 消 息, 而 不 是 归 类 为 错 误, 并 且 将 其 内 容 传 输 到 SQLWarning 对 象 以 下 代 码 演 示 了 这 一 过 程 : static void processwarnings(sqlwarning warning) { if (warning!= null) { System.out.println ("\n -- Warning received -- \n"); 发 行 公 告 5
6. 已 知 问 题 jconnect for JDBC 7.0 } } while (warning!= null) { System.out.println ("Message: " + warning.getmessage()); System.out.println ("SQLState: " + warning.getsqlstate()); System.out.println ("ErrorCode: " + warning.geterrorcode()); System.out.println ("------------------------------------"); warning = warning.getnextwarning(); } 当 发 生 数 字 错 误 时, 返 回 的 ResultSet 对 象 中 不 包 含 结 果 集 数 据, 而 且 您 必 须 从 SQLWarning 中 检 索 错 误 信 息 因 此, 在 JDBC 应 用 程 序 中, 用 于 检 查 并 处 理 SQLWarning 的 代 码 将 不 返 回 结 果 集 例 如, 以 下 代 码 通 过 处 理 while 循 环 来 检 查 并 处 理 结 果 集 之 内 和 之 外 的 SQLWarning 数 据 : while (rs.next()) { String value = rs.getstring(1); System.out.println ("Fetched value: " + value); } // Check for SQLWarning on the result set. processwarnings (rs.getwarnings()); // Check for SQLWarning on the result set. processwarnings (rs.getwarnings()); 上 述 代 码 检 查 有 无 SQLWarning, 即 使 没 有 结 果 集 数 据 (rs.next( ) 为 false) 也 是 如 此 下 面 是 一 个 程 序 的 输 出, 该 程 序 用 于 检 测 一 个 数 字 除 以 零 所 导 致 的 错 误 : -- Warning received -- Message: Divide by zero occurred. SQLState: 01012 ErrorCode: 3607 6 发 行 公 告
jconnect for JDBC 7.0 7. 文 档 更 新 和 说 明 7. 文 档 更 新 和 说 明 7.1 JDK 版 本 所 用 平 台 的 jconnect for JDBC 7.0 程 序 员 参 考 和 Software Developer's Kit 15.5 Installation Guide ( 软 件 开 发 工 具 包 15.5 安 装 指 南 ) 指 明, jconnect 7.0 必 须 有 JDK 1.6 版 或 更 高 版 本 才 能 正 常 工 作 Sun Microsystems 对 此 版 本 给 出 的 官 方 名 称 叫 做 JDK 6 7.2 配 置 Kerberos 8. 技 术 支 持 部 门 9. 其 它 信 息 来 源 有 关 设 置 Kerberos 的 信 息, 请 参 见 位 于 http://www.sybase.com/detail?id=1029260 的 为 Sybase 配 置 Kerberos (Configuring Kerberos for Sybase) 白 皮 书 对 于 购 买 了 支 持 合 同 的 客 户 安 装 的 每 一 个 Sybase 产 品, 都 会 有 一 位 或 多 位 指 定 人 员 获 得 与 Sybase 技 术 支 持 部 门 联 系 的 授 权 如 果 有 关 于 安 装 的 任 何 问 题 或 安 装 期 间 需 要 帮 助, 请 让 指 定 人 员 与 Sybase 技 术 支 持 部 门 或 所 在 区 域 的 Sybase 子 公 司 联 系 使 用 Sybase Getting Started CD SyBooks CD 和 Sybase Product Manuals 网 站 可 以 了 解 有 关 产 品 的 更 多 信 息 : Getting Started CD 包 含 PDF 格 式 的 发 行 公 告 和 安 装 指 南, 还 可 能 包 含 SyBooks CD 中 未 收 纳 的 其 它 文 档 或 更 新 信 息 它 随 软 件 一 起 提 供 要 阅 读 或 打 印 Getting Started CD 上 的 文 档, 您 需 要 使 用 Adobe Acrobat Reader, 可 以 通 过 CD 上 提 供 的 链 接 从 Adobe Web 站 点 免 费 下 载 该 软 件 SyBooks CD 含 有 产 品 手 册, 该 CD 是 随 软 件 提 供 的 通 过 使 用 基 于 Eclipse 的 SyBooks 浏 览 器, 您 可 以 阅 读 简 单 易 用 且 基 于 HTML 的 格 式 的 手 册 有 些 文 档 可 能 是 以 PDF 格 式 提 供 的, 您 可 以 通 过 SyBooks CD 上 的 PDF 目 录 访 问 这 些 文 档 若 要 阅 读 或 打 印 PDF 文 件, 您 需 要 使 用 Adobe Acrobat Reader 有 关 安 装 和 启 动 SyBooks 的 操 作 说 明, 请 参 考 Getting Started CD 上 的 SyBooks 安 装 指 南 或 SyBooks CD 上 的 README.txt 文 件 发 行 公 告 7
9. 其 它 信 息 来 源 jconnect for JDBC 7.0 Sybase Product Manuals Web 站 点 是 SyBooks CD 的 联 机 版 本, 您 可 以 使 用 标 准 Web 浏 览 器 进 行 访 问 除 了 产 品 手 册 之 外, 还 可 以 找 到 有 关 EBF/ 维 护 (EBFs/Maintenance) 技 术 文 档 (Technical Documents) 案 例 管 理 (Case Management) 已 解 决 的 案 例 (Solved Cases) 新 闻 组 (Newsgroups) 和 Sybase 开 发 人 员 网 络 (Sybase Developer Network) 的 链 接 若 要 访 问 Sybase Product Manuals Web 站 点, 请 转 到 位 于 http://www.sybase.com/support/manuals/ 的 产 品 手 册 (Product Manuals) 9.1 Web 上 的 Sybase 认 证 Sybase Web 站 点 上 的 技 术 文 档 不 断 在 更 新 查 找 有 关 产 品 认 证 的 最 新 信 息 1 将 Web 浏 览 器 定 位 到 位 于 http://www.sybase.com/support/techdocs/ 的 技 术 文 档 (Technical Documents) 2 单 击 合 作 伙 伴 认 证 报 告 (Partner Certification Report) 3 在 合 作 伙 伴 认 证 报 告 (Partner Certification Report) 过 滤 器 中 选 择 相 应 的 产 品 平 台 和 时 间 范 围, 然 后 单 击 查 找 (Go) 4 单 击 合 作 伙 伴 认 证 报 告 (Partner Certification Report) 标 题 显 示 此 报 告 查 找 有 关 组 件 认 证 的 最 新 信 息 1 将 Web 浏 览 器 定 位 到 位 于 http://certification.sybase.com/ 的 可 用 性 和 认 证 报 告 (Availability and Certification Reports) 2 在 按 基 本 产 品 搜 索 (Search by Base Product) 下 选 择 产 品 系 列 和 产 品, 或 在 按 平 台 搜 索 (Search by Platform) 下 选 择 平 台 和 产 品 3 选 择 搜 索 (Search) 以 显 示 所 选 项 目 的 可 用 性 和 认 证 报 告 创 建 Sybase Web 站 点 ( 包 括 支 持 页 ) 的 个 人 化 视 图 建 立 MySybase 配 置 文 件 MySybase 是 一 项 免 费 服 务, 它 允 许 您 创 建 Sybase Web 页 的 个 人 化 视 图 1 将 Web 浏 览 器 定 位 到 位 于 http://www.sybase.com/support/techdocs/ 的 技 术 文 档 (Technical Documents) 2 单 击 我 的 Sybase (MySybase) 并 创 建 MySybase 配 置 文 件 8 发 行 公 告
jconnect for JDBC 7.0 10. 辅 助 功 能 特 性 9.2 Sybase EBF 和 软 件 维 护 查 找 有 关 EBF 和 软 件 维 护 的 最 新 信 息 1 将 Web 浏 览 器 定 位 到 位 于 http://www.sybase.com/support 的 Sybase 支 持 页 (Sybase Support Page) 2 选 择 EBF/ 维 护 (EBFs/Maintenance) 如 果 出 现 提 示 信 息, 请 输 入 您 的 MySybase 用 户 名 和 口 令 3 选 择 一 个 产 品 4 指 定 时 间 范 围 并 单 击 查 找 (Go) 即 会 显 示 EBF/ 维 护 版 本 的 列 表 锁 形 图 标 表 示 由 于 您 没 有 注 册 为 技 术 支 持 联 系 人 (Technical Support Contact), 因 此 您 没 有 某 些 EBF/ 维 护 (EBF/Maintenance) 版 本 的 下 载 授 权 如 果 您 尚 未 注 册, 但 拥 有 Sybase 代 表 提 供 的 或 通 过 支 持 合 同 获 得 的 有 效 信 息, 请 单 击 Edit Roles ( 编 辑 角 色 ) 将 Technical Support Contact ( 技 术 支 持 联 系 人 ) 角 色 添 加 到 MySybase 配 置 文 件 中 5 单 击 信 息 图 标 可 显 示 EBF/ 维 护 报 告, 单 击 产 品 说 明 可 下 载 软 件 10. 辅 助 功 能 特 性 本 文 档 具 有 为 提 供 辅 助 功 能 而 进 行 了 专 门 设 计 的 HTML 版 本 可 以 利 用 适 应 性 技 术 ( 如 屏 幕 阅 读 器 ) 浏 览 HTML 文 档, 也 可 以 用 屏 幕 放 大 器 进 行 查 看 jconnect for JDBC 7.0 版 和 HTML 文 档 已 进 行 了 测 试, 符 合 美 国 政 府 第 508 节 辅 助 功 能 的 要 求 符 合 第 508 节 要 求 的 文 档 一 般 也 符 合 非 美 国 的 辅 助 功 能 原 则, 如 针 对 Web 站 点 的 World Wide Web 协 会 (W3C) 原 则 此 产 品 的 联 机 帮 助 也 是 以 HTML 格 式 提 供 的, 您 可 以 使 用 屏 幕 阅 读 器 进 行 浏 览 注 释 您 可 能 需 要 对 辅 助 功 能 工 具 进 行 配 置 以 实 现 最 优 化 某 些 屏 幕 阅 读 器 按 照 大 小 写 来 辨 别 文 本, 例 如 将 ALL UPPERCASE TEXT 看 作 首 字 母 缩 写, 而 将 MixedCase Text 看 作 单 词 对 工 具 进 行 配 置, 规 定 语 法 约 定, 您 可 能 会 感 觉 更 方 便 有 关 工 具 的 信 息, 请 查 阅 文 档 发 行 公 告 9
10. 辅 助 功 能 特 性 jconnect for JDBC 7.0 有 关 Sybase 如 何 支 持 辅 助 功 能 的 信 息, 请 参 见 位 于 http://www.sybase.com/accessibility 的 Sybase 辅 助 功 能 (Sybase Accessibility) Sybase Accessibility 站 点 包 括 指 向 有 关 第 508 节 和 W3C 标 准 的 信 息 的 链 接 10 发 行 公 告