使用 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 方法

反馈