欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Hibernate 的原理与配置

程序员文章站 2024-02-22 13:43:04
  也许你听说过hibernate的大名,但可能一直不了解它,也许你一直渴望使用它进行开发,那么本文正是你所需要的!在本文中,我向大家重点介绍hibernate的核心api...

  也许你听说过hibernate的大名,但可能一直不了解它,也许你一直渴望使用它进行开发,那么本文正是你所需要的!在本文中,我向大家重点介绍hibernate的核心api调用库,并讲解一下它的基本配置。

  看完本文后,我相信你对什么是orm(对像/关系映射)以及它的优点会有一个深刻的认识,我们先通过一个简单的例子开始来展现它的威力。

  正如一些传统的经典计算机文章大都会通过一个“hello,world”的例子开始讲解一样,我们也不例外,我们也将从一个相对简单的例子来阐述hibernate的开发方法,但如果要真正阐述hibernate的一些重要思想,仅仅靠在屏幕上打印一些字符是远远不够的,在我们的示例程序中,我们将创建一些对象,并将其保存在数据库中,然后对它们进行更新和查询。

  阅读导航

  “hello world”“hello world”示例程序让您对hibernate有一个简单的认识。
  理解hibernate的架构介绍hibernate接口的主要功能。
  核心接口hibernate有5个核心接口,通过这几个接口开发人员可以存储和获得持久对象,并且能够进行事务控制
  一个重要的术语:typetype是hibernate发明者发明的一个术语,它在整个构架中是一个非常基础、有着强大功能的元素,一个type对象能将一个java类型映射到数据库中一个表的字段中去。
  策略接口hibernate与某些其它开源软件不同的还有一点――高度的可扩展性,这通过它的内置策略机制来实现。
  基础配置hibernate可以配置成可在任何java环境中运行,一般说来,它通常被用在2-3层的c/s模式的项目中,并被部署在服务端。
  创建一个sessionfactory对象要创建一个sessionfactory对象,必须在hibernate初始化时创建一个configuration类的实例,并将已写好的映射文件交由它处理。

  “hello world”

  hibernate应用程序定义了一些持久类,并且定义了这些类与数据库表格的映射关系。在我们这个“hello world”示例程序中包含了一个类和一个映射文件。让我们看看这个简单的持久类包含有一些什么?映射文件是怎样定义的?另外,我们该怎样用hibernate来操作这个持久类。

  我们这个简单示例程序的目的是将一些持久类存储在数据库中,然后从数据库取出来,并将其信息正文显示给用户。其中message正是一个简单的持久类:,它包含我们要显示的信息,其源代码如下:

  列表1 message.java 一个简单的持久类

  package hello;
  public class message {
  private long id;
  private string text;
  private message nextmessage;
  private message() {}
  public message(string text) {
  this.text = text;
  }
  public long getid() {
  return id;
  }
  private void setid(long id) {
  this.id = id;
  }
  public string gettext() {
  return text;
  }
  public void settext(string text) {
  this.text = text;
  }
  public message getnextmessage() {
  return nextmessage;
  }
  public void setnextmessage(message nextmessage) {
  this.nextmessage = nextmessage;
  }
  }

  message类有三个属性:message的id 、消息正文、以及一个指向下一条消息的指针。其中id属性让我们的应用程序能够唯一的识别这条消息,通常它等同于数据库中的主键,如果多个message类的实例对象拥有相同的id,那它们代表数据库某个表的同一个记录。在这里我们选择了长整型作为我们的id值,但这不是必需的。hibernate允许我们使用任意的类型来作为对象的id值,在后面我们会对此作详细描述。

  你可能注意到message类的代码类似于javabean的代码风格,并且它有一个没有参数的构造函数,在我们以后的代码中我将继续使用这种风格来编写持久类的代码。

  hibernate会自动管理message类的实例,并通过内部机制使其持久化,但实际上message对象并没有实现任何关于hibernate的类或接口,因此我们也可以将它作为一个普通的java类来使用:

  message message = new message("hello world");
  system.out.println( message.gettext() );

  以上这段代码正是我们所期望的结果:它打印“hello world”到屏幕上。但这并不是我们的最终目标;实际上hibernate与诸如ejb容器这样的环境在持久层实现的方式上有很大的不同。我们的持久类(message类)可以用在与容器无关的环境中,不像ejb必须要有ejb容器才能执行。为了能更清楚地表现这点,以下代码将我们的一个新消息保存到数据库中去:

  session session = getsessionfactory().opensession();
  transaction tx = session.begintransaction();
  message message = new message("hello world");
  session.save(message);
  tx.commit();
  session.close();

  以上这段代码调用了hibernate的session和transaction接口(关于getsessionfactory()方法我们将会马上提到)。它相当于我们执行了以下sql语句:

  insert into messages (message_id, message_text, next_message_id)
  values (1, 'hello world', null)

  在以上的sql语句中,message_id字段到底被初始化成了什么值呢?由于我们并没有在先前的代码中为message对象的id属性赋与初始值,那它是否为null呢?实际上hibernate对id属性作了特殊处理:由于它是一个对象的唯一标识,因此当我们进行save()调用时,hibernate会为它自动赋予一个唯一的值(我们将在后面内容中讲述它是如何生成这个值的)。

  我们假设你已经在数据库中创建了一个名为message的表,那么既然前面这段代码让我们将message对象存入了数据库中,那么现在我们就要将它们一一取出来。下面这段代码将按照字母顺序,将数据库中的所有message对象取出来,并将它们的消息正文打印到屏幕上:

  session newsession = getsessionfactory().opensession();
  transaction newtransaction = newsession.begintransaction();
  list messages =newsession.find("from message as m order by m.text asc");
  system.out.println( messages.size() + " message(s) found:" );
  for ( iterator iter = messages.iterator(); iter.hasnext(); ) {
  message message = (message) iter.next();
  system.out.println( message.gettext() );
  }
  newtransaction.commit();
  newsession.close();

  在以上这段代码中,你可能被find()方法的这个参数困扰着:"from message as m order by m.text asc",其实它是hibernate自己定义的查询语言,全称叫hibernate query language(hql)。通俗地讲hql与sql的关系差不多就是方言与普通话之间的关系,咋一看,你会觉得它有点类似于sql语句。其实在find()调用时,hibernate会将这段hql语言翻译成如下的sql语句:

  select m.message_id, m.message_text, m.next_message_id
  from messages m
  order by m.message_text asc

  以下就是运行结果:

  1 message(s) found:
  hello world

  如果你以前没有orm(对象-关系映射)的开发经验,那你可能想在代码的某个地方去寻找这段sql语句,但在hibernate中你可能会失望:它根本不存在!所有就sql语句都是hibernate动态生成的。

  也许你会觉得还缺点什么,对!仅凭以上代码hibernate是无法将我们的message类持久化的。我们还需要一些更多的信息,这就是映射定义表!这个表在hibernate中是以xml格式来体现的,它定义了message类的属性是怎样与数据库中的messages表的字段进行一一对应的,列表2是这个示例程序的映射配置文件清单:

  列表2:示例程序的对象-关系映射表

  <?xml version="1.0"?>
  <!doctype hibernate-mapping public
  "-//hibernate/hibernate mapping dtd//en"
  "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
  <hibernate-mapping>
  <class name="hello.message" table="messages">
  <id name="id" column="message_id">
  <generator class="increment"/>
  </id>
  <property name="text" column="message_text"/>
  <many-to-one name="nextmessage" cascade="all" column="next_message_id"/>
  </class>
  </hibernate-mapping>

  以上这个文档告诉hibernate怎样将message类映射到messages表中,其中message类的id属性与表的message_id字段对应,text属性与表的message_text字段对应,nextmessage属性是一个多对一的关系,它与表中的next_message_id相对应。

  相对于有些开源项目来说,hibernate的配置文件其实是很容易理解的。你可以轻松地修改与维护它。只要你定义好了持久类与数据库中表字段的对应关系就行了,hibernate会自动帮你生成sql语句来对message对象进行插入、更新、删除、查找工作,你可以不写一句sql语句,甚至不需要懂得sql语言!

  现在让我们做一个新的试验,我们先取出第一个message对象,然后修改它的消息正文,最后我们再生成一个新的message对象,并将它作为第一个message对象的下一条消息,其代码如下:

  列表3 更新一条消息

  session session = getsessionfactory().opensession();
  transaction tx = session.begintransaction();
  // 1 is the generated id of the first message
  message message =(message) session.load( message.class, new long(1) );
  message.settext("greetings earthling");
  message nextmessage = new message("take me to your leader (please)");
  message.setnextmessage( nextmessage );
  tx.commit();
  session.close();

  以上这段代码在调用时,hibernate内部自动生成如下的sql语句:

  select m.message_id, m.message_text, m.next_message_id
  from messages m
  where m.message_id = 1

  insert into messages (message_id, message_text, next_message_id)
  values (2, 'take me to your leader (please)', null)

  update messages
  set message_text = 'greetings earthling', next_message_id = 2
  where message_id = 1

  当第一个message对象的text属性和nextmessage被程序修改时,请注意hibernate是如何检测到这种变化,并如何在数据库中自动对它更新的。这实际上是hibernate的一个很有价值的特色,我们把它称为“自动脏数据检测”,hibernate的这个特色使得当我们修改一个持久对象的属性后,不必显式地通知hibernate去将它在数据库中进行更新。同样的,当第一个message对象调用setnextmessage()方法将第二个message对象作为它的下一条消息的引用时,第二条消息会无需调用save()方法,便可以自动地保存在数据库中。这种特色被称为“级联保存”,它也免去了我们显式地对第二个message对象调用save()方法之苦。

  如果我们再运行先前的那段将数据库中所有的message对象都打印出来的代码,那它的运行结果如下:

  2 message(s) found:
  greetings earthling
  take me to your leader (please)


  “hello world”示例程序现在介绍完毕。我们总算对hibernate有了一个简单的认识,下面我们将回过头来,对hibernate的主要api调用作一下简要的介绍:
  

  理解hibernate的架构

  当你想用hibernate开发自己的基于持久层的应用时,第一件事情应当是熟悉它的编程接口。hibernate的api接口设计得尽量简洁明了,以方便开发人员。然而实际上由于orm的复杂性,它的api一般都不可能设计得很简单。但是别担心,你没有必要一下子了解所有的hibernate的api接口。

  我们将应用层放在了持久层的上部,实际上在传统的项目中,应用层充当着持久层的一个客户端角色。但对于一些简单的项目来说,应用层和持久层并没有区分得那么清楚,这也没什么,在这种情况下你可以将应用层和持久层合并成了一层。

  hibernate的接口大致可以分为以下几种类型:

  · 一些被用户的应用程序调用的,用来完成基本的创建、读取、更新、删除操作以及查询操作的接口。这些接口是hibernate实现用户程序的商业逻辑的主要接口,它们包括session、transaction和query。

  · hibernate用来读取诸如映射表这类配置文件的接口,典型的代表有configuration类。

  · 回调(callback)接口。它允许应用程序能对一些事件的发生作出相应的操作,例如interceptor、lifecycle和validatable都是这一类接口。

  · 一些可以用来扩展hibernate的映射机制的接口,例如usertype、compositeusertype和identifiergenerator。这些接口可由用户程序来实现(如果有必要)。

  hibernate使用了j2ee架构中的如下技术:jdbc、jta、jndi。其中jdbc是一个支持关系数据库操作的一个基础层;它与jndi和jta一起结合,使得hibernate可以方便地集成到j2ee应用服务器中去。

  在这里,我们不会详细地去讨论hibernate api接口中的所有方法,我们只简要讲一下每个主要接口的功能,如果你想了解得更多的话,你可以在hibernate的源码包中的net.sf.hibernate子包中去查看这些接口的源代码。下面我们依次讲一下所有的主要接口:

  核心接口

  以下5个核心接口几乎在任何实际开发中都会用到。通过这些接口,你不仅可以存储和获得持久对象,并且能够进行事务控制。

  session接口

  session接口对于hibernate 开发人员来说是一个最重要的接口。然而在hibernate中,实例化的session是一个轻量级的类,创建和销毁它都不会占用很多资源。这在实际项目中确实很重要,因为在客户程序中,可能会不断地创建以及销毁session对象,如果session的开销太大,会给系统带来不良影响。但值得注意的是session对象是非线程安全的,因此在你的设计中,最好是一个线程只创建一个session对象。

  在hibernate的设计者的头脑中,他们将session看作介于数据连接与事务管理一种中间接口。我们可以将session想象成一个持久对象的缓冲区,hibernate能检测到这些持久对象的改变,并及时刷新数据库。我们有时也称session是一个持久层管理器,因为它包含这一些持久层相关的操作,诸如存储持久对象至数据库,以及从数据库从获得它们。请注意,hibernate 的session不同于jsp应用中的httpsession。当我们使用session这个术语时,我们指的是hibernate中的session,而我们以后会将httpsesion对象称为用户session。

  sessionfactory 接口

  这里用到了一个设计模式――工厂模式,用户程序从工厂类sessionfactory中取得session的实例。

  令你感到奇怪的是sessionfactory并不是轻量级的!实际上它的设计者的意图是让它能在整个应用*享。典型地来说,一个项目通常只需要一个sessionfactory就够了,但是当你的项目要操作多个数据库时,那你必须为每个数据库指定一个sessionfactory。
  sessionfactory在hibernate中实际起到了一个缓冲区的作用,它缓冲了hibernate自动生成的sql语句和一些其它的映射数据,还缓冲了一些将来有可能重复利用的数据。

  configuration 接口

  configuration接口的作用是对hibernate进行配置,以及对它进行启动。在hibernate的启动过程中,configuration类的实例首先定位映射文档的位置,读取这些配置,然后创建一个sessionfactory对象。

  虽然configuration接口在整个hibernate项目中只扮演着一个很小的角色,但它是启动hibernate时你所遇到的每一个对象。

  transaction 接口

  transaction接口是一个可选的api,你可以选择不使用这个接口,取而代之的是hibernate的设计者自己写的底层事务处理代码。 transaction接口是对实际事务实现的一个抽象,这些实现包括jdbc的事务、jta中的usertransaction、甚至可以是corba事务。之所以这样设计是能让开发者能够使用一个统一事务的操作界面,使得自己的项目可以在不同的环境和容器之间方便地移值。

  query和criteria接口

  query接口让你方便地对数据库及持久对象进行查询,它可以有两种表达方式:hql语言或本地数据库的sql语句。query经常被用来绑定查询参数、限制查询记录数量,并最终执行查询操作。

  criteria接口与query接口非常类似,它允许你创建并执行面向对象的标准化查询。

  值得注意的是query接口也是轻量级的,它不能在session之外使用。

  callback 接口

  当一些有用的事件发生时――例如持久对象的载入、存储、删除时,callback接口会通知hibernate去接收一个通知消息。一般而言,callback接口在用户程序中并不是必须的,但你要在你的项目中创建审计日志时,你可能会用到它。

   一个重要的术语:type

  hibernate的设计者们发明了一个术语:type,它在整个构架中是一个非常基础、有着强大功能的元素。一个type对象能将一个java类型映射到数据库中一个表的字段中去(实际上,它可以映射到表的多个字段中去)。持久类的所有属性都对应一个type。这种设计思想使用hibernate有着高度的灵活性和扩展性。

  hibernate内置很多type类型,几乎包括所有的java基本类型,例如java.util.currency、java.util.calendar、byte[]和java.io.serializable。

  不仅如此,hibernate还支持用户自定义的type,通过实现接口usertype和接口compositeusertype,你可以加入自己的type。你可以利用这种特色让你的项目中使用自定义的诸如address、name这样的type,这样你就可以获得更大的便利,让你的代码更优雅。自定义type在hibernate中是一项核心特色,它的设计者鼓励你多多使用它来创建一个灵活、优雅的项目!

  策略接口

  hibernate与某些其它开源软件不同的还有一点――高度的可扩展性,这通过它的内置策略机制来实现。当你感觉到hibernate的某些功能不足,或者有某些缺陷时,你可以开发一个自己的策略来替换它,而你所要做的仅仅只是继承它的某个策略接口,然后实现你的新策略就可以了,以下是它的策略接口:

  · 主键的生成 (identifiergenerator 接口)

  · 本地sql语言支持 (dialect 抽象类)

  · 缓冲机制 (cache 和cacheprovider 接口)

  · jdbc 连接管理 (connectionprovider接口)

  · 事务管理 (transactionfactory, transaction, 和 transactionmanagerlookup 接口)

  · orm 策略 (classpersister 接口)

  · 属性访问策略 (propertyaccessor 接口)

  · 代理对象的创建 (proxyfactory接口)

  hibernate为以上所列的机制分别创建了一个缺省的实现,因此如果你只是要增强它的某个策略的功能的话,只需简单地继承这个类就可以了,没有必要从头开始写代码。

  以上就是hibernate的一些核心接口,但当我们真正开始用它进行开发时,你的脑海里可能总会有一个疑问:我是通过什么方式,并从哪里取得session的呢?以下我们就解答这个问题。

  基础配置

  现在回顾一下我们先前的内容:我们写出了一个示例程序,并简要地讲解了hibernate的一些核心类。但要真正使你的项目运行起来,还有一件事必须要做:配置。hibernate可以配置成可在任何java环境中运行,一般说来,它通常被用在2-3层的c/s模式的项目中,并被部署在服务端。在这种项目中,web浏览器、或java gui程序充当者客户端。尽管我们的焦点主要是集中在多层web应用,但实际上在一些基于命令行的应用中也可以使用hibernate。并且,对hibernate的配置在不同的环境下都会不同,hibernate运行在两种环境下:可管理环境和不可管理环境

  · 可管理环境――这种环境可管理如下资源:池资源管理,诸如数据库连接池和,还有事务管理、安全定义。一些典型的j2ee服务器(jboss、weblogic、websphere)已经实现了这些。

  · 不可管理环境――只是提供了一些基本的功能,诸如像jetty或tomcat这样的servlet容器环境。一个普通的java桌面应用或命令行程序也可以认为是处于这种环境下。这种环境不能提供自动事务处理、资源管理或安全管理,这些都必须由应用程序自己来定义。

  hibernate的设计者们将这两种环境设计了一个统一的抽象界面,因此对于开发者来说只有一种环境:可管理环境。如果实际项目是建立在诸如tomcat这类不可管理的环境中时,那hibernate将会使用它自己的事务处理代码和jdbc连接池,使其变为一个可管理环境。
  对于可管理的环境而言,hibernate会将自己集成在这种环境中。对于开发者而言,你所要做的工作非常简单:只需从一个configuration类中创建一个sessionfactory类就可以了。
   创建一个sessionfactory对象

  为了能创建一个sessionfactory对象,你必须在hibernate初始化时创建一个configuration类的实例,并将已写好的映射文件交由它处理。这样,configuration对象就可以创建一个sessionfactory对象,当sessionfactory对象创建成功后,configuration对象就没有用了,你可以简单地抛弃它。如下是示例代码:

  configuration cfg = new configuration();
  cfg.addresource("hello/message.hbm.xml");
  cfg.setproperties( system.getproperties() );
  sessionfactory sessions = cfg.buildsessionfactory();

  在以上代码中,message.hb.xml这个映射文件的位置比较特殊,它与当前的classpath相关。例如classpath包含当前目录,那在上述代码中的message.hbm.xml映射文件就可以保存在当前目录下的hello目录中。

  作为一种约定,hibernate的映射文件默认以.htm.xml作为其扩展名。另一个约定是坚持为每一个持久类写一个配置文件,想一想如果你将所有持久类的映射写入一个单独的配置文件中的话,那这个配置文件肯定非常庞大,不易维护。但这里又出现了一个新问题:如果为每个类写一个配置文件的话,这么多的配置文件应该存放在哪里呢?

  hibernate推荐你将每个映射文件保存在与持久类相同的目录下,并且与持久类同名。例如我们第一个示例程序中的message持久类放在hello目录下,那你必须在这个目录下存放名为message.hbm.xml的映射文件。这样一个持久类都有自己的一个映射文件,避免了出现像struts项目中的“struts-config.xml地狱”的情况。如果你不遵循这种规定,那你必须手动地用addresource()方法将一个个的映射文件载入;但你如果遵循这种规定,那你可以方便地用addclass()方法同时将持久类和它的映射文件载入,以下是体现这种便利性的示例代码:

  sessionfactory sessions = new configuration()
  .addclass(org.hibernate.auction.model.item.class)
  .addclass(org.hibernate.auction.model.category.class)
  .addclass(org.hibernate.auction.model.bid.class)
  .setproperties( system.getproperties() )
  .buildsessionfactory();

  当然,hibernate的映射文件还有很多其它的配置选项,比如数据库连接的设定,或是能够改变hibernate运行时行为的一些设定。所有的设置可能是非常庞杂的,足以让你喘不过气来,但是不必担心,因为hibernate为绝大多数值都设定了一个合理缺省值,你只需要修改这些配置文件中的极小一部分值。

  你可以通过以下几种方式来修改hibernate的系统配置参数:

  · 将一个java.util.properties实例作为参数传给configuration类的setproperties()方法。

  · 在hibernate启动时用java –dproperty=value的方式设置值。

  · 在classpath可以找到的路径下创建一个名为hibernate.properties的配置文件。

  · 在classpath可以找到的路径下创建一个名为hibernate.cfg.xml的文件,并在其<property>标签中定义属性值。

  以上就是对hibernate的一个大致介绍,如果你想知道得更多,那本文还是远远不够的,我将陆续推出更多关于hibernate的资料。但有一点是毫无疑问的:它的确是一个非常优秀的持久层解决方案!