Hibernate入门 - 基础配置
Hibernate配置文件可以有两种格式,一种是 hibernate.properties ,另一种是 hibernate.cfg.xml
后者稍微方便一些,当增加hbm映射文件的时候,可以直接在 hibernate.cfg.xml 里面增加,不必像 hibernate.properties 必须在初始化代码中加入。
但不管怎么说,两种的配置项都是一样的,下面详细介绍:
在Hibernate的src目录下有一个 hibernate.properties 模板,我们不必自己从头写,修改模板就可以了:)
hibernate.query.substitutions true 1, false 0, yes 'Y', no 'N'
这个配置意思是当你在Hibernate里面输入true的时候,Hibernate会转化为1插入数据库,当你在Hibernate里面输入false的时候,Hibernate会转化为0插入数据库,后面的Y,N同理。
对于某些数据库,例如Oracle来说,没有boolean数据类型,就是采用1代表true,0代表false,因此使用这个配置在Hibernate里面直接用true/false会非常直观。
hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
hibernate.connection.driver_class com.mysql.jdbc.Driver
hibernate.connection.url jdbc:mysql:///test
hibernate.connection.username root
hibernate.connection.password
这是一个连接MySQL数据库的例子,很直观,不必解释,不同的数据库的连接参数模板中全部给出了。
hibernate.connection.pool_size 1
hibernate.statement_cache.size 25
这是Hibernate自带的连接池的配置参数,在默认情况下将采用。意义很直观,不多解释。
只是提醒一点,Hibernate这个连接池是非常原始非常简单的连接池,如果你在项目中用Hibernate的话,建议你首选App Server的连接池,次选Hibernate带的DBCP连接池。自带的连接池应该做为末选。
如果你采用DBCP连接池,除了要配置DBCP连接池以外,还需要取消掉下行的注释:
hibernate.connection.provider_class net.sf.hibernate.connection.DBCPConnectionProvider
其它的连接池同理。
如果采用App Server的连接池,假设App Server连接池的DataSource的JNDI名称为"mypool"的话,配置应该如下:
hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
hibernate.connection.datasource mypool
hibernate.connection.provider_class net.sf.hibernate.connection.DatasourceConnectionProvider
其它参数就不必写了,因为已经在App Server配置连接池的时候指定好了。
如果你不是在App Server环境中使用Hibernate,例如远程客户端程序,但是你又想用App Server的数据库连接池,那么你还需要配置JNDI的参数,例如Hibernate连接远程Weblogic上的数据库连接池:
hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
hibernate.connection.datasource mypool
hibernate.connection.provider_class net.sf.hibernate.connection.DatasourceConnectionProvider
hibernate.jndi.class weblogic.jndi.WLInitialContextFactory
hibernate.jndi.url t3://servername:7001/
最后,如果你需要在EJB或者JTA中使用Hibernate,需要取消下行的注释:
hibernate.transaction.factory_class net.sf.hibernate.transaction.JTATransactionFactory
杂项配置:
hibernate.show_sql false
是否将Hibernate发送给数据库的sql显示出来,这是一个非常非常有用处的功能。当你在调试Hibernate的时候,让Hibernate打印sql语句,可以帮助你迅速解决问题。
#hibernate.connection.isolation 4
指定数据库的隔离级别,往往不同的数据库有自己定义的隔离级别,未必是Hibernate的设置所能更改的,所以也不必去管它了。
hibernate.jdbc.fetch_size 50
hibernate.jdbc.batch_size 25
这两个选项非常非常非常重要!!!将严重影响Hibernate的CRUD性能!
C = create, R = read, U = update, D = delete
Fetch Size 是设定JDBC的Statement读取数据的时候每次从数据库中取出的记录条数。
例如一次查询1万条记录,对于Oracle的JDBC驱动来说,是不会1次性把1万条取出来的,而只会取出Fetch Size条数,当纪录集遍历完了这些记录以后,再去数据库取Fetch Size条数据。
因此大大节省了无谓的内存消耗。当然Fetch Size设的越大,读数据库的次数越少,速度越快;Fetch Size越小,读数据库的次数越多,速度越慢。
这有点像平时我们写程序写硬盘文件一样,设立一个Buffer,每次写入Buffer,等Buffer满了以后,一次写入硬盘,道理相同。
Oracle数据库的JDBC驱动默认的Fetch Size=10,是一个非常保守的设定,根据我的测试,当Fetch Size=50的时候,性能会提升1倍之多,当Fetch Size=100,性能还能继续提升20%,Fetch Size继续增大,性能提升的就不显著了。
因此我建议使用Oracle的一定要将Fetch Size设到50。
不过并不是所有的数据库都支持Fetch Size特性,例如MySQL就不支持。
MySQL就像我上面说的那种最坏的情况,他总是一下就把1万条记录完全取出来,内存消耗会非常非常惊人!这个情况就没有什么好办法了 :(
Batch Size是设定对数据库进行批量删除,批量更新和批量插入的时候的批次大小,有点相当于设置Buffer缓冲区大小的意思。
Batch Size越大,批量操作的向数据库发送sql的次数越少,速度就越快。我做的一个测试结果是当Batch Size=0的时候,使用Hibernate对Oracle数据库删除1万条记录需要25秒,Batch Size = 50的时候,删除仅仅需要5秒!!!
可见有多么大的性能提升!很多人做Hibernate和JDBC的插入性能测试会奇怪的发现Hibernate速度至少是JDBC的两倍,就是因为Hibernate使用了Batch Insert,而他们写的JDBC没有使用Batch的缘故。
以我的经验来看,Oracle数据库 Batch Size = 30 的时候比较合适,50也不错,性能会继续提升,50以上,性能提升的非常微弱,反而消耗内存更加多,就没有必要了。
#hibernate.jdbc.use_scrollable_resultset true
设定是否可以使用JDBC2.0规范的可滚动结果集,这对Hibernate的分页显示有一定的作用,默认就好了。
#hibernate.cglib.use_reflection_optimizer false
默认打开,启用cglib反射优化。cglib是用来在Hibernate中动态生成PO字节码的,打开优化可以加快字节码构造的速度。
不过,当你在调试程序过程中,特别是和proxy,lazy loading相关的应用中,代码出错,但是出错提示信息有语焉不详,那么你可以把cglib优化关掉,这样Hibernate会输出比较详细的调试信息,帮助你debug。
Hibernate 入门 - 实战演练
本文配置环境:
JBuilder X
jdk 1.4.2
Mysql 4.0.11 驱动:mm.mysql-2.0.4-bin.jar(org.gjt.mm.mysql.Driver)
Hibernate 2.1
解压Hibernate
打开JB,新建工程,名为:hibernate
加入Hibernate需要的包与MYSQL驱动
步骤:file->new project->name中输入hibernate,directory选择你要存放本工程的路径->next
->required libraries->add->new->name中输入你要设置的hibernate包名
->add->选择你hibernate解压到的目录,选中该目录下的hibernate2.jar与lib目录下的所有jar包,再把你的MYSQL驱动包也加进去
然后一直按OK,next。
新建一个类,名为Hello_Bean.java,代码如下:
package hibernate;
import java.io.Serializable;
public class Hello_Bean implements Serializable {
private String name;//这里name与address和id的名字可以自己定,不会有什么影响.但get与set方法不可以。因为那得跟数据库与配置文件对应。
private String address;
private int id;
public Hello_Bean() {
}
public Hello_Bean(String name, String address) {//构造函数,看完本章以后相信你会明白的了
this.name = name;
this.address = address;
}
public String getName() {//此方法名必须与Hello_Bean.hbm.xml文件里的对应的名字一样,下面会详细讲
return name;
}
public void setName(String name) {
this.name = name;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public int getId() {//必须的方法
return id;
}
public void setId(int id)//必须的方法
{
this.id = id;
}
}
完成这一步以后编译
将hibernate解压后的目录下的src文件夹里的hibernate.properties与log4j.properties文件复制到你的工程目录的classes目录下
(例如hibernate\classes\目录下),
打开hibernate.properties文件,找到
## HypersonicSQL
hibernate.dialect net.sf.hibernate.dialect.HSQLDialect
hibernate.connection.driver_class org.hsqldb.jdbcDriver
hibernate.connection.username sa
hibernate.connection.password
hibernate.connection.url jdbc:hsqldb:hsql://localhost
hibernate.connection.url jdbc:hsqldb:test
hibernate.connection.url jdbc:hsqldb:.
改为
## HypersonicSQL
#hibernate.dialect net.sf.hibernate.dialect.HSQLDialect
#hibernate.connection.driver_class org.hsqldb.jdbcDriver
#hibernate.connection.username sa
#hibernate.connection.password
#hibernate.connection.url jdbc:hsqldb:hsql://localhost
#hibernate.connection.url jdbc:hsqldb:test
#hibernate.connection.url jdbc:hsqldb:.
再找到
## MySQL
#hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
#hibernate.connection.driver_class org.gjt.mm.mysql.Driver
#hibernate.connection.driver_class com.mysql.jdbc.Driver
#hibernate.connection.url jdbc:mysql:///test
#hibernate.connection.username root
#hibernate.connection.password
改为
## MySQL
hibernate.dialect net.sf.hibernate.dialect.MySQLDialect
hibernate.connection.driver_class org.gjt.mm.mysql.Driver
hibernate.connection.url jdbc:mysql://localhost:3306/test
hibernate.connection.username root
hibernate.connection.password
上面的URL请改为你自己的
完成以后创建一个空的文件,保存在你工程的类文件同个文件夹里(例如hibernate\classes\hibernate\目录下),文件名为:Hello_Bean.hbm.xml
内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 2.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
<hibernate-mapping>
<class name="hibernate.Hello_Bean" table="test_hibernate" >
<id name="id" column="id">
<generator class="identity"/>
</id>
<property name="name" type="string" update="true" insert="true" column="name" />
<property name="address" type="string" update="true" insert="true" column="address" />
</class>
</hibernate-mapping>
稍微解释一下,<class name="hibernate.Hello_Bean" table="test_hibernate" >里的name指你的生成表的类,
table则指定你要创建的数据库表的名字,可以自由修改,没有影响.
<id name="id" column="id">设置主键ID,这里name的值id跟Hello_Bean.java里的方法getId与setId对应,不用管这个,hibernate会自动调用,配置好就可以了,column的值为要生成的字段名,可以自由修改,没有影响。
<generator class="identity"/>属性让主键的ID自增(插入数据的时候自动加1)
<property name="name" type="string" update="true" insert="true" column="name" />这里的name值"name"跟Hello_Bean.java里的getName方法对应,column为要生成的字段名
<property name="address" type="string" update="true" insert="true" column="address" />
分别添加一个字段name与address,注意这里的type属性类型为string,如果这里的类型与Hello_Bean.java里设置的类型不一样会出错。
修改完以后保存。
最后在JB里新建一个类,名字为Hello.java,我会一步步解释,代码如下:
package hibernate;
import net.sf.hibernate.cfg.Configuration;
import net.sf.hibernate.SessionFactory;
import net.sf.hibernate.tool.hbm2ddl.SchemaExport;
import net.sf.hibernate.Session;
import net.sf.hibernate.Query;
import net.sf.hibernate.Hibernate;
import net.sf.hibernate.type.LongType;
import net.sf.hibernate.Transaction;
import net.sf.hibernate.ScrollableResults;
import java.util.*;
public class Hello {
public Hello() {
}
public static void main(String[] args) throws Exception {
Configuration cfg = new Configuration().addClass(Hello_Bean.class);//用Hello_Bean.class类初始化
SessionFactory sessions = cfg.buildSessionFactory();//用buildSessionFactory方法得到一个SessionFactory对象
Session session = sessions.openSession();//再用SessionFactory的openSession方法得到一个session
new SchemaExport(cfg).create(true, true);//这句意思是创建表,第一次运行以后,就是创建完表以后再把这行加上注释。如果建表以后不把这一句注释掉的话会删掉以前创建的表再重新建一个。
Hello_Bean my_hibernate = new Hello_Bean();//得到一个Hello_Bean对象
my_hibernate.setName("my_name");//设置Hello_Bean对象的name值为my_name,这里其实就是说把字符串my_name当作数据库字段name的值.数据库字段name与Hello_Bean类里的getName,setName方法是对应的。形成一个映射关系。
my_hibernate.setAddress("my_address");//如上
session.save(my_hibernate);//这句很重要,将my_hibernate对象写进数据库(my_hibernate对象里的name与address我们刚刚已经设置了值了,会直接把name,address的值写进数据库去)
session.flush();
session.close();
//上面是一个简单的插入数据与第一次运行建表的介绍,下面我再介绍删除与修改的方法,下面的代码我
//都加了注释,自己需要什么方法(删除,修改,循环数据库的值)就把注释去掉就可以了
HSQL比较简单,大家看一下例子就应该明白了,这里就不讲了。
遍历数据库的方法有三种,分别是Query,find,iterate,Query和find返回一个List接口,iterate返回一个Iterator,具体方法可以查看这些类得知。
//删除数据
/*
int a=session.delete("from Hello_Bean where id=1");//如果没有找到id为1的数据那么返回0,如果找到返回1,这
//里的Hello_Bean是我们的Hello_Bean类,他跟数据库表对应,所以我们在这里是直接用Hello_Bean来代码
//数据库表的。
System.out.println(a);
session.flush();
session.close();
*/
//Query方法查询数据
/*
Hello_Bean my_hibernate = null;
Query q = session.createQuery("from Hello_Bean");
// Query q = session.createQuery("from Hello_Bean where name=?");//这里的?跟JDBC的PreparedStatement方法的
//差不多,只不过这里的是以0开始,jdbc的是1开始。
// q.setString(0,"my_name");
// q.setFirstResult(0);//这句话的意思是说查询结果从第几行开始列出数据
// q.setMaxResults(3);//这句话的意思是取多少条数据,就跟SQL SERVER的TOP方法和MYSQL的LIMIT方
//法一样的意思。
// ScrollableResults sc=q.scroll();//得到一个ScrollableResults,可滚动的,如果你的数据库支持游标自由移动的
//话可以加上,也就是说可以判断查询结果有没有值,或者移动到下一行记录等等。
// if(!sc.next())
// {
// System.out.println("没有找到你需要的数据");
// }
session.flush();//如果使用了ScrollableResults的话请把这行注释掉
session.close();//如果使用了ScrollableResults的话请把这行注释掉
List l=q.list();//返回一个List接口,用来遍历结果集
for(int i=0;i<l.size();i++){
my_hibernate = (Hello_Bean) l.get(i);//从List中取得一个my_hibernate对象
System.out.println(my_hibernate.getName());//调用my_hibernate对象的getName方法取得数据库name字段的值
}
*/
//find方法查询数据
/*
Hello_Bean my_hibernate = null;
List q = session.find("from Hello_Bean");
session.flush();
session.close();
for(int i=0;i<q.size();i++)
{
my_hibernate = (Hello_Bean) q.get(i);
System.out.println(my_hibernate.getName());
}
*/
//iterate方法查询数据
/*
Hello_Bean my_hibernate = null;
Iterator q = session.iterate("from Hello_Bean");
while(q.hasNext())
{
my_hibernate = (Hello_Bean) q.next();
System.out.println(my_hibernate.getName());
}
*/
//修改数据
/*
Query qq=session.createQuery("from Hello_Bean");
Hello_Bean my_hibernate=(Hello_Bean)session.load(Hello_Bean.class,new Integer(2));
//这里的new Integer(2)意思是修改表中id为2的那一行数据,必须是一个包装类的对象,如果使用int的话会出错。
my_hibernate.setName("geezer");//把id为2的那一行数据的name字段值改为"geezer"
session.flush();
session.close();
*/
}
}
最后运行就可以了。
如果大家有什么不清楚的,可以下载这篇文章的例子看看,运行一下。
下载完以后用JB打开hibernate.jpx就可以了。用之前把hibernate和MYSQL的驱动加进去,方法如果不知道再看看本章开头部分。
常见错误:
Caused by: org.dom4j.DocumentException: Invalid byte 2 of 2-byte UTF-8 sequence. Nested exception: Invalid byte 2 of 2-byte UTF-8 sequence.
如果出现这行错误说明你的xml配置文件有不规范的字符,检查下。
net.sf.hibernate.MappingException: Error reading resource: hibernate/Hello_Bean.hbm.xml
如果出现这行错误说明你的hibernate的XML配置文件有错
net.sf.hibernate.MappingException: Resource: hibernate/Hello_Bean.hbm.xml not found
如果出现这行错误说明hibernate的XML配置文件没有找到,你应该把XML文件放在与你的类文件同个目录下,本文中是放在hibernate\classes\hibernate\目录下,也就是跟Hello_Bean.class类文件一起。
net.sf.hibernate.PropertyNotFoundException: Could not find a setter for property name in class hibernate.Hello_Bean
如果出现这行错误说明你的xml文件里设置的字段名name的值与Hello_Bean.java类里的getXXX或setXXX方法不一致。
net.sf.hibernate.HibernateException: JDBC Driver class not found: org.gjt.mm.mysql.Driver
如果出现这行错误说明你的MYSQL驱动没有加进JB库里或者不在CLASSPATH里。