JPA本地查询(Native Query)的总结2

OK，现在对同一个查询，再把结果集全部映射进实体对象。

 

首先

@NamedNativeQueries

(

    {

       @NamedNativeQuery(

           name="ReturnOrderListWithFullEntityType",

              query="select o.id as order_id,o.create_date as order_creation_date,o.description as order_description,o.sum_price as order_sum_total,

c.name as customer_name,c.ctype as customer_type,c.id as customer_id from orders o join customer c on o.cust_id=c.id where o.cust_id=?1",

           resultSetMapping="ReturnOrderListWithFullEntityType"),

        。。。。。。。。。。。。。可能还有更多的本地查询设置

}

)

改变本地查询的resultSetMapping

 

    @SqlResultSetMapping

    (

       name="ReturnOrderListWithFullEntityType",

       entities=

       {

           @EntityResult

           (

              entityClass=entity.Order.class,

              fields=

              {

    @FieldResult(name="id",column="order_id"),

                         @FieldResult(name="date",column="order_creation_date"),

                  @FieldResult(name="desc",column="order_description"),

    @FieldResult(name="sum",column="order_sum_total")

              }

           ),

 

           @EntityResult

           (

              entityClass=entity.Customer.class,

              discriminatorColumn="customer_type",

              fields=

              {

                  @FieldResult(name="id",column="customer_id"),

                  @FieldResult(name="name",column="customer_name")

              }

           )

       },

       columns={}

    )

 

entities属性是一个包含与返回结果集相映射的所有实体的一个数组。这条查询得到了订单和用户的信息，所以，与结果集映射的实体，就应该是Order和Customer。

每一个映射实体用@EntityResult表示，entityClass表示实体类，fields表示该实体类中的属性，与查询结果中的哪些个列相映射。而每一个“属性<->列”的映射关系，又保存在@FieldResult里面。name是实体属性，column是查询列（或列别名）

 

要注意的是，如果要将结果集映射到实体对象，则

1．Select 语句中必须包含实体所映射的表中的PK，也就是 select o.id as order_id

 

2. 反过来，“属性<->列”的映射，也必须将表的PK映射到实体类的用@Id annotation批注的字段或属性上。

 

否则，JPA就会抛出一个exception

oracle.toplink.essentials.exceptions.QueryException

Exception Description: The primary key read from the row [DatabaseRecord(

    orders.ID => null

    orders.CREATE_DATE => 2009-05-27 00:00:00.0

    orders.SUM_PRICE => 36817.0

    orders.DESCRIPTION => This is an order creation example.

    orders.cust_id => null)] during the execution of the query was detected to be null.  Primary keys must not contain null.

 

 

 

 

 

再看一下关于Customer实体的映射，与Order不一样的地方，是discriminatorColumn="customer_type" (可能为列别名)

加上这个属性的原因是，Customer类是一个父类，以供其他子类继承，而J PA的内在多态性机制将会获取到Customer的实际类型。根据J PA @Inheritance批注，得知，父类实体的表中必须有一个字段（默认为DTYPE）来表示各个子类的类型。所以当要将查询结果集保存为实体的时候，它必须要知道你所保存的这个Customer实体到底是哪种类型。

所以，你还必须在select子句中取得这个Discrimator Type的字段。

否则又会抛出异常： 

oracle.toplink.essentials.exceptions.QueryException

Exception Description: Custom SQL failed to provide descriminator column : , as defined in SQLResultSetMapping : ReturnOrderListWithFullEntityType.

或者：

oracle.toplink.essentials.exceptions.QueryException

Exception Description: Custom SQL failed to provide descriminator column : customer_type, as defined in SQLResultSetMapping : ReturnOrderListWithPartEntityPartScalarType.

 

 

通过这种映射方式，我们可以推测，得到的结果集List中，数据会是这样：

[  {“Order对象1”, “Customer对象1”},  {“Order对象2”, “Customerr对象2”}, ……  ]

 

经过运行测试程序，得到了我们的推论

 

*****ReturnOrderListWithFullEntityType*****

entity.Order@48edb5  entity.GoldenCustomer@1ee2c2c  

entity.Order@1402d5a entity.GoldenCustomer@1ee2c2c  

entity.Order@1e13e07 entity.GoldenCustomer@1ee2c2c  

entity.Order@9cfec1  entity.GoldenCustomer@1ee2c2c  

entity.Order@747fa2  entity.GoldenCustomer@1ee2c2c  

……

看来的确是保存了对象，而且注意第二个对象不是Customer而是GoldenCustomer，这说明，JPA自动将数据映射进了GoldenCustomer实体（尽管我们使用的是Customer实体进行保存  “entityClass=entity.Customer.class”）