定义 Finder 方法
另请参见
finder 方法是一种在 EJB 2.1 实体 Bean 中使用的查询方法。(select 方法是另一种查询方法。)finder 方法是实体 Bean 所特有的,因为实体 Bean 表示数据库中可以识别和找到的数据。会话 Bean 不表示数据库数据,因此没有可以找到的数据。
为实体 bean 定义 finder 方法:
- 在源代码编辑器中打开 Bean 类。
- 在源代码编辑器中的任意位置单击鼠标右键,然后选择“插入代码”>“添加 Finder 方法”。
- 在“添加 Finder 方法”对话框中定义方法签名:
- 将文本添加到方法的基本 findBy 名称中。
- 指定方法需要的任何参数。
- 指定要添加方法的接口(远程和/或本地)。
- 指定方法的返回基数。此设置应该与数据库中语句的返回基数相匹配。如果选择“一”,则该语句返回 Bean 的接口。如果选择“多”,则该语句返回 java.util.Collection 对象。
- 如果 Bean 使用容器管理持久性 (Container-Managed Persistence, CMP),请输入 EJB QL 语句,方法将使用该语句来查找它要返回的一个或多个企业 Bean。
- 单击“确定”创建方法。
IDE 将方法签名添加到 Bean 的接口中,然后在常规部署描述符中注册该方法。
- 如果实体 Bean 使用 CMP,则方法定义已经完成。容器从 home 接口或本地 home 接口中的签名实现 finder 方法,因此方法仅出现在 home 接口和本地 home 接口中。
- 如果实体 Bean 使用 Bean 管理持久性 (Bean-Managed Persistence, BMP),则 IDE 将空的 ejbFindyourname 方法添加到 Bean 类中,以便可以实现该方法。您必须自己实现 ejbFindyourname 方法。
查看、编辑或删除现有的 finder 方法:
- 在“项目”窗口中,展开 EJB 模块项目的“配置文件”节点。
- 双击 "ejb-jar.xml"。将在“常规”视图中打开图形编辑器。
- 单击 "XML" 标签以在 XML 编辑器中进行更改。
- 如果对 ejb-jar.xml 进行更改,则还需要在 Bean 源代码中进行相应的更改。
注意:
- 在 IDE 将 finder 方法添加到实体 Bean 中时,它不会保存 Bean 类或 Bean 接口。仅当编译或保存项目时,才会将更改保存到硬盘。
- 要从企业 Bean 中完全删除 finder 方法,请执行以下操作:
- 从 Bean 的源代码中删除该方法。
- 从 ejb-jar.xml 中删除 finder 查询。
- 另请参见
- 关于实体 Bean
- 定义 Select 方法
- 定义 Business 方法
- 定义 CMP 字段
- 将 EJB QL 添加到 Finder 或 Select 方法
- 通过数据库生成 CMP 实体 Bean
法律声明