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