EJB3.0笔记-9实体查询与EJB QL

转自：http://blog.sina.com.cn/s/blog_5016113a0100asnl.html

在java persistence中，可以同时使用EJB QL查询语言和原生的SQL来完成查询操作。由于EJB QL是一种描述Java对象的查询语言，而entity manager会为你处理由EJB QL向原生SQL转换的工作，因此它具有跨数据库厂商实现的移植能力。EJB QL比SQL更加紧凑和更容易阅读，但是EJB QL不可能都支持数据库所有私有特性，所以功能上没有厂商原生SQL那么功能全面。

Query API
    通过javax.persistence.Query接口来实现查询功能，而Query接口可以通过javax.persistence. EntityManager得到。
   
 参数
    EJB QL支持具名参数(named parameters)和指示参数(positional parameters),如：
    Query query=entityManager.createQuery(“from Customer c where c.firstName=:first and
         c.lastName=:last”);
    query.setParameter(“first”,first);
    query.setParameter(“last”,last);
    return query.getResultList();
    或者
    Query query=entityManager.createQuery(“from Customer c where c.firstName=?1 and
         c.lastName=?2”);
    query.setParameter(1,first);
    query.setParameter(2,last);
    return query.getResultList();

日期型参数
    如果要将java.util.Date或java.util.Calendar参数传入查询中，就得使用特殊的setParameter方法，    如下：
    setParameter(String name,java.util.Date value,TemporalType temporalType);
    setParameter(String name,Calendar value,TemporalType temporalType);
    其中temporalType表示将Date或Calendar参数转换成原生SQL类型时，使用的是何种数据库类型

对结果分页
    Query query=entityManager.createQuery(“from Customer c”);
    return query.setMaxResults(max).setFirstResult(index).getResultList();

Hints
    有些java.persistence厂商会为你提供一些能在执行查询时使用的附加功能，比如Jboss的EJB3.0允许    为查询定义超时。
    Query query=entityManager.createQuery(“from Customer c”);
    query.setHint(“org.hibernate.timeout”,1000);

FlushMode
    默认的flush模式，会在em查询之前，执行flush动作(把更新同步到数据库)。如果希望在查询前不执行    flush，可以通过
    Query query=entityManager.createQuery(“from Customer c”);
    query.setFlushMode(FlushModeType.COMMIT);

EJB QL
EJB QL是按照实体的抽象持久结构来表达的，包括：抽象结构名称、基本成员属性和关系型成员属性。抽象结构名，默认是非限定类名，如果使用了
@Entity(name=”Cust”)
public class Customer{….}
那么查询Customer 的EJB QL为 select c from Cust AS c;

简单查询
    select object(c) from Customer as c 等价于select c from Customer as c

选择实体和关系型成员属性
    对于
    @Entity
    public class Customer{
        private int id;
        private String first;
        private Address address;
        @Id
        public int getId(){…..}
        public getFirstName(){return first;}
        …………
    }
    选择成员属性可以使用：
    select c.firstName from Customer as c;或者
    select c.first from Customer as c;
    选择关联的实体可以使用：
    select c.address from Customer as c;
    选择关联实体的属性可以使用:
    select c.address.city  from Customer as c;
    但是如果Address不是持久型成员，只是普通的class，上面的语句是非法的。可以使用
    @Embedded private Address address;让语句变回合法。

构造函数表达式
    可以在select子句是指定一个构造函数，用于创建普通的JAVA对象(而非实体)，如：
    select new com.tian.domain.Name(c.firstName,c.lastName) from Customer c;

IN操作符和INNER JOIN
    返回所有乘客的所有预订信息
    select r from Customer as c ,in(c.reservations) r;
    等效于
    select r from Customer as c inner join c.reservations r;//inner可以省略

LEFT　JOIN
    查询所有顾客及他们的电话号码,如果顾客没有电话号码以null代替
    select c.firstName ,p.number from Customer c left join c.phoneNumbers p;
    //left join可以写成left outer join

Fetch Joins
如果关系型成员属性FetchType在定义XML时(或注解)设为LAZY，那么在程序访问到这些成员时才从数据库加载数据，有时会增加数据库访问量，可以通过JOIN FETCH强制加载这些关系成员，如：
select c from customer c left join fetch c.phones；这时会提前加载Phone关联

使用DISTINCT
关键字distinct确保查询不会返回重复项。如查询所有预订舱位的顾客，由于顾客可以预订多次，所有distinct可以派上用场。
select distinct cust from Reservation as res, in (res.customers) cust;

where 子句与字面常量
where 子句用于缩小选择范围。如果使用到字符串常量，可以使用单引号括起来，如果字符串中又有一个单引号，请用两个单引号表示；如果是数值型的常量，就直接书写；如果是布尔型，常量取值用true和false。如
where name=’capital one’; where name=’wendy’’s’;where hasGoodCredit=true;
如果不想涉及这些细节，可以直接使用查询参数，让查询API处理这些问题

where 子句与运算符的优先级
点号(.)à数学运算符(+-*/)à比较运算符(=,>,like,between,in,is null,is empty,member of)à逻辑运算符(not,and or)

where子句与数学运算符
允许查询操作在做比较时执行算术运算。运算过程中，数值也许被放宽或提升，如int 与double相乘，先把int 变成double,结果也是double的

where子句和逻辑运算符
and 和or运算符的行为与java语言中的&&和||有所不同。&&只有左操作数为true时才会对右操作数求值，and要由转换出的原生语言决定

where 子句和in
    IN用来检验是否与一组字面常量中的元素相匹配，如：
    where c.address.state IN(‘FL’,’TX’,’WI’);
    也可以使用参数
    where c.address.state IN(?1,?2,?3,5.7);
where 子句与is null
    比较运算符is null允许检验路径表达式是否为null。它也可以用来检验输入参数，如
    select c from Customer as c
    where :city is not null and :state is not null
    and c.address.state=:state

where 子句与is empty
is empty检验集合类型的关系是否为空(没有元素)，集体类型的关系是从不会为null的。对from子句已经被赋予标识符的集合型关系使用is empty是非法的，如：
select r from Reservation as r inner join r.customers as c //已经赋予标识符c，表明c一定不为空
where r.customers is not empty;

where 子句与member of
member of用于判断某个实体是否是集合型关系的一个成员,如
where cust not member of  res.customers

where子句与like
可以使用两个特殊的字符“%”(表示任意字符序列)和“_”(表示单个字符)，如果字符串本来就有%或_，可以使用“\”字符来避免冲突

函数表达式
    字符串处理函数
        LOWER(String):转换成小写
        UPPER(String):转换成大家
        TRIM([[leading|trailing|both][trim_char]from)]String):去除指定字符trim_char,默认为空格
        CONCAT(String1,String2):连接字符串
        LENGTH(String):求字符串长度
        LOCATE(String1,String2[,start]):String1在String2的什么位置
        SUBSTRING(String1,sart,length):截取字符串
    数字函数
        ABS(number):绝对值
        SORT(double):平方根
        MOD(int,int):求余数
    返回日期和时间的函数
        CURRENT_DATE:返回当前日期
        CURRENT_TIME:返回当前时间
        CURRENT_TIMESTAMP:返回当前时间戳
    聚合函数
        COUNT():返回查询结果集中的条目数
        MAX():找出最大值
        MIN():找出最小值
        AVG(numeric):平均值
        SUM(numerc):求和

ORDER BY子句
对返回集合进行排序。在EJB QL中有一个使用限制：order by子句中出现的属性，必须出现在select子句中，或者是select子句选中实体的一个属性。如：
select c from Customers as c order by c.address desc;select addr.zip from Address as addr order by add.zip;
以下是非法的
select c from Customers as c order by c.address.city desc;// city不是c的直接属性
GROUP BY 与HAVING
group by 用于分组，having对分组进一步筛选。group by子句中指定的字段必须出现于查询的返回结果中，这和SQL的要求是一致的。

子查询
    子查询是内嵌于主查询的另一个查询。EJB QL支持在where和having子句中使用子查询
    查询费用超过$100,000的所有航程
    from Cruise cr where 100000<(select sum(res.amountPaid) from cr.reservations res)
    
    ALL,ANY,SOME
    如果子查询返回多项结果，可以使用ALL、ANY和SOME对结果做进一步限定
    如果子查询中的所有内容都与条件表达式相匹配，那么操作符ALL就返回true
    查询所有预付了舱位预订定金的航程
    from Cruise cr where 0< all(select res.amountPaid from cr.reservations res)
    如果子查询中的有任意一项与条件表达式相匹配，那么操作符ALL或SOME就返回true
   
    EXISTS
    如果子查询包含一项或多项结果，那么操作符EXISTS返回true

批量的UPDATE与DELETE
    给所有名叫Bill Burke的乘客增加$10
    update Reservation res set res.amountPaid=(res.amountPaid+10)
    where exists(
        select c from res.customers c
        where c.firstName=’Bill’ and c.lastName=’Burke’
    );
    是否可以写成?
    update Reservation res set res.amountPaid=(res.amountPaid+10)
    where res.customers.firstName=’Bill’ and res.customers.lastName=’Burke’

    删除所有Bill Burke的舱位预订记录
    delect from Reservation res
    where exist(
        select c from res.customers c
        where c.firstName=’Bill’ and c.lastName=’Burke’
    )

原生查询
EntityManager接口有三个创建原生查询的方法：一个返回标量值，一个返回实体类型，还有一个返回多个实体与标量值组合

标量原生查询
createNativeQuery(String sql);

简单实体的原生查询
createNativeQuery(String sql,Class entityClass);根据某个实体定义好的映射元数据，将返回值映射到该实体

复杂原生查询
createNativeQuery(String sql,String mappingName)
    返回多个实体
        @Entity
        @SqlResultSetMapping(name=”customerAndCreditCardMapping”,//映射名
                entities={@EntityResult(entityClass=Customer.class),//entities指定映射的实体
                    @EntityResult(entityClass=CreditCard.class,
           fields={@FieldResult(name=”id”,column=”CC_ID”),//指定实体内成员与返回字段的映射
                    @FieldResult(name=”number”,column=”number”)})
                        })
        public class Customer{………}
        等价XML
        <entity-mappings>
            <sel-result-set-mapping name=” customerAndCreditCardMapping”>
                <entity-result entity-class=”com.titan.domain.Customer”/>
                <entity-result entity-class=”com.titan.domain.CreditCard”>   
                    <field-result name=”id” column=”CC_ID”/>
                    <field-result name=”number” column=”number”/>
                </entity-result>
            </sel-result-set-mapping>
        </entity-mappings>
        使用方法
        String sql=”select c.id,c.firstName,cc.id As CC_IC,cc.number from CUST_TABEL
           c,CREDIT_CARD_TABLE cc….”
        manager.createNativeQuery(sql,”customerAndCreditCardMapping”);
       
   返回结果既有标量也有实体
        @SqlResultSetMapping(name=”reservationCount”,//映射名
                entities={@EntityResult(entityClass=Cruise.class,              
                        fields={@FieldResult(name=”id”,column=”id”) })},
                columns={@ColumnsResult(name=”resCount”)}//标量
                )
        @Entity
        public class Cruise{……}
        等价XML
        <entity-mappings>
            <sel-result-set-mapping name=” reservationCount”>
                <entity-result entity-class=”com.titan.domain.Cruise”>   
                    <field-result name=”id” column=”id”/>
                </entity-result>
                <column-result name=”resCount”>
            </sel-result-set-mapping>
        </entity-mappings>
        使用方法
        String sql=”select c.id,count(Resrvation.id) as resCount from Cruise c left join
             Reservation on c.id=………..”;
        manager.createNativeQuery(sql,” reservationCount”);

具名EJB QL查询
    预先定义好EJB QL或原生的SQL查询
    使用@javax.persistence.NamedQuery用来预定EJB QL的,NamedQuerys用于定义多条查询
    @NamedQuerys({
        NamedQuery(name=”getAverageReservateion”,//名字
            query=”select AVG(r.amountPaid) from Cruise As c Join c.reservatons r where
                 c=:cruise”),//EJB QL
        NamedQuery(……)
    })
    @Entity
    public class Cruise{…….}
    等价XML
    <entity-mapping>
        <named-query name=” getAverageReservateion”>
            <query>
                EJB QL
            </query>
        </ named-query >
    </entity-mapping >
    使用方式
    Query query=em.createNamedQuery(“getAverageReservateion”);
    query.setParameter(“cruise”.cruise);

具名原生查询
    使用@javax.persistence.NamedNativeQuery注解来预定义具名原生SQL查询
    @NamedNativeQuery(
        name=”findCustAndCCNum”,
        query=”select ……..”,//原生SQL
        resultClass=”…”,//只返回一个实体时用
        resultSetMapping=”….”
        //一个声明的@SqlResultSetMapping,用于返回多个实体和或实体与标量混合的查询
    )
等价XML
    <entity-mappings>
        <named-native-query name=” getAverageReservateion” result-set-mapping=”….”>
            <query>
                原生SQL
            </query>
        </ named-native-query >
    </entity-mappings >
    使用方式
    Query query=em.createNamedQuery(“getAverageReservateion”);
    query.setParameter(“cruise”.cruise);