hibernate.cfg.xml 配置詳解

配置文件中映射元素詳解

對象關系的映射是用一個XML文檔來說明的。映射文檔可以使用工具來生成，如XDoclet，Middlegen和AndroMDA等。下面從一個映射的例子開始講解映射元素，映射文件的代碼如下。

＜?xml version="1.0"?＞
＜!--
所有的XML映射文件都需要定義如下所示的DOCTYPE。
Hibernate會先在它的類路徑（classptah）中搜索DTD文件。
--＞
＜!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http：//hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"＞
＜!--
hibernate-mapping有幾個可選的屬性：
schema屬性指明了這個映射的表所在的schema名稱。
default-cascade屬性指定了默認的級聯風格 可取值有 none、save、update。
auto-import屬性默認讓我們在查詢語言中可以使用非全限定名的類名 可取值有 true、false。
package屬性指定一個包前綴。
--＞
＜hibernate-mapping schema="schemaName" default-cascade="none" 
auto-import="true" package="test"＞
＜!--用class元素來定義一個持久化類 --＞
＜class name="People" table="person"＞
＜!-- id元素定義了屬性到數據庫表主鍵字段的映射。--＞
＜id name="id"＞
＜!-- 用來為該持久化類的實例生成唯一的標識 --＞
＜generator class="native"/＞
＜/id＞
＜!-- discriminator識別器 是一種定義繼承關系的映射方法--＞
＜discriminator column="subclass" type="character"/＞
＜!-- property元素為類聲明了一個持久化的，JavaBean風格的屬性--＞
＜property name="name" type="string"＞
＜column name="name" length="64" not-null="true" /＞
＜/property＞

＜property name="sex"
not-null="true" 
update="false"/＞
＜!--多對一映射關系--＞
＜many-to-one name="friend"
column="friend_id"
update="false"/＞
＜!--設置關聯關系--＞
＜set name="friends" inverse="true" order-by="id"＞
＜key column="friend_id"/＞
＜!―一對多映射--＞
＜one-to-many class="Cat"/＞
＜/set＞
＜/class＞
＜/hibernate-mapping＞

 

　　組件應用的方法 
　 　組件有兩種類型，即組件（component）和動態組件（dynamic-component）。在配置文件中，component元素為子對象的元 素與父類對應表的字段建立起映射關系。然后組件可以聲明它們自己的屬性、組件或者集合。component元素的定義如下所示：

＜component name="propertyName" class="className" insert="true|false" 
upate="true|false" access="field|property|ClassName"＞ 
＜property ...../＞
＜many-to-one .... /＞
........
＜/component＞

 

　　在這段代碼中，name是指屬性名，class是類的名字，insert指的是被映射的字段是否出現在SQL的INSERT語句中，upate指出被映射的字段是否出現在SQL的UPDATE語句中，access指出訪問屬性的策略。

　　Hiebernate的基本配置 
　　Hibernate的數據庫連接信息是從配置文件中加載的。 Hibernate的配置文件有兩種形式：一種是XML格式的文件，一種是properties屬性文件。properties形式的配置文件默認文件名是hibernate.properties，一個properties形式的配置文件內容如下所示：

#指定數據庫使用的驅動類
hibernate.connection.driver_class = com.mysql.jdbc.Driver r
#指定數據庫連接串
hibernate.connection.url = jdbc:mysql://localhost:3306/db
#指定數據庫連接的用戶名
hibernate.connection.username = user
#指定數據庫連接的密碼
hibernate.connection.password = password
#指定數據庫使用的方言
hibernate.dialect = net.sf.hibernate.dialect.MySQLDialect
#指定是否打印SQL語句
hibernate.show_sql=true
　　在配置文件中包含了一系列屬性的配置，Hibernate將根據這些屬性來連接數據庫。
　　在XML格式的配置文件中，除了基本的Hibernate配置信息，還可以指定具體的持久化類的映射文件，這可以避免將持久化類的配置文件硬編碼在程序中。XML格式的配置文件的默認文件名為hibernate.cfg.xml，一個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＞
＜!--連接字符串--＞
＜property name="connection.url"＞jdbc:mysql://localhost:3306/STU＜/property＞
＜!--連接數據庫的用戶名--＞
＜property name="connection.username"＞root＜/property＞
＜!--數據庫用戶密碼--＞
＜property name="connection.password"＞root＜/property＞
＜!--數據庫驅動--＞
＜property name="connection.driver_class"＞com.mysql.jdbc.Driver＜/property＞
＜!--選擇使用的方言--＞
＜property name="dialect"＞org.hibernate.dialect.MySQLDialect＜/property＞
＜!--映射文件 --＞
＜mapping resource="com/stuman/domain/Admin.hbm.xml" /＞
＜!--映射文件--＞
＜mapping resource="com/stuman/domain/Student.hbm.xml" /＞
＜/session-factory＞
＜/hibernate-configuration＞

 

　　properties形式的配置文件和XML格式的配置文件可以同時使用。當同時使用兩種類型的配置文件時，XML配置文件中的設置會覆蓋properties配置文件的相同的屬性。
　　對象標識符號 
　 　在關系數據庫表中，主鍵（Primary Key）用來識別記錄，並保證每條記錄的唯一性。在Java語言中，通過比較兩個變量所引用對象的內存地址是否相同，或者比較兩個變量引用的對象值是否相 同來判斷兩對象是否相等。Hibernate為了解決兩者之間的不同，使用對象標識符（OID）來標識對象的唯一性。OID是關系數據庫中主鍵在Java 對象模型中的等價物。在運行時，Hibernate根據OID來維持Java對象和數據庫表中記錄的對應關系。如下代碼所示，三次調用了Session的 load()方法，分別加載OID為1或3的User對象。

Transaction tx = session.beginTransaction();
User user1 = (User)session.load(User.class,new Long(1));
User user2 = (User)session.load(User.class,new Long(1));
User user3 = (User)session.load(User.class,new Long(3));
System.out.println( user1 == user2 );
System.out.println( user1 == user3 );
　 　應用程序在執行上述代碼時，第一次加載OID為1的User對象，從數據庫中查找ID為1的記錄，然后創建相應的User實例，並把它保存在 Session緩存中，最后將該實例的引用賦值給變量user1。第二次加載OID為1的對象時，直接把Session緩存中OID為1的實例的引用賦值 給變量user2。因此，表達式user1==user2的結果為true。
　　標識的生成可以使用不同的策略，表1為Hibernate內置的標識生成策略。
　　表1 Hibernate標識生成策略

 

標識符生成器	描述
increment	適用於代理主鍵。由Hibernate自動以遞增方式生成。
identity	適用於代理主鍵。由底層數據庫生成標識符。
sequence	適用於代理主鍵。Hibernate根據底層數據庫的序列生成標識符，這要求底層數據庫支持序列。
hilo	適用於代理主鍵。Hibernate分局high/low算法生成標識符。
seqhilo	適用於代理主鍵。使用一個高/低位算法來高效的生成long，short或者int類型的標識符。
native	適用於代理主鍵。根據底層數據庫對自動生成標識符的方式，自動選擇identity、sequence或hilo。
uuid.hex	適用於代理主鍵。Hibernate采用128位的UUID算法生成標識符。
uuid.string	適用於代理主鍵。UUID被編碼成一個16字符長的字符串。
assigned	適用於自然主鍵。由Java應用程序負責生成標識符。
foreign	適用於代理主鍵。使用另外一個相關聯的對象的標識符。

 

　　Hibernate映射類型 
　　在對象/關系映射文件中，Hibernate采用映射類型作為Java類型和SQL類型的橋梁。Hibernate映射類型分為2種：內置映射類型和自定義映射類型。
　　1、內置映射類型
　　Hibernate對所有的Java原生類型、常用的Java類型如String、Date等都定義了內置的映射類型。表2列出了Hibernate映射類型、對應的Java類型以及對應的標准SQL類型。
　　表2 Hibernate內置映射類型

 

Hibernate映射類型	Java類型	標准SQL類型	大小
integer/int	java.lang.Integer/int	INTEGER	4字節
long	java.lang.Long/long	BIGINT	8字節
short	java.lang.Short/short	SMALLINT	2字節
byte	java.lang.Byte/byte	TINYINT	1字節
float	java.lang.Float/float	FLOAT	4字節
double	java.lang.Double/double	DOUBLE	8字節
big_decimal	java.math.BigDecimal	NUMERIC
character	java.lang.Character/java.lang.String/char	CHAR(1)	定長字符
string	java.lang.String	VARCHAR	變長字符
boolean/ yes_no/true_false	java.lang.Boolean/Boolean	BIT	布爾類型
date	java.util.Date/java.sql.Date	DATE	日期
timestamp	java.util.Date/java.util.Timestamp	TIMESTAMP	日期
calendar	java.util.Calendar	TIMESTAMP	日期
calendar_date	java.util.Calendar	DATE	日期
binary	byte[]	BLOB	BLOB
text	java.lang.String	TEXT	CLOB
serializable	實現java.io.Serializablej接口的任意Java類	BLOB	BLOB
clob	java.sql.Clob	CLOB	CLOB
blob	java.sql.Blob	BLOB	BLOB
class	java.lang.Class	VARCHAR	定長字符
locale	java.util.Locale	VARCHAR	定長字符
timezone	java.util.TimeZone	VARCHAR	定長字符
currency	java.util.Currency	VARCHAR	定長字符

 

　　2、自定義映射類型
　 　Hibernate提供了自定義映射類型接口，允許用戶以編程的方式創建自定義的映射類型。用戶自定義的映射類型需要實現 net.sf.hibernate.UserType或net.sf.hibernate.CompositeUserType接口。具體的創建自定義映射類型的方法請參考hibernate官方文檔或相關資料，這里不再詳細介紹。 

3、連接池

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>

 

 

轉自------http://hanshuo528.bokee.com/viewdiary.23028288.html