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