【導(dǎo)讀】本文的目的是演示一下Hibernate的安裝過程以及最基本的功能,包括下載文件、配置環(huán)境、創(chuàng)建數(shù)據(jù)庫、創(chuàng)建Hibernate映射文件、配置Hibernate描述文件、開始運(yùn)行等。

其實Hibernate本身是個獨(dú)立的框架,它不需要任何web server或application server的支持。然而,大多數(shù)的Hibernate入門介紹都加入了很多非Hibernate的東西,比如:Tomcat, Eclipse, Log4J,Struts, XDoclet, 甚至JBoss。這容易讓人產(chǎn)生Hibernate復(fù)雜難懂的誤解,特別是打擊了初學(xué)者的積極性。

在這篇文章將不涉及Eclipse, log4j, Struts, Tomcat, XDoclet,和JBoss。本文的目的是演示一下Hibernate的安裝過程以及最基本的功能,從而給初學(xué)者一個低得不能再低的入門門檻。

下載文件

你需要Java SDK、Hibernate包、Ant包、和JDBC Driver。

1、Hibernate包下載地址

http://prdownloads.sourceforge.net/hibernate/?sort_by=date&sort=desc

2、Ant包下載地址

http://apache.130th.net/ant/binaries/apache-ant-1.6.1-bin.zip

3、 JDBC Driver要根據(jù)你用的database來定,一般database官方網(wǎng)站上都會有。Hibernate支持常用的database,比如 MySQL, Oracle, PostgreSQL, 和MS-SQL Server。這些數(shù)據(jù)庫都有JDBC Driver:

Oracle JDBC Driver下載地址(下載前必須同意Oracle協(xié)議書)

http://otn.oracle.com/software/htdocs/distlic.html?/software/tech/java/sqlj_jdbc/htdocs/jdbc9201.html

MySQL JDBC Driver下載地址

http://dev.mysql.com/downloads/connector/j/3.0.html

PostgreSQL JDBC Driver下載地址

http://jdbc.postgresql.org/download.html

MS-SQL Server JDBC Driver下載地址

http://www.microsoft.com/downloads/details.aspx?FamilyID=9f1874b6-f8e1-4bd6-947c-0fc5bf05bf71&displaylang=en

4、將Hibernate包和Ant包分別解壓至c:\dev\下(此目錄不重要,你可以換其它任何目錄)。

配置環(huán)境

1、你需要添加一個新的環(huán)境變量: ANT_HOME,讓它指向c:\dev\<你的ANT包所在目錄>。并在PATH環(huán)境變量里添加%ANT_HOME%\bin。

2、你需要添加一個新的環(huán)境變量: JAVA_HOME,讓它指向你的j2sdk根目錄。并在PATH環(huán)境變量里添加%JAVA_HOME%\bin。

3、創(chuàng)建一個項目目錄,比如c:\workspace\My1stHibernate。

在項目目錄下,另外創(chuàng)建三個目錄:src, classes, lib。

在lib目錄下,創(chuàng)建兩個目錄:hibernate和db。

這樣你有了如下的文件結(jié)構(gòu):

c:\workspace\My1stHibernate\

c:\workspace\My1stHibernate\src

c:\workspace\My1stHibernate\classes

c:\workspace\My1stHibernate\lib

c:\workspace\My1stHibernate\lib\hibernate

c:\workspace\My1stHibernate\lib\db

4、將c:\dev\<你的Hibernate包所在目錄>\hibernate2.jar文件copy到c:\workspace\My1stHibernate\lib\hibernate下。

將c:\dev\<你的Hibernate包所在目錄>\lib\下的所有文件同樣copy到c:\workspace\My1stHibernate\lib\hibernate下。

將你的JDBC Driver文件(一般是一個jar文件)copy到c:\workspace\My1stHibernate\lib\db下。

創(chuàng)建數(shù)據(jù)庫

1、用你最喜愛的database軟件,創(chuàng)建一個hibernate_test的數(shù)據(jù)庫。

2、在此數(shù)據(jù)庫下,新建一個table名為CUSTOMER

CREATE TABLE CUSTOMER

(

 CID INTEGER NOT NULL PRIMARY KEY, USERNAME VARCHAR(12) NOT NULL,

PASSWORD VARCHAR(12)

);

編寫Java文件

public class Customer {

 private int id;

 private String username;

 private String password;

 public int getId() {

return id;

 }

 public String getPassword() {

return password;

 }

 public String getUsername() {

return username;

 }

 public void setId(int id) {

this.id = id;

 }

 public void setPassword(String password) {

this.password = password;

 }

 public void setUsername(String username) {

this.username = username;

 }

}

將此類存為c:\workspace\My1stHibernate\src\Customer.java文件。

編寫Test類

import net.sf.hibernate.*;

import net.sf.hibernate.cfg.*;

public class Test {

 public static void main(String[] args) {

try {

 SessionFactory sf = new Configuration().configure().buildSessionFactory();

 Session session = sf.openSession();

 Transaction tx = session.beginTransaction();

 for (int i = 0; i < 200; i++) {

Customer customer = new Customer();

customer.setUsername("customer" + i);

customer.setPassword("customer");

session.save(customer);

 }

 tx.commit();

 session.close();

} catch (HibernateException e) {

 e.printStackTrace();

}

 }

}

將此類存為c:\workspace\My1stHibernate\src\Test.java文件。


創(chuàng)建Hibernate映射文件

因為這里只有一個Class --- Customer 和一個Table --- CUSTOMER,你只需要建立一個映射文件--- Customer.hbm.xml,來對應(yīng)Customer類和CUSTOMER表之間的關(guān)系。

<?xml version="1.0"?>

<!DOCTYPE hibernate-mapping PUBLIC

"-//Hibernate/Hibernate Mapping DTD//EN"

"

<hibernate-mapping>

<class name="Customer" table="CUSTOMER">

<id name="id" column="CID">

<generator class="increment" />

</id>

<property name="username" column="USERNAME" />

<property name="password" column="PASSWORD" />

</class>

</hibernate-mapping>

把此文件存為c:\workspace\My1stHibernate\src\Customer.hbm.xml,和Customer.java放在同一目錄下。

編寫Ant build.xml文件

你不一定要知道這個build.xml的細(xì)節(jié),其實Ant也不是Hibernate所必須的。這里用Ant是為了簡化一些任務(wù),比如:編譯、copy、運(yùn)行等。

<?xml version="1.0" ?>

<project name="My1stHibernate" default="build" basedir=".">

<property name="base.dir" value="." />

<property name="src.dir" value="src" />

<property name="lib.dir" value="lib" />

<property name="build.dir" value="classes" />

<path id="myclasspath">

<fileset dir="${lib.dir}">

<include name="**/*.jar" />

</fileset>

<pathelement location="${build.dir}" />

</path>

<target name="init">

<mkdir dir="${build.dir}" />

</target>

<target name="build" depends="init" description="compile the source files">

<javac classpathref="myclasspath" srcdir="${src.dir}" destdir="${build.dir}" />

<copy todir="${build.dir}" >

<fileset dir="${src.dir}" >

<exclude name="**/*.java"/>

</fileset>

</copy>

</target>

<target name="run" depends="build">

<java classpathref="myclasspath" classname="Test" fork="true" />

</target>

<target name="clean">

<delete includeEmptyDirs="true">

<fileset dir="${build.dir}" />

</delete>

</target>

</project>

配置Hibernate描述文件

Hibernate描述文件可以是一個properties或xml 文件,其中最重要的是定義數(shù)據(jù)庫的連接。我這里列出的是一個XML格式的hibernate.cfg.xml描述文件。

<?xml version="1.0" encoding="utf-8" ?>

<!DOCTYPE hibernate-configuration

PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"

"

<hibernate-configuration>

<session-factory name="java:/hibernate/HibernateFactory">

<property name="show_sql">true</property>

<property name="connection.driver_class">

oracle.jdbc.driver.OracleDriver <!-- 這里是Oracle 9i的JDBC driver class名 -->

</property>

<property name="connection.url">

jdbc:oracle:oci8:@hibernate_test <!-- 這里是Oracle的hibernate_test數(shù)據(jù)庫URL -->

</property>

<property name="connection.username">

你的數(shù)據(jù)庫用戶名

</property>

<property name="connection.password">

你的數(shù)據(jù)庫密碼

</property>

<property name="dialect">

net.sf.hibernate.dialect.Oracle9Dialect <!-- 這里是Oracle 9i的Dialect -->

</property>

<mapping resource="Customer.hbm.xml" /> <!-- 指定Customer的映射文件 -->

</session-factory>

</hibernate-configuration>

如果你用的不是Oracle 9i,可到C:\dev\<你的Hibernate包所在目錄>\src\hibernate.properties文件里找到你的數(shù)據(jù)庫,然后替換以上相對應(yīng)的值。

開始運(yùn)行

到c:\workspace\My1stHibernate下,運(yùn)行ant run。如果你嚴(yán)格依照以上步驟,應(yīng)該看到

run:

[java] log4j:WARN No appenders could be found for logger (net.sf.hibernate.cfg.Environment).

[java] log4j:WARN Please initialize the log4j system properly.

[java] Hibernate: insert into CUSTOMER (USERNAME, PASSWORD, CID) values (?, ?, ?)

BUILD SUCCESSFUL

到你的hibernate_test數(shù)據(jù)庫看一下,在CUSTMOR表里新添了200條記錄,但你沒有寫任何JDBC code。

以后如果你要更換數(shù)據(jù)庫,只需要改變hibernate.cfg.xml描述文件里相應(yīng)的值即可。