Hibernate hbm.xml文件怎么配置 Hibernate映射文件编写教程

hbm.xml 是 Hibernate 早期用于 ORM 映射的 XML 文件，定义类与表、属性与字段、主键策略及关联关系；结构以 为根，含 、、 等元素，需在配置中注册加载。

hbm.xml 是 Hibernate 早期版本中用于定义对象关系映射（ORM）的 XML 配置文件，虽然现在主流用注解（@Entity、@Id 等）或 JPA 标准方式，但老项目、遗留系统或特定场景下仍需维护或编写 hbm.xml 文件。它的核心作用是告诉 Hibernate：Java 类怎么对应数据库表，属性怎么映射字段，主键怎么生成，关联关系如何处理。

基础结构：一个最简 hbm.xml 文件长什么样

每个 hbm.xml 文件通常对应一个实体类，以 <hibernate-mapping></hibernate-mapping> 为根元素。下面是一个典型的 User.hbm.xml 示例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC
    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

<hibernate-mapping package="com.example.model">
    <class name="User" table="t_user">
        <id name="id" column="id">
            <generator class="native"/>
        </id>
        <property name="username" column="username" type="string"/>
        <property name="email" column="email" type="string"/>
    </class>
</hibernate-mapping>

登录后复制

说明：
– package 属性可省略，但设上后，name="User" 就不用写全限定名；
– <id></id> 定义主键，<generator></generator> 指定 ID 生成策略（如 native、increment、uuid、assigned）；
– <property></property> 映射普通属性，默认类型由 Hibernate 推断，显式写 type 更安全（如 integer、timestamp、text）。

常用映射细节：字段类型、空值、长度与唯一性

实际开发中，光靠 name 和 column 不够，还需控制数据库行为和 Java 层约束：

• 指定 SQL 类型和长度：用 type（Hibernate 类型）+ length + not-null，例如：
  <property name="phone" column="phone" type="string" length="15" not-null="true"></property>
• 映射时间字段：推荐用 type="timestamp"（对应 java.util.Date 或 LocalDateTime，需配合方言支持）；
  若只存日期，可用 type="date"；只存时间用 type="time"。
• 大文本字段（如 CLOB）：写 type="text"，Hibernate 会自动映射为 String 并适配数据库的长文本类型（如 MySQL 的 TEXT、Oracle 的 CLOB）。
• 布尔值映射：用 type="boolean"，底层按 TINYINT(1) 或 CHAR(1) 存（取决于方言），也可用 type="yes_no" 或 type="true_false" 控制存储值。

配置关联关系：一对多、多对一怎么写

关联是 hbm.xml 的重点也是难点。以“用户（User）→ 订单（Order）”的一对多为例：

在 User.hbm.xml 中声明集合：

标签： mysql oracle java cad app session ai 配置文件