从今天开始,我们一起来进入有关Hibernate框架的学习,Hibernate框架实际上是基于JDBC的高度封装的框架,所以对比起来Hibernate的运行效率没有JDBC效率高但是Hibernate的开发效率却比JDBC的要高,这也是企业级开发所追求的。所以目前大部分企业开发都不会使用JDBC。欲工善其事,必先利其器,首先我们熟悉下Hibernate环境搭建。
Hibernate环境搭建步骤:
第一步:获取到Hibernate发布包,可以去Hibernate官网上去下载,或者去GitHub直接搜索Hibernate,Hibernate的代码是托管到GitHub
下载地址:https://sourceforge.net/projects/hibernate/files/hibernate3/,官网下载地址:http://in.relation.to/hibernate-orm/.我这里的拿到的发布包是Hibernate3现在更新到4版本了,不管用3还是4都可以,但是一定要统一,不要既用部分3.0的jar包,又使用了4.0的jar这样就会出问题,到后期开发中会出现一系列的问题,建议统一所有jar版本,其实也不用担心,你只需要下载一个完整的Final包,所需的jar里面全都有。下载完Final包后解压后的目录如下图:
Hibernate一共包括了23个jar包,令人眼花缭乱。本文将详细讲解Hibernate每个jar包的作用,便于你在应用中根据自己的需要进行取舍。
下载Hibernate,例如3.6.1稳定版本,解压缩,可以看到一个hibernate3.jar和lib目录下有22个jar包:
hibernate3.jar:
Hibernate的库,没有什么可说的,必须使用的jar包
cglib-asm.jar:
CGLIB库,Hibernate用它来实现PO字节码的动态生成,非常核心的库,必须使用的jar包
dom4j.jar:
dom4j是一个Java的XML API,类似于jdom,用来读写XML文件的。dom4j是一个非常非常优秀的Java XML API,具有性能优异、功能强大和极端易用使用的特点,同时它也是一个开放源代码的软件,可以在SourceForge上找到它。在IBM developerWorks上面可以找到一篇文章,对主流的Java XML API进行的性能、功能和易用性的评测,dom4j无论在那个方面都是非常出色的。我早在将近一年之前就开始使用dom4j,直到现在。如今你可以看到越来越多的Java软件都在使用dom4j来读写XML,特别值得一提的是连Sun的JAXM也在用dom4j。这是必须使用的jar包,Hibernate用它来读写配置文件。
odmg.jar:
ODMG是一个ORM的规范,Hibernate实现了ODMG规范,这是一个核心的库,必须使用的jar包。
commons-collections.jar:
Apache Commons包中的一个,包含了一些Apache开发的集合类,功能比java.util.*强大。必须使用的jar包。
commons-beanutils.jar:
Apache Commons包中的一个,包含了一些Bean工具类类。必须使用的jar包。
commons-lang.jar:
Apache Commons包中的一个,包含了一些数据类型工具类,是java.lang.*的扩展。必须使用的jar包。
commons-logging.jar:
Apache Commons包中的一个,包含了日志功能,必须使用的jar包。这个包本身包含了一个Simple Logger,但是功能很弱。在运行的时候它会先在CLASSPATH找log4j,如果有,就使用log4j,如果没有,就找JDK1.4带的java.util.logging,如果也找不到就用Simple Logger。commons-logging.jar的出现是一个历史的的遗留的遗憾,当初Apache极力游说Sun把log4j加入JDK1.4,然而JDK1.4项目小组已经接近发布JDK1.4产品的时间了,因此拒绝了Apache的要求,使用自己的java.util.logging,这个包的功能比log4j差的很远,性能也一般。后来Apache就开发出来了commons-logging.jar用来兼容两个logger。因此用commons-logging.jar写的log程序,底层的Logger是可以切换的,你可以选择log4j,java.util.logging或者它自带的Simple
Logger。不过我仍然强烈建议使用log4j,因为log4j性能很高,log输出信息时间几乎等于System.out,而处理一条log平均只需要5us。你可以在Hibernate的src目录下找到Hibernate已经为你准备好了的log4j的配置文件,你只需要到Apache 网站去下载log4j就可以了。commons-logging.jar也是必须的jar包。
使用Hibernate必须的jar包就是以上的这几个,剩下的都是可选的。
ant.jar:
Ant编译工具的jar包,用来编译Hibernate源代码的。如果你不准备修改和编译Hibernate源代码,那么就没有什么用,可选的jar包
optional.jar:
Ant的一个辅助包。
c3p0.jar:
C3PO是一个数据库连接池,Hibernate可以配置为使用C3PO连接池。如果你准备用这个连接池,就需要这个jar包。
proxool.jar:
也是一个连接池,同上。
commons-pool.jar, commons-dbcp.jar:
DBCP数据库连接池,Apache的Jakarta组织开发的,Tomcat4的连接池也是DBCP。
实际上Hibernate自己也实现了一个非常非常简单的数据库连接池,加上上面3个,你实际上可以在Hibernate上选择4种不同的数据库连接池,选择哪一个看个人的偏好,不过DBCP可能更通用一些。另外强调一点,如果在EJB中使用Hibernate,一定要用App Server的连接池,不要用以上4种连接池,否则容器管理事务不起作用。
connector.jar:
JCA 规范,如果你在App Server上把Hibernate配置为Connector的话,就需要这个jar。不过实际上一般App Server肯定会带上这个包,所以实际上是多余的包。
jaas.jar:
JAAS是用来进行权限验证的,已经包含在JDK1.4里面了。所以实际上是多余的包。
jcs.jar:
如果你准备在Hibernate中使用JCS的话,那么必须包括它,否则就不用。
JDBC2_0-stdext.jar:
JDBC2.0的扩展包,一般来说数据库连接池会用上它。不过App Server都会带上,所以也是多余的。
jta.jar:
JTA规范,当Hibernate使用JTA的时候需要,不过App Server都会带上,所以也是多余的。
junit.jar:
Junit包,当你运行Hibernate自带的测试代码的时候需要,否则就不用。
xalan.jar, xerces.jar, xml-apis.jar:
Xerces是XML解析器,Xalan是格式化器,xml-apis实际上是JAXP。一般App Server都会带上,JDK1.4也包含了解析器,不过不是Xerces,是Crimson,效率比较差,不过Hibernate用XML只不过是读取配置文件,性能没什么紧要的,所以也是多余的。
通过上面对Hibernate下的23个jar包作用的简单分析和介绍,相信你应该知道怎么去选择适合你开发的jar吧,但是对于一般新手入门开发Hibernate所必须的jar只有8个
这个8个jar分别是:1、Hibernate3.jar,Hibernate库jar包肯定是必须的 2、在你的解压目录下有个lib目录,lib目录中有四个文件夹,选择require(必需的)文件夹中全部的6个jar,
然后再选择jpa文件夹中的全部的1个jar,总共8个jar包。
第二步:打开Eclipse新建一个Dynamic Web Project,并且在项目的根目录下新建一个dtd文件夹,然后在Final包解压文件夹内有个Hibernate3.jar也即是Hibernate的核心库用解压缩软件将其解压,解压的后到hibernate目录中找到两个以.dtd结尾的文件,将他们复制到我们刚刚建好的dtd文件目录下。实际上这两个文件就是分别配置Hibernate中的核心配置文件,和关系映射文件。
第三步将我们上面选好的8个jar放入到webContent中的WEB-INF/lib目录下,此外我们还需要放入一个连接数据库的驱动包,我这里使用的mysql数据驱动包。记住一定要放到webContent中的WEB-INF/lib目录下,不要自己去建个文件夹然后再Add Bulide path这样在以后的Web开发中会报异常找不到类的异常,也不需要Add bulide Path,因为这是一个动态的Web项目,它会自动加入到路径中。
第四步:配置Hibernate的核心配置文件hibernate.cfg.xml,在项目的src目录下新建一个XML文件,src目录是Hibernate默认加载目录,记住在新建Hibernate配置文件的时候
一定不要自己随意取名字,它只有一个名字hibernate.cfg.xml,不要写错,否则环境是无效的。
然后接着打开dtd目录下的hibernate-configuration-3.0.dtd文件如下:
将选中的代码粘贴到hibernate.cfg.xml中,并且再将选中的URL复制一下
然后按照图上红箭头操作:
确认配置好后如图,并且可以打出Hibernate配置代码提示就说明我们已经关联好了。
最后,我们就可以通过代码在该XML文件配置Hibernate了,但是由于很多配置的代码根本不熟,所以我们需要去Copy文档中的实例,注意这种代码不需要你记住,因为记住它没有多大意义,所以还是看文档吧。文档在哪看呢?在解压后的发布包的文件夹中有个documentation文件夹,然后里面有个manual文件夹,打开该文件夹,里面有个zh_CN的中文API文档,打开zh_CN里面有个html文件夹里面全是一些html格式的文档,找到Hibernate配置那一栏,然后复制<hibernate-configuration>标签内所有的内容,然后将复制的内容拷贝到我们建好的hibernate.cfg.xml中即可。
最终hibernate.cfg.xml配置代码如下:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- Database connection settings --> <property name="connection.driver_class">com.mysql.jdbc.Driver</property><!-- 数据库的驱动完整类名 ,根据自己需求替换--> <property name="connection.url">jdbc:mysql://127.0.0.1:3306/demo</property><!-- 数据库连接地址 /后跟数据库名,根据自己需求替换--> <property name="connection.username">root</property><!-- 用户名根据自己需求替换 --> <property name="connection.password">root</property><!-- 密码 根据自己需求替换--> <!-- JDBC connection pool (use the built-in) --> <property name="connection.pool_size">1</property> <!-- SQL dialect --> <property name="dialect">org.hibernate.dialect.MySQLDialect</property><!-- 设置相应数据库的方言根据自己需求替换 --> <!-- Enable Hibernate's automatic session context management --> <property name="current_session_context_class">thread</property> <!-- Disable the second-level cache --> <property name="cache.provider_class">org.hibernate.cache.NoCacheProvider</property> <!-- Echo all executed SQL to stdout --> <property name="show_sql">true</property><!--打印sql语句到控制台 --> <property name="format_sql">true</property><!--对打印到控制台的sql语句进行格式化 --> <!-- Drop and re-create the database schema on startup --> <property name="hbm2ddl.auto">update</property><!-- 自动建表 --> </session-factory> </hibernate-configuration>
第五步配置表的映射文件,Hibernate中的映射文件非常重要,可以借助映射文件将我们的Bean类转换成数据库中的一张表,也就是说我们只要把Bean类建好了,写好了映射文件的信息,并把映射文件配置到配置文件中,利用Hibernate的API就可以实现自动创建数据表,这个也是检测我们Hibernate环境是否搭建好的方法之一。
那么我们首先就来建一个Student类(Bean类)对象和一个测试类对象TableTest.并且先建立一个空的名为demo的数据库。
那么接下来就配置映射文件,记住在bean包下新建一个xml文件,文件名字是Student(Bean类的小写),student.hbm.xml,然后打开dtd目录下的hibernate-mapping-3.0.dtd文件,然后打开该文件,复制头部分内容,将这些内容粘贴到student.hbm.xml中。
然后以上选中的URL复制一下,按照如同以上配置
最后只要检测到代码提示就说明已经关联成功了。那么接下来就是怎么去写映射文件了,我在这里就不去找API了,我就给出一个格式,以后基本可以按照这个格式来即可
注意:以后在写映射文件的时候一定要对应Bean类来写,这里为了好看和理解方便,我就把Student(Bean类)和student.hbm.xml映射文件放在一起对应看。
package com.mikyou.bean; import java.io.Serializable; public class Student implements Serializable{ /** * */ private static final long serialVersionUID = 1L; private Long id; private String name; private int age; private String sex; public Student(Long id, String name, int age, String sex) { super(); this.id = id; this.name = name; this.age = age; this.sex = sex; } public Student() { // TODO Auto-generated constructor stub } 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; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } public String getSex() { return sex; } public void setSex(String sex) { this.sex = sex; } public static long getSerialversionuid() { return serialVersionUID; } @Override public String toString() { return "Student [id=" + id + ", name=" + name + ", age=" + age + ", sex=" + sex + "]"; } }
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> <hibernate-mapping package="com.mikyou.bean"><!-- 这里表示Student,Bean类所在包路径 --> <class name="Student" table="demo_student"><!-- 左边的name为类名 对应着 数据库中的表名demo_student --> <id name="id" column="id"><!-- id标签表示主键生成即表示Student中的id属性,对应数据库表中的id列,并且该列为该表的主键 --> <generator class="increment" /><!-- 这里表示主键生成机制为自增的方式,这里有多种方式以后会详细描述 --> </id> <property name="name" /><!-- 注意:这里填写的这些属性名一定要与Student类中的属性名一致 --> <property name="age" /> <property name="sex" /> </class> </hibernate-mapping>
第六步,将我们写好的映射文件,配置到hibernate.cfg.xml配置文件中,在引入之前一定要检查你的映射文件和Bean类中的属性是否对应,否则还是无法自动创建表。
很简单只需要将 <mapping resource="com/mikyou/bean/student.hbm.xml" />这行代码放入到配置文件中,resource配置的是映射文件相对项目工程所在的路径
最终的配置文件的代码如下:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- Database connection settings --> <property name="connection.driver_class">com.mysql.jdbc.Driver</property><!-- 数据库的驱动完整类名 ,根据自己需求替换--> <property name="connection.url">jdbc:mysql://127.0.0.1:3306/demo</property><!-- 数据库连接地址 /后跟数据库名,根据自己需求替换--> <property name="connection.username">root</property><!-- 用户名根据自己需求替换 --> <property name="connection.password">root</property><!-- 密码 根据自己需求替换--> <!-- JDBC connection pool (use the built-in) --> <property name="connection.pool_size">1</property> <!-- SQL dialect --> <property name="dialect">org.hibernate.dialect.MySQLDialect</property><!-- 设置相应数据库的方言根据自己需求替换 --> <!-- Enable Hibernate's automatic session context management --> <property name="current_session_context_class">thread</property> <!-- Disable the second-level cache --> <property name="cache.provider_class">org.hibernate.cache.NoCacheProvider</property> <!-- Echo all executed SQL to stdout --> <property name="show_sql">true</property><!--打印sql语句到控制台 --> <property name="format_sql">true</property><!--对打印到控制台的sql语句进行格式化 --> <!-- Drop and re-create the database schema on startup --> <property name="hbm2ddl.auto">update</property><!-- 自动建表 --> <mapping resource="com/mikyou/bean/student.hbm.xml" /><!-- 引入映射文件,里面为映射文件所在的路径 --> </session-factory> </hibernate-configuration>
第七步,终于到了最后一步了,编写建表测试类并通过代码插入一条记录,并查看数据表是否建立成功,数据是否插入成功。
package com.mikyou.test; import java.util.Date; import org.hibernate.SessionFactory; import org.hibernate.Transaction; import org.hibernate.cfg.Configuration; import org.hibernate.classic.Session; import com.mikyou.bean.Student; public class TableTest { public static void main(String[] args) { //1、创建配置对象 Configuration config=new Configuration(); //2、读取配置文件, config.configure();//注意这里有很多的重载的方法。默认是在src目录下加载配置文件 //3、根据配置文件信息创建一级缓存,SessionFactory重量级对象,不要频繁创建 SessionFactory factory=config.buildSessionFactory(); //4、创建Session 打开会话 Session session=factory.openSession(); //5、开启事务 Transaction transaction=session.beginTransaction(); Student student=new Student(null, "Mikyou", 22, "男"); session.save(student); //6、事务提交 transaction.commit(); //7、Session关闭 } }
测试结果:
通过测试结果发现,我们的表自动建立成功也就意味着我们的Hibernate环境搭建成功。