EJB3.0实例教程.doc

Transcription

1 Jboss EJB3.0 实 例 教 程

2 第 一 章 前 言 本 教 程 适 合 人 群 联 系 作 者 EJB3.0 实 例 教 程 官 方 MSN 群 版 权 声 明...5 第 二 章 运 行 环 境 配 置 下 载 与 安 装 运 行 一 个 EJB3 例 子 在 独 立 的 TOMCAT 中 调 用 EJB 发 布 在 JBOSS 中 的 WEB 应 用 调 用 EJB 如 何 获 取 最 新 的 内 嵌 EJB3 的 JBOSS 版 本...11 第 三 章 基 础 知 识 学 习 熟 悉 JBOSS 的 目 录 结 构 JBOSS 中 的 部 署 如 何 进 行 EJB 打 包 如 何 进 行 WEB 应 用 打 包 使 用 了 第 三 方 类 库 的 EJB 如 何 打 包 共 用 了 第 三 方 类 库 的 J2EE 项 目 如 何 打 包 如 何 恢 复 本 书 配 套 例 子 的 开 发 环 境 如 何 对 EJB3 进 行 调 试...22 第 四 章 会 话 BEAN(SESSION BEAN) STATELESS SESSION BEANS( 无 状 态 BEAN) 开 发 开 发 只 存 在 Remote 接 口 的 无 状 态 Session Bean 开 发 只 存 在 Local 接 口 的 无 状 态 Session Bean 开 发 存 在 Remote 与 Local 接 口 的 无 状 态 Session Bean STATEFUL SESSION BEANS( 有 状 态 BEAN) 开 发 STATELESS SESSION BEAN 与 STATEFUL SESSION BEAN 的 区 别 如 何 改 变 SESSION BEAN 的 JNDI 名 称 SESSION BEAN 的 生 命 周 期 拦 截 器 (INTERCEPTOR) 依 赖 注 入 (DEPENDENCY INJECTION) 定 时 服 务 (TIMER SERVICE) 安 全 服 务 (SECURITY SERVICE) 自 定 义 安 全 域...59 第 五 章 消 息 驱 动 BEAN (MESSAGE DRIVEN BEAN)...61 第 六 章 实 体 BEAN(ENTITY BEAN) 实 体 BEAN 的 组 成 文 件 PERSISTENCE.XML 配 置 JBOSS 数 据 源 的 配 置 MySql 数 据 源 的 配 置 Ms Sql Server2000 数 据 源 的 配 置...66

3 6.3 实 体 BEAN 发 布 前 的 准 备 工 作 单 表 映 射 的 实 体 BEAN 持 久 化 实 体 管 理 器 ENTITYMANAGER Entity 获 取 find() 或 getreference() 添 加 persist() 更 新 Merge() 删 除 Remove() 执 行 EJB3 QL 操 作 createquery() 执 行 SQL 操 作 createnativequery() 刷 新 实 体 refresh() 检 测 实 体 当 前 是 否 被 管 理 中 contains() 分 离 所 有 当 前 正 在 被 管 理 的 实 体 clear() 将 实 体 的 改 变 立 刻 刷 新 到 数 据 库 中 flush() 获 取 持 久 化 实 现 者 的 引 用 getdelegate( ) 关 系 / 对 象 映 射 映 射 的 表 名 或 列 名 与 数 据 库 保 留 字 同 名 时 的 处 理 一 对 多 及 多 对 一 映 射 一 对 一 映 射 多 对 多 映 射 使 用 参 数 查 询 命 名 参 数 查 询 位 置 参 数 查 询 Date 参 数 EJB3 QL 语 言 大 小 写 敏 感 性 (Case Sensitivity) 排 序 (order by) 查 询 部 分 属 性 查 询 中 使 用 构 造 器 (Constructor) 聚 合 查 询 (Aggregation) 关 联 (join) 比 较 Entity 批 量 更 新 (Batch Update) 批 量 删 除 (Batch Remove) 使 用 操 作 符 NOT 使 用 操 作 符 BETWEEN 使 用 操 作 符 IN 使 用 操 作 符 LIKE 使 用 操 作 符 IS NULL 使 用 操 作 符 IS EMPTY 使 用 操 作 符 EXISTS 字 符 串 函 数 计 算 函 数 子 查 询 结 果 集 分 页...130

4 6.9 调 用 存 储 过 程 调 用 无 返 回 值 的 存 储 过 程 调 用 返 回 单 值 的 存 储 过 程 调 用 返 回 表 全 部 列 的 存 储 过 程 调 用 返 回 部 分 列 的 存 储 过 程 事 务 管 理 服 务 ENTITY 的 生 命 周 期 和 状 态 生 命 周 期 回 调 事 件 在 外 部 类 中 实 现 回 调 在 Entity 类 中 实 现 回 调 复 合 主 键 (COMPOSITE PRIMARY KEY) 实 体 继 承 每 个 类 分 层 结 构 一 张 表 (table per class hierarchy) 每 个 子 类 一 张 表 (table per subclass) 每 个 具 体 类 一 张 表 (table per concrete class) 第 七 章 WEB 服 务 (WEB SERVICE) WEB SERVICE 的 创 建 WEB SERVICE 的 客 户 端 调 用 用 java 语 言 调 用 Web Service 用 asp 调 用 Web Service 第 八 章 使 用 EJB3.0 构 建 轻 量 级 应 用 框 架 在 WEB 中 使 用 EJB3.0 框 架 如 何 使 用 Session Bean 如 何 使 用 Message Driven Bean 如 何 使 用 依 赖 注 入 (dependency injection) 如 何 使 用 Entity Bean...187

5 第 一 章 前 言 期 待 已 久 的 EJB3.0 最 终 规 范 已 经 发 布 了 虽 然 EJB3.0 最 终 规 范 出 来 了 一 段 时 间, 但 对 EJB3.0 的 应 用 还 停 留 在 介 绍 之 中, 应 用 实 例 更 是 少 之 又 少, 所 以 作 者 拟 写 本 书, 以 简 单 的 实 例 展 现 EJB3.0 的 开 发 过 程, 希 望 对 大 家 有 所 帮 助 EJB3 最 激 动 人 心 的 是 POJO 编 程 模 型, 我 想 对 开 发 人 员 的 影 响 将 是 非 常 大 的, 因 为 他 降 低 了 开 发 人 员 编 写 EJB 的 要 求 EJB3 的 bean 类 将 更 像 常 规 的 Java bean 不 要 求 像 过 去 那 样 实 现 特 殊 的 回 调 界 面 或 者 扩 展 EJB 类 所 以 它 将 使 EJB 的 开 发 更 像 常 规 的 Java 开 发 作 者 对 EJB3.0 接 触 的 时 间 很 短, 所 以 一 些 新 的 概 念 和 知 识 理 解 也 难 免 有 误, 有 些 概 念 和 语 义 把 握 的 不 是 很 准, 希 望 在 这 方 面 有 经 验 和 了 解 的 朋 友 批 评 指 正, 欢 迎 多 提 意 见 因 为 JBOSS EJB3.0 产 品 常 未 成 熟, 本 教 程 随 着 新 产 品 的 推 出 将 有 所 改 动, 请 密 切 关 注! 1.1 本 教 程 适 合 人 群 本 教 程 适 合 具 有 Java 语 言 基 础 的 EJB 初 学 者 有 读 者 来 邮 件 问 需 不 需 要 先 学 EJB2.x, 作 者 明 确 地 告 诉 你 不 用 学 了 随 着 EJB3 的 发 展,EJB2.x 将 会 逐 步 成 为 历 史 1.2 联 系 作 者 黎 活 明, 广 东 佛 山 人, 毕 业 于 中 国 农 业 大 学, 一 直 从 事 于 B/S 系 统 架 构 工 作,06 年 11 月 离 开 游 易 航 空 旅 行 网, 成 为 一 名 自 由 职 业 者, 同 时 兼 任 某 公 司 的 技 术 总 监 电 子 邮 件 1.3 EJB3.0 实 例 教 程 官 方 MSN 群 MSN 群 账 号 添 加 该 账 号 到 你 的 MSN 中 即 可 加 入 群, 在 群 中 你 可 以 和 大 家 一 起 交 流 学 习 的 经 验, 技 术 的 最 新 发 展 等 1.4 版 权 声 明 本 电 子 书 的 内 容 全 部 为 版 权 作 品, 仅 供 个 人 研 究 和 学 习 之 用, 不 得 用 于 任 何 商 业 目 的, 未 经 作 者 书 面 许 可, 不 得 以 其 他 任 何 方 式 进 行 出 版 篡 改 编 辑 未 经 作 者 书 面 许 可, 任 何 商 业 培 训 机 构 不 得 使 用 本 电 子 书 作 为 培 训 教 程, 否 则 将 依 法 追 究 其 法 律 责 任

6 第 二 章 运 行 环 境 配 置 2.1 下 载 与 安 装 1> 下 载 安 装 JDK > 下 载 安 装 开 发 工 具 JBossIDE( 内 含 Eclipse 3.2), 直 接 解 压 缩 即 可 完 成 安 装 想 使 用 中 文 的 朋 友 可 以 下 载 中 文 语 言 包 NLpack1-eclipse-SDK-3.2-win32.zip 下 载 路 径 : /NLpack1-eclipse-SDK-3.2-win32.zip 解 压 语 言 包, 把 features 及 plugins 文 件 夹 拷 贝 复 盖 JBossIDE 安 装 目 录 下 的 features 及 plugins 文 件 夹 如 果 汉 化 失 败, 可 能 是 你 安 装 语 言 包 之 前 运 行 过 eclipse, 解 决 办 法 是 : 把 eclipse 安 装 目 录 下 的 configuration 文 件 夹 删 除, 从 JBossIDE 安 装 包 中 解 压 出 configuration 文 件 夹, 把 configuration 文 件 夹 拷 贝 到 JBossIDE 安 装 目 录 下 3> 下 载 和 安 装 JBOSS GA 服 务 器 文 件 下 载, 这 里 要 注 意 : 最 好 不 要 用 下 载 工 具 下 载, 直 接 通 过 目 标 另 存 为 下 载 安 装 方 法 : 双 击 jems-installer cr1.jar 文 件, 或 者 在 DOS 命 令 下 执 行 : java -jar G:\soft\jems-installer CR1.jar,G:\soft 为 Jboss 安 装 文 件 所 在 目 录 安 装 界 面 如 下 : 这 一 步 是 让 你 选 择 安 装 语 言, 以 后 点 Next 并 同 意 许 可 协 议, 直 到 选 择 安 装 目 录 ( 如 下 图 )

7 在 国 外 的 技 术 论 坛 上, 开 发 者 建 议 不 要 安 装 在 Program Files 目 录, 否 则 一 些 应 用 会 导 致 莫 名 的 错 误 这 里 大 家 就 安 装 在 别 的 目 录 吧 如 C:\JavaServer\jboss 跟 着 选 择 一 个 安 装 类 型, 本 文 选 择 带 集 群 功 能 的 安 装 选 项 ejb3-clustered, 如 下 图 点 下 一 步, 直 到 出 现 下 图. 在 Name 输 入 栏 中 输 入 all

8 点 下 一 步, 直 到 出 现 下 图 : 四 个 选 框 都 选 上 点 下 一 步 就 开 始 安 装 了 安 装 完 后 请 在 系 统 变 量 里 添 加 JBOSS_HOME 变 量, 值 为 Jboss 的 安 装 路 径 如 下 图

9 现 在 验 证 安 装 是 否 成 功 在 Dos 命 令 窗 口 下 执 行 : C:\JavaServer\jboss\bin\run c all 这 个 命 令 用 作 启 动 jboss 观 察 控 制 台 有 没 有 Java 的 例 外 抛 出 如 果 没 有 例 外 并 看 到 下 图, 恭 喜 你, 安 装 成 功 了

10 你 可 以 输 入 来 到 Jboss 的 欢 迎 主 页 在 JBoss Management 栏 中 点 击 JMX Console 进 入 Jboss 的 管 理 界 面, 这 里 需 要 你 输 入 用 户 名 及 密 码, 如 果 你 在 安 装 的 时 候 按 照 教 程 设 置 了 Jboss 管 理 台 用 户 名 及 密 码, 那 么 用 户 名 及 密 码 都 是 admin 如 果 启 动 jboss 出 现 例 外, 先 看 看 jboss 所 用 端 口 有 没 有 被 占 ( 如 1099,1098,8080, 8083 等 端 口 ) 可 以 下 载 端 口 查 看 器 (Active Ports) 进 行 检 查, 如 果 端 口 被 占 用 就 关 闭 此 进 程 确 定 不 是 端 口 被 占 用, 那 很 大 可 能 是 你 的 JDK 安 装 不 正 确 怎 么 排 错, 你 自 己 看 着 办 吧 2.2 运 行 一 个 EJB3 例 子 服 务 安 装 成 功 了, 得 来 一 个 真 家 伙 试 试 在 源 代 码 的 HelloWorld 文 件 夹 下 ( 源 代 码 下 载 : 把 HelloWorld.jar 拷 贝 到 jboss 安 装 目 录 /server/all/deploy/ 目 录 下, jboss 支 持 热 部 署,HelloWorld 会 被 发 现, 并 自 动 完 成 部 署 接 下 来 继 续 把 EJBTest 文 件 夹 下 的 EJBTest.war 拷 贝 到 jboss 安 装 目 录 /server/all/deploy/ 目 录 下 在 浏 览 器 上 输 入 : 怎 样? 看 见 什 么 了 2.3 在 独 立 的 Tomcat 中 调 用 EJB 在 正 式 的 生 产 环 境 下, 大 部 分 调 用 EJB 的 客 户 端 所 在 的 服 务 器 都 为 独 立 的 Tomcat 或 Resin 下 面 介 绍 如 何 在 独 立 的 Tomcat 服 务 器 中 调 用 Jboss 中 的 EJB 在 独 立 的 Tomcat 服 务 器 中 调 用 EJB 需 要 有 以 下 步 骤 : 1> 根 据 应 用 的 需 要, 把 调 用 EJB 所 依 赖 的 Jar 包 拷 贝 到 tomcat 下 的 /shared/lib 目 录 或 WEB 应 用 的 WEB-INF/lib 下, 所 依 赖 的 Jar 一 般 在 jboss 安 装 目 录 的 client,/server/all/deploy/jboss-aop-jdk50.deployer, /server/all/deploy/ejb3.deployer,/lib/endorsed 等 文 件 夹 下 下 面 的 jar 文 件 是 必 需 的 : [jboss 安 装 目 录 ]\client\jbossall-client.jar [jboss 安 装 目 录 ]\client\jboss-remoting.jar [jboss 安 装 目 录 ]\client\jboss-aop-jdk50-client.jar [jboss 安 装 目 录 ]\client\jboss-aspect-jdk50-client.jar [jboss 安 装 目 录 ]\client\jboss-ejb3-client.jar [jboss 安 装 目 录 ]\client\jboss-ejb3x.jar [jboss 安 装 目 录 ]\client\jboss-annotations-ejb3.jar 2> 把 调 用 的 EJB 接 口 拷 贝 到 应 用 的 /WEB-INF/classes/ 目 录 下 注 意 : 在 此 环 境 下 不 能 调 用 EJB 的 Local 接 口, 因 为 他 与 JBOSS 不 在 同 一 个 VM 中 2.4 发 布 在 JBOSS 中 的 WEB 应 用 调 用 EJB 有 些 调 用 EJB 的 WEB 应 用 是 直 接 发 布 在 Jboss 集 成 环 境 下, 本 教 程 的 客 户 端 调 用 例 子 就 是 发 布 在 Jboss 中 在 Jboss 下 发 布 WEB 应 用, 需 要 把 WEB 应 用 打 包 成 war 文 件 另 外 在 此 环 境 下 调 用 EJB 不 需 要 把 EJB 的 接 口 类 放 入 /WEB-INF/classes/ 目 录 中, 否 则 调 用 Stateful Bean 就 会 发 生 类 型 冲 突, 引 发 下 面 的 例 外 java.lang.classcastexception: $Proxy84 org.apache.jsp.statefulbeantest_jsp._jspservice(org.apache.jsp.statefulbeantest_jsp:55) 注 意 : 在 此 环 境 下,EJB 的 Local 或 Remote 接 口 都 可 以 被 调 用

11 2.5 如 何 获 取 最 新 的 内 嵌 EJB3 的 JBOSS 版 本 有 时 候 内 嵌 EJB3 的 JBOSS 在 官 方 网 站 上 发 布 有 些 慢, 如 果 你 着 急 需 要, 可 以 从 Jboss 的 版 本 库 中 获 取 获 取 的 方 法 很 简 单, 首 先 我 们 得 安 装 一 个 版 本 控 制 软 件 TortoiseSVN, 下 载 路 径 (window 版 本 ): 双 击 进 行 安 装, 安 装 完 后 需 要 重 启 机 器, 软 件 的 菜 单 通 过 右 键 属 性 菜 单 进 入 喜 欢 用 中 文 的 朋 友 还 可 以 再 下 载 中 文 语 言 包 安 装 完 后 需 要 设 置 语 言 选 项 才 可 以 显 示 中 文, 方 法 是 : 随 便 在 桌 面 空 白 处 右 击 鼠 标, 在 出 现 的 属 性 菜 单 中 点 击 TortoiseSVN - Settins, 在 出 现 的 属 性 窗 口 中 选 择 简 体 中 文, 如 下 图 所 示 : 下 面 我 们 就 开 始 从 Jboss 版 本 库 中 获 取 最 新 版 的 Jboss 源 文 件 如 我 们 要 获 取 JBoss_4_0_5_GA 版 的 源 文 件 他 的 版 本 库 路 径 为 : 首 先 我 们 建 一 个 用 于 存 放 Jboss 源 文 件 的 文 件 夹, 然 后 在 文 件 夹 上 右 击 鼠 标, 在 跳 出 的 属 性 菜 单 中 选 择 SVN Checkout ( 中 文 :SVN 检 出 ), 在 出 现 的 对 话 框 中 填 入 如 下 图 :

12 点 击 确 定 后, 程 序 就 开 始 从 版 本 库 中 获 取 源 文 件 文 件 大 小 有 70M 多, 你 就 慢 慢 下 载 吧 下 载 完 后, 进 入 build 文 件 夹, 执 行 build.bat 批 处 理 命 令, 程 序 就 开 始 进 行 编 绎, 这 过 程 需 要 十 来 分 钟 成 功 执 行 完 后, 在 build/output 文 件 夹 生 成 了 两 个 Jboss 发 行 版 ( jboss ga 和 jboss ga-ejb3), jboss ga-ejb3 内 嵌 EJB3,jboss GA 不 带 EJB3 把 jboss ga-ejb3 拷 贝 到 某 个 目 录 中 就 可 以 直 接 使 用 了 第 三 章 基 础 知 识 学 习 3.1 熟 悉 JBoss 的 目 录 结 构 安 装 JBoss 会 创 建 下 列 目 录 结 构 : 目 录 描 述 bin 启 动 和 关 闭 JBoss 的 脚 本 client 客 户 端 与 JBoss 通 信 所 需 的 Java 库 (JARs) docs 配 置 的 样 本 文 件 ( 数 据 库 配 置 等 ) docs/dtd 在 JBoss 中 使 用 的 各 种 XML 文 件 的 DTD lib 一 些 JAR,JBoss 启 动 时 加 载, 且 被 所 有 JBoss 配 置 共 享 ( 不 要 把 你 的 库 放 在 这 里 ) server 各 种 JBoss 配 置 每 个 配 置 必 须 放 在 不 同 的 子 目 录 子 目 录 的 名 字 表 示 配 置 的 名 字 JBoss 包 含 3 个 默 认 的 配 置 :minimial,default 和 all, 在 你 安 装 时 可 以 进 行 选 择 server/all JBoss 的 完 全 配 置, 启 动 所 有 服 务, 包 括 集 群 和 IIOP ( 本 教 程 就 采 用 此 配 置 ) server/default JBoss 的 默 认 配 置 在 没 有 在 JBoss 命 令 航 中 指 定 配 置 名 称 时 使 用 ( 本 教 程 没 有 安 装 此 配 置, 如 果 不 指 定 配 置 名 称, 启 动 将 会 出 错 ) server/all/conf JBoss 的 配 置 文 件 server/all/data JBoss 的 数 据 库 文 件 比 如, 嵌 入 的 数 据 库, 或 者 JBossMQ server/all/deploy JBoss 的 热 部 署 目 录 放 到 这 里 的 任 何 文 件 或 目 录 会 被 JBoss 自 动 部 署 EJB WAR EAR, 甚 至 服 务 server/all/lib 一 些 JAR,JBoss 在 启 动 特 定 配 置 时 加 载 他 们 (default 和 minimial 配 置 也 包 含 这 个 和 下

13 面 两 个 目 录 ) server/all/log JBoss 的 日 志 文 件 server/all/tmp JBoss 的 临 时 文 件 3.2 JBoss 中 的 部 署 JBoss 中 的 部 署 过 程 非 常 的 简 单 直 接 在 每 一 个 配 置 中,JBoss 不 断 的 扫 描 一 个 特 殊 目 录 的 变 化 : [jboss 安 装 目 录 ]/server/config-name/deploy 此 目 录 一 般 被 称 为 部 署 目 录 你 可 以 把 下 列 文 件 拷 贝 到 此 目 录 下 : * 任 何 jar 库 ( 其 中 的 类 将 被 自 动 添 加 到 JBoss 的 classpath 中 ) * EJB JAR * WAR (Web Appliction arrchive) * EAR (Enterprise Application archive) * 包 含 JBoss MBean 定 义 的 XML 文 件 * 一 个 包 含 EJB JAR WAR 或 者 EAR 的 解 压 缩 内 容, 并 以.jar.war 或 者.ear 结 尾 的 目 录 要 重 新 部 署 任 何 上 述 文 件 (JAR WAR EAR XML 等 ), 用 新 版 本 的 文 件 覆 盖 以 前 的 就 可 以 了 JBoss 会 根 据 比 较 文 件 的 时 间 发 现 改 变, 然 后 部 署 新 的 文 件 要 重 新 部 署 一 个 目 录, 更 新 他 的 修 改 时 间 即 可 3.3 如 何 进 行 EJB 打 包 要 发 布 EJB 时 必 须 把 她 打 成 jar 或 ear 包, 打 包 的 方 式 有 很 多, 如 :jar 命 令 行 集 成 开 发 环 境 的 打 包 向 导 和 Ant 任 务 下 面 介 绍 Elispse 打 包 向 导 和 Ant 打 包 任 务 1. Elispse 打 包 向 导 在 Elispse 开 发 环 境 下, 可 以 通 过 向 导 进 行 打 包 右 击 项 目 名 称, 在 跳 出 的 菜 单 中 选 择 导 出, 在 导 出 对 话 框 选 择 Jar 文 件, 在 选 择 要 导 出 的 资 源 时, 选 择 源 目 录 和 用 到 的 资 源 然 后 选 择 一 个 存 放 目 录 及 文 件 名 点 完 成 就 结 束 了 打 包 2. Ant 打 包 任 务 采 用 Ant 进 行 打 包 是 比 较 方 便 的, 也 是 作 者 推 荐 的 打 包 方 式 下 面 我 们 看 一 个 简 单 的 打 包 任 务 <?xml version="1.0"?> <project name="jartest" default="jar" basedir="."> <property name="build.dir" value="${basedir/build" /> <property name="build.classes.dir" value="${build.dir/classes" /> <target name="jar" description=" 打 包 成 Jar"> <jar jarfile="${basedir/ejbfile.jar"> <fileset dir="${build.classes.dir"> <include name="**/*.class" /> </fileset> <metainf dir="${basedir/meta-inf "> <include name="**" /> </metainf>

14 </jar> </target> </project> 上 面 建 立 了 一 个 名 为 jartest 的 Ant 项 目, 默 认 的 任 务 为 default="jar", 项 目 的 路 径 为 build.xml 文 件 所 在 目 录 basedir="." 应 用 编 绎 过 后 的 class 文 件 已 经 存 在 于 应 用 的 /build/classes/ 目 录 下 Ant 定 义 了 一 个 属 性 build.classes.dir, 他 指 向 应 用 的 /build/classes/ 目 录 <target name="jar" description=" 打 包 成 Jar"> 定 义 了 一 个 名 叫 jar 的 任 务,description 是 描 述 信 息 任 务 中 使 用 jar 命 令 把 /build/classes/ 目 录 下 的 所 有 class 文 件 打 包 进 jar 文 件, 同 时 也 把 应 用 下 的 META-INF 目 录 下 的 所 有 文 件 打 包 进 jar 文 件 的 META-INF 目 录 打 包 后 的 jar 文 件 存 放 在 应 用 目 录 下 文 件 名 为 :ejbfile.jar 3.4 如 何 进 行 WEB 应 用 打 包 一 个 Web 应 用 发 布 到 Jboss 服 务 器 时 需 要 打 成 war 包 本 节 将 介 绍 jar 命 令 行 及 Ant 任 务 两 种 war 文 件 的 打 包 方 式 1. 在 命 令 行 下 用 jar 命 令 进 行 war 文 件 打 包 在 打 包 前 把 文 件 存 成 以 下 结 构 : WEB 应 用 根 目 录 -- **/*. jsp -- WEB-INF -- web.xml -- lib -- *.* -- classes -- **/*.class 在 Dos 窗 口 中 进 入 到 WEB 应 用 根 目 录 下, 执 行 如 下 命 令 jar cvf EJBTest.war * 此 命 令 把 WEB 应 用 根 目 录 下 的 所 有 文 件 及 文 件 夹 打 包 成 EJBTest.war 文 件 例 如 WEB 应 用 根 目 录 在 : D:\java\webapp\, 命 令 输 入 如 下 : D:\java\webapp> jar cvf EJBTest.war * 2. 在 Ant 任 务 中 进 行 war 文 件 打 包 如 果 文 件 存 放 的 结 构 如 下 面 所 示 : WEB 应 用 根 目 录 -- build.xml --**/*.jsp -- WEB-INF -- web.xml -- lib -- *.* -- classes -- **/*.class 那 么 Ant 的 war 文 件 打 包 任 务 如 下 : <?xml version="1.0"?>

15 <project name="wartest" default="war" basedir="."> <target name="war" description=" 创 建 WEB 发 布 包 "> <war warfile="${basedir/ejbtest.war" webxml="${basedir/web-inf/web.xml"> <fileset dir="${basedir"> <include name="**"/> <exclude name="build.xml" /> <exclude name="/web-inf/web.xml" /> </fileset> </war> </target> </project> <target name="war" description=" 创 建 WEB 发 布 包 "> 定 义 一 个 名 叫 war 的 任 务 任 务 中 执 行 war 打 包 操 作, 把 应 用 下 除 了 build.xml, /WEB-INF/web.xml 之 外 的 所 有 文 件 夹 及 文 件 打 进 war 包, 同 时 把 webxml="${basedir/web-inf/web.xml" 作 为 web 应 用 的 web.xml 文 件 3.5 使 用 了 第 三 方 类 库 的 EJB 如 何 打 包 在 实 际 项 目 中, 我 们 经 常 需 要 使 用 第 三 方 的 类 库 这 些 类 库 应 该 放 在 哪 里?EJB 应 用 一 般 都 有 被 卸 出 ( 这 里 指 装 入 的 反 向 过 程 ) 的 能 力, 这 种 能 力 由 部 署 时 装 入 它 们 的 类 装 载 器 支 持 如 果 我 们 把 第 三 方 类 库 放 入 应 用 服 务 器 的 标 准 类 路 径 ([jboss 安 装 目 录 ]\server\all\lib), 这 些 类 很 可 能 完 全 失 去 被 卸 出 的 能 力 这 样, 如 果 EJB 应 用 要 更 新 某 个 第 三 方 类 库 的 版 本, 重 新 部 署 EJB 应 用 时, 第 三 方 类 库 也 要 重 新 部 署 在 这 种 情 形 下, 把 第 三 方 类 库 放 入 应 用 服 务 器 标 准 类 路 径 很 不 方 便, 因 为 每 次 部 署 EJB 应 用 时, 都 要 重 新 启 动 整 个 应 用 服 务 器, 这 显 然 不 是 理 想 的 选 择 适 合 放 入 应 用 服 务 器 类 路 径 的 第 三 方 类 库 通 常 是 一 些 通 用 类 库, 如 JDBC 驱 动 对 于 针 对 特 定 应 用 的 第 三 方 类 库, 最 理 想 的 选 择 是 把 他 们 放 入 EJB Jar 文 件 中 每 一 个 JAR 文 件 里 都 有 一 个 manifest 文 件, 这 个 文 件 由 jar 工 具 自 动 创 建, 默 认 名 字 是 MANIFEST.MF 我 们 可 以 在 manifest 文 件 中 加 入 一 个 Class-Path 属 性, 引 用 它 所 依 赖 的 JAR 文 件 我 们 可 以 手 工 编 辑 manifest.mf 文 件, 在 原 有 内 容 的 基 础 上, 添 加 Class-Path 属 性 Class-Path 属 性 的 值 是 用 来 搜 索 第 三 方 类 库 的 相 对 URL 这 个 URL 总 是 相 对 于 包 含 Class-Path 属 性 的 组 件 单 个 Class-Path 属 性 内 可 以 指 定 多 个 URL, 一 个 manifest 文 件 可 以 包 含 多 个 Class-Path 属 性 假 设 本 例 EJB 使 用 了 两 个 第 三 方 类 库, 名 为 :Upload.jar,Socket.jar, 修 改 后 的 manifest.mf 文 件 内 容 如 下 : Manifest-Version: 1.0 Ant-Version: Apache Ant Created-By: 1.5.0_01-b08 (Sun Microsystems Inc.) Class-Path: Upload.jar Socket.jar 注 意 :Class-Path: 与 Upload.jar 之 间 有 一 空 格 分 隔 ( 缺 少 了 空 格 就 会 发 生 找 不 到 jar 文 件 ), 多 个 jar 文 件 之 间 需 要 用 空 格 分 隔 Class-Path 所 在 行 还 需 要 进 行 回 车 换 行 下 面 是 打 完 包 后 的 目 录 结 构 : EJB 应 用 根 目 录 -- com ( 注 :ejb 类 包 ) -- Upload.jar ( 注 : 第 三 方 类 库 )

16 -- Socket.jar ( 注 : 第 三 方 类 库 ) -- META-INF -- MANIFEST.MF ( 注 : 加 入 了 Class-Path 属 性 ) 3.6 共 用 了 第 三 方 类 库 的 J2EE 项 目 如 何 打 包 一 个 J2EE 项 目 通 常 由 多 个 EJB 和 Web 应 用 构 成, 如 果 多 个 EJB 及 Web 应 用 共 用 了 一 个 第 三 方 类 库, 我 们 又 如 何 打 包 呢? 按 照 上 节 介 绍 的 内 容, 我 们 会 把 第 三 方 类 库 打 进 每 个 EJB Jar 文 件 及 放 在 Web 应 用 的 /WEB-INF/lib 目 录 下 虽 然 这 种 方 案 也 能 解 决 问 题, 但 它 明 显 地 不 够 完 善 封 装 JAR 文 件 的 目 的 是 为 了 提 高 应 用 的 模 块 化 程 度, 把 同 一 个 类 库 放 入 多 个 JAR 文 件 正 好 是 背 其 道 而 行 之 此 外, 多 次 放 置 同 一 个 类 库 无 谓 地 加 大 了 应 用 的 体 积 最 后, 即 使 只 改 变 一 个 类 库 的 版 权, 每 一 个 EJB JAR 文 件 也 都 要 重 新 构 造, 从 而 使 构 造 过 程 复 杂 化 下 面 的 方 案 很 好 地 解 决 了 上 面 的 问 题 假 设 一 个 J2EE 项 目 含 有 两 个 EJB 及 一 个 Web 应 用, 他 们 的 文 件 名 分 别 为 :HelloWorld.jar,HelloChina.jar, MyEJBTest.war 这 三 个 模 块 都 使 用 了 一 个 第 三 方 类 库, 名 为 :Tools.jar 现 在 我 们 要 做 的 是 编 辑 这 三 个 模 块 的 manifest.mf 文 件, 在 原 有 内 容 的 基 础 上, 添 加 Class-Path 属 性 三 个 模 块 的 jar 文 件 修 改 后 的 manifest.mf 文 件 内 容 如 下 : Manifest-Version: 1.0 Ant-Version: Apache Ant Created-By: 1.5.0_01-b08 (Sun Microsystems Inc.) Class-Path: Tools.jar 注 意 :Class-Path: 与 Tools.jar 之 间 有 一 空 格 分 隔 ( 缺 少 了 空 格 就 会 发 生 找 不 到 jar 文 件 ),Class-Path 所 在 行 还 需 要 进 行 回 车 换 行 各 个 模 块 通 过 manifest.mf 文 件 都 能 找 到 其 所 依 赖 的 Tools.jar 文 件 下 面 是 打 完 包 后 的 目 录 结 构 : J2EE 应 用 根 目 录 -- HelloWorld.jar -- META-INF -- MANIFEST.MF ( 注 : 加 入 了 Class-Path 属 性, 引 用 它 所 依 赖 的 Tools.jar) -- HelloChina.jar -- META-INF -- MANIFEST.MF ( 注 : 加 入 了 Class-Path 属 性, 引 用 它 所 依 赖 的 Tools.jar) -- MyEJBTest.war -- META-INF -- MANIFEST.MF ( 注 : 加 入 了 Class-Path 属 性, 引 用 它 所 依 赖 的 Tools.jar) -- Tools.jar ( 注 : 第 三 方 类 库 ) -- META-INF -- application.xml -- MANIFEST.MF ( 注 : 由 工 具 自 动 生 成, 没 有 加 入 Class-Path 属 性 ) 把 第 三 方 类 库 和 EJB 模 块 并 排 打 进 jar 包, 如 果 第 三 方 类 库 很 多 的 情 况 下, 显 的 有 些 零 乱 而 不 雅 观 在 此 作 者 建 议 大 家 建 个 文 件 夹 专 门 用 来 存 放 第 三 方 类 库 如 建 个 lib 文 件 夹, 把 第 三 方 类 库 放 在 此 文 件 夹 下 然 后 修 改 J2EE

17 各 模 块 的 manifest.mf 文 件 内 容, 修 改 后 的 内 容 如 下 : Manifest-Version: 1.0 Ant-Version: Apache Ant Created-By: 1.5.0_01-b08 (Sun Microsystems Inc.) Class-Path: lib/tools.jar J2EE 应 用 的 文 件 后 缀 为 ear, 应 用 使 用 到 的 各 模 块 在 application.xml 文 件 中 定 义, 本 例 的 application.xml 内 容 如 下 : <?xml version="1.0" encoding="utf-8"?> <application xmlns=" version="1.4" xmlns:xsi=" xsi:schemalocation=" /xml/ns/j2ee <display-name>ejb3trail</display-name> <description>j2ee Made Easy Trail Map</description> <module> <ejb>helloworld.jar</ejb> </module> <module> <ejb> HelloChina.jar</ejb> </module> <module> <web> <web-uri>myejbtest.war</web-uri> <context-root>myejbtest</context-root> </web> </module> </application> 因 为 EJB 打 进 了 EAR 文 件, 在 访 问 EJB 时,JNDI 名 应 为 以 下 格 式 : 访 问 本 地 接 口 :EAR-FILE-BASE-NAME/EJB-CLASS-NAME/local 访 问 远 程 接 口 :EAR-FILE-BASE-NAME/EJB-CLASS-NAME/remote 例 : 如 果 上 面 J2EE 应 用 打 成 MyJ2EE.ear 文 件, 访 问 HelloWorld EJB 远 程 接 口 的 JNDI 名 是 : MyJ2EE/HelloWorldBean/remote 3.7 如 何 恢 复 本 书 配 套 例 子 的 开 发 环 境 登 陆 下 载 本 书 配 套 例 子, 解 压 缩 后 可 以 看 到 以 下 文 件 夹 ( 本 例 解 压 缩 到 :E:\book):

18 每 个 文 件 夹 都 是 一 个 项 目,lib 文 件 夹 存 放 所 有 项 目 使 用 到 的 jar 文 件 下 面 我 们 以 恢 复 HelloWorld 项 目 为 例, 介 绍 开 发 环 境 的 恢 复 Eclipse 必 须 是 eclipse3.1.x 以 上 版 本, 使 用 JDK5.0 以 上 版 本 在 Eclipse 开 发 工 具 上 点 击 文 件 -> 新 建 -> 项 目, 选 择 Java 项 目, 点 击 下 一 步, 出 现 如 下 界 面 :

19 在 上 图 中 选 择 从 现 有 资 源 创 建 项 目 (X), 点 击 浏 览 (R), 在 出 现 的 文 件 窗 口 中 选 择 E:\book\HelloWorld 文 件 夹, 如 下 图 : 用 文 件 夹 名 HelloWorld 作 为 项 目 的 名 称, 如 下 图 :

20 在 上 图 中 点 击 下 一 步,Eclipse 将 会 检 测 已 存 在 项 目 的 配 置 信 息, 检 测 完 后 出 现 下 图 :

21 上 图 中 java 设 置 出 现 感 叹 号, 并 提 示 缺 少 N 个 构 建 路 径 条 目, 实 际 上 是 N 个 Jar 文 件 路 径 不 正 确 现 在 我 们 需 要 把 Jar 文 件 的 路 径 调 整 正 确 在 上 图 中 点 击 库 (L), 在 出 现 的 界 面 中 把 全 部 jar 文 件 及 JRE 系 统 库 删 除, 通 过 添 加 库 按 钮 选 择 添 加 JRE 系 统 库, 添 加 完 JRE 系 统 库 后 点 击 添 加 外 部 JAR(X) 按 钮, 在 出 现 的 文 件 窗 口 中 把 E:\book\lib 文 件 夹 下 所 有 的 Jar 文 件 选 上 (Ctrl+A), 回 到 了 如 下 界 面 :

22 点 击 完 成 就 结 束 了 开 发 环 境 的 建 立 本 书 其 他 项 目 的 开 发 环 境 恢 复 步 骤 如 上 3.8 如 何 对 EJB3 进 行 调 试 要 对 EJB3 进 行 调 试, 我 们 需 要 用 到 一 个 工 具 :JBossIDE, 这 个 工 具 就 是 第 二 章 要 你 下 载 安 装 的 开 发 工 具, 如 果 你 没 有 安 装, 请 参 照 第 二 章 的 内 容 进 行 安 装 在 对 EJB3 进 行 调 试 前 我 们 首 先 需 要 在 Eclipse 中 配 置 JBoss server 的 调 试 环 境 调 试 环 境 建 立 后, 所 有 的 项 目 都 可 以 共 用, 配 置 步 骤 如 下 : 1> 首 先 需 要 在 Eclipse 开 发 界 面 中 显 示 出 Jboss Server View 视 图, 你 可 以 在 Eclipse 菜 单 栏 点 击 窗 口 (W) - 显 示 视 图 (V) - 其 他 (O), 在 出 现 的 显 示 视 图 窗 口 中 选 择 Server 文 件 夹 下 的 Jboss Server View, 如 下 图 :

23 点 击 确 定 后, Jboss Server View 视 图 将 出 现 在 Eclipse 开 发 界 面 的 控 制 区 ( 如 果 你 的 开 发 界 面 已 经 很 零 乱, 可 以 通 过 窗 口 (W) - 复 位 透 视 图 复 位 Eclipse 原 始 界 面 ), 如 下 图 : 2> 接 着 我 们 需 要 建 立 一 个 Jboss Server 在 Jboss Server View 视 图 上 边 白 色 区 域 点 击 鼠 标 右 键, 在 出 现 的 属 性 菜 单 中 点 击 New - Server 如 下 图 : 点 击 Server 后 跳 出 如 下 窗 口, 在 这 个 窗 口 中 我 们 选 择 Jboss AS 4.0, 其 他 参 数 采 用 系 统 默 认 值

24 点 击 下 一 步 后 跳 出 如 下 窗 口, 在 这 个 窗 口 中 我 们 选 择 Jboss 服 务 器 所 在 目 录 ( 作 者 的 Jboss 安 装 在 C:\JavaServer\jboss) 目 前 Jboss IDE 有 个 小 bug, 他 默 认 到 default 配 置 下 找 javax.servlet.jar 文 件, 如 果 你 采 用 本 书 的 all 配 置 项, 那 么 就 会 发 生 找 不 到 文 件, 解 决 此 问 题 的 方 法 很 简 单, 就 是 在 [jboss 安 装 目 录 ]server\ 目 录 下 建 立 default\lib, 然 后 把 javax.servlet.jar 拷 贝 到 此 文 件 夹 下, 这 个 文 件 你 可 以 在 [jboss 安 装 目 录 ]server\all\lib 文 件 夹 下 得 到 点 击 下 一 步, 在 出 现 的 对 话 框 中 选 择 all 配 置, 其 他 采 用 默 认 值 ( 前 提 在 安 装 jboss 时 没 有 修 改 过 对 应 参 数 )

25 点 击 完 成, Jboss Server View 视 图 如 下 图 所 示 : 此 时 的 服 务 器 处 于 Stopped 状 态, 你 需 要 调 试 EJB3 时 可 以 以 Debug 方 式 启 动 Jboss, 方 法 是 : 在 服 务 器 JBOSS4.02 上 右 击 鼠 标, 在 跳 出 的 属 性 菜 单 中 点 击 Debug, 或 者 点 击 Jboss Server View 视 图 右 边 的 小 昆 虫 图 标 控 制 台 会 输 出 Jboss 的 启 动 信 息, 如 果 启 动 出 错, 先 看 看 在 DOS 窗 口 下 以 命 令 行 方 式 (run c all) 能 否 启 动 Jboss, 如 果 DOS 窗 口 下 能 正 常 启 动 Jboss, 那 估 计 是 你 在 建 立 Jboss Server 的 配 置 中 出 错, 除 了 检 查 Jboss 安 装 目 录 的 选 择 是 否 正 确 之 外, 还 要 重 点 检 查 Jboss 配 置 项 选 择 是 否 正 确 经 过 上 面 的 步 骤,JBoss server 的 调 试 环 境 已 经 搭 建 好, 下 面 我 们 就 以 HelloWorld 项 目 为 例 介 绍 EJB3 的 调 试 我 们 按 照 上 面 章 节 的 步 骤 恢 复 HelloWorld 项 目 的 开 发 环 境 因 为 SayHello(String name) 方 法 内 部 代 码 不 多, 为 了 有 代 码 可 调 试, 我 们 在 方 法 内 部 随 便 添 加 几 行 代 码, 并 把 断 点 设 在 代 码 的 第 一 行, 如 下 图 :

26 接 着 我 们 点 击 Jboss Server View 视 图 右 边 的 小 昆 虫 图 标, 以 Debug 方 式 启 动 名 为 JBOSS4.02 的 Jboss Server 在 控 制 台 观 察 启 动 是 否 完 成, 如 果 启 动 完 成, 我 们 就 打 开 HelloWorld 项 目 下 的 build.xml 文 件, 在 大 纲 视 图 中 以 调 试 方 式 执 行 Ant 的 deploy 任 务, 如 下 图 :

27 执 行 Ant 构 建 后, 在 控 制 台 将 会 输 出 Ant 的 任 务 信 息 及 HelloWorld 在 Jboss 中 的 发 布 信 息, 当 HelloWorld 发 布 完 成 后, 我 们 在 浏 览 器 上 输 入 注 意 : 确 保 已 经 发 布 了 Web 应 用 EJBTest.war),Eclipse 将 会 提 示 是 否 切 换 到 调 试 透 视 图 中, 如 下 图, 这 里 点 是. 如 果 你 不 想 老 出 现 这 个 对 话 框, 可 以 勾 选 上 记 住 我 的 决 定. 接 着 将 出 现 如 下 窗 口, 提 示 找 不 class 对 应 的 java 源 文 件

28 此 时 你 可 以 在 上 图 点 击 编 辑 源 查 找 路 径 (E), 出 现 编 辑 源 查 找 路 径 窗 口, 如 下 图 : 在 上 图 中 点 击 添 加 (A), 出 现 添 加 源 代 码 窗 口, 如 下 图 :

29 在 上 图 我 们 选 择 从 java 项 目 寻 找 对 应 的 源 代 码, 如 果 你 的 源 代 码 不 在 eclipse 的 项 目 中, 你 可 以 通 过 文 件 系 统 目 录 进 行 寻 找, 把 路 径 指 向 源 代 码 所 在 的 src 目 录 选 择 java 项 目, 点 击 确 定 后 出 现 下 面 对 话 框 : 在 上 图 中 我 们 勾 选 HelloWorld 项 目, 点 击 确 定 此 时 将 回 到 调 试 窗 口 界 面, 如 下 图 :

30 上 图 中 可 以 看 到 调 试 指 针 已 经 落 在 了 断 点 所 在 行, 此 后 的 调 试 方 法 就 和 普 通 的 java 应 用 程 序 一 样, 你 可 以 使 用 单 步 跳 入, 单 步 跳 过, 单 步 返 回, 运 行 至 行 等 调 试 方 式, 这 里 就 不 作 详 细 解 说 了, 想 了 解 的 朋 友 可 以 参 考 Eclipse 关 于 调 试 方 面 的 资 料 在 这 里 需 要 说 明 下, 调 试 指 针 ( 即 绿 色 光 亮 行 ) 的 移 动 有 时 候 比 较 慢, 点 击 单 步 跳 入 等 调 试 按 钮 十 多 秒 后, 调 试 指 针 的 移 动 才 有 反 应 为 了 方 便 调 试 EJB3, 建 议 使 用 Ant 执 行 编 绎 打 包 发 布 等 操 作 调 试 ejb3 时 不 需 要 反 复 重 启 Jboss Server

31 第 四 章 会 话 Bean(Session Bean) 4.1 Stateless Session Beans( 无 状 态 bean) 开 发 开 发 只 存 在 Remote 接 口 的 无 状 态 Session Bean 步 骤 如 下 : 第 一 步 : 要 定 义 一 个 会 话 Bean, 首 先 需 要 定 义 一 个 包 含 他 所 有 业 务 方 法 的 接 口 这 个 接 口 不 需 要 任 何 注 释, 就 像 普 通 的 java 接 口 那 样 定 义 调 用 EJB 的 客 户 端 通 过 使 用 这 个 接 口 引 用 从 EJB 容 器 得 到 的 会 话 Bean 对 象 stub 接 口 的 定 义 如 下 : HelloWorld.java //author:lihuoming package com.foshanshop.ejb3; public interface HelloWorld { public String SayHello(String name); 第 二 步 : 实 现 上 面 的 接 口 并 加 入 两 个 第 一 个 注 释 定 义 这 是 一 个 无 状 态 会 话 Bean, 第 二 个 注 释 指 明 这 个 无 状 态 Bean 的 remote 接 口 在 使 用 这 两 个 注 释 时 需 要 使 用 一 些 EJB 的 类 包, 这 些 类 包 都 可 以 在 jboss 安 装 目 录 的 client,/server/all/deploy/jboss-aop-jdk50.deployer,/server/all/deploy/ejb3.deployer, /lib/endorsed 等 文 件 夹 下 找 到, 或 者 在 源 代 码 的 Lib 文 件 夹 下 获 得 ( 下 载 地 址 : 经 过 上 面 的 步 骤 一 个 只 存 在 Remote 接 口 的 无 状 态 会 话 Bean 就 开 发 完 成 无 状 态 会 话 Bean 是 一 个 简 单 的 POJO( 纯 粹 的 面 向 对 象 思 想 的 java 对 象 ),EJB3.0 容 器 自 动 地 实 例 化 及 管 理 这 个 Bean 下 面 是 HelloWorld 会 话 Bean 的 实 现 代 码 : HelloWorldBean.java 实 现 类 的 命 名 规 则 是 : 接 口 +Bean, 如 : HelloWorldBean //author:lihuoming package com.foshanshop.ejb3.impl; import com.foshanshop.ejb3.helloworld; import javax.ejb.remote; ({HelloWorld.class) public class HelloWorldBean implements HelloWorld { public String SayHello(String name) { return name +" 说 : 你 好! 世 界, 这 是 我 的 第 一 个 EJB3 哦."; HelloWorld 会 话 Bean 开 发 完 了, 现 在 我 们 把 她 发 布 到 Jboss 中 在 发 布 前 需 要 把 她 打 成 Jar 包 或 EAR 包 ( 如 何 打 包 请 考 照 第 三 章 : 如 何 进 行 EJB 打 包 )

32 打 完 包 后, 启 动 Jboss, 把 发 布 包 拷 贝 到 [jboss 安 装 目 录 ]\server\all\deploy\ 目 录 下 观 察 Jboss 控 制 台 输 出, 如 果 没 有 抛 出 例 外 并 看 到 下 面 的 输 出 界 面, 发 布 就 算 成 功 了 一 旦 发 布 成 功, 你 就 可 以 在 jboss 的 管 理 平 台 查 看 她 们 的 JNDI 名, 输 入 下 面 URL 点 击 service=jndiview, 查 看 EJB 的 JNDI 名 称 ( 如 下 图 ) 在 出 现 的 页 面 中, 找 到 List of MBean operations: 栏 点 击 Invoke 按 钮, 出 现 如 下 界 面 : 在 上 图 中 可 以 看 见 HelloWorld 会 话 Bean 的 JNDI 名,JNDI 名 的 组 成 规 则 是 上 层 名 称 / 下 层 名 称, 每 层 之 间 以 / 分 隔 HelloWorld 会 话 Bean 的 JNDI 名 是 :HelloWorldBean/remote HelloWorld 会 话 Bean 发 布 成 功 后, 接 下 来 介 绍 客 户 端 如 何 访 问 她 当 一 个 无 状 态 会 话 Bean 发 布 到 EJB 容 器 时, 容 器 就 会 为 她 创 建 一 个 对 象 stub, 并 把 她 注 册 进 容 器 的 JNDI 目 录, 客 户 端 代 码 使 用 她 的 JNDI 名 从 容 器 获 得 他 的 stub 通 过 这 个 stub, 客 户 端 可 以 调 用 她 的 业 务 方 法 例 子 代 码 如 下 : Test.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.helloworld, javax.naming.*, java.util.properties"%> <% Properties props = new Properties();

33 props.setproperty("java.naming.factory.initial", "org.jnp.interfaces.namingcontextfactory"); props.setproperty("java.naming.provider.url", "localhost:1099"); props.setproperty("java.naming.factory.url.pkgs", "org.jboss.naming"); InitialContext ctx; try { ctx = new InitialContext(props); HelloWorld helloworld = (HelloWorld) ctx.lookup("helloworldbean/remote"); out.println(helloworld.sayhello(" 佛 山 人 ")); catch (NamingException e) { out.println(e.getmessage()); %> ctx = new InitialContext(props); 是 设 置 JNDI 访 问 的 环 境, 本 例 使 用 JBoss, 所 以 把 环 境 设 为 JBoss 的 上 下 文 环 境 在 这 里 作 者 要 重 点 说 明 一 下 EJB JNDI 名 称 默 认 的 命 名 规 则, 命 名 规 则 如 下 : 1> 如 果 EJB 打 包 进 后 缀 为 *.ear 的 J2EE 发 布 文 件, 默 认 的 JNDI 名 称 是 访 问 本 地 接 口 :EAR-FILE-BASE-NAME/EJB-CLASS-NAME/local 访 问 远 程 接 口 :EAR-FILE-BASE-NAME/EJB-CLASS-NAME/remote 例 :EJB HelloWorld 打 包 进 名 为 HelloWorld.ear 的 J2EE 应 用, 访 问 她 远 程 接 口 的 JNDI 名 是 : HelloWorld/HelloWorldBean/remote 2> 如 果 EJB 应 用 打 包 成 后 缀 为 *.jar 的 发 布 文 件, 默 认 的 JNDI 名 称 是 访 问 本 地 接 口 :EJB-CLASS-NAME/local 访 问 远 程 接 口 :EJB-CLASS-NAME/remote 例 : HelloWorld 应 用 打 包 成 HelloWorld.jar 文 件, 访 问 她 远 程 接 口 的 JNDI 名 称 是 :HelloWorldBean/remote 另 外 有 一 点 要 注 意 :EJB-CLASS-NAME 是 不 带 包 名 的, 如 com.foshanshop.ejb3.impl.helloworldbean 只 需 取 HelloWorldBean 目 前 网 上 很 多 教 材 获 取 JNDI 名 的 方 式 都 过 时 了, 如 : HelloWorld helloworld = (HelloWorld) ctx.lookup(helloworld.class.getname()); 我 们 把 上 面 的 客 户 端 应 用 打 成 war 文 件 然 后 把 她 拷 贝 到 [jboss 安 装 目 录 ]\server\all\deploy 目 录 下 如 果 war 文 件 的 文 件 名 为 EJBTest.war, 我 们 可 以 通 过 访 问 客 户 端 本 例 子 的 EJB 源 代 码 在 HelloWorld 文 件 夹 ( 源 代 码 下 载 : 项 目 使 用 到 的 类 库 在 上 级 目 录 lib 文 件 夹 下 要 恢 复 HelloWorld 项 目 的 开 发 环 境 请 参 考 第 三 章 如 何 恢 复 本 书 配 套 例 子 的 开 发 环 境, 要 发 布 本 例 子 ( 确 保 配 置 了 环 境 变 量 JBOSS_HOME 及 启 动 了 Jboss), 你 可 以 执 行 Ant 的 deploy 任 务 本 例 子 的 客 户 端 代 码 在 EJBTest 文 件 夹, 要 发 布 客 户 端 应 用, 你 可 以 执 行 Ant 的 deploy 任 务 通 过 访 问 客 户 端

34 4.1.2 开 发 只 存 在 Local 接 口 的 无 状 态 Session Bean 开 发 只 存 在 Local 接 口 的 无 状 态 会 话 Bean 的 步 骤 和 上 节 开 发 只 存 在 Remote 接 口 的 无 状 态 会 话 Bean 的 步 骤 相 同, 两 者 唯 一 不 同 之 处 是, 前 者 使 注 释 指 明 实 现 的 接 口 是 远 程 接 口, 后 者 使 注 释 指 明 实 现 的 接 口 是 本 地 接 口 注 释 都 不 存 在 时, 会 话 Bean 实 现 的 接 口 默 认 为 Local 接 口 如 果 在 本 机 调 用 EJB( 确 保 客 户 端 与 EJB 容 器 运 行 在 同 一 个 JVM), 采 用 Local 接 口 访 问 EJB 优 于 Remote 接 口, 因 为 Remote 接 口 访 问 EJB 需 要 经 过 远 程 方 法 调 用 (RPCs) 环 节, 而 Local 接 口 访 问 EJB 直 接 从 JVM 中 返 回 EJB 的 引 用 下 面 是 只 存 在 Local 接 口 的 无 状 态 会 话 Bean 代 码 LocalHelloWorld.java //author:lihuoming package com.foshanshop.ejb3; public interface LocalHelloWorld { public String SayHello(String name); LocalHelloWorldBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import javax.ejb.local; import javax.ejb.stateless; ({LocalHelloWorld.class) public class LocalHelloWorldBean implements LocalHelloWorld { public String SayHello(String name) { return name +" 说 : 你 好! 世 界, 这 是 一 个 只 具 有 Local 接 口 的 无 状 态 Bean"; 客 户 端 调 用 代 码 : LocalSessionBeanTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.localhelloworld, javax.naming.*, java.util.properties"%> <% Properties props = new Properties(); props.setproperty("java.naming.factory.initial", "org.jnp.interfaces.namingcontextfactory"); props.setproperty("java.naming.provider.url", "localhost:1099"); props.setproperty("java.naming.factory.url.pkgs", "org.jboss.naming"); InitialContext ctx; try { ctx = new InitialContext(props); LocalHelloWorld helloworld = (LocalHelloWorld)

35 ctx.lookup("localhelloworldbean/local"); out.println(helloworld.sayhello(" 佛 山 人 ")); catch (NamingException e) { out.println(e.getmessage()); %> 上 面 的 客 户 端 代 码 打 包 成 war 文 件 发 布 到 jboss 中 如 果 你 试 图 在 独 立 的 Tomcat 服 务 器 中 执 行 客 户 端 代 码 ( 如 何 在 独 立 的 Tomcat 环 境 中 调 用 EJB 请 考 照 第 二 章 : 在 独 立 的 Tomcat 中 调 用 EJB), 你 将 获 得 如 下 例 外 : java.lang.nullpointerexception org.jboss.ejb3.stateless.statelesslocalproxy.invoke(statelesslocalproxy.java:74) 产 生 此 例 外 的 原 因 是, 调 用 Local 接 口 的 客 户 端 与 EJB 容 器 不 在 同 一 个 VM( 虚 拟 内 存 堆 ) 相 对 于 发 布 到 jboss deploy 目 录 下 的 客 户 端 应 用 而 言, 他 与 EJB 容 器 运 行 在 同 一 个 VM 如 果 客 户 端 与 EJB 容 器 在 不 同 的 VM, 只 能 通 过 其 Remote 接 口 进 行 访 问 本 例 子 的 EJB 源 代 码 在 LocalSessionBean 文 件 夹 ( 源 代 码 下 载 : 项 目 中 使 用 到 的 类 库 在 上 级 目 录 lib 文 件 夹 下 要 恢 复 LocalSessionBean 项 目 的 开 发 环 境 请 参 考 第 三 章 如 何 恢 复 本 书 配 套 例 子 的 开 发 环 境, 要 发 布 本 例 子 EJB ( 确 保 配 置 了 环 境 变 量 JBOSS_HOME 及 启 动 了 Jboss), 你 可 以 执 行 Ant 的 deploy 任 务 本 例 子 的 客 户 端 代 码 在 EJBTest 文 件 夹, 要 发 布 客 户 端 应 用, 你 可 以 执 行 Ant 的 deploy 任 务 通 过 访 问 客 户 端 开 发 存 在 Remote 与 Local 接 口 的 无 状 态 Session Bean 在 实 际 应 用 中, 一 个 无 状 态 Session Bean 都 应 该 实 现 Remote 与 Local 接 口 当 会 话 Bean 的 某 些 方 法 只 供 EJB 容 器 内 部 调 用 而 不 对 外 暴 露 时, 可 以 把 他 定 义 在 Local 接 口 本 节 介 绍 如 何 开 发 一 个 具 有 Remote 与 Local 接 口 的 无 状 态 Session Bean 开 发 前 先 介 绍 一 下 两 个 接 口 具 有 的 方 法, 两 者 都 含 有 方 法 Add(int a, int b), 而 Local 接 口 含 有 一 个 自 己 的 方 法 :getresult() 下 面 是 例 子 的 源 代 码 定 义 远 程 接 口 :Operation.java //author:lihuoming package com.foshanshop.ejb3; public interface Operation { public int Add(int a, int b); 定 义 本 地 接 口 :LocalOperation.java, 本 地 接 口 具 有 远 程 接 口 的 所 有 方 法, 另 外 有 自 己 的 方 法 getresult() //author:lihuoming package com.foshanshop.ejb3; public interface LocalOperation extends Operation { public int getresult(); 实 现 本 地 接 口 与 远 程 接 口 的 会 话 Bean:OperationBean.java

36 //author:lihuoming package com.foshanshop.ejb3.impl; import javax.ejb.local; import javax.ejb.remote; import javax.ejb.stateless; import com.foshanshop.ejb3.localoperation; ({LocalOperation.class) public class OperationBean implements Operation, LocalOperation { private int total = 0; private int addresult = 0; public int Add(int a, int b) { addresult = a + b; return addresult; public int getresult() { total += addresult; return total; JSP 客 户 端 :OperationBeanTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.operation, com.foshanshop.ejb3.localoperation, javax.naming.*, java.util.properties"%> <% Properties props = new Properties(); props.setproperty("java.naming.factory.initial", "org.jnp.interfaces.namingcontextfactory"); props.setproperty("java.naming.provider.url", "localhost:1099"); props.setproperty("java.naming.factory.url.pkgs", "org.jboss.naming"); InitialContext ctx = new InitialContext(props); try { Operation operation = (Operation) ctx.lookup("operationbean/remote"); out.println(" 通 过 远 程 接 口 调 用 EJB 成 功 "); out.println("<br>( 通 过 远 程 接 口 调 用 EJB) 相 加 的 结 果 是 :"+ operation.add(1,1)); catch (Exception e) { out.println("<br> 远 程 接 口 调 用 失 败 "); out.println("<br>==============================================");

37 try { // 通 过 本 地 接 口 调 用 EJB LocalOperation A = (LocalOperation) ctx.lookup("operationbean/local"); out.println("<br>( 通 过 本 地 接 口 调 用 EJB) 调 用 A.Add() 的 结 果 是 :"+ A.Add(1,1)); out.println("<br> 调 用 A.getResult() 的 结 果 是 :"+ A.getResult()); LocalOperation B = (LocalOperation) ctx.lookup("operationbean/local"); out.println("<br>( 通 过 本 地 接 口 调 用 EJB) 调 用 B.Add() 的 结 果 是 :"+ B.Add(1,1)); out.println("<br> 调 用 B.getResult() 的 结 果 是 :<font color=red>"+ B.getResult() + "</font>"); catch (Exception e) { out.println("<br> 本 地 接 口 调 用 失 败 "); %> 把 会 话 Bean 及 客 户 端 Web 应 用 发 布 到 jboss, 客 户 端 的 调 用 结 果 如 下 : 通 过 远 程 接 口 调 用 EJB 成 功 ( 通 过 远 程 接 口 调 用 EJB) 相 加 的 结 果 是 :2 ============================================== ( 通 过 本 地 接 口 调 用 EJB) 调 用 A.Add() 的 结 果 是 :2 调 用 A.getResult() 的 结 果 是 :2 ( 通 过 本 地 接 口 调 用 EJB) 调 用 B.Add() 的 结 果 是 :2 调 用 B.getResult() 的 结 果 是 :4 细 心 的 你 可 能 会 发 现 调 用 Local 接 口 时, 两 次 累 加 的 结 果 都 不 一 样, 一 个 是 2, 一 个 是 4 调 用 本 地 接 口 的 客 户 端 代 码 片 段 如 下 : // 通 过 本 地 接 口 调 用 EJB LocalOperation A = (LocalOperation) ctx.lookup("operationbean/local"); out.println("<br>( 通 过 本 地 接 口 调 用 EJB) 调 用 A.Add() 的 结 果 是 :"+ A.Add(1,1)); out.println("<br> 调 用 A.getResult() 的 结 果 是 :"+ A.getResult()); LocalOperation B = (LocalOperation) ctx.lookup("operationbean/local"); out.println("<br>( 通 过 本 地 接 口 调 用 EJB) 调 用 B.Add() 的 结 果 是 :"+ B.Add(1,1)); out.println("<br> 调 用 B.getResult() 的 结 果 是 :<font color=red>"+ B.getResult() + "</font>"); 你 可 能 认 为 A 和 B 得 到 的 应 该 是 两 个 不 同 的 对 象, 根 据 OperationBean.java 的 代 码 判 断, 他 们 的 结 果 都 是 2 才 对 为 何 一 个 为 2, 另 一 个 为 4 呢 这 是 因 为 Stateless Session Bean 不 负 责 记 录 使 用 者 状 态,Stateless Session Bean 一 旦 实 例 化 就 被 加 进 会 话 池 中, 各 个 用 户 都 可 以 共 用 即 使 用 户 已 经 消 亡,Stateless Session Bean 的 生 命 期 也 不 一 定 结 束, 它 可 能 依 然 存 在 于 会 话 池 中, 供 其 他 用 户 调 用 如 果 它 有 自 己 的 属 性 ( 变 量 ), 那 么 这 些 变 量 就 会 受 到 所 有 调 用 它 的 用 户 的 影 响 本 例 子 的 EJB 源 代 码 在 LocalRemoteBean 文 件 夹 ( 源 代 码 下 载 : 项 目 中 使 用 到 的 类 库 在 上 级 目 录 lib 文 件 夹 下 要 恢 复 LocalRemoteBean 项 目 的 开 发 环 境 请 参 考 第 三 章 如 何 恢 复 本 书 配 套 例 子 的 开 发 环 境, 要 发 布 本 例 子 EJB ( 确 保 配 置 了 环 境 变 量 JBOSS_HOME 及 启 动 了 Jboss), 你 可 以 执 行 Ant 的 deploy 任 务 本 例 子 的 客 户 端 代 码 在 EJBTest 文 件 夹, 要 发 布 客 户 端 应 用, 你 可 以 执 行 Ant 的 deploy 任 务 通 过 访 问 客 户 端

38 在 Jboss 网 站 看 到, 在 EJB3.0 RC9(Jboss 4.0.5GA 内 含 ) 版 本 中 Remote 及 Local 接 口 可 以 指 向 同 一 个 业 务 接 口, 这 样 客 户 端 就 不 会 因 调 用 接 口 的 不 同 而 来 回 切 换 业 务 接 口 类 当 然 这 种 使 用 场 合 是 在 Remote 和 Local 的 接 口 方 法 相 同 的 情 况 下 如 : session bena 片 @Local({Same.class) public class SameBean implements Same { public String say(string who){ return who + " 说 : 我 就 爱 使 用 同 一 个 业 务 接 口 "; JSP 客 户 端 <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.same, javax.naming.*, java.util.properties"%> <% Properties props = new Properties(); props.setproperty("java.naming.factory.initial", "org.jnp.interfaces.namingcontextfactory"); props.setproperty("java.naming.provider.url", "localhost:1099"); props.setproperty("java.naming.factory.url.pkgs", "org.jboss.naming"); InitialContext ctx; try { ctx = new InitialContext(props); Same same = (Same) ctx.lookup("samebean/remote"); out.println(same.say(" 佛 山 人 ")); out.println("<br> <br>"); Same same2 = (Same) ctx.lookup("samebean/local"); out.println(same2.say(" 黎 明 ")); catch (NamingException e) { out.println(e.getmessage()); %> 上 面 的 Jsp 客 户 端 是 运 行 在 Jboss 中 的, 如 果 你 想 运 行 在 独 立 的 tomcat 中, 你 只 能 调 用 其 remote 接 口 需 要 独 立 运 行 在 tomcat 中, 你 可 以 参 考 第 二 章 在 独 立 的 Tomcat 中 调 用 EJB 4.2 Stateful Session Beans( 有 状 态 bean) 开 发 有 状 态 Bean 是 一 个 可 以 维 持 自 身 状 态 的 会 话 Bean 每 个 用 户 都 有 自 己 的 一 个 实 例, 在 用 户 的 生 存 期 内,Stateful Session Bean 保 持 了 用 户 的 信 息, 即 有 状 态 ; 一 旦 用 户 灭 亡 ( 调 用 结 束 或 实 例 结 束 ),Stateful Session Bean 的 生 命 期 也 告 结 束 即 每 个 用 户 最 初 都 会 得 到 一 个 初 始 的 Stateful Session Bean

39 Stateful Session Bean 的 开 发 步 骤 与 Stateless Session Bean 的 开 发 步 骤 相 同 先 定 义 业 务 接 口, 例 子 代 码 如 下 : MyAccount.java //author:lihuoming package com.foshanshop.ejb3; import java.io.serializable; public interface MyAccount extends Serializable { public int Add(int a, int b); public int getresult() ; 大 家 注 意 stateful session bean 必 须 实 现 Serializable 接 口, 这 样 EJB 容 器 才 能 在 她 们 不 再 使 用 时 序 列 化 存 储 她 们 的 状 态 信 息. MyAccountBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import javax.ejb.remote; import javax.ejb.stateful; @Remote(MyAccount.class) public class MyAccountBean implements MyAccount{ private int total = 0; private int addresult = 0; public int Add(int a, int b) { addresult = a + b; return addresult; public int getresult() { total += addresult; return total; 上 面 MyAccountBean 直 接 实 现 MyAccount 接 口, 通 注 释 定 义 这 是 一 个 有 状 态 会 话 Bean,@Remote 注 释 指 明 有 状 态 Bean 的 remote 接 注 释 屏 蔽 缺 少 serialversionuid 定 义 的 警 告 下 面 是 MyAccountBean 的 JSP 客 户 端 代 码 : StatefulBeanTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.myaccount,javax.naming.*, java.util.properties"%> <% Properties props = new Properties(); props.setproperty("java.naming.factory.initial", "org.jnp.interfaces.namingcontextfactory");

40 props.setproperty("java.naming.provider.url", "localhost:1099"); props.setproperty("java.naming.factory.url.pkgs", "org.jboss.naming:org.jnp.interfaces"); InitialContext ctx = new InitialContext(props); try { MyAccount A = (MyAccount) ctx.lookup("myaccountbean/remote"); out.println(" 调 用 A.Add() 的 结 果 是 :"+ A.Add(1,1)); out.println("<br> 调 用 A.getResult() 的 结 果 :"+ A.getResult()); out.println("<br>========================================"); MyAccount B = (MyAccount) ctx.lookup("myaccountbean/remote"); out.println("<br> 调 用 B.Add() 的 结 果 是 :"+ B.Add(1,1)); out.println("<br> 调 用 B.getResult() 的 结 果 :"+ B.getResult()); catch (Exception e) { out.println(e.getmessage()); %> 上 面 JSP 客 户 端, 有 A 和 B 两 个 用 户 在 使 用 MyAccountBean, 他 们 的 执 行 结 果 如 下 : 调 用 A.Add() 的 结 果 是 :2 调 用 A.getResult() 的 结 果 :2 ======================================== 调 用 B.Add() 的 结 果 是 :2 调 用 B.getResult() 的 结 果 :2 因 为 stateful session bean 的 每 个 用 户 都 有 自 己 的 一 个 实 例, 所 以 两 者 对 stateful session bean 的 操 作 不 会 影 响 对 方 另 外 注 意 : 如 果 后 面 需 要 操 作 某 个 用 户 的 实 例, 你 必 须 在 客 户 端 缓 存 Bean 的 Stub 对 象 (JSP 通 常 的 做 法 是 用 Session 缓 存 ), 这 样 在 后 面 每 次 调 用 中, 容 器 才 知 道 要 提 供 相 同 的 bean 实 例 本 例 子 的 EJB 源 代 码 在 StatefulBean 文 件 夹 ( 源 代 码 下 载 : 项 目 中 使 用 到 的 类 库 在 上 级 目 录 lib 文 件 夹 下 要 恢 复 StatefulBean 项 目 的 开 发 环 境 请 参 考 第 三 章 如 何 恢 复 本 书 配 套 例 子 的 开 发 环 境, 要 发 布 本 例 子 EJB ( 确 保 配 置 了 环 境 变 量 JBOSS_HOME 及 启 动 了 Jboss), 你 可 以 执 行 Ant 的 deploy 任 务 本 例 子 的 客 户 端 代 码 在 EJBTest 文 件 夹, 要 发 布 客 户 端 应 用, 你 可 以 执 行 Ant 的 deploy 任 务 通 过 访 问 客 户 端 4.3 Stateless Session Bean 与 Stateful Session Bean 的 区 别 这 两 种 Session Bean 都 可 以 将 系 统 逻 辑 放 在 方 法 之 中 执 行, 不 同 的 是 Stateful Session Bean 可 以 记 录 呼 叫 者 的 状 态, 因 此 一 个 使 用 者 会 有 自 己 的 一 个 实 例 Stateless Session Bean 虽 然 也 是 逻 辑 组 件, 但 是 他 却 不 负 责 记 录 使 用 者 状 态, 也 就 是 说 当 使 用 者 呼 叫 Stateless Session Bean 的 时 候,EJB 容 器 并 不 会 寻 找 特 定 的 Stateless Session Bean 的 实 体 来 执 行 这 个 method 换 言 之, 很 可 能 数 个 使 用 者 在 执 行 某 个 Stateless Session Bean 的 methods 时, 会 是 同 一 个 Bean 的 实 例 在 执 行 从 内 存 方 面 来 看,Stateful Session Bean 与 Stateless Session Bean 比 较,Stateful Session Bean 会 消 耗 J2EE Server 较 多 的 内 存, 然 而 Stateful Session Bean 的 优 势 却 在 于 他 可 以 维 持 使 用 者 的 状 态

41 4.4 如 何 改 变 Session Bean 的 JNDI 名 称 默 认 的 JNDI 命 名 规 则 前 面 已 经 介 绍 过, 但 有 些 情 况 下 需 要 自 定 义 名 称 要 自 定 义 JNDI 名 称, 可 以 使 注 注 释 指 定 Session Bean 的 Local 接 口 的 JNDI 名 注 释 指 定 Session Bean 的 Remote 接 口 的 JNDI 名 称, 下 面 的 代 码 展 示 了 如 何 自 定 义 JNDI 名 : //author:lihuoming package com.foshanshop.ejb3.impl; import javax.ejb.local; import javax.ejb.remote; import javax.ejb.stateless; import com.foshanshop.ejb3.localoperation; import com.foshanshop.ejb3.operation; import org.jboss.annotation.ejb.localbinding; (jndibinding="foshanshop/localoperation") public class OperationBean implements Operation, LocalOperation { private int total = 0; private int addresult = 0; public int Add(int a, int b) { addresult = a + b; return addresult; public int getresult() { total += addresult; return total; 在 JSP 客 户 端 调 用 上 面 EJB 的 代 码 片 断 如 下 : InitialContext ctx = new InitialContext(props); Operation operation = (Operation) ctx.lookup("foshanshop/remoteoperation"); 4.5 Session Bean 的 生 命 周 期 EJB 容 器 创 建 和 管 理 session bean 实 例, 有 些 时 候, 你 可 能 需 要 定 制 session bean 的 管 理 过 程 例 如, 你 可 能 想 在 创 建 session bean 实 例 的 时 候 初 始 化 字 段 变 量, 或 在 bean 实 例 被 销 毁 的 时 候 关 掉 外 部 资 源 上 述 这 些, 你 都 可 能 通 过 在 bean 类 中 定 义 生 命 周 期 的 回 调 方 法 来 实 现 这 些 方 法 将 会 被 容 器 在 生 命 周 期 的 不 同 阶 段 调 用 ( 如 : 创 建 或 销

42 毁 时 ) 通 过 使 有 下 面 所 列 的 注 释,EJB 3.0 允 许 你 将 任 何 方 法 指 定 为 回 调 方 法 这 不 同 于 EJB 2.1,EJB 2.1 中, 所 有 的 回 调 方 法 必 须 实 现, 即 使 是 空 的 EJB 3.0 中,bean 可 以 有 任 意 数 量, 任 意 名 字 的 回 调 方 当 bean 对 象 完 成 实 例 化 后, 使 用 了 这 个 注 释 的 方 法 会 被 立 即 调 用 这 个 注 释 同 时 适 用 于 有 状 态 和 无 状 态 的 会 话 使 用 这 个 注 释 的 方 法 会 在 容 器 从 它 的 对 象 池 中 销 毁 一 个 无 用 的 或 者 过 期 的 bean 实 例 之 前 调 用 这 个 注 释 同 时 适 用 于 有 状 态 和 无 状 态 的 会 话 当 一 个 有 状 态 的 session bean 实 例 空 闲 过 长 的 时 间, 容 器 将 会 钝 化 (passivate) 它, 并 把 它 的 状 态 保 存 在 缓 存 当 中 使 用 这 个 注 释 的 方 法 会 在 容 器 钝 化 bean 实 例 之 前 调 用 这 个 注 释 适 用 于 有 状 态 的 会 话 bean 当 钝 化 后, 又 经 过 一 段 时 间 该 bean 仍 然 没 有 被 操 作, 容 器 将 会 把 它 从 存 储 介 质 中 删 除 以 后, 任 何 针 对 该 bean 方 法 的 调 用 容 器 都 会 抛 出 例 当 客 户 端 再 次 使 用 已 经 被 钝 化 的 有 状 态 session bean 时, 新 的 实 例 被 创 建, 状 态 被 恢 复 使 用 此 注 释 的 session bean 会 在 bean 的 激 活 完 成 时 调 用 这 个 注 释 只 适 用 于 有 状 态 的 会 话 这 个 注 释 指 定 了 有 状 态 session bean 初 始 化 的 方 法 它 区 别 注 释 在 于 : 多 注 释 方 法 可 以 同 时 存 在 于 有 状 态 session bean 中, 但 每 个 bean 实 例 只 会 有 一 注 释 的 方 法 会 被 调 用 这 取 决 于 bean 是 如 何 创 建 的 ( 细 节 请 看 EJB 3.0 规 范 之 后 被 调 用 另 一 个 有 用 的 生 命 周 期 方 法 注 释 特 别 是 对 于 有 状 态 session bean 当 应 用 通 过 存 根 对 象 调 用 使 用 注 释 的 方 法 时, 容 器 就 知 道 在 该 方 法 执 行 完 毕 后, 要 把 bean 实 例 从 对 象 池 中 移 走 下 面 是 这 些 生 命 周 期 方 法 注 释 在 LifeCycleBean 中 的 一 个 示 例 : LifeCycleBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import com.foshanshop.ejb3.lifecycle; import javax.annotation.postconstruct; import javax.annotation.predestroy; import javax.ejb.init; import javax.ejb.postactivate; import javax.ejb.prepassivate; import javax.ejb.remote; import javax.ejb.remove; ({LifeCycle.class) public class LifeCycleBean implements LifeCycle { public String Say() { try { Thread.sleep(1000*30); catch (InterruptedException e) { e.printstacktrace(); return " 这 是 会 话 Bean 生 命 周 期 应 用 例 子 ";

43 @Init public void initialize () { System.out.println("initialize() 方 法 被 调 用 public void Construct () { System.out.println("Construct() 方 法 被 调 用 public void exit () { System.out.println("exit() 方 法 被 调 用 public void serialize () { System.out.println("serialize() 方 法 被 调 用 public void activate () { System.out.println("activate() 方 法 被 调 用 public void stopsession () { System.out.println("stopSession() 方 法 被 调 用 "); // 调 用 该 方 法 以 通 知 容 器 移 除 该 bean 实 例 终 止 会 话 方 法 体 可 以 是 空 的 本 例 子 的 运 行 结 果 输 出 在 Jboss 控 制 台, 请 仔 细 观 察 下 面 是 LifeCycleBean 的 Remote 接 口 LifeCycle.java //author:lihuoming package com.foshanshop.ejb3; public interface LifeCycle { public String Say(); public void stopsession (); 下 面 是 Session Bean 的 JSP 客 户 端 代 码 : LifeCycleTest.jsp

44 page contenttype="text/html; charset=gbk"%> page import="com.foshanshop.ejb3.lifecycle, javax.naming.*, java.util.properties"%> <% Properties props = new Properties(); props.setproperty("java.naming.factory.initial", "org.jnp.interfaces.namingcontextfactory"); props.setproperty("java.naming.provider.url", "localhost:1099"); props.setproperty("java.naming.factory.url.pkgs", "org.jboss.naming"); try { LifeCycle lifecycle = (LifeCycle) session.getattribute("lifecycle"); if (lifecycle == null) { InitialContext ctx = new InitialContext(props); lifecycle = (LifeCycle) ctx.lookup("lifecyclebean/remote"); session.setattribute ("lifecycle", lifecycle); out.println(lifecycle.say()); out.println("<br> 请 注 意 观 察 Jboss 控 制 台 输 出. 等 待 9 分 钟 左 右, 容 器 将 会 钝 化 此 会 话 Bean,@PrePassivate 注 释 的 方 法 将 会 执 行 <BR>"); out.println("<font color=red> 你 可 以 执 行 会 话 Bean 的 stopsession 方 法, 把 会 话 Bean 实 例 从 对 象 池 中 移 走 在 销 毁 这 个 会 话 Bean 之 前 将 会 执 注 释 的 方 法 <BR></font>"); /* lifecycle.stopsession(); */ catch (Exception e) { out.println(e.getmessage()); %> 本 例 子 的 EJB 源 代 码 在 SessionBeanLifeCycle 文 件 夹 ( 源 代 码 下 载 : 项 目 中 使 用 到 的 类 库 在 上 级 目 录 lib 文 件 夹 下 要 恢 复 SessionBeanLifeCycle 项 目 的 开 发 环 境 请 参 考 第 三 章 如 何 恢 复 本 书 配 套 例 子 的 开 发 环 境, 要 发 布 本 例 子 EJB ( 确 保 配 置 了 环 境 变 量 JBOSS_HOME 及 启 动 了 Jboss), 你 可 以 执 行 Ant 的 deploy 任 务 本 例 子 的 客 户 端 代 码 在 EJBTest 文 件 夹, 要 发 布 客 户 端 应 用, 你 可 以 执 行 Ant 的 deploy 任 务 通 过 访 问 客 户 端 4.6 拦 截 器 (Interceptor) 拦 截 器 可 以 监 听 程 序 的 一 个 或 所 有 方 法 拦 截 器 对 方 法 调 用 流 提 供 了 细 粒 度 控 制 可 以 在 无 状 态 会 话 bean 有 状 态 会 话 bean 和 消 息 驱 动 bean 上 使 用 它 们 拦 截 器 可 以 是 同 一 bean 类 中 的 方 法 或 是 一 个 外 部 类 下 面 介 绍 如 何 在 Session Bean 类 中 使 用 外 部 拦 截 器 类

45 HelloChinaBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import com.foshanshop.ejb3.hellochina; import com.foshanshop.ejb3.hellochinaremote; import javax.ejb.local; import javax.ejb.remote; import javax.ejb.stateless; @Interceptors({HelloInterceptor.class) public class HelloChinaBean implements HelloChina,HelloChinaRemote { public String SayHello(String name) { return name +" 说 : 你 好! 中 国."; public String Myname() { return " 我 是 佛 山 人 注 释 指 定 一 个 或 多 个 在 外 部 类 中 定 义 的 拦 截 器 上 面 拦 截 器 HelloInterceptor 对 HelloChinaBean 中 的 所 有 方 法 进 行 监 听 拦 截 器 HelloInterceptor.java //author:lihuoming package com.foshanshop.ejb3.impl; import javax.interceptor.aroundinvoke; import javax.interceptor.invocationcontext; public class HelloInterceptor public Object log(invocationcontext ctx) throws Exception { System.out.println("*** HelloInterceptor intercepting"); long start = System.currentTimeMillis(); try{ if (ctx.getmethod().getname().equals("sayhello")){ System.out.println("*** SayHello 已 经 被 调 用! *** " ); if (ctx.getmethod().getname().equals("myname")){ System.out.println("*** Myname 已 经 被 调 用! *** " );

46 return ctx.proceed(); catch (Exception e) { throw e; finally { long time = System.currentTimeMillis() - start; System.out.println(" 用 时 :"+ time + 注 释 指 定 了 要 用 作 拦 截 器 的 方 法 注 释 指 定 的 方 法 必 须 遵 守 以 下 格 式 : public Object XXX(InvocationContext ctx) throws Exception XXX 代 表 方 法 名 可 以 任 意 下 面 是 HelloChinaBean 的 本 地 及 远 程 业 务 接 口 HelloChina.java //author:lihuoming package com.foshanshop.ejb3; public interface HelloChina extends HelloChinaRemote{ HelloChinaRemote.java //author:lihuoming package com.foshanshop.ejb3; public interface HelloChinaRemote { public String SayHello(String name); public String Myname(); 下 面 是 Session Bean 的 JSP 客 户 端 代 码 : InterceptorTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.hellochinaremote, javax.naming.*, java.util.properties"%> <% Properties props = new Properties(); props.setproperty("java.naming.factory.initial", "org.jnp.interfaces.namingcontextfactory"); props.setproperty("java.naming.provider.url", "localhost:1099"); props.setproperty("java.naming.factory.url.pkgs", "org.jboss.naming"); InitialContext ctx; try { ctx = new InitialContext(props); HelloChinaRemote hellochinaremote = (HelloChinaRemote) ctx.lookup("hellochinabean/remote"); out.println(hellochinaremote.sayhello(" 佛 山 人 "));

47 %> out.println("<br>"+ hellochinaremote.myname()); catch (NamingException e) { out.println(e.getmessage()); 除 了 可 以 在 外 部 定 义 拦 截 器 之 外, 还 可 以 将 Session Bean 中 的 一 个 或 多 个 方 法 定 义 为 拦 截 器 下 面 以 上 面 的 HelloChinaBean 为 例, 介 绍 在 Session Bean 中 如 何 定 义 拦 截 器 HelloChinaBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import com.foshanshop.ejb3.hellochina; import com.foshanshop.ejb3.hellochinaremote; import javax.ejb.local; import javax.ejb.remote; import javax.ejb.stateless; import javax.interceptor.aroundinvoke; public class HelloChinaBean implements HelloChina,HelloChinaRemote { public String SayHello(String name) { return name +" 说 : 你 好! 中 国."; public String Myname() { return " 我 是 佛 山 人 public Object log(invocationcontext ctx) throws Exception { try{ if (ctx.getmethod().getname().equals("sayhello")){ System.out.println("*** HelloChinaBean.SayHello() 已 经 被 调 用! *** " ); if (ctx.getmethod().getname().equals("myname")){ System.out.println("*** HelloChinaBean.Myname() 已 经 被 调 用! *** " ); return ctx.proceed(); catch (Exception e) { throw e;