hibernate 配置笔记

hibernate 配置笔记：
１。准备工作
　　　下载 hibernate-2.1
　　　hibernate-extensions-2.1.2
　　　Middlegen-Hibernate-r5
      apache-ant-1.6.5
      设置ANT_HOME ,将%ANT_HOME%/bin追加到环境变量PATH中

２。目录结构如下：
├─DBdriver（JDBC驱动）
├─hibernate-2.1（hibernate2.1版本）
│  ├─bin
│  ├─build
│  ├─doc
│  ├─eg
│  ├─lib
│  ├─src
│  └─test
├─hibernate-extensions-2.1.2（hibernate 工具包　POJO 的生成）
│  ├─hibern8ide
│  │  ├─lib
│  │  └─src
│  └─tools
│      ├─bin
│      ├─doc
│      ├─lib
│      └─src
├─Middlegen-Hibernate-r5（hibernate 工具包　Hibernate映射文件生成）
│  ├─build
│  │  ├─classes
│  │  ├─gen-src
│  │  ├─hsqldb
│  │  └─sql
│  ├─config
│  │  └─database
│  ├─lib
│  ├─middlegen-lib
│  └─src
│      ├─java
│      ├─sql
│      └─web
└─w3c（Sample目录）
    └─org
        └─hibernate
            └─w3c｛保存java文件 *.java 和映射文件 *.hbm.xml 的目录｝
３．导出映射文件
　 (1).进入MiddleGen 目录下的/config/database 子目录，根据我们实际采用的数据库打开
对应的配置文件。如这里我们用的是MS SQLSERVER2000数据库，对应的就是mssql.xml 文件.
   <property name="database.script.file"           value=""/>
   <property name="database.driver.file"           value="D:/My/hibernate/DBdriver/Sprinta2000.jar"/>
   <property name="database.driver.classpath"      value="${database.driver.file}"/>
   <property name="database.driver"                value="com.inet.tds.TdsDriver"/>
   <property name="database.url"                   value="jdbc:inetdae7:192.168.100.187:1433?database=cam3t"/>
   <property name="database.userid"                value="cam3t"/>
   <property name="database.password"              value="cam3t"/>
   <property name="database.schema"                value="cam3t"/>
   <property name="database.catalog"               value="cam3t"/>
   <!--property name="jboss.datasource.mapping"       value="MS SQLSERVER"/-->
   <property name="jboss.datasource.mapping"       value="MS SQLSERVER2000"/>
   (2).修改Build.xml
    修改MiddleGen 根目录下的build.xml 文件，此文件是Middlegen-Hibernate 的Ant
构建配置。Middlegen-Hibernate将根据build.xml 文件中的具体参数生成数据库表映射
文件。可配置的项目包括：

 a) 目标数据库配置文件地址
 查找关键字”!ENTITY”，得到：
 <!DOCTYPE project [
 <!ENTITY database SYSTEM
 "file:./config/database/hsqldb.xml">
 ]>
 默认情况下，MiddleGen 采用的是hsqldb.xml，将其修改为我们所用的数据
 库配置文件（mysql.xml）：
 <!DOCTYPE project [
     <!ENTITY database SYSTEM
 "file:./config/database/mssql.xml">
 ]>
 b) Application name
 查找：
 <property name="name" value="airline"/>
 “aireline”是MiddleGen原始配置中默认的Application Name，将其修改为我们
 所希望的名称，如“HibernateSample”：
 <property name="name" value="w3c"/>
 c) 输出目录
 查找关键字“name="build.gen-src.dir"”，得到：
 <property name="build.gen-src.dir"
 value="${build.dir}/gen-src"/>
 修改value="${build.dir}/gen-src"使其指向我们所期望的输出目录，
 这里我们修改为：
    <property name="build.gen-src.dir"             
 value="D:/My/hibernate/w3c"/>
 d) 对应代码的Package name
 查找关键字“destination”，得到：
 <hibernate
 destination="${build.gen-src.dir}"
 package="${name}.hibernate"
 genXDocletTags="false"
 genIntergratedCompositeKeys="false"
 javaTypeMapper=
 "middlegen.plugins.hibernate.HibernateJavaTypeMapper"
 />
 可以看到，hibernate 节点package 属性的默认设置实际上是由前面的
 Application Name （${name}）和“.hibernate”组合而成，根据我们的需要，
 将其改为：
 <hibernate
 destination="${build.gen-src.dir}"
        package="org.hibernate.w3c"
 genXDocletTags="true"
 genIntergratedCompositeKeys="false"
 javaTypeMapper=
 "middlegen.plugins.hibernate.HibernateJavaTypeMapper"
 />
 这里还有一个属性genXDocletTags，如果设置为true，则生成的代码将包含
 xdoclet tag，这为以后在开发过程中借助xdoclet进行映射调整提供了帮助

 <middlegen
 appname="${name}"
 prefsdir="${src.dir}"
 gui="${gui}"
 databaseurl="${database.url}"
 initialContextFactory="${java.naming.factory.initial}"
 providerURL="${java.naming.provider.url}"
 datasourceJNDIName="${datasource.jndi.name}"
 driver="${database.driver}"
 username="${database.userid}"
 password="${database.password}"
 schema="${database.schema}"
 catalog="${database.catalog}"
 >
 如果只需要对数据库中选定的表进行持久化处理
        可在 <middlegen〉</middlegen>标记之间
 添加形如：
          <table name="DOC_TYPE" />
          <table name="CITY" />
          <table name="SUPPORT_DOC" />
        表示只导出 DOC_TYPE ,CITY,SUPPORT_DOC 三个表

 至此为止，MiddleGen 已经配置完毕，在MiddleGen 根目录下运行ant，就将出现MiddleGen的界面：
_____________________________________________________________________
 可以看到，数据库中的表结构已经导入到MiddleGen 的操作界面中，选定数据库
 表视图中的表元素，我们即可调整各个数据库表的属性。
 1 Domain Class Name
  对应POJO 的类名
 2 Key Generator
  主键产生器
  可选项说明：
  1) Assigned
  主键由外部程序负责生成，无需Hibernate参与。
  2) hilo
  通过hi/lo 算法实现的主键生成机制，需要额外的数据库表保存主
  键生成历史状态。
  3) seqhilo
  与hilo 类似，通过hi/lo 算法实现的主键生成机制，只是主键历史
  状态保存在Sequence中，适用于支持Sequence的数据库，如Oracle。
  4) increment
  主键按数值顺序递增。此方式的实现机制为在当前应用实例中维持
  一个变量，以保存着当前的最大值，之后每次需要生成主键的时候
  将此值加1作为主键。
  这种方式可能产生的问题是：如果当前有多个实例访问同一个数据
  库，那么由于各个实例各自维护主键状态，不同实例可能生成同样
  的主键，从而造成主键重复异常。因此，如果同一数据库有多个实
  例访问，此方式必须避免使用。
  5) identity
  采用数据库提供的主键生成机制。如DB2、SQL Server、MySQL
  中的主键生成机制。
  6) sequence
  采用数据库提供的sequence 机制生成主键。如Oralce 中的
  Sequence。
  7) native
  由Hibernate根据底层数据库自行判断采用identity、hilo、sequence
  其中一种作为主键生成方式。
  8) uuid.hex
  由Hibernate基于128位唯一值产生算法生成16 进制数值（编码后
  以长度32 的字符串表示）作为主键。
  9) uuid.string
  与uuid.hex 类似，只是生成的主键未进行编码（长度16）。在某些
  数据库中可能出现问题（如PostgreSQL）。
  10) foreign
  使用外部表的字段作为主键。
  一般而言，利用uuid.hex 方式生成主键将提供最好的性能和数据库平台适
  应性。
  另外由于常用的数据库，如Oracle、DB2、SQLServer、MySql 等，都提
  供了易用的主键生成机制（Auto-Increase 字段或者Sequence）。我们可以在数
  据库提供的主键生成机制上，采用generator-class=native的主键生成方式。
  不过值得注意的是，一些数据库提供的主键生成机制在效率上未必最佳，
  大量并发insert数据时可能会引起表之间的互锁。
  数据库提供的主键生成机制，往往是通过在一个内部表中保存当前主键状
  态（如对于自增型主键而言，此内部表中就维护着当前的最大值和递增量），
  之后每次插入数据会读取这个最大值，然后加上递增量作为新记录的主键，之
  后再把这个新的最大值更新回内部表中，这样，一次Insert操作可能导致数据
  库内部多次表读写操作，同时伴随的还有数据的加锁解锁操作，这对性能产生
  了较大影响。
  因此，对于并发Insert要求较高的系统，推荐采用uuid.hex 作为主键生成
  机制。
 3 如果需要采用定制的主键产生算法，则在此处配置主键生成器，主键生成器必
 须实现net.sf.hibernate.id.IdentifierGenerator 接口。
 4 Schema Name
 数据库Schema Name。
 5 Persister
 自定义持久类实现类类名。如果系统中还需要Hibernate 之外的持久层实
 现机制，如通过存储过程得到目标数据集，甚至从LDAP中获取数据来填
 充我们的POJO。
 6 Enable proxies
 是否使用代理（用于延迟加载[Lazy Loading]）。
 7 Dynamic Update
 如果选定，则生成Update SQL 时不包含未发生变动的字段属性，这样可
 以在一定程度上提升SQL执行效能。
 8 Mutable
 类是否可变，默认为选定状态（可变）。如果不希望应用程序对此类对应
 的数据记录进行修改（如对于数据库视图），则可将取消其选定状态，之
 后对此类的Delete和Update操作都将失效。
 9 Implement the Lifecyle interface
 是否实现Lifecyle接口。Lifecyle接口提供了数据固化过程中的控制机制，
 通过实现Lifecyle接口，我们可以在数据库操作中加入回调（Call Back）
 机制，如在数据库操作之前，之后触发指定操作。
 10 Implement the Validatable interface
 是否实现Validatable接口。通过实现Validatable接口，我们可以在数据被
 固化到数据库表之前对其合法性进行验证。
 值得注意的是，通过实现Lifecyle接口，我们同样可以在数据操作之前验
 证数据合法性，不同的是，Validatable 接口中定义的validate 方法可能会
 被调用多次，因此设计中应避免在Validatable 接口的validate 方法实现中
 加入业务逻辑的验证。
________________________________________________________________________
 以上是针对Class的设置，同样，在MiddleGen中，我们也可以设定字段属性。在
 MiddleGen中选定某个字段，界面下方即出现字段设置栏：
 在这里我们可以设置字段的属性，其中：
 1 Hibernate mapping specialty
 映射类型：
 Key ：主键
 Property ：属性
 Version ：用于实现optimistic locking，参见“高级特性”章节中关
 于optimistic locking的描述
 2 Java property name
 字段对应的Java 属性名
 3 Java Type
 字段对应的Java 数据类型
 4 Column updateable
 生成Update SQL时是否包含本字段。
 5 Column insertable
 生成Insert SQL时是否包含本字段。
 单击窗口顶部的Generate 按钮，MiddleGen 即为我们生成这些数据库表所对应的
 Hibernate映射文件。在MiddleGen根目录下的/build/gen-src/net/hibernate/sample目录中，
 我们可以看到对应的以.hbm.xml 作为后缀的多个映射文件，每个映射文件都对应了数
 据库的一个表。

4．导出映射文件
 仅有映射文件还不够，我们还需要根据这些文件生成对应的POJO。
 POJO 的生成工作可以通过Hibernate Extension 来完成，Hibernate Extension 的
 tools/bin目录下包含三个工具：
 1． hbm2java.bat
 根据映射文件生成对应的POJO。通过MiddleGen 我们已经得到了映射文件，
 下一步就是通过hbm2java.bat工具生成对应的POJO。
 2． class2hbm.bat
 根据POJO class 生成映射文件，这个工具很少用到，这里也就不再详细介绍。
 3． ddl2hbm.bat
 由数据库导出库表结构，并生成映射文件以及POJO。这个功能与MiddleGen
 的功能重叠，但由于目前还不够成熟（实际上已经被废弃，不再维护），提供
 的功能也有限，所以我们还是采用MiddleGen生成映射文件，之后由hbm2java
 根据映射文件生成POJO 的方式。
 为了使用以上工具，首先我们需要配置一些参数，打开tools/bin/setenv.bat 文件，修改
 其中的JDBC_DRIVER和HIBERNATE_HOME环境变量，使其指向我们的实际JDBC Driver
 文件和Hibernate所在目录，如
 set JDBC_DRIVER=D:/My/hibernate/DBdriver/Sprinta2000.jar
 set HIBERNATE_HOME=D:/My/hibernate/hibernate-2.1
 同时检查一下环境变量CP中的各个项目中是否实际存在，特别是%CORELIB%下的jar
 文件，某些版本的发行包中，默认配置中的文件名与实际的文件名有所出入（如
 %CORELIB%/commons-logging.jar, 在Hibernate 发行包中，可能实际的文件名是
 commons-logging-1.0.3.jar，诸如此类）。
 使用hbm2java，根据MiddleGen生成的映射文件生成Java 代码：
 打开Command Window，在tools/bin目录下执行：

 hbm2java D:/My/hibernate/w3c/org/hibernate/w3c/*.xml --output=D:/My/hibernate/w3c/

 即可生成对应的POJO。生成的POJO 保存在我们指定的输出目录下（D:/My/hibernate/w3c/）。
 目前为止，我们已经完成了通过MiddleGen 产生Hibernate 基础代码的工作。