JBuilder9+Weblogic7实战篇
ENTITY BEAN的运用（二）
作者：黄 凯
E_mail：hk_sz@163.com
五、使用EJB QL开发查询
5.1 什么是EJB QL
在关系数据库的操作中查询是经常使用的，主要是通过select语句完成的。Entity Bean作为代表数据库中数据的持久性组件也同样需要查询操作，即能够找到符合某一查询条件的Entity Bean的实例。Entity Bean的查询操作是通过定义finder()方法完成的。对于CMP,定义finder()方法仅仅是声明一个方法，指明finder()方法的参数，该参数通常与查询条件中的参数对应，真正完成查询的动作是由EJB容器完成的。EJB容器要读取部署描述文件ejb-jar.xml（在*.jar/META-INF里）中的<query>项，该项包含了与finder()方法相对应的查询语句。<query>项中的查询语句遵循的语法规范是EJB QL。
EJB QL的开发查询步骤如下：
1> 在Home接口中增加finder()方法，其参数为查询条件中用到的参数；
2> 在ejb-jar.xml文件的<query>项定义EJB QL语句。
EJB QL是EJB2.0新加入的特性，它实现了如何在Home接口中定义各种查找方法。它以SQL-92为基础，可以由容器自动编译，这使得Entity Bean具有更高的可移植性，并且容易部署。
EJB QL语句由select、where、orderby三个子句组成，其后两个子句是可选的。
EJB QL查询语句举例如下：
例1：
SELECT stu FROM Student AS stu WHERE stu.grade > 5
该查询语句的含义是查询grade>5的Student Bean实例。“Student”是抽象模式名（Abstract schema name），在ejb-jar.xml文件中<abstract schema name>项指定的名称。“stu”是Student的别名，引入别名的好处是可以引用所代表对象的字段。stu.grade表示Student的grade字段，称为路径表达式。
例2：
SELECT i FROM Student As i WHERE i.name = ?1
该查询语句的含义是查找名字与finder()方法中的第一个参数相同的Student Bean实例。
WHERE字句的使用说明：
★ 以?n代表相应的finder()方法的输入参数；
★ 字符串类型的值要用单引号括起来（如果值中有单引号，则用双引号代替）
WHERE语句中可以使用的表达式和运算符如下：
☆ +,-,*,/,=,<,<=,>=,>,<>,NOT,AND,OR
☆ between
☆ like
☆ in
☆ member of
☆ is null(is not null)
内置函数：
● CONCAT(String first,String second)
● SUBSTRING(String source,int start,int length)
● LOCATE(String source,String patter)
● LENGTH(String source)
5.2 查询方法开发实例
5.2.1 打开《Entity Bean的运用（一）》中建立的comSample工程。双击工程窗口中cmpSample.jpx/Cmp，在文档窗口的EJB Designer中用鼠标右键单击Student项，选择Add/Finder菜单项，创建一个finder()方法。
5.2.2 设置finder()方法的各种参数。
★ Finder Name: findByName （finder()方法的名字）
★ Return type: StudentRemote（返回对象的类型）
★ Input parameter: java.lang.String name （输入参数）
★ Query: SELECT i FROM Student As i WHERE i.stuname = ?1（完成该查询的EJB QL语句）
5.2.3 查看Student Entity Bean的Home接口（StudentHome.java）会发现增加了一个finder()方法，该方法的定义如下：
public Student findByName(String name) throws FinderException;
5.2.4右键单击工程窗口中cmpSample.jpx/Cmp，选择Rebuild命令重新打包。
5.2.5 启动Weblogic Server，然后右键单击工程窗口中cmpSample.jpx/Cmp，选择Deploy Options for "Cmp.jar"/Redeploy命令重新部署。
5.2.6 通过EJB Test Client Wizard新建一个客户端程序StudentTestClient2.java，因为EJB已经改变了，所以不能用先前创建的客户端程序。修改main()方法如下：
public static void main(String[] args)
{
StudentTestClient2 client = new StudentTestClient2();
client.studentRemote = client.findByName("student2");
System.out.println("The student2's id is " + client.getStuid());
}
该方法中通过findByName()方法查找名字为student2的Entity Bean实例，然后输出该Entity Bean对应的stuid值。
5.2.7 运行客户端程序，验证结果。
为了简单，仅使用了一个参数，并且返回的是一个Bean实例。如果查询的结果不唯一，那么需要设置返回值为一个集合（Collection）。
参考
电子工业出版社 《J2EE应用开发（Jbuilder+Weblogic）》
我的文章首发牛耳论坛（www.newer.com.cn/bbs）和程序员论坛（www.csdn.net），欢迎转载，不过，请保留作者以及修订者的名字，谢谢。
