hibernate 动态参数的绑定；从3.0到4.2改动 query.setParameter

hibernate中对动态参数的绑定提供了丰富的支持。

其中参数绑定有两种形式。

（1）按参数的名字进行绑定

在hql查询语句中定义命名参数，以“ ：”开头，形式如下：

Query query =session.createQuery(" from Customer as c where c.name =:customerName");

上面的HQL语句定义了“customerName”命名参数，接下来调用Query的setXXX()方法来绑定参数.

query.setString("customerName",name);

(2) 按参数位置绑定

在HQL查询语句中 用“？”来定义参数的位置，形式如下：

Query query =session.createQuery(" from Customer as c where c.name =？");

上面的HQL语句 定义了一个参数，参数的第一个位置为0，接下来调用Query的setXXX()方法来绑定参数.

query.setString(0 , name);

优先考虑按名字绑定的方式。

• 使得程序有较好的可读性
• 有利于程序代码的维护。按位置绑定方式，如果有多个参数在HQL语句中位置改变了，则必须改变绑定参数的代码，消弱了程序代码的健壮性和可维护性。

Hibernate提供了3个特殊的参数绑定方法。

（1）setEntity()方法 ： 把参数与一个持久化类的实例绑定。例如：以下setEntity()方法把“customer”命名参数与一个Customer对象绑定

session.createQuery("from Order o where o.customer = :customer")

.setEntity("customer",customer).list();

(2) setParameter()方法：绑定任意类型的参数

Query query = session.createQuery( " from Order o where o.id=:id and o.orderNumber like :orderNumber");

query.setParameter(" id" , 1);

//   query.setParameter(" orderNumber",orderNumber,Hibernate.STRING);  //hibernate 3.0的写法。

query.setParameter(" orderNumber",orderNumber, StringType.INSTANCE); //hibernate 4.2的写法

（3）setProperties() 方法：用于把参数名称与一个对象的属性值绑定，如：

Customer c=new Customer();

c.setName("Tom"); 

c.setAge(20);

Query query =session.createQuery(" from Customer as c where c.name = : name and c.age = :age")

query.setProperties(c) ;