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() 改变实体管理器的 Flush 模式 setflushmode() 获取持久化实现者的引用 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 字符串函数 计算函数...129

4 子查询 结果集分页 调用存储过程 调用无返回值的存储过程 调用返回单值的存储过程 调用返回表全部列的存储过程 调用返回部分列的存储过程 事务管理服务 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 server/all/tmp 面两个目录 ) JBoss 的日志文件 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;

48 注释就指定了要用作拦截器的方法 本例子的 EJB 源代码在 Interceptor 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 Interceptor 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 4.7 依赖注入 (dependency injection) 上面, 你学到了如何开发藕合松散的服务组件 但是, 为了存取那些服务对象, 你需要通过服务器的 JNDI 来查找存根对象 (session bean) 或消息队列 (MDB) JNDI 查找是把客户端与实际的服务端实现解藕的关键步骤 但是, 直接使用一个字符串来进行 JNDI 查找并不优雅 有这样几个原因 : 客户端与服务端必须有一致的基于字符串的名字 它没有在编译时得到认证或在部署时得到检查 从 JNDI 返回的服务对象的类型没有在编译时进行检查, 有可能在运行时出现转换 (casting) 错误 冗长的查找代码, 有着自己的 try-catch 代码块, 在应用之间是重复的和杂乱的 EJB 3.0, 对任何 POJO, 提供了一个简单的和优雅的方法来解藕服务对象和资源 注释, 你可以将 EJB 存根对象注入到任何 EJB 3.0 容器管理的 POJO 中 如果注释用在一个属性变量上, 容器将会在它被第一次访问 之前赋值给它 依赖注入只工作在本地命名服务中, 因此你不能注入远程服务器的对象 Jboss4.0.5 注释已从 javax.annotation 包移到 javax.ejb, 如果本例子运行在 Jboss4.0.5 以下版本, 将 会出错 下面的例子演示了怎样把 HelloWorldBean 无状态 session bean 的存根注入到 InjectionBean 类中 InjectionBean.java package com.foshanshop.ejb3.impl; import com.foshanshop.ejb3.helloworld; import com.foshanshop.ejb3.injection; import javax.ejb.ejb; import javax.ejb.remote; ({Injection.class) public class InjectionBean implements Injection (beanname="helloworldbean") HelloWorld helloworld; public String SayHello() { return helloworld.sayhello(" 注入者 ");

49 @EJB 注释的 beanname 属性指定 EJB 的类名 ( 不带包名 ), 他的另一个属性 mappedname 指定 Bean 实例的 JNDI 名 下面的片断演示了如何使用 beanname 或 mappedname 属性查找 HelloWorldBean 会话 bean public class InjectionBean implements Injection (beanname="helloworldbean") //@EJB (mappedname="helloworldbean/remote") HelloWorld 注释如果被用在 JavaBean 风格的 setter 方法上时, 容器会在属性第一次使用之前, 自动地用正确的参数调用 bean 的 setter 方法 下面的片断演示了这是如何做的 public class InjectionBean implements Injection { HelloWorld (beanname="helloworldbean") public void sethelloworld(helloworld helloworld) { this.helloworld = helloworld;.. 下面是 InjectionBean 的 Remote 业务接口 Injection.java //author:lihuoming package com.foshanshop.ejb3; public interface Injection { public String SayHello(); 下面是 Session Bean 的 JSP 客户端代码 : InjectionTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.injection, 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); Injection injection = (Injection) ctx.lookup("injectionbean/remote"); out.println(injection.sayhello()); catch (NamingException e) {

50 %> 注释只能注入 EJB 存根对象, 注释之外,EJB 3.0 注释来注入来自 JNDI 的任何资源 下面的例子中演示了如何注入数据源 "java:/defaultmysqlds" 是数据源 DefaultMySqlDS 的全局 JNDI 名 有关数据源的配置请参考后面章节 JBoss 数据源的配置 //author:lihuoming package com.foshanshop.ejb3.impl; import java.sql.connection; import java.sql.resultset; import java.sql.sqlexception; import java.sql.statement; import com.foshanshop.ejb3.helloworld; import com.foshanshop.ejb3.injection; import javax.annotation.resource; import javax.ejb.ejb; import javax.ejb.remote; import javax.ejb.stateless; { Injection.class ) public class InjectionBean implements Injection = "HelloWorldBean") HelloWorld = "java:/defaultmysqlds") DataSource mydb; public String SayHello() { String str = ""; try { Connection conn = mydb.getconnection(); Statement stmt = conn.createstatement(); ResultSet rs = stmt.executequery("select studentname FROM student"); if (rs.next()) { str = rs.getstring(1); rs.close(); stmt.close(); catch (SQLException e) { e.printstacktrace();

51 return helloworld.sayhello(str); 如果 JNDI 对象在本地 (java:comp/env)jndi 目录中, 你只需给定他的映谢名称即可, 不需要带前缀, 如下面例子注入一个消息 connection factory 和一个 messaging (mappedname="connectionfactory") QueueConnectionFactory (mappedname="queue/a") Queue queue; 对于 "well-known" 注释可以不指定 JNDI 名就能注入他们, 他通过变量的类型就能获得他的 JNDI 名 TimerService SessionContext ctx; 注释也可以被用在 JavaBean 风格的 setter 方法上 本例子的 EJB 源代码在 DependencyInjection 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 DependencyInjection 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB, 你可以执行 Ant 的 deploy 任务 发布前确保 HelloWorld.jar 已经发布到 Jboss 中 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 注意 : 在实际部署中, 如果 DependencyInjection.jar 和 HelloWorld.jar 文件同时存在于 jboss 启动 Jboss 时,Jboss 按默认的发布顺序先发布 DependencyInjection.jar, 后发布 HelloWorld.jar, 因为 DependencyInjection.jar 文件中使用到了 HelloWorld.jar 文件里的类, 所以就会抛出找不到类的例外, 导致 DependencyInjection.jar 发布失败 要解决这个问题, 作者给大家提供一个办法 : 在 [Jboss 安装目录 ]/ server/all/conf 文件夹中找到 jboss-service.xml 文件, 打开文件并找到 : <attribute name="urlcomparator">org.jboss.deployment.deploymentsorter</attribute> <!-- <attribute name="urlcomparator">org.jboss.deployment.scanner.prefixdeploymentsorter</attribute> --> 修改成 : <! <attribute name="urlcomparator"> org.jboss.deployment.deploymentsorter</attribute> --> <attribute name="urlcomparator">org.jboss.deployment.scanner.prefixdeploymentsorter</attribute> 给 jar 文件编个号, 格式为 :01_XXX.jar 如给本例子 jar 文件编号, 修改后的文件名称如下 : 01_HelloWorld.jar 02_DependencyInjection.jar

52 Jboss 将根据编号按从小到大的顺序发布 jar 文件 4.8 定时服务 (Timer Service) 定时服务用作在一段特定的时间后执行某段程序, 估计各位在不同的场合中已经使用过 下面就直接介绍 EJB3.0 定时服务的开发过程 定时服务的开发过程与会话 Bean 的开发过程大致相同, 但比会话 Bean 多了几个操作, 那就是使用容器对象 SessionContext 创建定时器, 注释声明定时器方法 下面定义一个每隔 3 秒触发一次事件的定时器, 当定时事件触发次数超过 5 次的时候便终止定时器的执行 TimerServiceBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import java.util.date; import com.foshanshop.ejb3.timerservice; import javax.annotation.resource; import javax.ejb.remote; import javax.ejb.sessioncontext; import javax.ejb.stateless; import javax.ejb.timeout; ({TimerService.class) public class TimerServiceBean implements TimerService { private int count = 1; SessionContext ctx; public void scheduletimer(long milliseconds){ count = 1; ctx.gettimerservice().createtimer(new Date(new Date().getTime() + milliseconds),milliseconds, " 大家好, 这是我的第一个定时器 public void timeouthandler(timer timer) { System.out.println(" "); System.out.println(" 定时器事件发生, 传进的参数为 : " + timer.getinfo()); System.out.println(" "); if (count>=5){ timer.cancel();// 如果定时器触发 5 次, 便终止定时器 count++;

53 SessionContext ctx, 我们获得 SessionContext 对象, 调用 ctx.gettimerservice().createtimer (Date arg0, long arg1, Serializable arg2) 方法创建定时器, 三个参数的含义如下 : Date arg0 定时器启动时间, 如果传入时间小于现在时间, 定时器会立刻启动 long arg1 间隔多长时间后再次触发定时事件 单位 : 毫秒 Serializable arg2 你需要传给定时器的参数, 该参数必须实现 Serializable 接口 当定时器创建完成后, 我们还需声明定时器方法 定时器方法的声明很简单, 注释, 另外定时器方法必须遵守如下格式 : void XXX(Timer timer) 在定时事件发生时, 此方法将被执行 下面是 TimerServiceBean 的 Remote 业务接口 TimerService.java //author:lihuoming package com.foshanshop.ejb3; public interface TimerService { public void scheduletimer(long milliseconds); 下面是 TimerServiceBean 的 JSP 客户端代码 : TimerServiceTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.timerservice, 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 { InitialContext ctx = new InitialContext(props); TimerService timer = (TimerService) ctx.lookup("timerservicebean/remote"); timer.scheduletimer((long)3000); out.println(" 定时器已经启动, 请观察 Jboss 控制台输出, 如果定时器触发 5 次, 便终止定时器 catch (Exception e) { out.println(e.getmessage()); 本例子的 EJB 源代码在 TimerService 文件夹 ( 源代码下载 : 项目中使用到的类库在上

54 级目录 lib 文件夹下 要恢复 TimerService 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 4.9 安全服务 (Security service) 当公司网络外部的用户需要访问你编写的应用程序或受安全保护的资源时, 很多 Java 程序员为他们的应用程序创建自己的安全模块 大多数这些模块都是针对具体的应用程序, 这样在下一个应用程序需要安全保护时, 程序员又重新开始所有工作 构建自己的安全模块的另外一个缺点是, 在应用程序变得越来越复杂时, 安全需求也会变得很复杂 使用 Java 验证和授权服务 (JAAS) 可以很好地解决上面的问题, 你可以用它来管理应用程序的安全性 JAAS 具有两个特性 : 验证 (Authentication) 和授权 (authorization), 认证是完成用户名和密码的匹配校验 ; 授权是决定用户可以访问哪些资源, 授权是基于角色的 Jboss 服务器提供了安全服务来进行用户认证和根据用户规则来限制对 POJO 的访问 对每一个 POJO 来说, 注释为它指定一个安全域, 安全域告诉容器到哪里去找密码和用户角色列表 JBoss 中的 other 域表明文件是 classpath 中的 users.propertes 和 roles.properties 这样, 对每一个方法来说, 我们可以使用一个安全限制注释来指定谁可以运行这个方法 比如, 下面的例子, 容器对所有试图调用 AdminUserMethod() 的用户进行认证, 只允许拥有 AdminUser 角色的用户运行它 如果你没有登录或者没有以管理员的身份登录, 一个安全意外将会抛出 本例定义了三种角色, 各角色的含义如下 : 角色名称说明 AdminUser 系统管理员角色 DepartmentUser 各事业部用户角色 CooperateUser 公司合作伙伴角色本例设置了三个用户, 各用户名及密码如下 : 用户名密码 lihuoming zhangfeng wuxiao 123 本例使用了 Jboss 默认的安全域 other, other 安全域告诉容器到 classpath 中的 users.propertes 和 roles.properties 找密码和用户角色列表 other 安全域的定义在 [jboss 安装目录 ]/server/all/conf/login-config.xml 文件 内容如下 : <application-policy name = "other"> <!-- A simple server login module, which can be used when the number of users is relatively small. It uses two properties files: users.properties, which holds users (key) and their password (value). roles.properties, which holds users (key) and a comma-separated list of their roles (value). The unauthenticatedidentity property defines the name of the principal that will be used when a null username and password are presented as is the case for an unuathenticated web client or MDB. If you want to allow such users to be authenticated add the property, e.g., unauthenticatedidentity="nobody" -->

55 <authentication> <login-module code = "org.jboss.security.auth.spi.usersrolesloginmodule" flag = "required" /> </authentication> </application-policy> other 安全域默认情况下是不允许匿名用户 ( 不提供用户名及密码 ) 访问的, 注释定义的资源, 可以修改 other 安全域配置, 修改片断如下 ( 蓝色部分 ): <application-policy name = "other"> <authentication> <login-module code = "org.jboss.security.auth.spi.usersrolesloginmodule" flag = "required" /> <module-option name = "unauthenticatedidentity">anonymoususer</module-option> </authentication> </application-policy> 注意 : 本例子采用的是 other 域默认配置, 没有修改过 login-config.xml 文件 注释的方法 注释的方法, 必须提供 users.propertes 文件中的用户 下面我们就开始安全服务的具体开发 : 开发的第一步是定义安全域, 安全域的定义有两种方法 : 第一种方法 : 通过 Jboss 发布文件 (jboss.xml) 进行定义 ( 本例采用的方法 ), 定义内容如下 : jboss.xml( 本例使用 Jboss 默认的安全域 other ) <?xml version="1.0" encoding="utf-8"?> <jboss> <!-- Bug in EJB3 of JBoss GA <security-domain>java:/jaas/other</security-domain> --> <security-domain>other</security-domain> <unauthenticated-principal>anonymoususer</unauthenticated-principal> </jboss> jboss.xml 必须打进 Jar 文件的 META-INF 目录 第二种方法 : 注释进行定义, 注释代码片断如下 : public class SecurityAccessBean implements SecurityAccess{ 由于使用的是 Jboss 安全注释, 程序采用了硬编码, 不利于日后迁移到其他 J2EE 服务器 ( 如 : WebLogic), 所以作者不建议使用这种方法定义安全域 定义好安全域之后, 因为我们使用 Jboss 默认的安全域 other, 所以必须使用 users.propertes 和 roles.properties 存储用户名 / 密码及用户角色 现在开发的第二步就是定义用户名, 密码及用户的角色 用户名和密码定义在 users.propertes 文件, 用户所属角

56 色定义在 roles.properties 文件 以下是这两个文件的具体配置 : users.propertes( 定义了本例使用的三个用户 ) lihuoming= zhangfeng= wuxiao=123 roles.properties( 定义了三个用户所具有的角色, 其中用户 lihuoming 具有三种角色 ) lihuoming=adminuser,departmentuser,cooperateuser zhangfeng=departmentuser wuxiao=cooperateuser 以上两个文件必须存放于类路径下 在进行用户验证时,Jboss 容器会自动寻找这两个文件 开发的第三步就是为业务方法定义访问角色 本例定义了三个方法 :AdminUserMethod(), DepartmentUserMethod(),AnonymousUserMethod(), 第一个方法只允许具有 AdminUser 角色的用户访问, 第二个方法只允许具有 DepartmentUser 角色的用户访问, 第三个方法允许所有角色的用户访问 下面是 Session Bean 代码 SecurityAccessBean.java package com.foshanshop.ejb3.impl; import com.foshanshop.ejb3.securityaccess; import javax.annotation.security.permitall; import javax.annotation.security.rolesallowed; import javax.ejb.remote; ({SecurityAccess.class) public class SecurityAccessBean implements public String AdminUserMethod() { return " 具有管理员角色的用户才可以访问 AdminUserMethod() 方法 public String DepartmentUserMethod() { return " 具有事业部门角色的用户才可以访问 DepartmentUserMethod() 方法 public String AnonymousUserMethod() { return " 任何角色的用户都可以访问 AnonymousUserMethod() 方法, 注 : 用户必须存在 users.properties 文件哦 注释定义允许访问方法的角色列表, 如角色为多个, 注释定义所有的角色都可以访问此方法

57 下面是 SecurityAccessBean 的 Remote 接口 SecurityAccess.java package com.foshanshop.ejb3; public interface SecurityAccess { public String AdminUserMethod(); public String DepartmentUserMethod(); public String AnonymousUserMethod(); 到目前为止一个安全服务例子就开发完成 下面我们看看客户端如何访问具有安全验证的 SecurityAccessBean SecurityAccessTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.securityaccess, javax.naming.*, org.jboss.security.*, java.util.*"%> <% 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); String user = request.getparameter("user"); String pwd = request.getparameter("pwd"); if (user!=null &&!"".equals(user.trim())){ SecurityAssociation.setPrincipal(new SimplePrincipal(user.trim())); SecurityAssociation.setCredential(pwd.trim().toCharArray()); SecurityAccess securityaccess = (SecurityAccess) ctx.lookup("securityaccessbean/remote"); try{ out.println("<font color=green> 调用结果 :</font>"+ securityaccess.adminusermethod()+ "<br>"); catch(exception e){ out.println(user+ " 没有权限访问 AdminUserMethod 方法 <BR>"); out.println("==========================<br>"); try{ out.println("<font color=green> 调用结果 :</font>"+ securityaccess.departmentusermethod()+ "<br>"); catch(exception e){

58 out.println(user+ " 没有权限访问 DepartmentUserMethod 方法 <BR>"); out.println("==========================<br>"); try{ out.println("<font color=green> 调用结果 :</font>"+ securityaccess.anonymoususermethod()+ "<br>"); catch(exception e){ out.println(user+ " 没有权限访问 AnonymousUserMethod 方法 <BR>"); %> SecurityAssociation.clear(); <html> <head> <title> 安全访问测试 </title> </head> <body> <center><h2> 安全访问测试 </h2></center> <br /> 请输入你的用户名及密码 <br /> <form method="post" action="securityaccesstest.jsp"> Username: <input type="text" name="user"/> <br /> Password: <input type="password" name="pwd"/> <br /> <input type="submit" value=" 身份验证 "/> </form> <p> 管理员用户名 : <STRONG>lihuoming</STRONG> 密码 : <STRONG>123456</STRONG> </p> <p> 事业部用户名 : <STRONG>zhangfeng</STRONG> 密码 <STRONG>111111</STRONG></p> <p> 合作伙伴用户名 : <STRONG>wuxiao</STRONG> 密码 <STRONG>123</STRONG></p> </body> </html> 本例子的 EJB 源代码在 SecurityWithPropertiesFile 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 SecurityWithPropertiesFile 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过

59 访问客户端 自定义安全域 把用户名 / 密码及角色存放在 users.propertes 和 roles.properties 文件, 不便于日后的管理 大多数情况下我们都希望把用户名 / 密码及角色存放在数据库中 为此, 我们需要自定义安全域, 下面的例子定义了一个名为 foshanshop 的安全域, 他采用数据库存储用户名及角色 安全域在 [jboss 安装目录 ]/server/all/conf/login-config.xml 文件中定义, 本例配置片断如下 : <!--... foshanshop login configuration...--> <application-policy name="foshanshop"> <authentication> <login-module code="org.jboss.security.auth.spi.databaseserverloginmodule" flag="required"> <module-option name="dsjndiname">java:/defaultmysqlds</module-option> <module-option name="principalsquery"> select password from sys_user where name=? </module-option> <module-option name="rolesquery"> select rolename,'roles' from sys_userrole where username=? </module-option> <module-option name = "unauthenticatedidentity">anonymoususer</module-option> </login-module> </authentication> </application-policy> 上面使用了 Jboss 数据库登录模块 (org.jboss.security.auth.spi.databaseserverloginmodule), 他的 dsjndiname 属性 ( 数据源 JNDI 名 ) 使用 DefaultMySqlDS 数据源 ( 本教程自定义的数据源, 关于数据源的配置请参考后面章节 :JBoss 数据源的配置 ), principalsquery 属性定义 Jboss 通过给定的用户名如何获得密码, rolesquery 属性定义 Jboss 通过给定的用户名如何获得角色列表, 注意 :SQL 中的 'Roles' 常量字段不能去掉 unauthenticatedidentity 属性允许匿名用户 ( 不提供用户名及密码 ) 访问 foshanshop 安全域使用的 sys_user 和 sys_userrole 表是自定义表, 实际项目开发中你可以使用别的表名 sys_user 表必须含有用户名及密码两个字段, 字段类型为字符型, 至于字符长度视你的应用而定 sys_userrole 表必须含有用户名及角色两个字段, 字段类型为字符型, 字符长度也视你的应用而定 下面是 sys_user,sys_userrole 表的具体定义 ( 实际项目开发中字段名可以自定义 ) sys_user 表 : 字段名属性 name( 主键 ) varchar(45) NOT NULL password varchar(45) NOT NULL DDL: CREATE TABLE `sys_user` ( `name` varchar(45) NOT NULL, `password` varchar(45) NOT NULL, PRIMARY KEY (`name`) ) ENGINE=InnoDB DEFAULT CHARSET=gb2312;

60 sys_userrole 表 : 字段名属性 username( 主键 ) varchar(45) NOT NULL rolename( 主键 ) varchar(45) NOT NULL DDL: CREATE TABLE `sys_userrole` ( `username` varchar(45) NOT NULL, `rolename` varchar(45) NOT NULL, PRIMARY KEY (`username`,`rolename`) ) ENGINE=InnoDB DEFAULT CHARSET=gb2312; 为了使用本例子, 你还需往 sys_user,sys_userrole 表添加数据 : name password lihuoming zhangfeng wuxiao 123 username lihuoming lihuoming lihuoming wuxiao zhangfeng rolename AdminUser DepartmentUser CooperateUser CooperateUser DepartmentUser 在完成上面的配置后, 我们就可以使用 foshanshop 安全域了, 配置内容如下 : jboss.xml <?xml version="1.0" encoding="utf-8"?> <jboss> <!-- Bug in EJB3 of JBoss GA <security-domain>java:/jaas/foshanshop</security-domain> --> <security-domain>foshanshop</security-domain> <unauthenticated-principal>anonymoususer</unauthenticated-principal> </jboss> jboss.xml 必须打进 Jar 文件的 META-INF 目录 本节我们仍然使用上节的 SecurityAccessBean 及 Jsp 客户端, 代码这里不再列出 本例子的 EJB 源代码在 SecurityWithDB 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 SecurityWithDB 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端

61 注意 : 别忘了配置数据源 foshanshop 安全域 数据库表及例子所需数据 第五章消息驱动 Bean (Message Driven Bean) 消息驱动 Bean(MDB) 是设计用来专门处理基于消息请求的组件 一个 MDB 类必须实现 MessageListener 接口 当容器检测到 bean 守候的队列一条消息时, 就调用 onmessage() 方法, 将消息作为参数传入 MDB 在 OnMessage() 中决定如何处理该消息 你可以用注释来配置 MDB 监听哪一条队列 当 MDB 部署时, 容器将会用到其中的注释信息 当一个业务执行的时间很长, 而执行结果无需实时向用户反馈时, 很适合使用消息驱动 Bean 如订单成功后给用户发送一封电子邮件或发送一条短信等 下面的例子在用户下订单完成后, 打印一份配送单 好让配送员根据地址把商品送到客人手中 代码如下 : PrintBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import javax.ejb.activationconfigproperty; import javax.ejb.messagedriven; import javax.jms.message; import javax.jms.messagelistener; import = propertyvalue="queue/foshanshop") ) public class PrintBean implements MessageListener { public void onmessage(message msg) { try { TextMessage tmsg = (TextMessage) msg; this.print(tmsg.gettext()); catch (Exception e){ e.printstacktrace(); private void print(string content){ System.out.println(content);

62 注释指明这是一个消息驱动 Bean, 注释配置消息的各种属性, 其中 destinationtype 属性指定消息的类型, 消息有两种类型 topics 和 queues, 下面是这两种消息类型的介绍 : Topics 可以有多个客户端 用 topic 发布允许一对多, 或多对多通讯通道 消息的产生者被叫做 publisher, 消息接受者叫做 subscriber destinationtype 属性对应值 :javax.jms.topic Queue 仅仅允许一个消息传送给一个客户 一个发送者将消息放入消息队列, 接受者从队列中抽取并得到消息, 消息就会在队列中消失 第一个接受者抽取并得到消息后, 其他人就不能再得到它 destinationtype 属性对应值 : javax.jms.queue destination 属性用作指定消息路径, 消息驱动 Bean 在发布时, 如果路径不存在, 容器会自动创建该路径, 当容器关闭时该路径会自动被删除 运行本例子, 当一个消息到达 queue/foshanshop 队列时, 就会触发 onmessage 方法, 消息作为一个参数传入, 在 onmessage 方法里面得到消息体并调用 print 方法把消息内容打印到控制台上 MessageDrivenBeanTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="javax.naming.*, java.text.*, javax.jms.*, java.util.properties"%> <% QueueConnection cnn = null; QueueSender sender = null; QueueSession sess = null; Queue queue = null; try { 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); QueueConnectionFactory factory = (QueueConnectionFactory) ctx.lookup("connectionfactory"); cnn = factory.createqueueconnection(); sess = cnn.createqueuesession(false, QueueSession.AUTO_ACKNOWLEDGE); queue = (Queue) ctx.lookup("queue/foshanshop"); catch (Exception e) { out.println(e.getmessage()); TextMessage msg = sess.createtextmessage(" 佛山人您好, 这是我的第一个消息驱动 Bean"); sender = sess.createsender(queue); sender.send(msg); sess.close ();

63 out.println(" 消息已经发送出去了, 你可以到 JBoss 控制台查看 Bean 的输出 "); %> 上面的 JSP 客户端用来向 queue/foshanshop 消息队列发送一条消息 客户端发送消息一般有以下步骤 : (1) 得到一个 JNDI 初始化上下文 (Context); 例子对应代码 : 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); (2) 根据上下文来查找一个连接工厂 TopicConnectFactory/ QueueConnectionFactory ( 有两种连接工厂, 根据是 topic/queue 来使用相应的类型 ); 例子对应代码 : QueueConnectionFactory factory = (QueueConnectionFactory) ctx.lookup("connectionfactory"); (3) 从连接工厂得到一个连接 (Connect 有两种 [TopicConnection/ QueueConnection]); 例子对应代码 :cnn = factory.createqueueconnection(); (4) 通过连接来建立一个会话 (Session); 例子对应代码 :sess = cnn.createqueuesession(false, QueueSession.AUTO_ACKNOWLEDGE); 这句代码意思是 : 建立不需要事务的并且能自动接收消息收条的会话, 在非事务 Session 中, 消息传递的方式有三种 : Session.AUTO_ACKNOWLEDGE : 当客户机调用的 receive 方法成功返回, 或当 MessageListenser 成功处理了消息,session 将会自动接收消息的收条 Session.CLIENT_ACKNOWLEDGE : 客户机通过调用消息的 acknowledge 方法来接收消息 接收发生在 session 层 接收到一个被消费的消息时, 将自动接收该 session 已经消费的所有消息 例如 : 如果消息的消费者消费了 10 条消息, 然后接收 15 个被传递的消息, 则前面的 10 个消息的收据都会在这 15 个消息中被接收 Session.DUPS_ACKNOWLEDGE : 指示 session 缓慢接收消息 (5) 查找目的地 (Topic/ Queue); 例子对应代码 :queue = (Queue) ctx.lookup("queue/foshanshop"); (6) 根据会话以及目的地来建立消息制造者 (TopicPublisher/QueueSender) 和消费者 (TopicSubscriber/ QueueReceiver). 例子对应代码 : TextMessage msg = sess.createtextmessage(" 佛山人您好, 这是我的第一个消息驱动 Bean"); sender = sess.createsender(queue); sender.send(msg); 下面是消息驱动 Bean 发布及 JSP 发送消息后的控制台输出

64 本例子的 EJB 源代码在 MessageDrivenBean 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 MessageDrivenBean 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 第六章实体 Bean(Entity Bean) 现在 EJB3 实体 Bean 是纯粹的 POJO, 可以像开发一般的 java bean 一样编程, 只需做少量的注释来定义实体关系 及 O/R 映射等 6.1 实体 Bean 的组成文件 persistence.xml 配置 一个实体 Bean 由实体类和 persistence.xml 文件组成 persistence.xml 文件在 Jar 文件的 META-INF 目录 persistence.xml 文件指定实体 Bean 使用的数据源及 EntityManager 对象的默认行为 persistence.xml 文件的配置说明如下 : <persistence> <persistence-unit name="foshanshop"> <jta-data-source>java:/defaultmysqlds</jta-data-source> <properties> <property name="hibernate.hbm2ddl.auto" value="create-drop"/> </properties> </persistence-unit> </persistence> persistence-unit 节点可以有一个或多个, 每个 persistence-unit 节点定义了持久化内容名称 使用的数据源名称及 Hibernate 属性 name 属性用作设置持久化名称 jta-data-source 节点用作指定实体 Bean 使用的数据源名称 ( 如何配置数据源请参考下节 Jboss 数据源的配置 ), 指定数据源名称时 java:/ 前缀不能缺少, 数据源名称大小写敏感 properties 节点用作指定 Hibernate 的各项属性, 如果 hibernate.hbm2ddl.auto 的值设为 create-drop, 在实体 Bean 发布及卸载时将自动创建及删除相应数据库表 ( 注意 :Jboss 服务器启动或关闭时会引发实体 Bean 的发布及卸载 )

65 Properties 节点的可用属性及默认值你可以在 [Jboss 安装目录 ] \server\all\deploy\ejb3.deployer\meta-inf/persistence.properties 文件中看见. 小提示 : 如果你的表已经存在, 并且想保留数据, 发布实体 bean 时可以把 hibernate.hbm2ddl.auto 的值设为 none 或 update, 以后为了实体 bean 的改动能反应到数据表, 建议使用 update, 这样实体 Bean 添加一个属性时能同时在数 据表增加相应字段 6.2 JBoss 数据源的配置 Jboss 有一个默认的数据源 DefaultDS, 他使用 Jboss 内置的 HSQLDB 数据库 实际应用中你可能使用不同的数据库, 如 MySql MsSqlServer Oracle 等 各种数据库的数据源配置模版你可以在 [Jboss 安装目录 ]\docs\examples\jca 目录中找到, 默认名称为 : 数据库名 + -ds.xml 不管你使用那种数据库都需要把他的驱动类 Jar 包放置在 [Jboss 安装目录 ]\server\all\lib 目录下, 放置后需要启动 Jboss 服务器 本教程使用的数据库是 mysql 和 Ms Sql Server2000, 使用驱动 Jar 包如下 : Mysql :mysql-connector-java bin.jar Ms Sql Server2000 :msbase.jar, mssqlserver.jar, msutil.jar 上面的 Jar 文件你可以在网上下载或在例子源码的 lib 文件夹下得到 ( 例子源码下载地址 : 下面介绍 Mysql 和 Ms Sql Server2000 的数据源配置, 数据源配置文件的取名格式必须为 xxx ds.xml, 如 : mysql-ds.xml,mssqlserver-ds.xml,oracle-ds.xml 数据源文件配置好后需要放置在 [jboss 安装目录 ]/server/config-name/deploy 目录下, 本教程采用的配置名为 :all, 所以路径为 [jboss 安装目录 ]/server/all/deploy 目录 MySql 数据源的配置 下面定义一个名为 DefaultMySqlDS 的 Mysql 数据源, 连接数据库为 foshanshop, 数据库登录用户名为 root, 密码为 , 数据库驱动类为 org.gjt.mm.mysql.driver 大家只需修改数据库名及登录用户名密码就可以直接使用 mysql-ds.xml <?xml version="1.0" encoding="utf-8"?> <datasources> <local-tx-datasource> <jndi-name>defaultmysqlds</jndi-name> <connection-url>jdbc:mysql://localhost:3306/foshanshop?useunicode=true&characterencoding=gbk </connection-url> <driver-class>org.gjt.mm.mysql.driver</driver-class> <user-name>root</user-name> <password>123456</password> <exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.mysqlexceptionsorter </exception-sorter-class-name> <metadata> <type-mapping>mysql</type-mapping> </metadata>

66 </local-tx-datasource> </datasources> Ms Sql Server2000 数据源的配置 下面定义一个名为 MSSQLDS 的 Ms Sql Server 数据源, 连接数据库为 foshanshop, 数据库登录用户名为 sa, 密码为 , 数据库驱动类为 com.microsoft.jdbc.sqlserver.sqlserverdriver 大家只需修改数据库名及登录用户名密码就可以直接使用 mssqlserver-ds.xml <?xml version="1.0" encoding="utf-8"?> <datasources> <local-tx-datasource> <jndi-name>mssqlds</jndi-name> <connection-url>jdbc:microsoft:sqlserver:// localhost:1433;databasename=foshanshop </connection-url> <driver-class>com.microsoft.jdbc.sqlserver.sqlserverdriver</driver-class> <user-name>sa</user-name> <password>123456</password> <metadata> <type-mapping>ms SQLSERVER2000</type-mapping> </metadata> </local-tx-datasource> </datasources> 6.3 实体 Bean 发布前的准备工作 1. 配置数据源并放置在 [jboss 安装目录 ]/server/all/deploy 目录, 把数据库驱动 Jar 包放置在 [Jboss 安装目录 ]\server\all\lib 目录下, 放置后需要重启 Jboss 服务器 如果数据源已经存在就不需要配置 2. 配置 persistence.xml 文件, 在文件中指定使用的源据源及各项参数 3. 把实体类和 persistence.xml 文件打成 Jar,persistence.xml 放在 jar 文件的 META-INF 目录 6.4 单表映射的实体 Bean 开发前先介绍需要映射的数据库表 person 字段名称 字段类型属性 描述 personid ( 主键 ) Int(11) not null 人员 ID PersonName Varchar(32) not null 姓名 sex Tinyint(1) not null 性别 age Smallint(6) not null 年龄 birthday datetime null 出生日期

67 建立与 Person 表进行映射的实体 Bean Person.java package com.foshanshop.ejb3.bean; import java.io.serializable; import java.util.date; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; @Table(name = "Person") public class Person implements Serializable{ private Integer personid; private String name; private boolean sex; private Short age; private public Integer getpersonid() { return personid; public void setpersonid(integer personid) { this.personid = = "PersonName",nullable=false,length=32) public String getname() { return name; public void setname(string name) { this.name = public boolean getsex() { return sex;

68 public void setsex(boolean sex) { this.sex = public Short getage() { return age; public void setage(short age) { this.age = age; public Date getbirthday() { return birthday; public void setbirthday(date birthday) { this.birthday = birthday; 通过 Person 类可以看到开发实体 Bean 非常简单, 就像开发一般的 java bean 注释指明这是一个实体 Bean, 每个实体 Bean 类映射数据库中的一个表,@Table 注释的 name 属性指定映射的数据表名称,Person 类映射的数据表为 Person 实体 Bean 的每个实例代表数据表中的一行数据, 注释定义了映射到列的所有属性, 如列名是否唯一, 是否允许为空, 是否允许更新等, 他的属性介绍如下 : name: 映射的列名 如 : 映射 Person 表的 PersonName 列, 可以在 name 属性的 getname = "PersonName"), 如果不指定映射列名, 容器将属性名称作为默认的映射列名 unique: 是否唯一 nullable: 是否允许为空 length: 对于字符型列,length 属性指定列的最大字符长度 insertable: 是否允许插入 updatable: 是否允许更新 columndefinition: 定义建表时创建此列的 DDL secondarytable: 从表名 如果此列不建在主表上 ( 默认建在主表 ), 注释指定 personid 属性为表的主键, 它可以有多种生成方式 : TABLE: 容器指定用底层的数据表确保唯一 SEQUENCE: 使用数据库的 SEQUENCE 列来保证唯一 IDENTITY: 使用数据库的 INDENTIT 列来保证唯一 AUTO: 由容器挑选一个合适的方式来保证唯一 NONE: 容器不负责主键的生成, 注释定义了标识字段的生成方式, 本例 personid 的值由 MySQL 数据库自动生成 实体 bean 需要在网络上传送时必须实现 Serializable 接口, 否则将引发 java.io.invalidclassexception 例外

69 为了使用上面的实体 Bean, 我们定义一个 Session Bean 作为他的使用者 下面是 Session Bean 的业务接口, 他定义了五个业务方法 insertperson,updateperson,getpersonbyid,getpersonlist 和 getpersonnamebyid,,insertperson 用作添加一个 Person,updatePerson 更新 Person,getPersonByID 根据 personid 获取 Person,getPersonList 结果分页获取,getPersonNameByID 根据 personid 获取人员的姓名 PersonDAO.java //author:lihuoming package com.foshanshop.ejb3; import java.util.date; import java.util.list; import com.foshanshop.ejb3.bean.person; public interface PersonDAO { public boolean insertperson(string name, boolean sex,short age, Date birthday); public String getpersonnamebyid(int personid); public boolean updateperson(person person); public Person getpersonbyid(int personid); public List getpersonlist(int max,int whichpage); 下面是 Session Bean 的实现 PersonDAOBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import java.util.date; import java.util.list; import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import javax.persistence.query; import com.foshanshop.ejb3.persondao; ({PersonDAO.class) public class PersonDAOBean implements PersonDAO protected EntityManager em; public String getpersonnamebyid(int personid) { Person person = em.find(person.class, Integer.valueOf(personid)); return person.getname();

70 public boolean insertperson(string name, boolean sex,short age, Date birthday) { try { Person person = new Person(); person.setname(name); person.setsex(sex); person.setage(short.valueof(age)); person.setbirthday(birthday); em.persist(person); catch (Exception e) { e.printstacktrace(); return false; return true; public Person getpersonbyid(int personid) { return em.find(person.class, Integer.valueOf(personid)); public boolean updateperson(person person) { try { em.merge(person); catch (Exception e) { e.printstacktrace(); return false; return true; public List getpersonlist(int max,int whichpage) { try { int index = (whichpage-1) * max; Query query = em.createquery("from Person p order by personid asc"); List list = query.setmaxresults(max). setfirstresult(index). getresultlist(); em.clear();// 分离内存中受 EntityManager 管理的实体 bean, 让 VM 进行垃圾回收 return list; catch (Exception e) { e.printstacktrace(); return null;

71 上面我们使用到了一个对象 :EntityManager em,entitymanager 是由 EJB 容器自动地管理和配置的, 不需要用户自己创建, 他用作操作实体 Bean 关于他的更多介绍请参考持久化实体管理器 EntityManager 上面 em.find() 方法用作查询主键 ID 为 personid 的记录 em.persist() 方法用作向数据库插入一条记录 大家可能感觉奇怪, 在类中并没有看到对 EntityManager em 进行赋值, 后面却可以直接使用他 这是因为在实体 Bean 加载时, 注释动态注入 EntityManager 对象 如果 persistence.xml 文件中配置了多个不同的持久化内容 你需要指定持久化名称注入 EntityManager 对象, 注释的 unitname 属性进行指定, 例 EntityManager em; 如果只有一个持久化内容配置, 不需要明确指定 下面是 persistence.xml 文件的配置 : <persistence> <persistence-unit name="foshanshop"> <jta-data-source>java:/defaultmysqlds</jta-data-source> <properties> <property name="hibernate.hbm2ddl.auto" value="create-drop"/> </properties> </persistence-unit> </persistence> 到目前为此, 实体 bean 应用已经开发完成 我们按照上节 实体 Bean 发布前的准备工作 介绍的步骤把他打成 Jar 文件并发布到 Jboss 中 在发布前请检查 persistence.xml 文件中使用的数据源是否配置 ( 如何配置数据源请参考 Jboss 数据源的配置 ), 数据库驱动 Jar 文件是否放进了 [Jboss 安装目录 ]\server\all\lib 目录下 ( 放进后需要重启 Jboss) 因为在 persistence.xml 文件中指定的 Hibernate 属性是 <property name="hibernate.hbm2ddl.auto" value="create-drop"/>, 该属性值指定在实体 Bean 发布及卸载时将自动创建及删除表 当实体 bean 发布成功后, 我们可以查看数据库中是否生成了 Person 表 生成的表如下图 :

72 下面是 JSP 客户端代码 : EntityBeanTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.persondao, com.foshanshop.ejb3.bean.person, javax.naming.*, java.util.properties, java.util.date, java.util.list, java.util.iterator, java.text.simpledateformat"%> <% 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 { PersonDAO persondao = (PersonDAO) ctx.lookup("persondaobean/remote"); SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd"); persondao.insertperson(" 黎活明 ", true, (short)26,formatter.parse(" "));// 添加一个人 out.println(persondao.getpersonnamebyid(1)); // 取 personid 为 1 的人姓名 经脱离容器的管理 Person person = persondao.getpersonbyid(1); // 取 personid 为 1 的 person, 此时的 person 已 person.setname(" 张小艳 "); // 把姓名改为张小艳

73 persondao.updateperson(person); // 更新 person out.println("<br> personid 为 1 的 person 姓名已由黎活明改为张小艳 "); out.println("<br>============ 分页显示, 每页记录数为 2 =========<BR>"); String index = request.getparameter("index"); if (index==null "".equals(index.trim())) index = "1"; int max = 2; // 每页记录数为 2 int whichpage = Integer.parseInt(index); // 第几页 List list = persondao.getpersonlist(max, whichpage); if (list!=null){ Iterator it = list.iterator(); while (it.hasnext()) { Person p = (Person)it.next(); out.println(" 人员编号 :"+ p.getpersonid() + " 姓名 :"+ p.getname() + "<Br>"); catch (Exception e) { out.println(e.getmessage()); %> 上面代码往数据库添加一个人, 然后取 personid 为 1 的人员姓名 本例子的 EJB 源代码在 EntityBean 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 EntityBean 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 本例子使用的数据库名为 foshanshop, 他的 DDL 为 : create database `foshanshop` DEFAULT CHARSET=gbk 在创建数据库时一定得指定 Mysql 的字符集编码为 GBK, 否则在插入中文字符时会报 : Data too long for column, 如果你不想每次创建数据库时指定编码, 可以修改 Mysql 默认的字符集编码, 方法是 : 在 Mysql 安装目录下找到 my.ini 文件, 打开文件找到 default-character-set ( 共两处 ), 把值设为 GBK, 设置完后需重启 Mysql 服务, 可以在服务管理器中重启或在 dos 窗口下输入 :service mysql restart 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 6.5 持久化实体管理器 EntityManager EntityManager 是用来对实体 Bean 进行操作的辅助类 他可以用来产生 / 删除持久化的实体 Bean, 通过主键查找实体 bean, 也可以通过 EJB3 QL 语言查找满足条件的实体 Bean 实体 Bean 被 EntityManager 管理时,EntityManager 跟踪他的状态改变, 在任何决定更新实体 Bean 的时候便会把发生改变的值同步到数据库中 当实体 Bean 从 EntityManager 分离后, 他是不受管理的,EntityManager 无法跟踪他的任何状态改变 EntityManager 的获取前面

74 已经介绍过, 注释由 EJB 容器动态注入, 例 EntityManager em; 下面介绍 EntityManager 常用的 API Entity 获取 find() 或 getreference() 如果知道 Entity 的唯一标示符, 我们可以用 find() 或 getreference() 方法来获得 protected EntityManager em; Person person = em.find(person.class,1); /* try { Person person = em.getreference (Person.class, 1); catch (EntityNotFoundException notfound) { // 找不到记录... */ 当在数据库中没有找到记录时,getReference() 和 find() 是有区别的,find() 方法会返回 null, 而 getreference() 方法会抛出 javax.persistence.entitynotfoundexception 例外, 另外 getreference() 方法不保证实体 Bean 已被初始化 如果传递进 getreference() 或 find() 方法的参数不是实体 Bean, 都会引发 IllegalArgumentException 例外 添加 persist() 保存 Entity protected EntityManager em; Person person = new Person(); person.setname(name); // 把数据保存进数据库中 em.persist(person); 如果传递进 persist() 方法的参数不是实体 Bean, 会引发 IllegalArgumentException 例外 更新实体 当实体正在被容器管理时, 你可以调用实体的 set 方法对数据进行修改, 在容器决定 flush 时, 更新的数据才会同步到数据库 如果你希望修改后的数据实时同步到数据库, 你可以执行 EntityManager.flush() protected EntityManager em;

75 public void updateperson() { try { Person person = em.find(person.class, 1); person.setname("lihuoming"); // 方法执行完后即可更新数据 catch (Exception e) { e.printstacktrace(); 合并 Merge() merge () 方法是在实体 Bean 已经脱离了 EntityManager 的管理时使用, 当容器决定 flush 时, protected EntityManager em; public Person getpersonbyid(int personid) { return em.find(person.class, personid); public boolean updateperson(person person) { try { em.merge(person); catch (Exception e) { e.printstacktrace(); return false; return true; 下面的代码把实体 Bean 返回到了客户端, 这时的实体 Bean 已经脱离了容器的管理, 在客户端对实体 Bean 进行修改, 最后把他返回给 EJB 容器进行更新操作 客户端调用代码如下 : PersonDAO persondao = (PersonDAO) ctx.lookup("persondaobean/remote"); Person person = persondao.getpersonbyid(1); // 取 personid 为 1 的 person, 此时的 person 已经脱离容器的管理 person.setname(" 张小艳 "); persondao.updateperson(person); 执行 em.merge(person) 方法时, 容器的工作规则 : 1. 如果此时容器中已经存在一个受容器管理的具有相同 ID 的 person 实例, 容器将会把参数 person 的内容拷贝进这个受管理的实例,merge() 方法返回受管理的实例, 但参数 person 仍然是分离的不受管理的 容器在决定 Flush 时把实例同步到数据库中 2. 容器中不存在具有相同 ID 的 person 实例 容器根据传进的 person 参数 Copy 出一个受容器管理的 person 实例, 同时 merge() 方法会返回出这个受管理的实例, 但参数 person 仍然是分离的不受管理的 容器在决定 Flush 时把实例同步到数据库中 如果传递进 merge () 方法的参数不是实体 Bean, 会引发一个 IllegalArgumentException 例外

76 6.5.5 删除 Remove() 把 Entity protected EntityManager em; Person person = em.find(person.class, 2); // 如果级联关系 cascade=cascadetype.all, 在删除 person 时候, 也会把级联对象删除 把 cascade 属性设为 cascade=cascadetype.remove 有同样的效果 em.remove (person); 如果传递进 remove () 方法的参数不是实体 Bean, 会引发一个 IllegalArgumentException 例外 执行 EJB3 QL 操作 createquery() 除了使用 find() 或 getreference() 方法来获得 Entity Bean 之外, 你还可以通过 EJB3 QL 得到实体 Bean 要执行 EJB3 QL 语句, 你必须通过 EntityManager 的 createquery() 或 createnamedquery() 方法创建一个 Query protected EntityManager em; Query query = em.createquery("select p from Person p where p. name= 黎明 "); List result = query.getresultlist(); Iterator iterator = result.iterator(); while( iterator.hasnext() ){ // 处理 Person // 执行更新语句 Query query = em.createquery("update Person as p set p.name =?1 where p. personid=?2"); query.setparameter(1, 黎明 ); query.setparameter(2, new Integer(1) ); int result = query.executeupdate(); // 影响的记录数 // 执行更新语句 Query query = em.createquery("delete from Person"); int result = query.executeupdate(); // 影响的记录数 执行 SQL 操作 createnativequery() 注意这里操作的是 SQL 语句, 并非 EJB3 QL, protected EntityManager em;

77 返回. // 我们可以让 EJB3 Persistence 运行环境将列值直接填充入一个 Entity 的实例, 并将实例作为结果 Query query = em.createnativequery("select * from person", Person.class); List result = query.getresultlist(); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ Person person= (Person)iterator.next();.. // 直接通过 SQL 执行更新语句 Query query = em.createnativequery("update person set age=age+2"); query.executeupdate(); 刷新实体 refresh() 如果你怀疑当前被管理的实体已经不是数据库中最新的数据, 你可以通过 refresh() 方法刷新实体, 容器会把数据库中的新值重写进实体 这种情况一般发生在你获取了实体之后, 有人更新了数据库中的记录, 这时你需要得到最新的数据 当然你再次调用 find() 或 getreference() 方法也可以得到最新数据, protected EntityManager em; Person person = em.find(person.class, 2); // 如果此时 person 对应的记录在数据库中已经发生了改变, 可以通过 refresh() 方法得到最新数据 em.refresh (person); 如果传递进 refresh () 方法的参数不是实体 Bean, 会引发一个 IllegalArgumentException 例外 检测实体当前是否被管理中 contains() contains() 方法使用一个实体作为参数, 如果这个实体对象当前正被持久化内容管理, 返回值为 true, 否则为 false 如果传递的参数不是实体 Bean, 将会引发一个 IllegalArgumentException protected EntityManager em; Person person = em.find(person.class, 2); if (em.contains(person)){ // 正在被持久化内容管理 else{ // 已经不受持久化内容管理

78 分离所有当前正在被管理的实体 clear() 在处理大量实体的时候, 如果你不把已经处理过的实体从 EntityManager 中分离出来, 将会消耗你大量的内存 调用 EntityManager 的 clear() 方法后, 所有正在被管理的实体将会从持久化内容中分离出来 有一点需要说明下, 在事务没有提交前 ( 事务默认在调用堆栈的最后提交, 如 : 方法的返回 ), 如果调用 clear() 方法, 之前对实体所作的任何改变将会掉失, 所以建议你在调用 clear() 方法之前先调用 flush() 方法保存更改 将实体的改变立刻刷新到数据库中 flush() 当实体管理器对象在一个 session bean 中使用时, 它是和服务器的事务上下文绑定的 实体管理器在服务器的事务提交时提交并且同步它的内容 在一个 session bean 中, 服务器的事务默认地会在调用堆栈的最后提交 ( 如 : 方法的返回 protected EntityManager em; public void updateperson(person person) { try { Person person = em.find(person.class, 2); person.setname("lihuoming"); em.merge(person); // 后面还有众多修改操作 catch (Exception e) { e.printstacktrace(); // 更新将会在这个方法的末尾被提交和刷新到数据库中 为了只在当事务提交时才将改变更新到数据库中, 容器将所有数据库操作集中到一个批处理中, 这样就减少了代价昂贵的与数据库的交互 当你调用 persist( ), merge( ) 或 remove( ) 这些方法时, 更新并不会立刻同步到数据库中, 直到容器决定刷新到数据库中时才会执行, 默认情况下, 容器决定刷新是在 相关查询 执行前或事务提交时发生, 当然 相关查询 除 find() 和 getreference() 之外, 这两个方法是不会引起容器触发刷新动作的, 默认的刷新模式是可以改变的, 具体请考参下节 如果你需要在事务提交之前将更新刷新到数据库中, 你可以直接地调用 EntityManager.flush() 方法 这种情况下, protected EntityManager em; public void updateperson(person person) { try {

79 Person person = em.find(person.class, 2); person.setname("lihuoming"); em.merge(person); em.flush();// 手动将更新立刻刷新进数据库 // 后面还有众多修改操作 catch (Exception e) { e.printstacktrace(); 改变实体管理器的 Flush 模式 setflushmode() 我们对 Flush 模式进行修改需要使用到 javax.persistence.flushmodetype, 他的定义如下 : public enum FlushModeType { AUTO, COMMIT 默认情况下, 实体管理器的 Flush 模式为 AUTO, 你可以改变他的值, 如下 : entitymanager.setflushmode(flushmodetype.commit); 下面说说这两者的区别及使用场合 : FlushModeType.AUTO: 刷新在查询语句执行前 ( 除了 find() 和 getreference() 查询 ) 或事务提交时才发生, 使用场合 : 在大量更新数据的过程中没有任何查询语句 ( 除了 find() 和 getreference() 查询 ) 的执行 FlushModeType.COMMIT: 刷新只有在事务提交时才发生, 使用场合 : 在大量更新数据的过程中存在查询语句 ( 除了 find() 和 getreference() 查询 ) 的执行 其实上面两种模式最终反映的结果是 :JDBC 驱动跟数据库交互的次数 JDBC 性能最大的增进是减少 JDBC 驱动 与数据库之间的网络通讯 FlushModeType.COMMIT 模式使更新只在一次的网络交互中完成, 而 FlushModeType.AUTO 模式可能需要多次交互 ( 触发了多少次 Flush 就产生了多少次网络交互 ) 获取持久化实现者的引用 getdelegate( ) 用过 getdelegate( ) 方法, 你可以获取 EntityManager 持久化实现者的引用, 如 Jboss EJB3 的持久化产品采用 Hibernate, 可以通过 getdelegate( ) 方法获取对他的访问, 如 protected EntityManager em; HibernateEntityManager manager = (HibernateEntityManager)em.getDelegate(); 获得对 Hibernate 的引用后, 可以直接面对 Hibernate 进行编码, 不过这种方法并不可取, 强烈建议不要使用 在 Weblogic 中, 你也可以通过此方法获取对 Kodo 的访问

80 6.6 关系 / 对象映射 映射的表名或列名与数据库保留字同名时的处理 如果应用采用的数据库是 Mysql, 当映射的表名或列名与数据库保留字同名时, 持久化引掣转绎后的 SQL 在执行时将会出错 = "Order") public class Order implements Serializable { 表名 Order 与排序保留字 Order 相同, 导致 SQL 语法出错 针对上面的情况, 作者在 Jboss 持久化产品文档中没有找到相关的解决方案 在此作者采用了一种变通的方法来解决此问题 该方法针对具体数据库, 不利于数据库移植 建议大家在不得已的情况下使用 可以用 `` 字符把 Order 括起来 = "`Order`") public class Order implements Serializable { 列名与保留字同名的处理方法如上, 如列名为 = "`group`") public String getgroup() { return group; 如果数据库是 Sqlserver 可以用 [] 把表名或列名括起来 Sqlserver 不加 [] 也能执行成功, 建议在出错的情况下使用 一对多及多对一映射 现实应用中存在很多一对多的情况, 如一项订单中存在一个或多个订购项 下面就以订单为例介绍存在一对多及 多对一双向关系的实体 bean 开发 需要映射的数据库表 orders 字段名称 字段类型属性 描述 orderid Int 订单号 amount float 订单金额 createdate datetime 订单创建日期 orderitems 字段名称 字段类型属性 描述 id Int 订单项 ID productname Varchar(255) 订购产品名称 price float 产品价格 order_id Int 订单号

81 双向一对多关系, 一是关系维护端 (owner side), 多是关系被维护端 (inverse side) 在关系被维护端建立外键列指向关系维护端的主键列 Order.java //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import java.util.hashset; import java.util.date; import java.util.set; import javax.persistence.cascadetype; import javax.persistence.entity; import javax.persistence.fetchtype; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.onetomany; import javax.persistence.orderby; @Table(name = "Orders") public class Order implements Serializable { private Integer orderid; private Float amount; private Set<OrderItem> orderitems = new HashSet<OrderItem>(); private public Integer getorderid() { return orderid; public void setorderid(integer orderid) { this.orderid = orderid; public Float getamount() { return amount; public void setamount(float amount) { this.amount = = CascadeType.ALL, fetch = = "id ASC")

82 public Set<OrderItem> getorderitems() { return orderitems; public void setorderitems(set<orderitem> orderitems) { this.orderitems = orderitems; public Date getcreatedate() { return createdate; public void setcreatedate(date createdate) { this.createdate = createdate; public void addorderitem(orderitem orderitem) { if (!this.orderitems.contains(orderitem)) { this.orderitems.add(orderitem); orderitem.setorder(this); public void removeorderitem(orderitem orderitem) { orderitem.setorder(null); this.orderitems.remove(orderitem); 上面声明一个 Set 变量 orderitems 用来存放多个 OrderItem 对象, = CascadeType.ALL, fetch = FetchType.LAZY) 指明 Order 与 OrderItem 关联关系为一对多关系, 注释的属性介绍 : 1>targetEntity Class 类型的属性 定义关系类的类型, 默认是该成员属性对应的类类型, 所以通常不需要提供定义 2>mappedBy String 类型的属性 定义类之间的双向关系 如果类之间是单向关系, 不需要提供定义, 如果类和类之间形成双向关系, 我们就需要使用这个属性进行定义, 否则可能引起数据一致性的问题 3>cascade CascadeType[] 类型 该属性定义类和类之间的级联关系 定义的级联关系将被容器视为对当前类对象及其关联类对象采取相同的操作, 而且这种关系是递归调用的 举个例子 :Order 和 OrderItem 有级联关系, 那么删除 Order 时将同时删除它所对应的 OrderItem 对象 而如果 OrderItem 还和其他的对象之间有级联关系, 那么这样的操作会一直递归执行下去 cascade 的值只能从 CascadeType.PERSIST( 级联新建 ) CascadeType.REMOVE( 级联删除 ) CascadeType.REFRESH

83 ( 级联刷新 ) CascadeType.MERGE( 级联更新 ) 中选择一个或多个 还有一个选择是使用 CascadeType.ALL, 表 示选择全部四项 4>fatch FetchType 类型的属性 可选择项包括 :FetchType.EAGER 和 FetchType.LAZY 前者表示关系类 ( 本例是 OrderItem 类 ) 在主类 ( 本例是 Order 类 ) 加载的时候同时加载, 后者表示关系类在被访问时才加载 默认值是 FetchType. = "id ASC") 注释指明加载 OrderItem 时按 id 的升序排序 addorderitem 和 removeorderitem 方法用来添加 / 删除订单项 OrderItem.java //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.cascadetype; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.joincolumn; import javax.persistence.manytoone; @Table(name = "OrderItems") public class OrderItem implements Serializable { private Integer id; private String productname; private Float price; private Order order; public OrderItem() { public OrderItem(String productname, Float price) { this.productname = productname; this.price public Integer getid() { return id;

84 public void setid(integer id) { this.id = id; public String getproductname() { return productname; public void setproductname(string productname) { this.productname = productname; public Float getprice() { return price; public void setprice(float price) { this.price = "order_id") public Order getorder() { return order; public void setorder(order order) { this.order = order; 指明 OrderItem 和 Order 之间为多对一关系, 多个 OrderItem 实例关联的都是同一个 Order 注释有四个属性 :targetentity cascade fetch 和 optional, 注释的同名属性相同, 注释的 fetch 属性默认值是 FetchType.EAGER optional 属性是定义该关联类对是否必须存在, 值为 false 时, 关联类双方都必须存在, 如果关系被维护端不存在, 查询的结果为 null 值为 true 时, 关系被维护端可以不存在, 查询的结果仍然会返回关系维护端, 在关系维护端中指向关系被维护端的属性为 null optional 属性的默认值是 true 举个例: 某项订单 (Order) 中没有订单项 (OrderItem), 如果 optional 属性设置为 false, 获取该项订单 (Order) 时, 得到的结果为 null, 如果 optional 属性设置为 true, 仍然可以获取该项订单, 但订单中指向订单项的属性为 null 实际上在解释 Order 与 OrderItem 的关系成 SQL 时,optional 属性指定了他们的联接关系 optional=false 联接关系为 inner join, optional=true 联接关系为 left = "order_id") 注释指定 OrderItem 映射表的 order_id 列作为外键与 Order 映射表的主键列关联 为了使用上面的实体 Bean, 我们定义一个 Session Bean 作为他的使用者 下面是 Session Bean 的业务接口, 他定义了三个业务方法 insertorder,getorderbyid 和 getallorder, 三个方法的业务功能是 : insertorder 添加一个订单 ( 带两个订单项 ) 进数据库 getorderbyid 获取指定订单号的订单

85 getallorder 获取所有订单下面是 Session Bean 的业务接口及实现类 OrderDAO.java //author:lihuoming package com.foshanshop.ejb3; import java.util.list; import com.foshanshop.ejb3.bean.order; public interface OrderDAO { public void insertorder(); public Order getorderbyid(integer orderid); public List getallorder(); OrderDAOBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import java.util.date; import java.util.list; import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import javax.persistence.query; import com.foshanshop.ejb3.orderdao; import com.foshanshop.ejb3.bean.order; ({OrderDAO.class) public class OrderDAOBean implements OrderDAO protected EntityManager em; public void insertorder(){ Order order = new Order(); order.setcreatedate(new Date()); order.addorderitem(new OrderItem(" 笔记本电脑 ", new Float( ))); order.addorderitem(new OrderItem("U 盘 ", new Float(620))); order.setamount(new Float( )); em.persist(order); public Order getorderbyid(integer orderid) { Order order = em.find(order.class, orderid);

86 order.getorderitems().size(); // 因为是延迟加载, 通过执行 size() 这种方式获取订单下的所有订单项 return order; public List getallorder() { Query query = em.createquery("select o from Order o inner join fetch o.orderitems order by o.orderid"); List result = query.getresultlist(); return result; 上面有一点需要强调 : 当业务方法需要把一个实体 Bean 作为参数返回给客户端时, 除了实体 Bean 本身需要实现 Serializable 接口之外, 如果关联类 (OrderItem) 是延迟加载, 还需在返回实体 Bean 之前通过访问关联类的方式加载关联类 否则在客户端访问关联类时将会抛出加载例外 另外不管是否延迟加载, 通过 join fetch 关联语句都可显式加载关联类, 如业务方法 getallorder 下面是 Session Bean 的 JSP 客户端代码 : OneToManyTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.orderdao, com.foshanshop.ejb3.bean.*, javax.naming.*, java.util.*"%> <% 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 { OrderDAO orderdao = (OrderDAO) ctx.lookup("orderdaobean/remote"); orderdao.insertorder(); /* Order order = orderdao.getorderbyid(new Integer(1)); out.println(" 订单总费用 :"+ order.getamount() +"<br>============== 订单项 =================<br>"); if (order!=null){ Iterator iterator = order.getorderitems().iterator(); while (iterator.hasnext()){ OrderItem SubOrder = (OrderItem) iterator.next(); out.println(" 订购产品 :"+ SubOrder.getProductname() +"<br>");

87 else{ out.println(" 没有找到相关订单 "); */ List list = orderdao.getallorder(); if (list!=null){ Integer orderid = null; for(int i=0; i<list.size();i++){ Order od = (Order) list.get(i); if (od!=null){ if (!od.getorderid().equals(orderid)){ orderid = od.getorderid(); out.println("============== 订单号 :"+ od.getorderid() +"=================<br>"); Iterator iterator = od.getorderitems().iterator(); while (iterator.hasnext()){ OrderItem SubOrder = (OrderItem) iterator.next(); out.println(" 订购产品 :"+ SubOrder.getProductname() +"<br>"); else{ out.println(" 获取不到订单列表 "); catch (Exception e) { out.println(e.getmessage()); %> 本例子的 EJB 源代码在 OneToMany 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 OneToMany 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 一对一映射 一个人 (Person) 只有唯一的身份证号 (IDCard),Person 与 IDCard 是一对一关系 下面就以他们为例介绍存在一对一关系的实体 Bean 开发过程需要映射的数据库表 person

88 字段名称 字段类型属性 描述 personid ( 主键 ) Int(11) not null 人员 ID PersonName Varchar(32) not null 姓名 sex Tinyint(1) not null 性别 age Smallint(6) not null 年龄 birthday Datetime null 出生日期 idcard 字段名称 字段类型属性 描述 id ( 主键 ) Int(11) not null 流水号 cardno Varchar(18) not null 身份证号 Person_ID Int(11) not null 作为外键指向 person 表的 personid 一对一关系需要在关系维护端 (owner side) 注释中定义 mappedby 属性 在关系被维护端 (inverse side) 建立外键列指向关系维护端的主键列 下面是关系维护端 Person.java 的源代码 : //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import java.util.date; import javax.persistence.cascadetype; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.onetoone; @Table(name = "Person") public class Person implements Serializable{ private Integer personid; private String name; private boolean sex; private Short age; private Date birthday; private public Integer getpersonid() {

89 return personid; public void setpersonid(integer personid) { this.personid = = "PersonName",nullable=false,length=32) public String getname() { return name; public void setname(string name) { this.name = public boolean getsex() { return sex; public void setsex(boolean sex) { this.sex = public Short getage() { return age; public void setage(short age) { this.age = age; public Date getbirthday() { return birthday; public void setbirthday(date birthday) { this.birthday = = true,cascade = CascadeType.ALL, mappedby = "person") public IDCard getidcard() { return idcard; public void setidcard(idcard idcard) { this.idcard = idcard;

90 @OneToOne 注释指明 Person 与 IDCard 注释五个属性 :targetentity cascade fetch optional 和 mappedby, 注释的同名属性一一对应, 请大家参考前面章节中的内容,fetch 属性默认值是 FetchType.EAGER mappedby 注释的同名属性相同 上面的 optional = true 设置 idcard 属性可以为 null, 也就是允讦没有身份证, 未成年人就是没有身份证的 IDCard.java //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.cascadetype; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.joincolumn; import javax.persistence.onetoone; @Table(name = "IDCard") public class IDCard implements Serializable{ private Integer id; private String cardno; private Person person; public IDCard() { public IDCard(String cardno) { this.cardno public Integer getid() { return id; public void setid(integer id) { this.id = id;

91 @Column(nullable=false,length=18,unique = true) public String getcardno() { return cardno; public void setcardno(string cardno) { this.cardno = = false, cascade = = "Person_ID", referencedcolumnname = "personid",unique = true) public Person getperson() { return person; public void setperson(person person) { this.person = 注释指明 IDCard 与 Person 为一对一关系,IDCard 是关系被维护端,optional = false 设置 person 属性值不能为 null, = "Person_ID", referencedcolumnname = "personid",unique = true) 指明 IDCard 对应表的 Person_ID 列作为外键与 Person 对应表的 personid 列进行关联, unique = true 指明 Person_ID 列的值不可重复 为了使用上面的实体 Bean, 我们定义一个 Session Bean 作为他的使用者 下面是 Session Bean 的业务接口, 他定义了四个业务方法 insertperson,getpersonbyid,updatepersoninfo 和 deleteperson, 四个方法的业务功能是 : insertperson 添加一个人员 ( 带一个身份证 ) 进数据库 getpersonbyid 获取指定编号的人员 updatepersoninfo 更新人名及身份证号 deleteperson 删除人员, 连同其身份证一起删除下面是 Session Bean 的业务接口及实现类 OneToOneDAO.java //author:lihuoming package com.foshanshop.ejb3; import java.util.date; import com.foshanshop.ejb3.bean.person; public interface OneToOneDAO { public void insertperson(string name, boolean sex,short age, Date birthday,string cardid); public Person getpersonbyid(integer orderid); public void updatepersoninfo(integer personid, String newname, String newidcard); public void deleteperson(integer personid); OneToOneDAOBean.java package com.foshanshop.ejb3.impl; import java.util.date;

92 import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import com.foshanshop.ejb3.onetoonedao; import com.foshanshop.ejb3.bean.idcard; ({OneToOneDAO.class) public class OneToOneDAOBean implements OneToOneDAO protected EntityManager em; public void insertperson(string name, boolean sex,short age, Date birthday,string cardid) { Person person = new Person(); person.setname(name); person.setsex(sex); person.setage(short.valueof(age)); person.setbirthday(birthday); IDCard idcard = new IDCard(cardID); idcard.setperson(person); person.setidcard(idcard); em.persist(person); public Person getpersonbyid(integer personid) { Person person = em.find(person.class, personid); return person; public void updatepersoninfo(integer personid, String newname, String newidcard) { Person person = em.find(person.class, personid); if (person!=null) { person.setname(newname); if (person.getidcard()!=null){ person.getidcard().setcardno(newidcard); em.merge(person); public void deleteperson(integer personid) {

93 Person person = em.find(person.class, personid); if (person!=null) em.remove(person); 下面是 Session Bean 的 JSP 客户端代码 : OneToOneTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.onetoonedao, com.foshanshop.ejb3.bean.*, javax.naming.*, java.util.date, java.text.simpledateformat, java.util.*"%> <% 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 { String outformate = "<font color=blue>cmd>>out>></font> "; OneToOneDAO onetoonedao = (OneToOneDAO) ctx.lookup("onetoonedaobean/remote"); SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd"); SimpleDateFormat formatter1 = new SimpleDateFormat("MMddhhmmss"); String endno = formatter1.format(new Date()).toString(); onetoonedao.insertperson(" 黎活明 ", true, (short)26,formatter.parse(" "), "44011"+endno); // 添加时请注意, 身份证号不要重复, 因为数据库字段身份证号是唯一的 Person person = onetoonedao.getpersonbyid(new Integer(1)); if (person!=null){ out.println(outformate +" 寻找编号为 1 的人员 <br>"); out.println(" 姓名 :"+ person.getname() +" 身份证 :"+ person.getidcard().getcardno() +"<br>"); else{ out.println(" 没有找到编号为 1 的人员 <br>"); +"<br>"); out.println(outformate +" 更新编号为 1 的人员的姓名为李明, 身份证号为 33012" +endno onetoonedao.updatepersoninfo(new Integer(1), " 李明 ", "33012" +endno);

94 out.println("================ 删除编号为 3 的人员 ==============<br>"); onetoonedao.deleteperson(new Integer(3)); %> catch (Exception e) { out.println(e.getmessage()); 本例子的 EJB 源代码在 OneToOne 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 OneToOne 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 注意 : 在发布本例子 EJB 时, 请御载前面带有 Person 类的例子 ( 如 : EntityBean.jar), 否则会引起类型冲突 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 多对多映射 学生和老师就是多对多的关系 一个学生有多个老师, 一个老师教多个学生 多对多映射采取中间表连接的映射 策略, 建立的中间表将分别引入两边的主键作为外键 EJB3 对于中间表的元数据提供了可配置的方式, 用户可 以自定义中间表的表名, 列名 下面就以学生和老师为例介绍多对多关系的实体 Bean 开发 需要映射的数据库表 student 字段名称 字段类型属性 描述 studentid ( 主键 ) Int(11) not null 学生 ID studentname varchar(32) not null 学生姓名 teacher 字段名称 字段类型属性 描述 teacherid ( 主键 ) Int(11) not null 教师 ID teachername varchar(32) not null 教师姓名 中间表 teacher_student 字段名称 字段类型属性 描述 Student_ID Int(11) not null 是 student 表 studentid 列的外键 Teacher_ID Int(11) not null 是 teacher 表 teacherid 列的外键 Student.java //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import java.util.hashset;

95 import java.util.set; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.manytomany; @Table(name = "Student") public class Student implements Serializable{ private Integer studentid; private String StudentName; private Set<Teacher> teachers = new HashSet<Teacher>(); public Student() { public Student(String studentname) { StudentName public Integer getstudentid() { return studentid; public void setstudentid(integer studentid) { this.studentid = length=32) public String getstudentname() { return StudentName; public void setstudentname(string studentname) { StudentName = = "students") public Set<Teacher> getteachers() { return teachers; public void setteachers(set<teacher> teachers) {

96 this.teachers = 注释表示 Student 是多对多关系的一边,mappedBy 属性定义了 Student 为双向关系的维护端 (owning side) Teacher.java //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import java.util.hashset; import java.util.set; import javax.persistence.cascadetype; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.fetchtype; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.joincolumn; import javax.persistence.jointable; import javax.persistence.manytomany; @Table(name = "Teacher") public class Teacher implements Serializable{ private Integer teacherid; private String TeacherName; private Set<Student> students = new HashSet<Student>(); public Teacher() { public Teacher(String teachername) { TeacherName public Integer getteacherid() { return teacherid; public void setteacherid(integer teacherid) { this.teacherid = teacherid;

97 @Column(nullable=false, length=32) public String getteachername() { return TeacherName; public void setteachername(string teachername) { TeacherName = = CascadeType.PERSIST, fetch = = "Teacher_Student", joincolumns = {@JoinColumn(name = "Teacher_ID", referencedcolumnname = "teacherid"), inversejoincolumns = {@JoinColumn(name = "Student_ID", referencedcolumnname = "studentid")) public Set<Student> getstudents() { return students; public void setstudents(set<student> students) { this.students = students; public void addstudent(student student) { if (!this.students.contains(student)) { this.students.add(student); public void removestudent(student student) { 注释表示 Teacher 描述了多对多关系的数据表关系 name 属性指定中间表名称,joinColumns 定义中间表与 Teacher 表的外键关系 上面的代码中, 中间表 Teacher_Student 的 Teacher_ID 列是 Teacher 表的主键列对应的外键列,inverseJoinColumns 属性定义了中间表与另外一端 (Student) 的外键关系 为了使用上面的实体 Bean, 我们定义一个 Session Bean 作为他的使用者 下面是 Session Bean 的业务接口, 他定义了三个业务方法 insertteacher,getteacherbyid, 和 getstudentbyid, 三个方法的业务功能是 : insertteacher 添加一个教师 ( 带学生 ) 进数据库 getteacherbyid 获取指定编号的教师 getstudentbyid 获取指定编号的学生下面是 Session Bean 的业务接口及实现类 TeacherDAO.java

98 //author:lihuoming package com.foshanshop.ejb3; import com.foshanshop.ejb3.bean.student; import com.foshanshop.ejb3.bean.teacher; public interface TeacherDAO { public void insertteacher(string name, String[] studentnames); public Teacher getteacherbyid(integer teacherid); public Student getstudentbyid(integer studentid); TeacherDAOBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import com.foshanshop.ejb3.teacherdao; import com.foshanshop.ejb3.bean.student; ({TeacherDAO.class) public class TeacherDAOBean implements TeacherDAO protected EntityManager em; public void insertteacher(string name, String[] studentnames) { Teacher teacher = new Teacher(name); if (studentnames!=null){ for(int i=0;i<studentnames.length; i++){ teacher.addstudent(new Student(studentnames[i])); em.persist(teacher); public Teacher getteacherbyid(integer teacherid) { Teacher teacher= em.find(teacher.class, teacherid); if (teacher!=null) teacher.getstudents().size(); return teacher;

99 public Student getstudentbyid(integer studentid) { Student student= em.find(student.class, studentid); if (student!=null) student.getteachers().size(); return student; 下面是 Session Bean 的 JSP 客户端代码 : ManyToManyTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.teacherdao, com.foshanshop.ejb3.bean.*, javax.naming.*, java.util.*"%> <% 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 { TeacherDAO teacherdao = (TeacherDAO) ctx.lookup("teacherdaobean/remote"); teacherdao.insertteacher(" 李老师 ",new String[]{" 张小红 "," 朱小光 "," 龚利 "); Teacher teacher = teacherdao.getteacherbyid(new Integer(1)); if (teacher!=null){ out.println("======= 获取编号为 1 的老师姓名 :"+ teacher.getteachername() +" ======<br>"); Iterator iterator = teacher.getstudents().iterator(); while (iterator.hasnext()){ Student student = (Student) iterator.next(); out.println(" 他的学生 :"+ student.getstudentname() +"<br>"); else{ out.println(" 没有找到编号为 1 的老师 <br>"); Student student = teacherdao.getstudentbyid(new Integer(1)); if (student!=null){ out.println("======= 获取编号为 1 的学生姓名 :"+ student.getstudentname() +" ======<br>"); Iterator iterator = student.getteachers().iterator();

100 while (iterator.hasnext()){ Teacher tc = (Teacher) iterator.next(); out.println(" 他的老师 :"+ tc.getteachername() +"<br>"); else{ out.println(" 没有找到编号为 1 的学生 <br>"); %> catch (Exception e) { out.println(e.getmessage()); 本例子的 EJB 源代码在 ManyToMany 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 ManyToMany 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 6.7 使用参数查询 参数查询也和 SQL 中的参数查询类似 EJB3 QL 支持两种方式的参数定义方式 : 命名参数和位置参数 在同一个 查询中只允许使用一种参数定义方式 命名参数查询 命令参数的格式为 : : + protected EntityManager em; private String NameQuery(){ // 获取指定 personid 的人员 Query query = em.createquery("select p from Person p where p.personid=:id"); query.setparameter("id",new Integer(1)); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** NameQuery 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ Person person= (Person)iterator.next(); out.append(person.getname()+ "<BR>");

101 return out.tostring(); 位置参数查询 位置参数的格式为?+ protected EntityManager em; private String PositionQuery(){ // 获取指定 personid 的人员 Query query = em.createquery("select p from Person p where p.personid=?1"); query.setparameter(1,new Integer(1)); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** PositionQuery 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ Person person= (Person)iterator.next(); out.append(person.getname()+ "<BR>"); return out.tostring(); Date 参数 如果你需要传递 java.util.date 或 java.util.calendar 参数进一个参数查询, 你需要使用一个特殊的 setparameter() 方法, 相关的 setparameter 方法定义如下 : public interface Query { // 命名参数查询时使用, 参数类型为 java.util.date Query setparameter(string name, java.util.date value, TemporalType temporaltype); // 命名参数查询时使用, 参数类型为 java.util.calendar Query setparameter(string name, Calendar value, TemporalType temporaltype); // 位置参数查询时使用, 参数类型为 java.util.date Query setparameter(int position, Date value, TemporalType temporaltype); // 位置参数查询时使用, 参数类型为 java.util.calendar

102 Query setparameter(int position, Calendar value, TemporalType temporaltype); 上面方法用到的 TemporalType 参数定义如下 : package javax.persistence; public enum TemporalType { DATE, //java.sql.date TIME, //java.sql.time TIMESTAMP //java.sql.timestamp 因为一个 Date 或 Calendar 对象能够描述一个真实的日期 时间或时间戳. 所以我们需要告诉 Query 对象怎么使用 这些参数, 我们把 javax.persistence.temporaltype 作为参数传递进 setparameter 方法, 告诉查询接口在转换 java.util.date 或 java.util.calendar 参数到本地 SQL 时使用什么数据库类型 6.8 EJB3 QL 语言 Jboss EJB3.0 采用 Hibernate 的 O/R 映射模型,Hibernate 装备了一种极为有力的查询语言, 看上去很像 SQL 但是别被语法蒙蔽,EJB3 QL 是完全面向对象的, 具备继承 多态和关联等特性 本教程只介绍常用的语法, 要了解更全面的知识请参考 Hibernate 使用手册 本小节把程序的测试框架搭建起来, 方便各位后面学习 EJB3 QL 语句 本例子的实体 Bean 有 Person,Order, OrderItem, 他们之间的关系是 : 一个 Person 有多个 Order, 一个 Order 有多个 OrderItem 下面是各实体 Bean 的代码 : Person.java package com.foshanshop.ejb3.bean; import java.io.serializable; import java.util.date; import java.util.hashset; import java.util.set; import javax.persistence.cascadetype; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.fetchtype; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.onetomany; import javax.persistence.orderby; @Table(name = "Person")

103 public class Person implements Serializable{ private Integer personid; private String name; private boolean sex; private Short age; private Date birthday; private Set<Order> orders = new HashSet<Order>(); public Person(){ public Person(String name, boolean sex, Short age, Date birthday) { this.name = name; this.sex = sex; this.age = age; this.birthday public Integer getpersonid() { return personid; public void setpersonid(integer personid) { this.personid = = "PersonName",nullable=false,length=32) public String getname() { return name; public void setname(string name) { this.name = public boolean getsex() { return sex; public void setsex(boolean sex) { this.sex = public Short getage() { return age;

104 public void setage(short age) { this.age = age; public Date getbirthday() { return birthday; public void setbirthday(date birthday) { this.birthday = = CascadeType.ALL, fetch = = "orderid ASC") public Set<Order> getorders() { return orders; public void setorders(set<order> orders) { this.orders = orders; Order.java package com.foshanshop.ejb3.bean; import java.io.serializable; import java.util.hashset; import java.util.date; import java.util.set; import javax.persistence.cascadetype; import javax.persistence.entity; import javax.persistence.fetchtype; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.joincolumn; import javax.persistence.manytoone; import javax.persistence.onetomany; import javax.persistence.orderby; @Table(name = "Orders") public class Order implements Serializable { private int hashcode = Integer.MIN_VALUE; private Integer orderid;

105 private Float amount; private Person ower; private Set<OrderItem> orderitems = new HashSet<OrderItem>(); private Date createdate; public Order(){ public Order(Float amount, Person ower, Date createdate) { this.amount = amount; this.ower = ower; this.createdate public Integer getorderid() { return orderid; public void setorderid(integer orderid) { this.orderid = orderid; public Float getamount() { return amount; public void setamount(float amount) { this.amount = "person_id") public Person getower() { return ower; public void setower(person ower) { this.ower = = CascadeType.ALL, fetch = = "id ASC") public Set<OrderItem> getorderitems() { return orderitems; public void setorderitems(set<orderitem> orderitems) { this.orderitems = orderitems;

106 public void addorderitem(orderitem orderitem) { if (!this.orderitems.contains(orderitem)) { this.orderitems.add(orderitem); orderitem.setorder(this); public void removeorderitem(orderitem orderitem) { orderitem.setorder(null); this.orderitems.remove(orderitem); public Date getcreatedate() { return createdate; public void setcreatedate(date createdate) { this.createdate = createdate; public boolean equals (Object obj) { if (null == obj) return false; if (!(obj instanceof Order)) return false; else { Order mobj = (Order) obj; if (null == this.getorderid() null == mobj.getorderid()) return false; else return (this.getorderid().equals(mobj.getorderid())); public int hashcode () { if (Integer.MIN_VALUE == this.hashcode) { if (null == this.getorderid()) return super.hashcode(); else { String hashstr = this.getclass().getname() + ":" + this.getorderid().hashcode(); this.hashcode = hashstr.hashcode(); return this.hashcode; OrderItem.java

107 package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.cascadetype; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.joincolumn; import javax.persistence.manytoone; @Table(name = "OrderItems") public class OrderItem implements Serializable { private Integer id; private String productname; private Float price; private Order order; public OrderItem() { public OrderItem(String productname, Float price) { this.productname = productname; this.price public Integer getid() { return id; public void setid(integer id) { this.id = id; public String getproductname() { return productname; public void setproductname(string productname) { this.productname = productname; public Float getprice() {

108 return price; public void setprice(float price) { this.price = "order_id") public Order getorder() { return order; public void setorder(order order) { this.order = order; 下面是实体 Bean 的使用者 Session Bean Session Bean 的接口 package com.foshanshop.ejb3; public interface QueryDAO { public String ExecuteQuery(int index); public void initdate(); Session Bean 的程序片断 package com.foshanshop.ejb3.impl; import java.text.simpledateformat; import java.util.date; import java.util.hashset; import java.util.iterator; import java.util.list; import java.util.set; import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import javax.persistence.query; import com.foshanshop.ejb3.querydao; import com.foshanshop.ejb3.bean.order; import com.foshanshop.ejb3.bean.orderitem; import com.foshanshop.ejb3.bean.person; ({QueryDAO.class)

109 public class QueryDAOBean implements QueryDAO protected EntityManager em; public void initdate() { try { Query query = em.createquery("select count(*) from Person p"); Object result = query.getsingleresult(); if (result == null Integer.parseInt(result.toString()) == 0) { // 没有数据时, 插入几条数据用作测试 // =================================== SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd"); Person person = new Person("liujun", true, new Short("26"), formatter.parse(" ")); Set<Order> orders = new HashSet<Order>(); Order order1 = new Order(new Float("105.5"), person, new Date()); order1.addorderitem(new OrderItem("U 盘 ", new Float("105.5"))); Order order2 = new Order(new Float("780"), person, new Date()); order2.addorderitem(new OrderItem("MP4", new Float("778"))); order2.addorderitem(new OrderItem(" 矿泉水 ", new Float("2"))); orders.add(order1); orders.add(order2); person.setorders(orders); Person person1 = new Person("yunxiaoyi", false, new Short("23"), formatter.parse(" ")); orders = new HashSet<Order>(); order1 = new Order(new Float("360"), person1, new Date()); order1.addorderitem(new OrderItem(" 香水 ", new Float("360"))); order2 = new Order(new Float("1806"), person1, new Date()); order2.addorderitem(new OrderItem(" 照相机 ", new Float("1800"))); order2.addorderitem(new OrderItem("5 号电池 ", new Float("6"))); orders.add(order1); orders.add(order2); person1.setorders(orders); // ===================================== Person person2 = new Person("zhangming", false, new Short("21"), formatter.parse(" ")); orders = new HashSet<Order>();

110 order1 = new Order(new Float("620"), person2, new Date()); order1.addorderitem(new OrderItem(" 棉被 ", new Float("620"))); order2 = new Order(new Float("3"), person2, new Date()); order2.addorderitem(new OrderItem(" 可乐 ", new Float("3"))); orders.add(order1); orders.add(order2); person2.setorders(orders); em.persist(person2); em.persist(person1); em.persist(person); catch (Exception e) { e.printstacktrace(); public String ExecuteQuery(int index) { String result = ""; switch(index){ case 1: result = this.namequery(); break; case 2: result = this.positionquery(); break; case 3: result = this.queryorderby(); break; case 4: result = this.querypartattribute(); break; case 5: result = this.queryconstructor(); break; case 6: result = this.queryaggregation(); break; case 7: result = this.querygroupby(); break; case 8: result = this.querygroupbyhaving();

111 break; case 9: result = this.queryleftjoin(); break; case 10: result = this.queryinnerjoin(); break; case 11: result = this.queryinnerjoinlazyload(); break; case 12: result = this.queryjoinfetch(); break; case 13: result = this.queryentityparameter(); break; case 14: result = this.querybatchupdate(); break; case 15: result = this.querybatchremove(); break; case 16: result = this.querynotoperate(); break; case 17: result = this.querybetweenoperate(); break; case 18: result = this.queryinoperate(); break; case 19: result = this.querylikeoperate(); break; case 20: result = this.queryisnulloperate(); break; case 21: result = this.queryisemptyoperate(); break; case 22: result = this.queryexistsoperate(); break; case 23:

112 result = this.querystringoperate(); break; case 24: result = this.querymathloperate(); break; case 25: result = this.querysubqueryoperate(); break; case 26: result = this.querynonereturnvaluestoreprocedure(); break; case 27: result = this.querysingleobjectstoreprocedure(); break; case 28: result = this.querystoreprocedure(); break; case 29: result = this.querypartcolumnstoreprocedure(); break; return result; 这里省略后面的代码 下面是 Session Bean 的 JSP 客户端代码 : QueryTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.querydao, javax.naming.*, java.util.date, java.text.simpledateformat, java.util.*"%> <% 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 { String index = request.getparameter("index"); if (index!=null &&!"".equals(index.trim())){ InitialContext ctx = new InitialContext(props);

113 %> QueryDAO querydao = (QueryDAO) ctx.lookup("querydaobean/remote"); querydao.initdate(); out.println(querydao.executequery(integer.parseint(index))); catch (Exception e) { out.println(e.getmessage()); 本例子的 EJB 源代码在 Query 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 Query 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 注意 : 在发布本例子 EJB 时, 请御载前面带有 Person,Order,OrderItem 类的例子 ( 如 : EntityBean.jar,OneToMany.jar, OneToOne.jar), 否则会引起类型冲突 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 参数值可以是 1 到 25) 访问客户端 大小写敏感性 (Case Sensitivity) 除了 Java 类和属性名称外, 查询都是大小写不敏感的 所以,SeLeCT 和 select 以及 SELECT 相同的, 但是 com.foshanshop.ejb3.bean.person 和 com.foshanshop.ejb3.bean.person 是不同的, person.name 和 person.name 也是不同的 排序 (order by) 下面是一个简单查询的例子, 可以看到 EJB3 QL 和 SQL 的使用方法很类似 "ASC" 和 "DESC" 分别为升序和降序, 如果不显式注明,EJB3 QL 中默认为 asc 升序 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryOrderBy(){ // 先按年龄降序排序, 然后按出生日期升序排序 Query query = em.createquery("select p from Person p order by p.age desc, p.birthday asc"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryOrderBy 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ Person person= (Person)iterator.next(); out.append(person.getname()+ "<BR>");

114 return out.tostring(); 查询部分属性 在前面的例子中, 都是对针对 Entity 类的查询, 返回的也是被查询的 Entity 类的实体 EJB3 QL 也允许我们直接查询返回我们需要的属性, 而不是返回整个 Entity 在一些 Entity 中属性特别多的情况, 这样的查询可以提高性能 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryPartAttribute(){ // 直接查询我们感兴趣的属性 ( 列 ) Query query = em.createquery("select p.personid, p.name from Person p order by p.personid desc "); // 集合中的元素不再是 Person, 而是一个 Object[] 对象数组 List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryPartAttribute 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ // 取每一行 Object[] row = ( Object[]) iterator.next(); // 数组中的第一个值是 personid int personid = Integer.parseInt(row[0].toString()); String PersonName = row[1].tostring(); out.append("personid="+ personid+ "; Person Name="+PersonName+ "<BR>"); return out.tostring(); 查询中使用构造器 (Constructor) EJB3 QL 支持将查询的属性结果直接作为一个 java class 的构造器参数, 并产生实体作为结果返回 ( 例子的源代码在 Query 文件夹 ) SimplePerson.java package com.foshanshop.ejb3.bean; public class SimplePerson { private String name; private boolean sex;

115 public SimplePerson() { public SimplePerson(String name, boolean sex) { this.name = name; this.sex = sex; public String getdescription() { return sex? name+" 是男孩 " : name+" 是女孩 "; 下面将查询的属性结果直接作为 SimplePerson 的构造器参数 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryConstructor(){ // 我们把需要的两个属性作为 SimplePerson 的构造器参数, 并使用 new 函数 Query query = em.createquery("select new com.foshanshop.ejb3.bean.simpleperson(p.name,p.sex) from Person p order by p.personid desc"); // 集合中的元素是 SimplePerson 对象 List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryConstructor 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ SimplePerson simpleperson = (SimplePerson) iterator.next(); out.append(" 人员介绍 :"+ simpleperson.getdescription()+ "<BR>"); return out.tostring(); 聚合查询 (Aggregation) 象大部分的 SQL 一样, EJB3 QL 也支持查询中的聚合函数 目前 EJB3 QL 支持的聚合函数包括 : 1. AVG() 2. SUM() 3. COUNT() 4. MAX()

116 5. MIN() ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryAggregation(){ // 获取最大年龄 Query query = em.createquery("select max(p.age) from Person p"); Object result = query.getsingleresult(); String maxage = result.tostring(); // 获取平均年龄 query = em.createquery("select avg(p.age) from Person p"); result = query.getsingleresult(); String avgage = result.tostring(); // 获取最小年龄 query = em.createquery("select min(p.age) from Person p"); result = query.getsingleresult(); String minage = result.tostring(); // 获取总人数 query = em.createquery("select count(*) from Person p"); result = query.getsingleresult(); String countperson = result.tostring(); // 获取年龄总和 query = em.createquery("select sum(p.age) from Person p"); result = query.getsingleresult(); String sumage = result.tostring(); StringBuffer out = new StringBuffer("*************** QueryConstructor 结果打印 ****************<BR>"); out.append(" 最大年龄 :"+ maxage+ "<BR>"); out.append(" 平均年龄 :"+ avgage+ "<BR>"); out.append(" 最小年龄 :"+ minage+ "<BR>"); out.append(" 总人数 :"+ countperson+ "<BR>"); out.append(" 年龄总和 :"+ sumage+ "<BR>"); return out.tostring(); 和 SQL 一样, 如果聚合函数不是 select...from 的唯一一个返回列, 需要使用 "GROUP BY" 语句 "GROUP BY" 应该包含 select 语句中除了聚合函数外的所有属性 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryGroupBy(){ // 返回男女生各自的总人数

117 Query query = em.createquery("select p.sex, count(*) from Person p group by p.sex"); // 集合中的元素不再是 Person, 而是一个 Object[] 对象数组 List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryGroupBy 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ // 取每一行 Object[] row = (Object[]) iterator.next(); // 数组中的第一个值是 sex boolean sex = Boolean.parseBoolean(row[0].toString()); // 数组中的第二个值是聚合函数 COUNT 返回值 String sextotal = row[1].tostring(); out.append((sex? " 男生 ":" 女生 ")+ " 总共有 "+ sextotal+ " 人 <BR>"); return out.tostring(); 如果还需要加上查询条件, 需要使用 "HAVING" 条件语句而不是 "WHERE" 语句 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryGroupByHaving(){ // 返回人数超过 1 人的性别 Query query = em.createquery("select p.sex, count(*) from Person p group by p.sex having count(*) >?1"); // 设置查询中的参数 query.setparameter(1, new Long(1)); // 集合中的元素不再是 Person, 而是一个 Object[] 对象数组 List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryGroupByHaving 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ // 取每一行 Object[] row = (Object[]) iterator.next(); // 数组中的第一个值是 sex boolean sex = Boolean.parseBoolean(row[0].toString()); // 数组中的第二个值是聚合函数 COUNT 返回值 String sextotal = row[1].tostring(); out.append((sex? " 男生 ":" 女生 ")+ " 总共有 "+ sextotal+ " 人 <BR>");

118 return out.tostring(); 关联 (join) 在 EJB3 QL 中, 仍然支持和 SQL 中类似的关联语法 : left out join/left join inner join left join/inner join fetch left out join/left join 等, 都是允许符合条件的右边表达式中的 Entiies 为空 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryLeftJoin(){ // 获取 26 岁人的订单, 不管 Order 中是否有 OrderItem Query query = em.createquery("select o from Order o left join o.orderitems where o.ower.age=26 order by o.orderid"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryLeftJoin 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); Integer orderid = null; while( iterator.hasnext() ){ Order order = (Order) iterator.next(); if (orderid==null!orderid.equals(order.getorderid())){ orderid = order.getorderid(); out.append(" 订单号 :"+ orderid+ "<BR>"); return out.tostring(); 这个句 EJB3 QL 编译成以下的 SQL select order0_.orderid as orderid18_, order0_.amount as amount18_, order0_.person_id as person4_18_, order0_.createdate as createdate18_ from Orders order0_ left outer join OrderItems orderitems1_ on order0_.orderid=orderitems1_.order_id, Person person2_ where order0_.person_id=person2_.personid and person2_.age=26 order by order0_.orderid 需要显式使用 left join/left outer join 的情况会比较少

119 inner join 要求右边的表达式必须返回 Entities ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryInnerJoin(){ // 获取 26 岁人的订单,Order 中必须要有 OrderItem Query query = em.createquery("select o from Order o inner join o.orderitems where o.ower.age=26 order by o.orderid"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryInnerJoin 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); Integer orderid = null; while( iterator.hasnext() ){ Order order = (Order) iterator.next(); if (orderid==null!orderid.equals(order.getorderid())){ orderid = order.getorderid(); out.append(" 订单号 :"+ orderid+ "<BR>"); return out.tostring(); 这个句 EJB3 QL 编译成以下的 SQL select order0_.orderid as orderid18_, order0_.amount as amount18_, order0_.person_id as person4_18_, order0_.createdate as createdate18_ from Orders order0_ inner join OrderItems orderitems1_ on order0_.orderid=orderitems1_.order_id, Person person2_ where order0_.person_id=person2_.personid and person2_.age=26 order by order0_.orderid left/left out/inner join fetch 提供了一种灵活的查询加载方式来提高查询的性能 在默认的查询中,Entity 中的集合属性默认不会被关联, 集合属性默认是缓加载 ( lazy-load ) 如下:( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryInnerJoinLazyLoad(){ // 默认 EJB3 QL 编译后不关联集合属性变量 (orderitems) 对应的表 Query query = em.createquery("select o from Order o inner join o.orderitems where o.ower.age=26 order by o.orderid"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryInnerJoinLazyLoad 结果打印 ****************<BR>");

120 if (result!=null){ if( result.size()>0){ // 这时获得 Order 实体中 orderitems( 集合属性变量 ) 为空 Order order = (Order) result.get(0); // 当应用需要时,EJB3 Runtime 才会执行一条 SQL 语句来加载属于当前 Order 的 OrderItems Set<OrderItem> list = order.getorderitems(); Iterator<OrderItem> iterator = list.iterator(); if (iterator.hasnext()){ OrderItem orderitem =iterator.next(); out.append(" 订购产品名 :"+ orderitem.getproductname()+ "<BR>"); return out.tostring(); 在执行 "select o from Order o inner join o.orderitems where o.ower.age=26 order by o.orderid" 时编译成的 SQL 如下 : 他不包含集合属性变量 (orderitems) 对应表的字段 select order0_.orderid as orderid6_, order0_.amount as amount6_, order0_.person_id as person4_6_, order0_.createdate as createdate6_ from Orders order0_ inner join OrderItems orderitems1_ on order0_.orderid=orderitems1_.order_id, Person person2_ where order0_.person_id=person2_.personid and person2_.age=26 order by order0_.orderid 当执行到 Set<OrderItem> list = order.getorderitems(); 时才会执行一条 SQL 语句来加载属于当前 Order 的 OrderItems, 编译成的 SQL 如下 : select orderitems0_.order_id as order4_1_, orderitems0_.id as id1_, orderitems0_.id as id7_0_, orderitems0_.order_id as order4_7_0_, orderitems0_.productname as productn2_7_0_, orderitems0_.price as price7_0_ from OrderItems orderitems0_ where orderitems0_.order_id=? order by orderitems0_.id ASC 这样的查询性能上有不足的地方 为了查询 N 个 Order, 我们需要一条 SQL 语句获得所有的 Order 的原始对象属性, 但需要另外 N 条语句获得每个 Order 的 orderitems 集合属性 为了避免 N+1 的性能问题, 我们可以利用 join fetch 一次过用一条 SQL 语句把 Order 的所有信息查询出来 如下 :( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryJoinFetch(){ // 获取 26 岁人的订单,Order 中必须要有 OrderItem Query query = em.createquery("select o from Order o inner join fetch o.orderitems where o.ower.age=26 order by o.orderid"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryJoinFetch 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); Integer orderid = null;

121 while( iterator.hasnext() ){ Order order = (Order) iterator.next(); if (orderid==null!orderid.equals(order.getorderid())){ orderid = order.getorderid(); out.append(" 订单号 :"+ orderid+ "<BR>"); return out.tostring(); 这个句 EJB3 QL 编译成以下的 SQL select order0_.orderid as orderid18_0_, orderitems1_.id as id19_1_, order0_.amount as amount18_0_, order0_.person_id as person4_18_0_, order0_.createdate as createdate18_0_, orderitems1_.order_id as order4_19_1_, orderitems1_.productname as productn2_19_1_, orderitems1_.price as price19_1_, orderitems1_.order_id as order4_0, orderitems1_.id as id0 from Orders order0_ inner join OrderItems orderitems1_ on order0_.orderid=orderitems1_.order_id, Person person2_ where order0_.person_id=person2_.personid and person2_.age=26 order by order0_.orderid, orderitems1_.id ASC 上面由于使用了 fetch, 这个查询只会产生一条 SQL 语句, 比原来需要 N+1 条 SQL 语句在性能上有了极大的提升 比较 Entity 在查询中使用参数查询时, 参数类型除了 String, 原始数据类型 ( int, double 等 ) 和它们的对象类型 ( Integer, Double 等 ), 也可以是 Entity 的实例 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryEntityParameter(){ // 查询某人的所有订单 Query query = em.createquery("select o from Order o where o.ower =?1 order by o.orderid"); Person person = new Person(); person.setpersonid(new Integer(1)); // 设置查询中的参数 query.setparameter(1,person); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryEntityParameter 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); Integer orderid = null; while( iterator.hasnext() ){ Order order = (Order) iterator.next(); if (orderid==null!orderid.equals(order.getorderid())){

122 orderid = order.getorderid(); out.append(" 订单号 :"+ orderid+ "<BR>"); return out.tostring(); 批量更新 (Batch Update) EJB3 QL 支持批量更新. ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryBatchUpdate(){ // 把所有订单的金额加 10 Query query = em.createquery("update Order as o set o.amount=o.amount+10"); //update 的记录数 int result = query.executeupdate(); StringBuffer out = new StringBuffer("*************** QueryBatchUpdate 结果打印 ****************<BR>"); out.append(" 更新操作影响的记录数 :"+ result+ " 条 <BR>"); return out.tostring(); 批量删除 (Batch Remove) EJB3 QL 支持批量删除 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryBatchRemove(){ // 把金额小于 100 的订单删除 Query query = em.createquery("delete from Order as o where o.amount <100"); //delete 的记录数 int result = query.executeupdate(); StringBuffer out = new StringBuffer("*************** QueryBatchRemove 结果打印 ****************<BR>"); out.append(" 删除操作影响的记录数 :"+ result+ " 条 <BR>"); return out.tostring();

123 使用操作符 NOT ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryNOTOperate(){ // 查询除了指定人之外的所有订单 Query query = em.createquery("select o from Order o where not(o.ower =?1) order by o.orderid"); Person person = new Person(); person.setpersonid(new Integer(2)); // 设置查询中的参数 query.setparameter(1,person); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryNOTOperate 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); Integer orderid = null; while( iterator.hasnext() ){ Order order = (Order) iterator.next(); if (orderid==null!orderid.equals(order.getorderid())){ orderid = order.getorderid(); out.append(" 订单号 :"+ orderid+ "<BR>"); return out.tostring(); 使用操作符 BETWEEN ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryBETWEENOperate(){ // 查询金额在 300 到 1000 之间的订单 Query query = em.createquery("select o from Order as o where o.amount between 300 and 1000"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryBETWEENOperate 结果打印 ****************<BR>");

124 if (result!=null){ Iterator iterator = result.iterator(); Integer orderid = null; while( iterator.hasnext() ){ Order order = (Order) iterator.next(); if (orderid==null!orderid.equals(order.getorderid())){ orderid = order.getorderid(); out.append(" 订单号 :"+ orderid+ "<BR>"); return out.tostring(); 使用操作符 IN ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryINOperate(){ // 查找年龄为 26,21 的 Person Query query = em.createquery("select p from Person as p where p.age in(26,21)"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryINOperate 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ Person person= (Person)iterator.next(); out.append(person.getname()+ "<BR>"); return out.tostring(); 使用操作符 LIKE ( 例子的源代码在 Query 文件夹 protected EntityManager em;

125 private String QueryLIKEOperate(){ // 查找以字符串 "li" 开头的 Person Query query = em.createquery("select p from Person as p where p.name like 'li%'"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryLIKEOperate 结果打印 ****************<BR>"); if (result!=null){ out.append(" 查找以字符串 \"li\" 开头的 Person <BR>"); Iterator iterator = result.iterator(); while( iterator.hasnext() ){ Person person= (Person)iterator.next(); out.append(person.getname()+ "<BR>"); // 可以结合 NOT 一起使用, 比如查询所有 name 不以字符串 "ming" 结尾的 Person query = em.createquery("select p from Person as p where p.name not like '%ming'"); result = query.getresultlist(); if (result!=null){ out.append(" 查询所有 name 不以字符串 \"ming\" 结尾的 Person <BR>"); Iterator iterator = result.iterator(); while( iterator.hasnext() ){ Person person= (Person)iterator.next(); out.append(person.getname()+ "<BR>"); return out.tostring(); 使用操作符 IS NULL ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryISNULLOperate(){ // 查询含有购买者的所有 Order Query query = em.createquery("select o from Order as o where o.ower is not null order by o.orderid"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryISNULLOperate 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator();

126 out.append(" 查询含有购买者的所有 Order <BR>"); while( iterator.hasnext() ){ Order order = (Order) iterator.next(); out.append(" 订单号 :"+ order.getorderid()+ "<BR>"); // 查询没有购买者的所有 Order query = em.createquery("select o from Order as o where o.ower is null order by o.orderid"); result = query.getresultlist(); if (result!=null){ Iterator iterator = result.iterator(); out.append(" 查询没有购买者的所有 Order <BR>"); while( iterator.hasnext() ){ Order order = (Order) iterator.next(); out.append(" 订单号 :"+ order.getorderid()+ "<BR>"); return out.tostring(); 使用操作符 IS EMPTY IS EMPTY 是针对集合属性 (Collection) 的操作符 可以和 NOT 一起使用 ( 例子的源代码在 Query 文件夹 ) 注: 低版权的 Mysql 不支持 IS protected EntityManager em; private String QueryISEMPTYOperate(){ // 查询含有订单项的所有 Order Query query = em.createquery("select o from Order as o where o.orderitems is not empty order by o.orderid"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryISEMPTYOperate 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); out.append(" 查询含有订单项的所有 Order <BR>"); while( iterator.hasnext() ){ Order order = (Order) iterator.next(); out.append(" 订单号 :"+ order.getorderid()+ "<BR>");

127 // 查询没有订单项的所有 Order query = em.createquery("select o from Order as o where o.orderitems is empty order by o.orderid"); result = query.getresultlist(); if (result!=null){ Iterator iterator = result.iterator(); out.append(" 查询没有订单项的所有 Order <BR>"); while( iterator.hasnext() ){ Order order = (Order) iterator.next(); out.append(" 订单号 :"+ order.getorderid()+ "<BR>"); return out.tostring(); 使用操作符 EXISTS [NOT]EXISTS 需要和子查询配合使用 ( 例子的源代码在 Query 文件夹 ) 注: 低版权的 Mysql 不支持 protected EntityManager em; private String QueryEXISTSOperate(){ // 如果存在订单号为 1 的订单, 就获取所有 OrderItem Query query = em.createquery("select oi from OrderItem as oi where exists (select o from Order o where o.orderid=1)"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryEXISTSOperate 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); out.append(" 如果存在订单号 1, 就获取所有 OrderItem <BR>"); while( iterator.hasnext() ){ OrderItem item = (OrderItem) iterator.next(); out.append(" 所有订购的产品名 :"+ item.getproductname()+ "<BR>"); // 如果不存在订单号为 10 的订单, 就获取 id 为 1 的 OrderItem query = em.createquery("select oi from OrderItem as oi where oi.id=1 and not exists (select o from Order o where o.orderid=10)"); result = query.getresultlist(); if (result!=null){ Iterator iterator = result.iterator(); out.append(" 如果不存在订单号 10, 就获取 id 为 1 的 OrderItem

128 <BR>"); if( iterator.hasnext() ){ OrderItem item = (OrderItem) iterator.next(); out.append(" 订单项 ID 为 1 的订购产品名 :"+ item.getproductname()+ "<BR>"); return out.tostring(); 字符串函数 EJB3 QL 定义了内置函数方便使用 这些函数的使用方法和 SQL 中相应的函数方法类似 EJB3 QL 中定义的字符串函数包括 : 1. CONCAT 字符串拼接 2. SUBSTRING 字符串截取 3. TRIM 去掉空格 4. LOWER 转换成小写 5. UPPER 装换成大写 6. LENGTH 字符串长度 7. LOCATE 字符串定位 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryStringOperate(){ // 查询所有人员, 并在姓名后面加上字符串 "_foshan" Query query = em.createquery("select p.personid, concat(p.name, '_foshan') from Person as p"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryStringOperate 结果打印 ****************<BR>"); if (result!=null){ out.append(" 查询所有人员, 并在姓名后面加上字符串 \"_foshan\" <BR>"); Iterator iterator = result.iterator(); while( iterator.hasnext() ){ // 取每一行 Object[] row = ( Object[]) iterator.next(); // 数组中的第一个值是 personid int personid = Integer.parseInt(row[0].toString()); String PersonName = row[1].tostring(); out.append("personid="+ personid+ "; Person Name="+PersonName+ "<BR>");

129 // 查询所有人员, 只取姓名的前三个字符 query = em.createquery("select p.personid, substring(p.name,1,3) from Person as p"); result = query.getresultlist(); if (result!=null){ out.append(" 查询所有人员, 只取姓名的前三个字符 <BR>"); Iterator iterator = result.iterator(); while( iterator.hasnext() ){ // 取每一行 Object[] row = ( Object[]) iterator.next(); // 数组中的第一个值是 personid int personid = Integer.parseInt(row[0].toString()); String PersonName = row[1].tostring(); out.append("personid="+ personid+ "; Person Name="+PersonName+ "<BR>"); return out.tostring(); 计算函数 EJB3 QL 中定义的计算函数包括 : ABS 绝对值 SQRT 平方根 MOD 取余数 SIZE 取集合的数量 ( 例子的源代码在 Query 文件夹 protected EntityManager em; private String QueryMathLOperate(){ // 查询所有 Order 的订单号及其订单项的数量 Query query = em.createquery("select o.orderid, size(o.orderitems) from Order as o group by o.orderid"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryMathLOperate 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); out.append(" 查询所有 Order 的订单号及其订单项的数量 <BR>"); while( iterator.hasnext() ){ // 取每一行 Object[] row = ( Object[]) iterator.next();

130 out.append(" 订单号 :"+ row[0].tostring()+ "; 订单项共 "+row[1].tostring()+ " 项 <BR>"); // 查询所有 Order 的订单号及其总金额 /10 的余数 query = em.createquery("select o.orderid, mod(o.amount, 10) from Order as o"); result = query.getresultlist(); if (result!=null){ Iterator iterator = result.iterator(); out.append(" 查询所有 Order 的订单号及其总金额 /10 的余数 <BR>"); while( iterator.hasnext() ){ // 取每一行 Object[] row = ( Object[]) iterator.next(); out.append(" 订单号 :"+ row[0].tostring()+ "; 总金额 /10 的余数 :"+row[1].tostring()+ "<BR>"); return out.tostring(); 子查询 子查询可以用于 WHERE 和 HAVING 条件语句中 ( 例子的源代码在 Query 文件夹 ) 注: 低版权的 Mysql protected EntityManager em; private String QuerySubQueryOperate(){ // 查询年龄为 26 岁的购买者的所有 Order Query query = em.createquery("select o from Order as o where o.ower in(select p from Person as p where p.age =26) order by o.orderid"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QuerySubQueryOperate 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); out.append(" 查询年龄为 26 岁的购买者的所有 Order <BR>"); while( iterator.hasnext() ){ Order order = (Order) iterator.next(); out.append(" 订单号 :"+ order.getorderid()+ "<BR>"); return out.tostring();

131 结果集分页 有些时候当执行一个查询会返回成千上万条记录, 事实上我们只需要显示一部分数据 这时我们需要对结果集进行分页,Query API 有两个接口方法可以解决这个问题 :setmaxresults( ) 和 setfirstresult( ) setmaxresults 方法设置获取多少条记录 setfirstresult 方法设置从结果集中的那个索引开始获取 ( 假如返回的记录有 3 条, 容器会自动为记录编上索引, 索引从 0 开始, 依次为 0,1,2) 单表映射项目 (EntityBean) 中 PersonDAOBean 的代码片断 : public List getpersonlist(int max,int whichpage) { try { int index = (whichpage-1) * max; Query query = em.createquery("from Person p order by personid asc"); List list = query.setmaxresults(max). setfirstresult(index). getresultlist(); em.clear();// 分离内存中受 EntityManager 管理的实体 bean, 让 VM 进行垃圾回收 return list; catch (Exception e) { e.printstacktrace(); return null; JSP 客户端调用代码片断 : <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.persondao, com.foshanshop.ejb3.bean.person, javax.naming.*, java.util.properties, java.util.list, java.util.iterator"%> <% 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 { PersonDAO persondao = (PersonDAO) ctx.lookup("persondaobean/remote"); out.println("<br>============ 分页显示, 每页记录数为 2 =========<BR>"); String index = request.getparameter("index");

132 if (index==null "".equals(index.trim())) index = "1"; int max = 2; // 每页记录数为 2 int whichpage = Integer.parseInt(index); // 第几页 List list = persondao.getpersonlist(max, whichpage); if (list!=null){ Iterator it = list.iterator(); while (it.hasnext()) { Person p = (Person)it.next(); out.println(" 人员编号 :"+ p.getpersonid() + " 姓名 :"+ p.getname() + "<Br>"); catch (Exception e) { out.println(e.getmessage()); %> 上面代码中设置每页记录数为 2, 如果数据库存在 7 条记录, 第一页显示的记录索引应为 (0,1), 第二页为 (2, 3), 第三页为 (3,4) 等等 如果我们需要显示大量的实体 Bean, 假如记录成千上万, 通过简单的循环处理, 我们将很快消耗完内存, 为此我们需要在显示了一部分实体 bean 之后调用 EntityManager.clear() 及时把这些实体 bean 从 EntityManager 分离出来, 让 Java VM 对他们进行垃圾回收 在分页中, 为了数据排列有序, 建议在查询中针对某些字段进行排序 6.9 调用存储过程 要调用存储过程, 我们可以通过 EntityManager 对象的 createnativequery() 方法执行 SQL 语句 ( 注意 : 这里说的是 SQL 语句, 不是 EJB3 QL), 调用存储过程的 SQL 格式如下 : {call 存储过程名称 ( 参数 1, 参数 2, ) 在 EJB3 中你可以调用的存储过程有两种 1. 无返回值的存储过程 2. 返回值为 ResultSet( 以 select 形式返回的值 ) 的存储过程,EJB3 不能调用以 OUT 参数返回值的存储过程 下面我们看看几种具有代表性的存储过程的调用方法 调用无返回值的存储过程 我们首先创建一个名为 AddPerson 的存储过程, 他的 DDL 如下 ( 注 : 本例使用的是 MySql 数据库 ): CREATE PROCEDURE `AddPerson`() NOT DETERMINISTIC SQL SECURITY DEFINER COMMENT ''

133 BEGIN END; INSERT into person(`personname`,`sex`,`age`) values(' 存储过程 ',1,25); 下面的代码片断展示了无返回值存储过程的调用方法 protected EntityManager em; private String QueryNoneReturnValueStoreProcedure(){ // 调用无返回参数的存储过程 Query query = em.createnativequery("{call AddPerson()"); query.executeupdate(); StringBuffer out = new StringBuffer("*************** QueryNoneReturnValueStoreProcedure 结果打印 ****************<BR>"); return out.tostring(); 例子的源代码在 Query 文件夹, 在运行本例子, 你首先需要创建 AddPerson 存储过程, 然后调用 Ant 的 deploy 任 务 通过 访问例子 调用返回单值的存储过程 我们首先创建一个名为 GetPersonName 的存储过程, 他有一个 INTEGER 类型的输入参数, 存储过程的 DDL 如下 ( 注 : 本例使用的是 MySql 数据库 ): CREATE PROCEDURE `GetPersonName`(IN Pid INTEGER(11)) NOT DETERMINISTIC SQL SECURITY DEFINER COMMENT '' BEGIN select personname from person where `personid`=pid; END; 上面的 select 语句不一定要从表中取数据, 你也可以这样写 :select foshanren 下面的代码片断展示了返回单值的存储过程的调用方法 protected EntityManager em; private String QuerySingleObjectStoreProcedure(){ // 调用返回单个值的存储过程 Query query = em.createnativequery("{call GetPersonName(?)"); query.setparameter(1, new Integer(1)); String result = query.getsingleresult().tostring(); StringBuffer out = new StringBuffer("*************** QuerySingleObjectStoreProcedure 结果打印 ****************<BR>");

134 out.append(" 返回值 ( 人员姓名 ) 为 :"+ result+ "<BR>"); return out.tostring(); 例子的源代码在 Query 文件夹, 在运行本例子, 你首先需要创建 GetPersonName 存储过程, 然后调用 Ant 的 deploy 任务 通过 访问例子 调用返回表全部列的存储过程 我们首先创建一个名为 GetPersonList 的存储过程, 他的 DDL 如下 ( 注 : 本例使用的是 MySql 数据库 ): CREATE PROCEDURE `GetPersonList`() NOT DETERMINISTIC SQL SECURITY DEFINER COMMENT '' BEGIN select * from person; END; 下面的代码片断展示了返回表全部列的存储过程的调用方法, 我们可以让 EJB3 Persistence 运行环境将列值直接填充入一个 Entity 的实例 ( 本例填充进 Person 对象 ), protected EntityManager em; private String QueryStoreProcedure(){ // 调用返回 Person 全部列的存储过程 Query query = em.createnativequery("{call GetPersonList()", Person.class); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryStoreProcedure 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ Person person= (Person)iterator.next(); out.append(person.getname()+ "<BR>"); return out.tostring(); 例子的源代码在 Query 文件夹, 在运行本例子, 你首先需要创建 GetPersonList 存储过程, 然后调用 Ant 的 deploy 任务 通过 访问例子

135 6.9.4 调用返回部分列的存储过程 我们首先创建一个名为 GetPersonPartProperties 的存储过程, 他的 DDL 如下 ( 注 : 本例使用的是 MySql 数据库 ): CREATE PROCEDURE `GetPersonPartProperties`() NOT DETERMINISTIC SQL SECURITY DEFINER COMMENT '' BEGIN SELECT personid, personname from person; END; 上面的 select 语句不一定要从表中取数据, 你也可以这样写 :select 3000, foshanren protected EntityManager em; private String QueryPartColumnStoreProcedure(){ // 调用返回部分列的存储过程 Query query = em.createnativequery("{call GetPersonPartProperties()"); List result = query.getresultlist(); StringBuffer out = new StringBuffer("*************** QueryPartColumnStoreProcedure 结果打印 ****************<BR>"); if (result!=null){ Iterator iterator = result.iterator(); while( iterator.hasnext() ){ // 取每一行 Object[] row = ( Object[]) iterator.next(); // 数组中的第一个值是 personid int personid = Integer.parseInt(row[0].toString()); String PersonName = row[1].tostring(); out.append(" 人员 ID="+ personid+ "; 姓名 ="+PersonName+ "<BR>"); return out.tostring(); 例子的源代码在 Query 文件夹, 在运行本例子, 你首先需要创建 GetPersonPartProperties 存储过程, 然后调用 Ant 的 deploy 任务 通过 访问例子 6.10 事务管理服务 最有用的容器服务可能就是事务管理服务, 当应用出现失败或异常时, 它保证了数据库的完整性 你可以简单地 将为一个 POJO 方法申明它的事务属性 这样容器就可以在合适的上下文中运行这个方法 最常见的事务是定义

136 在 session bean 的方法上, 方法中所有的数据库操作只有在方法正常退出时才会提交, 如果方法抛出未捕获的异常, 注释用作定义一个需要事务的方法 它可以有以下参数 : 1.REQUIRED: 方法在一个事务中执行, 如果调用的方法已经在一个事务中, 则使用该事务, 否则将创建一个新的事务 2.MANDATORY: 方法必须在一个事务中执行, 也就是说调用的方法必须已经有一个事务, 否则新抛出一个错误 (ERROR) 3.REQUIRESNEW: 方法将在一个新的事务中执行, 如果调用的方法已经在一个事务中, 则暂停旧的事务 4.SUPPORTS: 如果方法在一个事务中被调用, 则使用该事务, 否则不使用事务 5.NOT_SUPPORTED: 如果方法在一个事务中被调用, 将抛出一个错误 (ERROR) 如果没有指定参数,@TransactionAttribute 注释使用 REQUIRED 作为默认参数 下面的代码展示了事务管理的开发 : TransactionDAOBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import java.util.list; import javax.ejb.remote; import javax.ejb.stateless; import javax.ejb.transactionattribute; import javax.ejb.transactionattributetype; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import javax.persistence.query; import com.foshanshop.ejb3.transexception; import com.foshanshop.ejb3.transactiondao; ({TransactionDAO.class) public class TransactionDAOBean implements TransactionDAO protected EntityManager public void insertproduct(string name, Float price, boolean error) { try { for(int i=0;i<3; i++){ Product product = new Product(name+i,price*(i+1)); em.persist(product); if (error) new Float("kkk"); // 制造一个例外 catch (Exception e) { throw new RuntimeException (" 应用抛出运行时例外, 为了使事务回滚, 外部不要用 try/catch

137 包围 public void ModifyProductName(String newname, boolean error) throws Exception { Query query = em.createquery("select p from Product p"); List result = query.getresultlist(); if (result!=null){ for(int i=0;i<result.size();i++){ Product product = (Product)result.get(i); product.setname(newname+ i); em.merge(product); if (error && result.size()>0) throw new TransException (" 抛出应用例外 "); 上面定义了两个需要事务的方法, 容器在运行这两个方法时将会创建一个事务, 方法里的所有数据库操作都在此事务中运行, 当这两个方法正常退出时, 事务将会提交, 所有更改都会同步到数据库中 如果方法抛出 RuntimeException 例外或 ApplicationException 例外, 事务将会回滚 方法 ModifyProductName 中使用的 TransException 类是一个自定义 ApplicationException 例外 代码如下 : TransException.java package com.foshanshop.ejb3; public class TransException extends Exception { public TransException (String message) { 注释定义了在例外抛出时将回滚事务 下面是 TransactionDAOBean 的接口 TransactionDAO.java package com.foshanshop.ejb3; public interface TransactionDAO { public void insertproduct(string name, Float price, boolean error); public void ModifyProductName(String newname, boolean error) throws Exception ; 下面是 TransactionDAOBean 使用的实体 Bean Product.java

138 package com.foshanshop.ejb3.bean; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; = "Products") public class Product { private int hashcode = Integer.MIN_VALUE; private Integer productid; private String name; private Float price; public Product() { public Product(String name, Float price) { this.name = name; this.price public Integer getproductid() { return productid; public void setproductid(integer productid) { this.productid = = "ProductName",nullable=false,length=50) public String getname() { return name; public void setname(string name) { this.name = public Float getprice() { return price; public void setprice(float price) {

139 this.price = price; public boolean equals (Object obj) { if (null == obj) return false; if (!(obj instanceof Product)) return false; else { Product mobj = (Product) obj; if (null == this.getproductid() null == mobj.getproductid()) return false; else return (this.getproductid().equals(mobj.getproductid())); public int hashcode () { if (Integer.MIN_VALUE == this.hashcode) { if (null == this.getproductid()) return super.hashcode(); else { String hashstr = this.getclass().getname() + ":" + this.getproductid().hashcode(); this.hashcode = hashstr.hashcode(); return this.hashcode; 下面是 Session Bean 的 JSP 客户端代码 : TransactionTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.transactiondao, javax.naming.*, java.util.*"%> <% 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 { InitialContext ctx = new InitialContext(props); TransactionDAO transactiondao = (TransactionDAO) ctx.lookup("transactiondaobean/remote"); transactiondao.insertproduct(" 电脑 ", new Float("1200"), false); transactiondao.modifyproductname(" 数码相机 ", true);

140 %> out.println(" 执行完成 "); catch (Exception e) { out.println(e.getmessage()); 本例子的 EJB 源代码在 TransactionService 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 TransactionService 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 6.11 Entity 的生命周期和状态 在 EJB3 中定义了四种 Entity 的状态 : 1. 新实体 (new) Entity 由应用产生, 和 EJB3 Persistence 运行环境没有联系, 也没有唯一的标示符 (Identity) 2. 持久化实体 (managed) 新实体和 EJB3 Persistence 运行环境产生关联 ( 通过 persist(), merge() 等方法 ), 在 EJB3 Persistence 运行环境中存在和被管理, 标志是在 EJB3 Persistence 运行环境中有一个唯一的标示 (Identity) 3. 分离的实体 (detached) Entity 有唯一标示符, 但它的标示符不被 EJB3 Persistence 运行环境管理, 同样的该 Entity 也不被 EJB3 Persistence 运行环境管理 4. 删除的实体 (removed) Entity 被 remove() 方法删除, 对应的纪录将会在当前事务提交的时候从数据库中删除 当你执行持久化方法, 如 : persist( ), merge( ), remove( ), find( ) 或 EJB QL 查询的时候, 实体的生命周期事件将会触发 例如,persist( ) 方法触发数据插入事件,merge( ) 方法触发数据更新事件,remove( ) 方法触发数据删除事件, 通过 EJB QL 查询实体会触发数据载入事件 有时实体类得到这些事件发生的通知是非常有用的, 例如, 你想创建一个日志文件, 用来记录数据库每条记录发生的操作 ( 如 : 添, 删, 载入等 ) 持久化规范允许你在实体类中实现回调方法, 当这些事件发生时将会通知你的实体对象 当然你也可以使用一个 外部类去拦截这些事件, 这个外部类称作实体监听者 注释绑定到实体 Bean 这一节将教你如何在实体类中实现生命周期回调方法及怎样实现一个能拦截实体生命周期事件的实体监听者 生命周期回调事件 如果需要在生命周期事件期间执行自定义逻辑, 请使用以下生命周期事件注释关联生命周期事件与回调方法,EJB 3.0

141 @javax.persistence.postremove 下图演示了实体生命周期事件之间的关系 事件在下列情况触发 1. 执行 EntityManager.find( ) 或 getreference( ) 方法载入一个实体后 2. 执行 EJB QL 查询过后 3.EntityManager.refresh( ) 事件在实体对象插入到数据库的过程中发生,@PrePersist 事件在调用 EntityManager.persist( ) 方法后立刻发生, 级联保存也会发生此事件, 事件的触发由更新实体引起,@PreUpdate 事件在实体的状态同步到数据库之前触 发, 事件在实体的状态同步到数据库后触发, 同步在事务提 事件的触发由删除实体引起,@ PreRemove 事件在实体从数据库删除之前触发, 即调用了 EntityManager.remove() 方法或者级联删除时发生, 事件在实体已经从数据库中删除后触发

142 事件触发的时机有点怀疑, 事件在数据真实插入进数据库后发生, 但作者测试的结果是 : 在数据还没有真实插入进数据库时, 此事件就触发了 在本书的配套例子中, 专门让当前线程睡眠 5 秒, 在 5 秒内, 因为事务还未提交 ( 事务默认在堆栈未尾提交 ), 所以数据还没有进入数据库, 事件在这之前就已经触发 事件在调用了 JDBC 相关 API 后就会触发, 不管此时的事务是否提交 如果是这样的话,@PostPersist 事件的情况一样, 事件触发的时机和文档上说的一样, 在数据从数据库中删除后触发 ( 这也不排除作者对英文文档理解有误, 欢迎指正 ) 下面我们将学习怎样实现这些生命周期事件的回调方法 在外部类中实现回调 Entity listeners( 实体监听者 ) 用作拦截实体回调事件, 注释可以把他们绑定到一个实体类 在 Entity listeners 类里, 你可以指定一个方法拦截实体的某个事件, 所指定的方法必须带有一个 Object 参数及返回值为 void, 格式如下 : void <MethodName>(Object) 通过为方法加上事件注释, 即完成特定事件与回调方法的关联 下面是一个例子 EntityListenerLogger.java package com.foshanshop.ejb3.bean.listener; import javax.persistence.postload; import javax.persistence.postpersist; import javax.persistence.postremove; import javax.persistence.postupdate; import javax.persistence.prepersist; import javax.persistence.preremove; import javax.persistence.preupdate; public class EntityListenerLogger public void postload(object entity) { System.out.println(" 载入了实体 Bean{" + entity.getclass().getname( ) + public void PreInsert(Object entity) { System.out.println(" 对实体 Bean{" + entity.getclass().getname( )+ " 调用了 EntityManager.persist() 或级联保存 public void postinsert(object entity) { System.out.println(" 在 JDBC API 层对实体 Bean{" + entity.getclass().getname( )+ " 执行了插

143 入操作, 但事务还未提交 public void PreUpdate(Object entity) { System.out.println(" 对实体 Bean{" + entity.getclass().getname( )+ " 调用了 EntityManager.merge() 或级联更新 public void PostUpdate(Object entity) { System.out.println(" 在 JDBC API 层对实体 Bean{" + entity.getclass().getname( )+ " 执行了更新操作, 但事务还未提交 public void PreRemove(Object entity) { System.out.println(" 对实体 Bean{" + entity.getclass().getname( )+ " 调用了 EntityManager.remove() 或级联删除 public void PostRemove(Object entity) { System.out.println(" 实体 Bean{" + entity.getclass().getname( )+ " 已经从数据库中删除 "); 注释可以绑定多个实体监听类, 之间用逗号分隔, 监听的顺序按照定义的先后顺序执行 EntityLifecycle.java package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.entitylisteners; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.table; = public class EntityLifecycle implements Serializable{

144 private static final long serialversionuid = L; private Integer id; private String name; public EntityLifecycle() { public EntityLifecycle(String name) { this.name public Integer getid() { return id; public void setid(integer id) { this.id = public String getname() { return name; public void setname(string name) { this.name = name; 为了使用上面的实体 Bean, 我们定义一个 Session Bean 作为他的使用者 下面是 Session Bean 的业务接口及实现类 EntityLifecycleDAO.java package com.foshanshop.ejb3; import com.foshanshop.ejb3.bean.entitylifecycle; public interface EntityLifecycleDAO { public void Persist(); public EntityLifecycle Load(); public void Update(); public void Remove(); EntityLifecycleDAOBean.java package com.foshanshop.ejb3.impl; import java.util.list;

145 import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import javax.persistence.query; import com.foshanshop.ejb3.entitylifecycledao; ({EntityLifecycleDAO.class) public class EntityLifecycleDAOBean implements EntityLifecycleDAO protected EntityManager em; public EntityLifecycle Load() { return em.find(entitylifecycle.class, 1);// 事件 public void Persist() { EntityLifecycle entitylifecycle = new EntityLifecycle(" 孙丽 "); em.persist(entitylifecycle);// 事件 // 下面让线程等待 5 秒, 在五秒时间内你可以查看数据是否已经插入进数据库 try { System.out.println("*** 当前线程睡眠 5 秒, 在五秒时间内你可以查看数据是否已经插入进数据库 ***"); Thread.sleep(5*1000); catch (InterruptedException e) { e.printstacktrace(); public void Remove() { Query query = em.createquery("from EntityLifecycle e"); List result = query.getresultlist(); if (result!=null && result.size()>1){ EntityLifecycle entitylifecycle = (EntityLifecycle)result.get(result.size()-1); em.remove(entitylifecycle);// 事件 // 下面让线程等待 5 秒, 在五秒时间内你可以查看数据是否已经删除 try { System.out.println("*** 当前线程睡眠 5 秒, 在五秒时间内你可以查看数据是否已经删除 ***"); Thread.sleep(5*1000); catch (InterruptedException e) { e.printstacktrace();

146 public void Update() { Query query = em.createquery("from EntityLifecycle e"); List result = query.getresultlist(); if (result!=null && result.size()>0){ EntityLifecycle entitylifecycle = (EntityLifecycle)result.get(result.size()-1); entitylifecycle.setname(" 张权 "); em.merge(entitylifecycle); // 事件 // 下面让线程等待 5 秒, 在五秒时间内你可以查看数据是否已经更新 try { System.out.println("*** 当前线程睡眠 5 秒, 在五秒时间内你可以查看数据是否已经更新 ***"); Thread.sleep(5*1000); catch (InterruptedException e) { e.printstacktrace(); 下面是 JSP 客端 EntityListenerTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.entitylifecycledao, com.foshanshop.ejb3.bean.entitylifecycle, 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 { out.println(" 输出信息将打印在 Jboss 控制台, 每个方法的执行都会停留 5 秒 "); out.println(", 以便你更好地观察生命周期回调方法的运行效果 "); EntityLifecycleDAO entitylifecycledao = (EntityLifecycleDAO) ctx.lookup("entitylifecycledaobean/remote");

147 %> entitylifecycledao.persist(); // 添加测试数据 entitylifecycledao.load(); // 载入数据 entitylifecycledao.update(); // 更新数据 entitylifecycledao.remove(); // 删除最后一条数据 catch (Exception e) { out.println(e.getmessage()); 本例子的 EJB 源代码在 EntityListeners 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 EntityListeners 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 在 Entity 类中实现回调 除了外部类可以实现生命周期事件的回调, 你也可以把回调方法写在 Entity 类中 要注意 : 直接写在 Entity 类中的回调方法不需带任何参数, 格式如下 : void <MethodName>() = "EntityLifecycle") public class EntityLifecycle implements public void postload() { System.out.println(" 载入了实体 Bean{" + this.getclass().getname( ) + public void PreInsert() { System.out.println(" 对实体 Bean{" + this.getclass().getname( )+ " 调用了 EntityManager.persist() 或级联保存 public void postinsert() { System.out.println(" 在 JDBC API 层对实体 Bean{" + this.getclass().getname( )+ " 执行了插入操作, 但事务还未提交 ");

148 @PreUpdate public void PreUpdate() { System.out.println(" 对实体 Bean{" + this.getclass().getname( )+ " 调用了 EntityManager.merge() 或级联更新 public void PostUpdate() { System.out.println(" 在 JDBC API 层对实体 Bean{" + this.getclass().getname( )+ " 执行了更新操作, 但事务还未提交 public void PreRemove() { System.out.println(" 对实体 Bean{" + this.getclass().getname( )+ " 调用了 EntityManager.remove() 或级联删除 public void PostRemove() { System.out.println(" 实体 Bean{" + this.getclass().getname( )+ " 已经从数据库中删除 "); 当一个生命周期事件发生时, 将会调用与该事件关联的回调方法 6.12 复合主键 (Composite Primary Key) 当我们需要使用多个属性变量 ( 表中的多列 ) 联合起来作为主键, 我们需要使用复合主键 复合主键要求我们编写一个复合主键类 ( Composite Primary Key Class ) 复合主键类需要符合以下一些要求: 复合主键类必须是 public 和具备一个没有参数的构造函数 复合主键类的每个属性变量必须有 getter/setter, 如果没有, 每个属性变量则必须是 public 或者 protected 复合主键类必须实现 java.io.serializable 复合主键类必须实现 equals() 和 hashcode() 方法 复合主键类中的主键属性变量的名字必须和对应的 Entity 中主键属性变量的名字相同 一旦主键值设定后, 不要修改主键属性变量的值本节以航线为例, 介绍复合主键的开发过程, 航线以出发地及到达地作为联合主键, 航线与航班存在一对多的关联关系, 下面是他们的数据库表 airline 字段名称字段类型属性描述 leavecity ( 主键 ) char(3) not null 出发地 arrivecity ( 主键 ) char(3) not null 到达地 onoff tinyint(1) null 航线打开及关闭标志 flight

149 字段名称 字段类型属性 描述 Id ( 主键 ) int(11) not null 流水号 flightno varchar(10) not null 航班号 arrivetime varchar(10) null 到达时间 leavetime varchar(10) null 起飞时间 Leave_City char(3) not null 出发地 Arrive_City char(3) not null 到达地 按照复合主键类的要求, 我们编写一个复合主键类 AirtLinePK.java, 代码如下 : //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.column; public class AirtLinePK implements Serializable { private String leavecity; private String arrivecity; public AirtLinePK(){ public AirtLinePK(String leavecity, String arrivecity) { this.leavecity = leavecity; this.arrivecity = public String getleavecity() { return leavecity; public void setleavecity(string leavecity) { this.leavecity = public String getarrivecity() { return arrivecity; public void setarrivecity(string arrivecity) { this.arrivecity = arrivecity;

150 public boolean equals(object o) { if (this == o) return true; if (!(o instanceof AirtLinePK)) return false; final AirtLinePK airtlinepk = (AirtLinePK) o; if (!leavecity.equals(airtlinepk.getleavecity())) return false; if (!arrivecity.equals(airtlinepk.getarrivecity())) return false; return true; public int hashcode() { int result; result = leavecity.hashcode(); result = 29 * result + arrivecity.hashcode(); return result; 复合主键使用一个可嵌入的类作为主键表示,@Embeddable 注释指明这是一个可嵌入的类 下面 AirLine.java 用复合主键类 AirtLinePK 作为其主键 AirLine.java //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import java.util.hashset; import java.util.set; import javax.persistence.cascadetype; import javax.persistence.entity; import javax.persistence.fetchtype; import javax.persistence.id; import javax.persistence.onetomany; import javax.persistence.orderby; @Table(name = "AirLine") public class AirLine implements Serializable { private AirtLinePK id; private Boolean onoff; private Set<Flight> flights = new HashSet<Flight>(); public AirLine(){

151 public AirLine(AirtLinePK id, Boolean onoff){ this.id = id; this.onoff = public AirtLinePK getid() { return id; public void setid(airtlinepk id) { this.id = id; public Boolean getonoff() { return onoff; public void setonoff(boolean onoff) { this.onoff = = CascadeType.ALL, fetch = = "id ASC") public Set<Flight> getflights() { return flights; public void setflights(set<flight> flights) { this.flights = flights; public void addflight(flight flight) { if (!this.flights.contains(flight)) { this.flights.add(flight); flight.setairline(this); public void removeflight(flight flight) { flight.setairline(null); this.flights.remove(flight);

152 Flight.java //author:lihuoming package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.cascadetype; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.joincolumn; import javax.persistence.joincolumns; import javax.persistence.manytoone; @Table(name = "Flight") public class Flight implements Serializable { private Integer id; private String flightno;// 航班号 private String leavetime;// 起飞时间 private String arrivetime;// 到达时间 private AirLine airline; public Flight(){ public Flight(String flightno, String leavetime, String arrivetime) { this.flightno = flightno; this.leavetime = leavetime; this.arrivetime public Integer getid() { return id; public void setid(integer id) { this.id = public String getflightno() {

153 return flightno; public void setflightno(string flightno) { this.flightno = public String getarrivetime() { return arrivetime; public void setarrivetime(string arrivetime) { this.arrivetime = public String getleavetime() { return leavetime; public void setleavetime(string leavetime) { this.leavetime referencedcolumnname = "leavecity", referencedcolumnname = "arrivecity", nullable=false) ) public AirLine getairline() { return airline; public void setairline(airline airline) { this.airline = airline; Flight 与 AirLine 存在多对一关系,Flight 含有两个外键指向 AirLine, 注释定义多个 JoinColumn 的属性, Flight 对应表中的 Leave_City 列作为外键指向 AirLine 对应表中的 leavecity 列, Flight 对应表中 Arrive_City 列指向 AirLine 对应表中的 arrivecity 列 为了使用上面的实体 Bean, 我们定义一个 Session Bean 作为他的使用者 下面是 Session Bean 的业务接口, 他定 义了两个业务方法 insertairline 和 getairlinebyid, 两个方法的业务功能是 :

154 insertairline 添加一条航线 ( 含有三个航班 ) 进数据库 getairlinebyid 获取指定出发地及到达地的航线信息 下面是 Session Bean 的业务接口及实现类 AirLineDAO.java //author:lihuoming package com.foshanshop.ejb3; import com.foshanshop.ejb3.bean.airline; public interface AirLineDAO { public void insertairline(); public AirLine getairlinebyid(string leavecity, String arrivecity); AirLineDAOBean.java //author:lihuoming package com.foshanshop.ejb3.impl; import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import javax.persistence.query; import com.foshanshop.ejb3.airlinedao; import com.foshanshop.ejb3.bean.airline; import com.foshanshop.ejb3.bean.airtlinepk; ({AirLineDAO.class) public class AirLineDAOBean implements AirLineDAO protected EntityManager em; public void insertairline() { Query query = em.createquery("select count(*) from AirLine a where a.id.leavecity =?1 and a.id.arrivecity=?2"); query.setparameter(1, "PEK"); query.setparameter(2, "CAN"); int result = Integer.parseInt(query.getSingleResult().toString()); if (result==0){ AirLine airline = new AirLine(new AirtLinePK("PEK","CAN"), true); //PEK 为首都机场三字码,CAN 为广州白云机场三字码 airline.addflight(new Flight("CA1321","08:45","11:50")); airline.addflight(new Flight("CZ3102","12:05","15:05")); airline.addflight(new Flight("HU7801","15:05","17:45")); em.persist(airline);

155 public AirLine getairlinebyid(string leavecity, String arrivecity) { AirLine airline = em.find(airline.class, new AirtLinePK(leavecity,arrivecity)); airline.getflights().size(); // 因为是延迟加载, 通过执行 size() 这种方式获取航线下的所有航班 return airline; 下面是 Session Bean 的 JSP 客户端代码 : CompositePKTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.airlinedao, com.foshanshop.ejb3.bean.*, javax.naming.*, java.util.*"%> <% 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 { AirLineDAO airlinedao = (AirLineDAO) ctx.lookup("airlinedaobean/remote"); airlinedao.insertairline(); AirLine airline = airlinedao.getairlinebyid("pek","can"); out.println(" 航线 :"+ airline.getid().getleavecity() +"--"+ airline.getid().getarrivecity() +"<br>"); out.println("============== 存在以下航班 =================<br>"); if (airline!=null){ Iterator iterator = airline.getflights().iterator(); while (iterator.hasnext()){ Flight flight = (Flight) iterator.next(); out.println(" 航班 :"+ flight.getflightno() +"<br>"); else{ out.println(" 没有找到相关航线 ");

156 %> catch (Exception e) { out.println(e.getmessage()); 本例子的 EJB 源代码在 CompositePK 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 CompositePK 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 6.13 实体继承 在本章我们定义几个类, 用来完成实体继承的介绍 三个类分别是 :Vehicle( 交通工具 ),Car( 汽车 ),Camion ( 卡车 ), 他们的继承关系如下 : Vehicle Car Camion 因为关系数据库的表之间不存在继承关系,Entity 提供三种基本的继承映射策略 : 每个类分层结构一张表 (table per class hierarchy) 每个子类一张表 (table per subclass) 每个具体类一张表 (table per concrete class) 三种继承映射策略的特性 继承策略 多态多 多态一 多态一对 多态多对 多态 find() 或 多态查询 多态连接 外连接 (Inheritanc 对一 对一 多 多 getreference() (join) (Outer e strategy) join) 抓 取 每个类分 <many-to <one-to <one-to- <many-to em.find(vehicle.cl from ower from Order 支持 层结构一 -one> -one> many> -many> ass, id) ow o join 张表 (table o.ower ow per class hierarchy) 每个子类 <many-to <one-to <one-to- <many-to em.find(vehicle.cl from ower from Order 支持 一张表 -one> -one> many> -many> ass, id) ow o join (table per o.ower ow

157 subclass) 每个具体 <many-to <one-to <one-to- <many-to em.find(vehicle.cl from ower from Order 支持 类一张表 -one> -one> many> -many> ass, id) ow o join (table per ( 仅对于 o.ower ow concrete inverse=" class) true" 的情 况 ) 每种映射策略都有各自的优缺点, 下面分别介绍这三种策略的使用 每个类分层结构一张表 (table per class hierarchy) 这种映射方式只需为基类 Vehicle 创建一个表 (Vehicle_Hierarchy) 即可 在表中不仅提供 Vehicle 所有属性对应的字段, 还要提供所有子类属性对应的字段, 此外还需要一个字段用于区分子类的具体类型 Vehicle_Hierarchy 表字段名称字段类型属性描述 id ( 主键 ) Int(11) not null ID speed Smallint(6) null 速度 ( 基类 Vehicle 的属性 ) engine Varchar(30) null 发动机 ( 子类 Car 的属性 ) container Varchar(30) null 集装箱 ( 子类 Camion 的属性 ) Discriminator Varchar(30) null 鉴别字段, 用于区分各个类要使用每个类分层结构一张表 (table per class hierarchy) 策略, 注释的 strategy 属性设置为 InheritanceType.SINGLE_TABLE 除非你要改变子类的映射策略, 注释只能放在继承层次的基类 通过鉴别字段的值, 持久化引掣可以区分出各个类, 并且知道每个类对应那些字段 注释进行定义,name 属性定义鉴别字段的列名,discriminatorType 属性定义鉴别字段的类型 ( 可选值有 :String, Char, Integer), 如果鉴别字段的类型为 String 或 Char, 可以用 length 注释为继承关系中的每个类定义鉴别值, 如果不指定鉴别值, 默认采用类名 Vehicle.java package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.column; import javax.persistence.discriminatorcolumn; import javax.persistence.discriminatortype; import javax.persistence.discriminatorvalue; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.inheritance; import javax.persistence.inheritancetype;

158 @Table(name="Vehicle_Hierarchy") discriminatortype = DiscriminatorType.STRING, public class Vehicle implements Serializable{ private Long id; private Short @Column(columnDefinition="integer")// 指定使用适配 Integer 长度的数据类型 public Long getid() { return id; public void setid(long id) { this.id = id; public Short getspeed() { return speed; public void setspeed(short speed) { this.speed = speed; Car.java ( Car 继承 Vehicle, 并有自己的属性 engine) package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.column; import javax.persistence.discriminatorcolumn; import javax.persistence.discriminatortype; import javax.persistence.discriminatorvalue; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.inheritance; import javax.persistence.inheritancetype; import javax.persistence.table; package com.foshanshop.ejb3.bean;

159 import javax.persistence.column; import javax.persistence.discriminatorvalue; @DiscriminatorValue("Car") public class Car extends Vehicle{ private String engine;// public String getengine() { return engine; public void setengine(string engine) { this.engine = engine; Camion.java (Camion 继承 Car, 并有自己的属性 container) package com.foshanshop.ejb3.bean; import javax.persistence.column; import javax.persistence.discriminatorvalue; @DiscriminatorValue("Camion") public class Camion extends Car{ private String container;// public String getcontainer() { return container; public void setcontainer(string container) { this.container = container; 可以看出, 每个子类没有单独的映射, 在数据库中没有对应的表存在 而只有一个记录所有自身属性和子类所有 属性的表, 在基类为 Vehicle 的时候,Discriminator 字段的值将为 Vehicle, 在子类为 Car 的时候,Discriminator 字

160 段的值将为 Car, 子类为 Camion 的时候,Discriminator 字段的值将为 Camion 那么, 如果业务逻辑要求 Car 对 象的 engine 属性不允许为 null, 显然无法在 Vehicle_Hierarchy 表中为 engine 字段定义 not null 约束, 可见这种映 射方式无法保证关系数据模型的数据完整性 为了使用上面的实体 Bean, 我们定义一个 Session Bean 作为他的使用者 下面是 Session Bean 的业务接口, 他定义了五个业务方法 initializedata,getlastvehicle,getlastcar,getlastcamion 和 deletevehicle, 五个方法的业务功能是 : initializedata 添加一些测试数据进数据库 getlastvehicle 获取最后一条 Vehicle 记录 getlastcar 获取最后一条 Car 记录 getlastcamion 获取最后一条 Camion 记录 deletevehicle 删除所有 Vehicle 对应的记录, 执行该操作除了会删除自身对应的记录之外, 还会删除所有继承 Vehicle 的记录, 因为他是继承树中的根类, 所以相当于清除整个表的数据 下面是 Session Bean 的实现类及业务接口 EntityInheritanceDAOBean.java package com.foshanshop.ejb3.impl; import java.util.list; import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import javax.persistence.query; import com.foshanshop.ejb3.entityinheritancedao; import com.foshanshop.ejb3.bean.car; import com.foshanshop.ejb3.bean.vehicle; ({EntityInheritanceDAO.class) public class EntityInheritanceDAOBean implements EntityInheritanceDAO protected EntityManager em; public void initializedata(){ // 添加 Vehicle Vehicle vehicle = new Vehicle(); vehicle.setspeed((short)100); em.persist(vehicle); // 添加 Car Car car = new Car(); car.setspeed((short)300); car.setengine("a 发动机 "); em.persist(car);

161 // 添加 Camion Camion camion = new Camion(); camion.setspeed((short)200); camion.setengine("b 发动机 "); camion.setcontainer("2 吨集装箱 "); em.persist(camion); public Vehicle getlastvehicle() { // 查询所有 Vehicle 时, 因为他是最继承树中的根, 查询结果会得到所有继承于 Vehicle 类的记录 // 转绎成的 SQL 片断 :select * from Vehicle_Hierarchy Query query = em.createquery("from Vehicle v"); List result = query.getresultlist(); if (result!=null && result.size()>0) return (Vehicle)result.get(result.size()-1); return null; public Car getlastcar() { // 查询所有 Car 时, 除了得到 Car 类的记录, 也会得到所有继承于 Car 类的记录 // 转绎成的 SQL 片断 :where Discriminator in ('Car', 'Camion') Query query = em.createquery("from Car c"); List result = query.getresultlist(); if (result!=null && result.size()>0) return (Car)result.get(result.size()-1); return null; public Camion getlastcamion() { Query query = em.createquery("from Camion c"); List result = query.getresultlist(); if (result!=null && result.size()>0) return (Camion)result.get(result.size()-1); return null; public void deletevehicle() { // 执行该操作会删除自身对应记录, 还会删除所有继承 Vehicle 的记录, // 因为他是最继承树中的根, 就相当于清除整个表的数据 Query query = em.createquery("delete from Vehicle v"); query.executeupdate();

162 EntityInheritanceDAO.java 业务接口 package com.foshanshop.ejb3; import com.foshanshop.ejb3.bean.camion; import com.foshanshop.ejb3.bean.car; import com.foshanshop.ejb3.bean.vehicle; public interface EntityInheritanceDAO { public void initializedata(); public Vehicle getlastvehicle(); public Car getlastcar(); public Camion getlastcamion(); public void deletevehicle(); 下面是 Session Bean 的 JSP 客户端代码 : EntityInheritanceTest.jsp <%@ page contenttype="text/html; charset=gbk"%> <%@ page import="com.foshanshop.ejb3.entityinheritancedao, com.foshanshop.ejb3.bean.*, 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 { EntityInheritanceDAO entityinheritancedao = (EntityInheritanceDAO) ctx.lookup("entityinheritancedaobean/remote"); entityinheritancedao.initializedata(); Vehicle vehicle = entityinheritancedao.getlastvehicle(); // 取最后一个 Vehicle out.println("vehicle 类 : 速度 ="); out.println(vehicle.getspeed()); Car car = entityinheritancedao.getlastcar(); // 取最后一个 Car out.println("<br>car 类 : 速度 ="); out.println(car.getspeed()+"; 发动机 ="+ car.getengine()); Camion camion = entityinheritancedao.getlastcamion(); // 取最后一个 Camion out.println("<br>camion 类 : 速度 ="); out.println(camion.getspeed()+ "; 发动机 ="+ camion.getengine()+ "; 集装箱 ="+ camion.getcontainer());

163 %> /* 下面语句会删除所有记录 entityinheritancedao.deletevehicle(); */ catch (Exception e) { out.println(e.getmessage()); 该策略的优点 : SINGLE_TABLE 映射策略在所有继承策略中是最简单的, 同时也是执行效率最高的 他仅需对一个表进行管理及操作, 持久化引掣在载入 entiry 或多态连接时不需要进行任何的关联, 联合或子查询, 因为所有数据都存储在一个表 该策略的缺点 : 这种策略最大的一个缺点是需要对关系数据模型进行非常规设计, 在数据库表中加入额外的区分各个子类的字段, 此外, 不能为所有子类的属性对应的字段定义 not null 约束, 此策略的关系数据模型完全不支持对象的继承关系 选择原则 : 查询性能要求高, 子类属性不是非常多时, 优先选择该策略 本例子的 EJB 源代码在 EntityInheritance 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 EntityInheritance 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 每个子类一张表 (table per subclass) 这种映射方式为每个类创建一个表 在每个类对应的表中只需包含和这个类本身的属性对应的字段, 子类对应的 表参照父类对应的表 Vehicle 表 字段名称 字段类型属性 描述 id ( 主键 ) Int(11) not null ID speed Smallint(6) null 速度 ( 基类 Vehicle 的属性 ) Car 表字段名称 字段类型属性 描述 CarID ( 主键 ) Int(11) not null Vehicle 的外键 engine Varchar(30) null 发动机 ( 子类 Car 的属性 ) Camion 表字段名称 字段类型属性 描述 CamionID ( 主键 ) Int(11) not null Car 的外键 container Varchar(30) null 集装箱 ( 子类 Camion 的属性 ) 要使用每个子类一张表 (table per subclass) 策略, 注释的 strategy 属性设置为

164 InheritanceType.JOINED Vehicle.java package com.foshanshop.ejb3.bean; import java.io.serializable; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.generatedvalue; import javax.persistence.id; import javax.persistence.inheritance; import javax.persistence.inheritancetype; public class Vehicle implements Serializable{ private Long id; private Short @Column(columnDefinition="integer") public Long getid() { return id; public void setid(long id) { this.id = id; public Short getspeed() { return speed; public void setspeed(short speed) { this.speed = speed; Car.java package com.foshanshop.ejb3.bean; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.primarykeyjoincolumn;

165 把主键对应的列名更改为 CarID public class Car extends Vehicle{ private String engine;// public String getengine() { return engine; public void setengine(string engine) { this.engine = engine; Camion.java package com.foshanshop.ejb3.bean; import javax.persistence.column; import javax.persistence.entity; import javax.persistence.primarykeyjoincolumn; 把主键对应的列名更改为 CamionID public class Camion extends Car{ private String container;// public String getcontainer() { return container; public void setcontainer(string container) { this.container = container; Session Bean 及 JSP 客户端我们使用上节的文件, 这里不再列出

166 该策略的优点 : 这种映射方式支持多态关联和多态查询, 而且符合关系数据模型的常规设计规则 在这种策略中你可以对子类的属性对应的字段定义 not null 约束 该策略的缺点 : 它的查询性能不如上面介绍的映射策略 在这种映射策略下, 必须通过表的内连接或左外连接来实现多态查询和多态关联 选择原则 : 子类属性非常多, 需要对子类某些属性对应的字段进行 not null 约束, 且对性能要求不是很严格时, 优先选择该策略 本例子的 EJB 源代码在 EntityInheritanceSubclass 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 EntityInheritanceSubclass 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端 每个具体类一张表 (table per concrete class) 这种映射方式为每个类创建一个表 在每个类对应的表中包含和这个类所有属性 ( 包括从超类继承的属性 ) 对应 的字段 Vehicle 表 字段名称 字段类型属性 描述 id ( 主键 ) Int(11) not null ID speed Smallint(6) null 速度 ( 基类 Vehicle 的属性 ) Car 表字段名称 字段类型属性 描述 id ( 主键 ) Int(11) not null ID speed Smallint(6) null 速度 ( 基类 Vehicle 的属性 ) engine Varchar(30) null 发动机 ( 子类 Car 的属性 ) Camion 表字段名称 字段类型属性 描述 id ( 主键 ) Int(11) not null ID speed Smallint(6) null 速度 ( 基类 Vehicle 的属性 ) engine Varchar(30) null 发动机 ( 子类 Car 的属性 ) container Varchar(30) null 集装箱 ( 子类 Camion 的属性 ) 要使用每个具体类一张表 (table per concrete class) 策略, 注释的 strategy 属性 设置为 InheritanceType.TABLE_PER_CLASS Vehicle.java package com.foshanshop.ejb3.bean; import java.io.serializable;

167 import javax.persistence.column; import javax.persistence.entity; import javax.persistence.id; import javax.persistence.inheritance; import javax.persistence.inheritancetype; public class Vehicle implements Serializable{ private Long id; private Short public Long getid() { return id; public void setid(long id) { this.id = id; public Short getspeed() { return speed; public void setspeed(short speed) { this.speed = speed; 注意 : 一旦使用这种策略就意味着你不能使用 AUTO generator 和 IDENTITY generator, 即主键值不能采用数据库自动生成. Car.java package com.foshanshop.ejb3.bean; import javax.persistence.column; import javax.persistence.entity; @Table(name="Car") public class Car extends Vehicle{

168 private String engine;// public String getengine() { return engine; public void setengine(string engine) { this.engine = engine; Camion.java package com.foshanshop.ejb3.bean; import javax.persistence.column; import javax.persistence.entity; @Table(name="Camion") public class Camion extends Car{ private String container;// public String getcontainer() { return container; public void setcontainer(string container) { this.container = container; Session Bean 与上节的代码有些改动, 代码如下 : package com.foshanshop.ejb3.impl; import java.util.list; import javax.ejb.remote; import javax.ejb.stateless; import javax.persistence.entitymanager; import javax.persistence.persistencecontext; import javax.persistence.query; import com.foshanshop.ejb3.entityinheritancedao; import com.foshanshop.ejb3.bean.car;

169 import com.foshanshop.ejb3.bean.vehicle; ({EntityInheritanceDAO.class) public class EntityInheritanceDAOBean implements EntityInheritanceDAO protected EntityManager em; public void initializedata(){ // 添加 Vehicle Vehicle vehicle = new Vehicle(); vehicle.setid((long)1); vehicle.setspeed((short)100); em.persist(vehicle); // 添加 Car Car car = new Car(); car.setid((long)2); car.setspeed((short)300); car.setengine("a 发动机 "); em.persist(car); // 添加 Camion Camion camion = new Camion(); camion.setid((long)3); camion.setspeed((short)200); camion.setengine("b 发动机 "); camion.setcontainer("2 吨集装箱 "); em.persist(camion); public Vehicle getlastvehicle() { // 查询所有 Vehicle 时, 因为他是最继承树中的根, 查询结果会得到所有继承于 Vehicle 类的记录 // 转绎成的 SQL 片断 :select * from Vehicle_Hierarchy Query query = em.createquery("from Vehicle v"); List result = query.getresultlist(); if (result!=null && result.size()>0) return (Vehicle)result.get(result.size()-1); return null; public Car getlastcar() { // 查询所有 Car 时, 除了得到 Car 类的记录, 也会得到所有继承于 Car 类的记录 // 构造的 SQL Where 部分 :where Discriminator in ('Car', 'Camion') Query query = em.createquery("from Car c");

170 List result = query.getresultlist(); if (result!=null && result.size()>0) return (Car)result.get(result.size()-1); return null; public Camion getlastcamion() { Query query = em.createquery("from Camion c"); List result = query.getresultlist(); if (result!=null && result.size()>0) return (Camion)result.get(result.size()-1); return null; public void deletevehicle() { // 执行该操作会删除自身对应记录, 还会删除所有继承 Vehicle 的记录, // 因为他是最继承树中的根, 就相当于清除整个表的数据 Query query = em.createquery("delete from Vehicle v"); query.executeupdate(); Session Bean 的接口及 JSP 客户端可以使用上节的文件, 这里不再列出 该策略的优点 : 在这种策略中你可以对子类的属性对应的字段定义 not null 约束 该策略的缺点 : 不符合关系数据模型的常规设计规则, 每个表中都存在属于基类的多余的字段 同时, 为了支持策略的映射, 持久化管理者需要决定使用什么方法, 一种方法是在 entity 载入或多态关联时, 容器使用多次查询去实现, 这种方法需要对数据库做几次来往查询, 非常影响执行效率 另一种方法是容器通过使用 SQL UNIOU 查询来实现这种策略 选择原则 : 除非你的现实情况必须使用这种策略, 一般情况下不要选择 本例子的 EJB 源代码在 EntityInheritanceConcreteclass 文件夹 ( 源代码下载 : 项目中使用到的类库在上级目录 lib 文件夹下 要恢复 EntityInheritanceConcreteclass 项目的开发环境请参考第三章 如何恢复本书配套例子的开发环境, 要发布本例子 EJB ( 确保配置了环境变量 JBOSS_HOME 及启动了 Jboss), 你可以执行 Ant 的 deploy 任务 例子使用的数据源配置文件是 mysql-ds.xml, 你可以在下载的文件中找到 数据库名为 foshanshop 本例子的客户端代码在 EJBTest 文件夹, 要发布客户端应用, 你可以执行 Ant 的 deploy 任务 通过 访问客户端

171 第七章 Web 服务 (Web Service) 7.1 Web Service 的创建 在本章节, 我们将创建一个基于 JSR-181 规范的 Web Service 及其对应的客户端 开发一个 JSR-181 POJO Endpoint 的 Web Service 应遵守下面几个步骤 : 1> 建立一个 POJO endpoint 2> 把 endpoint 定义成一个 servlet 3> 把 endpoint 打包成一个 Web 应用 (war 文件 ) 下面让我们看看如何建立一个 POJO endpoint package com.foshanshop.ws; import javax.jws.webmethod; import javax.jws.webservice; import = "HelloWorld", targetnamespace = " servicename = = SOAPBinding.Style.RPC) public class HelloWorldService public String SayHello(String name) { return name+ " 说 : 这是我的第一个 web 服务 这个注释放置在 Java 类的前面, 声明这个类的部分方法可以被发布为 Web 的属性用于设置 Web 服务被发布时的一些配置信息, 常用的属性说明如下 1. name Web 服务的名字,WSDL 中 wsdl:porttype 元素的 name 属性和它保持一致, 默认是 Java 类或者接口的名字 2. servicename Web 服务的服务名,WSDL 中 wsdl:service 元素的 name 属性和它保持一致, 默认是 Java 类的名字 + Service 3. targetnamespace WSDL 文件所使用的 namespace, 该 Web 服务中所产生的其他 XML 文档同样采用这个作为 表示这个服务可以映射到一个 SOAP 消息中 Style 用于指定 SOAP 这个注释放在需要被发布成 Web 服务的方法前面 下面把 POJO endpoint 定义成一个 servlet. Web.xml <web-app xmlns=" xmlns:xsi=" xsi:schemalocation="

172 version="2.4"> <servlet> <servlet-name>helloworldservice</servlet-name> <servlet-class>com.foshanshop.ws.helloworldservice</servlet-class> </servlet> <servlet-mapping> <servlet-name>helloworldservice</servlet-name> <url-pattern>/helloworldservice/*</url-pattern> </servlet-mapping> </web-app> 把 endpoint 打包成一个 web 应用 (*.war), 下面是 Ant 配置文件 build.xml 的片断 : <target name="war" depends="compile" description=" 创建 WS 发布包 "> <war warfile="${app.dir/services.war" webxml="${app.dir/web-inf/web.xml"> <classes dir="${build.classes.dir"> <include name="com/foshanshop/ws/helloworldservice.class" /> </classes> </war> </target> 注意 :POJO endpoint 文件及 web.xml 都是必须的 经过上面的步骤, 完成了一个 Web Service 的开发, 下面我们通过 Jboss 管理平台查看刚才发布的 Web Service, 我们可以输入 进入 JbossWS 的查看界面, 如下 : 点击 view 连接后, 可以查看已经发布的 web services, 如下图 :

173 在上图中你可以点击 ServiceEndpointAddress 下的路径 访问他的 wsdl 描述,wsdl 描述文件在应用发布时由容器自动生成, 输出如下 : <definitions name='helloworldservice' targetnamespace=' xmlns=' xmlns:soap=' xmlns:tns=' xmlns:xsd=' <types></types> <message name='helloworld_sayhello'> <part name='string_1' type='xsd:string'/> </message> <message name='helloworld_sayhelloresponse'> <part name='result' type='xsd:string'/> </message> <porttype name='helloworld'> <operation name='sayhello' parameterorder='string_1'> <input message='tns:helloworld_sayhello'/> <output message='tns:helloworld_sayhelloresponse'/> </operation> </porttype> <binding name='helloworldbinding' type='tns:helloworld'> <soap:binding style='rpc' transport=' <operation name='sayhello'> <soap:operation soapaction=''/> <input> <soap:body namespace=' use='literal'/> </input> <output> <soap:body namespace=' use='literal'/> </output> </operation> </binding> <service name='helloworldservice'> <port binding='tns:helloworldbinding' name='helloworldport'>