Hibernate是Java应用和关系数据库之间的桥梁,它负责Java对象和关系数据之间的映射。Hibernate内部封装了通过JDBC访问数据库的操作,向上层应用提供了面向对象的数据访问API。在Java应用中使用Hibernate包含以下步骤。
(1)创建Hibernate的配置文件。
(2)创建持久化类。
(3)创建对象-关系映射文件。
(4)通过Hibernate API编写访问数据库的代码。
本章通过一个简单的例子helloapp应用,演示如何运用Hibernate来访问关系数据库。helloapp应用的功能非常简单:通过Hibernate保存、更新、删除、加载及查询Customer对象。图1显示了Hibernate在helloapp应用中所处的位置。
helloapp应用既能作为独立的Java程序运行,还能作为Java Web应用运行,该应用的源代码位于配套光盘的sourcecode/chapter2/helloapp目录下。
2.1 创建Hibernate的配置文件
Hibernate从其配置文件中读取和数据库连接有关的信息,这个配置文件应该位于应用的classpath中。Hibernate的配置文件有两种形式:一种是XML格式的文件;还有一种是Java属性文件,采用"健=值"的形式。
下面介绍如何以Java属性文件的格式来创建Hibernate的配置文件。这种配置文件的默认文件名为hibernate.properties,例程2-1为示范代码。
例程2-1 hibernate.properties
hibernate.dialect= net.sf.hibernate.dialect.MySQLDialect hibernate.connection.driver_class= com.mysql.jdbc.Driver hibernate.connection.url=jdbc:mysql: //localhost:3306/SAMPLEDB hibernate.connection.username=root hibernate.connection.password=1234 hibernate.show_sql=true |
以上hibernate.properties文件包含了一系列属性及其属性值,Hibernate将根据这些属性来连接数据库,本例为连接MySQL数据库的配置代码。表2-1对以上hibernate.properties文件中的所有属性做了描述。
表2-1 Hibernate配置文件的属性
属 性 描 述
hibernate.dialect 指定数据库使用的SQL方言
hibernate.connection.driver_class 指定数据库的驱动程序
hibernate.connection.url 指定连接数据库的URL
hibernate.connection.username 指定连接数据库的用户名
hibernate.connection.password 指定连接数据库的口令
hibernate.show_sql 如果为true,表示在程序运行时,会在控制台输出SQL语句,这有利于跟踪Hibernate的运行状态,默认为false。在应用开发和测试阶段,可以把这个属性设为true,以便跟踪和调试应用程序,在应用发布阶段,应该把这个属性设为false,以便减少应用的输出信息,提高运行性能
Hibernate能够访问多种关系数据库,如MySQL、Oracle和Sybase等。尽管多数关系数据库都支持标准的SQL语言,但是它们往往还有各自的SQL方言,就像不同地区的人既能说标准的普通话,还能讲各自的方言一样。
hibernate.dialect属性用于指定被访问数据库使用的SQL方言,当Hibernate生成SQL查询语句,或者使用native对象标识符生成策略时,都会参考本地数据库的SQL方言。本书第5章(映射对象标识符)介绍了Hibernate的各种对象标识符生成策略。
在Hibernate软件包的etc目录下,有一个hibernate.properties文件,它提供了连接各种关系数据库的配置代码样例。
2.2 创建持久化类
持久化类是指其实例需要被Hibernate持久化到数据库中的类。持久化类通常都是域模型中的实体域类。持久化类符合JavaBean的规范,包含一些属性,以及与之对应的getXXX()和setXXX()方法。例程2-2定义了一个名为Customer的持久化类。
例程2-2 Customer.java
package mypack; import java.io.Serializable; import java.sql.Date; import java.sql.Timestamp;
public class Customer implements Serializable { private Long id; private String name; private String email; private String password; private int phone; private boolean married; private String address; private char sex; private String description; private byte[] image; private Date birthday; private Timestamp registeredTime; public Customer(){}
public Long getId() { return id; }
public void setId(Long id) { this.id = id; }
public String getName() { return name; }
public void setName(String name) { this.name=name; } //此处省略email、password和phone 等属性的getXXX()和setXXX()方法 …… } |
持久化类符合JavaBean的规范,包含一些属性,以及与之对应的getXXX()和setXXX()方法。getXXX()和setXXX()方法必须符合特定的命名规则,"get"和"set"后面紧跟属性的名字,并且属性名的首字母为大写,例如name属性的get方法为getName(),如果把get方法写为getname()或者getNAME(),会导致Hibernate在运行时抛出以下异常:
net.sf.hibernate.PropertyNotFoundException: Could not find a getter for property name in class mypack.Customer |
如果持久化类的属性为boolean类型,那么它的get方法名既可以用"get"作为前缀,也可以用"is"作为前缀。例如Customer类的married属性为boolean类型,因此以下两种get方法是等价的:
public boolean isMarried() { return married; } |
或者:
public boolean getMarried() { return married; } |
Hibernate并不要求持久化类必须实现java.io.Serializable接口,但是对于采用分布式结构的Java应用,当Java对象在不同的进程节点之间传输时,这个对象所属的类必须实现Serializable接口,此外,在Java Web应用中,如果希望对HttpSession中存放的Java对象进行持久化,那么这个Java对象所属的类也必须实现Serializable接口。
Customer持久化类有一个id属性,用来惟一标识Customer类的每个对象。在面向对象术语中,这个id属性被称为对象标识符(OID,Object Identifier),通常它都用整数表示,当然也可以设为其他类型。如果customerA.getId().equals(customerB.getId())的结果是true,就表示customerA和customerB对象指的是同一个客户,它们和CUSTOMERS表中的同一条记录对应。
Hibernate要求持久化类必须提供一个不带参数的默认构造方法,在程序运行时,Hibernate运用Java反射机制,调用java.lang.reflect.Constructor.newInstance()方法来构造持久化类的实例。
如果对这个持久化类使用延迟检索策略,为了使Hibernate能够在运行时为这个持久化类创建动态代理,要求持久化类的默认构造方法的访问级别必须是public或protected类型,而不能是default或private类型。
在本书第10章(Hibernate的检索策略)介绍了Hibernate的延迟检索策略及动态代理的概念。
在Customer类中没有引入任何Hibernate API,Customer类不需要继承Hibernate的类,或实现Hibernate的接口,这提高了持久化类的独立性。如果日后要改用其他的ORM产品,比如由Hibernate改为OJB,不需要修改持久化类的代码。
本书第1章介绍了J2EE的持久化方案,无论是基于CMP的实体EJB,还是基于BMP的实体EJB,它们的共同特点是都必须运行在EJB容器中。而Hibernate支持的持久化类不过是普通的Java类,它们能够运行在任何一种Java环境中。[@more@]