Hibernate 3.6.10.Final ²Î¿¼ÊÖ²á ÖÐÎÄ°æ

很多 Hibernate 映射元素定义了可选的 length、precision 或者 scale 属性。你可以通过这个属性设置字段的长度、精度、小数点位数。

<property name="zip" length="5"/>

<property name="balance" precision="12" scale="2"/>

有些 tag 还接受 not-null 属性（用来在表字段上生成 NOT NULL 约束）和 unique 属性（用来在表字段上生成 UNIQUE 约束）。

<many-to-one name="bar" column="barId" not-null="true"/>

<element column="serialNumber" type="long" not-null="true" unique="true"/>

unique-key 属性可以对成组的字段指定一个唯一键约束（unique key constraint）。目前，unique-key 属性指定的值在生成 DDL 时并不会被当作这个约束的名字，它们只是在用来在映射文件内部用作区分的。

<many-to-one name="org" column="orgId" unique-key="OrgEmployeeId"/>

<property name="employeeId" unique-key="OrgEmployee"/>

index 属性会用对应的字段（一个或多个）生成一个 index，它指出了这个 index 的名字。如果多个字段对应的 index 名字相同，就会生成包含这些字段的 index。

<property name="lastName" index="CustName"/>

<property name="firstName" index="CustName"/>

foreign-key 属性可以用来覆盖任何生成的外键约束的名字。

<many-to-one name="bar" column="barId" foreign-key="FKFooBar"/>

很多映射元素还接受 <column> 子元素。这在定义跨越多字段的类型时特别有用。

<property name="name" type="my.customtypes.Name"/>

    <column name="last" not-null="true" index="bar_idx" length="30"/>

    <column name="first" not-null="true" index="bar_idx" length="20"/>

    <column name="initial"/>

</property

>

default 属性为字段指定一个默认值（在保存被映射的类的新实例之前，你应该将同样的值赋于对应的属性）。

<property name="credits" type="integer" insert="false">

    <column name="credits" default="10"/>

</property

>

<version name="version" type="integer" insert="false">

    <column name="version" default="0"/>

</property

>

sql-type 属性允许用户覆盖默认的 Hibernate 类型到 SQL 数据类型的映射。

<property name="balance" type="float">

    <column name="balance" sql-type="decimal(13,3)"/>

</property

>

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

>

下表总结了这些可选属性：

<comment> 元素可以让你在生成的 schema 中加入注释。

<class name="Customer" table="CurCust">

    <comment

>Current customers only</comment>

    ...

</class

>

<property name="balance">

    <column name="bal">

        <comment

>Balance in USD</comment>

    </column>

</property

>

结果是在生成的 DDL 中包含 comment on table 或者 comment on column 语句（假若支持的话）。

SchemaExport 工具把 DDL 脚本写到标准输出，同时/或者执行 DDL 语句。

下表显示了 SchemaExport 命令行选项

java -cp hibernate_classpaths org.hibernate.tool.hbm2ddl.SchemaExport options mapping_files

你甚至可以在你的应用程序中嵌入 SchemaExport 工具：

Configuration cfg = ....;

new SchemaExport(cfg).create(false, true);

可以通过如下方式指定数据库属性：

所需的参数包括：

你可以在你的 Ant build 脚本中调用 SchemaExport：

<target name="schemaexport">

    <taskdef name="schemaexport"

        classname="org.hibernate.tool.hbm2ddl.SchemaExportTask"

        classpathref="class.path"/>

    

    <schemaexport

        properties="hibernate.properties"

        quiet="no"

        text="no"

        drop="no"

        delimiter=";"

        output="schema-export.sql">

        <fileset dir="src">

            <include name="**/*.hbm.xml"/>

        </fileset>

    </schemaexport>

</target

>

SchemaUpdate 工具对已存在的 schema 采用"增量"方式进行更新。注意 SchemaUpdate 严重依赖于 JDBC metadata API，所以它并非对所有 JDBC 驱动都有效。

java -cp hibernate_classpaths org.hibernate.tool.hbm2ddl.SchemaUpdate options mapping_files

你可以在你的应用程序中嵌入 SchemaUpdate 工具：

Configuration cfg = ....;

new SchemaUpdate(cfg).execute(false);

你可以在 Ant 脚本中调用 SchemaUpdate：

<target name="schemaupdate">

    <taskdef name="schemaupdate"

        classname="org.hibernate.tool.hbm2ddl.SchemaUpdateTask"

        classpathref="class.path"/>

    

    <schemaupdate

        properties="hibernate.properties"

        quiet="no">

        <fileset dir="src">

            <include name="**/*.hbm.xml"/>

        </fileset>

    </schemaupdate>

</target

>

SchemaValidator 工具会比较数据库现状是否与映射文档“匹配”。注意，SchemaValidator 严重依赖于 JDBC 的 metadata API，因此不是对所有的 JDBC 驱动都适用。这一工具在测试的时候特别有用。

java -cp hibernate_classpaths org.hibernate.tool.hbm2ddl.SchemaValidator options mapping_files

下表显示了 SchemaValidator 命令行参数：

你可以在你的应用程序中嵌入 SchemaValidator：

Configuration cfg = ....;

new SchemaValidator(cfg).validate();

你可以在 Ant 脚本中调用 SchemaValidator：

<target name="schemavalidate">

    <taskdef name="schemavalidator"

        classname="org.hibernate.tool.hbm2ddl.SchemaValidatorTask"

        classpathref="class.path"/>

    

    <schemavalidator

        properties="hibernate.properties">

        <fileset dir="src">

            <include name="**/*.hbm.xml"/>

        </fileset>

    </schemavalidator>

</target

>