在FindProductByName中有几点值得注意:
- 有一个具有where子句的query字符串,这与标准SQL语句很相似。
- 初始化Hibernate的方法与第一个示例中一样。这一次,我们有配置文件和映射文件。
- sess.find()执行查询,并将提供的产品名称设置为类型Hibernate.STRING的搜索参数。
- 作为结果,我们得到一个包含所找到的Product的java.util.List。
- 使用Product p = (Product) list.get(0); 我们用通常的类型转换方法获取找到的对象。
执行java test.FindProductByName Milk,查看显示在控制台中的内容。
注意:查询是区分大小写的,所以搜索小写的milk将不会返回任何结果。使用lower()或upper()SQL函数来启用不区分大小写的搜索。在这种情况下,我们会在查询字符串中使用where lower(product.name)=lower(:name)。关于查询的详细内容,请参见文档。此外,如果不希望显示所有的INFO日志信息,可以修改log4j.properties文件,将日志等级设置为warn。
更新和删除产品
到现在为止,您应该对Hibernate的工作方式有了一个基本的了解,因此我们将缩短冗长的示例,只显示重要的部分。
为了在单个事务中将所有产品的价格提高10%,我们可以编写如下的内容:
double percentage = Double.parseDouble(args[0])/100;
sess = sf.openSession();
Transaction t = sess.beginTransaction();
// 列表包含产品
Iterator iter = list.iterator();
while (iter.hasNext()) {
Product p = (Product) iter.next();
p.setPrice(p.getPrice() * (1 + percentage));
sess.saveOrUpdate(p);
}
t.commit();
sess.close();
最后,要删除Product,当然要调用sess.delete(product)。如果数据库关闭了autocommit,不要忘记调用commit()提交Transaction。
现在,我们已经完成了针对单个对象的所有基本操作——创建、读取、更新和删除。看上去相当有趣,但我们可以做得更好。现在我们来学习如何操纵对象集而不需要编写SQL语句。所有的魔法都通过映射文件实现。
Orders,OrderItems
有时一个一个地操纵对象确实可行,但是我们希望能够级联加载和更新。现在我们来看如何做到这一点。
我们需要同时检查Order和OrderItem。就如前面所提到的,我们添加一项Product到一个Order中,它将变成一个OrderItem。Order在内部保存一个OrderItem集。我们希望保存Order,让Hibernate来做其他工作:保存OrderItem和更新所添加的Product的可用库存(数量)。听起来很复杂,但实际上非常简单。Hibernate知道如何处理一对一、一对多、多对一和多对多方式中的相关对象。我们将从映射文件开始。
Order.hbm.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping
PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
<hibernate-mapping>
<class name="test.hibernate.Order" table="orders">
<id name="id" type="string" unsaved-value="null" >
<column name="id" sql-type="char(32)" not-null="true"/>
<generator class="uuid.hex"/>
</id>
<property name="date">
<column name="order_date"
sql-type="datetime" not-null="true"/>
</property>
<property name="priceTotal">
<column name="price_total"
sql-type="double" not-null="true"/>
</property>
<set name="orderItems" table="order_items" inverse="true" cascade="all">
<key column="order_id" />
<one-to-many class="test.hibernate.OrderItem" />
</set>
</class>
</hibernate-mapping>
这个映射文件非常易于理解,除了最后一个元素<set>。它表示了不同类之间的连接,在我们的例子中,这些类是Order和OrderItem。属性和子元素很容易理解:一个Set类型的字段,名为orderItems(参见上面的Order源代码),它包含类型为test.hibernate.OrderItem的对象,正如<one-to-many>子元素所解释的那样。这些对象被持久化在表order_items中,order_id列包含OrderItem类型的对象的键。
cascade="all"是一个非常重要的属性。它解释了在操纵连接到的对象时,Hibernate如何动作。在我们的例子中,当创建一个Order时,我们无疑希望它所有的OrderItem也被创建;当然,当一个Order被删除时,我们也希望它所有的OrderItem也被删除。Cascade属性还有另外三个选项(none、save-update和delete),我们将在下面的示例中看一下如何使用它们。
OrderItem.hbm.xml
这个对象比较有意思。它的实例自动在Order中创建,基本上不会存在于其外。然而,由于它们在创建Order时代表Product,所以我们需要它们。如果一项产品的价格改变了,我们无疑不希望所有相关的OrderItem以及Order的价格被改变。我们需要的只是在OrderItem创建时更新Product的可用库存。最后,当一项Order被删除时,其OrderItem也被删除,但我们不能改变Product!听上去很复杂,特别是要编写所有这些SQL语句的话。但Hibernate把它们压缩成了映射文件中的两行!
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping
PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
<hibernate-mapping>
<class name="test.hibernate.OrderItem"
table="order_items">
<id name="id" type="string" unsaved-value="null" >
<column name="id" sql-type="char(32)"
not-null="true"/>
<generator class="uuid.hex"/>
</id>
<property name="orderId" insert="false"
update="false">
<column name="order_id" sql-type="char(32)"
not-null="true"/>
</property>
<property name="productId" insert="false"
update="false">
<column name="product_id" sql-type="char(32)"
not-null="true"/>
</property>
<property name="amount">
<column name="amount" sql-type="int"
not-null="true"/>
</property>
<property name="price">
<column name="price" sql-type="double"
not-null="true"/>
</property>
<many-to-one name="order"
class="test.hibernate.Order"
column="order_id" />
<many-to-one name="product"
class="test.hibernate.Product"
cascade="save-update"
column="product_id"/>
</class>
</hibernate-mapping>
到目前为止,我们了解了关于<id>和<property>元素的一切,但<many-to-one>是一个新元素。这个元素非常简单。第一个<many-to-one>元素指出OrderItem的名为order的字段是test.hibernate.Order类型,并且通过表order_items的order_id列来引用(参见class元素的table属性)。第二个many-to-one元素类似于第一个,除了它具有cascade="save-update"属性。它在定义的内容之前进行解释。在这个例子中,我们假设Hibernate只在保存(创建)或更新(更改)OrderItem时传递Product的更改,而在删除时不传递更改。因此,上述的复杂SQL语句就被压缩为单个属性!现在这个问题解决了!
用法示例
创建一个订单。在该示例中,我们创建并持久化一个订单。反复运行这个示例,查看产品数量在每次成功创建订单后如何变化。
// ...
Configuration cfg = new Configuration()
.addClass(Product.class)
.addClass(Order.class)
.addClass(OrderItem.class);
// ...
Order order = new Order();
order.addProduct(milk, 3);
order.addProduct(coffee, 5);
// ...
sess = sf.openSession();
Transaction t = sess.beginTransaction();
sess.save(order);
t.commit();
sess.close();
System.out.println(order);
// ...
按照价格范围查找订单。在该示例中,我们将展示如何使用一个带有两个参数的查询。Hibernate正确地加载具有适当订单项和产品的订单。
// ...
String query = "select o from o "
+ "in class test.hibernate.Order "
+ "where o.priceTotal > :priceTotalLower "
+ "and o.priceTotal < :priceTotalUpper";
// ...
Query q = sess.createQuery(query);
q.setDouble("priceTotalLower",
Double.parseDouble(args[0]));
q.setDouble("priceTotalUpper",
Double.parseDouble(args[1]));
List list = q.list();
// ...
sess.close();
// ...
删除一定价格范围内的订单。这是一个重要的示例。这里我们会看到Hibernate是一个多么智能的工具。正如前面所提到的,当删除一个订单时,其订单项也需要被删除,但不能改变产品。在运行该示例后,检查数据库,确认产品没有变化。
// ...
String query = "select o from o "
+ "in class test.hibernate.Order "
+ "where o.priceTotal > :priceTotalLower "
+ "and o.priceTotal < :priceTotalUpper";
Transaction tx = sess.beginTransaction();
sess.delete(query,
new Object[]{new Double(args[0]),
new Double(args[1])},
new Type[]{Hibernate.DOUBLE,
Hibernate.DOUBLE}
);
tx.commit();
sess.close();
结束语
本文展示了Hibernate有多么强大。您已经了解到可以多么轻松地持久化任何类型的Java对象、操纵对象层次结构、处理集合、使用事务。但Hibernate的功能不止于此。它可以处理使用提交和回滚的完整事务、继承、几种类型的集合,并提供非常强大的面向对象查询语言HQL,HQL支持关联和联结、多态、子查询等。接下来您可以阅读Hibernate参考文档,并着手在日常工作中使用Hibernate。
参考资料
- 本文中使用的源代码
原文出处: Hibernate Your Data http://www.onjava.com/pub/a/onjava/2004/01/14/hibernate.html
| 作者简介 | |
| Davor Cengija 是TIS PU公司的一名IT顾问。TIS PU是位于克罗地亚萨格勒布的一个专攻业务集成任务的公司。 | |








