工具箱指南
可以通过一系列Eclipse插件、命令行工具和Ant任务来进行与Hibernate关联的转换。
除了Ant任务外,当前的Hibernate Tools也包含了Eclipse IDE的插件,用于与现存数据库的逆向工程。
Mapping Editor: Hibernate XML映射文件的编辑器,支持自动完成和语法高亮。它也支持对类名和属性/字段名的语义自动完成,比通常的XML编辑器方便得多。
Console: Console是Eclipse的一个新视图。除了对你的console配置的树状概览,你还可以获得对你持久化类及其关联的交互式视图。Console允许你对数据库执行HQL查询,并直接在Eclipse中浏览结果。
Development Wizards: 在Hibernate Eclipse tools中还提供了几个向导;你可以用向导快速生成Hibernate 配置文件(cfg.xml),你甚至还可以同现存的数据库schema中反向工程出POJO源代码与Hibernate 映射文件。反向工程支持可定制的模版。
Ant Tasks:
要得到更多信息,请查阅 Hibernate Tools 包及其文档。
同时,Hibernate主发行包还附带了一个集成的工具(它甚至可以在Hibernate“内部”快速运行)SchemaExport ,也就是 hbm2ddl。
Schema自动生成(Automatic schema generation)
可以从你的映射文件使用一个Hibernate工具生成DDL。 生成的schema包含有对实体和集合类表的完整性引用约束(主键和外键)。涉及到的标示符生成器所需的表和sequence也会同时生成。
在使用这个工具的时候,你必须 通过hibernate.dialet属性指定一个SQL方言(Dialet),因为DDL是与供应商高度相关的。
首先,要定制你的映射文件,来改善生成的schema。
对schema定制化(Customizing the schema)
很多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属性指定的值并不会被当作这个约束的名字,它们只是在用来在映射文件内部用作区分的。
示例:
]]>
另外,这些元素还接受<column>子元素。在定义跨越多字段的类型时特别有用。
]]>
sql-type属性允许用户覆盖默认的Hibernate类型到SQL数据类型的映射。
check属性允许用户指定一个约束检查。
...
]]>
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
org.hibernate.tool.hbm2ddl.SchemaExport options mapping_files
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工具:
属性(Properties)
可以通过如下方式指定数据库属性:
通过-D<property>系统参数
在hibernate.properties文件中
位于一个其它名字的properties文件中,然后用 --properties参数指定
所需的参数包括:
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)
使用Ant(Using Ant)
你可以在你的Ant build脚本中调用SchemaExport:
]]>
对schema的增量更新(Incremental schema updates)
SchemaUpdate工具对已存在的schema采用"增量"方式进行更新。注意SchemaUpdate严重依赖于JDBC metadata API,所以它并非对所有JDBC驱动都有效。
java -cp hibernate_classpaths
org.hibernate.tool.hbm2ddl.SchemaUpdate options mapping_files
SchemaUpdate命令行选项
选项
说明
--quiet
不要把脚本输出到stdout
--properties=hibernate.properties
从指定文件读入数据库属性
你可以在你的应用程序中嵌入SchemaUpdate工具:
用Ant来增量更新schema(Using Ant for incremental schema updates)
你可以在Ant脚本中调用SchemaUpdate:
]]>