使用 EJB QL 将 finder 方法添加至 EJB 2.x bean

您可以将“find”或“ejbSelect”finder 方法添加至 EJB 2.x CMP bean 的 home 接口。这些 finder 方法使用 EJB 查询语言。向导会指导您完成将新的或现有的 finder 添加至 bean 的步骤。

EJB 查询语言(EJB QL)语法基于 SQL 并允许对企业 bean 的持久属性以及相关联的 bean 属性进行搜索。查询语言与至关系数据存储的 bean 映射无关,且它是可移植的。在部署时,查询语言根据 bean 的模式映射而被编译成 SQL。

有关 EJB QL 的详细信息,请转至 WebSphere Application Server 信息中心并搜索关键字“EJB QL”。

要将 EJB QL 查询添加至 EJB 2.x 企业 bean:

  1. 在 J2EE 透视图的“项目资源管理器”视图中,右键单击 EJB 项目的部署描述符,并选择打开方式 > 部署描述符编辑器以打开部署描述符编辑器。
  2. 在编辑器的 Bean 页上,选择想要添加 finder 方法的 EJB 2.x CMP 实体 bean。
  3. 滚动至“查询”部分,然后单击添加。“添加 finder 描述符”向导打开。
  4. 选择下列其中一个选项:
    • 新的 - 创建新的 finder 方法。
    • 现有 - 使用现有的 finder 方法。
  5. 从下列选项中选择一个方法类型:
    • find 方法 - finder 方法是在实体 bean 的 home 接口(本地和/或远程)中定义的。finder 方法的返回和结果取决于定义它的位置。
    • ejbSelect 方法 - ejbSelect 方法是不直接通过客户机视图显示的特殊查询方法。ejbSelect 方法通常用来选择实体的持久状态,或者选择与为其定义查询的实体 bean 相关的实体。
  6. 如果要使用现有 finder,则从发现的 finder 列表中进行选择,然后单击完成
  7. 如果要定义新的 finder,则完成下列步骤。
  8. 对于 finder 的类型,至少选择下列其中一个复选框:
    • 本地 - 选择此项以将方法声明添加至本地 home 接口以供本地方法调用。
    • 本地 - 选择此项以将方法声明添加至远程 home 接口以供远程方法调用。
    可以同时选择这两个复选框以将 finder 同时包括在远程接口和本地接口中。仅当 bean 包括各自的接口时复选框才可用。
  9. 可选: 如果要创建 ejbSelect 方法,则可以选择返回远程实体复选框。此选项指示您希望返回远程引用。此选项仅对于此方法类型可用。
  10. 名称字段中,输入新的查询的名称。查询方法名称必须以指示选择的类型的字母开头,例如,findejbSelect
  11. 可选: 单击添加以添加方法参数。
  12. 返回类型下拉列表中,选择 finder 方法将返回的类型。
  13. 单击下一步Bean抽象模式名查询方法名字段都是只读的。
  14. 可选: 描述文本区域中输入方法的描述。
  15. 可选: 为了帮助您生成 EJB 查询,可以从选择样本查询下拉列表中的样本查询着手。
  16. 查询语句文本区域中输入或修改查询。
  17. 单击完成
<query></query> 元素添加至 bean 的部署描述符。将实际查询添加至 <ejb-ql></ejb-ql> 元素。将方法声明添加至 home 接口(视您的选择而定,可为本地和/或远程)。
要编辑或除去查询,选择“查询”部分中的查询并单击编辑除去
相关概念
CMP 实体 bean 的 finder 方法
使用条款 | 反馈
(C) Copyright IBM Corporation 1999, 2005. All Rights Reserved.