通过Hibernate项目中提供的几个命令行工具(他们也被当作项目的一部分不断得到维护),还有XDoclet,Middlegen和AndroMDA内置的对Hibernate的支持,可以在几个不同的环境(SQL,java代码,xml映射文件)中进行相互转换(roundtrip)。
Hibernate的主发行包中附带了最重要的工具（甚至在Hibernate内部也可以快速调用这个工具）：
从映射文件到DDL schema的生成器（也就是SchemaExport和hbm2ddl）
Hibernate项目直接提供的其他工具在一个单独的发行包中发布，Hibernate Extensions。这个发行包包含了下列任务的工具：
从映射文件到Java源代码的生成器(也就是CodeGenerator，hbm2java）
从已编译的Java类或者带有XDoclet标记的Java源代码生成映射文件（它们是MapGenerator,class2hbm）
实际上Hibernate Extensions里面还有一个工具：ddl2hbm。但是它已经被废弃了，已经不再被维护了。Middlegen完成了同样的任务，并且更加出色。
对Hibernate提供支持的第三方工具有：
Middlegen (从现有的数据库schema中生成映射文件）
AndroMDA ( 使用MDA思想(Model-Driven Architecture ，模型驱动体系)的代码生成器，它从UML图和其XML/XMI等价形式中生成持久化类的代码）
这些第三方工具没有在这篇指南中说明。请查阅Hibernate 网站得到关于它们目前的情况。（Hibernate主发行包中有关于整个网站的快照）
可以从你的映射文件使用一个命令行工具生成DDL。在Hibernate主发行包的hibernate-x.x.x/bin目录下有一个批处理文件。
生成的schema包含有对实体和集合类表的完整性引用约束（主键和外键）。涉及到的标示符生成器所需的表和sequence也会同时生成。
在使用这个工具的时候，你必须 通过hibernate.dialet属性指定一个SQL方言(Dialet)。
很多Hibernate映射元素定义了一个可选的length属性。你可以通过这个属性设置字段的长度。 (如果是Or, for numeric/decimal data types, the precision.)
有些tag接受not-null属性（用来在表字段上生成NOT NULL约束）和unique属性（用来在表字段上生成UNIQUE约束）。
有些tag接受index属性，用来指定字段的index名字。unique-key属性可以对成组的字段指定一个组合键约束(unit key constraint)。目前，unique-key属性指定的值并不会被当作这个约束的名字，它们只是在用来在映射文件内部用作区分的。
示例：
<property name="foo" type="string" length="64" not-null="true"/> <many-to-one name="bar" foreign-key="fk_foo_bar" not-null="true"/> <element column="serial_number" type="long" not-null="true" unique="true"/>
另外，这些元素还接受<column>子元素。在定义跨越多字段的类型时特别有用。
<property name="foo" type="string"> <column name="foo" length="64" not-null="true" sql-type="text"/> </property> <property name="bar" type="my.customtypes.MultiColumnType"/> <column name="fee" not-null="true" index="bar_idx"/> <column name="fi" not-null="true" index="bar_idx"/> <column name="fo" not-null="true" index="bar_idx"/> </property>
sql-type属性允许用户覆盖默认的Hibernate类型到SQL数据类型的映射。
check属性允许用户指定一个约束检查。
<property name="foo" type="integer"> <column name="foo" check="foo > 10"/> </property> <class name="Foo" table="foos" check="bar < 100.0"> ... <property name="bar" type="float"/> </class>
表 15.1. Summary
| 属性(Attribute) | 值（Values） | 解释（Interpretation） |
|---|---|---|
| length | 数字 | 字段长度/小数点精度 |
| not-null | true|false | 指明字段是否应该是非空的 |
| unique | true|false | 指明是否该字段具有惟一约束 |
| index | index_name | 指明一个（多字段）的索引(index)的名字 |
| unique-key | unique_key_name | 指明多字段惟一约束的名字（参见上面的说明） |
| foreign-key | foreign_key_name | 指明一个外键的名字，它是为关联生成的。 |
| sql-type | column_type | 覆盖默认的字段类型(只能用于<column>属性） |
| check | SQL 表达式 | 对字段或表加入SQL约束检查 |
SchemaExport工具把DDL脚本写到标准输出，同时/或者执行DDL语句。
java -cp hibernate_classpaths net.sf.hibernate.tool.hbm2ddl.SchemaExport options mapping_files
表 15.2. SchemaExport命令行选项
| 选项 | 说明 |
|---|---|
| --quiet | 不要把脚本输出到stdout |
| --drop | 只进行drop tables的步骤 |
| --text | 不执行在数据库中运行的步骤 |
| --output=my_schema.ddl | 把输出的ddl脚本输出到一个文件 |
| --config=hibernate.cfg.xml | 从XML文件读入Hibernate配置 |
| --properties=hibernate.properties | 从文件读入数据库属性 |
| --format | 把脚本中的SQL语句对齐和美化 |
| --delimiter=x | 为脚本设置行结束符 |
你甚至可以在你的应用程序中嵌入SchemaExport工具:
Configuration cfg = ....; new SchemaExport(cfg).create(false, true);
可以通过如下方式指定数据库属性:
通过-D<property>系统参数
在hibernate.properties文件中
位于一个其它名字的properties文件中,然后用 --properties参数指定
所需的参数包括:
表 15.3. SchemaExport 连接属性
| 属性名 | 说明 |
|---|---|
| hibernate.connection.driver_class | jdbc driver class |
| hibernate.connection.url | jdbc url |
| hibernate.connection.username | database user |
| hibernate.connection.password | user password |
| hibernate.dialect | 方言(dialect) |
[1] [2] [3] [4] [5] 下一页