written by robbin

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。