Hibernate的描述文件可以是一個properties屬性文件,也可以是一個xml文件。下面講一下Hibernate.cfg.xml的配置。配置格式如下:
1. 配置數據源
在Hibernate.cfg.xml中既可以配置JDBC,也可以配置JNDI.在本小節中講述數據源如何配置。
hibernate.cfg.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- 各屬性的配置--> <!—為true表示將Hibernate發送給數據庫的sql顯示出來 --> <property name="show_sql">true</property> <!-- SQL方言,這邊設定的是MySQL --> <property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property> <!-- 一次讀的數據庫記錄數 --> <property name="jdbc.fetch_size">50</property> <!-- 設定對數據庫進行批量刪除 --> <property name="jdbc.batch_size">30</property> <!—下面為JNDI的配置 --> <!-- 數據源的名稱 --> <property name="connection.datasource">java:comp/env/jdbc/datasourcename</property> <!-- Hibernate的連接加載類 --> <property name="connection.provider_class">net.sf.hibernate.connection.DatasourceConnectionProvider</property> <property name="dialect">net.sf.hibernate.dialect.SQLServerDialect</property> <!—映射文件 --> <mapping resource="com/amigo/pojo/User.hbm.xml"/> <mapping resource="com/amigo/pojo/Org.hbm.xml"/> </session-factory> </hibernate-configuration>
2. c3p0連接池
c3p0連接池是Hibernate推薦使用的連接池,若需要使用該連接池時,需要將c3p0的jar包加入到classpath中。c3p0連接池的配置示例如下:
hibernate.cfg.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- 顯示實際操作數據庫時的SQL --> <property name="show_sql">true</property> <!-- SQL方言,這邊設定的是MySQL --> <property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property> <!--驅動程序,在後續的章節中將講述mysql、sqlserver和Oracle數據庫的配置 --> <property name="connection.driver_class">……</property> <!-- JDBC URL --> <property name="connection.url">……</property> <!-- 數據庫用戶名 --> <property name="connection.username">user</property> <!-- 數據庫密碼 --> <property name="connection.password">pass</property> <property name="c3p0.min_size">5</property> <property name="c3p0.max_size">20</property> <property name="c3p0.timeout">1800</property> <property name="c3p0.max_statements">50</property> <!-- 對象與數據庫表格映像文件 --> <mapping resource="com/amigo/pojo/User.hbm.xml"/> <mapping resource="com/amigo/pojo/Org.hbm.xml"/> </session-factory> </hibernate-configuration>
在上述配置中,Hibernate根據配置文件生成連接,再交給c3p0管理。
3. proxool連接池
proxool跟c3p0以及dbcp不一樣,它是自己生成連接的,因此連接信息放在proxool配置文件中。使用它時,需要將proxool-0.8.3.jar加入到classespath中。配置舉例如下:
hibernate.cfg.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- 顯示實際操作數據庫時的SQL --> <property name="show_sql">true</property> <!-- SQL方言,這邊設定的是MySQL --> <property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property> <!—proxool的配置 --> <property name="proxool.pool_alias">pool1</property> <property name="proxool.xml">ProxoolConf.xml</property> <property name="connection.provider_class">net.sf.hibernate.connection.ProxoolConnectionProvider</property> <!-- 對象與數據庫表格映像文件 --> <mapping resource="com/amigo/pojo/User.hbm.xml"/> <mapping resource="com/amigo/pojo/Org.hbm.xml"/> </session-factory> </hibernate-configuration>
在hibernate.cfg.xml的同目錄下編寫proxool的配置文件:ProxoolConf.xml,該文件的配置實例如下:
ProxoolConf.xml
<?xml version="1.0" encoding="utf-8"?> <!-- the proxool configuration can be embedded within your own application's. Anything outside the "proxool" tag is ignored. --> <something-else-entirely> <proxool> <alias>pool1</alias> <!--proxool只能管理由自己產生的連接--> <!-- 驅動的url--> <!-- jdbc:mysql://localhost:3306/dbname?useUnicode=true&characterEncoding=GBK--> <driver-url>… </driver-url> <!-- 驅動類,eg. com.mysql.jdbc.Driver--> <driver-class>… </driver-class> <driver-properties> <!-- 數據庫用戶名,eg. value為root--> <property name="user" value="…"/> <!-- 數據庫密碼,eg. value為root--> <property name="password" value="…."/> </driver-properties> <!-- proxool自動偵察各個連接狀態的時間間隔(毫秒),偵察到空閒的連接就馬上回收,超時的銷毀--> <house-keeping-sleep-time>90000</house-keeping-sleep-time> <!-- 指因未有空閒連接可以分配而在隊列中等候的最大請求數,超過這個請求數的用戶連接就不會被接受--> <maximum-new-connections>20</maximum-new-connections> <!-- 最少保持的空閒連接數--> <prototype-count>5</prototype-count> <!-- 允許最大連接數,超過了這個連接,再有請求時,就排在隊列中等候,最大的等待請求數由maximum-new-connections決定--> <maximum-connection-count>100</maximum-connection-count> <!-- 最小連接數--> <minimum-connection-count>10</minimum-connection-count> </proxool> </something-else-entirely>
4. dbcp連接池
在hibernate3.0中,已經不再支持dbcp了,hibernate的作者在hibernate.org中,明確指出在實踐中發現dbcp有 BUG,在某些種情會產生很多空連接不能釋放,所以拋棄了對dbcp的支持。若需要使用dbcp,開發人員還需要將commons-pool-1.2.jar 和commons-dbcp-1.2.1.jar兩個jar包加入到classpath中。dbcp與c3p0一樣,都是由hibernate建立連接的。
在hibernate2.0中的配置建立如下:
hibernate.cfg.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 2.0//EN" "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- 顯示實際操作數據庫時的SQL --> <property name="show_sql">true</property> <!-- SQL方言,這邊設定的是MySQL --> <property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property> <!--驅動程序,在後續的章節中將講述mysql、sqlserver和Oracle數據庫的配置 --> <property name="connection.driver_class">……</property> <!-- JDBC URL --> <property name="connection.url">……</property> <!-- 數據庫用戶名,eg. root --> <property name="connection.username">…</property> <!-- 數據庫密碼, eg. root--> <property name="connection.password">…</property> <property name="dbcp.maxActive">100</property> <property name="dbcp.whenExhaustedAction">1</property> <property name="dbcp.maxWait">60000</property> <property name="dbcp.maxIdle">10</property> <property name="dbcp.ps.maxActive">100</property> <property name="dbcp.ps.whenExhaustedAction">1</property> <property name="dbcp.ps.maxWait">60000</property> <property name="dbcp.ps.maxIdle">10</property> <!-- 對象與數據庫表格映像文件 --> <mapping resource="com/amigo/pojo/User.hbm.xml"/> <mapping resource="com/amigo/pojo/Org.hbm.xml"/> </session-factory> </hibernate-configuration>
5. MySql連接配置
在hibernate中,可以配置很多種數據庫,例如MySql、Sql Server和Oracle,MySql的配置舉例如下:
hibernate.cfg.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> <hibernate-configuration> <session-factory> <!-- 各屬性的配置--> <!—為true表示將Hibernate發送給數據庫的sql顯示出來 --> <property name="show_sql">true</property> <!-- SQL方言,這邊設定的是MySQL --> <property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property> <!-- 一次讀的數據庫記錄數 --> <property name="jdbc.fetch_size">50</property> <!-- 設定對數據庫進行批量刪除 --> <property name="jdbc.batch_size">30</property> <!--驅動程序--> <property name="connection.driver_class">com.mysql.jdbc.Driver</property> <!-- JDBC URL --> <property name="connection.url">jdbc:mysql://localhost/dbname?characterEncoding=gb2312</property> <!-- 數據庫用戶名--> <property name="connection.username">root</property> <!-- 數據庫密碼--> <property name="connection.password">root</property> <!—映射文件 --> <mapping resource="com/amigo/pojo/User.hbm.xml"/> <mapping resource="com/amigo/pojo/Org.hbm.xml"/> </session-factory> </hibernate-configuration>
上面使用的驅動類是com.mysql.jdbc.Driver。需要將MySql的連接器jar包(eg. mysql-connector-java-5.0.4-bin.jar)加入到classpath中。
6. Sql Server連接配置
本小節講述一下Sql Server數據庫的hibernate連接設置,在此只給出連接部分的內容,其余部分與2.2.1.5一樣,在此不再贅述。內容如下:
<!--驅動程序-->
<property name="connection.driver_class">net.sourceforge.jtds.jdbc.Driver</property>
<!-- JDBC URL -->
<property name="connection.url">jdbc:jtds:sqlserver://localhost:1433;DatabaseName=dbname</property>
<!-- 數據庫用戶名-->
<property name="connection.username">sa</property>
<!-- 數據庫密碼-->
<property name="connection.password"></property>
上例的驅動類使用的是jtds的驅動類,因此讀者需要將jtds的jar包(eg. jtds-1.2.jar)加入到classpath中。
7. Oracle連接配置
本小節講述一下Sql Server數據庫的hibernate連接設置,在此只給出連接部分的內容,其余部分與2.2.1.5一樣,在此不再贅述。內容如下:
<!--驅動程序-->
<property name="connection.driver_class">oracle.jdbc.driver.OracleDriver</property>
<!-- JDBC URL -->
<property name="connection.url">jdbc:oracle:thin:@localhost:1521:dbname</property>
<!-- 數據庫用戶名-->
<property name="connection.username">test</property>
<!-- 數據庫密碼-->
<property name="connection.password">test</property>
上例使用的驅動類為:oracle.jdbc.driver.OracleDriver,開發人員需要將相關的jar包(ojdbc14.jar)加入到classpath中。
hbm2dll屬性有4個值:
1、validate:驗證hbm2dll映射。
2、update:檢查更新hbm2dll映射。
3、create:先drop數據庫,在create數據庫。
4、create-drop:先drop數據庫,在create數據庫,當SessionFactory關閉時,又drop數據庫。