Hibernate是Java应用和关系数据库之间的桥梁,它负责Java对象和关系数据之间的映射。Hibernate内部封装了通过JDBC访问数据库的操作,向上层应用提供了面向对象的数据访问API。在Java应用中使用Hibernate包含以下步骤。

    (1)创建Hibernate的配置文件。

    (2)创建持久化类。

    (3)创建对象-关系映射文件。

    (4)通过Hibernate API编写访问数据库的代码。

    本文通过一个简单的例子helloapp应用,演示如何运用Hibernate来访问关系数据库。helloapp应用的功能非常简单:通过Hibernate保存、更新、删除、加载及查询Customer对象。图1显示了Hibernate在helloapp应用中所处的位置。

图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能够访问多种关系数据库,如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,不需要修改持久化类的代码。

    本文介绍了J2EE的持久化方案,无论是基于CMP的实体EJB,还是基于BMP的实体EJB,它们的共同特点是都必须运行在EJB容器中。而Hibernate支持的持久化类不过是普通的Java类,它们能够运行在任何一种Java环境中。