文 档 ID:DC 最 后 修 订 日 期 :2009 年 10 月 版 权 所 有 2010 Sybase, Inc. 保 留 所 有 权 利 本 出 版 物 适 用 于 Sybase 软 件 和 任 何 后 续 版 本, 除 非 在 新 版 本 或 技 术 声 明

Transcription

1 Adaptive Server Enterprise 中 的 Java Adaptive Server Enterprise 15.5

2 文 档 ID:DC 最 后 修 订 日 期 :2009 年 10 月 版 权 所 有 2010 Sybase, Inc. 保 留 所 有 权 利 本 出 版 物 适 用 于 Sybase 软 件 和 任 何 后 续 版 本, 除 非 在 新 版 本 或 技 术 声 明 中 另 有 说 明 此 文 档 中 的 信 息 如 有 更 改, 恕 不 另 行 通 知 此 处 说 明 的 软 件 按 许 可 协 议 提 供, 其 使 用 和 复 制 必 须 符 合 该 协 议 的 条 款 若 要 订 购 附 加 文 档, 美 国 和 加 拿 大 的 客 户 请 拨 打 客 户 服 务 部 门 电 话 (800) 或 发 传 真 至 (617) 持 有 美 国 许 可 协 议 的 其 它 国 家 / 地 区 的 客 户 可 通 过 上 述 传 真 号 码 与 客 户 服 务 部 门 联 系 所 有 其 它 国 际 客 户 请 与 Sybase 子 公 司 或 当 地 分 销 商 联 系 仅 在 定 期 安 排 的 软 件 发 布 日 期 提 供 升 级 未 经 Sybase, Inc. 的 事 先 书 面 许 可, 本 手 册 的 任 何 部 分 不 得 以 任 何 形 式 任 何 手 段 ( 电 子 的 机 械 的 手 动 光 学 的 或 其 它 手 段 ) 进 行 复 制 传 播 或 翻 译 Sybase 商 标 可 在 位 于 的 Sybase 商 标 页 (Sybase trademarks page) 上 进 行 查 看 Sybase 和 文 中 列 出 的 标 记 均 是 Sybase, Inc. 的 商 标 表 示 已 在 美 国 注 册 Java 和 所 有 基 于 Java 的 标 记 都 是 Sun Microsystems, Inc. 在 美 国 和 其 它 国 家 / 地 区 的 商 标 或 注 册 商 标 Unicode 和 Unicode 徽 标 是 Unicode, Inc. 的 注 册 商 标 IBM 和 Tivoli 是 International Business Machines Corporation 在 美 国 和 / 或 其 它 国 家 / 地 区 的 注 册 商 标 提 到 的 所 有 其 它 公 司 和 产 品 名 均 可 能 是 与 之 相 关 的 相 应 公 司 的 商 标 政 府 使 用 复 制 或 公 开 的 行 为 受 适 用 于 DOD 的 DFARS 中 的 段 落 (c)(1)(ii) 的 约 束, 同 时 受 适 用 于 民 间 机 构 的 FAR (a)-(d) 的 约 束 Sybase, Inc., One Sybase Drive, Dublin, CA

3 目 录 关 于 本 手 册... ix 第 1 章 数 据 库 中 的 Java 简 介... 1 数 据 库 中 的 Java 的 优 点... 1 数 据 库 中 Java 的 功 能... 2 在 数 据 库 中 调 用 Java 方 法... 2 将 Java 类 存 储 为 数 据 库 类 型... 3 在 数 据 库 中 存 储 和 查 询 XML... 3 Java 组 件... 3 Adaptive Server 和 更 高 版 本 中 的 功 能 变 化... 4 类 分 发 变 化... 4 PCA/JVM 在 无 人 参 与 模 式 下 运 行... 4 内 存 管 理 变 化... 5 类 装 载 程 序 行 为 变 化... 5 标 准... 5 数 据 库 中 的 Java: 问 题 和 解 答... 6 主 要 功 能 有 哪 些?... 6 如 何 在 数 据 库 中 存 储 Java 指 令?... 6 如 何 在 数 据 库 中 执 行 Java?... 7 支 持 哪 些 Java 虚 拟 机 (JVM)?... 7 什 么 是 无 人 参 与 模 式?... 7 什 么 是 JDBC?... 7 如 何 将 Java 与 SQL 一 起 使 用?... 8 什 么 是 Java API?... 8 Java API 支 持 哪 些 Java 类?... 8 是 否 可 以 在 数 据 库 中 安 装 用 户 定 义 的 类?... 8 是 否 可 以 使 用 Java 访 问 数 据?... 9 是 否 可 以 在 客 户 端 和 服 务 器 上 使 用 相 同 的 类?... 9 如 何 在 SQL 中 使 用 Java 类... 9 在 何 处 查 找 数 据 库 中 的 Java 的 相 关 信 息? 不 能 使 用 数 据 库 中 的 Java 执 行 的 操 作 Adaptive Server Enterprise 中 的 Java iii

4 目 录 第 2 章 管 理 Java 环 境 Java 环 境 组 件 JVM 可 插 入 组 件 可 插 入 组 件 适 配 器 /JVM (PCA/JVM) 可 插 入 组 件 接 口 (PCI) 和 PCI 桥 PCI 内 存 池 sybpcidb 数 据 库 如 何 在 sybpcidb 中 组 织 配 置 值 何 时 更 改 配 置 值 服 务 器 级 选 项 PCI 桥 的 配 置 选 项 PCA/JVM 的 配 置 选 项 在 运 行 的 服 务 器 中 更 改 配 置 值 重 新 启 动 Adaptive Server 以 更 改 配 置 值 在 初 始 化 JVM 之 前 更 改 配 置 值 在 初 始 化 JVM 之 后 更 改 配 置 值 将 缺 省 配 置 值 恢 复 为 sybpcidb 使 用 监 控 表 显 示 有 关 PCI 桥 的 信 息 第 3 章 在 数 据 库 中 准 备 和 维 护 Java Java 运 行 时 环 境 数 据 库 中 的 Java 类 JDBC 驱 动 程 序 JVM 启 用 Java 在 数 据 库 中 安 装 Java 类 使 用 installjava 引 用 其 它 Java-SQL 类 查 看 有 关 安 装 的 类 和 JAR 的 信 息 下 载 安 装 的 类 和 JAR 删 除 类 和 JAR 保 留 类 第 4 章 在 SQL 中 使 用 Java 类 一 般 概 念 使 用 Java 需 要 考 虑 的 事 项 Java-SQL 名 称 使 用 Java 类 作 为 数 据 类 型 创 建 和 更 改 包 含 Java-SQL 列 的 表 选 择 插 入 更 新 和 删 除 Java 对 象 在 SQL 中 调 用 Java 方 法 方 法 示 例 Java-SQL 方 法 中 的 例 外 iv Adaptive Server Enterprise 15.5

5 目 录 表 示 Java 实 例 Java-SQL 数 据 项 的 赋 值 属 性 Java 和 SQL 字 段 之 间 的 数 据 类 型 映 射 数 据 和 标 识 符 的 字 符 集 Java-SQL 数 据 中 的 子 类 型 扩 大 转 换 缩 小 转 换 运 行 时 与 编 译 期 数 据 类 型 对 Java-SQL 数 据 中 的 空 值 的 处 理 对 空 值 实 例 字 段 与 方 法 的 引 用 空 值 作 为 Java-SQL 方 法 的 参 数 使 用 SQL convert 函 数 时 的 空 值 Java-SQL string 数 据 零 长 度 字 符 串 类 型 和 无 类 型 方 法 Java 无 类 型 实 例 方 法 Java 无 类 型 静 态 方 法 等 同 性 和 排 序 运 算 求 值 顺 序 和 Java 方 法 调 用 列 变 量 和 参 数 表 达 式 中 的 确 定 性 Java 函 数 Java-SQL 类 中 的 静 态 变 量 Adaptive Server 和 更 高 版 本 中 的 静 态 变 量 更 改 Cluster Edition 中 的 静 态 变 量 更 改 多 个 数 据 库 中 的 Java 类 范 围 跨 数 据 库 引 用 类 间 传 送 传 递 类 间 参 数 临 时 数 据 库 和 工 作 数 据 库 Java 类 第 5 章 使 用 JDBC 访 问 数 据 概 述 JDBC 概 念 和 术 语 客 户 端 与 服 务 器 端 JDBC 之 间 的 差 异 权 限 使 用 JDBC 访 问 数 据 JDBCExamples 类 的 概 述 main( ) 和 servermain( ) 方 法 获 得 一 个 JDBC 连 接 :Connecter( ) 方 法 将 操 作 传 递 给 其 它 方 法 :doaction( ) 方 法 执 行 必 要 的 SQL 操 作 :dosql( ) 方 法 Adaptive Server Enterprise 中 的 Java v

6 目 录 执 行 update 语 句 :updater( ) 方 法 执 行 select 语 句 :selecter( ) 方 法 调 用 SQL 存 储 过 程 :caller( ) 方 法 本 机 JDBC 驱 动 程 序 中 的 错 误 处 理 JDBCExamples 类 main() 方 法 servermain( ) 方 法 connecter( ) 方 法 doaction( ) 方 法 dosql( ) 方 法 updater( ) 方 法 selecter( ) 方 法 caller( ) 方 法 第 6 章 SQLJ 函 数 和 存 储 过 程 概 述 符 合 SQLJ 第 1 部 分 规 范 一 般 问 题 安 全 性 和 权 限 SQLJ 示 例 在 Adaptive Server 中 调 用 Java 方 法 使 用 Sybase Central 管 理 SQLJ 函 数 和 过 程 SQLJ 用 户 定 义 函 数 处 理 空 参 数 值 删 除 SQLJ 函 数 名 SQLJ 存 储 过 程 修 改 SQL 数 据 使 用 输 入 和 输 出 参 数 返 回 结 果 集 查 看 有 关 SQLJ 函 数 和 过 程 的 信 息 高 级 主 题 映 射 Java 和 SQL 数 据 类 型 使 用 命 令 main 方 法 SQLJ 和 Sybase 实 现 : 比 较 SQLJExamples 类 第 7 章 在 数 据 库 中 调 试 Java 支 持 的 Java 调 试 程 序 设 置 Java 调 试 配 置 服 务 器 以 支 持 调 试 将 远 程 调 试 程 序 连 接 到 JVM 调 试 代 理 vi Adaptive Server Enterprise 15.5

7 目 录 第 8 章 使 用 Java 访 问 文 件 和 网 络 使 用 java.io 访 问 文 件 用 户 标 识 和 权 限 指 定 文 件 I/O 目 录 :UNIX 平 台 指 定 文 件 I/O 目 录 :Windows 平 台 文 件 I/O 更 改 打 开 现 有 文 件 的 规 则 使 用 文 件 打 开 操 作 创 建 文 件 的 规 则 最 终 文 件 检 查 使 用 java.net 访 问 文 件 示 例 第 9 章 其 它 主 题 服 务 器 中 的 Java 类 的 JDK 要 求 赋 值 编 译 期 赋 值 规 则 运 行 时 赋 值 规 则 允 许 的 转 换 将 Java-SQL 对 象 传 送 到 客 户 端 改 善 性 能 的 建 议 最 大 限 度 降 低 从 SQL 到 JVM 的 调 用 数 应 小 心 使 用 java.lang.thread 类 确 定 是 否 在 PCA/JVM 中 运 行 避 免 在 多 引 擎 环 境 中 使 用 SQL 循 环 控 制 在 PCA/JVM 中 访 问 本 机 方 法 不 支 持 的 Java API 包 类 和 方 法 受 限 制 的 Java 包 类 和 方 法 不 支 持 的 java.sql 方 法 和 接 口 从 Java 中 调 用 SQL 特 殊 注 意 事 项 Java 方 法 中 的 Transact-SQL 命 令 Java 和 SQL 之 间 的 数 据 类 型 映 射 Java-SQL 标 识 符 Java-SQL 类 和 包 名 称 Java-SQL 列 声 明 Java-SQL 变 量 声 明 Java-SQL 列 引 用 Java-SQL 成 员 引 用 Java-SQL 方 法 调 用 词 汇 表 索 引 Adaptive Server Enterprise 中 的 Java vii

8 目 录 viii Adaptive Server Enterprise 15.5

9 关 于 本 手 册 读 者 本 手 册 的 目 标 读 者 是 Sybase 系 统 管 理 员 数 据 库 所 有 者 以 及 熟 悉 Java 编 程 语 言 和 Transact-SQL 的 用 户 其 中,Transact-SQL 是 Sybase 版 本 的 结 构 化 查 询 语 言 (SQL) 假 定 使 用 这 些 功 能 的 用 户 均 已 熟 悉 Java 数 据 库 连 接 (JDBC) 如 何 使 用 本 手 册 本 手 册 将 帮 助 您 在 Adaptive Server 数 据 库 中 安 装 配 置 和 使 用 Java 类 和 方 法 其 中 包 括 以 下 章 节 : 第 1 章 数 据 库 中 的 Java 简 介, 简 要 介 绍 了 Adaptive Server 中 的 Java, 其 中 包 括 为 初 学 者 和 有 经 验 的 Java 用 户 提 供 的 问 题 和 解 答 部 分 第 2 章 管 理 Java 环 境, 介 绍 Java 环 境 组 件 以 及 如 何 管 理 它 们 第 3 章 在 数 据 库 中 准 备 和 维 护 Java, 介 绍 Java 运 行 时 环 境 以 及 安 装 Java 类 的 步 骤 第 4 章 在 SQL 中 使 用 Java 类, 介 绍 如 何 在 Adaptive Server 数 据 库 中 使 用 Java-SQL 类 第 5 章 使 用 JDBC 访 问 数 据, 介 绍 如 何 使 用 JDBC 驱 动 程 序 ( 在 服 务 器 或 客 户 端 上 ) 在 Java 中 执 行 SQL 操 作 第 6 章 SQLJ 函 数 和 存 储 过 程, 介 绍 如 何 在 SQL 包 装 中 装 入 和 使 用 Java 方 法 第 7 章 在 数 据 库 中 调 试 Java, 介 绍 如 何 在 数 据 库 中 调 试 Java 第 8 章 使 用 Java 访 问 文 件 和 网 络, 介 绍 如 何 使 用 java.net, 该 软 件 包 可 用 于 创 建 通 过 TCP/IP 连 接 的 网 络 应 用 程 序, 并 能 使 在 Adaptive Server 中 运 行 的 类 访 问 不 同 的 服 务 器 第 9 章 其 它 主 题, 提 供 数 据 类 型 映 射 Java-SQL 语 法 性 能 改 善 以 及 其 它 有 用 的 信 息 此 外, 还 提 供 了 一 个 词 汇 表, 用 于 介 绍 在 本 手 册 中 使 用 的 Java 和 Java-SQL 术 语 Adaptive Server Enterprise 中 的 Java ix

10 相 关 文 档 Adaptive Server Enterprise 文 档 集 包 括 : 针 对 所 用 平 台 的 发 行 公 告 包 含 未 能 及 时 写 入 手 册 的 最 新 信 息 最 新 版 本 的 发 行 公 告 可 能 已 经 推 出 若 要 了 解 本 产 品 CD 发 行 以 后 增 加 的 重 要 产 品 或 文 档 信 息, 请 使 用 Sybase Product Manuals 网 站 针 对 所 用 平 台 的 安 装 指 南 介 绍 所 有 Adaptive Server 产 品 及 相 关 Sybase 产 品 的 安 装 过 程 升 级 过 程 和 一 些 配 置 过 程 New Feature Summary ( 新 增 功 能 摘 要 ) 介 绍 Adaptive Server 中 的 新 增 功 能 为 支 持 这 些 功 能 所 做 的 系 统 更 改, 以 及 可 能 会 影 响 现 有 应 用 程 序 的 更 改 Active Messaging Users Guide ( Active Messaging 用 户 指 南 ) 介 绍 如 何 使 用 Active Messaging 功 能 捕 获 Adaptive Server Enterprise 数 据 库 中 的 事 务 ( 数 据 更 改 ), 并 将 它 们 作 为 事 件 实 时 传 送 到 外 部 应 用 程 序 组 件 集 成 服 务 用 户 指 南 介 绍 如 何 使 用 组 件 集 成 服 务 功 能 来 连 接 远 程 Sybase 数 据 库 和 非 Sybase 数 据 库 针 对 所 用 平 台 的 Configuration Guide ( 配 置 指 南 ) 提 供 执 行 特 定 配 置 任 务 的 说 明 词 汇 表 定 义 Adaptive Server 文 档 中 使 用 的 技 术 术 语 Historical Server 用 户 指 南 介 绍 如 何 使 用 Historical Server 从 Adaptive Server 获 取 性 能 信 息 Adaptive Server Enterprise 中 的 Java 介 绍 如 何 在 Adaptive Server 数 据 库 中 安 装 Java 类 以 及 如 何 将 它 们 用 作 数 据 类 型 函 数 和 存 储 过 程 Job Scheduler 用 户 指 南 提 供 有 关 如 何 使 用 命 令 行 或 图 形 用 户 界 面 (GUI) 在 本 地 或 远 程 Adaptive Server 上 进 行 安 装 和 配 置 以 及 创 建 和 调 度 作 业 的 说 明 迁 移 技 术 指 南 介 绍 迁 移 到 其 它 版 本 的 Adaptive Server 所 需 的 策 略 和 工 具 Monitor Client Library 程 序 员 指 南 介 绍 如 何 编 写 可 访 问 Adaptive Server 性 能 数 据 的 Monitor Client Library 应 用 程 序 Monitor Server 用 户 指 南 介 绍 如 何 使 用 Monitor Server 从 Adaptive Server 获 取 性 能 统 计 信 息 Monitoring Tables Diagram ( 监 控 表 框 图 ) 以 张 贴 画 格 式 阐 明 监 控 表 及 其 实 体 关 系 大 图 只 在 印 刷 品 中 提 供 ; 采 用 PDF 格 式 时 提 供 缩 略 图 x Adaptive Server Enterprise 15.5

11 关 于 本 手 册 Performance and Tuning Series ( 性 能 和 调 优 系 列 ) 是 一 套 系 列 丛 书, 介 绍 如 何 调 节 Adaptive Server 以 获 得 最 佳 性 能 : Basics ( 基 础 知 识 ) 包 含 了 解 和 研 究 Adaptive Server 中 的 性 能 问 题 需 具 备 的 基 础 知 识 Improving Performance with Statistical Analysis ( 利 用 统 计 分 析 改 进 性 能 ) 介 绍 Adaptive Server 如 何 存 储 和 显 示 统 计 信 息, 以 及 如 何 使 用 set statistics 命 令 分 析 服 务 器 统 计 信 息 Locking and Concurrency Control ( 锁 定 和 并 发 控 制 ) 介 绍 如 何 使 用 锁 定 方 案 提 高 性 能, 以 及 如 何 选 择 索 引 以 最 大 限 度 地 减 少 并 发 Monitoring Adaptive Server with sp_sysmon ( 使 用 sp_sysmon 监 控 Adaptive Server ) 讨 论 如 何 使 用 sp_sysmon 监 控 性 能 Monitoring Tables ( 监 控 表 ) 介 绍 如 何 从 Adaptive Server 监 控 表 中 查 询 统 计 信 息 和 诊 断 信 息 Physical Database Tuning ( 物 理 数 据 库 调 优 ) 介 绍 如 何 管 理 物 理 数 据 放 置 为 数 据 分 配 的 空 间 以 及 临 时 数 据 库 Query Processing and Abstract Plans ( 查 询 处 理 和 抽 象 计 划 ) 介 绍 优 化 程 序 如 何 处 理 查 询 以 及 如 何 使 用 抽 象 计 划 更 改 某 些 优 化 程 序 计 划 快 速 参 考 指 南 这 是 一 本 袖 珍 手 册, 完 整 地 列 出 了 各 种 命 令 函 数 系 统 过 程 扩 展 系 统 过 程 数 据 类 型 和 实 用 程 序 的 名 称 和 语 法 ( 该 手 册 在 用 PDF 格 式 查 看 时 采 用 正 常 大 小 ) 参 考 手 册 是 一 套 系 列 丛 书, 其 中 包 含 详 细 的 Transact-SQL 信 息 : 构 件 块 讨 论 数 据 类 型 函 数 全 局 变 量 表 达 式 标 识 符 通 配 符 和 保 留 字 命 令 提 供 各 种 命 令 的 文 档 资 料 过 程 介 绍 系 统 过 程 目 录 存 储 过 程 系 统 扩 展 存 储 过 程 和 dbcc 存 储 过 程 表 讨 论 系 统 表 监 控 表 和 dbcc 表 Adaptive Server Enterprise 中 的 Java xi

12 系 统 管 理 指 南 系 统 管 理 指 南, 卷 1 介 绍 系 统 管 理 的 基 础 知 识, 其 中 包 括 对 配 置 参 数 资 源 问 题 字 符 集 排 序 顺 序 的 说 明 以 及 有 关 诊 断 系 统 问 题 的 说 明 系 统 管 理 指 南, 卷 1 的 后 半 部 分 对 安 全 性 管 理 进 行 了 深 入 讨 论 系 统 管 理 指 南, 卷 2 包 括 针 对 管 理 物 理 资 源 镜 像 设 备 配 置 内 存 和 数 据 高 速 缓 存 管 理 多 处 理 器 服 务 器 和 用 户 数 据 库 装 入 和 卸 下 数 据 库 创 建 和 使 用 段 使 用 reorg 命 令 以 及 检 查 数 据 库 一 致 性 的 说 明 和 指 南 系 统 管 理 指 南, 卷 2 的 后 半 部 分 介 绍 了 如 何 备 份 和 恢 复 系 统 数 据 库 和 用 户 数 据 库 System Tables Diagram ( 系 统 表 框 图 ) 以 张 贴 画 格 式 阐 明 系 统 表 及 其 实 体 关 系 大 图 只 在 印 刷 品 中 提 供 ; 采 用 PDF 格 式 时 提 供 缩 略 图 Transact-SQL 用 户 指 南 提 供 有 关 Transact-SQL 这 一 Sybase 关 系 数 据 库 语 言 增 强 版 的 文 档 资 料 该 指 南 可 用 作 数 据 库 管 理 系 统 初 级 用 户 的 教 科 书, 其 中 还 包 含 有 关 pubs2 和 pubs3 示 例 数 据 库 的 详 细 说 明 Troubleshooting: Error Messages Advanced Resolutions ( 故 障 排 除 : 错 误 消 息 高 级 解 析 ) 包 含 针 对 您 可 能 遇 到 的 问 题 的 故 障 排 除 过 程 其 中 讨 论 了 Sybase 技 术 支 持 人 员 最 常 听 到 的 问 题 加 密 列 用 户 指 南 介 绍 如 何 通 过 Adaptive Server 配 置 和 使 用 加 密 列 内 存 数 据 库 用 户 指 南 介 绍 如 何 配 置 和 使 用 内 存 数 据 库 Using Adaptive Server Distributed Transaction Management Features ( 使 用 Adaptive Server 分 布 式 事 务 管 理 功 能 ) 介 绍 如 何 在 分 布 式 事 务 处 理 环 境 中 配 置 使 用 Adaptive Server DTM 功 能 以 及 如 何 排 除 其 中 的 故 障 将 Backup Server 与 IBM Tivoli Storage Manager 配 合 使 用 介 绍 如 何 设 置 和 使 用 IBM Tivoli Storage Manager 以 创 建 Adaptive Server 备 份 在 高 可 用 性 系 统 中 使 用 Sybase 故 障 切 换 提 供 有 关 使 用 Sybase 的 故 障 切 换 功 能 将 Adaptive Server 配 置 为 高 可 用 性 系 统 中 的 协 同 服 务 器 的 说 明 Unified Agent and Agent Management Console ( Unified Agent 和 Agent Management Console ) 介 绍 Unified Agent, 它 用 于 提 供 管 理 监 控 和 控 制 分 布 式 Sybase 资 源 的 运 行 时 服 务 xii Adaptive Server Enterprise 15.5

13 关 于 本 手 册 其 它 信 息 来 源 实 用 程 序 指 南 提 供 有 关 在 操 作 系 统 级 别 执 行 的 Adaptive Server 实 用 程 序 ( 如 isql 和 bcp) 的 文 档 资 料 Web 服 务 用 户 指 南 介 绍 如 何 配 置 使 用 Adaptive Server 的 Web 服 务 以 及 如 何 排 除 其 中 的 故 障 XA Interface Integration Guide for CICS, Encina, and TUXEDO( 适 用 于 CICS Encina 和 TUXEDO 的 XA 接 口 集 成 指 南 ) 提 供 有 关 将 Sybase DTM XA 接 口 与 X/Open XA 事 务 管 理 器 配 合 使 用 的 说 明 Adaptive Server Enterprise 中 的 XML 服 务 介 绍 Sybase 本 机 XML 处 理 器 和 Sybase 基 于 Java 的 XML 支 持 以 及 数 据 库 中 的 XML, 并 提 供 了 XML 服 务 中 可 用 的 查 询 和 映 射 函 数 的 文 档 资 料 可 以 使 用 Sybase Getting Started CD SyBooks CD 和 Sybase Product Manuals 网 站 了 解 有 关 产 品 的 更 多 信 息 : Getting Started CD 包 含 PDF 格 式 的 发 行 公 告 和 安 装 指 南, 还 可 能 包 含 SyBooks CD 中 未 收 纳 的 其 它 文 档 或 更 新 信 息 它 随 软 件 一 起 提 供 若 要 阅 读 或 打 印 Getting Started CD 上 的 文 档, 需 要 使 用 Adobe Acrobat Reader, 该 软 件 可 以 使 用 CD 上 提 供 的 链 接 从 Adobe 网 站 免 费 下 载 SyBooks CD 含 有 产 品 手 册, 它 随 软 件 一 起 提 供 基 于 Eclipse 的 SyBooks 浏 览 器 使 您 能 够 以 易 于 使 用 的 基 于 HTML 的 格 式 阅 读 手 册 有 些 文 档 可 能 是 以 PDF 格 式 提 供 的, 您 可 以 通 过 SyBooks CD 上 的 PDF 目 录 访 问 这 些 文 档 若 要 阅 读 或 打 印 PDF 文 件, 您 需 要 使 用 Adobe Acrobat Reader 有 关 安 装 和 启 动 SyBooks 的 说 明, 请 参 见 Getting Started CD 上 的 SyBooks Installation Guide ( SyBooks 安 装 指 南 ) 或 SyBooks CD 上 的 README.txt 文 件 Sybase Product Manuals 网 站 是 SyBooks CD 的 联 机 版 本, 您 可 以 使 用 标 准 Web 浏 览 器 来 访 问 它 除 了 产 品 手 册 之 外, 还 可 以 找 到 EBF/ 维 护 (EBFs/Maintenance) 技 术 文 档 (Technical Documents) 案 例 管 理 (Case Management) 解 决 的 案 例 (Solved Cases) 新 闻 组 (Newsgroups) 和 Sybase 开 发 人 员 网 络 (Sybase Developer Network) 的 链 接 若 要 访 问 Sybase Product Manuals 网 站, 请 转 到 位 于 的 产 品 手 册 (Product Manuals) Adaptive Server Enterprise 中 的 Java xiii

14 Web 上 的 Sybase 认 证 Sybase 网 站 上 的 技 术 文 档 在 不 断 地 更 新 查 找 有 关 产 品 认 证 的 最 新 信 息 1 使 用 Web 浏 览 器 访 问 位 于 的 技 术 文 档 (Technical Documents) 2 单 击 认 证 报 告 (Certification Report) 3 在 认 证 报 告 (Certification Report) 过 滤 器 中 选 择 相 应 的 产 品 平 台 和 时 间 范 围, 然 后 单 击 查 找 (Go) 4 单 击 认 证 报 告 (Certification Report) 标 题 显 示 该 报 告 查 找 有 关 组 件 认 证 的 最 新 信 息 1 使 用 Web 浏 览 器 访 问 位 于 的 可 用 性 和 认 证 报 告 (Availability and Certification Reports) 2 在 按 基 本 产 品 搜 索 (Search by Base Product) 下 选 择 产 品 系 列 和 产 品, 或 在 按 平 台 搜 索 (Search by Platform) 下 选 择 平 台 和 产 品 3 选 择 搜 索 (Search) 以 显 示 所 选 项 目 的 可 用 性 和 认 证 报 告 创 建 Sybase 网 站 ( 包 括 支 持 页 ) 的 个 性 化 视 图 设 置 MySybase 配 置 文 件 MySybase 是 一 项 免 费 服 务, 它 允 许 您 创 建 Sybase 网 页 的 个 性 化 视 图 1 使 用 Web 浏 览 器 访 问 位 于 的 技 术 文 档 (Technical Documents) 2 单 击 Sybase 并 创 建 MySybase 配 置 文 件 xiv Adaptive Server Enterprise 15.5

15 关 于 本 手 册 Sybase EBF 和 软 件 维 护 查 找 有 关 EBF 和 软 件 维 护 的 最 新 信 息 1 使 用 Web 浏 览 器 访 问 位 于 的 Sybase 支 持 页 (Sybase Support Page) 2 选 择 EBF/ 维 护 (EBFs/Maintenance) 如 果 出 现 提 示 信 息, 请 输 入 您 的 MySybase 用 户 名 和 口 令 3 选 择 一 个 产 品 4 指 定 时 间 范 围 并 单 击 查 找 (Go) 即 会 显 示 EBF/ 维 护 版 本 的 列 表 锁 形 图 标 表 示 因 为 您 没 有 注 册 为 技 术 支 持 联 系 人 (Technical Support Contact), 因 此 您 没 有 某 些 EBF/ 维 护 版 本 的 下 载 授 权 如 果 您 尚 未 注 册, 但 拥 有 Sybase 代 表 提 供 的 或 通 过 支 持 合 同 获 得 的 有 效 信 息, 请 单 击 编 辑 角 色 (Edit Roles) 将 技 术 支 持 联 系 人 (Technical Support Contact) 角 色 添 加 到 MySybase 配 置 文 件 中 5 单 击 信 息 图 标 可 显 示 EBF/ 维 护 报 告, 单 击 产 品 说 明 可 下 载 软 件 约 定 以 下 各 部 分 将 说 明 在 本 手 册 中 使 用 的 约 定 SQL 是 一 种 形 式 自 由 的 语 言 没 有 规 定 每 一 行 中 的 单 词 数 量 或 者 必 须 换 行 的 地 方 不 过, 为 了 便 于 阅 读, 本 手 册 中 的 所 有 示 例 和 大 多 数 语 法 语 句 都 经 过 了 格 式 设 置, 以 便 语 句 的 每 个 子 句 都 在 一 个 新 行 上 开 始 有 多 个 成 分 的 子 句 会 扩 展 到 其 它 行, 这 些 行 会 有 缩 进 复 杂 命 令 使 用 修 正 的 Backus Naur Form (BNF) 表 示 法 进 行 了 格 式 设 置 表 1 说 明 本 手 册 中 出 现 的 语 法 语 句 的 约 定 : 表 1: 本 手 册 的 字 体 和 语 法 约 定 元 素 命 令 名 过 程 名 实 用 程 序 名 和 其 它 关 键 字 用 sans serif 字 体 显 示 数 据 库 名 和 数 据 类 型 用 sans serif 字 体 显 示 书 名 采 用 正 常 字 体 并 加 书 名 号 ; 文 件 名 变 量 和 路 径 名 用 斜 体 显 示 变 量 ( 即 代 表 您 要 填 充 的 值 的 词 语 ) 作 为 查 询 或 语 句 的 一 部 分 出 现 时 用 斜 体 的 Courier 字 体 显 示 输 入 小 括 号 作 为 命 令 的 一 部 分 示 例 select sp_configure master 数 据 库 系 统 管 理 指 南 sql.ini 文 件 column_name $SYBASE/ASE 目 录 select column_name from table_name where search_conditions compute row_aggregate (column_name) Adaptive Server Enterprise 中 的 Java xv

16 元 素 双 冒 号 加 等 号 表 示 语 法 是 用 BNF 表 示 法 编 写 的 请 勿 输 入 此 符 号 表 示 被 定 义 为 大 括 号 表 示 必 须 至 少 选 择 括 号 中 的 一 个 选 项 请 勿 输 入 大 括 号 中 括 号 表 示 可 以 选 择 括 号 中 的 一 个 或 多 个 选 项, 也 可 不 选 请 勿 输 入 中 括 号 逗 号 表 示 可 以 选 择 任 意 多 个 所 显 示 的 选 项 可 用 逗 号 作 为 命 令 的 一 部 分 来 分 隔 选 项 竖 线 ( ) 表 示 只 可 选 择 所 显 示 的 选 项 中 的 一 个 省 略 号 (...) 表 示 可 以 将 最 后 一 个 单 元 重 复 任 意 次 语 法 语 句 ( 显 示 命 令 的 语 法 和 所 有 选 项 ) 显 示 如 下 : sp_dropdevice [device_name] 对 于 具 有 多 个 选 项 的 命 令 : select column_name from table_name where search_conditions 在 语 法 语 句 中, 关 键 字 ( 命 令 ) 采 用 常 规 字 体, 而 标 识 符 为 小 写 斜 体 表 示 用 户 提 供 的 内 容 说 明 Transact-SQL 命 令 用 法 的 示 例 显 示 如 下 : select * from publishers 计 算 机 输 出 的 示 例 如 下 : pub_id pub_name city state New Age Books Boston MA 0877 Binnet & Hardley Washington DC 1389 Algodata Infosystems Berkeley CA (3 rows affected) 示 例 ::= {cash, check, credit [cash check credit] cash, check, credit cash check credit buy thing = price [cash check credit] [, thing = price [cash check credit]]... 您 必 须 至 少 购 买 一 件 物 品, 并 给 出 其 价 格 可 以 选 择 一 种 付 款 方 式 : 中 括 号 中 的 项 目 之 一 还 可 选 择 购 买 其 它 物 品 : 可 根 据 需 要 购 买 任 意 数 量 的 物 品 对 于 要 购 买 的 每 件 物 品, 给 出 其 名 称 价 格 和 付 款 方 式 ( 可 选 ) xvi Adaptive Server Enterprise 15.5

17 关 于 本 手 册 辅 助 功 能 特 性 本 手 册 中 的 大 多 数 示 例 都 用 小 写 字 符 显 示 不 过, 输 入 Transact-SQL 关 键 字 时 可 以 忽 略 大 小 写 例 如, SELECT Select 和 select 是 相 同 的 Adaptive Server 是 否 区 分 数 据 库 对 象 ( 如 表 名 ) 的 大 小 写 取 决 于 安 装 在 Adaptive Server 上 的 排 序 顺 序 通 过 重 新 配 置 Adaptive Server 的 排 序 顺 序, 可 改 变 单 字 节 字 符 集 的 区 分 大 小 写 设 置 有 关 详 细 信 息, 请 参 见 系 统 管 理 指 南 此 文 档 具 有 针 对 辅 助 功 能 进 行 了 专 门 设 计 的 HTML 版 本 可 以 利 用 适 应 性 技 术 ( 如 屏 幕 阅 读 器 ) 浏 览 HTML 文 档, 也 可 以 用 屏 幕 放 大 器 进 行 查 看 Adaptive Server HTML 文 档 已 经 过 测 试, 符 合 美 国 政 府 第 508 节 辅 助 功 能 的 要 求 符 合 第 508 节 要 求 的 文 档 一 般 也 符 合 美 国 之 外 的 辅 助 功 能 原 则, 如 针 对 网 站 的 World Wide Web 协 会 (W3C) 原 则 注 释 可 能 需 要 配 置 辅 助 功 能 工 具, 以 便 获 得 最 佳 使 用 效 果 某 些 屏 幕 阅 读 器 按 照 大 小 写 来 辨 别 文 本, 例 如 将 ALL UPPERCASE TEXT 看 作 首 字 母 缩 写, 而 将 MixedCase Text 看 作 单 词 对 工 具 进 行 配 置, 规 定 语 法 约 定, 您 可 能 会 感 觉 更 方 便 有 关 工 具 的 信 息, 请 查 阅 文 档 如 果 需 要 帮 助 有 关 Sybase 如 何 支 持 辅 助 功 能 的 信 息, 请 参 见 位 于 的 Sybase 辅 助 功 能 (Sybase Accessibility) Sybase Accessibility 站 点 包 括 指 向 第 508 节 和 W3C 标 准 相 关 信 息 的 链 接 对 于 购 买 了 支 持 合 同 的 客 户 安 装 的 每 一 个 Sybase 产 品, 都 会 有 一 位 或 多 位 指 定 人 员 获 得 与 Sybase 技 术 支 持 部 门 联 系 的 授 权 如 果 使 用 手 册 或 联 机 帮 助 不 能 解 决 问 题, 可 让 指 定 人 员 与 Sybase 技 术 支 持 部 门 联 系 或 与 所 在 区 域 的 Sybase 子 公 司 联 系 Adaptive Server Enterprise 中 的 Java xvii

18 xviii Adaptive Server Enterprise 15.5

19 第 1 章 数 据 库 中 的 Java 简 介 本 章 简 要 介 绍 了 Adaptive Server Enterprise 中 的 Java 主 题 页 码 数 据 库 中 的 Java 的 优 点 1 数 据 库 中 Java 的 功 能 2 Java 组 件 3 Adaptive Server 和 更 高 版 本 中 的 功 能 变 化 4 标 准 5 数 据 库 中 的 Java: 问 题 和 解 答 6 数 据 库 中 的 Java 的 优 点 Adaptive Server 为 Java 提 供 了 运 行 时 环 境, 这 意 味 着 可 以 在 服 务 器 上 执 行 Java 代 码 在 数 据 库 服 务 器 上 为 Java 建 立 一 个 运 行 时 环 境, 这 将 为 管 理 和 存 储 数 据 与 逻 辑 提 供 强 有 力 的 新 途 径 可 以 将 Java 编 程 语 言 作 为 Transact-SQL 整 体 的 一 部 分 使 用 可 以 在 应 用 程 序 的 不 同 层 ( 客 户 端 中 间 层 或 服 务 器 ) 中 重 复 使 用 Java 代 码, 并 在 您 认 为 最 有 意 义 的 任 何 地 方 使 用 它 们 对 于 在 数 据 库 中 创 建 逻 辑 而 言, Adaptive Server 中 的 Java 是 一 种 比 存 储 过 程 更 强 大 的 语 言 Java 类 已 成 为 丰 富 的 用 户 定 义 的 数 据 类 型 Java 类 的 方 法 提 供 了 可 从 SQL 访 问 的 新 函 数 在 数 据 库 中 使 用 Java 不 会 危 害 数 据 库 的 完 整 性 安 全 性 和 健 壮 性 使 用 Java 不 会 改 变 已 有 SQL 语 句 的 功 能, 也 不 会 影 响 其 它 与 Java 无 关 的 数 据 库 功 能 Adaptive Server Enterprise 中 的 Java 1

20 数 据 库 中 Java 的 功 能 数 据 库 中 Java 的 功 能 Adaptive Server 中 的 Java 允 许 您 : 在 数 据 库 中 调 用 Java 方 法 将 Java 类 存 储 为 数 据 类 型 在 数 据 库 中 存 储 和 查 询 XML 在 数 据 库 中 调 用 Java 方 法 直 接 从 SQL 中 调 用 Java 方 法 将 Java 方 法 作 为 SQLJ 存 储 过 程 和 函 数 来 调 用 可 在 Adaptive Server 中 安 装 Java 类, 然 后 用 两 种 方 法 调 用 这 些 类 的 静 态 方 法 : 可 直 接 从 SQL 中 调 用 Java 方 法 可 以 在 SQL 名 称 中 包 装 这 些 方 法, 并 将 它 们 当 作 标 准 的 Transact-SQL 存 储 过 程 来 调 用 面 向 对 象 语 言 的 方 法 与 过 程 语 言 的 函 数 相 对 应 可 以 通 过 引 用 的 方 法 调 用 存 储 在 数 据 库 中 的 方 法, 调 用 这 些 方 法 时, 需 要 对 实 例 方 法 的 实 例 和 静 态 ( 类 ) 方 法 的 实 例 或 类 进 行 名 称 限 定 可 直 接 调 用 方 法, 例 如 在 Transact-SQL select 列 表 和 where 子 句 中 调 用 可 以 将 向 调 用 者 返 回 值 的 静 态 方 法 用 作 用 户 定 义 的 函 数 (UDF) 用 下 列 方 法 使 用 Java 方 法 时, 有 一 定 的 限 制 : 如 果 Java 方 法 通 过 JDBC 访 问 数 据 库, 则 只 有 Java 方 法 可 以 使 用 结 果 集 中 的 值, 客 户 端 应 用 程 序 无 法 使 用 这 些 值 不 支 持 输 出 参 数 方 法 可 以 处 理 通 过 JDBC 连 接 接 收 的 数 据, 但 只 能 向 其 调 用 者 返 回 一 个 返 回 值, 该 值 是 在 其 定 义 中 声 明 的 在 SQL 包 装 中 可 包 括 Java 静 态 方 法, 并 且 它 们 的 使 用 方 法 与 Transact-SQL 存 储 过 程 或 内 置 函 数 完 全 相 同 它 的 功 能 包 括 : 允 许 Java 方 法 将 输 出 参 数 和 结 果 集 返 回 到 调 用 环 境 允 许 利 用 传 统 的 SQL 语 法 元 数 据 及 权 限 功 能 允 许 跨 数 据 库 调 用 SQLJ 函 数 允 许 在 服 务 器 客 户 端 和 任 何 符 合 SQLJ 的 第 三 方 数 据 库 上 将 现 有 Java 方 法 用 作 SQLJ 的 过 程 和 函 数 遵 循 标 准 规 范 的 第 1 部 分 请 参 见 第 5 页 的 标 准 2 Adaptive Server Enterprise 15.5

21 第 1 章 数 据 库 中 的 Java 简 介 将 Java 类 存 储 为 数 据 库 类 型 利 用 数 据 库 中 的 Java, 可 以 在 SQL 系 统 中 安 装 纯 Java 类, 然 后 像 平 常 那 样 将 这 些 类 用 作 SQL 数 据 库 中 的 数 据 类 型 此 功 能 采 用 了 一 种 便 于 理 解 的 模 型 和 一 种 便 于 移 植 和 获 取 的 语 言, 为 SQL 添 加 了 一 个 完 全 面 向 对 象 的 数 据 类 型 扩 展 机 制 使 用 此 功 能 创 建 和 存 储 的 对 象 可 以 传 送 到 任 何 一 个 启 用 Java 的 环 境 中, 无 论 该 环 境 是 另 外 一 个 SQL 系 统 还 是 一 个 独 立 的 Java 环 境 这 种 在 数 据 库 中 使 用 Java 类 的 能 力 有 两 个 不 同 但 互 为 补 充 的 作 用 : 为 SQL 提 供 了 一 个 类 型 扩 展 机 制, 可 以 将 这 种 机 制 用 于 在 SQL 中 创 建 和 处 理 的 数 据 为 Java 提 供 了 一 种 持 久 的 数 据 功 能, 用 于 在 SQL 中 存 储 在 Java 中 创 建 和 处 理 ( 主 要 方 面 ) 的 数 据 Adaptive Server 中 的 Java 与 传 统 的 SQL 功 能 相 比 有 一 个 显 著 的 优 点 : 您 无 需 将 Java 对 象 映 射 为 标 量 SQL 数 据 类 型 或 将 Java 对 象 存 储 为 无 类 型 的 二 进 制 字 符 串 在 数 据 库 中 存 储 和 查 询 XML 与 超 文 本 标 记 语 言 (HTML) 相 似, 可 扩 展 标 记 语 言 (XML) 允 许 您 定 义 自 己 的 特 定 于 应 用 程 序 的 标 记, 因 而 它 特 别 适 用 于 数 据 交 换 Adaptive Server Enterprise 中 的 XML 服 务 介 绍 Sybase 本 机 XML 处 理 器 和 Sybase 基 于 Java 的 XML 支 持 以 及 数 据 库 中 的 XML, 并 提 供 了 有 关 构 成 XML 服 务 的 查 询 和 映 射 函 数 的 文 档 资 料 Java 组 件 Adaptive Server 允 许 插 入 现 成 的 商 业 Java 运 行 时 环 境 (JRE) 和 Java 虚 拟 机 (JVM) 组 件 在 为 Adaptive Server 配 置 Java 后, 您 可 以 包 括 任 何 支 持 Java 6 或 更 高 版 本 的 标 准 JVM 通 过 使 用 这 种 基 础 结 构, 您 可 以 运 行 使 用 Adaptive Server 之 前 版 本 中 的 Java 解 决 方 案 配 置 的 Java 应 用 程 序 以 及 使 用 Adaptive Server 和 更 高 版 本 创 建 的 应 用 程 序 Adaptive Server 的 Java 接 口 包 含 商 业 JVM 和 支 持 该 JVM 的 Sybase 组 件 : 可 插 入 组 件 适 配 器 /JVM (PCA/JVM) 可 插 入 组 件 接 口 (PCI) 和 PCI 桥, 它 们 是 Adaptive Server 的 内 部 组 件 请 参 见 第 2 章 管 理 Java 环 境 Adaptive Server Enterprise 中 的 Java 3

22 Adaptive Server 和 更 高 版 本 中 的 功 能 变 化 Adaptive Server 和 更 高 版 本 中 的 功 能 变 化 在 Adaptive Server 版 中, Sybase 引 入 了 对 商 业 JVM 的 支 持, 如 Sun Java 2 Platform, Standard Edition (J2SE) Adaptive Server 和 更 低 版 本 提 供 了 一 个 内 部 JVM Adaptive Server PCA/JVM 确 保 使 用 之 前 版 本 创 建 的 Java 应 用 程 序 可 以 与 使 用 Adaptive Server 和 更 高 版 本 创 建 的 Java 应 用 程 序 一 起 无 缝 运 行 除 了 本 节 中 介 绍 的 变 化 以 外, 另 请 参 见 以 下 内 容 : 第 55 页 的 Adaptive Server 和 更 高 版 本 中 的 静 态 变 量 更 改 第 56 页 的 Cluster Edition 中 的 静 态 变 量 更 改 类 分 发 变 化 Adaptive Server 和 更 低 版 本 附 带 提 供 的 Java 运 行 时 类 是 Java 1.2 版 的 一 个 有 限 子 集 Adaptive Server 不 再 提 供 运 行 时 类 相 反,JVM 使 用 作 为 商 业 JRE 一 部 分 提 供 的 运 行 时 类 通 常, 可 以 认 为 较 高 版 本 中 的 Java 类 与 早 期 版 本 向 后 兼 容 不 过, 早 期 版 本 中 标 有 不 建 议 使 用 的 某 些 方 法 或 类 可 能 不 再 与 较 高 版 本 兼 容 请 确 保 应 用 程 序 所 使 用 的 任 何 不 建 议 使 用 的 类 或 方 法 在 较 高 Java 版 本 中 仍 受 支 持 并 保 持 不 变 Adaptive Server 和 更 低 版 本 在 $SYBASE/$SYBASE_ASE/lib 目 录 中 包 含 runtime.zip 文 件 该 文 件 包 含 特 定 于 Adaptive Server 的 类 驱 动 程 序 支 持 所 需 的 JDBC 类 以 及 标 准 Java 类 的 子 集 Adaptive Server 将 runtime.zip 文 件 替 换 为 sybasert.jar ( 其 中 包 含 PCA/JVM 所 需 的 Sybase Java 类 ), 并 使 用 rt.jar 提 供 标 准 Java 类 集 sybasert.jar 位 于 $SYBASE/ASE-15_0/lib/pca 中, rt.jar 位 于 Java 分 发 的 $SYBASE/shared/<jre_directory>/lib 中, 其 中 jre_directory 是 特 定 于 所 用 平 台 的 名 称 PCA/JVM 在 无 人 参 与 模 式 下 运 行 Adaptive Server 和 更 低 版 本 提 供 的 Java 分 发 中 排 除 了 需 要 用 户 交 互 的 类 和 方 法 由 于 PCA/JVM 使 用 标 准 类 分 发, 因 此 现 在 可 以 使 用 这 些 类 为 防 止 用 户 调 用 需 要 用 户 交 互 的 方 法, PCA/JVM 始 终 在 无 人 参 与 模 式 下 运 行 4 Adaptive Server Enterprise 15.5

23 第 1 章 数 据 库 中 的 Java 简 介 内 存 管 理 变 化 Adaptive Server 和 更 低 版 本 使 用 的 内 存 管 理 系 统 包 含 三 个 不 同 的 堆 : 全 局 固 定 堆 共 享 类 堆 和 进 程 对 象 堆 Adaptive Server 和 更 高 版 本 使 用 单 个 PCI 内 存 池 Adaptive Server 忽 略 和 更 低 版 本 中 的 任 何 现 有 配 置 值 您 必 须 使 用 pci memory size 配 置 参 数 指 定 PCI 子 系 统 的 总 内 存 请 参 见 第 2 章 管 理 Java 环 境 如 果 要 从 Adaptive Server 和 更 低 版 本 进 行 转 换, 您 可 能 需 要 更 改 PCI 内 存 池 的 缺 省 大 小 商 业 JVM 使 用 的 类 生 命 周 期 和 碎 片 收 集 算 法 与 Sybase 内 部 JVM 有 很 大 差 别 在 适 当 地 配 置 PCI 内 存 池 的 大 小 后, 您 应 该 看 不 到 行 为 上 有 任 何 差 异 类 装 载 程 序 行 为 变 化 在 Adaptive Server 和 更 高 版 本 中, 类 装 载 程 序 行 为 符 合 在 装 载 期 间 检 验 类 的 JVM 规 范 在 Adaptive Server 和 更 低 版 本 中, 将 检 查 对 所 装 载 的 类 中 的 其 它 类 的 引 用, 但 不 会 完 全 解 析 这 些 引 用 例 如, 如 果 类 A 引 用 方 法 中 的 类 B, 则 类 装 载 程 序 不 检 查 类 B 实 际 是 否 可 用 因 此, 类 可 以 成 功 装 载, 而 无 需 满 足 它 的 所 有 依 赖 性 只 有 在 遇 到 需 要 未 满 足 的 依 赖 性 的 方 法 时, 才 会 引 发 例 外 在 装 载 初 始 类 时, 所 有 商 业 JVM 实 现 的 类 装 载 程 序 将 执 行 完 全 类 检 验 因 此, 不 会 装 载 具 有 未 满 足 的 依 赖 性 的 类, 这 会 引 发 未 处 理 的 Java 例 外, 并 且 Java 堆 栈 跟 踪 将 该 错 误 作 为 java.lang.noclassdeffounderror 列 出 这 意 味 着, 在 极 少 数 情 况 下, 在 Adaptive Server 和 更 低 版 本 中 成 功 装 载 的 类 可 能 在 Adaptive Server 和 更 高 版 本 中 不 会 装 载, 除 非 提 供 了 一 整 套 用 户 类 和 Java 提 供 的 类 以 满 足 所 有 依 赖 性 标 准 ANSI SQL 标 准 指 定 用 于 在 SQL 中 使 用 Java 功 能 的 SQL 扩 展 Java-SQL 规 范 位 于 SQL 标 准 第 13 部 分 : 使 用 Java 编 程 语 言 (SQL/JRT) 的 SQL 例 程 和 类 型 中 此 标 准 在 非 正 式 场 合 称 为 SQLJ Sybase 支 持 Java 例 程 的 SQLJ 规 范 并 提 供 Java 类 型 的 等 效 功 能 此 外, Sybase 还 对 标 准 进 行 了 扩 展 例 如,Adaptive Server 允 许 您 直 接 在 SQL 中 引 用 Java 方 法 和 类 Adaptive Server Enterprise 中 的 Java 5

24 数 据 库 中 的 Java: 问 题 和 解 答 数 据 库 中 的 Java: 问 题 和 解 答 尽 管 本 书 是 面 向 那 些 熟 悉 Java 的 读 者, 但 是 仍 有 许 多 有 关 数 据 库 中 Java 的 知 识 有 待 我 们 去 学 习 Sybase 不 仅 用 Java 来 扩 展 数 据 库 的 功 能, 而 且 用 数 据 库 来 扩 展 Java 的 功 能 无 论 是 经 验 丰 富 的 Java 用 户 还 是 初 学 者, 都 应 该 阅 读 这 一 节 这 一 节 采 用 问 答 的 形 式 帮 助 用 户 了 解 Adaptive Server 中 的 Java 的 基 础 知 识 主 要 功 能 有 哪 些? 后 面 几 节 详 细 说 明 了 所 有 这 些 内 容 通 过 使 用 Adaptive Server 中 的 Java, 您 可 以 : 使 用 任 何 支 持 Java 6 或 更 高 版 本 的 商 业 JVM 运 行 Java 直 接 从 SQL 语 句 中 调 用 Java 函 数 ( 方 法 ) 用 SQL 别 名 包 装 Java 方 法 并 将 它 们 当 作 标 准 的 SQL 存 储 过 程 和 内 置 函 数 来 调 用 使 用 内 部 JDBC 驱 动 程 序 访 问 SQL 数 据 将 Java 类 用 作 SQL 数 据 类 型 在 表 中 保 存 Java 类 的 实 例 通 过 Adaptive Server 数 据 库 中 存 储 的 原 始 数 据 生 成 XML 格 式 的 文 档, 也 可 以 反 过 来, 即, 将 XML 文 档 以 及 从 中 提 取 的 数 据 存 储 到 Adaptive Server 数 据 库 中 调 试 在 数 据 库 中 运 行 的 Java 类 如 何 在 数 据 库 中 存 储 Java 指 令? Java 是 一 种 面 向 对 象 的 语 言, 其 指 令 采 用 类 的 形 式 您 可 以 在 数 据 库 外 部 编 写 Java 指 令 并 将 其 编 译 为 已 编 译 的 类 ( 字 节 码 ), 这 些 类 是 保 存 Java 指 令 的 二 进 制 文 件 然 后, 可 以 将 已 编 译 的 类 安 装 到 数 据 库 中, 并 在 数 据 库 服 务 器 上 执 行 这 些 类 Adaptive Server 为 Java 类 提 供 了 运 行 时 环 境 您 需 要 使 用 Java 开 发 环 境 ( 如 Sybase PowerJ 或 Sun Microsystems Java 开 发 工 具 包 (JDK)) 编 写 和 编 译 Java 6 Adaptive Server Enterprise 15.5

25 第 1 章 数 据 库 中 的 Java 简 介 如 何 在 数 据 库 中 执 行 Java? 当 Adaptive Server 在 执 行 的 SQL 语 句 中 遇 到 Java 语 句 时, 服 务 器 将 调 用 JVM 以 执 行 该 语 句 如 果 JVM 已 运 行, 则 会 将 Java 调 用 转 发 到 JVM ; 如 果 这 是 第 一 个 Java 请 求, 则 会 自 动 启 动 JVM JVM 查 找 并 装 载 Java 语 句 指 定 的 类, 然 后 执 行 字 节 码 支 持 哪 些 Java 虚 拟 机 (JVM)? Adaptive Server Java 框 架 设 计 用 于 任 何 支 持 Java 6 或 更 高 版 本 的 标 准 JVM Adaptive Server 版 经 认 证 可 用 于 $SYBASE/shared 目 录 中 包 含 的 Java 6 版 使 用 早 期 版 本 的 Java 编 译 的 类 可 以 继 续 在 较 高 版 本 的 Java 中 正 确 运 行 什 么 是 无 人 参 与 模 式? Adaptive Server 中 的 Java 在 无 人 参 与 模 式 下 运 行, 这 意 味 着 不 使 用 显 示 设 备 键 盘 和 鼠 标 虽 然 标 准 Java 分 发 中 的 所 有 类 均 可 供 用 户 使 用, 但 不 支 持 某 些 需 要 用 户 输 入 或 输 出 设 备 的 方 法 什 么 是 JDBC? JDBC 是 在 Java 中 执 行 SQL 的 行 业 标 准 API Adaptive Server 提 供 本 机 JDBC 驱 动 程 序 根 据 设 计, 该 驱 动 程 序 在 服 务 器 上 执 行 时 可 实 现 最 佳 性 能, 因 为 它 不 需 要 通 过 网 络 来 通 信 该 驱 动 程 序 允 许 数 据 库 中 安 装 的 Java 类 使 用 执 行 SQL 语 句 的 JDBC 类 Adaptive Server Enterprise 中 的 Java 7

26 数 据 库 中 的 Java: 问 题 和 解 答 如 何 将 Java 与 SQL 一 起 使 用? 数 据 库 中 的 Java 设 计 原 则 是, 为 现 有 SQL 功 能 提 供 自 然 的 开 放 式 扩 展 从 SQL 中 调 用 Java 操 作 Sybase 扩 展 了 SQL 表 达 式 的 范 围 以 包 括 Java 对 象 的 字 段 和 方 法, 以 便 在 SQL 语 句 中 包 含 Java 操 作 作 为 SQLJ 存 储 过 程 和 函 数 的 Java 方 法 可 以 为 Java 静 态 方 法 创 建 一 个 SQLJ 别 名, 以 便 将 它 们 作 为 标 准 SQL 存 储 过 程 和 用 户 定 义 的 函 数 (UDF) 进 行 调 用 Java 类 变 为 用 户 定 义 的 数 据 类 型 可 以 通 过 用 于 传 统 SQL 数 据 类 型 的 相 同 SQL 语 句 来 存 储 Java 类 实 例 您 可 以 使 用 作 为 Java API 一 部 分 的 类 和 由 Java 开 发 人 员 创 建 和 编 译 的 类 什 么 是 Java API? Java 应 用 程 序 编 程 接 口 (API) 是 一 组 由 Sun Microsystems 定 义 的 基 本 功 能 Java 开 发 人 员 可 以 使 用 和 扩 展 该 接 口 这 是 使 用 Java 完 成 各 种 任 务 的 关 键 所 在 Java API 在 它 自 己 的 范 围 内 提 供 了 众 多 功 能, 它 是 为 单 个 用 户 应 用 程 序 创 建 的 所 有 用 户 定 义 类 的 基 础 Java API 支 持 哪 些 Java 类? Adaptive Server 在 数 据 库 中 支 持 所 有 标 准 Java 类 由 于 数 据 库 中 的 Java 在 无 人 参 与 模 式 下 运 行 ( 请 参 见 第 7 页 的 什 么 是 无 人 参 与 模 式? ), 某 些 需 要 用 户 输 入 或 输 出 设 备 的 方 法 将 引 发 Java 例 外 是 否 可 以 在 数 据 库 中 安 装 用 户 定 义 的 类? 您 可 以 将 自 己 的 Java 类 安 装 到 数 据 库 中, 例 如, 用 户 创 建 的 Employee 类 或 开 发 人 员 设 计 编 写 并 使 用 Java 编 译 器 编 译 的 Inventory 类 用 户 定 义 的 Java 类 可 以 同 时 包 含 数 据 以 及 对 数 据 执 行 的 方 法 在 数 据 库 中 安 装 这 些 类 后, Adaptive Server 允 许 在 数 据 库 的 任 何 部 分 和 操 作 中 使 用 这 些 类 并 执 行 它 们 的 功 能 ( 以 类 或 实 例 方 法 的 形 式 ) 8 Adaptive Server Enterprise 15.5

27 第 1 章 数 据 库 中 的 Java 简 介 是 否 可 以 使 用 Java 访 问 数 据? JDBC 接 口 是 用 于 访 问 数 据 库 系 统 的 行 业 标 准 JDBC 类 可 用 于 连 接 到 数 据 库, 使 用 SQL 语 句 请 求 数 据 并 返 回 可 在 客 户 端 应 用 程 序 中 处 理 的 结 果 Adaptive Server 提 供 了 一 个 内 部 JDBC 驱 动 程 序, 它 允 许 数 据 库 中 安 装 的 Java 类 使 用 执 行 SQL 语 句 的 JDBC 类 是 否 可 以 在 客 户 端 和 服 务 器 上 使 用 相 同 的 类? 您 可 以 创 建 在 企 业 应 用 程 序 的 不 同 层 中 使 用 的 Java 类 可 以 将 同 一 Java 类 集 成 到 客 户 端 应 用 程 序 中 间 层 或 数 据 库 中 请 注 意, 在 不 同 层 中 使 用 的 类 或 在 同 一 层 中 不 同 时 间 使 用 的 类 将 保 持 兼 容 或 有 意 使 其 不 兼 容, 以 使 行 为 在 整 个 应 用 程 序 中 保 持 一 致 有 关 详 细 信 息, 请 参 见 有 关 java.io.serializable 类 中 的 serialversionuid 的 Java 文 档 如 何 在 SQL 中 使 用 Java 类 使 用 用 户 定 义 的 Java 类 分 为 三 个 步 骤 : 1 编 写 或 获 取 一 组 要 用 作 SQL 数 据 类 型 或 静 态 方 法 的 SQL 别 名 的 Java 类 2 在 Adaptive Server 数 据 库 中 安 装 这 些 类 注 释 Java 分 发 中 包 含 的 类 始 终 可 用, 不 需 要 在 使 用 之 前 在 数 据 库 中 安 装 这 些 类 3 在 SQL 代 码 中 使 用 这 些 类 执 行 以 下 操 作 : 直 接 将 静 态 方 法 作 为 UDF 进 行 调 用 将 Java 类 声 明 为 SQL 列 变 量 和 参 数 的 数 据 类 型 在 本 手 册 中, 将 它 们 称 为 Java-SQL 列 变 量 和 参 数 引 用 Java-SQL 列 变 量 或 参 数 的 字 段 或 方 法 在 SQL 别 名 中 包 装 静 态 方 法 并 将 其 用 作 存 储 过 程 或 函 数 Adaptive Server Enterprise 中 的 Java 9

28 数 据 库 中 的 Java: 问 题 和 解 答 在 何 处 查 找 数 据 库 中 的 Java 的 相 关 信 息? 有 很 多 关 于 Java 和 数 据 库 中 的 Java 的 书 籍 Sun 网 站 上 提 供 了 最 新 的 Java 语 言 规 范 不 能 使 用 数 据 库 中 的 Java 执 行 的 操 作 Adaptive Server 是 Java 类 的 运 行 时 环 境, 而 并 非 是 Java 开 发 环 境 不 能 在 数 据 库 中 执 行 以 下 操 作 : 编 辑 类 的 源 文 件 (*.java 文 件 ) 编 译 Java 类 的 源 文 件 (*.java 文 件 ) 执 行 不 支 持 的 Java API, 例 如, 小 程 序 和 可 见 类 使 用 Java 本 机 接 口 (JNI) 将 Java 对 象 作 为 发 送 到 远 程 过 程 调 用 或 从 中 接 收 的 参 数 它 们 不 能 正 确 进 行 转 换 Sybase 建 议 不 要 在 Java-SQL 函 数 SQLJ 函 数 或 SQLJ 存 储 过 程 引 用 的 方 法 中 使 用 非 最 终 静 态 变 量 由 于 静 态 变 量 范 围 取 决 于 实 现 情 况, 因 此, 为 这 些 变 量 返 回 的 值 可 能 不 可 靠 10 Adaptive Server Enterprise 15.5

29 第 2 章 管 理 Java 环 境 主 题 页 码 Java 环 境 组 件 12 何 时 更 改 配 置 值 16 在 运 行 的 服 务 器 中 更 改 配 置 值 18 将 缺 省 配 置 值 恢 复 为 sybpcidb 20 使 用 监 控 表 显 示 有 关 PCI 桥 的 信 息 21 您 可 以 将 现 成 的 标 准 Java JRE 和 JVM 组 件 ( 如 J2SE) 插 入 到 Adaptive Server 中 本 章 介 绍 了 支 持 Java 的 Sybase 组 件 以 及 如 何 更 改 缺 省 配 置 值 Adaptive Server Java 框 架 设 计 用 于 任 何 支 持 Java 6 或 更 高 版 本 的 标 准 JVM ASE 15.5 经 认 证 可 用 于 $SYBASE/shared 目 录 中 包 含 的 Java 6 版 使 用 早 期 版 本 的 Java 编 译 的 类 可 以 继 续 在 较 高 版 本 的 Java 中 正 确 运 行 JVM 独 立 于 Adaptive Server 您 可 以 更 改 或 升 级 Java 应 用 程 序 以 利 用 发 布 的 新 Java 功 能 Adaptive Server Enterprise 中 的 Java 11

30 Java 环 境 组 件 Java 环 境 组 件 图 2-1 显 示 了 构 成 Adaptive Server Java 环 境 的 组 件 图 2-1:Java 组 件 Java J2SE/JVM 可 插 入 组 件 PCA/JVM PCI 桥 Adaptive Server JVM 可 插 入 组 件 JVM 插 件 是 一 个 动 态 装 载 的 模 块, 它 是 在 平 台 上 独 立 于 Adaptive Server 进 行 工 程 支 持 和 安 装 的 对 Adaptive Server 而 言, 该 插 件 是 黑 箱 应 用 程 序, 而 不 是 Sybase 支 持 的 技 术 :JVM 插 件 发 出 Java 结 果 集,PCI 桥 对 其 进 行 转 换, 然 后 将 转 换 的 结 果 集 发 送 到 Adaptive Server 由 于 JVM 插 件 是 由 PCA/JVM 控 制 的, 因 此, 它 间 接 连 接 到 Adaptive Server 您 可 以 独 立 于 Adaptive Server 安 装 升 级 和 启 动 JVM 插 件 通 常, Java 分 发 包 含 一 个 或 多 个 JVM 实 现 这 样, 用 户 就 可 以 选 择 最 符 合 各 个 应 用 程 序 的 性 能 要 求 的 VM 客 户 端 应 用 程 序 在 通 常 用 于 客 户 端 应 用 程 序 的 平 台 上,JRE 包 含 调 优 的 VM 以 缩 短 启 动 时 间 并 减 少 使 用 的 内 存 量 服 务 器 应 用 程 序 在 所 有 平 台 上, JRE 包 含 的 JVM 版 本 旨 在 最 大 限 度 提 高 应 用 程 序 执 行 速 度 12 Adaptive Server Enterprise 15.5

31 第 2 章 管 理 Java 环 境 有 很 多 种 Java 分 发, 不 过,Java 技 术 的 这 些 功 能 对 客 户 端 和 服 务 器 VM 版 本 是 相 同 的 : Adaptive 编 译 器 Java 插 件 使 用 标 准 解 释 器 启 动 应 用 程 序, 但 在 运 行 代 码 时 对 其 进 行 分 析 以 检 测 性 能 瓶 颈 或 热 点 快 速 内 存 分 配 和 碎 片 收 集 Java 技 术 为 对 象 提 供 了 快 速 内 存 分 配 功 能, 并 提 供 了 一 组 快 速 有 效 且 非 常 先 进 的 碎 片 收 集 器 供 您 选 择 线 程 同 步 Java 编 程 语 言 允 许 使 用 多 个 并 发 路 径 来 执 行 程 序 ( 称 为 线 程 ) Java 技 术 包 含 一 项 线 程 处 理 功 能, 可 轻 松 扩 展 该 功 能 以 用 于 大 型 共 享 内 存 多 处 理 器 服 务 器 注 释 应 小 心 使 用 生 成 子 线 程 的 方 法 在 Java 方 法 中 启 动 的 java.lang.thread 对 象 是 在 运 行 时 调 度 的, 而 不 是 由 Adaptive Server 调 度 程 序 调 度 的 如 果 这 些 线 程 是 处 理 器 密 集 型 线 程, 或 者 生 成 了 大 量 线 程, 服 务 器 性 能 可 能 会 由 于 争 用 处 理 器 时 间 而 下 降 虽 然 PCA/JVM 插 件 可 以 使 用 客 户 端 或 服 务 器 JVM, 但 Sybase 建 议 您 缺 省 使 用 服 务 器 版 本 以 最 大 限 度 提 高 Java 方 法 的 性 能 ; 安 装 过 程 将 使 用 服 务 器 版 本 有 关 适 用 于 您 的 企 业 的 相 应 客 户 端 版 本 的 信 息, 请 参 见 客 户 端 版 本 文 档 可 插 入 组 件 适 配 器 /JVM (PCA/JVM) PCA/JVM 用 作 一 个 代 理 以 管 理 Adaptive Server 和 JVM 之 间 的 服 务 请 求 PCA/JVM 在 两 个 方 向 转 发 和 控 制 请 求 : 从 Adaptive Server 到 JVM 以 及 从 JVM 到 Adaptive Server 可 插 入 组 件 接 口 (PCI) 和 PCI 桥 PCI 是 Adaptive Server 的 内 部 通 用 接 口 ; 缺 省 情 况 下, 在 安 装 或 升 级 Adaptive Server 时 将 安 装 该 接 口 PCI 桥 (PCI 的 内 部 组 件 ) 在 Adaptive Server 和 JVM 插 件 之 间 执 行 实 际 操 作 PCI 桥 提 供 了 以 下 功 能 : 本 机 线 程 ( 进 程 ) 管 理 内 存 管 理 同 步 ( 锁 定 条 件 和 事 件 ) 管 理 Adaptive Server Enterprise 中 的 Java 13

32 Java 环 境 组 件 数 据 访 问 服 务 支 持 配 置 管 理 通 过 自 动 装 载 插 件 按 需 分 配 功 能 信 号 和 例 外 处 理 平 台 运 行 时 支 持 动 态 设 备 功 能 将 错 误 消 息 传 送 到 Adaptive Server 错 误 日 志 大 多 数 情 况 下, 使 用 缺 省 PCI 桥 配 置 就 足 够 了 如 有 必 要, 您 应 该 咨 询 Sybase 技 术 支 持 人 员 并 使 用 sp_pciconfig 系 统 存 储 过 程 修 改 PCI 配 置 sp_pciconfig 包 含 一 些 参 数, 可 用 于 列 出 报 告 启 用 或 禁 用 sybpcidb 中 的 指 令 和 参 数 请 参 见 第 18 页 的 在 运 行 的 服 务 器 中 更 改 配 置 值 PCI 内 存 池 PCI 内 存 池 是 在 PCI 桥 初 始 化 时 一 次 性 全 部 分 配 的 ; 以 后, 其 大 小 不 会 增 加 它 是 由 Adaptive Server 控 制 的, 其 它 内 存 池 受 到 的 限 制 也 同 样 适 用, 例 如, 单 个 分 配 不 能 超 过 1MB PCI 内 存 池 的 缺 省 大 小 为 32,768 KB 在 为 服 务 器 配 置 Java 时, 可 以 使 用 enable pci 配 置 参 数 启 用 PCI 内 存 池 请 参 见 针 对 所 用 平 台 的 安 装 指 南 更 改 PCI 内 存 池 的 大 小 PCI 内 存 池 的 缺 省 大 小 适 用 于 大 多 数 非 集 群 安 装 要 增 加 内 存 池 的 大 小, 请 重 置 pci memory size 配 置 参 数 例 如, 要 将 pci memory size 设 置 为 页 ( 每 页 为 2KB), 请 输 入 : sp_configure "pci memory size", pci memory size 是 一 个 动 态 配 置 参 数 ; 无 需 重 新 启 动 Adaptive Server 即 可 使 更 改 生 效 如 果 Adaptive Server 没 有 足 够 的 可 用 内 存 分 配 给 内 存 池, 则 会 忽 略 该 配 置 更 改 并 且 不 会 启 动 PCI 桥 有 关 pci memory size 的 详 细 信 息, 请 参 见 系 统 管 理 指 南, 卷 1 14 Adaptive Server Enterprise 15.5

33 第 2 章 管 理 Java 环 境 多 引 擎 Adaptive Server 中 使 用 的 Java VM 内 存 在 多 引 擎 环 境 中, 多 个 Adaptive Server 任 务 可 能 会 并 行 使 用 Java VM 结 果, Java VM 在 多 引 擎 环 境 中 需 要 的 内 存 比 单 引 擎 环 境 多 因 此, 您 可 能 需 要 根 据 所 运 行 的 应 用 程 序 类 型 以 及 并 行 执 行 Java 的 用 户 数, 增 加 PCI 内 存 池 的 大 小 可 以 让 Adaptive Server 计 算 堆 大 小, 您 也 可 以 自 己 使 用 sp_jreconfig 设 置 PCA_JVM_JAVA_OPTIONS 指 令 的 -Xmx 和 -Xms 参 数 以 配 置 堆 大 小 要 让 Adaptive Server 配 置 堆 大 小, 计 算 的 堆 大 小 必 须 大 于 4MB, 并 且 不 能 设 置 -Xmx 和 -Xms 参 数 (Adaptive Server 使 用 sybpcidb 中 存 储 的 值 ) 当 Adaptive Server 配 置 堆 大 小 时 : 设 置 PCA_JVM_JAVA_OPTIONS 指 令 的 -Xmx 参 数, 以 使 Java 堆 大 小 为 PCI 内 存 池 大 小 的 65% 将 -Xms 参 数 设 置 为 与 -Xmx 相 同 的 值 为 新 生 成 的 堆 配 置 20% 的 Java 堆 大 小, 也 称 为 Eden 区 sybpcidb 数 据 库 sybpcidb 数 据 库 存 储 PCI 桥 和 PCA/JVM 插 件 的 配 置 信 息 在 为 服 务 器 配 置 Java 时, 可 以 创 建 sybpcidb, 安 装 其 中 的 表 并 创 建 其 系 统 存 储 过 程 请 参 见 针 对 所 用 平 台 的 安 装 指 南 sybpcidb 系 统 存 储 过 程 包 括 : sp_pciconfig 配 置 PCI 桥 属 性 sp_jreconfig 配 置 PCA/JVM 插 件 属 性 sybpcidb 表 sybpcidb 数 据 库 中 包 含 以 下 表 用 户 表 内 容 pci_directives PCI 桥 的 指 令 配 置 信 息 pci_arguments PCI 桥 的 参 数 配 置 信 息 pci_slotinfo 每 个 槽 的 信 息, 其 中 包 括 相 关 指 令 和 参 数 的 表 名 pci_slot_syscalls PCI 桥 使 用 的 运 行 时 分 配 模 式 的 运 行 时 系 统 调 用 配 置 信 息 pca_jre_directives 特 定 于 PCA/JVM 插 件 的 指 令 信 息 pca_jre_arguments 特 定 于 PCA/JVM 插 件 的 参 数 信 息 有 关 sybpcidb 的 详 细 信 息, 请 参 见 参 考 手 册 : 表 有 关 sp_pciconfig 和 sp_jreconfig 的 详 细 信 息, 请 参 见 参 考 手 册 : 过 程 Adaptive Server Enterprise 中 的 Java 15

34 何 时 更 改 配 置 值 如 何 在 sybpcidb 中 组 织 配 置 值 PCI 桥 和 PCA/JVM 的 配 置 值 存 储 在 sybpcidb 中, 并 按 照 指 令 和 参 数 层 次 进 行 划 分 每 个 指 令 包 含 一 个 或 多 个 参 数 ; 每 个 参 数 保 存 一 个 配 置 值 参 数 类 型 如 下 : 开 关 参 数 描 述 只 能 启 用 或 禁 用 的 属 性 开 关 参 数 不 包 含 任 何 数 据 (PCI 桥 和 PCA/JVM) 数 字 参 数 包 含 数 字 属 性 值 (PCI 桥 和 PCA/JVM) 字 符 串 参 数 包 含 字 符 串 属 性 值 ( 仅 限 PCA/JVM) 数 组 参 数 包 含 一 个 或 多 个 字 符 串 属 性 值 的 集 合 ( 仅 限 PCA/JVM) 您 可 以 启 用 或 禁 用 每 个 指 令 及 其 每 个 参 数 指 令 状 态 将 覆 盖 其 参 数 状 态 例 如, 假 设 指 令 包 含 三 个 参 数 : 启 用 arg1 并 禁 用 arg2 和 arg3 如 果 启 用 了 指 令, 则 每 个 参 数 将 保 持 其 基 本 状 态 也 就 是 说, 启 用 arg1 并 禁 用 arg2 和 arg3 如 果 禁 用 了 指 令, 指 令 的 禁 用 状 态 将 覆 盖 参 数 的 基 本 状 态, 从 而 将 arg1 arg2 和 arg3 全 部 禁 用 不 过, 如 果 重 新 启 用 了 指 令, 每 个 参 数 将 恢 复 其 基 本 状 态 : 启 用 arg1 并 禁 用 arg2 和 arg3 通 过 采 用 这 种 设 置, 您 可 以 通 过 一 个 命 令 禁 用 所 有 参 数, 或 将 所 有 参 数 恢 复 为 原 始 状 态 何 时 更 改 配 置 值 对 于 大 多 数 安 装, 使 用 服 务 器 以 及 PCI 桥 和 PCA/JVM 的 缺 省 配 置 选 项 就 足 够 了 虽 然 您 可 以 自 己 安 全 地 更 改 和 管 理 几 个 配 置 选 项, 但 对 于 大 多 数 配 置 选 项, 应 在 Sybase 技 术 支 持 人 员 的 指 导 下 进 行 更 改 您 可 以 设 置 配 置 选 项 : 在 服 务 器 级 针 对 PCI 桥 针 对 PCA/JVM 16 Adaptive Server Enterprise 15.5

35 第 2 章 管 理 Java 环 境 服 务 器 级 选 项 可 以 使 用 sp_configure 更 改 和 管 理 以 下 服 务 器 级 配 置 参 数 : enable pci 启 用 PCI 桥 enable java 在 数 据 库 中 启 用 Java pci memory size 设 置 PCI 内 存 池 的 最 大 大 小 注 释 在 使 用 PCA/JVM 之 前, 必 须 启 用 Java 和 PCI 桥 请 参 见 针 对 所 用 平 台 的 安 装 指 南 和 系 统 管 理 指 南, 卷 1 PCI 桥 的 配 置 选 项 不 要 更 改 PCI 桥 的 任 何 配 置 选 项 ( 指 令 或 参 数 ), 除 非 Sybase 技 术 支 持 人 员 要 求 这 样 做 PCA/JVM 的 配 置 选 项 您 可 以 安 全 地 更 改 PCA/JVM 的 以 下 参 数 : pca_jvm_module_path 只 有 在 使 用 的 JRE 不 是 安 装 提 供 的 JRE 时, 才 能 更 改 该 属 性 如 果 是 这 种 情 况, 请 将 该 属 性 指 向 PCA/JVM 使 用 的 JRE pca_jvm_work_dir 根 据 需 要, 在 可 使 用 特 定 权 限 掩 码 配 置 的 每 个 工 作 目 录 ( 可 信 目 录 ) 的 该 参 数 数 组 中 添 加 一 个 条 目 请 参 见 第 8 章 使 用 Java 访 问 文 件 和 网 络 pca_jvm_netio 启 用 此 参 数 以 启 用 网 络 I/O 禁 用 此 参 数 可 禁 用 网 络 I/O pca_jvm_dbg_agent_port 启 用 此 参 数, 并 将 其 数 值 设 置 为 JVM 用 于 调 试 代 理 的 端 口 号 Java 调 试 程 序 必 须 监 听 相 同 的 端 口 Adaptive Server Enterprise 中 的 Java 17

36 在 运 行 的 服 务 器 中 更 改 配 置 值 pca_jvm_java_dbg_agent_suspend 启 用 此 参 数 以 在 挂 起 状 态 下 启 动 调 试 代 理 启 用 此 参 数 是 非 常 有 用 的, 因 为 在 将 Java 调 试 程 序 连 接 到 运 行 的 进 程 后, 这 可 为 您 留 出 一 些 时 间 在 调 试 程 序 中 设 置 断 点 和 其 它 选 项 请 参 见 参 考 手 册 : 命 令 注 释 应 小 心 使 用 pca_jvm_java_dbg_agent_suspend 启 用 pca_jvm_java_dbg_agent_suspend 将 导 致 JVM 挂 起 ; 所 有 Adaptive Server Java 任 务 将 一 直 等 到 连 接 调 试 程 序 并 通 知 JVM 继 续 为 止 Sybase 建 议 您 启 动 JVM 并 运 行 简 单 的 Java 命 令, 以 便 连 接 调 试 程 序 而 不 是 启 用 pca_jvm_java_dbg_agent_suspend 使 用 Java 命 令 可 启 动 JVM, 并 且 可 以 在 执 行 要 调 试 的 类 之 前 连 接 调 试 程 序 应 在 Sybase 技 术 支 持 人 员 的 指 导 下 更 改 PCA/JVM 的 任 何 其 它 指 令 或 参 数 在 运 行 的 服 务 器 中 更 改 配 置 值 如 果 要 更 改 缺 省 配 置 值, 您 应 该 咨 询 Sybase 技 术 支 持 人 员 并 使 用 sp_jreconfig 和 sp_pciconfig 系 统 存 储 过 程 请 参 见 第 16 页 的 何 时 更 改 配 置 值 本 节 介 绍 了 如 何 将 更 改 的 配 置 值 装 载 到 运 行 的 服 务 器 的 内 存 中 在 Adaptive Server 启 动 时, 如 果 为 服 务 器 配 置 了 Java, 它 将 自 动 装 载 JVM 不 过, 直 到 收 到 第 一 个 Java 请 求 后, 才 会 初 始 化 JVM 这 取 决 于 使 用 Java 的 频 率 在 初 始 化 之 前 更 改 配 置 值 相 对 简 单 一 些 在 初 始 化 后, 配 置 信 息 已 读 取 到 内 存 数 据 结 构 中, 此 时 更 改 配 置 值 会 比 较 困 难 可 通 过 以 下 方 法 更 新 配 置 信 息 : 重 新 启 动 Adaptive Server 在 初 始 化 JVM 之 前 ( 仅 限 PCA/JVM 插 件 ) 在 初 始 化 JVM 之 后 ( 仅 限 PCA/JVM 插 件 ) 18 Adaptive Server Enterprise 15.5

37 第 2 章 管 理 Java 环 境 重 新 启 动 Adaptive Server 以 更 改 配 置 值 这 是 更 改 配 置 信 息 的 最 简 单 方 法, 并 且 始 终 可 以 使 用 该 方 法 注 释 如 果 使 用 sp_pciconfig 更 改 PCI 桥 的 配 置 值, 则 必 须 使 用 该 方 法 1 使 用 sp_jreconfig 或 sp_pciconfig 更 改 配 置 值 2 重 新 启 动 Adaptive Server 在 初 始 化 JVM 之 前 更 改 配 置 值 在 运 行 Adaptive Server 但 未 初 始 化 JVM 时, 可 以 使 用 该 方 法 更 改 PCA/JVM 插 件 的 配 置 值 1 使 用 sp_jreconfig 更 改 配 置 值 2 将 配 置 参 数 装 载 到 内 存 中 请 输 入 : sp_jreconfig "reload_config" 无 需 重 新 启 动 Adaptive Server 即 可 使 新 配 置 值 生 效 注 释 只 有 在 尚 未 初 始 化 JVM 时, 使 用 sp_jreconfig "reload_config" 进 行 的 更 改 才 会 生 效 使 用 sp_jreconfig 仅 修 改 sybpcidb 中 的 表 值, 而 不 会 影 响 在 启 动 Adaptive Server 时 装 载 到 内 存 中 的 当 前 内 存 数 据 结 构 您 可 以 安 全 地 尝 试 该 方 法, 即 使 您 不 确 定 是 否 初 始 化 了 JVM 如 果 已 初 始 化 JVM, reload_config 命 令 将 失 败 并 显 示 一 条 错 误 消 息 这 不 会 产 生 任 何 不 利 后 果 Adaptive Server Enterprise 中 的 Java 19

38 将 缺 省 配 置 值 恢 复 为 sybpcidb 在 初 始 化 JVM 之 后 更 改 配 置 值 如 果 服 务 器 正 在 运 行 并 且 已 初 始 化 JVM, 则 会 将 配 置 参 数 装 载 到 内 存 中 在 这 种 情 况 下, 您 可 以 更 改 PCA/JVM 插 件 的 配 置 参 数, 而 无 需 重 新 启 动 Adaptive Server, 但 是 : Adaptive Server 必 须 在 多 引 擎 模 式 下 运 行, 并 且 JVM 必 须 在 自 己 的 引 擎 中 运 行 否 则, 必 须 重 新 启 动 Adaptive Server 请 按 照 以 下 步 骤 进 行 操 作 : 1 使 用 sp_jreconfig 更 改 配 置 值 2 将 运 行 JVM 的 引 擎 脱 机 ( 此 示 例 中 为 引 擎 3): sp_engine "offline", 3 3 将 运 行 JVM 的 引 擎 恢 复 联 机 : sp_engine "online", 3 Adaptive Server 在 此 过 程 期 间 继 续 运 行, 但 将 运 行 JVM 的 引 擎 联 机 后 才 能 使 用 Java 在 步 骤 3 中 将 引 擎 联 机 后, JVM 将 重 新 处 于 未 初 始 化 状 态, 直 至 收 到 第 一 个 Java 请 求 为 止 将 缺 省 配 置 值 恢 复 为 sybpcidb 在 初 始 化 JVM 后, 将 缺 省 配 置 值 恢 复 为 sybpcidb 配 置 值 的 步 骤 取 决 于 是 否 可 以 重 新 启 动 Adaptive Server, 以 及 是 使 用 单 引 擎 还 是 多 引 擎 Adaptive Server 如 果 使 用 的 是 单 引 擎 Adaptive Server: 1 重 新 安 装 installpcidb 安 装 脚 本 以 将 sybpcidb 配 置 表 值 重 置 为 出 厂 缺 省 值 例 如 : isql -Usa -Psa_password -Sserver_name -i $SYBASE_ASE/scripts/installpcidb 2 重 新 启 动 Adaptive Server 在 JVM 初 始 化 以 响 应 第 一 个 Java 请 求 时, 缺 省 配 置 值 才 会 生 效 20 Adaptive Server Enterprise 15.5

39 第 2 章 管 理 Java 环 境 如 果 使 用 的 是 多 引 擎 Adaptive Server: 1 重 新 安 装 installpcidb 以 将 sybpcidb 配 置 表 值 重 置 为 出 厂 缺 省 值 例 如 : isql -Usa -Psa_password -Sserver_name -i $SYBASE_ASE/scripts/installpcidb 2 将 运 行 JVM 的 引 擎 脱 机 例 如 : sp_engine "offline", 3 在 此 示 例 中, JVM 在 引 擎 3 中 运 行 3 将 运 行 JVM 的 引 擎 恢 复 联 机 例 如 : sp_engine "online", 3 无 需 重 新 启 动 Adaptive Server 即 可 使 新 配 置 值 生 效 使 用 监 控 表 显 示 有 关 PCI 桥 的 信 息 可 以 使 用 以 下 监 控 表 显 示 有 关 PCI 桥 的 信 息 : monpcibridge 显 示 有 关 PCI 桥 的 一 般 信 息 例 如 : select * from monpcibridge Status ConfiguredSlots ActiveSlots ConfiguredPCIMemoryKB UsedPCIMemoryKB ACTIVE monpcislots 显 示 有 关 绑 定 到 每 个 槽 的 插 件 的 信 息 例 如 : select * from monpcislots Slot Status Modulename Engine IN USE PCA/JVM 0 Adaptive Server Enterprise 中 的 Java 21

40 使 用 监 控 表 显 示 有 关 PCI 桥 的 信 息 monpciengine 显 示 PCI 桥 及 其 插 件 的 引 擎 信 息 例 如 : select * from monpciengine Engine Status PLBStatus NumberofActiveThreads PLBRequest PLBWakeupRequests PCA ACTIVE ACTIVE PCA ACTIVE ACTIVE 有 关 详 细 信 息, 请 参 见 参 考 手 册 : 表 22 Adaptive Server Enterprise 15.5

41 第 3 章 在 数 据 库 中 准 备 和 维 护 Java 本 章 介 绍 Java 的 运 行 时 环 境, 并 说 明 如 何 在 服 务 器 上 启 用 Java 以 及 如 何 在 数 据 库 中 安 装 和 维 护 Java 类 主 题 页 码 Java 运 行 时 环 境 23 启 用 Java 25 在 数 据 库 中 安 装 Java 类 25 查 看 有 关 安 装 的 类 和 JAR 的 信 息 28 下 载 安 装 的 类 和 JAR 28 删 除 类 和 JAR 29 Java 运 行 时 环 境 Adaptive Server 的 Java 运 行 时 环 境 需 要 使 用 第 三 方 JVM ( 即 Sybase PCI, 作 为 数 据 库 服 务 器 的 一 部 分 提 供 ) 和 Sybase 运 行 时 Java 类 ( 即 Java API) 如 果 在 客 户 端 运 行 Java 应 用 程 序, 则 可 能 还 需 要 在 客 户 端 安 装 Sybase JDBC 驱 动 程 序 jconnect 数 据 库 中 的 Java 类 可 以 使 用 Java 类 的 任 何 以 下 来 源 : 位 于 rt.jar 中 的 标 准 Java 分 发 以 及 安 装 在 Java 安 装 目 录 下 的 ext 目 录 中 的 类 注 释 ext 目 录 内 容 可 能 随 Java 供 应 商 不 同 而 发 生 变 化 有 关 这 些 类 的 详 细 信 息, 请 参 见 供 应 商 文 档 用 户 定 义 的 类 Adaptive Server Enterprise 中 的 Java 23

42 Java 运 行 时 环 境 Sybase 运 行 时 Java 类 Sybase 运 行 时 Java 类 是 安 装 到 支 持 Java 的 数 据 库 中 的 底 层 类 在 安 装 Adaptive Server 时, 将 会 自 动 下 载 这 些 类, 以 后 可 以 从 $SYBASE /$SYBASE_ASE/lib/sybasert.jar (UNIX) 或 %SYBASE%\%SYBASE_ASE%\lib\sybasert.jar (Windows) 中 使 用 这 些 类 在 JVM 启 动 时, Adaptive Server 将 设 置 CLASSPATH 环 境 注 释 如 果 CLASSPATH 是 在 操 作 系 统 环 境 中 设 置 的, 在 内 部 JVM 启 动 时, Adaptive Server 将 忽 略 该 值 用 户 定 义 的 Java 类 可 以 使 用 installjava 实 用 程 序 将 用 户 定 义 的 类 安 装 到 数 据 库 中 安 装 后, 即 可 从 数 据 库 中 的 其 它 类 和 SQL 中 以 用 户 定 义 的 数 据 类 型 形 式 使 用 它 们 JDBC 驱 动 程 序 Adaptive Server 附 带 的 Sybase 本 机 JDBC 驱 动 程 序 支 持 JDBC 1.1 和 1.2 版, 并 且 与 JDBC 2.0 版 的 一 些 类 和 方 法 兼 容 有 关 支 持 和 不 支 持 的 类 和 方 法 的 完 整 列 表, 请 参 见 第 9 章 其 它 主 题 如 果 系 统 要 求 在 客 户 端 使 用 JDBC 驱 动 程 序, 则 必 须 使 用 支 持 JDBC 2.0 版 的 jconnect 6.x 或 更 高 版 本 JVM Adaptive Server Java 框 架 设 计 用 于 任 何 支 持 Java 6 或 更 高 版 本 的 标 准 JVM Adaptive Server 版 经 认 证 可 用 于 $SYBASE/shared 目 录 中 包 含 的 Java 6 版 使 用 早 期 版 本 的 Java 编 译 的 类 可 以 继 续 在 较 高 版 本 的 Java 中 正 确 运 行 24 Adaptive Server Enterprise 15.5

43 第 3 章 在 数 据 库 中 准 备 和 维 护 Java 启 用 Java 注 释 在 启 用 PCI 和 Java 之 前, 请 按 照 针 对 所 用 平 台 的 安 装 指 南 所 述 配 置 sybpcidb 要 在 服 务 器 及 其 数 据 库 中 启 用 Java, 请 在 isql 中 输 入 以 下 命 令 : sp_configure "enable pci", 1 sp_configure "enable java", 1 然 后 关 闭 并 重 新 启 动 服 务 器 Adaptive Server 和 更 高 版 本 要 求 将 启 用 PCI 作 为 启 用 Java 的 先 决 条 件 缺 省 情 况 下,Adaptive Server 不 启 用 Java 只 有 在 服 务 器 中 启 用 了 Java 时, 才 能 安 装 Java 类 或 执 行 任 何 Java 操 作 在 数 据 库 中 安 装 Java 类 要 通 过 客 户 端 操 作 系 统 文 件 安 装 Java 类, 请 从 命 令 行 中 使 用 installjava (UNIX) 或 instjava (Windows) 实 用 程 序 有 关 这 些 实 用 程 序 的 详 细 信 息, 请 参 见 Adaptive Server Enterprise Utilities Guide ( Adaptive Server Enterprise 实 用 程 序 指 南 ) 这 两 个 实 用 程 序 执 行 相 同 的 任 务, 为 简 单 起 见, 本 文 档 使 用 UNIX 示 例 使 用 installjava installjava 将 解 压 缩 的 JAR 文 件 复 制 到 Adaptive Server 系 统 中, 并 使 JAR 中 包 含 的 Java 类 可 以 在 当 前 数 据 库 中 使 用 语 法 为 : installjava -f file_name [-new -update] [-j jar_name] [ -S server_name ] [ -U user_name ] [ -P password ] [ -D database_name ] [ -I interfaces_file ] [ -a display_charset ] [ -J client_charset ] [ -z language ] [ -t timeout ] Adaptive Server Enterprise 中 的 Java 25

44 在 数 据 库 中 安 装 Java 类 例 如, 要 安 装 addr.jar 文 件 中 的 类, 请 输 入 : installjava -f /home/usera/jars/addr.jar f 参 数 指 定 包 含 JAR 的 操 作 系 统 文 件 必 须 使 用 JAR 的 完 整 路 径 名 本 节 介 绍 了 保 留 的 JAR 文 件 ( 使 用 -j) 以 及 如 何 更 新 安 装 的 JAR 和 类 ( 使 用 new 和 update) 有 关 这 些 选 项 和 可 用 于 installjava 的 其 它 选 项 的 详 细 信 息, 请 参 见 实 用 程 序 指 南 注 释 安 装 JAR 文 件 时, 应 用 程 序 服 务 器 会 将 文 件 复 制 到 一 个 临 时 表 中, 然 后 从 该 处 安 装 JAR 文 件 如 果 安 装 较 大 的 JAR 文 件, 则 可 能 需 要 使 用 alter database 命 令 扩 展 tempdb 大 小 安 装 解 压 缩 的 JAR installjava 和 instjava 工 具 需 要 使 用 解 压 缩 的 jar 文 件 要 在 数 据 库 中 安 装 Java 类, 请 解 压 缩 并 保 存 JAR 文 件 中 的 类 或 包 要 创 建 包 含 Java 类 的 解 压 缩 JAR 文 件, 请 使 用 Java jar cf0 ( 零 ) 命 令 在 以 下 UNIX 示 例 中, jar 命 令 创 建 一 个 解 压 缩 的 JAR 文 件, 其 中 包 含 jcspackage 目 录 中 的 所 有.class 文 件 : jar cf0 jcspackage.jar jcspackage/*.class 保 留 JAR 文 件 在 数 据 库 中 安 装 JAR 时, 服 务 器 将 分 解 JAR, 然 后 提 取 并 单 独 存 储 其 中 的 类 除 非 指 定 具 有 -j 参 数 的 installjava, 否 则 不 会 将 JAR 存 储 在 数 据 库 中 使 用 -j 可 确 定 Adaptive Server 系 统 是 保 留 installjava 中 指 定 的 JAR, 还 是 仅 使 用 JAR 提 取 要 安 装 的 类 如 果 指 定 -j 参 数, Adaptive Server 将 按 常 规 方 式 安 装 JAR 中 包 含 的 类, 然 后 保 留 JAR 及 其 与 已 安 装 类 的 关 联 如 果 未 指 定 -j 参 数, Adaptive Server 将 不 保 留 类 与 JAR 的 任 何 关 联 这 是 缺 省 选 项 Sybase 建 议 指 定 一 个 JAR 名 称, 以 便 能 更 好 地 管 理 安 装 的 类 如 果 保 留 JAR 文 件 : 可 以 使 用 remove java 语 句 同 时 删 除 JAR 及 其 关 联 的 所 有 类 否 则, 必 须 一 次 一 个 地 删 除 类 或 类 的 包 可 以 使 用 extractjava 将 JAR 下 载 到 操 作 系 统 文 件 中 请 参 见 第 28 页 的 下 载 安 装 的 类 和 JAR 26 Adaptive Server Enterprise 15.5

45 第 3 章 在 数 据 库 中 准 备 和 维 护 Java 更 新 安 装 的 类 installjava 的 new 和 update 子 句 指 示, 您 是 否 希 望 将 当 前 安 装 的 类 替 换 为 新 类 如 果 指 定 new, 则 不 能 安 装 与 现 有 类 名 称 相 同 的 类 如 果 指 定 update, 则 可 以 安 装 与 现 有 类 名 称 相 同 的 类, 并 且 新 安 装 的 类 将 替 换 现 有 类 警 告! 如 果 通 过 重 新 安 装 类 的 修 订 版 本 的 方 法 来 改 变 已 用 作 列 数 据 类 型 的 类, 则 需 要 确 保 修 改 后 的 类 可 以 读 取 和 使 用 将 它 用 作 数 据 类 型 的 表 中 的 现 有 对 象 ( 行 ) 否 则, 不 重 新 安 装 最 初 的 类, 就 可 能 无 法 访 问 现 有 对 象 使 用 新 类 替 换 已 安 装 的 类 还 取 决 于 是 正 在 安 装 的 类 还 是 已 安 装 的 类 与 JAR 关 联 因 此 : 如 果 更 新 JAR, 则 现 有 JAR 中 的 所 有 类 都 将 被 删 除, 而 代 之 以 新 的 JAR 中 的 类 类 只 能 与 单 个 JAR 关 联 如 果 某 JAR 中 已 安 装 了 同 一 名 称 的 类, 并 且 该 类 已 与 另 一 个 JAR 关 联, 则 不 能 安 装 该 类 同 样, 如 果 已 安 装 某 个 类 并 且 该 类 与 JAR 关 联, 则 不 能 安 装 与 JAR 不 关 联 的 类 但 是, 当 已 安 装 的 类 与 JAR 不 关 联 时, 可 以 在 保 留 的 JAR 中 安 装 与 该 类 同 名 的 类 在 这 种 情 况 下, 将 删 除 与 JAR 不 关 联 的 类, 并 将 同 名 的 新 类 与 新 的 JAR 关 联 如 果 要 在 新 JAR 中 重 新 组 织 已 安 装 的 类, 比 较 容 易 的 方 法 可 能 是 先 解 除 受 影 响 的 类 与 其 JAR 的 关 联 有 关 详 细 信 息, 请 参 见 第 29 页 的 保 留 类 引 用 其 它 Java-SQL 类 已 安 装 的 类 可 以 引 用 同 一 JAR 文 件 中 的 其 它 类 和 同 一 数 据 库 中 以 前 安 装 的 类, 但 不 能 引 用 其 它 数 据 库 中 的 类 如 果 JAR 文 件 中 的 类 引 用 未 定 义 的 类, 则 会 发 生 错 误 : 如 果 在 SQL 中 直 接 引 用 未 定 义 的 类, 则 会 导 致 未 定 义 类 语 法 错 误 如 果 在 调 用 的 Java 方 法 中 引 用 未 定 义 的 类, 则 会 抛 出 可 能 在 调 用 的 Java 方 法 中 捕 获 的 Java 例 外, 或 者 导 致 第 38 页 的 Java-SQL 方 法 中 的 例 外 中 所 述 的 一 般 SQL 例 外 只 要 不 动 态 引 用 或 调 用 不 受 支 持 的 类 和 方 法, 类 定 义 就 可 包 含 这 些 引 用 同 样 地, 只 要 不 对 类 进 行 实 例 化 或 引 用, 则 已 安 装 的 类 就 可 以 包 含 在 不 同 数 据 库 中 安 装 的 用 户 定 义 类 的 引 用 Adaptive Server Enterprise 中 的 Java 27

46 查 看 有 关 安 装 的 类 和 JAR 的 信 息 查 看 有 关 安 装 的 类 和 JAR 的 信 息 要 查 看 有 关 数 据 库 中 安 装 的 类 和 JAR 的 信 息, 请 使 用 sp_helpjava 语 法 为 : sp_helpjava [ class [, name [, 'detail', 'depends' ]] jar [, name [, 'depends' ] ]] 例 如, 要 查 看 有 关 Address 类 的 详 细 信 息 ( 包 括 版 本 号 ), 请 登 录 到 isql 并 输 入 : sp_helpjava class, Address, detail 有 关 详 细 信 息, 请 参 见 参 考 手 册 中 的 sp_helpjava 下 载 安 装 的 类 和 JAR 可 以 下 载 已 安 装 在 一 个 数 据 库 中 的 Java 类 的 副 本, 以 便 在 其 它 数 据 库 或 应 用 程 序 中 使 用 使 用 extractjava 系 统 实 用 程 序 可 将 JAR 文 件 及 其 类 下 载 到 客 户 端 操 作 系 统 文 件 中 例 如, 要 将 addr.jar 下 载 到 ~/home/usera/jars/addrcopy.jar 中, 请 输 入 : extractjava j addr.jar -f ~/home/usera/jars/addrcopy.jar' 有 关 详 细 信 息, 请 参 见 实 用 程 序 指 南 手 册 28 Adaptive Server Enterprise 15.5

47 第 3 章 在 数 据 库 中 准 备 和 维 护 Java 删 除 类 和 JAR 可 以 使 用 Transact-SQL remove java 语 句 从 数 据 库 中 卸 载 一 个 或 多 个 Java-SQL 类 remove java 可 以 指 定 一 个 或 多 个 Java 类 名 Java 包 名 或 保 留 的 JAR 名 称 例 如, 要 卸 载 utilityclasses 包, 请 从 isql 中 输 入 : remove java package "utilityclasses" 注 释 Adaptive Server 不 允 许 删 除 用 作 列 和 参 数 的 数 据 类 型 的 类, 或 由 SQLJ 函 数 或 存 储 过 程 引 用 的 类 无 法 检 查 其 它 类 的 使 用 情 况, 可 以 在 存 储 过 程 中 仍 引 用 这 些 类 的 同 时 将 其 删 除 请 确 保 没 有 删 除 用 作 变 量 或 UDF 返 回 类 型 的 子 类 或 类 remove java package 可 删 除 指 定 包 及 其 所 有 子 包 中 的 所 有 类 有 关 remove java 的 详 细 信 息, 请 参 见 参 考 手 册 保 留 类 您 可 以 从 数 据 库 中 删 除 JAR 文 件, 但 将 其 中 的 类 保 留 为 不 再 与 JAR 关 联 的 类 例 如, 如 果 要 重 新 组 织 几 个 保 留 的 JAR 的 内 容, 可 以 将 remove java 与 retain classes 选 项 一 起 使 用 例 如, 从 isql 中 输 入 : remove java jar 'utilityclasses' retain classes 在 解 除 类 与 其 JAR 的 关 联 后, 可 以 使 用 installjava 和 new 关 键 字 将 其 与 新 JAR 相 关 联 Adaptive Server Enterprise 中 的 Java 29