Hibernate配置文件和映射元素解释

 
 
 

  
  
  
 
  
  
  
                  
  
  
  
 
  
  
  
  
  
  
          "-//Hibernate/Hibernate Configuration DTD 3.0//EN"  
  
  
  
          "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> 
  
  
  
            
  
  
  
     
  
  
  
     
  
  
  
             
  
  
  
       
  
  
  
           com.mysql.jdbc.Driver   
  
  
  
           
  
  
  
            jdbc:mysql://localhost/hibernate 
  
  
  
     
  
  
  
           root   
  
  
  
           
  
  
  
           123456           
  
  
  
           
  
  
  
           20          
  
  
  
          
  
  
  
         true 
  
  
  
          
  
  
  
         50 
  
  
  
          
  
  
  
         23 
  
  
  
          
  
  
  
         false 
  
  
  
          
  
  
  
         true 
  
  
  
          
  
  
  
    gbk        
  
  
  
           
  
  
  
          
  
  
  
           org.hibernate.dialect.MySQLDialect 
  
  
  
                    
  
  
  
            
  
  
  
   
  
  
  
   
 
 
 

 配置文件中映射元素详解

在囊谦等地区，都构建了全面的区域性战略布局，加强发展的系统性、市场前瞻性、产品创新能力，以专注、极致的服务理念，为客户提供成都网站设计、成都网站制作 网站设计制作按需规划网站,公司网站建设,企业网站建设,品牌网站设计,全网整合营销推广,外贸营销网站建设,囊谦网站建设费用合理。

对象关系的映射是用一个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标识生成策略

Hibernate映射类型

在对象/关系映射文件中，Hibernate采用映射类型作为Java类型和SQL类型的桥梁。Hibernate映射类型分为2种：内置映射类型和自定义映射类型。

1、内置映射类型

Hibernate对所有的Java原生类型、常用的Java类型如String、Date等都定义了内置的映射类型。表2列出了Hibernate映射类型、对应的Java类型以及对应的标准SQL类型。

表2：Hibernate内置映射类型

hibernate-mapping

这个元素包括三个可选的属性。schema属性，指明了这个映射所引用的表所在的schema名称。假若指定了这个属性，表名会加上所指定的schema的名字扩展为全限定名。假若没有指定，表名就不会使用全限定名。default-cascade指定了未明确注明cascade属性的Java属性和集合类Java会采取什么样的默认级联风格。auto-import属性默认让我们在查询语言中可以使用非全限定名的类名。

 
 
 

  
  
  
  
  
  
         schema="schemaName"                           
  
  
  
         default-cascade="none|save-update"            
  
  
  
         auto-import="true|false"                      
  
  
  
         package="package.name"                        
  
  
  
 /> 
 
 
 

schema (可选): 数据库schema名称。

default-cascade (可选 - 默认为 none): 默认的级联风格。

auto-import (可选 - 默认为 true): 指定是否我们可以在查询语言中使用非全限定的类名（仅限于本映射文件中的类）。

package (可选): 指定一个包前缀，如果在映射文档中没有指定全限定名，就使用这个包名。

假若你有两个持久化类，它们的非全限定名是一样的（就是在不同的包里面--译者注），你应该设置auto-import="false"。假若说你把一个“import过”的名字同时对应两个类， Hibernate会抛出一个异常。

5.1.3. class

你可以使用class元素来定义一个持久化类：

 
 
 

  
  
  
  
  
  
        name="ClassName"                               
  
  
  
        table="tableName"                              
  
  
  
        discriminator-value="discriminator_value"      
  
  
  
        mutable="true|false"                           
  
  
  
        schema="owner"                                 
  
  
  
        proxy="ProxyInterface"                         
  
  
  
        dynamic-update="true|false"                    
  
  
  
        dynamic-insert="true|false"                    
  
  
  
        select-before-update="true|false"              
  
  
  
        polymorphism="implicit|explicit"               
  
  
  
        where="arbitrary sql where condition"         (11)  
  
  
  
        persister="PersisterClass"                    (12)  
  
  
  
        batch-size="N"                                (13)  
  
  
  
        optimistic-lock="none|version|dirty|all"      (14)  
  
  
  
        lazy="true|false"                             (15)  
  
  
  
/> 
 
 
 

name: 持久化类（或者接口）的Java全限定名。

table: 对应的数据库表名。

discriminator-value（辨别值） （可选 - 默认和类名一样）：一个用于区分不同的子类的值，在多态行为时使用。

mutable（可变） (可选, 默认值为 true): 表明该类的实例可变（不可变）。

schema (可选): 覆盖在根元素中指定的schema名字。

proxy (可选): 指定一个接口，在延迟装载时作为代理使用。你可以在这里使用该类自己的名字。

dynamic-update（动态更新） (可选，默认为false): 指定用于UPDATE 的SQL将会在运行时动态生成，并且只更新那些改变过的字段。

dynamic-insert（动态插入） (可选, 默认为false): 指定用于INSERT的 SQL 将会在运行时动态生成，并且只包含那些非空值字段。

select-before-update (可选，默认值为false): 指定Hibernate除非确定对象的确被修改了，不会执行SQL UPDATE操作。在特定场合（实际上，只会发生在一个临时对象关联到一个新的session中去，执行update()的时候），这说明Hibernate会在UPDATE之前执行一次额外的SQL SELECT操作，来决定是否应该进行UPDATE。

polymorphism（多形，多态） (可选, 默认值为 implicit (隐式)): 界定是隐式还是显式的使用查询多态。

(11) where (可选) 指定一个附加的SQLWHERE 条件，在抓取这个类的对象时会一直增加这个条件。

(12) persister (可选): 指定一个定制的ClassPersister。

(13) batch-size (可选,默认是1) 指定一个用于根据标识符抓取实例时使用的"batch size"（批次抓取数量）。

(14) optimistic-lock（乐观锁定） (可选，默认是version): 决定乐观锁定的策略。

(15) lazy（延迟） (可选): 假若设置 lazy="true"，就是设置这个类自己的名字作为proxy接口的一种等价快捷形式。

若指明的持久化类实际上是一个接口，也可以被完美地接受。其后你可以用来指定该接口的实际实现类名。你可以持久化任何static（静态的）内部类。记得应该使用标准的类名格式，就是说比如：Foo$Bar。

不可变类，mutable="false"不可以被应用程序更新或者删除。这可以让Hibernate做一些小小的性能优化。

可选的proxy属性可以允许延迟加载类的持久化实例。Hibernate开始会返回实现了这个命名接口的CGLIB代理。当代理的某个方法被实际调用的时候，真实的持久化对象才会被装载。参见下面的“用于延迟装载的代理”。

Implicit (隐式)的多态是指，如果查询中给出的是任何超类、该类实现的接口或者该类的名字，都会返回这个类的实例；如果查询中给出的是子类的名字，则会返回子类的实例。 Explicit （显式）的多态是指，只有在查询中给出的明确是该类的名字时才会返回这个类的实例；同时只有当在这个的定义中作为或者出现的子类，才会可能返回。大多数情况下，默认的polymorphism="implicit"都是合适的。显式的多态在有两个不同的类映射到同一个表的时候很有用。（允许一个“轻型”的类，只包含部分表字段）。

persister属性可以让你定制这个类使用的持久化策略。你可以指定你自己实现的net.sf.hibernate.persister.EntityPersister的子类，你甚至可以完全从头开始编写一个net.sf.hibernate.persister.ClassPersister接口的实现，可能是用储存过程调用、序列化到文件或者LDAP数据库来实现的。参阅net.sf.hibernate.test.CustomPersister，这是一个简单的例子（“持久化”到一个Hashtable）。

请注意dynamic-update和dynamic-insert的设置并不会继承到子类，所以在或者元素中可能需要再次设置。这些设置是否能够提高效率要视情形而定。请用你的智慧决定是否使用。

使用select-before-update通常会降低性能.当是在防止数据库不必要的触发update触发器，这就很有用了。

如果你打开了dynamic-update，你可以选择几种乐观锁定的策略：

version（版本检查）检查version/timestamp字段

all（全部） 检查全部字段

dirty（脏检查）只检察修改过的字段

none（不检查）不使用乐观锁定

我们非常强烈建议你在Hibernate中使用version/timestamp字段来进行乐观锁定。对性能来说，这是最好的选择，并且这也是唯一能够处理在session外进行操作的策略（就是说，当使用Session.update()的时候）。

5.1.4. id

被映射的类必须声明对应数据库表主键字段。大多数类有一个JavaBeans风格的属性，为每一个实例包含唯一的标识。 元素定义了该属性到数据库表主键字段的映射。

 
 
 

  
  
  
  
  
  
name="propertyName"   
  
  
  
type="typename"   
  
  
  
column="column_name"   
  
  
  
unsaved-value="any|none|null|id_value"   
  
  
  
access="field|property|ClassName">   
  
  
  
 
  
  
  
  
  
  
  
 
 
 
 

name (可选): 标识属性的名字。

type (可选): 标识Hibernate类型的名字。

column (可选 - 默认为属性名): 主键字段的名字。

unsaved-value (可选 - 默认为null): 一个特定的标识属性值，用来标志该实例是刚刚创建的，尚未保存。这可以把这种实例和从以前的session中装载过（可能又做过修改--译者注）但未再次持久化的实例区分开来。

access (可选 - 默认为property): Hibernate用来访问属性值的策略。

如果 name属性不存在，会认为这个类没有标识属性。

unsaved-value 属性很重要！如果你的类的标识属性不是默认为null的，你应该指定正确的默认值。

还有一个另外的声明可以访问旧式的多主键数据。我们强烈不鼓励使用这种方式。

5.1.4.1. generator

必须声明的子元素是一个Java类的名字，用来为该持久化类的实例生成唯一的标识。如果这个生成器实例需要某些配置值或者初始化参数，用元素来传递。

 
 
 

  
  
  
 
  
  
  
 
  
  
  
uid_table 
  
  
  
next_hi_value_column 
  
  
  
 
  
  
  
 
 
 
 

所有的生成器都实现net.sf.hibernate.id.IdentifierGenerator接口。这是一个非常简单的接口；某些应用程序可以选择提供他们自己特定的实现。当然，Hibernate提供了很多内置的实现。下面是一些内置生成器的快捷名字：

increment（递增）

用于为long, short或者int类型生成唯一标识。只有在没有其他进程往同一张表中插入数据时才能使用。在集群下不要使用。

identity

对DB2,MySQL, MS SQL Server, Sybase和HypersonicSQL的内置标识字段提供支持。返回的标识符是long, short 或者int类型的。

sequence （序列）

在DB2,PostgreSQL, Oracle, SAP DB, McKoi中使用序列（sequence)，而在Interbase中使用生成器(generator)。返回的标识符是long, short或者 int类型的。

hilo （高低位）

使用一个高/低位算法来高效的生成long, short或者 int类型的标识符。给定一个表和字段（默认分别是是hibernate_unique_key 和next）作为高位值得来源。高/低位算法生成的标识符只在一个特定的数据库中是唯一的。在使用JTA获得的连接或者用户自行提供的连接中，不要使用这种生成器。

seqhilo（使用序列的高低位）

使用一个高/低位算法来高效的生成long, short或者 int类型的标识符，给定一个数据库序列（sequence)的名字。

uuid.hex

用一个128-bit的UUID算法生成字符串类型的标识符。在一个网络中唯一（使用了IP地址）。UUID被编码为一个32位16进制数字的字符串。

uuid.string

使用同样的UUID算法。UUID被编码为一个16个字符长的任意ASCII字符组成的字符串。不能使用在PostgreSQL数据库中

native（本地）

根据底层数据库的能力选择identity, sequence 或者hilo中的一个。

assigned（程序设置）

让应用程序在save()之前为对象分配一个标示符。

foreign（外部引用）

使用另外一个相关联的对象的标识符。和联合一起使用。

原文链接：http://blog.csdn.net/ysynlm/article/details/2766281

文章名称：Hibernate配置文件和映射元素解释
文章出自：http://www.shufengxianlan.com/qtweb/news30/505730.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联